diff --git a/NEWS b/NEWS index f35755bd..d744fbb1 100644 --- a/NEWS +++ b/NEWS @@ -10,6 +10,8 @@ procps-ng-NEXT * top: the time related fields can now be user scaled * top: added a 'start time' field (STARTED) * top: column highlighting allowed under 'L' or 'O' + * top: can display the following with no need to scroll + * cmdline, control groups, environment, supp groups procps-ng-3.3.17 diff --git a/top/top.1 b/top/top.1 index d78e9bcc..58e3f9bd 100644 --- a/top/top.1 +++ b/top/top.1 @@ -1139,7 +1139,8 @@ 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, + ^G, ^K, ^U, ^V 4b.\fI Summary-Area-Commands \fR C, l, t, m, 1, 2, 3, 4, ! 4c.\fI Task-Area-Commands \fR @@ -1397,6 +1398,39 @@ 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. +.P +\ \ \ \fB^G\fR\ \ :\fIDisplay-Full-Control-Groups \fR (Ctrl key + `g') +.br +\ \ \ \fB^K\fR\ \ :\fIDisplay-Full-Cmdline \fR (Ctrl key + `k') +.br +\ \ \ \fB^U\fR\ \ :\fIDisplay-Full-Supplementary-Groups \fR (Ctrl key + `u') +.br +\ \ \ \fB^V\fR\ \ :\fIDisplay-Full-Environment \fR (Ctrl key + `v') +.br +.RS +7 +Applied to the first process displayed, these commands will show +that task's full (potentially wrapped) information. +Such data will be displayed in a separate window at the bottom of +the screen. + +Keying the same command a second time removes that separate window +as does the death of the targeted task. +Keying a different Ctrl combination, while one is already active, +immediately transitions to the new information. + +Notable among these provisions is the Ctrl+V (environment) command. +Its output can be extensive and not easily read when line wrapped. +A more readable version can be achieved with an `Inspect' entry +in the rcfile like the following. + +.nf + pipe ^I Environment ^I cat /proc/%d/environ | tr '\\0' '\\n' +.fi + +\*(XC `Y' \*(CI above and topic 6b. ADDING INSPECT Entries for +additional information. +.RS -7 + .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.