Diffs of the man page of vmstat(1M): ==================================== --- vmstat.1m.old Sun May 4 22:48:58 2008 +++ vmstat.1m.new Mon May 5 22:29:48 2008 @@ -1,390 +1,429 @@ System Administration Commands vmstat(1M) NAME vmstat - report virtual memory statistics SYNOPSIS - vmstat [-cipqsS] [disks] [interval [count]] + vmstat [-chipqsS] [disks] [-o format] [interval [count]] DESCRIPTION vmstat reports virtual memory statistics regarding kernel thread, virtual memory, disk, trap, and CPU activity. On MP (multi-processor) systems, vmstat averages the number of CPUs into the output. For per-processor statistics, see mpstat(1M). vmstat only supports statistics for certain devices. For more general system statistics, use sar(1), iostat(1M), or sar(1M). Without options, vmstat displays a one-line summary of the virtual memory activity since the system was booted. During execution of the kernel status command, the state of the system can change. If relevant, a state change message is included in the vmstat output, in one of the following forms: <> <> <> <> See for device naming conventions for disks. OPTIONS The following options are supported: -c Report cache flushing statistics. This option is obsolete, and no longer meaningful. This option might be removed in a future version of Solaris. -i Report the number of interrupts per device. count and interval does not apply to the -i option. SunOS 5.11 Last change: 20 Dec 2004 1 System Administration Commands vmstat(1M) + -h The output is in human readable format. + The sizes are scaled to a human readable format, + for example, 14.5G, 118K, 543.0M. + Scaling is done by repetitively dividing by 1024 to + report in bytes and divided by 1000 to report non byte + information. + + + + -o format Prints information of the fields specified in the format. + The following fields can be specified in the format: + kthr memory page faults cpu + For -po option the following fields are allowed: + memory page executable anonymous filesystem + The fields are seperated by comma. + [interval] and [count] can be mentioned in the end seperated + by space. + The information of selected fields can be obtained by omitting + fields in right to left order.For random omission, the alignment + of header is not guaranteed. + + -p Report paging activity in details. This option will display the following, respectively: epi Executable page-ins. epo Executable page-outs. epf Executable page-frees. api Anonymous page-ins. apo Anonymous page-outs. apf Anonymous page-frees. fpi File system page-ins. fpo File system page-outs. fpf File system page-frees. When executed in a zone and if the pools facility is active, all of the above only report actitivity on the processors in the processor set of the zone's pool. -q Suppress messages related to state changes. -s Display the total number of various system events since boot. count and interval does not apply to the -s option. -S Report on swapping rather than paging activity. This option will change two fields in vmstat's ``paging'' display: rather than the ``re'' and ``mf'' fields, vmstat will report ``si'' (swap-ins) and ``so'' (swap-outs). OPERANDS The following operands are supported: SunOS 5.11 Last change: 20 Dec 2004 2 System Administration Commands vmstat(1M) count Specifies the number of times that the statis- tics are repeated. count does not apply to the -i and -s options. disks Specifies which disks are to be given priority in the output (only four disks fit on a line). Common disk names are id, sd, xd, or xy, fol- lowed by a number (for example, sd2, xd0, and so forth). interval Specifies the last number of seconds over which vmstat summarizes activity. This number of seconds repeats forever. interval does not apply to the -i and -s options. EXAMPLES Example 1 Using vmstat The following command displays a summary of what the system is doing every five seconds. example% vmstat 5 kthr memory page disk faults cpu r b w swap free re mf pi p fr de sr s0 s1 s2 s3 in sy cs us sy id 0 0 0 11456 4120 1 41 19 1 3 0 2 0 4 0 0 48 112 130 4 14 82 0 0 1 10132 4280 0 4 44 0 0 0 0 0 23 0 0 211 230 144 3 35 62 0 0 1 10132 4616 0 0 20 0 0 0 0 0 19 0 0 150 172 146 3 33 64 0 0 1 10132 5292 0 0 9 0 0 0 0 0 21 0 0 165 105 130 1 21 78 1 1 1 10132 5496 0 0 5 0 0 0 0 0 23 0 0 183 92 134 1 20 79 1 0 1 10132 5564 0 0 25 0 0 0 0 0 18 0 0 131 231 116 4 34 62 1 0 1 10124 5412 0 0 37 0 0 0 0 0 22 0 0 166 179 118 1 33 67 1 0 1 10124 5236 0 0 24 0 0 0 0 0 14 0 0 109 243 113 4 56 39 ^C - example% + example% vmstat -pho memory,page,executable 1 + memory page executable + swap free re mf fr de sr epi epo epf + 4.3G 544.6M 270 4K 21K 0 11 3K 0 77 + 4.4G 614.9M 65 87 0 0 0 0 0 0 + 4.4G 614.9M 5 6 0 0 0 0 0 0 + ^C + example% vmstat -o kthr,memory,page,faults,cpu -h 1 2 + + + kthr memory page faults cpu + r b w swap free re mf pi po fr de sr in sy cs us sy id + 10 0 0 47.4G 13.4G 2K 17K 66K 964 607 0 0 4270 30107 4630 17 8 75 + 0 0 0 43.5G 9.4G 30 49 0 0 0 0 0 8252 9260 5196 0 2 98 + + example% + + The fields of vmstat's display are kthr Report the number of kernel threads in each of the three following states: SunOS 5.11 Last change: 20 Dec 2004 3 System Administration Commands vmstat(1M) r the number of kernel threads in run queue b the number of blocked kernel threads that are waiting for resources I/O, paging, and so forth w the number of swapped out lightweight processes (LWPs) that are waiting for pro- cessing resources to finish. memory Report on usage of virtual and real memory. swap available swap space (Kbytes) free size of the free list (Kbytes) page Report information about page faults and paging activity. The information on each of the following activities is given in units per second. re page reclaims - but see the -S option for how this field is modified. mf minor faults - but see the -S option for how this field is modified. pi kilobytes paged in po kilobytes paged out fr kilobytes freed de anticipated short-term memory shortfall (Kbytes) sr pages scanned by clock algorithm When executed in a zone and if the pools facility is active, all of the above (except for "de") only SunOS 5.11 Last change: 20 Dec 2004 4 System Administration Commands vmstat(1M) report activity on the processors in the processor set of the zone's pool. disk Report the number of disk operations per second. There are slots for up to four disks, labeled with a single letter and number. The letter indicates the type of disk (s = SCSI, i = IPI, and so forth); the number is the logical unit number. faults Report the trap/interrupt rates (per second). in interrupts sy system calls cs CPU context switches When executed in a zone and if the pools facility is active, all of the above only report actitivity on the processors in the processor set of the zone's pool. cpu Give a breakdown of percentage usage of CPU time. On MP systems, this is an average across all pro- cessors. us user time sy system time id idle time When executed in a zone and if the pools facility is active, all of the above only report actitivity on the processors in the processor set of the zone's pool. ATTRIBUTES See attributes(5) for descriptions of the following attri- butes: SunOS 5.11 Last change: 20 Dec 2004 5 System Administration Commands vmstat(1M) ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWcsu | |_____________________________|_____________________________| | Interface Stability | See below. | |_____________________________|_____________________________| Invocation is evolving. Human readable output is unstable. SEE ALSO sar(1), iostat(1M), mpstat(1M), sar(1M), attributes(5) NOTES The sum of CPU utilization might vary slightly from 100 because of rounding errors in the production of a percentage figure. The -c option (Report cache flushing statistics) is not sup- ported in this release. SunOS 5.11 Last change: 20 Dec 2004 6