diff options
| author | Tony Hutter <[email protected]> | 2018-12-14 17:27:49 -0800 |
|---|---|---|
| committer | Brian Behlendorf <[email protected]> | 2018-12-14 17:27:49 -0800 |
| commit | c66401fae036b22ecb3fa9af3337e1f9ecffb5e7 (patch) | |
| tree | c52b231a099ae57908e550b2d85ef32c0433167e /man/man5/vdev_id.conf.5 | |
| parent | 7c46894081300410612a34f7c05377848b277dab (diff) | |
Add enclosure_symlinks option to vdev_id
Add an 'enclosure_symlinks' option to vdev_id.conf. This creates
consistently named symlinks to the enclosure devices (/dev/sg*) based
off the configuration in vdev_id.conf. The enclosure symlinks show
up in /dev/by-enclosure/<prefix>-<channel><num>. The links make it
make it easy to run sg_ses on a particular enclosure device. The
enclosure links are created in addition to the normal
/dev/disk/by-vdev links.
'enclosure_symlinks' is only valid in sas_direct configurations.
Reviewed-by: Brian Behlendorf <[email protected]>
Reviewed-by: Simon Guest <[email protected]>
Signed-off-by: Tony Hutter <[email protected]>
Closes #8194
Diffstat (limited to 'man/man5/vdev_id.conf.5')
| -rw-r--r-- | man/man5/vdev_id.conf.5 | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/man/man5/vdev_id.conf.5 b/man/man5/vdev_id.conf.5 index 50caa92c0..5b7fbf0ca 100644 --- a/man/man5/vdev_id.conf.5 +++ b/man/man5/vdev_id.conf.5 @@ -38,6 +38,19 @@ defined by udev. This may be an absolute path or the base filename. Maps a physical path to a channel name (typically representing a single disk enclosure). +.TP +\fIenclosure_symlinks\fR <yes|no> +Additionally create /dev/by-enclosure symlinks to the disk enclosure +sg devices using the naming scheme from from vdev_id.conf. +\fIenclosure_symlinks\fR is only allowed for sas_direct mode. +.TP +\fIenclosure_symlinks_prefix\fR <prefix> +Specify the prefix for the enclosure symlinks in the form of: + +/dev/by-enclosure/<prefix>-<channel><num> + +Defaults to "enc" if not specified. +.TP \fIpci_slot\fR - specifies the PCI SLOT of the HBA hosting the disk enclosure being mapped, as found in the output of .BR lspci (8). @@ -169,6 +182,27 @@ definitions - one per physical path. channel 86:00.0 0 B .fi .P +A configuration with enclosure_symlinks enabled. +.P +.nf + multipath yes + enclosure_symlinks yes + + # PCI_ID HBA PORT CHANNEL NAME + channel 05:00.0 1 U + channel 05:00.0 0 L + channel 06:00.0 1 U + channel 06:00.0 0 L +.fi +In addition to the disks symlinks, this configuration will create: +.P +.nf + /dev/by-enclosure/enc-L0 + /dev/by-enclosure/enc-L1 + /dev/by-enclosure/enc-U0 + /dev/by-enclosure/enc-U1 +.fi +.P A configuration using device link aliases. .P .nf |