version 1.32, 2005/06/23 14:32:48 |
version 1.33, 2005/06/29 00:38:18 |
|
|
.Op Fl M Ar core |
.Op Fl M Ar core |
.Op Fl N Ar system |
.Op Fl N Ar system |
.Op Fl w Ar wait |
.Op Fl w Ar wait |
.Op Ar disks |
.Op Ar disk ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
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. |
|
The default behavior is to print a one-line summary of these statistics. |
|
The |
|
.Fl c |
|
and |
|
.Fl w |
|
flags may be used to continually report summaries. |
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
|
.It Fl f |
.It Fl f |
Report on the number of |
Report on the number of |
.Xr fork 2 , |
.Xr fork 2 , |
.Xr rfork 2 |
.Xr rfork 2 , |
and |
and |
.Xr vfork 2 |
.Xr vfork 2 |
system calls as well as kernel thread creations since system startup, |
system calls as well as kernel thread creations since system startup, |
|
|
Extract the name list from the specified system instead of the running kernel. |
Extract the name list from the specified system instead of the running kernel. |
.It Fl s |
.It Fl s |
Display the contents of the |
Display the contents of the |
.Ar sum |
.Va uvmexp |
structure, giving the total number of several kinds of paging related |
structure (see |
|
.Xr uvm 9 ) , |
|
giving the total number of several kinds of paging related |
events which have occurred since system startup. |
events which have occurred since system startup. |
.It Fl t |
.It Fl 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, |
|
|
By default, |
By default, |
.Nm |
.Nm |
displays the following information just once: |
displays the following information just once: |
.Bl -tag -width "whatever" |
.Bl -tag -width Ds |
.It Ar procs |
.It Li procs |
Information about the numbers of processes in various states. |
Information about the numbers of processes in various states. |
.Pp |
.Pp |
.Bl -inset -width xxxxxx -compact |
.Bl -tag -width 4n -compact |
.It Ar r |
.It Li r |
in run queue |
in run queue |
.It Ar b |
.It Li b |
blocked for resources (i/o, paging, etc.) |
blocked for resources (I/O, paging, etc.) |
.It Ar w |
.It Li w |
runnable or short sleeper (< 20 secs) but swapped |
runnable or short sleeper (< 20 secs) but swapped |
.El |
.El |
.Pp |
.It Li memory |
.It Ar memory |
|
Information about the usage of virtual and real memory. |
Information about the usage of virtual and real memory. |
Virtual pages |
Virtual pages |
(reported in units of 1024 bytes) are considered active if they belong |
(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. |
to processes which are running or have run in the last 20 seconds. |
.Pp |
.Pp |
.Bl -inset -width xxxxxx -compact |
.Bl -tag -width 4n -compact |
.It Ar avm |
.It Li avm |
active virtual pages |
active virtual pages |
.It Ar fre |
.It Li fre |
size of the free list |
size of the free list |
.El |
.El |
.Pp |
.It Li 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. |
.Pp |
.Pp |
.Bl -tag -width flt -compact |
.Bl -tag -width 4n -compact |
.It Ar flt |
.It Li flt |
page faults |
page faults |
.It Ar re |
.It Li re |
page reclaims (simulating reference bits) |
page reclaims (simulating reference bits) |
.It Ar at |
.It Li at |
pages attached (found in free list) |
pages attached (found in free list) |
.It Ar pi |
.It Li pi |
pages paged in |
pages paged in |
.It Ar po |
.It Li po |
pages paged out |
pages paged out |
.It Ar fr |
.It Li fr |
pages freed |
pages freed |
.It Ar sr |
.It Li sr |
pages scanned by clock algorithm |
pages scanned by clock algorithm |
.El |
.El |
.Pp |
.It Li disks |
.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 |
|
|
To force |
To force |
.Nm |
.Nm |
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. |
.Pp |
.It Li traps |
.It Ar traps |
|
Trap/interrupt rate averages per second over last 5 seconds. |
Trap/interrupt rate averages per second over last 5 seconds. |
.Pp |
.Pp |
.Bl -inset -width xxxxxx -compact |
.Bl -tag -width 4n -compact |
.It Ar int |
.It Li int |
device interrupts per interval (including clock interrupts) |
device interrupts per interval (including clock interrupts) |
.It Ar sys |
.It Li sys |
system calls per interval |
system calls per interval |
.It Ar cs |
.It Li cs |
\ \&CPU context switch rate (switches/interval) |
CPU context switch rate (switches/interval) |
.El |
.El |
.Pp |
.It Li cpu |
.It Ar cpu |
|
Breakdown of percentage usage of CPU time. |
Breakdown of percentage usage of CPU time. |
.Pp |
.Pp |
.Bl -inset -width xxxxxx -compact |
.Bl -tag -width 4n -compact |
.It Ar us |
.It Li us |
user time for normal and low priority processes |
user time for normal and low priority processes |
.It Ar sy |
.It Li sy |
system time |
system time |
.It Ar id |
.It Li id |
CPU idle |
CPU idle |
.El |
.El |
.El |
.El |
|
.Sh FILES |
|
.Bl -tag -width Pa -compact |
|
.It Pa /bsd |
|
default kernel image |
|
.It Pa /dev/kmem |
|
default memory file |
|
.El |
.Sh EXAMPLES |
.Sh EXAMPLES |
The command |
The command |
.Ic vmstat -w 5 |
.Ic vmstat -w 5 |
|
|
.Xr ps 1 , |
.Xr ps 1 , |
.Xr systat 1 , |
.Xr systat 1 , |
.Xr iostat 8 , |
.Xr iostat 8 , |
.Xr pstat 8 |
.Xr pstat 8 , |
.Pp |
.Xr uvm 9 |
The sections starting with |
|
.Dq Interpreting system activity |
|
in |
|
.%T "Installing and Operating 4.3BSD" . |
|
.Sh BUGS |
.Sh BUGS |
The |
The |
.Fl c |
.Fl c |