Print this page
5839 vmstat(1M) should stop documenting -c
   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