Print this page
5839 vmstat(1M) should stop documenting -c
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/vmstat.1m.man.txt
+++ new/usr/src/man/man1m/vmstat.1m.man.txt
1 1 VMSTAT(1M) Maintenance Commands VMSTAT(1M)
2 2
3 3
4 4
5 5 NAME
6 6 vmstat - report virtual memory statistics
7 7
8 8 SYNOPSIS
9 - vmstat [-cipqsS] [-T u | d] [disks] [interval [count]]
9 + vmstat [-ipqsS] [-T u | d] [disks] [interval [count]]
10 10
11 11
12 12 DESCRIPTION
13 13 vmstat reports virtual memory statistics regarding kernel thread,
14 14 virtual memory, disk, trap, and CPU activity.
15 15
16 16
17 17 On MP (multi-processor) systems, vmstat averages the number of CPUs into
18 18 the output. For per-processor statistics, see mpstat(1M).
19 19
20 20
21 21 vmstat only supports statistics for certain devices. For more general
22 22 system statistics, use sar(1), iostat(1M), or sar(1M).
23 23
24 24
25 25 Without options, vmstat displays a one-line summary of the virtual
26 26 memory activity since the system was booted.
27 27
28 28
29 29 During execution of the kernel status command, the state of the system
30 30 can change. If relevant, a state change message is included in the
31 31 vmstat output, in one of the following forms:
32 32
33 33 <<device added: sd0>>
34 34 <<device removed: sd0>>
35 35 <<processors added: 1, 3>>
|
↓ open down ↓ |
16 lines elided |
↑ open up ↑ |
36 36 <<processors removed: 1, 3>>
37 37
38 38
39 39
40 40
41 41 See for device naming conventions for disks.
42 42
43 43 OPTIONS
44 44 The following options are supported:
45 45
46 - -c
47 - Report cache flushing statistics. This option is obsolete,
48 - and no longer meaningful. This option might be removed in
49 - a future version of Solaris.
50 -
51 -
52 46 -i
53 47 Report the number of interrupts per device. count and
54 48 interval does not apply to the -i option.
55 49
56 50
57 51 -p
58 52 Report paging activity in details. This option will
59 53 display the following, respectively:
60 54
61 55 epi
62 56 Executable page-ins.
63 57
64 58
65 59 epo
66 60 Executable page-outs.
67 61
68 62
69 63 epf
70 64 Executable page-frees.
71 65
72 66
73 67 api
74 68 Anonymous page-ins.
75 69
76 70
77 71 apo
78 72 Anonymous page-outs.
79 73
80 74
81 75 apf
82 76 Anonymous page-frees.
83 77
84 78
85 79 fpi
86 80 File system page-ins.
87 81
88 82
89 83 fpo
90 84 File system page-outs.
91 85
92 86
93 87 fpf
94 88 File system page-frees.
95 89
96 90 When executed in a zone and if the pools facility is
97 91 active, all of the above only report actitivity on the
98 92 processors in the processor set of the zone's pool.
99 93
100 94
101 95 -q
102 96 Suppress messages related to state changes.
103 97
104 98
105 99 -s
106 100 Display the total number of various system events since
107 101 boot. count and interval does not apply to the -s option.
108 102
109 103
110 104 -S
111 105 Report on swapping rather than paging activity. This
112 106 option will change two fields in vmstat's ``paging''
113 107 display: rather than the ``re'' and ``mf'' fields, vmstat
114 108 will report ``si'' (swap-ins) and ``so'' (swap-outs).
115 109
116 110
117 111 -T u | d
118 112 Specify u for a printed representation of the internal
119 113 representation of time. See time(2). Specify d for
120 114 standard date format. See date(1).
121 115
122 116
123 117 OPERANDS
124 118 The following operands are supported:
125 119
126 120 count
127 121 Specifies the number of times that the statistics are
128 122 repeated. count does not apply to the -i and -s options.
129 123
130 124
131 125 disks
132 126 Specifies which disks are to be given priority in the
133 127 output (only four disks fit on a line). Common disk names
134 128 are id, sd, xd, or xy, followed by a number (for example,
135 129 sd2, xd0, and so forth).
136 130
137 131
138 132 interval
139 133 Specifies the last number of seconds over which vmstat
140 134 summarizes activity. This number of seconds repeats
141 135 forever. interval does not apply to the -i and -s options.
142 136
143 137
144 138 EXAMPLES
145 139 Example 1 Using vmstat
146 140
147 141
148 142 The following command displays a summary of what the system is doing
149 143 every five seconds.
150 144
151 145
152 146 example% vmstat 5
153 147
154 148
155 149 kthr memory page disk faults cpu
156 150 r b w swap free re mf pi p fr de sr s0 s1 s2 s3 in sy cs us sy id
157 151 0 0 0 11456 4120 1 41 19 1 3 0 2 0 4 0 0 48 112 130 4 14 82
158 152 0 0 1 10132 4280 0 4 44 0 0 0 0 0 23 0 0 211 230 144 3 35 62
159 153 0 0 1 10132 4616 0 0 20 0 0 0 0 0 19 0 0 150 172 146 3 33 64
160 154 0 0 1 10132 5292 0 0 9 0 0 0 0 0 21 0 0 165 105 130 1 21 78
161 155 1 1 1 10132 5496 0 0 5 0 0 0 0 0 23 0 0 183 92 134 1 20 79
162 156 1 0 1 10132 5564 0 0 25 0 0 0 0 0 18 0 0 131 231 116 4 34 62
163 157 1 0 1 10124 5412 0 0 37 0 0 0 0 0 22 0 0 166 179 118 1 33 67
164 158 1 0 1 10124 5236 0 0 24 0 0 0 0 0 14 0 0 109 243 113 4 56 39
165 159 ^C
166 160
167 161 example%
168 162
169 163
170 164
171 165
172 166 The fields of vmstat's display are
173 167
174 168
175 169 kthr
176 170 Report the number of kernel threads in each of the three
177 171 following states:
178 172
179 173 r
180 174 the number of kernel threads in run queue
181 175
182 176
183 177 b
184 178 the number of blocked kernel threads that are waiting
185 179 for resources I/O, paging, and so forth
186 180
187 181
188 182 w
189 183 the number of swapped out lightweight processes (LWPs)
190 184 that are waiting for processing resources to finish.
191 185
192 186
193 187
194 188 memory
195 189 Report on usage of virtual and real memory.
196 190
197 191 swap
198 192 available swap space (Kbytes)
199 193
200 194
201 195 free
202 196 size of the free list (Kbytes)
203 197
204 198
205 199
206 200 page
207 201 Report information about page faults and paging activity. The
208 202 information on each of the following activities is given in
209 203 units per second.
210 204
211 205 re
212 206 page reclaims but see the -S option for how this field
213 207 is modified.
214 208
215 209
216 210 mf
217 211 minor faults but see the -S option for how this field
218 212 is modified.
219 213
220 214
221 215 pi
222 216 kilobytes paged in
223 217
224 218
225 219 po
226 220 kilobytes paged out
227 221
228 222
229 223 fr
230 224 kilobytes freed
231 225
232 226
233 227 de
234 228 anticipated short-term memory shortfall (Kbytes)
235 229
236 230
237 231 sr
238 232 pages scanned by clock algorithm
239 233
240 234 When executed in a zone and if the pools facility is active,
241 235 all of the above (except for "de") only report activity on
242 236 the processors in the processor set of the zone's pool.
243 237
244 238
245 239 disk
246 240 Report the number of disk operations per second. There are
247 241 slots for up to four disks, labeled with a single letter and
248 242 number. The letter indicates the type of disk (s = SCSI, i =
249 243 IPI, and so forth); the number is the logical unit number.
250 244
251 245
252 246 faults
253 247 Report the trap/interrupt rates (per second).
254 248
255 249 in
256 250 interrupts
257 251
258 252
259 253 sy
260 254 system calls
261 255
262 256
263 257 cs
264 258 CPU context switches
265 259
266 260 When executed in a zone and if the pools facility is active,
267 261 all of the above only report actitivity on the processors in
268 262 the processor set of the zone's pool.
269 263
270 264
271 265 cpu
272 266 Give a breakdown of percentage usage of CPU time. On MP
273 267 systems, this is an average across all processors.
274 268
275 269 us
276 270 user time
277 271
278 272
279 273 sy
280 274 system time
281 275
282 276
283 277 id
284 278 idle time
285 279
286 280 When executed in a zone and if the pools facility is active,
287 281 all of the above only report actitivity on the processors in
288 282 the processor set of the zone's pool.
289 283
290 284
291 285 ATTRIBUTES
292 286 See attributes(5) for descriptions of the following attributes:
293 287
294 288
295 289
296 290
297 291 +--------------------+-----------------+
298 292 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
299 293 +--------------------+-----------------+
300 294 |Interface Stability | See below. |
301 295 +--------------------+-----------------+
302 296
303 297
304 298 Invocation is evolving. Human readable output is unstable.
|
↓ open down ↓ |
243 lines elided |
↑ open up ↑ |
305 299
306 300 SEE ALSO
307 301 date(1), sar(1), iostat(1M), mpstat(1M), sar(1M), time(2),
308 302 attributes(5)
309 303
310 304 NOTES
311 305 The sum of CPU utilization might vary slightly from 100 because of
312 306 rounding errors in the production of a percentage figure.
313 307
314 308
315 - The -c option (Report cache flushing statistics) is not supported in
316 - this release.
317 -
318 309
319 310
320 - March 23, 2009 VMSTAT(1M)
311 + April 14, 2015 VMSTAT(1M)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX