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