3 vdev_id.conf \- Configuration file for vdev_id
6 is the configuration file for
8 It controls the default behavior of
10 while it is mapping a disk device name to an alias.
14 file uses a simple format consisting of a keyword followed by one or
15 more values on a single line. Any line not beginning with a recognized
16 keyword is ignored. Comments may optionally begin with a hash
19 The following keywords and values are used.
21 \fIchannel\fR [pci_slot] <port> <name>
22 Maps a physical path to a channel name (typically representing a single
25 \fIpci_slot\fR - specifies the PCI SLOT of the HBA
26 hosting the disk enclosure being mapped, as found in the output of
28 This argument is not used in sas_switch mode.
30 \fIport\fR - specifies the numeric identifier of the HBA or SAS switch port
31 connected to the disk enclosure being mapped.
33 \fIname\fR - specifies the name of the channel.
36 \fIslot\fR <old> <new>
37 Maps a disk slot number as reported by the operating system
38 to an alternative slot number.
40 \fImultipath\fR <yes|no>
43 will handle only dm-multipath devices. If set to "yes" then
45 will examine the first running component disk of a dm-multipath
46 device as listed by the
48 command to determine the physical path.
50 \fItopology\fR <sas_direct|sas_switch>
51 Identifies a physical topology that governs how physical paths are
54 \fIsas_direct\fR - in this mode a channel is uniquely identified by
55 a PCI slot and a HBA port number
57 \fIsas_switch\fR - in this mode a channel is uniquely identified by
58 a SAS switch port number
61 \fIphys_per_port\fR <num>
62 Specifies the number of PHY devices are associated with a SAS HBA port or SAS
65 internally uses this value to determine which HBA or switch port a
66 device is connected to. The default is 4.
68 A non-multipath configuration with direct-attached SAS enclosures and an
69 arbitrary slot re-mapping.
79 # PCI_SLOT HBA PORT CHANNEL NAME
116 A SAS-switch topology. Note that the
118 keyword takes only two arguments in this example.
124 # SWITCH PORT CHANNEL NAME
135 A multipath configuration. Note that channel names have multiple
136 definitions - one per physical path.
142 # PCI_SLOT HBA PORT CHANNEL NAME
156 .I /etc/zfs/vdev_id.conf
157 The configuration file for