mpstat - Report processors related statistics.


SYNOPSIS

       mpstat [ -P { cpu | ALL } ] [ -V ] [ interval [ count ] ]


DESCRIPTION

       The  mpstat  command  writes to standard output activities
       for each available processor, processor 0 being the  first
       one.   Global  average activities 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.

       The interval parameter specifies the  amount  of  time  in
       seconds  between each report.  A value of 0 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
       parameter, the mpstat command generates  reports  continu­
       ously.


REPORTS

       The report generated by the mpstat command has the follow­
       ing format:

       CPU
              Processor number. The keyword  all  indicates  that
              statistics  are  calculated  as  averages among all
              processors.
       %user
              Show  the  percentage  of  CPU   utilization   that
              occurred  while executing at the user level (appli­
              cation).
       %nice
              Show  the  percentage  of  CPU   utilization   that
              occurred  while  executing  at  the user level with
              nice priority.
       %system
              Show  the  percentage  of  CPU   utilization   that
              occurred  while executing at the system level (ker­
              nel).
       %idle
              Show the percentage of time that the  CPU  or  CPUs
              were idle.
       intr/s
              Show  the  total  number of interrupts received per
              second by the CPU or CPUs.

       -P cpu | ALL
              Indicate the processor number for which  statistics
              are  to  be reported.  cpu is the processor number.
              Note that processor 0 is the first processor.   The
              ALL  keyword  indicates  that  statistics are to be
              reported for all processors.

       -V     Print version number and usage then exit.


ENVIRONMENT

       The mpstat command takes into account the following  envi­
       ronment variable:

       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 header.  The mpstat command
              will use the ISO format (YYYY-MM-DD) instead.


EXAMPLES

       mpstat 2 5
              Display five reports of global statistics among all
              processors at two second intervals.

       mpstat -P ALL 2 5
              Display  five reports of statistics for all proces­
              sors at two second intervals.


BUGS

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

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


FILES

       /proc contains various files with system statistics.


AUTHOR

       Sebastien Godard <sebastien.godard@wanadoo.fr>


SEE ALSO

       sar(1), sadc(8), sa1(8), sa2(8), iostat(1), vmstat(8)

       http://perso.wanadoo.fr/sebastien.godard/


Man(1) output converted with man2html