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 The graphs are plotted with time on the horizontal axis.
111 The vertical axes range from 0 to 1000*sleepsecs,
112 multiplied by the number of processors on the machine
114 The only exceptions are
117 which display fractions of the total available,
118 system load, which displays a number between 0 and 1000,
119 idle and intr, which display percentages and the Ethernet error count,
120 which goes from 0 to 10..
121 If the value of the parameter is too large for the visible range, its value is shown
122 in decimal in the upper left corner of the graph.
124 Upper-case options control details of the display.
125 All graphs are affected; there is no mechanism to
126 affect only one graph.
129 Set the number of seconds between samples to
131 (default one second).
134 Sets a scale factor for the displays. A value of 2, for example,
135 means that the highest value plotted will be twice as large as the default.
138 Plot all graphs with logarithmic
141 The graph is plotted so the maximum value that would be displayed on
142 a linear graph is 2/3 of the way up the
144 axis and the total range of the graph is a factor of 1000; thus the
146 origin is 1/100 of the default maximum value and the top of the graph is
147 10 times the default maximum.
150 If the display is large enough to show them,
151 place value markers along the
154 Since one set of markers serves for all machines across the display,
155 the values in the markers disregard scaling factors due to multiple processors
156 on the machines. On a graph for a multiprocessor,
157 the displayed values will be larger
158 than the markers indicate.
159 The markers appear along the right, and the markers
160 show values appropriate to the rightmost machine; this only
161 matters for graphs such as memory that have machine-specific
164 Typing `q' or DEL causes
169 Show the load, memory, interrupts, system calls, context switches,
170 and ethernet packets for the local machine,
174 a remote Linux machine
179 path, so the full path must be given.
182 stats -lmisce `hostname` daemon \e
186 .B \*9/src/cmd/draw/stats.c
188 .B \*9/src/cmd/auxstats
192 binary needs read access to
194 in order to collect network statistics on non-Linux systems.
195 Typically this can be arranged by setting the
200 and then turning on its set-gid bit.