diff options
Diffstat (limited to 'usr.bin/vmstat/vmstat.8')
-rw-r--r-- | usr.bin/vmstat/vmstat.8 | 206 |
1 files changed, 206 insertions, 0 deletions
diff --git a/usr.bin/vmstat/vmstat.8 b/usr.bin/vmstat/vmstat.8 new file mode 100644 index 0000000..d2eb074 --- /dev/null +++ b/usr.bin/vmstat/vmstat.8 @@ -0,0 +1,206 @@ +.\" Copyright (c) 1986, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)vmstat.8 8.1 (Berkeley) 6/6/93 +.\" +.TH VMSTAT 1 "June 6, 1993" +.UC 4 +.SH NAME +vmstat \- report virtual memory statistics +.SH SYNOPSIS +.nf +.ft B +vmstat [ \-fimst ] [ \-c count ] [ \-M core ] [ \-N system ] +.ti +5 +[ \-w wait ] [ disks ] +.ft R +.fi +.SH DESCRIPTION +.I Vmstat +reports certain kernel statistics kept about process, virtual memory, +disk, trap and cpu activity. +.PP +The options are as follows: +.TP +\-c +Repeat the display +.I count +times. +The first display is for the time since a reboot and each subsequent report +is for the time period since the last display. +If no +.I wait +interval is specified, the default is 1 second. +.TP +\-f +Report on the number +.IR fork (2) +and +.IR vfork (2) +system calls since system startup, and the number of pages of virtual memory +involved in each. +.TP +\-i +Report on the number of interrupts taken by each device since system +startup. +.TP +\-M +Extract values associated with the name list from the specified core +instead of the default ``/dev/kmem''. +.TP +\-N +Extract the name list from the specified system instead of the default +``/vmunix''. +.TP +\-m +Report on the usage of kernel dynamic memory listed first by size of +allocation and then by type of usage. +.TP +\-s +Display the contents of the +.I sum +structure, giving the total number of several kinds of paging related +events which have occurred since system startup. +.TP +\-t +Report on the number of page in and page reclaims since system startup, +and the amount of time required by each. +.TP +\-w +Pause +.I wait +seconds between each display. +If no repeat +.I count +is specified, the default is infinity. +.PP +By default, +.I vmstat +displays the following information: +.PP +.TP +procs +Information about the numbers of processes in various states. +.sp +.RS +.nf +r in run queue +b blocked for resources (i/o, paging, etc.) +w runnable or short sleeper (< 20 secs) but swapped +.fi +.RE +.TP +memory +Information about the usage of virtual and real memory. +Virtual pages (reported in units of 1024 bytes) are considered active if +they belong to processes which are running or have run in the last 20 +seconds. +.sp +.RS +.nf +avm active virtual pages +fre size of the free list +.fi +.RE +.TP +page +Information about page faults and paging activity. +These are averaged each five seconds, and given in units per second. +.sp +.RS +.nf +re page reclaims (simulating reference bits) +at pages attached (found in free list) +pi pages paged in +po pages paged out +fr pages freed per second +de anticipated short term memory shortfall +sr pages scanned by clock algorithm, per-second +.fi +.RE +.TP +disks +Disk operations per second (this field is system dependent). +Typically paging will be split across the available drives. +The header of the field is the first character of the disk name and +the unit number. +If more than four disk drives are configured in the system, +.I vmstat +displays only the first four drives. +To force +.I vmstat +to display specific drives, their names may be supplied on the command line. +.TP +faults +Trap/interrupt rate averages per second over last 5 seconds. +.sp +.RS +.nf +in device interrupts per interval (including clock interrupts) +sy system calls per interval +cs cpu context switch rate (switches/interval) +.fi +.RE +.TP +cpu +Breakdown of percentage usage of CPU time. +.sp +.RS +.nf +us user time for normal and low priority processes +sy system time +id cpu idle +.fi +.RE +.SH EXAMPLES +The command ``vmstat -i 5'' will print what the system is doing every five +seconds; this is a good choice of printing interval since this is how often +some of the statistics are sampled in the system. +Others vary every second and running the output for a while will make it +apparent which are recomputed every second. +.SH FILES +.ta \w'/dev/kmem 'u +/vmunix default kernel namelist +.br +/dev/kmem default memory file +.SH SEE ALSO +.IR fstat (1), +.IR netstat (1), +.IR nfsstat (1), +.IR ps (1), +.IR systat (1), +.IR iostat (8), +.IR pstat (8) +.sp +The sections starting with ``Interpreting system activity'' in +.IR "Installing and Operating 4.3BSD" . +.SH BUGS +The \-c and \-w options are only available with the default output. |