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