DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

mpstat(ADM)


mpstat -- multiprocessor CPU load status display

Syntax

mpstat [ -x | -c CPU ] [ -bho ]

mpstat [ -V ]

Description

The multiprocessor load display utility, mpstat, displays system processor activity information on your screen for each of the processors serialized on your system. CPU load display information updates every second.

When you invoke mpstat, the Multiprocessor Activity window displays on your screen. For each CPU serialized on your system the following information displays:

CPU Activity Display windows

The CPU Activity Display window displays CPU activity. The percentage of kernel code running, the percentage of user code running, and the percentage of CPU idle time are indicated as follows: The amount of space within the CPU Activity Display window indicates the percentage of CPU idle time (one space equals 5%).

Status

Each CPU is in one of three states:
The CPU load display utility displays status information for as many CPUs as possible on your screen. If you have a large number of processors serialized, it may not be possible to display status information for all processors on one screen. mpstat allows you to examine status information for all CPUs using the following key combinations:

<Ctrl>f scrolls forward one screen
<Ctrl>d scrolls forward one half screen
<Ctrl>b scrolls backward one screen
<Ctrl>u scrolls backward one half screen
<Home> or <Ctrl>h moves to the first screen
<End> or G moves to the last screen
<Up Arrow> or j scrolls forward one CPU
<Down Arrow> or k scrolls backward one CPU
<Ctrl>r or <Ctrl>l refreshes the current screen
<Space Bar> scrolls through options

 +----------------+----------------------------------+
 |Ctrlf           | scrolls forward one screen       |
 +----------------+----------------------------------+
 |Ctrld           | scrolls forward one half screen  |
 +----------------+----------------------------------+
 |Ctrlb           | scrolls backward one screen      |
 +----------------+----------------------------------+
 |Ctrlu           | scrolls backward one half screen |
 +----------------+----------------------------------+
 |Home or Ctrlh   | moves to the first screen        |
 +----------------+----------------------------------+
 |End or G        | moves to the last screen         |
 +----------------+----------------------------------+
 |Up Arrow or j   | scrolls forward one CPU          |
 +----------------+----------------------------------+
 |Down Arrow or k | scrolls backward one CPU         |
 +----------------+----------------------------------+
 |Ctrlr or Ctrll  | refreshes the current screen     |
 +----------------+----------------------------------+
 |Space Bar       | scrolls through options          |
 +----------------+----------------------------------+
The Help window displays the list of the key combinations above. Press ``h'' from the Multiprocessor Activity window to display the Help window. The Help window also displays Hotkey information. Hotkeys are used to move between mpstat windows. The Hotkeys are as follows:

<Esc> or q exit the current window
o display the Options window

 +---------+----------------------------+
 |Esc or q | exit the current window    |
 +---------+----------------------------+
 |o        | display the Options window |
 +---------+----------------------------+
The mpstat utility allows you to lock this utility onto any one CPU (with the exception of the base CPU -- CPU1). If you lock mpstat onto a CPU, that CPU will only execute mpstat and processes currently designated to run on that CPU. The CPU displays on the status information screen as being in a STATIC state.

Invoke mpstat with the -c CPU option or select the lock option from the Options menu to lock mpstat to run on a specified CPU.

Invoke mpstat with the -x (default) option to allow mpstat to free run on any CPU.

Invoke mpstat with the -h option or select the hide option from the Options menu to hide the statistics of the locked CPU.

You can select the required options, on the Options screen, using the <Up Arrow> and <Down Arrow> keys. Invoke mpstat with the -o option or type ``o'' at the Multiprocessor Activity window to display the Options window.

mpstat can be run with none or any of the following command line parameters:


-c CPU
lock mpstat utility on processor number CPU. Cannot be used with option -x.

-b
use black and white for screen colors. This is useful for running mpstat in, for example, a scoterm window.

-h
hide statistics of locked CPU

-o
run Options window

-x
allow mpstat to free run on any CPU. Default option. Cannot be used with option -c.

-V
display Corollary mpstat version number

Files


/etc/mpstat
command

See also

cpu(HW), cpuonoff(ADM), cpusar(ADM), mpsar(ADM)

Standards conformance

mpstat is not part of any currently supported standard; it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003