summaryrefslogtreecommitdiff
path: root/extras/path_id
diff options
context:
space:
mode:
authorVMiklos <vmiklos@gmail.com>2007-04-22 14:10:18 +0200
committerKay Sievers <kay.sievers@vrfy.org>2007-04-22 14:10:18 +0200
commit8127859217bcc4db6f42f8d549f157df93a44557 (patch)
tree26361ec5f7c68ece3a210bbef091b701c1571d63 /extras/path_id
parentfc630edad4631f4c046052f504a67ce9df381531 (diff)
path_id: add man page
Diffstat (limited to 'extras/path_id')
-rw-r--r--extras/path_id/Makefile2
-rw-r--r--extras/path_id/path_id.826
2 files changed, 27 insertions, 1 deletions
diff --git a/extras/path_id/Makefile b/extras/path_id/Makefile
index 2f6890cb32..24b47b425a 100644
--- a/extras/path_id/Makefile
+++ b/extras/path_id/Makefile
@@ -45,7 +45,7 @@ uninstall-bin:
.PHONY: uninstall-bin
install-man:
- @echo "Please create a man page for this tool."
+ $(INSTALL_DATA) -D $(PROG).8 $(DESTDIR)$(mandir)/man8/$(PROG).8
.PHONY: install-man
uninstall-man:
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>.