|
|
1.1 root 1: .TH VMSTAT 1 "26 April 1981"
2: .de s1
3: .if n .sp
4: .if t .sp .1i
5: ..
6: .de t1
7: .if n .ta 5n
8: .if t .ta 1i
9: ..
10: .UC 4
11: .SH NAME
12: vmstat \- report virtual memory statistics
13: .SH SYNOPSIS
14: .B vmstat
15: [
16: .B \-fs
17: ]
18: [ interval [ count ] ]
19: .SH DESCRIPTION
20: .I Vmstat
21: delves into the system and normally reports certain statistics kept about
22: process, virtual memory, disk, trap and cpu activity.
23: If given a
24: .B \-f
25: argument, it instead reports on the number of
26: .I forks
27: and
28: .I vforks
29: since system startup and the number of pages of virtual memory involved in each
30: kind of fork.
31: If given a
32: .B \-s
33: argument, it instead prints the contents
34: of the
35: .I sum
36: structure, giving the total number of several kinds of paging related
37: events which have occurred since boot.
38: .PP
39: If none of these options are given,
40: .I vmstat
41: will report in the first line a summary of the virtual memory activity
42: since the system has been booted.
43: If
44: .I interval
45: is specified, then successive lines are summaries over the last
46: .I interval
47: seconds.
48: ``vmstat 5'' will print what the system is doing every five seconds;
49: this is a good choice of printing interval since this is how often
50: some of the statistics are sampled in the system; others vary every
51: second, running the output for a while will make it apparent which
52: are recomputed every second.
53: If a
54: .I count
55: is given, the statistics are repeated
56: .I count
57: times.
58: The format fields are:
59: .PP
60: Procs: information about numbers of processes in various states.
61: .s1
62: .t1
63: .nf
64: r in run queue
65: b blocked for resources (i/o, paging, etc.)
66: w runnable or short sleeper (< 20 secs) but swapped
67: .fi
68: .s1
69: Memory: information about the usage of virtual and real memory.
70: Virtual pages are considered active if they belong to processes which
71: are running or have run in the last 20 seconds.
72: A ``page'' here is 1024 bytes.
73: .s1
74: .t1
75: .nf
76: avm active virtual pages
77: fre size of the free list
78: .fi
79: .s1
80: Page: information about page faults and paging activity.
81: These are averaged each five seconds, and given in units per second.
82: .s1
83: .t1
84: .nf
85: re page reclaims (simulating reference bits)
86: pi pages paged in
87: po pages paged out
88: fr pages freed per second
89: de anticipated short term memory shortfall
90: sr pages scanned by clock algorithm, per-second
91: .fi
92: .s1
93: up/hp/rk: Disk operations per second (this field is system dependent).
94: Typically paging will be split across several of the available drives.
95: The number under each of these is the unit number.
96: .s1
97: Faults: trap/interrupt rate averages per second over last 5 seconds.
98: .s1
99: .t1
100: .nf
101: in (non clock) device interrupts per second
102: sy system calls per second
103: cs cpu context switch rate (switches/sec)
104: .fi
105: .s1
106: Cpu: breakdown of percentage usage of CPU time
107: .s1
108: .nf
109: us user time for normal and low priority processes
110: sy system time
111: id cpu idle
112: .SH FILES
113: /dev/kmem, /vmunix
114: .SH SEE ALSO
115: The sections starting with ``Interpreting system activity'' in
116: .IR "Installing and Operating 4.2bsd" .
117: .SH AUTHORS
118: William Joy and Ozalp Babaoglu
119: .SH BUGS
120: There should be a screen oriented program which combines
121: .I vmstat
122: and
123: .IR ps (1)
124: in real time
125: as well as reporting on other system activity.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.