aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorJake Hunsaker <jhunsake@redhat.com>2017-12-19 17:17:53 -0500
committerBryn M. Reeves <bmr@redhat.com>2018-06-06 10:45:35 +0100
commit04df94418071b48a15aa80636dd34243ed374d2c (patch)
tree3893fcf2a4bd5c12c2d1ded974defcf40b017917 /man
parent2fcf5f09e0e809124aeb5e262eeecbe446824efc (diff)
downloadsos-04df94418071b48a15aa80636dd34243ed374d2c.tar.gz
[sosreport] Concurrently run plugins
Changes sos to run plugins concurrently. By default sos will now use four (4) threads to run plugins, allowing for faster overall execution of sosreport. The number of threads can be changed using the --threads commandline option. Plugins now also have a timeout applied to them as a whole to avoid situations where sosreport appears to be hung. If a plugin exceeds the timeout threshold, the plugin will be terminated immediately. - this allows sos to not only continue running normally, but should still allow for collection of commands run by the plugin up until it was terminated. The timeout is plugin controlled, and defaults to 300 seconds if not set. Note that for python2 environments, this adds a dependency on python-futures. The futures module is present in the standard library for python3 environments. Signed-off-by: Jake Hunsaker <jhunsake@redhat.com>
Diffstat (limited to 'man')
-rw-r--r--man/en/sosreport.14
1 files changed, 4 insertions, 0 deletions
diff --git a/man/en/sosreport.1 b/man/en/sosreport.1
index 8ec70c7e..b0adcd8b 100644
--- a/man/en/sosreport.1
+++ b/man/en/sosreport.1
@@ -12,6 +12,7 @@ sosreport \- Collect and package diagnostic and support data
[--no-report] [--config-file conf]\fR
[--batch] [--build] [--debug]\fR
[--label label] [--case-id id] [--ticket-number nr]
+ [--threads threads]
[-s|--sysroot SYSROOT]\fR
[-c|--chroot {auto|always|never}\fR
[--tmp-dir directory]\fR
@@ -131,6 +132,9 @@ 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 \--case-id NUMBER
Specify a case identifier to associate with the archive.
Identifiers may include alphanumeric characters, commas and periods ('.').