![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to vmstat.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / vmstat|
Return to vmstat.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / vmstat |
1.1 root 1: .\" Copyright (c) 1980 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted
5: .\" provided that the above copyright notice and this paragraph are
6: .\" duplicated in all such forms and that any documentation,
7: .\" advertising materials, and other materials related to such
8: .\" distribution and use acknowledge that the software was developed
9: .\" by the University of California, Berkeley. The name of the
10: .\" University may not be used to endorse or promote products derived
11: .\" from this software without specific prior written permission.
12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
15: .\"
16: .\" @(#)vmstat.1 6.5 (Berkeley) 1/19/89
17: .\"
18: .TH VMSTAT 1 "January 19, 1989"
19: .UC 4
20: .de s1
21: .if n .sp
22: .if t .sp .1i
23: ..
24: .de t1
25: .if n .ta 5n
26: .if t .ta 1i
27: ..
28: .SH NAME
29: vmstat \- report virtual memory statistics
30: .SH SYNOPSIS
31: .B vmstat
32: [
33: .B \-fsim
34: ]
35: [ drives ]
36: [ interval [ count ] ]
37: .SH DESCRIPTION
38: .I Vmstat
39: delves into the system and normally reports certain statistics kept about
40: process, virtual memory, disk, trap and cpu activity.
41: If given a
42: .B \-f
43: argument, it instead reports on the number of
44: .I forks
45: and
46: .I vforks
47: since system startup and the number of pages of virtual memory involved in each
48: kind of fork.
49: If given a
50: .B \-s
51: argument, it instead prints the contents
52: of the
53: .I sum
54: structure, giving the total number of several kinds of paging related
55: events which have occurred since boot.
56: If given a
57: .B \-i
58: argument, it instead reports on the number of
59: .I interrupts
60: taken by each device since system startup.
61: If given a
62: .B \-m
63: argument, it instead reports on the usage of
64: kernel dynamic memory listed first by
65: .I size
66: of allocation and then by
67: .I type
68: of usage.
69: .PP
70: If none of these options are given,
71: .I vmstat
72: will report in the first line a summary of the virtual memory activity
73: since the system has been booted.
74: If
75: .I interval
76: is specified, then successive lines are summaries over the last
77: .I interval
78: seconds.
79: ``vmstat 5'' will print what the system is doing every five seconds;
80: this is a good choice of printing interval since this is how often
81: some of the statistics are sampled in the system; others vary every
82: second, running the output for a while will make it apparent which
83: are recomputed every second.
84: If a
85: .I count
86: is given, the statistics are repeated
87: .I count
88: times.
89: The format fields are:
90: .PP
91: Procs: information about numbers of processes in various states.
92: .s1
93: .t1
94: .nf
95: r in run queue
96: b blocked for resources (i/o, paging, etc.)
97: w runnable or short sleeper (< 20 secs) but swapped
98: .fi
99: .s1
100: Memory: information about the usage of virtual and real memory.
101: Virtual pages are considered active if they belong to processes which
102: are running or have run in the last 20 seconds.
103: A ``page'' here is 1024 bytes.
104: .s1
105: .t1
106: .nf
107: avm active virtual pages
108: fre size of the free list
109: .fi
110: .s1
111: Page: information about page faults and paging activity.
112: These are averaged each five seconds, and given in units per second.
113: .s1
114: .t1
115: .nf
116: re page reclaims (simulating reference bits)
117: at pages attached (found in free list)
118: pi pages paged in
119: po pages paged out
120: fr pages freed per second
121: de anticipated short term memory shortfall
122: sr pages scanned by clock algorithm, per-second
123: .fi
124: .s1
125: up/hp/rk/ra: Disk operations per second (this field is system dependent).
126: Typically paging will be split across several of the available drives.
127: The number under each of these is the unit number.
128: .s1
129: Faults: trap/interrupt rate averages per second over last 5 seconds.
130: .s1
131: .t1
132: .nf
133: in (non clock) device interrupts per second
134: sy system calls per second
135: cs cpu context switch rate (switches/sec)
136: .fi
137: .s1
138: Cpu: breakdown of percentage usage of CPU time
139: .s1
140: .nf
141: us user time for normal and low priority processes
142: sy system time
143: id cpu idle
144: .fi
145: .PP
146: If more than 4 disk drives are configured in the system,
147: .I vmstat
148: displays only the first 4 drives, with priority given
149: to Massbus disk drives (i.e. if both Unibus and Massbus
150: drives are present and the total number of drives exceeds
151: 4, then some number of Unibus drives will not be displayed
152: in favor of the Massbus drives). To force
153: .I vmstat
154: to display specific drives, their names may be supplied on
155: the command line.
156: .SH FILES
157: /dev/kmem, /vmunix
158: .SH SEE ALSO
159: .IR systat (1),
160: .IR iostat (1)
161: .PP
162: The sections starting with ``Interpreting system activity'' in
163: .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.