Annotation of src/usr.bin/systat/systat.1, Revision 1.111
1.111 ! dlg 1: .\" $OpenBSD: systat.1,v 1.110 2018/07/25 17:24:14 bluhm Exp $
1.2 deraadt 2: .\" $NetBSD: systat.1,v 1.6 1996/05/10 23:16:39 thorpej Exp $
1.1 deraadt 3: .\"
4: .\" Copyright (c) 1985, 1990, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
1.28 millert 15: .\" 3. Neither the name of the University nor the names of its contributors
1.1 deraadt 16: .\" may be used to endorse or promote products derived from this software
17: .\" without specific prior written permission.
18: .\"
19: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29: .\" SUCH DAMAGE.
30: .\"
31: .\" @(#)systat.1 8.2 (Berkeley) 12/30/93
32: .\"
1.111 ! dlg 33: .Dd $Mdocdate: July 25 2018 $
1.1 deraadt 34: .Dt SYSTAT 1
1.12 aaron 35: .Os
1.1 deraadt 36: .Sh NAME
37: .Nm systat
1.41 jmc 38: .Nd display system statistics
1.1 deraadt 39: .Sh SYNOPSIS
40: .Nm systat
1.96 reyk 41: .Op Fl aBbiNn
1.62 matthieu 42: .Op Fl d Ar count
43: .Op Fl s Ar delay
44: .Op Fl w Ar width
45: .Op Ar view
46: .Op Ar delay
1.1 deraadt 47: .Sh DESCRIPTION
1.13 aaron 48: .Nm
1.73 jmc 49: displays various system statistics in a screen-oriented fashion
50: using the
51: .Xr curses 3
52: screen display library.
1.1 deraadt 53: .Pp
54: While
1.13 aaron 55: .Nm
1.86 lum 56: is running, the screen is divided into different areas.
57: The top line displays the current number of users, the
58: three system load average figures over the last 1, 5, and
59: 15 minute intervals, and the system time.
1.73 jmc 60: The bottom line of the screen is reserved for
61: user input and error messages.
62: The information displayed in the rest of the screen
63: comprises a
64: .Em view ,
65: and is the main interface for
1.76 jmc 66: displaying different types of system statistics.
1.73 jmc 67: The
68: .Ic vmstat
69: view is the default.
1.77 jmc 70: .Pp
71: Certain information may be discarded when the screen size is
72: insufficient for display.
73: For example, on a machine with 10 drives the
74: .Ic iostat
75: bar graph displays only 3 drives on a 24 line terminal.
1.76 jmc 76: .\".Pp
77: .\"Input is interpreted at two different levels.
78: .\"A
79: .\".Dq global
80: .\"command interpreter processes all keyboard input.
81: .\"If this command interpreter fails to recognize a command, the
82: .\"input line is passed to a per-display command interpreter.
83: .\"This allows each display to have certain display-specific commands.
1.1 deraadt 84: .Pp
1.16 aaron 85: The options are as follows:
1.62 matthieu 86: .Bl -tag -width Ds
1.64 jmc 87: .It Fl a
1.62 matthieu 88: Display all lines.
1.96 reyk 89: .It Fl B
90: Raw, non-interactive mode.
91: The default is to exit after two screen updates,
92: with statistics only ever displayed once.
93: Useful for views such as
94: .Ic cpu ,
95: where initial calculations are useless.
1.62 matthieu 96: .It Fl b
1.88 lum 97: Raw, non-interactive mode.
1.96 reyk 98: The default is to exit after one screen update,
99: with statistics displayed every update.
1.62 matthieu 100: .It Fl d Ar count
101: Exit after
102: .Ar count
103: screen updates.
104: .It Fl i
105: Interactive mode.
1.81 sthen 106: .It Fl N
107: Resolve network addresses to names.
108: This is the opposite of the
109: .Fl n
110: option.
1.34 itojun 111: .It Fl n
1.73 jmc 112: Do not try to reverse map IP addresses.
1.81 sthen 113: This is the default.
1.62 matthieu 114: .It Fl s Ar delay
1.31 jmc 115: Specifies the screen refresh time interval in seconds.
1.62 matthieu 116: This option is overridden by the final
1.64 jmc 117: .Ar delay
1.73 jmc 118: argument, if given.
1.31 jmc 119: The default interval is 5 seconds.
1.62 matthieu 120: .It Fl w Ar width
1.94 okan 121: Specifies the maximum width of the output in raw, non-interactive mode.
1.62 matthieu 122: .It Ar view
1.1 deraadt 123: The
1.62 matthieu 124: .Ar view
1.2 deraadt 125: argument expects to be one of:
1.62 matthieu 126: .Ic vmstat ,
1.1 deraadt 127: .Ic pigs ,
1.62 matthieu 128: .Ic ifstat ,
1.1 deraadt 129: .Ic iostat ,
1.49 deraadt 130: .Ic sensors ,
1.1 deraadt 131: .Ic mbufs ,
1.62 matthieu 132: .Ic netstat ,
133: .Ic swap ,
134: .Ic states ,
135: .Ic rules ,
1.68 canacar 136: .Ic queues ,
1.71 canacar 137: .Ic pf ,
138: .Ic pool ,
1.102 dlg 139: .Ic pcache ,
1.71 canacar 140: .Ic malloc ,
1.80 jmc 141: .Ic buckets ,
142: .Ic nfsclient ,
1.96 reyk 143: .Ic nfsserver ,
1.105 krw 144: .Ic cpu ,
1.1 deraadt 145: or
1.105 krw 146: .Ic uvm .
1.2 deraadt 147: These displays can also be requested interactively and are described in
1.1 deraadt 148: full detail below.
1.62 matthieu 149: .Ar view
1.53 jmc 150: may be abbreviated to the minimum unambiguous prefix;
151: for example,
1.50 jmc 152: .Dq io
153: for
154: .Dq iostat .
1.62 matthieu 155: .It Ar delay
1.1 deraadt 156: The
1.62 matthieu 157: .Ar delay
1.73 jmc 158: argument specifies the screen refresh time interval in seconds.
159: This is provided for backwards compatibility, and overrides any
1.31 jmc 160: interval specified with the
1.73 jmc 161: .Fl s
1.2 deraadt 162: flag.
1.31 jmc 163: The default interval is 5 seconds.
1.1 deraadt 164: .El
165: .Pp
166: Certain characters cause immediate action by
1.61 jmc 167: .Nm .
1.63 sobrado 168: These are:
1.1 deraadt 169: .Bl -tag -width Fl
170: .It Ic \&:
171: Move the cursor to the command line and interpret the input
1.16 aaron 172: line typed as a command.
173: While entering a command the
1.1 deraadt 174: current character erase, word erase, and line kill characters
175: may be used.
1.69 canacar 176: .It Ic o
177: Select the next ordering which sorts the rows according to a
1.70 jmc 178: combination of columns.
179: Available orderings depend on the view.
180: Not all views support orderings.
1.66 canacar 181: .It Ic p
182: Pause
183: .Nm .
1.59 jmc 184: .It Ic q
1.73 jmc 185: Quit
1.66 canacar 186: .Nm .
1.69 canacar 187: .It Ic r
188: Reverse the selected ordering if supported by the view.
1.91 mpf 189: .It Ic \&,
190: Print numbers with thousand separators, where applicable.
1.100 bentley 191: .It Ic ^A | Aq Ic Home
1.66 canacar 192: Jump to the beginning of the current view.
1.100 bentley 193: .It Ic ^B | Aq Ic right arrow
1.84 jmc 194: Select the previous view.
1.100 bentley 195: .It Ic ^E | Aq Ic End
1.66 canacar 196: Jump to the end of the current view.
1.100 bentley 197: .It Ic ^F | Aq Ic left arrow
1.66 canacar 198: Select the next view.
199: .It Ic ^G
200: Print the name of the current
1.73 jmc 201: view being shown and the refresh interval.
1.66 canacar 202: .It Ic ^L
203: Refresh the screen.
1.100 bentley 204: .It Ic ^N | Aq Ic down arrow
1.66 canacar 205: Scroll current view down by one line.
1.100 bentley 206: .It Ic ^P | Aq Ic up arrow
1.66 canacar 207: Scroll current view up by one line.
1.100 bentley 208: .It Ic ^V | Aq Ic Page Down
1.66 canacar 209: Scroll current view down by one page.
1.100 bentley 210: .It Ic Alt-V | Aq Ic Page Up
1.66 canacar 211: Scroll current view up by one page.
212: .It Ic ^Z
213: Suspend
1.59 jmc 214: .Nm .
1.1 deraadt 215: .El
216: .Pp
1.13 aaron 217: The following commands are interpreted by the
218: .Dq global
1.1 deraadt 219: command interpreter.
220: .Bl -tag -width Fl
221: .It Ic help
1.73 jmc 222: Print the names of the available views on the command line.
1.103 martijn 223: .It Ic order
224: Print the names of the available orderings on the command line.
1.52 jmc 225: .It Ic quit
1.73 jmc 226: Quit
1.61 jmc 227: .Nm .
1.52 jmc 228: (This may be abbreviated to
229: .Ic q . )
1.1 deraadt 230: .It Ic stop
231: Stop refreshing the screen.
232: .It Xo
233: .Op Ic start
234: .Op Ar number
235: .Xc
1.16 aaron 236: Start (continue) refreshing the screen.
237: If a second, numeric,
1.1 deraadt 238: argument is provided it is interpreted as a refresh interval
239: (in seconds).
240: Supplying only a number will set the refresh interval to this
241: value.
242: .El
243: .Pp
1.73 jmc 244: .Ar view
1.53 jmc 245: may be abbreviated to the minimum unambiguous prefix.
1.73 jmc 246: The available views are:
1.52 jmc 247: .Bl -tag -width "netstatXXX"
1.71 canacar 248: .It Ic buckets
249: Display kernel
250: .Xr malloc 9
251: bucket statistics similar to the output of
252: .Cm vmstat Fl m .
1.96 reyk 253: .It Ic cpu
254: Display information about the average usage of each CPU,
255: similar to the output provided by
256: .Xr top 1 .
1.52 jmc 257: .It Ic ifstat
1.73 jmc 258: Display interface statistics.
1.52 jmc 259: The
260: .Dq State
261: column has the format
262: .Sm off
263: .Xo
1.100 bentley 264: .Cm up | dn
265: .Bq : Cm U | D .
1.52 jmc 266: .Xc
267: .Sm on
268: .Sq up
269: and
270: .Sq dn
271: represent whether the interface is up or down.
272: .Sq U
273: and
274: .Sq D
275: represent whether the interface is connected or not;
276: in the case of
277: .Xr carp 4
278: interfaces, whether the interface is in master or backup state, respectively.
1.92 lum 279: .Pp
1.91 mpf 280: The character
281: .Ic B
282: changes the counter view between bytes and bits.
1.92 lum 283: Pressing
284: .Ic b
285: displays statistics as calculated from boot time.
286: .Ic r
287: changes the counters to show their totals as calculated
288: between display refreshes.
289: .Ic t
290: changes the counters to show the average per second over
291: the display refresh interval;
292: this is the default.
1.111 ! dlg 293: .Ic d
! 294: displays input and output queue drops.
! 295: .Ic e
! 296: displays input and output errors.
! 297: .Ic f
! 298: displays input and output queue drops plus errors.
! 299: This is the default view.
1.52 jmc 300: .It Ic iostat
1.73 jmc 301: Display statistics about disk throughput.
1.52 jmc 302: Statistics
1.109 jmc 303: on disk throughput show, for each drive, data transferred in bytes,
1.52 jmc 304: number of disk transactions performed, and time spent in disk accesses
1.56 otto 305: (in fractions of a second).
1.71 canacar 306: .It Ic malloc
307: Display kernel
308: .Xr malloc 9
309: type statistics similar to the output of
310: .Cm vmstat Fl m .
311: Available orderings are:
312: .Ic name ,
313: .Ic inuse ,
314: .Ic memuse ,
315: and
316: .Ic requests .
1.72 jmc 317: .It Ic mbufs
1.78 canacar 318: Display mbuf usage information from kernel pools
319: and mbuf cluster pool statistics of each network interface.
1.52 jmc 320: .It Ic netstat
1.73 jmc 321: Display network connections.
1.93 okan 322: Each address
323: is displayed numerically in the format
324: .Dq host:port .
1.52 jmc 325: By default, network servers awaiting requests are not displayed.
1.93 okan 326: It is also possible to have addresses displayed symbolically,
327: when possible, and limit the display to a set of protocols
328: (the minimum unambiguous prefix may be supplied):
329: .Bl -tag -width Ar
330: .It Cm all
331: Toggle the displaying of server processes awaiting requests (this
332: is the equivalent of the
333: .Fl a
334: flag to
335: .Xr netstat 1 ) .
336: .It Cm names
337: Display network addresses symbolically.
338: .It Cm numbers
339: Display network addresses numerically.
340: .It Cm reset
341: Reset matching mechanisms to the default.
1.76 jmc 342: .\".It Cm show Oo
1.100 bentley 343: .\".Ar protocols | ports | hosts
1.76 jmc 344: .\".Oc
345: .\"Show, on the command line, the currently selected protocols,
346: .\"hosts, and ports.
347: .\"Protocols, hosts and ports which are being ignored are prefixed with a
348: .\".Ql \&! .
349: .\"If an argument is supplied to
350: .\".Cm show ,
351: .\"then only the requested information will be displayed.
1.101 claudio 352: .It Cm tcp | udp | other
1.93 okan 353: Display only network connections using the indicated protocol.
354: .El
1.79 jasper 355: .It Ic nfsclient
1.80 jmc 356: Display statistics about NFS client activity.
1.84 jmc 357: Output resembles
1.79 jasper 358: .Cm nfsstat Fl c .
359: .It Ic nfsserver
1.80 jmc 360: Display statistics about NFS server activity.
1.84 jmc 361: Output resembles
1.79 jasper 362: .Cm nfsstat Fl s .
1.62 matthieu 363: .It Ic pf
1.64 jmc 364: Display filter information about
1.62 matthieu 365: .Xr pf 4 ,
366: similar to the output of
1.64 jmc 367: .Cm pfctl Fl s Cm info
1.62 matthieu 368: option.
1.1 deraadt 369: .It Ic pigs
1.73 jmc 370: Display those processes resident in main
1.1 deraadt 371: memory and getting the
1.73 jmc 372: largest portion of the processor.
1.1 deraadt 373: When less than 100% of the
374: processor is scheduled to user processes, the remaining time
1.13 aaron 375: is accounted to the
376: .Dq idle
377: process.
1.68 canacar 378: .It Ic pool
379: Display kernel
380: .Xr pool 9
381: statistics similar to the output of
382: .Cm vmstat Fl m .
1.69 canacar 383: Available orderings are:
1.75 canacar 384: .Ic name ,
385: .Ic requests ,
1.76 jmc 386: .Ic size ,
1.69 canacar 387: and
1.75 canacar 388: .Ic number of pages .
1.98 mpi 389: .Pp
390: By default only the statistics of active pools are displayed but pressing
391: .Ic A
392: changes the view to show all of them.
1.102 dlg 393: .It Ic pcache
394: Display kernel
395: .Xr pool 9
396: per CPU cache statistics.
1.104 martijn 397: Ordering is available on all columns.
1.62 matthieu 398: .It Ic queues
1.97 henning 399: Display statistics about the active queues,
400: similar to the output of
1.62 matthieu 401: .Cm pfctl Fl s Cm queue .
402: .It Ic rules
1.64 jmc 403: Display pf rules statistics, similar to the output of
1.62 matthieu 404: .Cm pfctl Fl s Cm rules .
1.52 jmc 405: .It Ic sensors
1.73 jmc 406: Display the current values of available hardware sensors,
1.52 jmc 407: in a format similar to that of
408: .Xr sysctl 8 .
1.62 matthieu 409: .It Ic states
1.64 jmc 410: Display pf states statistics, similar to the output of
1.62 matthieu 411: .Cm pfctl Fl s Cm states .
1.69 canacar 412: Available orderings are:
413: .Ic none ,
414: .Ic bytes ,
415: .Ic expiry ,
416: .Ic packets ,
417: .Ic age ,
418: .Ic source address ,
419: .Ic source port ,
420: .Ic destination address ,
421: .Ic destination port ,
422: .Ic rate ,
423: and
424: .Ic peak
425: columns.
1.1 deraadt 426: .It Ic swap
1.12 aaron 427: Show information about swap space usage on all the
1.1 deraadt 428: swap areas compiled into the kernel.
429: The first column is the device name of the partition.
430: The next column is the total space available in the partition.
1.12 aaron 431: The
1.1 deraadt 432: .Ar Used
433: column indicates the total blocks used so far;
434: the graph shows the percentage of space in use on each partition.
1.8 aaron 435: If there is more than one swap partition in use,
1.1 deraadt 436: a total line is also shown.
1.8 aaron 437: Areas known to the kernel but not in use are shown as not available.
1.1 deraadt 438: .It Ic vmstat
439: Take over the entire display and show a (rather crowded) compendium
440: of statistics related to virtual memory usage, process scheduling,
1.84 jmc 441: device interrupts, system name translation caching, disk I/O, etc.
1.73 jmc 442: This view is the default.
1.1 deraadt 443: .Pp
1.86 lum 444: Below the top line are statistics on memory utilization.
1.1 deraadt 445: The first row of the table reports memory usage only among
1.8 aaron 446: active processes, that is, processes that have run in the previous
1.1 deraadt 447: twenty seconds.
448: The second row reports on memory usage of all processes.
1.47 millert 449: The first column reports on the amount of physical memory
1.1 deraadt 450: claimed by processes.
1.29 jmc 451: The second column reports the same figure for
1.47 millert 452: virtual memory, that is, the amount of memory that would be
453: needed if all processes were resident at the same time.
454: Finally, the last column shows the amount of physical memory
1.1 deraadt 455: on the free list.
456: .Pp
1.5 flipk 457: Below the memory display is a list of the average number of processes
1.13 aaron 458: (over the last refresh interval) that are runnable
459: .Pq Sq r ,
460: in disk wait other than paging
461: .Pq Sq d ,
462: sleeping
463: .Pq Sq s ,
464: and swapped out but desiring to run
465: .Pq Sq w .
1.1 deraadt 466: Below the queue length listing is a numerical listing and
467: a bar graph showing the amount of
1.40 dlg 468: interrupt (shown as
1.100 bentley 469: .Ql | ) ,
1.110 bluhm 470: spinning (shown as
471: .Ql @ ) ,
1.16 aaron 472: system (shown as
473: .Ql = ) ,
1.110 bluhm 474: user plus nice (shown as
1.100 bentley 475: .Ql > ) ,
1.16 aaron 476: and idle time (shown as
1.29 jmc 477: .Ql \ \& ) .
1.1 deraadt 478: .Pp
1.12 aaron 479: To the right of the Proc display are statistics about
1.16 aaron 480: Context switches
481: .Pq Dq Csw ,
482: Traps
483: .Pq Dq Trp ,
484: Syscalls
485: .Pq Dq Sys ,
486: Interrupts
487: .Pq Dq Int ,
488: Soft interrupts
489: .Pq Dq Sof ,
490: and Faults
491: .Pq Dq Flt
1.7 deraadt 492: which have occurred during the last refresh interval.
1.5 flipk 493: .Pp
1.83 jmc 494: Below the CPU usage graph are statistics on name translations.
1.1 deraadt 495: It lists the number of names translated in the previous interval,
496: the number and percentage of the translations that were
497: handled by the system wide name translation cache, and
498: the number and percentage of the translations that were
499: handled by the per process name translation cache.
500: .Pp
1.5 flipk 501: At the bottom left is the disk usage display.
502: It reports the number of seeks, transfers, number
503: of kilobyte blocks transferred per second averaged over the
1.90 lum 504: refresh period of the display, and
1.5 flipk 505: the time spent in disk accesses.
506: .Pp
1.1 deraadt 507: Under the date in the upper right hand quadrant are statistics
508: on paging and swapping activity.
509: The first two columns report the average number of pages
510: brought in and out per second over the last refresh interval
511: due to page faults and the paging daemon.
512: The third and fourth columns report the average number of pages
513: brought in and out per second over the last refresh interval
514: due to swap requests initiated by the scheduler.
515: The first row of the display shows the average
1.8 aaron 516: number of disk transfers per second over the last refresh interval.
517: The second row of the display shows the average
1.1 deraadt 518: number of pages transferred per second over the last refresh interval.
519: .Pp
520: Running down the right hand side of the display is a breakdown
521: of the interrupts being handled by the system.
522: At the top of the list is the total interrupts per second
523: over the time interval.
524: The rest of the column breaks down the total on a device
525: by device basis.
526: Only devices that have interrupted at least once since boot time are shown.
1.83 jmc 527: .Pp
1.89 lum 528: Below the Interrupts display are
529: the average number of input and output packets per second
530: for all interfaces over the last refresh interval.
1.5 flipk 531: .Pp
532: Below the SWAPPING display and slightly to the left of the Interrupts
1.18 aaron 533: display is a list of virtual memory statistics.
534: The abbreviations are:
1.36 jmc 535: .Pp
1.38 niallo 536: .Bl -tag -compact -width "kmapentXX" -offset indent
1.21 deraadt 537: .It forks
538: process forks
539: .It fkppw
540: forks where parent waits
541: .It fksvm
542: forks where vmspace is shared
543: .It pwait
544: fault had to wait on a page
545: .It relck
546: fault relock called
547: .It rlkok
548: fault relock is successful
549: .It noram
550: faults out of ram
551: .It ndcpy
552: number of times fault clears "need copy"
553: .It fltcp
554: number of times fault promotes with copy
555: .It zfod
556: fault promotes with zerofill
1.5 flipk 557: .It cow
1.21 deraadt 558: number of times fault anon cow
559: .It fmin
560: min number of free pages
561: .It ftarg
562: target number of free pages
563: .It itarg
564: target number of inactive pages
565: .It wired
566: wired pages
1.25 deraadt 567: .It pdfre
1.21 deraadt 568: pages daemon freed since boot
569: .It pdscn
570: pages daemon scanned since boot
1.108 krw 571: .It pzidl
1.38 niallo 572: number of zeroed pages
1.108 krw 573: .It kmape
1.38 niallo 574: number of kernel map entries
1.5 flipk 575: .El
1.105 krw 576: .It Ic uvm
1.106 jmc 577: Display statistics relevant to the UVM subsystem.
1.105 krw 578: The statistics are divided into eight groups.
579: .Pp
1.106 jmc 580: .Bl -tag -compact -width "reserve_pagedaemon" -offset indent
581: .It Page Counters:
1.105 krw 582: .It npages
1.106 jmc 583: pages managed by UVM
1.105 krw 584: .It free
585: free pages
586: .It active
587: active pages
588: .It inactive
589: freed pages that may be wanted back
590: .It paging
591: pages in the process of being paged out
592: .It wired
593: wired pages
594: .It zeropages
595: zero'd pages
596: .It reserve_pagedaemon
597: pages reserved for pagedaemon
598: .It reserve_kernel
599: pages reserved for kernel.
600: .It vnodepages
601: pages used by vnode page cache
602: .It vtextpages
603: pages used by vtext vnodes
604: .Pp
1.106 jmc 605: .It Stats Counters:
1.105 krw 606: .It faults
607: page fault count
608: .It traps
609: trap count
610: .It intrs
611: interrupt count
612: .It swtch
613: context switch count
614: .It softs
615: software interrupt count
616: .It syscalls
617: system calls
618: .It pageins
619: pagein operation count
620: .It pgswapin
621: pages swapped in
622: .It pgswapout
623: pages swapped out
624: .It forks
625: forks.
626: .It forks_ppwait
627: forks where parent waits
628: .It forks_sharevm
629: forks where vmspace is shared
630: .It pga_zerohit
631: pagealloc found requested zero'd pages
632: .It pga_zeromiss
633: pagealloc failed to obtain zero'd pages
634: .Pp
1.106 jmc 635: .It Fault Counters:
1.105 krw 636: .It fltnoram
637: fault was out of ram
638: .It fltnoanon
639: fault was out of anons
640: .It fltnoamap
641: fault was out of amap chunks
642: .It fltpgwait
643: fault had to wait on a page
644: .It fltpgrele
645: fault found a released page
646: .It fltrelck
647: fault relock called
648: .It fltrelckok
649: fault relock was a success
650: .It fltanget
651: fault got anon page
652: .It fltanretry
653: fault retried an anon get
654: .It fltamcopy
655: fault cleared "needs copy"
656: .It fltnamap
657: fault mapped a neighbor anon page
658: .It fltnomap
659: fault mapped a neighbor obj page
660: .It fltlget
661: fault did a locked pgo_get
662: .It fltget
663: fault did an unlocked get
664: .It flt_anon
665: fault anon (case 1a)
666: .It flt_acow
667: fault anon cow (case 1b)
668: .It flt_obj
669: fault was on object page (2a)
670: .It flt_prcopy
671: fault promotes with copy (2b)
672: .It flt_przero
673: fault promotes with zerofill (2b)
674: .Pp
1.106 jmc 675: .It Pageout Params:
1.105 krw 676: .It freemin
677: minimum number of free pages
678: .It freetarg
679: target number of free pages
680: .It inactarg
681: target number of inactive pages
682: .It wiredmax
683: maximum number of wired pages
684: .It anonmin
685: mininumu threshold for anon pages
686: .It vtextmin
687: minimum threshold for vtext pages
688: .It vnodemin
689: minimum threshold for vnode pages
690: .It anonminpct
691: minimum percent anon pages
692: .It vtextminpct
693: minimum percent vtext pages
694: .It vnodeminpct
695: minimum percent vnode pages
696: .Pp
1.106 jmc 697: .It Swap Counters:
1.105 krw 698: .It nswapdev
699: configured swap devices
700: .It swpages
701: PAGE_SIZE'ed swap pages
702: .It swpginuse
703: swap pages in use
704: .It swpgonly
705: in use swap pages not in RAM
706: .It nswget
707: fault called uvm_swap_get()
708: .It nanon
709: total anon's
710: .Pp
1.106 jmc 711: .It Daemon Counters:
1.105 krw 712: .It pdwoke
713: times daemon woke up
714: .It pdrevs
715: times daemon rev'd clock hand
716: .It pdswout
717: times daemon called for swapout
718: .It pdfreed
719: pages daemon freed since boot
720: .It pdscans
721: pages daemon scanned since boot
722: .It pdanscan
723: anonymous pages scanned by daemon
724: .It pdobscan
725: object pages scanned by daemon
726: .It pdreact
727: pages daemon reactivated since boot
728: .It pdbusy
729: times daemon found a busy page
730: .It pdpageouts
731: times daemon started a pageout
732: .It pdpending
733: times daemon got a pending pagout
734: .It pddeact
735: pages daemon deactivates
736: .Pp
1.106 jmc 737: .It Misc Counters:
1.105 krw 738: .It fpswtch
739: FPU context switches
740: .It kmapent
741: kernel map entries
742: .Pp
1.106 jmc 743: .It Constants:
1.105 krw 744: .It pagesize
745: size of a page, always a power of 2
746: .It pagemask
747: page mask
748: .It pageshift
749: page shift
1.106 jmc 750: .El
1.35 markus 751: .El
1.74 jmc 752: .\".Pp
753: .\"The following commands are specific to the
754: .\".Ic vmstat
755: .\"and
756: .\".Ic ifstat
757: .\"views; the minimum unambiguous prefix may be supplied.
758: .\".Pp
759: .\".Bl -tag -width Ds -compact
760: .\".It Cm boot
761: .\"Display cumulative statistics since the system was booted.
762: .\".It Cm run
763: .\"Display statistics as a running total from the point this
764: .\"command is given.
765: .\".It Cm time
766: .\"Display statistics averaged over the refresh interval (the default).
767: .\".It Cm zero
768: .\"Reset running statistics to zero.
769: .\".El
770: .\".Pp
771: .\"The following commands are common to each view which shows
772: .\"information about disk drives.
773: .\"These commands are used to select a set of drives to report on,
774: .\"should a system have more drives configured
775: .\"than can normally be displayed on the screen.
776: .\".Pp
777: .\".Bl -tag -width Tx -compact
778: .\".It Cm display Op Ar drives
779: .\"Display information about the drives indicated.
780: .\"Multiple drives may be specified, separated by spaces.
781: .\".It Cm ignore Op Ar drives
782: .\"Do not display information about the drives indicated.
783: .\"Multiple drives may be specified, separated by spaces.
784: .\".El
1.1 deraadt 785: .Sh FILES
1.99 schwarze 786: .Bl -tag -width "/etc/servicesXXX" -compact
1.1 deraadt 787: .It Pa /etc/hosts
1.73 jmc 788: Host names.
1.62 matthieu 789: .It Pa /etc/pf.conf
1.73 jmc 790: .Xr pf 4
791: configuration.
1.1 deraadt 792: .It Pa /etc/services
1.73 jmc 793: Port names.
1.1 deraadt 794: .El
1.15 aaron 795: .Sh SEE ALSO
1.85 jmc 796: .Xr fstat 1 ,
1.15 aaron 797: .Xr kill 1 ,
1.37 jmc 798: .Xr netstat 1 ,
1.79 jasper 799: .Xr nfsstat 1 ,
1.15 aaron 800: .Xr ps 1 ,
801: .Xr top 1 ,
1.37 jmc 802: .Xr iostat 8 ,
1.62 matthieu 803: .Xr pfctl 8 ,
1.37 jmc 804: .Xr pstat 8 ,
805: .Xr renice 8 ,
1.48 deanna 806: .Xr sysctl 8 ,
1.37 jmc 807: .Xr vmstat 8
1.1 deraadt 808: .Sh HISTORY
809: The
1.13 aaron 810: .Nm
1.73 jmc 811: program first appeared in
1.1 deraadt 812: .Bx 4.3 .
813: .Sh BUGS
814: Certain displays presume a minimum of 80 characters per line.
815: The
816: .Ic vmstat
817: display looks out of place because it is (it was added in as
818: a separate display rather than created as a new program).