aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorJake Hunsaker <jhunsake@redhat.com>2023-02-07 12:54:49 -0500
committerJake Hunsaker <jhunsake@redhat.com>2023-03-07 17:34:32 -0500
commit61e36af743cd0bffcac2c0759ac13d2493caec93 (patch)
tree81a8e93279bf13cd3099cff99bdecd92f170b9b0 /man
parente8dc0e55988b36d0476bcae741652208356f0f07 (diff)
downloadsos-61e36af743cd0bffcac2c0759ac13d2493caec93.tar.gz
[report] Allow users to constrain sos process priority
Adds a new `--low-priority` option to report, which will attempt to constrain the process priority for the report generation. We do this by attempting to set ourselves to an 'idle' IO class, as well as setting our niceness to 19 to avoid contending for CPU time. This is also exposed via `sos collect`, however users should note that this will not be effective until the sos-4.5.1 release. Closes: #3127 Signed-off-by: Jake Hunsaker <jhunsake@redhat.com>
Diffstat (limited to 'man')
-rw-r--r--man/en/sos-report.16
1 files changed, 6 insertions, 0 deletions
diff --git a/man/en/sos-report.1 b/man/en/sos-report.1
index 4facd556..c4859b8f 100644
--- a/man/en/sos-report.1
+++ b/man/en/sos-report.1
@@ -33,6 +33,7 @@ sos report \- Collect and package diagnostic and support data
[--skip-commands commands]\fR
[--skip-files files]\fR
[--allow-system-changes]\fR
+ [--low-priority]\fR
[-z|--compression-type method]\fR
[--encrypt]\fR
[--encrypt-key KEY]\fR
@@ -230,6 +231,11 @@ for example \fB/etc/sos/*\fR.
.B \--allow-system-changes
Run commands even if they can change the system (e.g. load kernel modules).
.TP
+.B \--low-priority
+Set sos to execute as a low priority process so that is does not interfere with
+other processes running on the system. Specific distributions may set their own
+constraints, but by default this involves setting process niceness to 19 and, if
+available, setting an idle IO class via ionice.
.B \-z, \--compression-type METHOD
Override the default compression type specified by the active policy.
.TP