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 \fIalias\fR <name> <devlink>
22 Maps a device link in the /dev directory hierarchy to a new device
23 name. The udev rule defining the device link must have run prior to
25 A defined alias takes precedence over a topology-derived name, but the
26 two naming methods can otherwise coexist. For example, one might name
27 drives in a JBOD with the sas_direct topology while naming an internal
28 L2ARC device with an alias.
30 \fIname\fR - the name of the link to the device that will by created in
33 \fIdevlink\fR - the name of the device link that has already been
34 defined by udev. This may be an absolute path or the base filename.
37 \fIchannel\fR [pci_slot] <port> <name>
38 Maps a physical path to a channel name (typically representing a single
41 \fIpci_slot\fR - specifies the PCI SLOT of the HBA
42 hosting the disk enclosure being mapped, as found in the output of
44 This argument is not used in sas_switch mode.
46 \fIport\fR - specifies the numeric identifier of the HBA or SAS switch port
47 connected to the disk enclosure being mapped.
49 \fIname\fR - specifies the name of the channel.
52 \fIslot\fR <old> <new>
53 Maps a disk slot number as reported by the operating system
54 to an alternative slot number.
56 \fImultipath\fR <yes|no>
59 will handle only dm-multipath devices. If set to "yes" then
61 will examine the first running component disk of a dm-multipath
62 device as listed by the
64 command to determine the physical path.
66 \fItopology\fR <sas_direct|sas_switch>
67 Identifies a physical topology that governs how physical paths are
70 \fIsas_direct\fR - in this mode a channel is uniquely identified by
71 a PCI slot and a HBA port number
73 \fIsas_switch\fR - in this mode a channel is uniquely identified by
74 a SAS switch port number
77 \fIphys_per_port\fR <num>
78 Specifies the number of PHY devices associated with a SAS HBA port or SAS
81 internally uses this value to determine which HBA or switch port a
82 device is connected to. The default is 4.
84 A non-multipath configuration with direct-attached SAS enclosures and an
85 arbitrary slot re-mapping.
95 # PCI_SLOT HBA PORT CHANNEL NAME
132 A SAS-switch topology. Note that the
134 keyword takes only two arguments in this example.
140 # SWITCH PORT CHANNEL NAME
151 A multipath configuration. Note that channel names have multiple
152 definitions - one per physical path.
158 # PCI_SLOT HBA PORT CHANNEL NAME
169 A configuration using device link aliases.
174 # name fully qualified or base name of device link
176 alias d1 /dev/disk/by-id/wwn-0x5000c5002de3b9ca
178 alias d2 wwn-0x5000c5002def789e
184 .I /etc/zfs/vdev_id.conf
185 The configuration file for