From: VMiklos <vmiklos@gmail.com>
Date: Sun, 22 Apr 2007 12:10:18 +0000 (+0200)
Subject: path_id: add man page
X-Git-Tag: 174~1997
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=8127859217bcc4db6f42f8d549f157df93a44557;hp=fc630edad4631f4c046052f504a67ce9df381531

path_id: add man page
---

diff --git a/extras/path_id/Makefile b/extras/path_id/Makefile
index 2f6890cb3..24b47b425 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 000000000..e55914de3
--- /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>.