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

Diff for /src/usr.bin/vmstat/vmstat.8 between version 1.7 and 1.8

version 1.7, 1997/01/01 18:57:12 version 1.8, 1998/01/03 12:14:37
Line 34 
Line 34 
 .\"  .\"
 .\"     @(#)vmstat.8    8.1 (Berkeley) 6/6/93  .\"     @(#)vmstat.8    8.1 (Berkeley) 6/6/93
 .\"  .\"
 .TH VMSTAT 8 "June 6, 1993"  .Dd June 6, 1993
 .UC 4  .Dt VMSTAT 8
 .SH NAME  .Os
 vmstat \- report virtual memory statistics  .Sh NAME
 .SH SYNOPSIS  .Nm vmstat
 .nf  .Nd report virtual memory statistics
 .ft B  .Sh SYNOPSIS
 vmstat [ \-fimst ] [ \-c count ] [ \-M core ] [ \-N system ]  .Nm vmstat
 .ti +5  .Op Fl fimst
 [ \-w wait ] [ disks ]  .Nm vmstat
 .ft R  .Op Fl c Ar count
 .fi  .Op Fl M Ar count
 .SH DESCRIPTION  .Op Fl N Ar system
 .I Vmstat  .Op Fl w Ar wait
   .Op disks
   .Sh DESCRIPTION
   .Nm vmstat
 reports certain kernel statistics kept about process, virtual memory,  reports certain kernel statistics kept about process, virtual memory,
 disk, trap and cpu activity.  disk, trap and cpu activity.
 .PP  .Pp
 The options are as follows:  The options are as follows:
 .TP  .Bl -tag -width "blah"
 \-c  .It Fl c Ar count
 Repeat the display  Repeat the display
 .I count  .Ar count
 times.  times.
 The first display is for the time since a reboot and each subsequent report  The first display is for the time since a reboot and each subsequent report
 is for the time period since the last display.  is for the time period since the last display.
 If no  If no
 .I wait  .Ar wait
 interval is specified, the default is 1 second.  interval is specified, the default is 1 second.
 .TP  .It Fl f
 \-f  
 Report on the number  Report on the number
 .IR fork (2) ,  .Xr fork 2 ,
 .IR vfork (2)  .Xr vfork 2 ,
 and  and
 .IR rfork (2)  .Xr rfork 2
 system calls since system startup, and the number of pages of virtual memory  system calls since system startup, and the number of pages of virtual memory
 involved in each.  involved in each.
 .TP  .It Fl i
 \-i  
 Report on the number of interrupts taken by each device since system  Report on the number of interrupts taken by each device since system
 startup.  startup.
 .TP  .It Fl M Ar core
 \-M  
 Extract values associated with the name list from the specified core  Extract values associated with the name list from the specified core
 instead of the default ``/dev/mem''.  instead of the default
 .TP  .Pa /dev/mem .
 \-N  .It Fl N Ar system
 Extract the name list from the specified system instead of the default  Extract the name list from the specified system instead of the default
 ``/bsd''.  .Pa /bsd .
 .TP  .It Fl m
 \-m  
 Report on the usage of kernel dynamic memory listed first by size of  Report on the usage of kernel dynamic memory listed first by size of
 allocation and then by type of usage.  allocation and then by type of usage.
 .TP  .It Fl s
 \-s  
 Display the contents of the  Display the contents of the
 .I sum  .Ar sum
 structure, giving the total number of several kinds of paging related  structure, giving the total number of several kinds of paging related
 events which have occurred since system startup.  events which have occurred since system startup.
 .TP  .It Fl t
 \-t  
 Report on the number of page in and page reclaims since system startup,  Report on the number of page in and page reclaims since system startup,
 and the amount of time required by each.  and the amount of time required by each.
 .TP  .It Fl w Ar wait
 \-w  
 Pause  Pause
 .I wait  .Ar wait
 seconds between each display.  seconds between each display.
 If no repeat  If no repeat
 .I count  .Ar count
 is specified, the default is infinity.  is specified, the default is infinity.
 .PP  .El
   .Pp
 By default,  By default,
 .I vmstat  .Nm vmstat
 displays the following information:  displays the following information just once:
 .PP  .Pp
 .TP  .Bl -tag -width "whatever"
 procs  .It procs
 Information about the numbers of processes in various states.  Information about the numbers of processes in various states.
 .sp  .Pp
 .RS  .Bl -inset -width xxxxxx -compact
 .nf  .It Ar r
 r       in run queue  in run queue
 b       blocked for resources (i/o, paging, etc.)  .It Ar b
 w       runnable or short sleeper (< 20 secs) but swapped  blocked for resources (i/o, paging, etc.)
 .fi  .It Ar w
 .RE  runnable or short sleeper (< 20 secs) but swapped
 .TP  .El
 memory  .Pp
 Information about the usage of virtual and real memory.  .It Ar memory
 Virtual pages (reported in units of 1024 bytes) are considered active if  Information about the usage of virtual and real memory.  Virtual pages
 they belong to processes which are running or have run in the last 20  (reported in units of 1024 bytes) are considered active if they belong
 seconds.  to processes which are running or have run in the last 20 seconds.
 .sp  .Pp
 .RS  .Bl -inset -width xxxxxx -compact
 .nf  .It Ar avm
 avm     active virtual pages  active virtual pages
 fre     size of the free list  .It Ar fre
 .fi  size of the free list
 .RE  .El
 .TP  .Pp
 page  .It Ar page
 Information about page faults and paging activity.  Information about page faults and paging activity.
 These are averaged each five seconds, and given in units per second.  These are averaged each five seconds, and given in units per second.
 .sp  .Pp
 .RS  .Bl -inset -width xxxxxx -compact
 .nf  .It Ar re
 re      page reclaims (simulating reference bits)  page reclaims (simulating reference bits)
 at      pages attached (found in free list)  .It Ar at
 pi      pages paged in  pages attached (found in free list)
 po      pages paged out  .It Ar pi
 fr      pages freed per second  pages paged in
 de      anticipated short term memory shortfall  .It Ar po
 sr      pages scanned by clock algorithm, per-second  pages paged out
 .fi  .It Ar fr
 .RE  pages freed per second
 .TP  .It Ar de
 disks  anticipated short term memory shortfall
   .It Ar sr
   pages scanned by clock algorithm, per-second
   .El
   .Pp
   .It Ar disks
 Disk transfers per second.  Disk transfers per second.
 Typically paging will be split across the available drives.  Typically paging will be split across the available drives.
 The header of the field is the first character of the disk name and  The header of the field is the first character of the disk name and
 the unit number.  the unit number.
 If more than four disk drives are configured in the system,  If more than four disk drives are configured in the system,
 .I vmstat  .Nm vmstat
 displays only the first four drives.  displays only the first four drives.
 To force  To force
 .I vmstat  .Nm vmstat
 to display specific drives, their names may be supplied on the command line.  to display specific drives, their names may be supplied on the command line.
 .TP  .Pp
 faults  .It Ar faults
 Trap/interrupt rate averages per second over last 5 seconds.  Trap/interrupt rate averages per second over last 5 seconds.
 .sp  .Pp
 .RS  .Bl -inset -width xxxxxx -compact
 .nf  .It Ar in
 in      device interrupts per interval (including clock interrupts)  device interrupts per interval (including clock interrupts)
 sy      system calls per interval  .It Ar sy
 cs      cpu context switch rate (switches/interval)  system calls per interval
 .fi  .It Ar cs
 .RE  cpu context switch rate (switches/interval)
 .TP  .El
 cpu  .Pp
   .It Ar cpu
 Breakdown of percentage usage of CPU time.  Breakdown of percentage usage of CPU time.
 .sp  .Pp
 .RS  .Bl -inset -width xxxxxx -compact
 .nf  .It Ar us
 us      user time for normal and low priority processes  user time for normal and low priority processes
 sy      system time  .It Ar sy
 id      cpu idle  system time
 .fi  .It Ar id
 .RE  cpu idle
 .SH EXAMPLES  .El
   .El
   .Pp
   .Sh EXAMPLES
 The command ``vmstat -w 5'' will print what the system is doing every five  The command ``vmstat -w 5'' will print what the system is doing every five
 seconds; this is a good choice of printing interval since this is how often  seconds; this is a good choice of printing interval since this is how often
 some of the statistics are sampled in the system.  some of the statistics are sampled in the system.
 Others vary every second and running the output for a while will make it  Others vary every second and running the output for a while will make it
 apparent which are recomputed every second.  apparent which are recomputed every second.
 .SH FILES  .Sh FILES
 .ta \w'/dev/mem  'u  .Bl -tag -width /etc/networks -compact
 /bsd    default kernel namelist  .It Pa /bsd
 .br  Default kernel namelist
 /dev/mem        default memory file  .It Pa /dev/mem
 .SH SEE ALSO  Default memory file
 .IR fstat (1),  .El
 .IR netstat (1),  .Pp
 .IR nfsstat (1),  .Sh SEE ALSO
 .IR ps (1),  .Xr fstat 1 ,
 .IR systat (1),  .Xr netstat 1 ,
 .IR iostat (8),  .Xr nfsstat 1 ,
 .IR pstat (8)  .Xr ps 1 ,
   .Xr systat 1 ,
   .Xr iostat 8 ,
   .Xr pstat 8
 .sp  .sp
 The sections starting with ``Interpreting system activity'' in  The sections starting with ``Interpreting system activity'' in
 .IR "Installing and Operating 4.3BSD" .  .Xr "Installing and Operating 4.3BSD" .
 .SH BUGS  .Sh BUGS
 The \-c and \-w options are only available with the default output.  The
   .Fl c
   and
   .Fl w
   options are only available with the default output.
   .Pp
   This manual page lacks an incredible amount of detail.
Legend:
Removed from v.1.7  
changed lines
  Added in v.1.8