summaryrefslogtreecommitdiff
path: root/extras/dasd_id
diff options
context:
space:
mode:
authorJan Luebbe <jluebbe@lasnet.de>2005-10-31 02:10:56 +0100
committerKay Sievers <kay.sievers@suse.de>2005-10-31 02:10:56 +0100
commit0c25d156b06259f4d0ba4cfafffc8c64c27a0baf (patch)
tree94d65c80987b92bde6b5749365ced48da46cf36f /extras/dasd_id
parent2a4ce7092546039063fcf5aaa36760a89d8c9047 (diff)
add man pages for *_id programs
I've written manpages for the *_id binaries, which are attached to this mail.
Diffstat (limited to 'extras/dasd_id')
-rw-r--r--extras/dasd_id/Makefile4
-rw-r--r--extras/dasd_id/dasd_id.828
2 files changed, 30 insertions, 2 deletions
diff --git a/extras/dasd_id/Makefile b/extras/dasd_id/Makefile
index 698253a9ee..a995c7892d 100644
--- a/extras/dasd_id/Makefile
+++ b/extras/dasd_id/Makefile
@@ -57,11 +57,11 @@ 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: uninstall-man
uninstall-man:
- @echo "Please create a man page for this tool."
+ -rm -f $(DESTDIR)$(mandir)/man8/$(PROG).8
.PHONY: uninstall-man
install-config:
diff --git a/extras/dasd_id/dasd_id.8 b/extras/dasd_id/dasd_id.8
new file mode 100644
index 0000000000..c3d4075326
--- /dev/null
+++ b/extras/dasd_id/dasd_id.8
@@ -0,0 +1,28 @@
+.TH DASD_ID 8 "November 2005" "" "Linux Administrator's Manual"
+.SH NAME
+dasd_id \- udev callout to read label from s390 block device
+.SH SYNOPSIS
+.BI dasd_id
+[\fI--export\fP] \fIblockdevice\fP
+.SH "DESCRIPTION"
+.B dasd_id
+is normally called from a udev rule, to provide udev with a unique string and
+additional information (type, serial) for an S390 drive. Udev can use this
+information to create symlinks in /dev/disk/by-id and /dev/disk/by-label
+to the real device node.
+.SH USAGE
+.B dasd_id
+opens the blockdevice node specified at the commandline and prints the
+information chosen by the options.
+.SH OPTIONS
+The following commandline switches are supported to specify what dasd_id
+should print:
+.TP
+.BI --export
+print all values (instead of only the serial)
+.RE
+.SH SEE ALSO
+.BR udev (8)
+.SH AUTHORS
+Developed by Arnd Bergmann <arnd@arndb.de> and Kay Sievers <kay.sievers@vrfy.org>.
+