[BACK]Return to systat.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / systat

Annotation of src/usr.bin/systat/systat.1, Revision 1.96

1.96    ! reyk        1: .\"    $OpenBSD: systat.1,v 1.95 2012/12/23 17:01:27 jmc 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.96    ! reyk       33: .Dd $Mdocdate: December 23 2012 $
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 ,
                    139: .Ic malloc ,
1.80      jmc       140: .Ic buckets ,
                    141: .Ic nfsclient ,
1.96    ! reyk      142: .Ic nfsserver ,
1.1       deraadt   143: or
1.96    ! reyk      144: .Ic cpu .
1.2       deraadt   145: These displays can also be requested interactively and are described in
1.1       deraadt   146: full detail below.
1.62      matthieu  147: .Ar view
1.53      jmc       148: may be abbreviated to the minimum unambiguous prefix;
                    149: for example,
1.50      jmc       150: .Dq io
                    151: for
                    152: .Dq iostat .
1.62      matthieu  153: .It Ar delay
1.1       deraadt   154: The
1.62      matthieu  155: .Ar delay
1.73      jmc       156: argument specifies the screen refresh time interval in seconds.
                    157: This is provided for backwards compatibility, and overrides any
1.31      jmc       158: interval specified with the
1.73      jmc       159: .Fl s
1.2       deraadt   160: flag.
1.31      jmc       161: The default interval is 5 seconds.
1.1       deraadt   162: .El
                    163: .Pp
                    164: Certain characters cause immediate action by
1.61      jmc       165: .Nm .
1.63      sobrado   166: These are:
1.1       deraadt   167: .Bl -tag -width Fl
                    168: .It Ic \&:
                    169: Move the cursor to the command line and interpret the input
1.16      aaron     170: line typed as a command.
                    171: While entering a command the
1.1       deraadt   172: current character erase, word erase, and line kill characters
                    173: may be used.
1.69      canacar   174: .It Ic o
                    175: Select the next ordering which sorts the rows according to a
1.70      jmc       176: combination of columns.
                    177: Available orderings depend on the view.
                    178: Not all views support orderings.
1.66      canacar   179: .It Ic p
                    180: Pause
                    181: .Nm .
1.59      jmc       182: .It Ic q
1.73      jmc       183: Quit
1.66      canacar   184: .Nm .
1.69      canacar   185: .It Ic r
                    186: Reverse the selected ordering if supported by the view.
1.91      mpf       187: .It Ic \&,
                    188: Print numbers with thousand separators, where applicable.
1.66      canacar   189: .It Ic ^A \*(Ba Aq Ic Home
                    190: Jump to the beginning of the current view.
                    191: .It Ic ^B \*(Ba Aq Ic right arrow
1.84      jmc       192: Select the previous view.
1.66      canacar   193: .It Ic ^E \*(Ba Aq Ic End
                    194: Jump to the end of the current view.
                    195: .It Ic ^F \*(Ba Aq Ic left arrow
                    196: Select the next view.
                    197: .It Ic ^G
                    198: Print the name of the current
1.73      jmc       199: view being shown and the refresh interval.
1.66      canacar   200: .It Ic ^L
                    201: Refresh the screen.
                    202: .It Ic ^N \*(Ba Aq Ic down arrow
                    203: Scroll current view down by one line.
                    204: .It Ic ^P \*(Ba Aq Ic up arrow
                    205: Scroll current view up by one line.
                    206: .It Ic ^V \*(Ba Aq Ic Page Down
                    207: Scroll current view down by one page.
                    208: .It Ic Alt-V \*(Ba Aq Ic Page Up
                    209: Scroll current view up by one page.
                    210: .It Ic ^Z
                    211: Suspend
1.59      jmc       212: .Nm .
1.1       deraadt   213: .El
                    214: .Pp
1.13      aaron     215: The following commands are interpreted by the
                    216: .Dq global
1.1       deraadt   217: command interpreter.
                    218: .Bl -tag -width Fl
                    219: .It Ic help
1.73      jmc       220: Print the names of the available views on the command line.
1.52      jmc       221: .It Ic quit
1.73      jmc       222: Quit
1.61      jmc       223: .Nm .
1.52      jmc       224: (This may be abbreviated to
                    225: .Ic q . )
1.1       deraadt   226: .It Ic stop
                    227: Stop refreshing the screen.
                    228: .It Xo
                    229: .Op Ic start
                    230: .Op Ar number
                    231: .Xc
1.16      aaron     232: Start (continue) refreshing the screen.
                    233: If a second, numeric,
1.1       deraadt   234: argument is provided it is interpreted as a refresh interval
                    235: (in seconds).
                    236: Supplying only a number will set the refresh interval to this
                    237: value.
                    238: .El
                    239: .Pp
1.73      jmc       240: .Ar view
1.53      jmc       241: may be abbreviated to the minimum unambiguous prefix.
1.73      jmc       242: The available views are:
1.52      jmc       243: .Bl -tag -width "netstatXXX"
1.71      canacar   244: .It Ic buckets
                    245: Display kernel
                    246: .Xr malloc 9
                    247: bucket statistics similar to the output of
                    248: .Cm vmstat Fl m .
1.96    ! reyk      249: .It Ic cpu
        !           250: Display information about the average usage of each CPU,
        !           251: similar to the output provided by
        !           252: .Xr top 1 .
1.52      jmc       253: .It Ic ifstat
1.73      jmc       254: Display interface statistics.
1.52      jmc       255: The
                    256: .Dq State
                    257: column has the format
                    258: .Sm off
                    259: .Xo
                    260: .Cm up \*(Ba dn
                    261: .Bq : Cm U \*(Ba D .
                    262: .Xc
                    263: .Sm on
                    264: .Sq up
                    265: and
                    266: .Sq dn
                    267: represent whether the interface is up or down.
                    268: .Sq U
                    269: and
                    270: .Sq D
                    271: represent whether the interface is connected or not;
                    272: in the case of
                    273: .Xr carp 4
                    274: interfaces, whether the interface is in master or backup state, respectively.
1.92      lum       275: .Pp
1.91      mpf       276: The character
                    277: .Ic B
                    278: changes the counter view between bytes and bits.
1.92      lum       279: Pressing
                    280: .Ic b
                    281: displays statistics as calculated from boot time.
                    282: .Ic r
                    283: changes the counters to show their totals as calculated
                    284: between display refreshes.
                    285: .Ic t
                    286: changes the counters to show the average per second over
                    287: the display refresh interval;
                    288: this is the default.
1.52      jmc       289: .It Ic iostat
1.73      jmc       290: Display statistics about disk throughput.
1.52      jmc       291: Statistics
                    292: on disk throughput show, for each drive, data transferred in kilobytes,
                    293: number of disk transactions performed, and time spent in disk accesses
1.56      otto      294: (in fractions of a second).
1.71      canacar   295: .It Ic malloc
                    296: Display kernel
                    297: .Xr malloc 9
                    298: type statistics similar to the output of
                    299: .Cm vmstat Fl m .
                    300: Available orderings are:
                    301: .Ic name ,
                    302: .Ic inuse ,
                    303: .Ic memuse ,
                    304: and
                    305: .Ic requests .
1.72      jmc       306: .It Ic mbufs
1.78      canacar   307: Display mbuf usage information from kernel pools
                    308: and mbuf cluster pool statistics of each network interface.
1.52      jmc       309: .It Ic netstat
1.73      jmc       310: Display network connections.
1.93      okan      311: Each address
                    312: is displayed numerically in the format
                    313: .Dq host:port .
1.52      jmc       314: By default, network servers awaiting requests are not displayed.
1.93      okan      315: It is also possible to have addresses displayed symbolically,
                    316: when possible, and limit the display to a set of protocols
                    317: (the minimum unambiguous prefix may be supplied):
                    318: .Bl -tag -width Ar
                    319: .It Cm all
                    320: Toggle the displaying of server processes awaiting requests (this
                    321: is the equivalent of the
                    322: .Fl a
                    323: flag to
                    324: .Xr netstat 1 ) .
                    325: .It Cm names
                    326: Display network addresses symbolically.
                    327: .It Cm numbers
                    328: Display network addresses numerically.
                    329: .It Cm reset
                    330: Reset matching mechanisms to the default.
1.76      jmc       331: .\".It Cm show Oo
                    332: .\".Ar protocols \*(Ba ports \*(Ba hosts
                    333: .\".Oc
                    334: .\"Show, on the command line, the currently selected protocols,
                    335: .\"hosts, and ports.
                    336: .\"Protocols, hosts and ports which are being ignored are prefixed with a
                    337: .\".Ql \&! .
                    338: .\"If an argument is supplied to
                    339: .\".Cm show ,
                    340: .\"then only the requested information will be displayed.
1.93      okan      341: .It Cm tcp \*(Ba udp
                    342: Display only network connections using the indicated protocol.
                    343: .El
1.79      jasper    344: .It Ic nfsclient
1.80      jmc       345: Display statistics about NFS client activity.
1.84      jmc       346: Output resembles
1.79      jasper    347: .Cm nfsstat Fl c .
                    348: .It Ic nfsserver
1.80      jmc       349: Display statistics about NFS server activity.
1.84      jmc       350: Output resembles
1.79      jasper    351: .Cm nfsstat Fl s .
1.62      matthieu  352: .It Ic pf
1.64      jmc       353: Display filter information about
1.62      matthieu  354: .Xr pf 4 ,
                    355: similar to the output of
1.64      jmc       356: .Cm pfctl Fl s Cm info
1.62      matthieu  357: option.
1.1       deraadt   358: .It Ic pigs
1.73      jmc       359: Display those processes resident in main
1.1       deraadt   360: memory and getting the
1.73      jmc       361: largest portion of the processor.
1.1       deraadt   362: When less than 100% of the
                    363: processor is scheduled to user processes, the remaining time
1.13      aaron     364: is accounted to the
                    365: .Dq idle
                    366: process.
1.68      canacar   367: .It Ic pool
                    368: Display kernel
                    369: .Xr pool 9
                    370: statistics similar to the output of
                    371: .Cm vmstat Fl m .
1.69      canacar   372: Available orderings are:
1.75      canacar   373: .Ic name ,
                    374: .Ic requests ,
1.76      jmc       375: .Ic size ,
1.69      canacar   376: and
1.75      canacar   377: .Ic number of pages .
1.62      matthieu  378: .It Ic queues
1.64      jmc       379: Display statistics about the active
                    380: .Xr altq 9
                    381: queues, similar to the output of
1.62      matthieu  382: .Cm pfctl Fl s Cm queue .
                    383: .It Ic rules
1.64      jmc       384: Display pf rules statistics, similar to the output of
1.62      matthieu  385: .Cm pfctl Fl s Cm rules .
1.52      jmc       386: .It Ic sensors
1.73      jmc       387: Display the current values of available hardware sensors,
1.52      jmc       388: in a format similar to that of
                    389: .Xr sysctl 8 .
1.62      matthieu  390: .It Ic states
1.64      jmc       391: Display pf states statistics, similar to the output of
1.62      matthieu  392: .Cm pfctl Fl s Cm states .
1.69      canacar   393: Available orderings are:
                    394: .Ic none ,
                    395: .Ic bytes ,
                    396: .Ic expiry ,
                    397: .Ic packets ,
                    398: .Ic age ,
                    399: .Ic source address ,
                    400: .Ic source port ,
                    401: .Ic destination address ,
                    402: .Ic destination port ,
                    403: .Ic rate ,
                    404: and
                    405: .Ic peak
                    406: columns.
1.1       deraadt   407: .It Ic swap
1.12      aaron     408: Show information about swap space usage on all the
1.1       deraadt   409: swap areas compiled into the kernel.
                    410: The first column is the device name of the partition.
                    411: The next column is the total space available in the partition.
1.12      aaron     412: The
1.1       deraadt   413: .Ar Used
                    414: column indicates the total blocks used so far;
                    415: the graph shows the percentage of space in use on each partition.
1.8       aaron     416: If there is more than one swap partition in use,
1.1       deraadt   417: a total line is also shown.
1.8       aaron     418: Areas known to the kernel but not in use are shown as not available.
1.1       deraadt   419: .It Ic vmstat
                    420: Take over the entire display and show a (rather crowded) compendium
                    421: of statistics related to virtual memory usage, process scheduling,
1.84      jmc       422: device interrupts, system name translation caching, disk I/O, etc.
1.73      jmc       423: This view is the default.
1.1       deraadt   424: .Pp
1.86      lum       425: Below the top line are statistics on memory utilization.
1.1       deraadt   426: The first row of the table reports memory usage only among
1.8       aaron     427: active processes, that is, processes that have run in the previous
1.1       deraadt   428: twenty seconds.
                    429: The second row reports on memory usage of all processes.
1.47      millert   430: The first column reports on the amount of physical memory
1.1       deraadt   431: claimed by processes.
1.29      jmc       432: The second column reports the same figure for
1.47      millert   433: virtual memory, that is, the amount of memory that would be
                    434: needed if all processes were resident at the same time.
                    435: Finally, the last column shows the amount of physical memory
1.1       deraadt   436: on the free list.
                    437: .Pp
1.5       flipk     438: Below the memory display is a list of the average number of processes
1.13      aaron     439: (over the last refresh interval) that are runnable
                    440: .Pq Sq r ,
                    441: in disk wait other than paging
                    442: .Pq Sq d ,
                    443: sleeping
                    444: .Pq Sq s ,
                    445: and swapped out but desiring to run
                    446: .Pq Sq w .
1.1       deraadt   447: Below the queue length listing is a numerical listing and
                    448: a bar graph showing the amount of
1.40      dlg       449: interrupt (shown as
1.63      sobrado   450: .Ql \*(Ba ) ,
1.16      aaron     451: system (shown as
                    452: .Ql = ) ,
                    453: user (shown as
1.43      jmc       454: .Ql \*(Gt ) ,
1.16      aaron     455: nice (shown as
                    456: .Ql - ) ,
                    457: and idle time (shown as
1.29      jmc       458: .Ql \ \& ) .
1.1       deraadt   459: .Pp
1.12      aaron     460: To the right of the Proc display are statistics about
1.16      aaron     461: Context switches
                    462: .Pq Dq Csw ,
                    463: Traps
                    464: .Pq Dq Trp ,
                    465: Syscalls
                    466: .Pq Dq Sys ,
                    467: Interrupts
                    468: .Pq Dq Int ,
                    469: Soft interrupts
                    470: .Pq Dq Sof ,
                    471: and Faults
                    472: .Pq Dq Flt
1.7       deraadt   473: which have occurred during the last refresh interval.
1.5       flipk     474: .Pp
1.83      jmc       475: Below the CPU usage graph are statistics on name translations.
1.1       deraadt   476: It lists the number of names translated in the previous interval,
                    477: the number and percentage of the translations that were
                    478: handled by the system wide name translation cache, and
                    479: the number and percentage of the translations that were
                    480: handled by the per process name translation cache.
                    481: .Pp
1.5       flipk     482: At the bottom left is the disk usage display.
                    483: It reports the number of seeks, transfers, number
                    484: of kilobyte blocks transferred per second averaged over the
1.90      lum       485: refresh period of the display, and
1.5       flipk     486: the time spent in disk accesses.
                    487: .Pp
1.1       deraadt   488: Under the date in the upper right hand quadrant are statistics
                    489: on paging and swapping activity.
                    490: The first two columns report the average number of pages
                    491: brought in and out per second over the last refresh interval
                    492: due to page faults and the paging daemon.
                    493: The third and fourth columns report the average number of pages
                    494: brought in and out per second over the last refresh interval
                    495: due to swap requests initiated by the scheduler.
                    496: The first row of the display shows the average
1.8       aaron     497: number of disk transfers per second over the last refresh interval.
                    498: The second row of the display shows the average
1.1       deraadt   499: number of pages transferred per second over the last refresh interval.
                    500: .Pp
                    501: Running down the right hand side of the display is a breakdown
                    502: of the interrupts being handled by the system.
                    503: At the top of the list is the total interrupts per second
                    504: over the time interval.
                    505: The rest of the column breaks down the total on a device
                    506: by device basis.
                    507: Only devices that have interrupted at least once since boot time are shown.
1.83      jmc       508: .Pp
1.89      lum       509: Below the Interrupts display are
                    510: the average number of input and output packets per second
                    511: for all interfaces over the last refresh interval.
1.5       flipk     512: .Pp
                    513: Below the SWAPPING display and slightly to the left of the Interrupts
1.18      aaron     514: display is a list of virtual memory statistics.
                    515: The abbreviations are:
1.36      jmc       516: .Pp
1.38      niallo    517: .Bl -tag -compact -width "kmapentXX" -offset indent
1.21      deraadt   518: .It forks
                    519: process forks
                    520: .It fkppw
                    521: forks where parent waits
                    522: .It fksvm
                    523: forks where vmspace is shared
                    524: .It pwait
                    525: fault had to wait on a page
                    526: .It relck
                    527: fault relock called
                    528: .It rlkok
                    529: fault relock is successful
                    530: .It noram
                    531: faults out of ram
                    532: .It ndcpy
                    533: number of times fault clears "need copy"
                    534: .It fltcp
                    535: number of times fault promotes with copy
                    536: .It zfod
                    537: fault promotes with zerofill
1.5       flipk     538: .It cow
1.21      deraadt   539: number of times fault anon cow
                    540: .It fmin
                    541: min number of free pages
                    542: .It ftarg
                    543: target number of free pages
                    544: .It itarg
                    545: target number of inactive pages
                    546: .It wired
                    547: wired pages
1.25      deraadt   548: .It pdfre
1.21      deraadt   549: pages daemon freed since boot
                    550: .It pdscn
                    551: pages daemon scanned since boot
1.38      niallo    552: .It pzidle
                    553: number of zeroed pages
                    554: .It kmapent
                    555: number of kernel map entries
1.5       flipk     556: .El
1.35      markus    557: .El
1.74      jmc       558: .\".Pp
                    559: .\"The following commands are specific to the
                    560: .\".Ic vmstat
                    561: .\"and
                    562: .\".Ic ifstat
                    563: .\"views; the minimum unambiguous prefix may be supplied.
                    564: .\".Pp
                    565: .\".Bl -tag -width Ds -compact
                    566: .\".It Cm boot
                    567: .\"Display cumulative statistics since the system was booted.
                    568: .\".It Cm run
                    569: .\"Display statistics as a running total from the point this
                    570: .\"command is given.
                    571: .\".It Cm time
                    572: .\"Display statistics averaged over the refresh interval (the default).
                    573: .\".It Cm zero
                    574: .\"Reset running statistics to zero.
                    575: .\".El
                    576: .\".Pp
                    577: .\"The following commands are common to each view which shows
                    578: .\"information about disk drives.
                    579: .\"These commands are used to select a set of drives to report on,
                    580: .\"should a system have more drives configured
                    581: .\"than can normally be displayed on the screen.
                    582: .\".Pp
                    583: .\".Bl -tag -width Tx -compact
                    584: .\".It Cm display Op Ar drives
                    585: .\"Display information about the drives indicated.
                    586: .\"Multiple drives may be specified, separated by spaces.
                    587: .\".It Cm ignore Op Ar drives
                    588: .\"Do not display information about the drives indicated.
                    589: .\"Multiple drives may be specified, separated by spaces.
                    590: .\".El
1.1       deraadt   591: .Sh FILES
1.73      jmc       592: .Bl -tag -width "/etc/networksXXX" -compact
1.1       deraadt   593: .It Pa /etc/hosts
1.73      jmc       594: Host names.
1.1       deraadt   595: .It Pa /etc/networks
1.73      jmc       596: Network names.
1.62      matthieu  597: .It Pa /etc/pf.conf
1.73      jmc       598: .Xr pf 4
                    599: configuration.
1.1       deraadt   600: .It Pa /etc/services
1.73      jmc       601: Port names.
1.1       deraadt   602: .El
1.15      aaron     603: .Sh SEE ALSO
1.85      jmc       604: .Xr fstat 1 ,
1.15      aaron     605: .Xr kill 1 ,
1.37      jmc       606: .Xr netstat 1 ,
1.79      jasper    607: .Xr nfsstat 1 ,
1.15      aaron     608: .Xr ps 1 ,
                    609: .Xr top 1 ,
1.37      jmc       610: .Xr iostat 8 ,
1.62      matthieu  611: .Xr pfctl 8 ,
1.37      jmc       612: .Xr pstat 8 ,
                    613: .Xr renice 8 ,
1.48      deanna    614: .Xr sysctl 8 ,
1.37      jmc       615: .Xr vmstat 8
1.1       deraadt   616: .Sh HISTORY
                    617: The
1.13      aaron     618: .Nm
1.73      jmc       619: program first appeared in
1.1       deraadt   620: .Bx 4.3 .
                    621: .Sh BUGS
                    622: Certain displays presume a minimum of 80 characters per line.
                    623: The
                    624: .Ic vmstat
                    625: display looks out of place because it is (it was added in as
                    626: a separate display rather than created as a new program).