From 5b952551f0df8abf13d7af989924f13dd127d094 Mon Sep 17 00:00:00 2001 From: Than Ngo Date: Sat, 28 Mar 2020 18:38:28 +0100 Subject: [PATCH] add missing man pages --- add_regex.8 | 13 +++++++++++++ convert_dt_node_props.8 | 16 ++++++++++++++++ extract_opal_dump.8 | 25 +++++++++++++++++++++++++ extract_platdump.8 | 12 ++++++++++++ ppc64-diag.spec | 8 +++++++- rtas_errd.8 | 37 +++++++++++++++++++++++++++++++++++++ 6 files changed, 110 insertions(+), 1 deletion(-) create mode 100644 add_regex.8 create mode 100644 convert_dt_node_props.8 create mode 100644 extract_opal_dump.8 create mode 100644 extract_platdump.8 create mode 100644 rtas_errd.8 diff --git a/add_regex.8 b/add_regex.8 new file mode 100644 index 0000000..03306cf --- /dev/null +++ b/add_regex.8 @@ -0,0 +1,13 @@ +.TH add_regex: "8" "June 2016" "ppc64-diag" "System Administration Utilities" +.SH NAME +add_regex \- catalog parser +.SH SYNOPSIS +.B add_regex +[\fB\-C\fR \fI\,dir\/\fR] +.SH DESCRIPTION +Parse all the catalog files in the specified directory, populating +reporter_catalog, exceptions catalog, and event_catalog. +.SH OPTIONS +.TP +.BR \-C " " \fIdir\fR +Catalog directory in which catalog files are stored. diff --git a/convert_dt_node_props.8 b/convert_dt_node_props.8 new file mode 100644 index 0000000..5e7fef6 --- /dev/null +++ b/convert_dt_node_props.8 @@ -0,0 +1,16 @@ +.TH convert_dt_node_props "8" "June 2016" "ppc64-diag" "System Administration Utilities" +.SH NAME +convert_dt_node_props \- conversion tool +.SH SYNOPSIS +.B convert_dt_node_props +\fB\-\-context\fR \fI\,\fR \fB\-\-from \fI\,\fR \fB\-\-to \fI\,\fR \fI\,\/\fR +.SH DESCRIPTION +.HP +\fB\-c\fR, \fB\-\-context\fR: currently, \fI\,\fR must be cpu +.HP +\fB\-f\fR, \fB\-\-from\fR and \fB\-t\fR, \fB\-\-to\fR: allowed values for \fI\,\fR and \fI\,\fR: interrupt\-server, drc\-index, drc\-name +.IP +if \fI\,\fR is a drc\-index or interrupt\-server, it can be +specified in decimal, hex (with a leading 0x), or octal +(with a leading 0); if it is a drc\-name, it should be +specified as a string in double quotes diff --git a/extract_opal_dump.8 b/extract_opal_dump.8 new file mode 100644 index 0000000..d889ab4 --- /dev/null +++ b/extract_opal_dump.8 @@ -0,0 +1,25 @@ +.TH extract_opal_dump "8" "June 2016" "ppc64-diag" "System Administration Utilities" +.SH NAME +extract_opal_dump \- Extract opal dump +.SH SYNOPSIS +.B extract_opal_dump +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.PP +\fB\-A\fR +Don't acknowledge dump +.TP +\fB\-s\fR \fI\,dir\fR +sysfs directory (default \fI\,/sys\/\fP) +.TP +\fB\-o\fR \fI\,dir\fR +directory to save dumps (default \fI\,/var/log/dump\/\fP) +.TP +\fB\-m\fR \fI\,max\fR +maximum number of dumps of a specific type to be saved +.TP +\fB\-w\fR +wait for a dump +.TP +\fB\-h\fR +help (this message) diff --git a/extract_platdump.8 b/extract_platdump.8 new file mode 100644 index 0000000..3088a42 --- /dev/null +++ b/extract_platdump.8 @@ -0,0 +1,12 @@ +.TH extract_platdump "8" "June 2016" "ppc64-diag" "System Administration Utilities" +.SH NAME +extract_platdump: \- Extract platform dump +.SH SYNOPSIS +.B extract_platdump +[\fI\,-h\/\fR] [\fI\,-v\/\fR] \fI\,\/\fR +.SH DESCRIPTION +Extracts a platform dump with a given tag to the filesystem. \fI\,\fR is the tag of the dump(s) to extract, in hex. +.HP +\fB\-h\fR: print this help message +.HP +\fB\-v\fR: verbose output diff --git a/ppc64-diag.spec b/ppc64-diag.spec index daacc96..cb2faa3 100644 --- a/ppc64-diag.spec +++ b/ppc64-diag.spec @@ -23,6 +23,12 @@ Requires: servicelog Requires: lsvpd Source0: https://github.com/power-ras/p%{name}/archive/v%{version}/%{name}-%{version}.tar.gz +Source1: add_regex.8 +Source2: convert_dt_node_props.8 +Source3: extract_opal_dump.8 +Source4: extract_platdump.8 +Source5: rtas_errd.8 + # fix paths and permissions Patch0: ppc64-diag-messagecatalog-location.patch Patch2: ppc64-diag-scriptlocation.patch @@ -65,7 +71,7 @@ mkdir -p $RPM_BUILD_ROOT/%{_sysconfdir}/%{name}/ses_pages mkdir -p $RPM_BUILD_ROOT/%{_localstatedir}/log/dump mkdir -p $RPM_BUILD_ROOT/%{_localstatedir}/log/opal-elog ln -sfv %{_sbindir}/usysattn $RPM_BUILD_ROOT/%{_sbindir}/usysfault - +install -m 644 %{SOURCE1} %{SOURCE2} %{SOURCE3} %{SOURCE4} %{SOURCE5} $RPM_BUILD_ROOT/%{_mandir}/man8/ %files %license COPYING diff --git a/rtas_errd.8 b/rtas_errd.8 new file mode 100644 index 0000000..b274f0d --- /dev/null +++ b/rtas_errd.8 @@ -0,0 +1,37 @@ +.TH RTAS_ERRD "8" "rtas_errd" "System Administration Utilities" +.SH NAME +rtas_errd \- rtas_errd +.SH SYNOPSIS +.B rtas_errd +[\fI\,OPTION\/\fR] +.SH DESCRIPTION +.TP +\fB\-c\fR, \fB\-\-config\fR=\fI\,FILE\/\fR +path to config file (default \fI\,/etc/ppc64\-diag/ppc64\-diag.config\/\fP) +.TP +\fB\-d\fR, \fB\-\-debug\fR +don't daemonize, increase librtas debug level +.TP +\fB\-e\fR, \fB\-\-epowfile\fR=\fI\,FILE\/\fR +path to epow status file (default \fI\,/var/log/epow_status\/\fP) +.TP +\fB\-f\fR, \fB\-\-file\fR=\fI\,FILE\/\fR +path to RTAS test file +.TP +\fB\-h\fR, \fB\-\-help\fR +help (this message) +.TP +\fB\-l\fR, \fB\-\-logfile\fR=\fI\,FILE\/\fR +path to rtas_errd debug logfile (default \fI\,/var/log/rtas_errd.log\/\fP) +.TP +\fB\-m\fR, \fB\-\-msgsfile\fR=\fI\,FILE\/\fR +path to syslog +.TP +\fB\-p\fR, \fB\-\-platformfile\fR=\fI\,FILE\/\fR +path to platform_log (default \fI\,/var/log/platform\/\fP) +.TP +\fB\-R\fR, \fB\-\-nodrmgr\fR +no drmgr +.TP +\fB\-s\fR, \fB\-\-scenario\fR=\fI\,FILE\/\fR +path to RTAS scenario file