3 stats, auxstats \- display graphs of system activity
10 .IB machine\fR[ : path\fR]
22 displays a rolling graph of various statistics collected by the operating
23 system and updated once per second.
24 The statistics may be from a remote
28 whose graphs will appear in adjacent columns.
29 The columns are labeled by the machine names and the number
30 of processors on the machine if it is a multiprocessor.
33 collects the machine statistics for display by
35 With no arguments, it collects statistics from the local machine.
46 sleeps for one minute and runs it again.
51 but since some shells do not execute any sort of user profile
52 when run as a non-login shell, it is often necessary to specify
55 The right mouse button presents a menu to enable and disable the display
56 of various statistics; by default,
58 begins by showing the load average on the executing machine.
63 choose the initial set to display:
67 percentage battery life remaining.
70 number of process context switches per second.
74 total number of packets sent and received per second.
78 number of packets sent and received per second, displayed as separate graphs.
81 number of page faults per second.
84 number of interrupts per second.
87 (default) system load average.
88 The load is computed as a running average of
89 the number of processes ready to run, multiplied by 1000.
90 On most systems, it changes only every five seconds and has limited accuracy.
93 total pages of active memory.
94 The graph displays the fraction
95 of the machine's total memory in use.
99 number of packets sent and received per second, and total number of errors, displayed as separate graphs.
102 number of system calls per second.
105 number of valid pages on the swap device.
106 The swap is displayed as a
107 fraction of the number of swap pages configured by the machine.
110 display the signal strength detected by the 802.11b wireless ether card; the value
111 is usually below 50% unless the receiver is in the same room as the transmitter, so
112 a midrange value represents a strong signal.
115 The graphs are plotted with time on the horizontal axis.
116 The vertical axes range from 0 to 1000*sleepsecs,
117 multiplied by the number of processors on the machine
119 The only exceptions are
122 which display fractions of the total available,
123 system load, which displays a number between 0 and 1000,
124 idle and intr, which display percentages and the Ethernet error count,
125 which goes from 0 to 10..
126 If the value of the parameter is too large for the visible range, its value is shown
127 in decimal in the upper left corner of the graph.
129 Upper-case options control details of the display.
130 All graphs are affected; there is no mechanism to
131 affect only one graph.
134 Set the number of seconds between samples to
136 (default one second).
139 Sets a scale factor for the displays. A value of 2, for example,
140 means that the highest value plotted will be twice as large as the default.
143 Plot all graphs with logarithmic
146 The graph is plotted so the maximum value that would be displayed on
147 a linear graph is 2/3 of the way up the
149 axis and the total range of the graph is a factor of 1000; thus the
151 origin is 1/100 of the default maximum value and the top of the graph is
152 10 times the default maximum.
155 If the display is large enough to show them,
156 place value markers along the
159 Since one set of markers serves for all machines across the display,
160 the values in the markers disregard scaling factors due to multiple processors
161 on the machines. On a graph for a multiprocessor,
162 the displayed values will be larger
163 than the markers indicate.
164 The markers appear along the right, and the markers
165 show values appropriate to the rightmost machine; this only
166 matters for graphs such as memory that have machine-specific
169 Typing `q' or DEL causes
174 Show the load, memory, interrupts, system calls, context switches,
175 and ethernet packets for the local machine,
179 a remote Linux machine
184 path, so the full path must be given.
187 stats -lmisce `hostname` daemon \e
191 .B \*9/src/cmd/draw/stats.c
193 .B \*9/src/cmd/auxstats
197 binary needs read access to
199 in order to collect network statistics on non-Linux systems.
200 Typically this can be arranged by setting the
205 and then turning on its set-gid bit.