vdev_id - generate user-friendly names for JBOD disks
vdev_id <-d dev> [-c config_file] [-g sas_direct|sas_switch]
[-m] [-p phys_per_port]
command is a udev helper which parses the file
(5) to map a physical path in a storage topology
to a channel name. The channel name is combined with a disk enclosure slot
number to create an alias that reflects the physical location of the drive.
This is particularly helpful when it comes to tasks like replacing failed
drives. Slot numbers may also be re-mapped in case the default numbering is
unsatisfactory. The drive aliases will be created as symbolic links in
The currently supported topologies are sas_direct and sas_switch. A multipath
mode is supported in which dm-mpath devices are handled by examining the
first-listed running component disk as reported by the multipath
command. In multipath mode the configuration file should contain a channel
definition with the same name for each path to a given enclosure.
also supports creating aliases based on existing udev links in
the /dev hierarchy using the alias
configuration file keyword. See the
(5) man page for details.
- -c <config_file>
- Specifies the path to an alternate configuration file. The default is
- -d <device>
- This is the only mandatory argument. Specifies the name of a device in
/dev, i.e. "sda".
- -g <sas_direct|sas_switch>
- Identifies a physical topology that governs how physical paths are mapped
sas_direct - in this mode a channel is uniquely identified by a PCI
slot and a HBA port number
sas_switch - in this mode a channel is uniquely identified by a SAS
switch port number
- Specifies that vdev_id(8) will handle only dm-multipath devices. If
set to "yes" then vdev_id(8) will examine the first
running component disk of a dm-multipath device as listed by the
multipath(8) command to determine the physical path.
- -p <phys_per_port>
- Specifies the number of PHY devices associated with a SAS HBA port or SAS
switch port. vdev_id(8) internally uses this value to determine
which HBA or switch port a device is connected to. The default is 4.
- Print a usage summary.