scripts: Move man pages to System commands section

dbginfo.sh, zfcpdbf, and zipl-switch-to-blscfg are system commands but
the corresponding man pages are located in section 1 for user commands.

Move the man pages to section 8 for system commands.

Fixes: https://github.com/ibm-s390-linux/s390-tools/issues/135
Reviewed-by: Steffen Maier <maier@linux.ibm.com> [zfcpdbf]
Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>

scripts/dbginfo.sh.8

@@ -0,0 +1,123 @@
+.TH DBGINFO.SH  8 "May 2022" "s390-tools"
+
+.SH NAME
+dbginfo.sh \- collect runtime, configuration and trace information
+for debugging Linux on IBM Z
+
+.SH SYNOPSIS
+.br
+\fBdbginfo.sh\fP [OPTIONS]
+.br
+\fBdbginfo.sh\fP {\-h|\-v}
+
+.SH DESCRIPTION
+This script collects runtime, configuration and trace information that can
+be used to debug a Linux on IBM Z instance.
+For Linux on z/VM, the script also traces information about the z/VM system.
+KVM or DOCKER data ist collected on a host serving this.
+
+The debug information is written to a file
+/<DIRECTORY>/DBGINFO\-<date>\-<time>\-<hostname>\-<processorid>.tgz
+where [date] and [time] are the date and time when the debug data was
+collected. [hostname] indicates the hostname of the system the data was
+collected from. The [processorid] is taken from the processor 0 and indicates
+the processor identification.
+
+.SH OPTIONS
+.TP
+\fB\-h\fP, \fB\-\-help\fP
+Print usage information, then exit.
+
+.TP
+\fB\-v\fP, \fB\-\-version\fP
+Print version information, then exit.
+
+.TP
+\fB\-d <DIRECTORY>\fP, \fB\-\-directory <DIRECTORY>\fP
+Specify the DIRECTORY where the data collection stores the temporary data and the final archive.
+The specified directory must already exist. If this parameter is not specified, /tmp is used by default.
+
+.TP
+\fB\-c\fP, \fB\-\-check\fP
+Print online quick check (not saving any data) - can be combind with a preceding -d option.
+
+.SH FILES
+A .tgz file of the form
+.PP
+.nf
+.fam C
+    DBGINFO\-<year>\-<month>\-<day>\-<hours>\-<minutes>\-<seconds>\-<hostname>\-<processorid>.tgz
+
+.fam T
+.fi
+is generated and placed in the /tmp directory or in the directory specified by the -d option.
+
+.SH EXAMPLE
+Sample invocation:
+.P
+[root@host]# dbginfo.sh \-d /data\-collection
+.br
+dbginfo.sh: Debug information script version %S390_TOOLS_VERSION%
+.br
+Copyright IBM Corp. 2002, 2021
+.PP
+Hardware platform     = s390x
+.br
+Runtime environment   = z/VM
+.br
+Kernel version        = 4.18.0 (4.18.0-305.el8.s390x)
+.br
+OS version / distro   = Red Hat Enterprise Linux 8.4 (Ootpa)
+.br
+Date and time of info = 2021-08-26-15-27-58
+.PP
+1 of 18: Collecting sysfs
+.PP
+2 of 18: Collecting procfs
+.PP
+3 of 18: Collecting config files
+.PP
+4 of 18: Collecting command output
+.PP
+5 of 18: Collecting hyptop for z/VM - 5s output
+.PP
+6 of 18: Collecting z/VM output
+.PP
+7 of 18: Collecting network output
+.PP
+8 of 18: Collecting osa oat output
+.PP
+9 of 18: Collecting ethtool output
+.PP
+10 of 18: Collecting Trafic Control output
+.PP
+11 of 18: Collecting bridge output
+.PP
+12 of 18: Skip OpenVSwitch: ovs-vsctl not available
+.PP
+13 of 18: Skip KVM: no virsh command
+.PP
+14 of 18: Collecting docker output
+.PP
+15 of 18: Collecting NVME storage output
+.PP
+16 of 18: Collecting log files
+.PP
+ 0 logfiles over 50 MB
+.PP
+17 of 18: Postprocessing
+.PP
+18 of 18: Finalizing: Creating archive with collected data
+.PP
+Collected data was saved to:
+.br
+ >>  /data\-collection/DBGINFO\-2021\-08\-26\-15\-27\-58\-host\-012345.tgz  <<
+.br
+Please review all collected data before sending to your service organization.
+.SH HINTS
+Run the script with root authority.
+.br
+For Linux on z/VM, only z/VM guest virtual machines with class B privileges
+yield the complete debug information.
+.SH AUTHOR
+Linux on IBM Z development <linux390@de.ibm.com>