glenda.party
term% ls -F
term% cat index.txt
STATS(8)                    System Manager's Manual                   STATS(8)



NAME
       stats - display graphs of system activity

SYNOPSIS
       stats [ -option ] [ machine ...  ]

DESCRIPTION
       Stats  displays  a rolling graph of various statistics collected 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 dis‐
       play 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.

       I idle system load, % time in idle, and % time in interrupts.  The last
              two are averaged over all processors on a multiprocessor.

       l load (default)  system  load average.  The load is computed as a run‐
              ning average of the number of processes ready to run, multiplied
              by 1000.

       m mem  total  pages  of active memory.  The graph displays the fraction
              of the machine's total memory in use.

       n etherin,out,err
              number of packets sent and received per second, and total number
              of errors, displayed as separate 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  ma‐
              chine.

       8 802.11b
              display  the  signal  strength  detected by the 802.11b wireless
              ether card; the value is usually below 50% unless  the  receiver
              is in the same room as the transmitter, so a midrange value rep‐
              resents a strong signal.

       The graphs are plotted with time on the horizontal axis.  The  vertical
       axes  range  from 0 to 1000*sleepsecs, multiplied by the number of pro‐
       cessors on the machine when appropriate.  The only exceptions are  mem‐
       ory,  and  swap  space, which display fractions of the total available,
       system load, which displays a number between 0 and 1000, idle and intr,
       which display percentages 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 corner of the
       graph.

       Upper-case options control details of the display.  All graphs are  af‐
       fected; there is no mechanism to affect only one graph.

       -T sleepsecs
              Set  the number of seconds between samples to sleepsecs (default
              one second).  Sleepsecs may be a floating-point number.

       -S scale
              Sets a scale factor for the displays.  A value of 2,  for  exam‐
              ple, 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  ma‐
              chines.  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.



                                                                      STATS(8)