MPSTAT(8) Maintenance Commands and Procedures MPSTAT(8)

NAME

mpstat - report per-processor or per-processor-set statistics

SYNOPSIS

/usr/bin/mpstat [-aq] [-p | -P set] [-T u | d] [interval [count]]

DESCRIPTION

The mpstat command reports processor statistics in tabular form. Each
row of the table represents the activity of one processor. The first
table summarizes all activity since boot. Each subsequent table
summarizes activity for the preceding interval. All values are rates
listed as events per second unless otherwise noted.


During execution of the kernel status command, the state of the
kernel can change. If relevant, a state change message is included in
the mpstat output, in one of the following forms:

<<processor 3 moved from pset: -1 to: 1>>
<<pset destroyed: 1>>
<<pset created: 1>>
<<processors added: 1, 3>>
<<processors removed: 1, 3>>


The mpstat command reports the following information:

CPU or SET
Without the -a option, mpstat reports CPU statistics
for a processor ID. With the -a option, mpstat reports
SET statistics for a processor set ID.


minf
minor faults


mjf
major faults


xcal
inter-processor cross-calls


intr
interrupts


ithr
interrupts as threads (not counting clock interrupt)


csw
context switches


icsw
involuntary context switches


migr
thread migrations (to another processor)


smtx
spins on mutexes (lock not acquired on first try)


srw
spins on readers/writer locks (lock not acquired on
first try)


syscl
system calls


usr
percent user time


sys
percent system time


wt
the I/O wait time is no longer calculated as a
percentage of CPU time, and this statistic will always
return zero.


idl
percent idle time


sze
number of processors in the requested processor set


set
processor set membership of each CPU

OPTIONS

The following options are supported:

-a
Aggregate output by processor set. Sort the output by
set. The default output is sorted by CPU number.


-p
Report processor set membership of each CPU. Sort the
output by set. The default output is sorted by CPU
number.


-P set
Display only those processors in the specified set.


-q
Suppress messages related to state changes.


-T u | d
Specify u for a printed representation of the internal
representation of time. See time(2). Specify d for
standard date format. See date(1).


interval
Report once each interval seconds.


count
Only print count reports.

EXAMPLES

Example 1: Using mpstat to Generate User and System Operation

Statistics


The following command generates processor statistics over a five-
second interval in two reports. The command shows the processor set
membership of each CPU. The default output is sorted by CPU number,
aggregated by processor set, for user (usr) and system (sys)
operations.


example% mpstat -ap 5 2


SET minf mjf xcal intr ithr csw icsw migr smtx srw syscl usr sys wt idl sze
0 6 0 355 291 190 22 0 0 0 0 43 0 2 0 43 1
1 24 17 534 207 200 70 1 0 2 0 600 4 1 0 84 2
2 19 7 353 325 318 44 0 0 5 0 345 1 1 0 94 3
3 36 2 149 237 236 14 0 0 4 0 97 0 0 0 98 2
SET minf mjf xcal intr ithr csw icsw migr smtx srw syscl usr sys wt idl sze
0 1 0 720 405 304 55 0 0 18 0 12 0 15 0 81 1
1 0 69 1955 230 200 313 33 4 41 9 7086 34 10 0 19 2
2 0 46 685 314 300 203 11 0 54 1 5287 36 6 0 28 3
3 0 0 14 386 384 0 0 0 0 0 0 0 0 0 100 2

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+


Invocation is evolving. Human readable output is unstable.

SEE ALSO

date(1), sar(1), time(2), attributes(7), iostat(8), sar(8), vmstat(8)

NOTES

The sum of CPU utilization might vary slightly from 100 due to
rounding errors in the production of a percentage figure.


The total time used for CPU processing is the sum of usr and sys
output values, reported for user and system operations. The idl value
reports the time that the CPU is idle for any reason other than
pending disk I/O operations.


Run the iostat command with the -x option to report I/O service times
in svc_t output. The iostat utility also reports the same wt, user
(us), and system (sy) statistics. See iostat(8) for more information.


When executing in a zone and if the pools facility is active,
mpstat(8) will only provide information for those processors which
are a member of the processor set of the pool to which the zone is
bound.

March 23, 2009 MPSTAT(8)