~ubuntu-branches/ubuntu/hoary/sysstat/hoary

« back to all changes in this revision

Viewing changes to man/mpstat.1

  • Committer: Bazaar Package Importer
  • Author(s): Robert Luberda
  • Date: 2004-06-15 18:47:50 UTC
  • Revision ID: james.westby@ubuntu.com-20040615184750-y9zskvg3k6tf9j15
Tags: upstream-5.0.5
ImportĀ upstreamĀ versionĀ 5.0.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH MPSTAT 1 "FEBRUARY 2004" Linux "Linux User's Manual" -*- nroff -*-
 
2
.SH NAME
 
3
mpstat \- Report processors related statistics.
 
4
.SH SYNOPSIS
 
5
.B mpstat [ -P {
 
6
.I cpu
 
7
.B | ALL } ] [ -V ] [
 
8
.I interval
 
9
.B [
 
10
.I count
 
11
.B ] ]
 
12
.SH DESCRIPTION
 
13
The
 
14
.B mpstat
 
15
command writes to standard output activities for each available processor,
 
16
processor 0 being the first one.
 
17
Global average activities among all processors are also reported.
 
18
The
 
19
.B mpstat
 
20
command can be used both on SMP and UP machines, but in the latter, only global
 
21
average activities will be printed.
 
22
 
 
23
The
 
24
.I interval
 
25
parameter specifies the amount of time in seconds between each report.
 
26
A value of 0 indicates that processors statistics are to be reported
 
27
for the time since system startup (boot).
 
28
The
 
29
.I count
 
30
parameter can be specified in conjunction with the
 
31
.I interval
 
32
parameter if this one is not set to zero. The value of
 
33
.I count
 
34
determines the number of reports generated at
 
35
.I interval
 
36
seconds apart. If the
 
37
.I interval
 
38
parameter is specified without the
 
39
.I count
 
40
parameter, the
 
41
.B mpstat
 
42
command generates reports continuously.
 
43
 
 
44
.SH REPORTS
 
45
The report generated by the
 
46
.B mpstat
 
47
command has the following format:
 
48
 
 
49
.B CPU
 
50
.RS
 
51
Processor number. The keyword
 
52
.I all
 
53
indicates that statistics are calculated as averages among all
 
54
processors.
 
55
.RE
 
56
.B %user
 
57
.RS
 
58
Show the percentage of CPU utilization that occurred while
 
59
executing at the user level (application).
 
60
.RE
 
61
.B %nice
 
62
.RS
 
63
Show the percentage of CPU utilization that occurred while
 
64
executing at the user level with nice priority.
 
65
.RE
 
66
.B %system
 
67
.RS
 
68
Show the percentage of CPU utilization that occurred while
 
69
executing at the system level (kernel). Note that this does not
 
70
include the time spent servicing interrupts or softirqs.
 
71
.RE
 
72
.B %iowait
 
73
.RS
 
74
Show the percentage of time that the CPU or CPUs were idle during which
 
75
the system had an outstanding disk I/O request.
 
76
.RE
 
77
.B %irq
 
78
.RS
 
79
Show the percentage of time spent by the CPU or CPUs to service interrupts.
 
80
.RE
 
81
.B %soft
 
82
.RS
 
83
Show the percentage of time spent by the CPU or CPUs to service softirqs.
 
84
A softirq (software interrupt) is one of up to 32 enumerated software
 
85
interrupts which can run on multiple CPUs at once.
 
86
.RE
 
87
.B %idle
 
88
.RS
 
89
Show the percentage of time that the CPU or CPUs were idle and the system
 
90
did not have an outstanding disk I/O request.
 
91
.RE
 
92
.B intr/s
 
93
.RS
 
94
Show the total number of interrupts received per second by
 
95
the CPU or CPUs.
 
96
.RE
 
97
.RE
 
98
 
 
99
.SH OPTIONS
 
100
.IP "-P cpu | ALL"
 
101
Indicate the processor number for which statistics are to be reported.
 
102
.I cpu
 
103
is the processor number. Note that processor 0 is the first processor.
 
104
The
 
105
.I ALL
 
106
keyword indicates that statistics are to be reported for all processors.
 
107
.IP -V
 
108
Print version number and usage then exit.
 
109
 
 
110
.SH ENVIRONMENT
 
111
The
 
112
.B mpstat
 
113
command takes into account the following environment variable:
 
114
 
 
115
.IP S_TIME_FORMAT
 
116
If this variable exists and its value is
 
117
.BR ISO
 
118
then the current locale will be ignored when printing the date in the report header.
 
119
The
 
120
.B mpstat
 
121
command will use the ISO 8601 format (YYYY-MM-DD) instead.
 
122
 
 
123
.SH EXAMPLES
 
124
.B mpstat 2 5
 
125
.RS
 
126
Display five reports of global statistics among all processors at two second intervals.
 
127
.RE
 
128
 
 
129
.B mpstat -P ALL 2 5
 
130
.RS
 
131
Display five reports of statistics for all processors at two second intervals.
 
132
 
 
133
.SH BUGS
 
134
.I /proc
 
135
filesystem must be mounted for the
 
136
.B mpstat
 
137
command to work.
 
138
 
 
139
Only a few activities are supplied by the Linux kernel for each processor.
 
140
 
 
141
.SH FILES
 
142
.IR /proc
 
143
contains various files with system statistics.
 
144
 
 
145
.SH AUTHOR
 
146
Sebastien Godard (sysstat <at> wanadoo.fr)
 
147
.SH SEE ALSO
 
148
.BR sar (1),
 
149
.BR sadc (8),
 
150
.BR sa1 (8),
 
151
.BR sa2 (8),
 
152
.BR iostat (1),
 
153
.BR vmstat (8)
 
154
 
 
155
.I http://perso.wanadoo.fr/sebastien.godard/