version 1.7, 1997/01/01 18:57:12 |
version 1.8, 1998/01/03 12:14:37 |
|
|
.\" |
.\" |
.\" @(#)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. |