RFC: Sorting in top -m io
Giorgos Keramidas
keramida at ceid.upatras.gr
Thu Jul 8 13:54:48 PDT 2004
On 2004-07-08 12:07, Dan Nelson <dnelson at allantgroup.com> wrote:
> docs are still missing: manpage, top Usage string, and "?" help all
> need to describe the -m flag and 'm' key. Since there's room,
> context-switch info would also be neat to display.
Hi,
I don't like writing in nroff -man which is a bit too `primitive' when
compared with mdoc, but here is the patch I mentioned earlier:
Does this look ok? Should I add more details? If yes, what about?
%%
Index: top.X
===================================================================
RCS file: /home/ncvs/src/contrib/top/top.X,v
retrieving revision 1.10
diff -u -r1.10 top.X
--- top.X 1 Jul 2004 09:12:38 -0000 1.10
+++ top.X 8 Jul 2004 20:50:23 -0000
@@ -90,7 +90,7 @@
process.
.TP
.BI \-m display
-Display either 'cpu' or 'io' statistics. Default is 'cpu'.
+Display either 'cpu' or 'io' statistics. The default display mode is 'cpu'.
.TP
.B \-n
Use \*(lqnon-interactive\*(rq mode. This is identical to \*(lqbatch\*(rq
@@ -221,6 +221,8 @@
.TP
.B m
Toggle the display between 'cpu' and 'io' modes.
+Note that this affects the sort order of the displayed processes,
+as different sort keys are available in each mode.
.TP
.B n or #
Change the number of processes to display (prompt for new number).
@@ -247,8 +249,16 @@
.B o
Change the order in which the display is sorted. This command is not
available on all systems. The sort key names vary fron system to system
-but usually include: \*(lqcpu\*(rq, \*(lqres\*(rq, \*(lqsize\*(rq,
-\*(lqtime\*(rq. The default is cpu.
+and depend on the current display mode of
+.IR top .
+.IP
+The available sort keys usually include:
+\*(lqcpu\*(rq, \*(lqres\*(rq, \*(lqsize\*(rq, and \*(lqtime\*(rq.
+These are the same sort keys that are available when the 'cpu' mode is
+used. The default sort key of this mode is \*(lqcpu\*(rq.
+.IP
+The sort keys that can be used in the 'io' display mode are:
+\*(lqtotal\*(rq, \*(lqread\*(rq, \*(lqwrite\*(rq, and \*(lqfault\*(rq.
.TP
.B e
Display a list of system errors (if any) generated by the last
%%
More information about the freebsd-current
mailing list