From df4d2dc570337cbfe6b6b0ab80b938fe3391dac5 Mon Sep 17 00:00:00 2001 From: Jim Warner Date: Sun, 24 Apr 2022 00:00:00 -0500 Subject: [PATCH] doc: added provision for autogroup nice (AGNI) changes Signed-off-by: Jim Warner --- NEWS | 1 + top/top.1 | 18 +++++++++++++++++- 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index 0e705e92..2209e615 100644 --- a/NEWS +++ b/NEWS @@ -6,6 +6,7 @@ procps-ng-NEXT * sysctl: print dotted keys again * top: fix 'smaps' bug preventing build under clang issue #235 * top: column highlighting allowed under 'L' or 'O' + * top: can alter autogroup nice value (like 'r' renice) procps-ng-4.0.0 --------------- diff --git a/top/top.1 b/top/top.1 index 814bccd5..cc12a5fc 100644 --- a/top/top.1 +++ b/top/top.1 @@ -1262,7 +1262,7 @@ depending on the context in which they are issued. .nf 4a.\fI Global-Commands \fR ?, =, 0, - A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z + A, B, d, E, e, g, H, h, I, k, q, r, s, W, X, Y, Z, ^R 4b.\fI Summary-Area-Commands \fR C, l, t, m, 1, 2, 3, 4, ! 4c.\fI Task-Area-Commands \fR @@ -1520,6 +1520,22 @@ This key will take you to a separate screen where you can change the colors for the \*(CW, or for all windows. For details regarding this \*(CI \*(Xt 4d. COLOR Mapping. +.TP 7 +*\ \ \fB^R\fR\ \ :\fIRenice-an-Autogroup \fR (Ctrl key + `r') +You will be prompted for a PID and then the value for its +autogroup AGNI. + +Entering no PID will be interpreted as the default shown in +the prompt (the first task displayed). + +A positive AGNI value will cause processes in that autogroup +to lose priority. +Conversely, a negative value causes them to be viewed more +favorably by the kernel. +Ordinary users are not allowed to set negative AGNI values. + +If you wish to abort the renice process type . + .IP "*" 3 The commands shown with an \*(AK are not available in Secure mode, nor will they be shown on the level-1 help screen.