top: documentation update, enable NUMA/Node extensions

This commit provides the NEWS and man document changes
supporting the new NUMA/Node top program enhancements.

For providing the initial impetus for this enhancement
I wish to thank Lance Shelton <LShelton@fusionio.com>.

(everything is perfectly justified plus right margins)
(are completely filled, but of course it must be luck)

Signed-off-by: Jim Warner <james.warner@comcast.net>
Signed-off-by: Lance Shelton <LShelton@fusionio.com>
This commit is contained in:
Jim Warner 2013-04-08 00:00:00 -05:00 committed by Craig Small
parent 87ac6383bb
commit c2afde130e
2 changed files with 30 additions and 5 deletions

5
NEWS
View File

@ -1,3 +1,8 @@
procps-ng-3.3.8
---------------
* top adds extensions for linux NUMA/Node capability
procps-ng-3.3.7 procps-ng-3.3.7
--------------- ---------------

View File

@ -912,7 +912,7 @@ depending on the context in which they are issued.
<Ent/Sp> ?, =, 0, <Ent/Sp> ?, =, 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
4b.\fI Summary-Area-Commands \fR 4b.\fI Summary-Area-Commands \fR
C, l, t, 1, m C, l, t, m, 1, 2, 3
4c.\fI Task-Area-Commands \fR 4c.\fI Task-Area-Commands \fR
Appearance: b, J, j, x, y, z Appearance: b, J, j, x, y, z
Content: c, f, F, o, O, S, u, U, V Content: c, f, F, o, O, S, u, U, V
@ -1183,6 +1183,12 @@ These commands always impact just the \*(CG.
\*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight into \*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight into
\*(CWs and \*(FGs. \*(CWs and \*(FGs.
.TP 7
\ \ \'\fBC\fR' :\fIShow-scroll-coordinates\fR toggle \fR
Toggle an informational message which is displayed whenever the message
line is not otherwise being used.
For additional information \*(Xt 5c. SCROLLING a Window.
.TP 7 .TP 7
\ \ \'\fBl\fR\' :\fILoad-Average/Uptime\fR toggle \fR \ \ \'\fBl\fR\' :\fILoad-Average/Uptime\fR toggle \fR
This is also the line containing the program name (possibly an alias) This is also the line containing the program name (possibly an alias)
@ -1191,11 +1197,17 @@ when operating in \*(FM or the \*(CW name when operating in \*(AM.
.TP 7 .TP 7
\ \ \'\fBt\fR\' :\fITask/Cpu-States\fR toggle \fR \ \ \'\fBt\fR\' :\fITask/Cpu-States\fR toggle \fR
This command affects from 2 to many \*(SA lines, depending on the state This command affects from 2 to many \*(SA lines, depending on the state
of the '1' toggle and whether or not \*(We is running under true SMP. of the '1', '2' or '3' \*(CTs and whether or not \*(We is running under
true SMP.
This portion of the \*(SA is also influenced by the 'H' \*(CI toggle, This portion of the \*(SA is also influenced by the 'H' \*(CI toggle,
as reflected in the total label which shows either 'Tasks' or 'Threads'. as reflected in the total label which shows either 'Tasks' or 'Threads'.
.TP 7
\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR
This command affects the two \*(SA lines dealing with physical
and virtual memory.
.TP 7 .TP 7
\ \ \'\fB1\fR\' :\fISingle/Separate-Cpu-States\fR toggle \fR \ \ \'\fB1\fR\' :\fISingle/Separate-Cpu-States\fR toggle \fR
This command affects how the 't' command's Cpu States portion is shown. This command affects how the 't' command's Cpu States portion is shown.
@ -1208,9 +1220,17 @@ Otherwise, each \*(Pu is displayed separately as: '%Cpu0, %Cpu1, ...'
up to available screen height. up to available screen height.
.TP 7 .TP 7
\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR \ \ \'\fB2\fR\' :\fINUMA-Nodes/Cpu-Summary\fR toggle \fR
This command affects the two \*(SA lines dealing with physical This command toggles between the '1' command cpu summary display (only)
and virtual memory. or a summary display plus the cpu usage statistics for each NUMA Node.
It is only available if a system has the requisite NUMA support.
.TP 7
\ \ \'\fB3\fR\' :\fIExpand-NUMA-Node \fR
You will be invited to enter a number representing a NUMA Node.
Thereafter, a node summary plus the statistics for each cpu in that
node will be shown until either the '1' or '2' \*(CT is pressed.
This \*(CI is only available if a system has the requisite NUMA support.
.PP .PP
\*(NT If the entire \*(SA has been toggled \*F for any window, you would \*(NT If the entire \*(SA has been toggled \*F for any window, you would