stats 4.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160
  1. .TH STATS 8
  2. .SH NAME
  3. stats \- display graphs of system activity
  4. .SH SYNOPSIS
  5. .B stats
  6. [
  7. .BI - option
  8. ]
  9. [
  10. .I machine
  11. \&...
  12. ]
  13. .SH DESCRIPTION
  14. .I Stats
  15. displays a rolling graph of various statistics collected by the operating
  16. system and updated once per second.
  17. The statistics may be from a remote
  18. .I machine
  19. or multiple
  20. .IR machines ,
  21. whose graphs will appear in adjacent columns.
  22. The columns are labeled by the machine names and the number
  23. of processors on the machine if it is a multiprocessor.
  24. .PP
  25. The right mouse button presents a menu to enable and disable the display
  26. of various statistics; by default,
  27. .I stats
  28. begins by showing the load average on the executing machine.
  29. .PP
  30. The
  31. lower-case
  32. .I options
  33. choose the initial set to display:
  34. .TF [t]tlbpurge
  35. .TP
  36. .B "b battery
  37. percentage battery life remaining.
  38. .TP
  39. .B "c context
  40. number of process context switches per second.
  41. .TP
  42. .B
  43. .B "e ether
  44. total number of packets sent and received per second.
  45. .TP
  46. .B
  47. .B "E etherin,out
  48. number of packets sent and received per second, displayed as separate graphs.
  49. .TP
  50. .B "f fault
  51. number of page faults per second.
  52. .TP
  53. .B "i intr
  54. number of interrupts per second.
  55. .TP
  56. .B "I idle
  57. system load, % time in idle, and % time in interrupts.
  58. The last two are averaged over all processors on a
  59. multiprocessor.
  60. .TP
  61. .B "l load
  62. (default) system load average.
  63. The load is computed as a running average of
  64. the number of processes ready to run, multiplied by 1000.
  65. .TP
  66. .B "m mem
  67. total pages of active memory.
  68. The graph displays the fraction
  69. of the machine's total memory in use.
  70. .TP
  71. .B
  72. .B "n etherin,out,err
  73. number of packets sent and received per second, and total number of errors, displayed as separate graphs.
  74. .TP
  75. .B "p tlbpurge
  76. number of translation lookaside buffer flushes per second.
  77. .TP
  78. .B "s syscall
  79. number of system calls per second.
  80. .TP
  81. .B "t tlbmiss
  82. number of translation lookaside buffer misses per second.
  83. .TP
  84. .B "w swap
  85. number of valid pages on the swap device.
  86. The swap is displayed as a
  87. fraction of the number of swap pages configured by the machine.
  88. .TP
  89. .B "8 802.11b
  90. display the signal strength detected by the 802.11b wireless ether card; the value
  91. is usually below 50% unless the receiver is in the same room as the transmitter, so
  92. a midrange value represents a strong signal.
  93. .PD
  94. .PP
  95. The graphs are plotted with time on the horizontal axis.
  96. The vertical axes range from 0 to 1000*sleepsecs,
  97. multiplied by the number of processors on the machine
  98. when appropriate.
  99. The only exceptions are
  100. memory,
  101. and swap space,
  102. which display fractions of the total available,
  103. system load, which displays a number between 0 and 1000,
  104. idle and intr, which display percentages and the Ethernet error count,
  105. which goes from 0 to 10..
  106. If the value of the parameter is too large for the visible range, its value is shown
  107. in decimal in the upper left corner of the graph.
  108. .PP
  109. Upper-case options control details of the display.
  110. All graphs are affected; there is no mechanism to
  111. affect only one graph.
  112. .TP
  113. .BI -T " sleepsecs
  114. Set the number of seconds between samples to
  115. .I sleepsecs
  116. (default one second).
  117. .I Sleepsecs
  118. may be a floating-point number.
  119. .TP
  120. .BI -S " scale
  121. Sets a scale factor for the displays. A value of 2, for example,
  122. means that the highest value plotted will be twice as large as the default.
  123. .TP
  124. .B -L
  125. Plot all graphs with logarithmic
  126. .I y
  127. axes.
  128. The graph is plotted so the maximum value that would be displayed on
  129. a linear graph is 2/3 of the way up the
  130. .I y
  131. axis and the total range of the graph is a factor of 1000; thus the
  132. .I y
  133. origin is 1/100 of the default maximum value and the top of the graph is
  134. 10 times the default maximum.
  135. .TP
  136. .B -Y
  137. If the display is large enough to show them,
  138. place value markers along the
  139. .I y
  140. axes of the graphs.
  141. Since one set of markers serves for all machines across the display,
  142. the values in the markers disregard scaling factors due to multiple processors
  143. on the machines. On a graph for a multiprocessor,
  144. the displayed values will be larger
  145. than the markers indicate.
  146. The markers appear along the right, and the markers
  147. show values appropriate to the rightmost machine; this only
  148. matters for graphs such as memory that have machine-specific
  149. maxima.
  150. .PD
  151. .SH FILES
  152. .B /net/ether0/0/stats
  153. .br
  154. .B #c/swap
  155. .br
  156. .B #c/sysstat
  157. .SH SOURCE
  158. .B /sys/src/cmd/stats.c
  159. .SH BUGS
  160. Some machines do not have TLB hardware.