1 files changed, 26 insertions, 0 deletions
diff --git a/extras/path_id/path_id.8 b/extras/path_id/path_id.8
new file mode 100644
index 0000000000..e55914de31
--- /dev/null
+++ b/extras/path_id/path_id.8
@@ -0,0 +1,26 @@
+.TH PATH_ID 8 "April 2007" "" "Linux Administrator's Manual"
+.SH NAME
+path_id \- udev callout to provide the shortest possible unique hardware path
+to a device for the Linux Persistent Device Naming scheme
+.SH SYNOPSIS
+DEVPATH=<devpath>; path_id
+
+path_id <devpath>
+.SH "DESCRIPTION"
+.B path_id
+is normally called from a udev rule, to provide udev a unique hardware path for
+a device. Udev can use this information to create symlinks in /dev/ to the real
+device node.
+.SH EXAMPLES
+For all block devices on a system:
+
+.nf
+for i in `find /sys/class/block`
+do
+	DEVPATH="`echo $i | sed -e 's@^/sys\|/dev@@g'`"; path_id
+done
+.fi
+.SH SEE ALSO
+.BR udev (7)
+.SH AUTHORS
+Developed by Hannes Reinecke <hare@suse.de>.