Commit | Line | Data |
---|---|---|
a5a04f92 KM |
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 | .\" | |
e6c2ef59 | 5 | .\" @(#)vmstat.8 6.2 (Berkeley) %G% |
a5a04f92 | 6 | .\" |
6a2866ad | 7 | .TH VMSTAT 1 "" |
a5a04f92 KM |
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 | [ | |
6a2866ad | 22 | .B \-fsi |
a5a04f92 | 23 | ] |
6a2866ad | 24 | [ drives ] |
a5a04f92 KM |
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. | |
6a2866ad KM |
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. | |
a5a04f92 KM |
50 | .PP |
51 | If none of these options are given, | |
52 | .I vmstat | |
7d8111ac KM |
53 | will report in the first line a summary of the virtual memory activity |
54 | since the system has been booted. | |
55 | If | |
a5a04f92 | 56 | .I interval |
7d8111ac | 57 | is specified, then successive lines are summaries over the last |
a5a04f92 | 58 | .I interval |
7d8111ac | 59 | seconds. |
a5a04f92 KM |
60 | ``vmstat 5'' will print what the system is doing every five seconds; |
61 | this is a good choice of printing interval since this is how often | |
62 | some of the statistics are sampled in the system; others vary every | |
63 | second, running the output for a while will make it apparent which | |
64 | are recomputed every second. | |
65 | If a | |
66 | .I count | |
67 | is given, the statistics are repeated | |
68 | .I count | |
69 | times. | |
70 | The format fields are: | |
71 | .PP | |
72 | Procs: information about numbers of processes in various states. | |
73 | .s1 | |
74 | .t1 | |
75 | .nf | |
76 | r in run queue | |
77 | b blocked for resources (i/o, paging, etc.) | |
78 | w runnable or short sleeper (< 20 secs) but swapped | |
79 | .fi | |
80 | .s1 | |
81 | Memory: information about the usage of virtual and real memory. | |
82 | Virtual pages are considered active if they belong to processes which | |
83 | are running or have run in the last 20 seconds. | |
84 | A ``page'' here is 1024 bytes. | |
85 | .s1 | |
86 | .t1 | |
87 | .nf | |
88 | avm active virtual pages | |
89 | fre size of the free list | |
90 | .fi | |
91 | .s1 | |
92 | Page: information about page faults and paging activity. | |
93 | These are averaged each five seconds, and given in units per second. | |
94 | .s1 | |
95 | .t1 | |
96 | .nf | |
97 | re page reclaims (simulating reference bits) | |
6a2866ad | 98 | at pages attached (found in free list) |
a5a04f92 KM |
99 | pi pages paged in |
100 | po pages paged out | |
101 | fr pages freed per second | |
102 | de anticipated short term memory shortfall | |
103 | sr pages scanned by clock algorithm, per-second | |
104 | .fi | |
105 | .s1 | |
6a2866ad | 106 | up/hp/rk/ra: Disk operations per second (this field is system dependent). |
a5a04f92 KM |
107 | Typically paging will be split across several of the available drives. |
108 | The number under each of these is the unit number. | |
109 | .s1 | |
110 | Faults: trap/interrupt rate averages per second over last 5 seconds. | |
111 | .s1 | |
112 | .t1 | |
113 | .nf | |
114 | in (non clock) device interrupts per second | |
115 | sy system calls per second | |
116 | cs cpu context switch rate (switches/sec) | |
117 | .fi | |
118 | .s1 | |
119 | Cpu: breakdown of percentage usage of CPU time | |
120 | .s1 | |
121 | .nf | |
122 | us user time for normal and low priority processes | |
123 | sy system time | |
124 | id cpu idle | |
e6c2ef59 | 125 | .fi |
6a2866ad KM |
126 | .PP |
127 | If more than 4 disk drives are configured in the system, | |
128 | .I vmstat | |
129 | displays only the first 4 drives, with priority given | |
130 | to Massbus disk drives (i.e. if both Unibus and Massbus | |
131 | drives are present and the total number of drives exceeds | |
132 | 4, then some number of Unibus drives will not be displayed | |
133 | in favor of the Massbus drives). To force | |
134 | .I vmstat | |
135 | to display specific drives, their names may be supplied on | |
136 | the command line. | |
a5a04f92 KM |
137 | .SH FILES |
138 | /dev/kmem, /vmunix | |
139 | .SH SEE ALSO | |
6a2866ad KM |
140 | .IR systat (1), |
141 | .IR vsta (1) | |
142 | .PP | |
a5a04f92 | 143 | The sections starting with ``Interpreting system activity'' in |
7d8111ac | 144 | .IR "Installing and Operating 4.2bsd" . |
a5a04f92 KM |
145 | .SH AUTHORS |
146 | William Joy and Ozalp Babaoglu |