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

top: reflect current graph modes state in man document

Browse Source 
This patch just beefs up the man documentation for the
new graphs modes while also reflecting the most recent
program changes, prompted by the feedback shown below.

Reference(s):
http://www.freelists.org/post/procps/latest-top-enhancements,1

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2014-06-22 00:00:00 -05:00 committed by Craig Small
parent b8614adcb5
commit d8a8822b5f
1 changed files with 28 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
top/top.1
View File

@ -447,9 +447,15 @@ are shown first.
\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, an abbreviated summary is shown In the alternate cpu states display modes, beyond the first tasks/threads line,
consisting of \fBUser\fR (`us' and `ni' above) / \fBSystem\fR (`sy' above) an abbreviated summary is shown consisting of these elements:
percentages followed by a visual graph of those representations. .nf
\fR a \fR b \fR c \fR d
Cpu(s): \fB75.0\fR/25.0 \fB100\fR[ ...
.fi
Where: a) is the combined \fBus\fR and \fBni\fR percentage; b) is the \fBsy\fR percentage; c) is the total;
and d) is one of two visual graphs of those representations.
\*(XT 4b. SUMMARY AREA Commands and the `t' command for additional information \*(XT 4b. SUMMARY AREA Commands and the `t' command for additional information
on that special 4-way toggle. on that special 4-way toggle.
@ -471,11 +477,19 @@ Line 2 reflects mostly \*(MV, classified as:
.fi .fi
In the alternate memory display modes, two abbreviated summary lines In the alternate memory display modes, two abbreviated summary lines
are shown consisting of percentage used and total available followed are shown consisting of these elements:
by a visual graph. .nf
In the case of \*(MP, the percentage includes the sum of `used', `buffers' \fR a \fR b c
and `cached' memory noted above. GiB Mem : \fB18.7\fR/15.738 [ ...
The graph itself is divided between `used' then `buffers' and `cached' combined. GiB Swap: \fB 0.0\fR/7.999 [ ...
.fi
Where: a) is the percentage used; b) is the total available; and c) is one of two
visual graphs of those representations.
In the case of \*(MP, the percentage includes the sum of \fBused\fR, \fBbuffers\fR
and \fBcached\fR memory noted above.
The `Mem' graph itself is divided between \fBused\fR then \fBbuffers\fR and \fBcached\fR combined.
\*(XT 4b. SUMMARY AREA Commands and the `m' command for additional information \*(XT 4b. SUMMARY AREA Commands and the `m' command for additional information
on that special 4-way toggle. on that special 4-way toggle.
@ -1241,11 +1255,15 @@ as reflected in the total label which shows either Tasks or Threads.
This command serves as a 4-way toggle, cycling through these modes: This command serves as a 4-way toggle, cycling through these modes:
.nf .nf
1. detailed percentages by category (default) 1. detailed percentages by category (default)
2. abbreviated user/system percentages + bar graph 2. abbreviated user/system and total % + bar graph
3. abbreviated user/system percentages + block graph 3. abbreviated user/system and total % + block graph
4. turn off task and cpu states display 4. turn off task and cpu states display
.fi .fi
When operating in either of the graphic modes, the display becomes much
more meaningful when individual CPUs or NUMA nodes are also displayed.
\*(XC the `1', `2' and `3' commands below for additional information.
.TP 7 .TP 7
\ \ \ \fBm\fR\ \ :\fIMemory/Swap-Usage\fR toggle \fR \ \ \ \fBm\fR\ \ :\fIMemory/Swap-Usage\fR toggle \fR
This command affects the two \*(SA lines dealing with physical This command affects the two \*(SA lines dealing with physical