STATS(8) STATS(8)
NAME
stats - display graphs of system activity
SYNOPSIS
stats [ -option ] [ machine ... ]
DESCRIPTION
Stats displays a rolling graph of various statistics col-
lected by the operating system and updated once per second.
The statistics may be from a remote machine or multiple
machines, whose graphs will appear in adjacent columns. The
columns are labeled by the machine names and the number of
processors on the machine if it is a multiprocessor.
The right mouse button presents a menu to enable and disable
the display of various statistics; by default, stats begins
by showing the load average on the executing machine.
The lower-case options choose the initial set to display:
b battery percentage battery life remaining.
c context number of process context switches per second.
e ether total number of packets sent and received per
second.
E etherin,out
number of packets sent and received per second,
displayed as separate graphs.
f fault number of page faults per second.
i intr number of interrupts per second.
l load (default) system load average. The load is
computed as a running average of the number of
processes ready to run, multiplied by 1000.
m mem total pages of active memory. The graph dis-
plays the fraction of the machine's total mem-
ory in use.
n etherin,out,err
number of packets sent and received per second,
and total number of errors, displayed as sepa-
rate graphs.
p tlbpurge number of translation lookaside buffer flushes
per second.
s syscall number of system calls per second.
t tlbmiss number of translation lookaside buffer misses
per second.
w swap number of valid pages on the swap device. The
swap is displayed as a fraction of the number
of swap pages configured by the machine.
The graphs are plotted with time on the horizontal axis.
The vertical axes range from 0 to 1000 times the number of
Page 1 Plan 9 (printed 10/27/25)
STATS(8) STATS(8)
processors on the machine. The only exceptions are memory
and swap space, which display fractions of the total avail-
able, and the Ethernet error count, which goes from 0 to 10.
If the value of the parameter is too large for the visible
range, its value is shown in decimal in the upper left cor-
ner of the graph.
Upper-case options control details of the display. All
graphs are affected; there is no mechanism to affect only
one graph.
-S scale
Sets a scale factor for the displays. A value of 2,
for example, means that the highest value plotted will
be twice as large as the default.
-L Plot all graphs with logarithmic y axes. The graph is
plotted so the maximum value that would be displayed on
a linear graph is 2/3 of the way up the y axis and the
total range of the graph is a factor of 1000; thus the
y origin is 1/100 of the default maximum value and the
top of the graph is 10 times the default maximum.
-Y If the display is large enough to show them, place
value markers along the y axes of the graphs. Since
one set of markers serves for all machines across the
display, the values in the markers disregard scaling
factors due to multiple processors on the machines. On
a graph for a multiprocessor, the displayed values will
be larger than the markers indicate. The markers
appear along the right, and the markers show values
appropriate to the rightmost machine; this only matters
for graphs such as memory that have machine-specific
maxima.
FILES
/net/ether0/0/stats
#c/swap
#c/sysstat
SOURCE
/sys/src/cmd/stats.c
BUGS
Some machines do not have TLB hardware.
Page 2 Plan 9 (printed 10/27/25)