|
|
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)vmstat.1 6.4 (Berkeley) 2/27/88
6: .\"
7: .TH VMSTAT 1 "February 27, 1988"
8: .UC 4
9: .de s1
10: .if n .sp
11: .if t .sp .1i
12: ..
13: .de t1
14: .if n .ta 5n
15: .if t .ta 1i
16: ..
17: .SH NAME
18: vmstat \- report virtual memory statistics
19: .SH SYNOPSIS
20: .B vmstat
21: [
22: .B \-fsim
23: ]
24: [ drives ]
25: [ interval [ count ] ]
26: .SH DESCRIPTION
27: .I Vmstat
28: delves into the system and normally reports certain statistics kept about
29: process, virtual memory, disk, trap and cpu activity.
30: If given a
31: .B \-f
32: argument, it instead reports on the number of
33: .I forks
34: and
35: .I vforks
36: since system startup and the number of pages of virtual memory involved in each
37: kind of fork.
38: If given a
39: .B \-s
40: argument, it instead prints the contents
41: of the
42: .I sum
43: structure, giving the total number of several kinds of paging related
44: events which have occurred since boot.
45: If given a
46: .B \-i
47: argument, it instead reports on the number of
48: .I interrupts
49: taken by each device since system startup.
50: If given a
51: .B \-m
52: argument, it instead reports on the usage of
53: kernel dynamic memory listed first by
54: .I size
55: of allocation and then by
56: .I type
57: of usage.
58: .PP
59: If none of these options are given,
60: .I vmstat
61: will report in the first line a summary of the virtual memory activity
62: since the system has been booted.
63: If
64: .I interval
65: is specified, then successive lines are summaries over the last
66: .I interval
67: seconds.
68: ``vmstat 5'' will print what the system is doing every five seconds;
69: this is a good choice of printing interval since this is how often
70: some of the statistics are sampled in the system; others vary every
71: second, running the output for a while will make it apparent which
72: are recomputed every second.
73: If a
74: .I count
75: is given, the statistics are repeated
76: .I count
77: times.
78: The format fields are:
79: .PP
80: Procs: information about numbers of processes in various states.
81: .s1
82: .t1
83: .nf
84: r in run queue
85: b blocked for resources (i/o, paging, etc.)
86: w runnable or short sleeper (< 20 secs) but swapped
87: .fi
88: .s1
89: Memory: information about the usage of virtual and real memory.
90: Virtual pages are considered active if they belong to processes which
91: are running or have run in the last 20 seconds.
92: A ``page'' here is 1024 bytes.
93: .s1
94: .t1
95: .nf
96: avm active virtual pages
97: fre size of the free list
98: .fi
99: .s1
100: Page: information about page faults and paging activity.
101: These are averaged each five seconds, and given in units per second.
102: .s1
103: .t1
104: .nf
105: re page reclaims (simulating reference bits)
106: at pages attached (found in free list)
107: pi pages paged in
108: po pages paged out
109: fr pages freed per second
110: de anticipated short term memory shortfall
111: sr pages scanned by clock algorithm, per-second
112: .fi
113: .s1
114: up/hp/rk/ra: Disk operations per second (this field is system dependent).
115: Typically paging will be split across several of the available drives.
116: The number under each of these is the unit number.
117: .s1
118: Faults: trap/interrupt rate averages per second over last 5 seconds.
119: .s1
120: .t1
121: .nf
122: in (non clock) device interrupts per second
123: sy system calls per second
124: cs cpu context switch rate (switches/sec)
125: .fi
126: .s1
127: Cpu: breakdown of percentage usage of CPU time
128: .s1
129: .nf
130: us user time for normal and low priority processes
131: sy system time
132: id cpu idle
133: .fi
134: .PP
135: If more than 4 disk drives are configured in the system,
136: .I vmstat
137: displays only the first 4 drives, with priority given
138: to Massbus disk drives (i.e. if both Unibus and Massbus
139: drives are present and the total number of drives exceeds
140: 4, then some number of Unibus drives will not be displayed
141: in favor of the Massbus drives). To force
142: .I vmstat
143: to display specific drives, their names may be supplied on
144: the command line.
145: .SH FILES
146: /dev/kmem, /vmunix
147: .SH SEE ALSO
148: .IR systat (1),
149: .IR iostat (1)
150: .PP
151: The sections starting with ``Interpreting system activity'' in
152: .IR "Installing and Operating 4.2bsd" .
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.