File s390-tools-sles11sp2-mkdump-manpage.patch of Package s390-tools

Description: mkdump manpage
Symptom:     mkdump isn't well documented
Problem:     mkdump does not have a man page
Solution:    add a manpage for mkdump
diff -Nrup s390-tools-1.8.0.orig//man/Makefile s390-tools-1.8.0/man/Makefile
--- s390-tools-1.8.0.orig//man/Makefile	2011-08-08 18:49:54.301788000 +0200
+++ s390-tools-1.8.0/man/Makefile	2011-08-08 18:51:18.305314000 +0200
@@ -1,6 +1,6 @@
 include ../common.mak
 
-MANS = dumpconf.8 prandom.4 af_iucv.7
+MANS = dumpconf.8 mkdump.8 prandom.4 af_iucv.7
 
 all:
 
diff -Nrup s390-tools-1.8.0.orig//man/mkdump.8 s390-tools-1.8.0/man/mkdump.8
--- s390-tools-1.8.0.orig//man/mkdump.8	1970-01-01 01:00:00.000000000 +0100
+++ s390-tools-1.8.0/man/mkdump.8	2011-08-08 18:06:53.805230000 +0200
@@ -0,0 +1,73 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.36.
+.TH MKDUMP "8" "August 2011" "mkdump 2.0" "System Administration Utilities"
+.SH NAME
+mkdump \- Preparing disks for use as S/390 dump device.
+.SH SYNOPSIS
+.B mkdump
+[\fIOPTIONS\fR] [\fIDEVICE\fR]...
+.SH DESCRIPTION
+mkdump 2.0.2
+.PP
+Prepare one or more volumes for use as S/390 dump device. Supported devices
+are ECKD DASD and ZFCP disks, while multi\-volumes are limited to DASD.
+.PP
+Only whole disks can be used, no partitions! If the device is incompatible
+formatted/partioned, the script will refuse to install the dump record
+unless the \fB\-\-force\fR switch is given.
+.PP
+Disks which are in use or have mounted partitions will not be listed and can't be used.
+The mentioning of "dumpdevice" after a disk indicates that it is an already usable dump device. Additionally multi\-volume dump devices are indicated by the list of including DASD ids.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+display version information and exit
+.TP
+\fB\-d\fR, \fB\-\-debug\fR
+debug mode, do not run programs which commit changes
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+be verbose and show command outputs
+.TP
+\fB\-f\fR, \fB\-\-force\fR
+force overwrite of the disk
+.TP
+\fB\-l\fR, \fB\-\-list\-dump\fR
+display dump disks
+.TP
+\fB\-D\fR, \fB\-\-list\-dasd\fR
+display usable DASD disks (Device, Size, ID, Dump)
+.TP
+\fB\-Z\fR, \fB\-\-list\-zfcp\fR
+display usable ZFCP disks (Device, Size, ID, WWPN, LUN, Dump)
+.SH DIAGNOSTICS
+mkdump returns the following exit codes:
+.RS
+.IP 0
+Normal (no errors or warnings detected)
+.IP 11
+Invalid or unusable disk (fatal)
+.IP 12
+Incompatible formatting/partitioning, can be corrected with --force
+.IP 13
+Missing support programs
+.IP 14
+Bad command line parameters
+.IP 15
+Access problem
+.IP other
+Support program failed
+.SH AUTHOR
+Written by Tim Hardeck <thardeck@suse.de>.
+.SH "REPORTING BUGS"
+Report bugs on https://bugzilla.novell.com/
+.SH COPYRIGHT
+Copyright \(co 2011 SUSE LINUX Products GmbH
+License GPLv2 or GPLv3: GNU GPL version 2 or 3
+<http://www.gnu.org/licenses/gpl-2.0.html>
+<http://www.gnu.org/licenses/gpl-3.0.html>
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.