1 '\" te
2 .\" Copyright (c) 2001 Sun Microsystems, Inc. All Rights Reserved.
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 .\" 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 .\" 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"
7 .SH NAME
8 vmstat \- report virtual memory statistics
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBvmstat\fR [\fB-cipqsS\fR] [\fB-T\fR u | d] [\fIdisks\fR] [\fIinterval\fR [\fIcount\fR]]
13 .fi
14
15 .SH DESCRIPTION
16 .sp
17 .LP
18 \fBvmstat\fR reports virtual memory statistics regarding kernel thread, virtual
19 memory, disk, trap, and \fBCPU\fR activity.
20 .sp
21 .LP
22 On \fBMP\fR (multi-processor) systems, \fBvmstat\fR averages the number of
23 \fBCPUs\fR into the output. For per-processor statistics, see \fBmpstat\fR(1M).
24 .sp
25 .LP
26 \fBvmstat\fR only supports statistics for certain devices. For more general
27 system statistics, use \fBsar\fR(1), \fBiostat\fR(1M), or \fBsar\fR(1M).
28 .sp
29 .LP
30 Without options, \fBvmstat\fR displays a one-line summary of the virtual memory
31 activity since the system was booted.
32 .sp
33 .LP
34 During execution of the kernel status command, the \fBstate\fR of the system
35 can change. If relevant, a state change message is included in the \fBvmstat\fR
36 output, in one of the following forms:
37 .sp
38 .in +2
39 .nf
40 <<device added: sd0>>
41 <<device removed: sd0>>
42 <<processors added: 1, 3>>
43 <<processors removed: 1, 3>>
44 .fi
45 .in -2
46 .sp
47
48 .sp
49 .LP
50 See \fI\fR for device naming conventions for disks.
51 .SH OPTIONS
52 .sp
53 .LP
54 The following options are supported:
55 .sp
56 .ne 2
57 .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 \fB\fB-i\fR\fR
69 .ad
70 .RS 13n
71 Report the number of interrupts per device. \fIcount\fR and \fIinterval\fR does
72 not apply to the \fB-i\fR option.
73 .RE
74
75 .sp
76 .ne 2
77 .na
78 \fB\fB-p\fR\fR
79 .ad
80 .RS 13n
81 Report paging activity in details. This option will display the following,
82 respectively:
83 .sp
84 .ne 2
85 .na
86 \fBepi\fR
87 .ad
191 \fB\fB-S\fR\fR
192 .ad
193 .RS 13n
194 Report on swapping rather than paging activity. This option will change two
195 fields in \fBvmstat\fR's ``paging'' display: rather than the ``re'' and ``mf''
196 fields, \fBvmstat\fR will report ``si'' (swap-ins) and ``so'' (swap-outs).
197 .RE
198
199 .sp
200 .ne 2
201 .na
202 \fB\fB-T\fR \fBu\fR | \fBd\fR\fR
203 .ad
204 .RS 13n
205 Specify \fBu\fR for a printed representation of the internal representation of
206 time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See
207 \fBdate\fR(1).
208 .RE
209
210 .SH OPERANDS
211 .sp
212 .LP
213 The following operands are supported:
214 .sp
215 .ne 2
216 .na
217 \fB\fIcount\fR\fR
218 .ad
219 .RS 12n
220 Specifies the number of times that the statistics are repeated. \fIcount\fR
221 does not apply to the \fB-i\fR and \fB-s\fR options.
222 .RE
223
224 .sp
225 .ne 2
226 .na
227 \fB\fIdisks\fR\fR
228 .ad
229 .RS 12n
230 Specifies which disks are to be given priority in the output (only four disks
231 fit on a line). Common disk names are \fBid\fR, \fBsd\fR, \fBxd\fR, or
495 .ad
496 .RS 6n
497 system time
498 .RE
499
500 .sp
501 .ne 2
502 .na
503 \fB\fBid\fR\fR
504 .ad
505 .RS 6n
506 idle time
507 .RE
508
509 When executed in a \fBzone\fR and if the pools facility is active, all of the
510 above only report actitivity on the processors in the processor set of the
511 \fBzone\fR's pool.
512 .RE
513
514 .SH ATTRIBUTES
515 .sp
516 .LP
517 See \fBattributes\fR(5) for descriptions of the following attributes:
518 .sp
519
520 .sp
521 .TS
522 box;
523 c | c
524 l | l .
525 ATTRIBUTE TYPE ATTRIBUTE VALUE
526 _
527 Interface Stability See below.
528 .TE
529
530 .sp
531 .LP
532 Invocation is evolving. Human readable output is unstable.
533 .SH SEE ALSO
534 .sp
535 .LP
536 \fBdate\fR(1), \fBsar\fR(1), \fBiostat\fR(1M), \fBmpstat\fR(1M), \fBsar\fR(1M),
537 \fBtime\fR(2), \fBattributes\fR(5)
538 .SH NOTES
539 .sp
540 .LP
541 The sum of CPU utilization might vary slightly from 100 because of rounding
542 errors in the production of a percentage figure.
543 .sp
544 .LP
545 The \fB-c\fR option (Report cache flushing statistics) is not supported in this
546 release.
|
1 '\" te
2 .\" Copyright (c) 2001 Sun Microsystems, Inc. All Rights Reserved.
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 .\" 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 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH VMSTAT 1M "April 14, 2015"
7 .SH NAME
8 vmstat \- report virtual memory statistics
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBvmstat\fR [\fB-ipqsS\fR] [\fB-T\fR u | d] [\fIdisks\fR] [\fIinterval\fR [\fIcount\fR]]
13 .fi
14
15 .SH DESCRIPTION
16 .LP
17 \fBvmstat\fR reports virtual memory statistics regarding kernel thread, virtual
18 memory, disk, trap, and \fBCPU\fR activity.
19 .sp
20 .LP
21 On \fBMP\fR (multi-processor) systems, \fBvmstat\fR averages the number of
22 \fBCPUs\fR into the output. For per-processor statistics, see \fBmpstat\fR(1M).
23 .sp
24 .LP
25 \fBvmstat\fR only supports statistics for certain devices. For more general
26 system statistics, use \fBsar\fR(1), \fBiostat\fR(1M), or \fBsar\fR(1M).
27 .sp
28 .LP
29 Without options, \fBvmstat\fR displays a one-line summary of the virtual memory
30 activity since the system was booted.
31 .sp
32 .LP
33 During execution of the kernel status command, the \fBstate\fR of the system
34 can change. If relevant, a state change message is included in the \fBvmstat\fR
35 output, in one of the following forms:
36 .sp
37 .in +2
38 .nf
39 <<device added: sd0>>
40 <<device removed: sd0>>
41 <<processors added: 1, 3>>
42 <<processors removed: 1, 3>>
43 .fi
44 .in -2
45 .sp
46
47 .sp
48 .LP
49 See \fI\fR for device naming conventions for disks.
50 .SH OPTIONS
51 .LP
52 The following options are supported:
53 .sp
54 .ne 2
55 .na
56 \fB\fB-i\fR\fR
57 .ad
58 .RS 13n
59 Report the number of interrupts per device. \fIcount\fR and \fIinterval\fR does
60 not apply to the \fB-i\fR option.
61 .RE
62
63 .sp
64 .ne 2
65 .na
66 \fB\fB-p\fR\fR
67 .ad
68 .RS 13n
69 Report paging activity in details. This option will display the following,
70 respectively:
71 .sp
72 .ne 2
73 .na
74 \fBepi\fR
75 .ad
179 \fB\fB-S\fR\fR
180 .ad
181 .RS 13n
182 Report on swapping rather than paging activity. This option will change two
183 fields in \fBvmstat\fR's ``paging'' display: rather than the ``re'' and ``mf''
184 fields, \fBvmstat\fR will report ``si'' (swap-ins) and ``so'' (swap-outs).
185 .RE
186
187 .sp
188 .ne 2
189 .na
190 \fB\fB-T\fR \fBu\fR | \fBd\fR\fR
191 .ad
192 .RS 13n
193 Specify \fBu\fR for a printed representation of the internal representation of
194 time. See \fBtime\fR(2). Specify \fBd\fR for standard date format. See
195 \fBdate\fR(1).
196 .RE
197
198 .SH OPERANDS
199 .LP
200 The following operands are supported:
201 .sp
202 .ne 2
203 .na
204 \fB\fIcount\fR\fR
205 .ad
206 .RS 12n
207 Specifies the number of times that the statistics are repeated. \fIcount\fR
208 does not apply to the \fB-i\fR and \fB-s\fR options.
209 .RE
210
211 .sp
212 .ne 2
213 .na
214 \fB\fIdisks\fR\fR
215 .ad
216 .RS 12n
217 Specifies which disks are to be given priority in the output (only four disks
218 fit on a line). Common disk names are \fBid\fR, \fBsd\fR, \fBxd\fR, or
482 .ad
483 .RS 6n
484 system time
485 .RE
486
487 .sp
488 .ne 2
489 .na
490 \fB\fBid\fR\fR
491 .ad
492 .RS 6n
493 idle time
494 .RE
495
496 When executed in a \fBzone\fR and if the pools facility is active, all of the
497 above only report actitivity on the processors in the processor set of the
498 \fBzone\fR's pool.
499 .RE
500
501 .SH ATTRIBUTES
502 .LP
503 See \fBattributes\fR(5) for descriptions of the following attributes:
504 .sp
505
506 .sp
507 .TS
508 box;
509 c | c
510 l | l .
511 ATTRIBUTE TYPE ATTRIBUTE VALUE
512 _
513 Interface Stability See below.
514 .TE
515
516 .sp
517 .LP
518 Invocation is evolving. Human readable output is unstable.
519 .SH SEE ALSO
520 .LP
521 \fBdate\fR(1), \fBsar\fR(1), \fBiostat\fR(1M), \fBmpstat\fR(1M), \fBsar\fR(1M),
522 \fBtime\fR(2), \fBattributes\fR(5)
523 .SH NOTES
524 .LP
525 The sum of CPU utilization might vary slightly from 100 because of rounding
526 errors in the production of a percentage figure.
527 .sp
|