emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

doc: top now has more than two abreast summary display

Browse Source 
Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2022-09-10 00:00:00 -05:00 committed by Craig Small
parent 248efdf16e
commit fd529e9679
2 changed files with 31 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
NEWS
View File

@ -18,6 +18,7 @@ procps-ng-NEXT
* top: adds a 'message log' recall capability * top: adds a 'message log' recall capability
* top: will accept utf8 multi-byte input with support * top: will accept utf8 multi-byte input with support
for full line editing and previous line recall for full line editing and previous line recall
* top: can show more than 2 abreast in summary display
* watch: Add equexit no-change and exit option merge #153 * watch: Add equexit no-change and exit option merge #153
procps-ng-4.0.0 procps-ng-4.0.0

49
man/top.1
View File

@ -527,19 +527,27 @@ Depending on your kernel version, the \fBst\fR field may not be shown.
\fBst\fR : time stolen from this vm by the hypervisor \fBst\fR : time stolen from this vm by the hypervisor
.fi .fi
In the alternate cpu states display modes, beyond the first tasks/threads line, Beyond the first tasks/threads line, there are alternate \*(PU display
an abbreviated summary is shown consisting of these elements: modes available via the 4-way `t' \*(CT.
They show an abbreviated summary consisting of these elements:
.nf .nf
\fR a \fR b \fR c \fR d \fR a \fR b \fR c \fR d
%Cpu(s): \fB75.0\fR/25.0 \fB100\fR[ ... %Cpu(s): \fB75.0\fR/25.0 \fB100\fR[ ... ]
.fi .fi
Where: a) is the `user' (us + ni) percentage; b) is the `system' Where: a) is the `user' (us + ni) percentage; b) is the `system'
(sy + hi + si) percentage; c) is the total; and d) is one of two (sy + hi + si) percentage; c) is the total percentage; and d) is
visual graphs of those representations. one of two visual graphs of those representations.
\*(XT 4b. SUMMARY AREA Commands and the `t' command for additional information Such graphs also reflect separate `user' and `system' portions.
on that special 4-way toggle.
If the `4' \*(CT is used to yield more than two cpus per line,
results will be further abridged eliminating the a) and b) elements.
However, that information is still reflected in the graph itself
assuming color is active or, if not, bars vs. blocks are being shown.
\*(XT 4b. SUMMARY AREA Commands for additional information on the `t'
and `4' \*(CTs.
.\" ...................................................................... .\" ......................................................................
.SS 2c. MEMORY Usage .SS 2c. MEMORY Usage
@ -569,8 +577,8 @@ In the alternate memory display modes, two abbreviated summary lines
are shown consisting of these elements: are shown consisting of these elements:
.nf .nf
\fR a \fR b c \fR a \fR b c
GiB Mem : \fB18.7\fR/15.738 [ ... GiB Mem : \fB18.7\fR/15.738 [ ... ]
GiB Swap: \fB 0.0\fR/7.999 [ ... GiB Swap: \fB 0.0\fR/7.999 [ ... ]
.fi .fi
Where: a) is the percentage used; b) is the total available; and c) is one of two Where: a) is the percentage used; b) is the total available; and c) is one of two
@ -1678,17 +1686,20 @@ node will be shown until the `1', `2' or `4' \*(CT is pressed.
This \*(CI is only available if a system has the requisite NUMA support. This \*(CI is only available if a system has the requisite NUMA support.
.TP 7 .TP 7
\ \ \ \fB4\fR\ \ :\fIDisplay-Two-Abreast \fR \ \ \ \fB4\fR\ \ :\fIDisplay-Multiple-Elements-Adjacent\fR toggle \fR
This command turns the `1' toggle \*F, thus showing individual This \*(CT turns the `1' toggle \*F and shows multiple \*(PU and
processors, and prints \*(PU and Memory results two abreast. Memory results on each line.
It requires a terminal with a minimum width of 80 columns. Each successive `4' key adds another \*(PU until again reverting
If a terminal's width is decreased below the minimum while \*(We to separate lines for \*(PU and Memory results.
is running, \*(We reverts to showing \*(PU and Memory results
on separate lines.
To avoid truncation when displaying detailed statistics, A maximum of 8 \*(PUs per line can be displayed in this manner.
as opposed to the graphic representations, a minimum width However, data truncation may occur before reaching the maximum.
of 165 columns would be required when the `4' toggle is \*O. That is definitely true when displaying detailed statistics via
the `t' \*(CT since such data cannot be scaled like the graphic
representations.
If one wished to quickly exit adjacent mode without cycling all the
way to 8, simply use the `1' \*(CT.
.TP 7 .TP 7
\ \ \ \fB!\fR\ \ :\fICombine-Cpus-Mode \fR \ \ \ \fB!\fR\ \ :\fICombine-Cpus-Mode \fR