From 4a2fcf2e50ae4a3ef5c0f5b871f475f5ef5f5911 Mon Sep 17 00:00:00 2001 From: "Bryn M. Reeves" Date: Mon, 25 Mar 2013 17:24:51 +0000 Subject: Rename --silent to --quiet 'silent' is a poort name for an option that admits to not being silent: --silent Only display FATAL errors on stdout Rename the option to '--quiet' instead and document it in the man page. It's probably also worth either documenting the fact that UI text is still printed when --quiet is given in non-batch mode or changing interactive mode to only print essential prompts when run with --quiet. Signed-off-by: Bryn M. Reeves --- man/en/sosreport.1 | 3 +++ 1 file changed, 3 insertions(+) (limited to 'man') diff --git a/man/en/sosreport.1 b/man/en/sosreport.1 index e28e7581..9f47f3c7 100644 --- a/man/en/sosreport.1 +++ b/man/en/sosreport.1 @@ -45,6 +45,9 @@ Upload the report to Red Hat (use exclusively if advised from a Red Hat support .B \-v, \--verbose Increase the verbosity of the output as sosreport is running. Multiple -v mean more verbosity. .TP +.B \-q, \--quiet +Only log fatal errors to stderr. +.TP .B \--report Enable html/xml report writing .TP -- cgit From e4f82d7b153cfe2d655cae6808f22966761d433f Mon Sep 17 00:00:00 2001 From: "Bryn M. Reeves" Date: Mon, 25 Mar 2013 18:19:01 +0000 Subject: Man page updates --- man/en/sosreport.1 | 90 ++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 64 insertions(+), 26 deletions(-) (limited to 'man') diff --git a/man/en/sosreport.1 b/man/en/sosreport.1 index 9f47f3c7..b5a56974 100644 --- a/man/en/sosreport.1 +++ b/man/en/sosreport.1 @@ -1,6 +1,6 @@ .TH SOSREPORT 1 "Tue Apr 08 2010" .SH NAME -sosreport \- Generate debugging information for this system +sosreport \- Collect and package diagnostic and support data .SH SYNOPSIS .B sosreport [-l|--list-plugins]\fR @@ -13,74 +13,112 @@ sosreport \- Generate debugging information for this system [--debug] [--upload] [--tmp-dir directory]\fR [--profile] [--help]\fR .SH DESCRIPTION -\fBsosreport\fR generates a compressed tarball of debugging information -for the system it is run on that can be sent to technical support -reps that will give them a more complete view of the overall system -status. +\fBsosreport\fR generates a compressed tar archive of diagnostic +information from the running system. The archive may be stored +locally or centrally for recording or tracking purposes or may +be sent to technical support representatives, developers or +system administrators to assist with technical fault-finding and +debugging. +.LP +Sos is modular in design and is able to collect data from a wide +range of subsystems and packages that may be installed. An +XML or HTML report summarizing the collected information is +optionally generated and stored within the archive. .SH OPTIONS .TP .B \-l, \--list-plugins -This will list all available plugins showing which ones will be enabled by the current configuration. It will also show all plugin options which can be -modified using the -k option (see below). +List all available plugins and their options. Plug-ins that would +not be enabled by the current configuration are listed separately. .TP .B \-n, --skip-plugins PLUGNAME[,PLUGNAME] -Do not load specified plugin(s). To specify multiple plugins, separate them with a comma. +Disable the specified plugin(s). Multiple plug-ins may be specified +by repeating the option or as a comma-separated list. .TP .B \-e, --enable-plugins PLUGNAME[,PLUGNAME] -Enable the specified plugin(s). To specify multiple plugins, separate them with a comma. +Enable the specified plugin(s). Multiple plug-ins may be specified +by repeating the option or as a comma-separated list. .TP .B \-o, --only-plugins PLUGNAME[,PLUGNAME] -Enable the specified plugin(s) only (all other plugins should be disabled). To specify multiple plugins, separate them with a comma. +Enable the specified plugin(s) only (all other plugins should be +disabled). Multiple plugins may be specified by repeating the option +or as a comma-separated list. .TP .B \-k PLUGNAME.PLUGOPT[=VALUE] -This is used to specify options for plugins. A list of available plugin options can be obtained from the output of --list-plugins. -If no value is specified and the option is a boolean (on/off), it will be set to "on". +Specify plug-in options. The option PLUGOPT is enabled, or set to the +specified value in the plug-in PLUGNAME. .TP .B \-a, \--alloptions -Enable all (boolean) options for all loaded plugins. +Set all boolean options to True for all enabled plug-ins. .TP .B \--upload FTP_SERVER -Upload the report to Red Hat (use exclusively if advised from a Red Hat support representative). +Upload the report to the configured destination. .TP .B \-v, \--verbose -Increase the verbosity of the output as sosreport is running. Multiple -v mean more verbosity. +Increase logging verbosity. May be specified multiple times to enable +additional debugging messages. .TP .B \-q, \--quiet Only log fatal errors to stderr. .TP .B \--report -Enable html/xml report writing +Enable HTML/XML report writing. .TP .B \--config-file CONFIG -Specify alternate configuration file +Specify alternate configuration file. .TP .B \--tmp-dir DIRECTORY -Specify alternate temporary directory to copy data as well as the compressed report. +Specify alternate temporary directory to copy data as well as the +compressed report. .TP .B \--batch -Perform data gathering unattended +Generate archive without prompting for interactive input. .TP .B \--name NAME -Define a unique name for archive +Specify a name to be used for the archive. .TP .B \--ticket-number NUMBER -Define a unique number for archive +Specify a ticket number to be used for archive .TP .B \--build -Do not archive copied data, leave directory tree untouched for further modification +Do not archive copied data. Causes sosreport to leave an uncompressed +archive as a temporary file or directory tree. .TP .B \--debug -Give opportunity to debug python exceptions through the python debugger. +Enable interactive debugging using the python debugger. Exceptions in +sos or plug-in code will cause a trap to the pdb shell. .TP .B \--profile -Turn on profiling for cmds run +Enable profiler logging. .TP .B \--help -Display sosreport help system. +Display usage message. .SH MAINTAINER .nf -Adam Stokes +Bryn M. Reeves .fi +.SH AUTHORS & CONTRIBUTORS + +Adam Stokes, +Ben Turner, +Bryn M. Reeves, +Eugene Teo, +Gary Kotton, +Jesse Jaggars, +Joey Boggs, +John Berninger, +Justin Payne, +Keith Kearnan, +Kent Lamb, +Marc Sauton, +Navid Sheikhol-Eslami, +Pierre Amadio , +Pierre Carrier, +Ranjith Rajaram, +Sadique Puthen, +Shijoe George, +Steve Conklin, +Tomas Smetana +.nf .SH TRANSLATIONS .nf Translations are handled by transifex (https://fedorahosted.org/transifex/) -- cgit