[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.72

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