aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJose Castillo <jcastillo@redhat.com>2020-05-22 11:30:28 +0100
committerJake Hunsaker <jhunsake@redhat.com>2021-02-22 10:33:00 -0500
commit7ac0fdbc4a7467ffdf54a96fa4dced11a6be22ed (patch)
tree1337fd7863f94bf7b514a957d555d4c34d511cd0
parent20d8938fe948c4bbfedd6b68b59a543e8b2baaca (diff)
downloadsos-7ac0fdbc4a7467ffdf54a96fa4dced11a6be22ed.tar.gz
Clarify default timeout for all plugins
The default timeout for all plugins is 300, but the global timeout is set as -1 in the option list. This is because this timeout is unset by default. This patch attempts to clarify the -1 exposed to the user when using commands like 'sos report -l', via the option description as well as a note clarifying it in the man page. Closes: #2003 Resolves: #2415 Signed-off-by: Jose Castillo <jcastillo@redhat.com> Signed-off-by: Jake Hunsaker <jhunsake@redhat.com>
-rw-r--r--man/en/sos-report.13
-rw-r--r--sos/report/plugins/__init__.py3
2 files changed, 4 insertions, 2 deletions
diff --git a/man/en/sos-report.1 b/man/en/sos-report.1
index fcf3d020..e7fae97b 100644
--- a/man/en/sos-report.1
+++ b/man/en/sos-report.1
@@ -243,7 +243,8 @@ 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.
+means no timeout will be set. A value of -1 is used to indicate the default
+timeout of 300 seconds.
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
diff --git a/sos/report/plugins/__init__.py b/sos/report/plugins/__init__.py
index 9074625c..02625eb1 100644
--- a/sos/report/plugins/__init__.py
+++ b/sos/report/plugins/__init__.py
@@ -470,7 +470,8 @@ class Plugin(object):
predicate = None
cmd_predicate = None
_default_plug_opts = [
- ('timeout', 'Timeout in seconds for plugin', 'fast', -1),
+ ('timeout', 'Timeout in seconds for plugin. The default value (-1) ' +
+ 'defers to the general plugin timeout, 300 seconds', 'fast', -1),
('postproc', 'Enable post-processing collected plugin data', 'fast',
True)
]