X-Git-Url: https://git.camperquake.de/gitweb.cgi?a=blobdiff_plain;f=man%2Fman5%2Fvdev_id.conf.5;h=df3f59fc2228c64c8b9ca0c36d3a4f7f099ef759;hb=51a3ae72d23d89d35a4a67059b39e870d66a2495;hp=e449360d1f141dcb40c422572f1e6122bf85484e;hpb=821b683436423593a1f3ee597f40a61bd4569bdd;p=zfs.git

diff --git a/man/man5/vdev_id.conf.5 b/man/man5/vdev_id.conf.5
index e449360..df3f59f 100644
--- a/man/man5/vdev_id.conf.5
+++ b/man/man5/vdev_id.conf.5
@@ -18,6 +18,22 @@ character.
 
 The following keywords and values are used.
 .TP
+\fIalias\fR <name> <devlink>
+Maps a device link in the /dev directory hierarchy to a new device
+name.  The udev rule defining the device link must have run prior to
+.BR vdev_id (8).
+A defined alias takes precedence over a topology-derived name, but the
+two naming methods can otherwise coexist.  For example, one might name
+drives in a JBOD with the sas_direct topology while naming an internal
+L2ARC device with an alias.
+
+\fIname\fR - the name of the link to the device that will by created in
+/dev/disk/by-vdev.
+
+\fIdevlink\fR - the name of the device link that has already been
+defined by udev.  This may be an absolute path or the base filename.
+
+.TP
 \fIchannel\fR [pci_slot] <port> <name>
 Maps a physical path to a channel name (typically representing a single
 disk enclosure).
@@ -59,7 +75,7 @@ a SAS switch port number
 
 .TP
 \fIphys_per_port\fR <num>
-Specifies the number of PHY devices are associated with a SAS HBA port or SAS
+Specifies the number of PHY devices associated with a SAS HBA port or SAS
 switch port.
 .BR vdev_id (8)
 internally uses this value to determine which HBA or switch port a
@@ -150,6 +166,18 @@ definitions - one per physical path.
 	channel 86:00.0  0         B
 .br
 .P
+A configuration using device link aliases.
+.P
+.br
+	#     by-vdev
+.br
+	#     name     fully qualified or base name of device link
+.br
+	alias d1       /dev/disk/by-id/wwn-0x5000c5002de3b9ca
+.br
+	alias d2       wwn-0x5000c5002def789e
+.br
+.P
 
 .SH FILES
 .TP