[docs] Add general sos manpage, rename sosreport.1, add symlinks

Adds a general manpage for the sos command that then points to the
available components.

Renames sosreport.1 to sos-report.1 to match the component style, and
then symlinks sosreport.1 to it.

Adds a symlink from sos-collector.1 to sos-collect.1.

Signed-off-by: Jake Hunsaker <jhunsake@redhat.com>

4 files changed, 418 insertions, 334 deletions

diff --git a/man/en/sos-collector.1 b/man/en/sos-collector.1
new file mode 120000
index 00000000..4304b380
--- /dev/null
+++ b/man/en/sos-collector.1
@@ -0,0 +1 @@
+sos-collect.1
\ No newline at end of file
diff --git a/man/en/sos-report.1 b/man/en/sos-report.1
new file mode 100644
index 00000000..4f7185f1
--- /dev/null
+++ b/man/en/sos-report.1
@@ -0,0 +1,334 @@
+.TH SOSREPORT 1 "Mon Mar 25 2013"
+.SH NAME
+sosreport \- Collect and package diagnostic and support data
+.SH SYNOPSIS
+.B sosreport
+          [-l|--list-plugins]\fR
+          [-n|--skip-plugins plugin-names]\fR
+          [-e|--enable-plugins plugin-names]\fR
+          [-o|--only-plugins plugin-names]\fR
+          [-a|--alloptions] [-v|--verbose]\fR
+          [-k plug.opt|--plugin-option plug.opt]\fR
+          [--no-report] [--config-file conf]\fR
+          [--no-postproc]\fR
+          [--preset preset] [--add-preset add_preset]\fR
+          [--del-preset del_preset] [--desc description]\fR
+          [--batch] [--build] [--debug] [--dry-run]\fR
+          [--label label] [--case-id id] [--ticket-number nr]\fR
+          [--threads threads]\fR
+          [--plugin-timeout TIMEOUT]\fR
+          [-s|--sysroot SYSROOT]\fR
+          [-c|--chroot {auto|always|never}\fR
+          [--tmp-dir directory]\fR
+          [-p|--profile profile-name]\fR
+          [--list-profiles]\fR
+          [--verify]\fR
+          [--log-size]\fR
+          [--all-logs]\fR
+          [--since YYYYMMDD[HHMMSS]]\fR
+          [--allow-system-changes]\fR
+          [-z|--compression-type method]\fR
+          [--encrypt-key KEY]\fR
+          [--encrypt-pass PASS]\fR
+          [--upload] [--upload-url url] [--upload-user user]\fR
+          [--upload-directory dir] [--upload-pass pass]\fR
+          [--experimental]\fR
+          [-h|--help]\fR
+
+.SH DESCRIPTION
+\fBsosreport\fR generates an archive of configuration and 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
+HTML report summarizing the collected information is optionally
+generated and stored within the archive.
+.SH OPTIONS
+.TP
+.B \-l, \--list-plugins
+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]
+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). 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). Multiple plugins may be specified by repeating the option
+or as a comma-separated list.
+.TP
+.B \-k PLUGNAME.PLUGOPT[=VALUE], \--plugin-option=PLUGNAME.PLUGOPT[=VALUE]
+Specify plug-in options. The option PLUGOPT is enabled, or set to the
+specified value in the plug-in PLUGNAME.
+.TP
+.B \-a, \--alloptions
+Set all boolean options to True for all enabled plug-ins.
+.TP
+.B \-v, \--verbose
+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 \--no-report
+Disable HTML report writing.
+.TP
+.B \--config-file CONFIG
+Specify alternate configuration file.
+.TP
+.B \-\-no-postproc
+Disable postprocessing globally for all plugins. This will mean data is not
+obfuscated/sanitized from the archive during collection.
+
+Note that this means data such as password, SSH keys, certificates, etc...
+will be collected in plain text.
+
+To selectively disable postprocessing on a per-plugin basis, use the 'postproc'
+plugin option available to all plugins, e.g. '-k podman.postproc=off'.
+.TP
+.B \--preset PRESET
+Specify an existing preset to use for sos options.
+
+Presets are pre-configured sets of options for both sos and sos plugins. For
+example a preset may enable a certain set of plugins, disable others, or enable
+specific plugin options. They may also specify sos options such as log-size or
+package verification.
+
+User defined presets are saved under /var/lib/sos/presets as JSON-formatted files.
+.TP
+.B \--add-preset ADD_PRESET [options]
+Add a preset with name ADD_PRESET that enables [options] when called.
+
+For example, 'sosreport --add-preset mypreset --log-size=50 -n logs' will enable
+a user to run 'sosreport --preset mypreset' that sets the maximum log size to
+50 and disables the logs plugin.
+
+Note: to set a description for the preset that is displayed with \fB--list-presets\fR,
+use the \fB--desc\fR option.
+
+Note: to set a behaviour note of the preset, use --note option.
+.TP
+.B \--del-preset DEL_PRESET
+Deletes the preset with name DEL_PRESET from the filesystem so that it can no
+longer be used.
+.TP
+.B \--list-presets
+Display a list of available presets and what options they carry.
+.TP
+.B \--desc DESCRIPTION
+When using \fB--add-preset\fR use this option to add a description of the preset
+that will be displayed when using \fB--list-presets\fR.
+.TP
+.B \-s, \--sysroot SYSROOT
+Specify an alternate root file system path. Useful for collecting
+reports from containers and images.
+.TP
+.B \-c, \--chroot {auto|always|never}
+Set the chroot mode. When \--sysroot is used commands default to
+executing with SYSROOT as the root directory (unless disabled by
+a specific plugin). This can be overriden by setting \--chroot to
+"always" (always chroot) or "never" (always run in the host
+namespace).
+.TP
+.B \--tmp-dir DIRECTORY
+Specify alternate temporary directory to copy data as well as the
+compressed report.
+.TP
+.B \--list-profiles
+Display a list of available profiles and the plugins that they enable.
+.TP
+.B \-p, \--profile NAME
+Only run plugins that correspond to the given profile. Multple profiles
+may be specified as a comma-separated list; the set of plugins executed
+is the union of each of the profile's plugin sets. Currently defined
+profiles include: boot, cluster, desktop, debug, hardware, identity,
+network, openstack, packagemanager, security, services, storage,
+sysmgmt, system, performance, virt, and webserver.
+.TP
+.B \--verify
+Instructs plugins to perform plugin-specific verification during data
+collection. This may include package manager verification, log integrity
+testing or other plugin defined behaviour. Use of \--verify may cause
+the time taken to generate a report to be considerably longer.
+.TP
+.B \--log-size
+Places a global limit on the size (in MiB) of any collected set of logs. The
+limit is applied separately for each set of logs collected by any
+plugin.
+.TP
+.B \--all-logs
+Tell plugins to collect all possible log data ignoring any size limits
+and including logs in non-default locations. This option may significantly
+increase the size of reports.
+.TP
+.B \--since YYYYMMDD[HHMMSS]
+Limits the collection of log archives to those newer than this date. A log
+archive is any file not found in /etc, that has either a numeric or a
+compression-type file extension for example ".zip". ".1", ".gz" etc.).
+This also affects \--all-logs. The date string will be padded with zeros
+if HHMMSS is not specified.
+.TP
+.B \--allow-system-changes
+Run commands even if they can change the system (e.g. load kernel modules).
+.TP
+.B \-z, \--compression-type METHOD
+Override the default compression type specified by the active policy.
+.TP
+.B \--encrypt-key KEY
+Encrypts the resulting archive that sosreport produces using GPG. KEY must be
+an existing key in the user's keyring as GPG does not allow for keyfiles.
+KEY can be any value accepted by gpg's 'recipient' option.
+
+Note that the user running sosreport must match the user owning the keyring
+from which keys will be obtained. In particular this means that if sudo is
+used to run sosreport, the keyring must also be set up using sudo
+(or direct shell access to the account).
+
+Users should be aware that encrypting the final archive will result in sos
+using double the amount of temporary disk space - the encrypted archive must be
+written as a separate, rather than replacement, file within the temp directory
+that sos writes the archive to. However, since the encrypted archive will be
+the same size as the original archive, there is no additional space consumption
+once the temporary directory is removed at the end of execution.
+
+This means that only the encrypted archive is present on disk after sos
+finishes running.
+
+If encryption fails for any reason, the original unencrypted archive is
+preserved instead.
+.TP
+.B \--encrypt-pass PASS
+The same as \--encrypt-key, but use the provided PASS for symmetric encryption
+rather than key-pair encryption.
+.TP
+.B \--batch
+Generate archive without prompting for interactive input.
+.TP
+.B \--name NAME
+Deprecated. See \--label
+.TP
+.B \--label LABEL
+Specify an arbitrary identifier to associate with the archive.
+Labels will be appended after the system's short hostname and may contain
+alphanumeric characters.
+.TP
+.B \--threads THREADS
+Specify the number of threads sosreport will use for concurrency. Defaults to 4.
+.TP
+.B \--plugin-timeout TIMEOUT
+Specify a timeout in seconds to allow each plugin to run for. A value of 0
+means no timeout will be set.
+
+Note that this options sets the timeout for all plugins. If you want to set
+a timeout for a specific plugin, use the 'timeout' plugin option available to
+all plugins - e.g. '-k logs.timeout=600'.
+
+The plugin-specific timeout option will override this option. For example, using
+\'--plugin-timeout=60 -k logs.timeout=600\' will set a timeout of 600 seconds for
+the logs plugin and 60 seconds for all other enabled plugins.
+.TP
+.B \--case-id NUMBER
+Specify a case identifier to associate with the archive.
+Identifiers may include alphanumeric characters, commas and periods ('.').
+Synonymous with \--ticket-number.
+.TP
+.B \--ticket-number NUMBER
+Specify a ticket number or other identifier to associate with the archive.
+Identifiers may include alphanumeric characters, commas and periods ('.').
+Synonymous with \--case-id.
+.TP
+.B \--build
+Do not archive copied data. Causes sosreport to leave an uncompressed
+archive as a temporary file or directory tree.
+.TP
+.B \--debug
+Enable interactive debugging using the python debugger. Exceptions in
+sos or plug-in code will cause a trap to the pdb shell.
+.TP
+.B \--dry-run
+Execute plugins as normal, but do not collect any file content, command
+output, or string data from the system. The resulting logs may be used
+to understand the actions that sos would have taken without the dry run
+option.
+.TP
+.B \--upload
+If specified, attempt to upload the resulting archive to a vendor defined location.
+
+This option is implied if --upload-url is used.
+
+You may be prompted for a username and password if these are not defined by the vendor
+as well. If these credentials are not provided, sos will still run and create an archive
+but will not attempt an automatic upload, instead relying on the end user to upload it
+as needed.
+
+The sosreport archive will still remain on the local filesystem even after a successful
+upload.
+
+Note that depending on the distribution sos is being run on, or the vendor policy detected during
+execution, there may be dependencies that are not strictly required by the package
+at installation time.
+
+For example, for HTTPS uploads the python-requests library must be available. If this
+library is not available, HTTPS uploads will not be attempted.
+.TP
+.B \--upload-url URL
+If a vendor does not provide a default upload location, or if you would like to upload
+the archive to a different location, specify the address here.
+
+A support protocol MUST be specified in this URL. Currently uploading is supported
+for HTTPS, SFTP, and FTP protocols.
+
+If your destination server listens on a non-standard port, specify the listening
+port in the URL.
+.TP
+.B \-\-upload-user USER
+If a vendor does not provide a default user for uploading, specify the username here.
+
+If this option is unused and upload is request, and a vendor default is not set, you
+will be prompted for one. If --batch is used and this option is omitted, no username will
+be collected and thus uploads will fail if no vendor default is set.
+.TP
+.B \-\-upload-pass PASS
+Specify the password to use for authentication with the destination server.
+
+If this option is omitted and upload is requested, you will be prompted for one.
+
+If --batch is used, this prompt will not occur, so any uploads are likely to fail unless
+this option is used.
+
+Note that this will result in the plaintext string appearing in `ps` output that may
+be collected by sos and be in the archive. If a password must be provided by you
+for uploading, it is strongly recommended to not use --batch and enter the password
+when prompted rather than using this option.
+.TP
+.B \--upload-directory DIR
+Specify a directory to upload to, if one is not specified by a vendor default location
+or if your destination server does not allow writes to '/'.
+.TP
+.B \--experimental
+Enable plugins marked as experimental. Experimental plugins may not have
+been tested for this port or may still be under active development.
+.TP
+.B \--help
+Display usage message.
+.SH MAINTAINER
+.nf
+Bryn M. Reeves <bmr@redhat.com>
+.fi
+.SH AUTHORS & CONTRIBUTORS
+See \fBAUTHORS\fR file in the package documentation.
+.nf
+.SH TRANSLATIONS
+.nf
+Translations are handled by transifex (https://fedorahosted.org/transifex/)
+.fi
+.fi
diff --git a/man/en/sos.1 b/man/en/sos.1
new file mode 100644
index 00000000..0444dba4
--- /dev/null
+++ b/man/en/sos.1
@@ -0,0 +1,82 @@
+.TH sos 1 "April 2020"
+
+.SH NAME
+sos \- A unified tool for collecting system logs and other debug information
+.SH SYNOPSIS
+\fBsos\fR component [options]
+
+.SH DESCRIPTION
+\fBsos\fR is a diagnostic data collection utility, used by system administrators,
+support representatives, and the like to assist in troubleshooting issues with
+a system or group of systems.
+
+The most well known function is \fB sos report\fR or \fBsosreport\fR as it was
+previously known.
+
+An sos archive is typically requested by support organizations to collect baseline
+configuration and system data from which to begin the troubleshooting process.
+
+
+.SH COMPONENTS
+
+sos supports several subcommands or components. Each provides a different set
+of information for the user. Supported components are as follows
+
+.TP
+.B report
+Report generates an archive of system information including configuration files
+and command output. Information included in the report is based upon plugins that
+are activated automatically when certain criteria, such as installed packages, files,
+services, or system architecture is detected.
+
+See \fBsos report --help\fR and \fBman sos-report\fR for more information.
+
+May also be invoked via the alias \fBrep\fR or the deprecated command \fBsosreport\fR.
+
+.TP
+.B collect
+Collect is used to capture reports on multiple systems simultaneously. These
+systems can either be defined by the user at the command line and/or defined by
+clustering software that exists either on the local system or on a "master" system
+that is able to inform about other nodes in the cluster.
+
+When running collect, sos report will be run on the remote nodes, and then the
+resulting archives will be copied from those nodes to the local system running
+sos collect. Archives are then removed from the remote systems.
+
+See \fBsos collect --help\fR and \fBman sos-collect\fR for more information.
+
+May also be invoked via the alias \fBsos collector\fR or the deprecated command
+\fBsos-collector\fR.
+
+.SH GLOBAL OPTIONS
+sos components provide their own set of options, however the following are available
+to be set across all components.
+
+.B \--config-file CONFIG
+Specify alternate configuration file.
+.TP
+.B \-s, \--sysroot SYSROOT
+Specify an alternate root file system path.
+.TP
+.B \--tmp-dir DIRECTORY
+Specify alternate temporary directory to copy data during execution.
+.TP
+.B \--threads THREADS
+Specify the number of threads sosreport will use for concurrency. Defaults to 4. 
+.TP
+.B \-v, \--verbose
+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 \--help
+Display usage message.
+.SH MAINTAINER
+.nf
+Jake Hunsaker <jhunsake@redhat.com>
+.fi
+.SH AUTHORS & CONTRIBUTORS
+See \fBAUTHORS\fR file in the package documentation.
diff --git a/man/en/sosreport.1 b/man/en/sosreport.1
index 4f7185f1..d1716cce 100644..120000
--- a/man/en/sosreport.1
+++ b/man/en/sosreport.1
@@ -1,334 +1 @@
-.TH SOSREPORT 1 "Mon Mar 25 2013"
-.SH NAME
-sosreport \- Collect and package diagnostic and support data
-.SH SYNOPSIS
-.B sosreport
-          [-l|--list-plugins]\fR
-          [-n|--skip-plugins plugin-names]\fR
-          [-e|--enable-plugins plugin-names]\fR
-          [-o|--only-plugins plugin-names]\fR
-          [-a|--alloptions] [-v|--verbose]\fR
-          [-k plug.opt|--plugin-option plug.opt]\fR
-          [--no-report] [--config-file conf]\fR
-          [--no-postproc]\fR
-          [--preset preset] [--add-preset add_preset]\fR
-          [--del-preset del_preset] [--desc description]\fR
-          [--batch] [--build] [--debug] [--dry-run]\fR
-          [--label label] [--case-id id] [--ticket-number nr]\fR
-          [--threads threads]\fR
-          [--plugin-timeout TIMEOUT]\fR
-          [-s|--sysroot SYSROOT]\fR
-          [-c|--chroot {auto|always|never}\fR
-          [--tmp-dir directory]\fR
-          [-p|--profile profile-name]\fR
-          [--list-profiles]\fR
-          [--verify]\fR
-          [--log-size]\fR
-          [--all-logs]\fR
-          [--since YYYYMMDD[HHMMSS]]\fR
-          [--allow-system-changes]\fR
-          [-z|--compression-type method]\fR
-          [--encrypt-key KEY]\fR
-          [--encrypt-pass PASS]\fR
-          [--upload] [--upload-url url] [--upload-user user]\fR
-          [--upload-directory dir] [--upload-pass pass]\fR
-          [--experimental]\fR
-          [-h|--help]\fR
-
-.SH DESCRIPTION
-\fBsosreport\fR generates an archive of configuration and 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
-HTML report summarizing the collected information is optionally
-generated and stored within the archive.
-.SH OPTIONS
-.TP
-.B \-l, \--list-plugins
-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]
-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). 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). Multiple plugins may be specified by repeating the option
-or as a comma-separated list.
-.TP
-.B \-k PLUGNAME.PLUGOPT[=VALUE], \--plugin-option=PLUGNAME.PLUGOPT[=VALUE]
-Specify plug-in options. The option PLUGOPT is enabled, or set to the
-specified value in the plug-in PLUGNAME.
-.TP
-.B \-a, \--alloptions
-Set all boolean options to True for all enabled plug-ins.
-.TP
-.B \-v, \--verbose
-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 \--no-report
-Disable HTML report writing.
-.TP
-.B \--config-file CONFIG
-Specify alternate configuration file.
-.TP
-.B \-\-no-postproc
-Disable postprocessing globally for all plugins. This will mean data is not
-obfuscated/sanitized from the archive during collection.
-
-Note that this means data such as password, SSH keys, certificates, etc...
-will be collected in plain text.
-
-To selectively disable postprocessing on a per-plugin basis, use the 'postproc'
-plugin option available to all plugins, e.g. '-k podman.postproc=off'.
-.TP
-.B \--preset PRESET
-Specify an existing preset to use for sos options.
-
-Presets are pre-configured sets of options for both sos and sos plugins. For
-example a preset may enable a certain set of plugins, disable others, or enable
-specific plugin options. They may also specify sos options such as log-size or
-package verification.
-
-User defined presets are saved under /var/lib/sos/presets as JSON-formatted files.
-.TP
-.B \--add-preset ADD_PRESET [options]
-Add a preset with name ADD_PRESET that enables [options] when called.
-
-For example, 'sosreport --add-preset mypreset --log-size=50 -n logs' will enable
-a user to run 'sosreport --preset mypreset' that sets the maximum log size to
-50 and disables the logs plugin.
-
-Note: to set a description for the preset that is displayed with \fB--list-presets\fR,
-use the \fB--desc\fR option.
-
-Note: to set a behaviour note of the preset, use --note option.
-.TP
-.B \--del-preset DEL_PRESET
-Deletes the preset with name DEL_PRESET from the filesystem so that it can no
-longer be used.
-.TP
-.B \--list-presets
-Display a list of available presets and what options they carry.
-.TP
-.B \--desc DESCRIPTION
-When using \fB--add-preset\fR use this option to add a description of the preset
-that will be displayed when using \fB--list-presets\fR.
-.TP
-.B \-s, \--sysroot SYSROOT
-Specify an alternate root file system path. Useful for collecting
-reports from containers and images.
-.TP
-.B \-c, \--chroot {auto|always|never}
-Set the chroot mode. When \--sysroot is used commands default to
-executing with SYSROOT as the root directory (unless disabled by
-a specific plugin). This can be overriden by setting \--chroot to
-"always" (always chroot) or "never" (always run in the host
-namespace).
-.TP
-.B \--tmp-dir DIRECTORY
-Specify alternate temporary directory to copy data as well as the
-compressed report.
-.TP
-.B \--list-profiles
-Display a list of available profiles and the plugins that they enable.
-.TP
-.B \-p, \--profile NAME
-Only run plugins that correspond to the given profile. Multple profiles
-may be specified as a comma-separated list; the set of plugins executed
-is the union of each of the profile's plugin sets. Currently defined
-profiles include: boot, cluster, desktop, debug, hardware, identity,
-network, openstack, packagemanager, security, services, storage,
-sysmgmt, system, performance, virt, and webserver.
-.TP
-.B \--verify
-Instructs plugins to perform plugin-specific verification during data
-collection. This may include package manager verification, log integrity
-testing or other plugin defined behaviour. Use of \--verify may cause
-the time taken to generate a report to be considerably longer.
-.TP
-.B \--log-size
-Places a global limit on the size (in MiB) of any collected set of logs. The
-limit is applied separately for each set of logs collected by any
-plugin.
-.TP
-.B \--all-logs
-Tell plugins to collect all possible log data ignoring any size limits
-and including logs in non-default locations. This option may significantly
-increase the size of reports.
-.TP
-.B \--since YYYYMMDD[HHMMSS]
-Limits the collection of log archives to those newer than this date. A log
-archive is any file not found in /etc, that has either a numeric or a
-compression-type file extension for example ".zip". ".1", ".gz" etc.).
-This also affects \--all-logs. The date string will be padded with zeros
-if HHMMSS is not specified.
-.TP
-.B \--allow-system-changes
-Run commands even if they can change the system (e.g. load kernel modules).
-.TP
-.B \-z, \--compression-type METHOD
-Override the default compression type specified by the active policy.
-.TP
-.B \--encrypt-key KEY
-Encrypts the resulting archive that sosreport produces using GPG. KEY must be
-an existing key in the user's keyring as GPG does not allow for keyfiles.
-KEY can be any value accepted by gpg's 'recipient' option.
-
-Note that the user running sosreport must match the user owning the keyring
-from which keys will be obtained. In particular this means that if sudo is
-used to run sosreport, the keyring must also be set up using sudo
-(or direct shell access to the account).
-
-Users should be aware that encrypting the final archive will result in sos
-using double the amount of temporary disk space - the encrypted archive must be
-written as a separate, rather than replacement, file within the temp directory
-that sos writes the archive to. However, since the encrypted archive will be
-the same size as the original archive, there is no additional space consumption
-once the temporary directory is removed at the end of execution.
-
-This means that only the encrypted archive is present on disk after sos
-finishes running.
-
-If encryption fails for any reason, the original unencrypted archive is
-preserved instead.
-.TP
-.B \--encrypt-pass PASS
-The same as \--encrypt-key, but use the provided PASS for symmetric encryption
-rather than key-pair encryption.
-.TP
-.B \--batch
-Generate archive without prompting for interactive input.
-.TP
-.B \--name NAME
-Deprecated. See \--label
-.TP
-.B \--label LABEL
-Specify an arbitrary identifier to associate with the archive.
-Labels will be appended after the system's short hostname and may contain
-alphanumeric characters.
-.TP
-.B \--threads THREADS
-Specify the number of threads sosreport will use for concurrency. Defaults to 4.
-.TP
-.B \--plugin-timeout TIMEOUT
-Specify a timeout in seconds to allow each plugin to run for. A value of 0
-means no timeout will be set.
-
-Note that this options sets the timeout for all plugins. If you want to set
-a timeout for a specific plugin, use the 'timeout' plugin option available to
-all plugins - e.g. '-k logs.timeout=600'.
-
-The plugin-specific timeout option will override this option. For example, using
-\'--plugin-timeout=60 -k logs.timeout=600\' will set a timeout of 600 seconds for
-the logs plugin and 60 seconds for all other enabled plugins.
-.TP
-.B \--case-id NUMBER
-Specify a case identifier to associate with the archive.
-Identifiers may include alphanumeric characters, commas and periods ('.').
-Synonymous with \--ticket-number.
-.TP
-.B \--ticket-number NUMBER
-Specify a ticket number or other identifier to associate with the archive.
-Identifiers may include alphanumeric characters, commas and periods ('.').
-Synonymous with \--case-id.
-.TP
-.B \--build
-Do not archive copied data. Causes sosreport to leave an uncompressed
-archive as a temporary file or directory tree.
-.TP
-.B \--debug
-Enable interactive debugging using the python debugger. Exceptions in
-sos or plug-in code will cause a trap to the pdb shell.
-.TP
-.B \--dry-run
-Execute plugins as normal, but do not collect any file content, command
-output, or string data from the system. The resulting logs may be used
-to understand the actions that sos would have taken without the dry run
-option.
-.TP
-.B \--upload
-If specified, attempt to upload the resulting archive to a vendor defined location.
-
-This option is implied if --upload-url is used.
-
-You may be prompted for a username and password if these are not defined by the vendor
-as well. If these credentials are not provided, sos will still run and create an archive
-but will not attempt an automatic upload, instead relying on the end user to upload it
-as needed.
-
-The sosreport archive will still remain on the local filesystem even after a successful
-upload.
-
-Note that depending on the distribution sos is being run on, or the vendor policy detected during
-execution, there may be dependencies that are not strictly required by the package
-at installation time.
-
-For example, for HTTPS uploads the python-requests library must be available. If this
-library is not available, HTTPS uploads will not be attempted.
-.TP
-.B \--upload-url URL
-If a vendor does not provide a default upload location, or if you would like to upload
-the archive to a different location, specify the address here.
-
-A support protocol MUST be specified in this URL. Currently uploading is supported
-for HTTPS, SFTP, and FTP protocols.
-
-If your destination server listens on a non-standard port, specify the listening
-port in the URL.
-.TP
-.B \-\-upload-user USER
-If a vendor does not provide a default user for uploading, specify the username here.
-
-If this option is unused and upload is request, and a vendor default is not set, you
-will be prompted for one. If --batch is used and this option is omitted, no username will
-be collected and thus uploads will fail if no vendor default is set.
-.TP
-.B \-\-upload-pass PASS
-Specify the password to use for authentication with the destination server.
-
-If this option is omitted and upload is requested, you will be prompted for one.
-
-If --batch is used, this prompt will not occur, so any uploads are likely to fail unless
-this option is used.
-
-Note that this will result in the plaintext string appearing in `ps` output that may
-be collected by sos and be in the archive. If a password must be provided by you
-for uploading, it is strongly recommended to not use --batch and enter the password
-when prompted rather than using this option.
-.TP
-.B \--upload-directory DIR
-Specify a directory to upload to, if one is not specified by a vendor default location
-or if your destination server does not allow writes to '/'.
-.TP
-.B \--experimental
-Enable plugins marked as experimental. Experimental plugins may not have
-been tested for this port or may still be under active development.
-.TP
-.B \--help
-Display usage message.
-.SH MAINTAINER
-.nf
-Bryn M. Reeves <bmr@redhat.com>
-.fi
-.SH AUTHORS & CONTRIBUTORS
-See \fBAUTHORS\fR file in the package documentation.
-.nf
-.SH TRANSLATIONS
-.nf
-Translations are handled by transifex (https://fedorahosted.org/transifex/)
-.fi
-.fi
+sos-report.1
\ No newline at end of file