Print this page
5839 vmstat(1M) should stop documenting -c
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/vmstat.1m
+++ new/usr/src/man/man1m/vmstat.1m
1 1 '\" te
2 2 .\" Copyright (c) 2001 Sun Microsystems, Inc. All Rights Reserved.
3 3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 4 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 -.TH VMSTAT 1M "Mar 23, 2009"
6 +.TH VMSTAT 1M "April 14, 2015"
7 7 .SH NAME
8 8 vmstat \- report virtual memory statistics
9 9 .SH SYNOPSIS
10 10 .LP
11 11 .nf
12 -\fBvmstat\fR [\fB-cipqsS\fR] [\fB-T\fR u | d] [\fIdisks\fR] [\fIinterval\fR [\fIcount\fR]]
12 +\fBvmstat\fR [\fB-ipqsS\fR] [\fB-T\fR u | d] [\fIdisks\fR] [\fIinterval\fR [\fIcount\fR]]
13 13 .fi
14 14
15 15 .SH DESCRIPTION
16 -.sp
17 16 .LP
18 17 \fBvmstat\fR reports virtual memory statistics regarding kernel thread, virtual
19 18 memory, disk, trap, and \fBCPU\fR activity.
20 19 .sp
21 20 .LP
22 21 On \fBMP\fR (multi-processor) systems, \fBvmstat\fR averages the number of
23 22 \fBCPUs\fR into the output. For per-processor statistics, see \fBmpstat\fR(1M).
24 23 .sp
25 24 .LP
26 25 \fBvmstat\fR only supports statistics for certain devices. For more general
27 26 system statistics, use \fBsar\fR(1), \fBiostat\fR(1M), or \fBsar\fR(1M).
28 27 .sp
29 28 .LP
30 29 Without options, \fBvmstat\fR displays a one-line summary of the virtual memory
31 30 activity since the system was booted.
32 31 .sp
33 32 .LP
34 33 During execution of the kernel status command, the \fBstate\fR of the system
35 34 can change. If relevant, a state change message is included in the \fBvmstat\fR
36 35 output, in one of the following forms:
37 36 .sp
38 37 .in +2
39 38 .nf
40 39 <<device added: sd0>>
41 40 <<device removed: sd0>>
|
↓ open down ↓ |
15 lines elided |
↑ open up ↑ |
42 41 <<processors added: 1, 3>>
43 42 <<processors removed: 1, 3>>
44 43 .fi
45 44 .in -2
46 45 .sp
47 46
48 47 .sp
49 48 .LP
50 49 See \fI\fR for device naming conventions for disks.
51 50 .SH OPTIONS
52 -.sp
53 51 .LP
54 52 The following options are supported:
55 53 .sp
56 54 .ne 2
57 55 .na
58 -\fB\fB-c\fR\fR
59 -.ad
60 -.RS 13n
61 -Report cache flushing statistics. This option is obsolete, and no longer
62 -meaningful. This option might be removed in a future version of Solaris.
63 -.RE
64 -
65 -.sp
66 -.ne 2
67 -.na
68 56 \fB\fB-i\fR\fR
69 57 .ad
70 58 .RS 13n
71 59 Report the number of interrupts per device. \fIcount\fR and \fIinterval\fR does
72 60 not apply to the \fB-i\fR option.
73 61 .RE
74 62
75 63 .sp
76 64 .ne 2
77 65 .na
78 66 \fB\fB-p\fR\fR
79 67 .ad
80 68 .RS 13n
81 69 Report paging activity in details. This option will display the following,
82 70 respectively:
83 71 .sp
84 72 .ne 2
85 73 .na
86 74 \fBepi\fR
87 75 .ad
88 76 .RS 7n
89 77 Executable page-ins.
90 78 .RE
91 79
92 80 .sp
93 81 .ne 2
94 82 .na
95 83 \fBepo\fR
96 84 .ad
97 85 .RS 7n
98 86 Executable page-outs.
99 87 .RE
100 88
101 89 .sp
102 90 .ne 2
103 91 .na
104 92 \fBepf\fR
105 93 .ad
106 94 .RS 7n
107 95 Executable page-frees.
108 96 .RE
109 97
110 98 .sp
111 99 .ne 2
112 100 .na
113 101 \fBapi\fR
114 102 .ad
115 103 .RS 7n
116 104 Anonymous page-ins.
117 105 .RE
118 106
119 107 .sp
120 108 .ne 2
121 109 .na
122 110 \fBapo\fR
123 111 .ad
124 112 .RS 7n
125 113 Anonymous page-outs.
126 114 .RE
127 115
128 116 .sp
129 117 .ne 2
130 118 .na
131 119 \fBapf\fR
132 120 .ad
133 121 .RS 7n
134 122 Anonymous page-frees.
135 123 .RE
136 124
137 125 .sp
138 126 .ne 2
139 127 .na
140 128 \fBfpi\fR
141 129 .ad
142 130 .RS 7n
143 131 File system page-ins.
144 132 .RE
145 133
146 134 .sp
147 135 .ne 2
148 136 .na
149 137 \fBfpo\fR
150 138 .ad
151 139 .RS 7n
152 140 File system page-outs.
153 141 .RE
154 142
155 143 .sp
156 144 .ne 2
157 145 .na
158 146 \fBfpf\fR
159 147 .ad
160 148 .RS 7n
161 149 File system page-frees.
162 150 .RE
163 151
164 152 When executed in a \fBzone\fR and if the pools facility is active, all of the
165 153 above only report actitivity on the processors in the processor set of the
166 154 \fBzone\fR's pool.
167 155 .RE
168 156
169 157 .sp
170 158 .ne 2
171 159 .na
172 160 \fB\fB-q\fR\fR
173 161 .ad
174 162 .RS 13n
175 163 Suppress messages related to state changes.
176 164 .RE
177 165
178 166 .sp
179 167 .ne 2
180 168 .na
181 169 \fB\fB-s\fR\fR
182 170 .ad
183 171 .RS 13n
184 172 Display the total number of various system events since boot. \fIcount\fR and
185 173 \fIinterval\fR does not apply to the \fB-s\fR option.
186 174 .RE
187 175
188 176 .sp
189 177 .ne 2
190 178 .na
191 179 \fB\fB-S\fR\fR
192 180 .ad
193 181 .RS 13n
194 182 Report on swapping rather than paging activity. This option will change two
195 183 fields in \fBvmstat\fR's ``paging'' display: rather than the ``re'' and ``mf''
196 184 fields, \fBvmstat\fR will report ``si'' (swap-ins) and ``so'' (swap-outs).
197 185 .RE
198 186
199 187 .sp
200 188 .ne 2
|
↓ open down ↓ |
123 lines elided |
↑ open up ↑ |
201 189 .na
202 190 \fB\fB-T\fR \fBu\fR | \fBd\fR\fR
203 191 .ad
204 192 .RS 13n
205 193 Specify \fBu\fR for a printed representation of the internal representation of
206 194 time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See
207 195 \fBdate\fR(1).
208 196 .RE
209 197
210 198 .SH OPERANDS
211 -.sp
212 199 .LP
213 200 The following operands are supported:
214 201 .sp
215 202 .ne 2
216 203 .na
217 204 \fB\fIcount\fR\fR
218 205 .ad
219 206 .RS 12n
220 207 Specifies the number of times that the statistics are repeated. \fIcount\fR
221 208 does not apply to the \fB-i\fR and \fB-s\fR options.
222 209 .RE
223 210
224 211 .sp
225 212 .ne 2
226 213 .na
227 214 \fB\fIdisks\fR\fR
228 215 .ad
229 216 .RS 12n
230 217 Specifies which disks are to be given priority in the output (only four disks
231 218 fit on a line). Common disk names are \fBid\fR, \fBsd\fR, \fBxd\fR, or
232 219 \fBxy,\fR followed by a number (for example, \fBsd2\fR, \fBxd0\fR, and so
233 220 forth).
234 221 .RE
235 222
236 223 .sp
237 224 .ne 2
238 225 .na
239 226 \fB\fIinterval\fR\fR
240 227 .ad
241 228 .RS 12n
242 229 Specifies the last number of seconds over which \fBvmstat\fR summarizes
243 230 activity. This number of seconds repeats forever. \fIinterval\fR does not apply
244 231 to the \fB-i\fR and \fB-s\fR options.
245 232 .RE
246 233
247 234 .SH EXAMPLES
248 235 .LP
249 236 \fBExample 1 \fRUsing \fBvmstat\fR
250 237 .sp
251 238 .LP
252 239 The following command displays a summary of what the system is doing every five
253 240 seconds.
254 241
255 242 .sp
256 243 .in +2
257 244 .nf
258 245 example% \fBvmstat 5\fR
259 246
260 247
261 248 kthr memory page disk faults cpu
262 249 r b w swap free re mf pi p fr de sr s0 s1 s2 s3 in sy cs us sy id
263 250 0 0 0 11456 4120 1 41 19 1 3 0 2 0 4 0 0 48 112 130 4 14 82
264 251 0 0 1 10132 4280 0 4 44 0 0 0 0 0 23 0 0 211 230 144 3 35 62
265 252 0 0 1 10132 4616 0 0 20 0 0 0 0 0 19 0 0 150 172 146 3 33 64
266 253 0 0 1 10132 5292 0 0 9 0 0 0 0 0 21 0 0 165 105 130 1 21 78
267 254 1 1 1 10132 5496 0 0 5 0 0 0 0 0 23 0 0 183 92 134 1 20 79
268 255 1 0 1 10132 5564 0 0 25 0 0 0 0 0 18 0 0 131 231 116 4 34 62
269 256 1 0 1 10124 5412 0 0 37 0 0 0 0 0 22 0 0 166 179 118 1 33 67
270 257 1 0 1 10124 5236 0 0 24 0 0 0 0 0 14 0 0 109 243 113 4 56 39
271 258 ^C
272 259
273 260 example%
274 261 .fi
275 262 .in -2
276 263 .sp
277 264
278 265 .sp
279 266 .LP
280 267 The fields of \fBvmstat\fR's display are
281 268
282 269 .sp
283 270 .ne 2
284 271 .na
285 272 \fB\fBkthr\fR\fR
286 273 .ad
287 274 .RS 10n
288 275 Report the number of kernel threads in each of the three following states:
289 276 .sp
290 277 .ne 2
291 278 .na
292 279 \fB\fBr\fR\fR
293 280 .ad
294 281 .RS 5n
295 282 the number of kernel threads in run queue
296 283 .RE
297 284
298 285 .sp
299 286 .ne 2
300 287 .na
301 288 \fB\fBb\fR\fR
302 289 .ad
303 290 .RS 5n
304 291 the number of blocked kernel threads that are waiting for resources \fBI/O,\fR
305 292 paging, and so forth
306 293 .RE
307 294
308 295 .sp
309 296 .ne 2
310 297 .na
311 298 \fB\fBw\fR\fR
312 299 .ad
313 300 .RS 5n
314 301 the number of swapped out lightweight processes (LWPs) that are waiting for
315 302 processing resources to finish.
316 303 .RE
317 304
318 305 .RE
319 306
320 307 .sp
321 308 .ne 2
322 309 .na
323 310 \fB\fBmemory\fR\fR
324 311 .ad
325 312 .RS 10n
326 313 Report on usage of virtual and real memory.
327 314 .sp
328 315 .ne 2
329 316 .na
330 317 \fB\fBswap\fR\fR
331 318 .ad
332 319 .RS 8n
333 320 available swap space (Kbytes)
334 321 .RE
335 322
336 323 .sp
337 324 .ne 2
338 325 .na
339 326 \fB\fBfree\fR\fR
340 327 .ad
341 328 .RS 8n
342 329 size of the free list (Kbytes)
343 330 .RE
344 331
345 332 .RE
346 333
347 334 .sp
348 335 .ne 2
349 336 .na
350 337 \fB\fBpage\fR\fR
351 338 .ad
352 339 .RS 10n
353 340 Report information about page faults and paging activity. The information on
354 341 each of the following activities is given in units per second.
355 342 .sp
356 343 .ne 2
357 344 .na
358 345 \fB\fBre\fR\fR
359 346 .ad
360 347 .RS 6n
361 348 page reclaims \(em but see the \fB-S\fR option for how this field is modified.
362 349 .RE
363 350
364 351 .sp
365 352 .ne 2
366 353 .na
367 354 \fB\fBmf\fR\fR
368 355 .ad
369 356 .RS 6n
370 357 minor faults \(em but see the \fB-S\fR option for how this field is modified.
371 358 .RE
372 359
373 360 .sp
374 361 .ne 2
375 362 .na
376 363 \fB\fBpi\fR\fR
377 364 .ad
378 365 .RS 6n
379 366 kilobytes paged in
380 367 .RE
381 368
382 369 .sp
383 370 .ne 2
384 371 .na
385 372 \fB\fBpo\fR\fR
386 373 .ad
387 374 .RS 6n
388 375 kilobytes paged out
389 376 .RE
390 377
391 378 .sp
392 379 .ne 2
393 380 .na
394 381 \fB\fBfr\fR\fR
395 382 .ad
396 383 .RS 6n
397 384 kilobytes freed
398 385 .RE
399 386
400 387 .sp
401 388 .ne 2
402 389 .na
403 390 \fB\fBde\fR\fR
404 391 .ad
405 392 .RS 6n
406 393 anticipated short-term memory shortfall (Kbytes)
407 394 .RE
408 395
409 396 .sp
410 397 .ne 2
411 398 .na
412 399 \fB\fBsr\fR\fR
413 400 .ad
414 401 .RS 6n
415 402 pages scanned by clock algorithm
416 403 .RE
417 404
418 405 When executed in a \fBzone\fR and if the pools facility is active, all of the
419 406 above (except for "de") only report activity on the processors in the processor
420 407 set of the \fBzone\fR's pool.
421 408 .RE
422 409
423 410 .sp
424 411 .ne 2
425 412 .na
426 413 \fB\fBdisk\fR\fR
427 414 .ad
428 415 .RS 10n
429 416 Report the number of disk operations per second. There are slots for up to four
430 417 disks, labeled with a single letter and number. The letter indicates the type
431 418 of disk (s = \fBSCSI\fR, i = \fBIPI\fR, and so forth); the number is the
432 419 logical unit number.
433 420 .RE
434 421
435 422 .sp
436 423 .ne 2
437 424 .na
438 425 \fB\fBfaults\fR\fR
439 426 .ad
440 427 .RS 10n
441 428 Report the trap/interrupt rates (per second).
442 429 .sp
443 430 .ne 2
444 431 .na
445 432 \fB\fBin\fR\fR
446 433 .ad
447 434 .RS 6n
448 435 interrupts
449 436 .RE
450 437
451 438 .sp
452 439 .ne 2
453 440 .na
454 441 \fB\fBsy\fR\fR
455 442 .ad
456 443 .RS 6n
457 444 system calls
458 445 .RE
459 446
460 447 .sp
461 448 .ne 2
462 449 .na
463 450 \fB\fBcs\fR\fR
464 451 .ad
465 452 .RS 6n
466 453 \fBCPU\fR context switches
467 454 .RE
468 455
469 456 When executed in a \fBzone\fR and if the pools facility is active, all of the
470 457 above only report actitivity on the processors in the processor set of the
471 458 \fBzone\fR's pool.
472 459 .RE
473 460
474 461 .sp
475 462 .ne 2
476 463 .na
477 464 \fB\fBcpu\fR\fR
478 465 .ad
479 466 .RS 10n
480 467 Give a breakdown of percentage usage of \fBCPU\fR time. On \fBMP\fR systems,
481 468 this is an average across all processors.
482 469 .sp
483 470 .ne 2
484 471 .na
485 472 \fB\fBus\fR\fR
486 473 .ad
487 474 .RS 6n
488 475 user time
489 476 .RE
490 477
491 478 .sp
492 479 .ne 2
493 480 .na
494 481 \fB\fBsy\fR\fR
495 482 .ad
496 483 .RS 6n
497 484 system time
498 485 .RE
499 486
500 487 .sp
501 488 .ne 2
502 489 .na
503 490 \fB\fBid\fR\fR
504 491 .ad
|
↓ open down ↓ |
283 lines elided |
↑ open up ↑ |
505 492 .RS 6n
506 493 idle time
507 494 .RE
508 495
509 496 When executed in a \fBzone\fR and if the pools facility is active, all of the
510 497 above only report actitivity on the processors in the processor set of the
511 498 \fBzone\fR's pool.
512 499 .RE
513 500
514 501 .SH ATTRIBUTES
515 -.sp
516 502 .LP
517 503 See \fBattributes\fR(5) for descriptions of the following attributes:
518 504 .sp
519 505
520 506 .sp
521 507 .TS
522 508 box;
523 509 c | c
524 510 l | l .
525 511 ATTRIBUTE TYPE ATTRIBUTE VALUE
526 512 _
527 513 Interface Stability See below.
528 514 .TE
529 515
530 516 .sp
531 517 .LP
532 518 Invocation is evolving. Human readable output is unstable.
533 519 .SH SEE ALSO
534 -.sp
535 520 .LP
536 521 \fBdate\fR(1), \fBsar\fR(1), \fBiostat\fR(1M), \fBmpstat\fR(1M), \fBsar\fR(1M),
537 522 \fBtime\fR(2), \fBattributes\fR(5)
538 523 .SH NOTES
539 -.sp
540 524 .LP
541 525 The sum of CPU utilization might vary slightly from 100 because of rounding
542 526 errors in the production of a percentage figure.
543 527 .sp
544 -.LP
545 -The \fB-c\fR option (Report cache flushing statistics) is not supported in this
546 -release.
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX