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