1 a4feed8a 2004-04-23 devnull .TH STATS 1
3 94b5e3ff 2005-01-04 devnull stats, auxstats \- display graphs of system activity
4 a4feed8a 2004-04-23 devnull .SH SYNOPSIS
7 a4feed8a 2004-04-23 devnull .BI - option
10 df0baa49 2004-04-23 devnull .IB machine\fR[ : path\fR]
14 a4feed8a 2004-04-23 devnull .B auxstats
16 a4feed8a 2004-04-23 devnull .I machine
20 a4feed8a 2004-04-23 devnull .SH DESCRIPTION
22 a4feed8a 2004-04-23 devnull displays a rolling graph of various statistics collected by the operating
23 a4feed8a 2004-04-23 devnull system and updated once per second.
24 a4feed8a 2004-04-23 devnull The statistics may be from a remote
25 a4feed8a 2004-04-23 devnull .I machine
26 a4feed8a 2004-04-23 devnull or multiple
27 a4feed8a 2004-04-23 devnull .IR machines ,
28 a4feed8a 2004-04-23 devnull whose graphs will appear in adjacent columns.
29 a4feed8a 2004-04-23 devnull The columns are labeled by the machine names and the number
30 a4feed8a 2004-04-23 devnull of processors on the machine if it is a multiprocessor.
32 a4feed8a 2004-04-23 devnull .I Auxstats
33 a4feed8a 2004-04-23 devnull collects the machine statistics for display by
34 a4feed8a 2004-04-23 devnull .IR stats .
35 a4feed8a 2004-04-23 devnull With no arguments, it collects statistics from the local machine.
37 a4feed8a 2004-04-23 devnull .I machine
38 a4feed8a 2004-04-23 devnull is named, it executes
40 a4feed8a 2004-04-23 devnull .I machine
41 a4feed8a 2004-04-23 devnull .IR path ;
44 a4feed8a 2004-04-23 devnull finishes,
45 a4feed8a 2004-04-23 devnull .I auxstats
46 df0baa49 2004-04-23 devnull sleeps for one minute and runs it again.
47 a4feed8a 2004-04-23 devnull The default
49 a4feed8a 2004-04-23 devnull is simply
50 a4feed8a 2004-04-23 devnull .BR auxstats ,
51 a4feed8a 2004-04-23 devnull but since some shells do not execute any sort of user profile
52 a4feed8a 2004-04-23 devnull when run as a non-login shell, it is often necessary to specify
53 a4feed8a 2004-04-23 devnull an exact path.
55 a4feed8a 2004-04-23 devnull The right mouse button presents a menu to enable and disable the display
56 a4feed8a 2004-04-23 devnull of various statistics; by default,
58 a4feed8a 2004-04-23 devnull begins by showing the load average on the executing machine.
61 a4feed8a 2004-04-23 devnull lower-case
62 a4feed8a 2004-04-23 devnull .I options
63 a4feed8a 2004-04-23 devnull choose the initial set to display:
64 a4feed8a 2004-04-23 devnull .TF [t]tlbpurge
66 a4feed8a 2004-04-23 devnull .B "b battery
67 a4feed8a 2004-04-23 devnull percentage battery life remaining.
69 a4feed8a 2004-04-23 devnull .B "c context
70 a4feed8a 2004-04-23 devnull number of process context switches per second.
73 a4feed8a 2004-04-23 devnull .B "e ether
74 a4feed8a 2004-04-23 devnull total number of packets sent and received per second.
77 a4feed8a 2004-04-23 devnull .B "E etherin,out
78 a4feed8a 2004-04-23 devnull number of packets sent and received per second, displayed as separate graphs.
80 a4feed8a 2004-04-23 devnull .B "f fault
81 a4feed8a 2004-04-23 devnull number of page faults per second.
83 a4feed8a 2004-04-23 devnull .B "i intr
84 a4feed8a 2004-04-23 devnull number of interrupts per second.
86 a4feed8a 2004-04-23 devnull .B "l load
87 a4feed8a 2004-04-23 devnull (default) system load average.
88 a4feed8a 2004-04-23 devnull The load is computed as a running average of
89 a4feed8a 2004-04-23 devnull the number of processes ready to run, multiplied by 1000.
90 a4feed8a 2004-04-23 devnull On most systems, it changes only every five seconds and has limited accuracy.
92 a4feed8a 2004-04-23 devnull .B "m mem
93 a4feed8a 2004-04-23 devnull total pages of active memory.
94 a4feed8a 2004-04-23 devnull The graph displays the fraction
95 a4feed8a 2004-04-23 devnull of the machine's total memory in use.
98 a4feed8a 2004-04-23 devnull .B "n etherin,out,err
99 a4feed8a 2004-04-23 devnull number of packets sent and received per second, and total number of errors, displayed as separate graphs.
101 a4feed8a 2004-04-23 devnull .B "s syscall
102 a4feed8a 2004-04-23 devnull number of system calls per second.
104 a4feed8a 2004-04-23 devnull .B "w swap
105 a4feed8a 2004-04-23 devnull number of valid pages on the swap device.
106 a4feed8a 2004-04-23 devnull The swap is displayed as a
107 a4feed8a 2004-04-23 devnull fraction of the number of swap pages configured by the machine.
110 a4feed8a 2004-04-23 devnull The graphs are plotted with time on the horizontal axis.
111 a4feed8a 2004-04-23 devnull The vertical axes range from 0 to 1000*sleepsecs,
112 a4feed8a 2004-04-23 devnull multiplied by the number of processors on the machine
113 a4feed8a 2004-04-23 devnull when appropriate.
114 a4feed8a 2004-04-23 devnull The only exceptions are
116 a4feed8a 2004-04-23 devnull and swap space,
117 a4feed8a 2004-04-23 devnull which display fractions of the total available,
118 a4feed8a 2004-04-23 devnull system load, which displays a number between 0 and 1000,
119 a4feed8a 2004-04-23 devnull idle and intr, which display percentages and the Ethernet error count,
120 a4feed8a 2004-04-23 devnull which goes from 0 to 10..
121 a4feed8a 2004-04-23 devnull If the value of the parameter is too large for the visible range, its value is shown
122 a4feed8a 2004-04-23 devnull in decimal in the upper left corner of the graph.
124 a4feed8a 2004-04-23 devnull Upper-case options control details of the display.
125 a4feed8a 2004-04-23 devnull All graphs are affected; there is no mechanism to
126 a4feed8a 2004-04-23 devnull affect only one graph.
128 a4feed8a 2004-04-23 devnull .BI -T " sleepsecs
129 a4feed8a 2004-04-23 devnull Set the number of seconds between samples to
130 a4feed8a 2004-04-23 devnull .I sleepsecs
131 a4feed8a 2004-04-23 devnull (default one second).
133 a4feed8a 2004-04-23 devnull .BI -S " scale
134 a4feed8a 2004-04-23 devnull Sets a scale factor for the displays. A value of 2, for example,
135 a4feed8a 2004-04-23 devnull means that the highest value plotted will be twice as large as the default.
138 a4feed8a 2004-04-23 devnull Plot all graphs with logarithmic
141 a4feed8a 2004-04-23 devnull The graph is plotted so the maximum value that would be displayed on
142 a4feed8a 2004-04-23 devnull a linear graph is 2/3 of the way up the
144 a4feed8a 2004-04-23 devnull axis and the total range of the graph is a factor of 1000; thus the
146 a4feed8a 2004-04-23 devnull origin is 1/100 of the default maximum value and the top of the graph is
147 a4feed8a 2004-04-23 devnull 10 times the default maximum.
150 a4feed8a 2004-04-23 devnull If the display is large enough to show them,
151 a4feed8a 2004-04-23 devnull place value markers along the
153 a4feed8a 2004-04-23 devnull axes of the graphs.
154 a4feed8a 2004-04-23 devnull Since one set of markers serves for all machines across the display,
155 a4feed8a 2004-04-23 devnull the values in the markers disregard scaling factors due to multiple processors
156 a4feed8a 2004-04-23 devnull on the machines. On a graph for a multiprocessor,
157 a4feed8a 2004-04-23 devnull the displayed values will be larger
158 a4feed8a 2004-04-23 devnull than the markers indicate.
159 a4feed8a 2004-04-23 devnull The markers appear along the right, and the markers
160 a4feed8a 2004-04-23 devnull show values appropriate to the rightmost machine; this only
161 a4feed8a 2004-04-23 devnull matters for graphs such as memory that have machine-specific
164 df0baa49 2004-04-23 devnull Typing `q' or DEL causes
165 df0baa49 2004-04-23 devnull .I stats
166 df0baa49 2004-04-23 devnull to exit.
168 a4feed8a 2004-04-23 devnull .SH EXAMPLE
169 a4feed8a 2004-04-23 devnull Show the load, memory, interrupts, system calls, context switches,
170 c8b6342d 2005-01-13 devnull and ethernet packets for the local machine,
171 c8b6342d 2005-01-13 devnull a remote BSD machine
172 c8b6342d 2005-01-13 devnull .IR daemon ,
174 c8b6342d 2005-01-13 devnull a remote Linux machine
175 c8b6342d 2005-01-13 devnull .IR tux .
176 c8b6342d 2005-01-13 devnull .I Auxstats
177 c8b6342d 2005-01-13 devnull is not in
178 c8b6342d 2005-01-13 devnull .IR tux 's
179 c8b6342d 2005-01-13 devnull path, so the full path must be given.
182 c8b6342d 2005-01-13 devnull stats -lmisce `hostname` daemon \e
183 c8b6342d 2005-01-13 devnull tux:\*9/bin/auxstats
185 a4feed8a 2004-04-23 devnull .SH SOURCE
186 c3674de4 2005-01-11 devnull .B \*9/src/cmd/draw/stats.c
188 c3674de4 2005-01-11 devnull .B \*9/src/cmd/auxstats
189 a4feed8a 2004-04-23 devnull .SH BUGS
191 a4feed8a 2004-04-23 devnull .I auxstats
192 a4feed8a 2004-04-23 devnull binary needs read access to
193 a4feed8a 2004-04-23 devnull .B /dev/kmem
194 78802e69 2004-04-24 devnull in order to collect network statistics on non-Linux systems.
195 a4feed8a 2004-04-23 devnull Typically this can be arranged by setting the
196 a4feed8a 2004-04-23 devnull .I auxstat
197 a4feed8a 2004-04-23 devnull binary's
198 a4feed8a 2004-04-23 devnull group to
200 a4feed8a 2004-04-23 devnull and then turning on its set-gid bit.