mpstat


SYNOPSIS
       mpstat  [  -A  ]  [  -I  { SUM | CPU | SCPU | ALL } ] [ -u ] [ -P { cpu
       [,...] | ON | ALL } ] [ -V ] [ interval [ count ] ]

DESCRIPTION
       The mpstat command writes to standard output activities for each avail-
       able processor, processor 0 being the first one.  Global average activ-
       ities among all processors are also reported.  The mpstat  command  can
       be  used  both  on  SMP and UP machines, but in the latter, only global
       average activities will be printed. If no activity has  been  selected,
       then the default report is the CPU utilization report.

       The  interval parameter specifies the amount of time in seconds between
       each report.  A value of 0 (or no parameters  at  all)  indicates  that
       processors  statistics  are  to  be  reported for the time since system
       startup (boot).  The count parameter can be  specified  in  conjunction
       with  the  interval parameter if this one is not set to zero. The value
       of count determines the number of reports generated at interval seconds
       apart. If the interval parameter is specified without the count parame-
       ter, the mpstat command generates reports continuously.


OPTIONS
       -A     This option is equivalent to specifying -I ALL -u -P ALL

       -I { SUM | CPU | SCPU | ALL }
              Report interrupts statistics.

              With the SUM keyword, the mpstat command reports the total  num-
              ber  of interrupts per processor.  The following values are dis-
              played:

              CPU
                     Processor number. The keyword all indicates that  statis-
                     tics are calculated as averages among all processors.

              intr/s
                     Show  the  total number of interrupts received per second
                     by the CPU or CPUs.

              With the CPU keyword, the number of  each  individual  interrupt
              received per second by the CPU or CPUs is displayed.

              With  the  SCPU  keyword, the number of each individual software
              interrupt received per second by the CPU or CPUs  is  displayed.
              This option works only with kernels 2.6.31 and later.

              The  ALL  keyword  is  equivalent to specifying all the keywords
              above and therefore all the interrupts statistics are displayed.

       -P { cpu [,...] | ON | ALL }
              Indicate the processor number for which  statistics  are  to  be
              reported.  cpu is the processor number. Note that processor 0 is
                     Show the percentage  of  CPU  utilization  that  occurred
                     while executing at the user level (application).

              %nice
                     Show  the  percentage  of  CPU  utilization that occurred
                     while executing at the user level with nice priority.

              %sys
                     Show the percentage  of  CPU  utilization  that  occurred
                     while  executing  at the system level (kernel). Note that
                     this does not include time spent servicing  hardware  and
                     software interrupts.

              %iowait
                     Show  the  percentage  of  time that the CPU or CPUs were
                     idle during which the system had an outstanding disk  I/O
                     request.

              %irq
                     Show  the  percentage of time spent by the CPU or CPUs to
                     service hardware interrupts.

              %soft
                     Show the percentage of time spent by the CPU or  CPUs  to
                     service software interrupts.

              %steal
                     Show  the percentage of time spent in involuntary wait by
                     the virtual CPU or CPUs while the hypervisor was  servic-
                     ing another virtual processor.

              %guest
                     Show  the  percentage of time spent by the CPU or CPUs to
                     run a virtual processor.

              %idle
                     Show the percentage of time that the  CPU  or  CPUs  were
                     idle  and the system did not have an outstanding disk I/O
                     request.

              Note: On SMP machines a processor that does not have any  activ-
              ity at all is a disabled (offline) processor.

       -V     Print version number then exit.


ENVIRONMENT
       The  mpstat  command takes into account the following environment vari-
       able:


       S_TIME_FORMAT
              If this variable exists and its value is ISO  then  the  current
              locale  will  be  ignored  when  printing the date in the report


BUGS
       /proc filesystem must be mounted for the mpstat command to work.

       Only a few activities are given by the Linux kernel for each processor.


FILES
       /proc contains various files with system statistics.


AUTHOR
       Sebastien Godard (sysstat <at> orange.fr)

SEE ALSO
       sar(1), pidstat(1), iostat(1), vmstat(8)

       http://pagesperso-orange.fr/sebastien.godard/



Linux                             AUGUST 2011                        MPSTAT(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2017 Hurricane Electric. All Rights Reserved.