---
name: "xmcpustate"
section: "1"
platform: "linux"
package: "xmcpustate"
version: "3-11"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/xmcpustate"
---

# xmcpustate(1)

display CPU states (idle, nice, system, kernel) statistics

## NAME

xmcpustate - display CPU states (idle, nice, system, kernel) statistics

## SYNTAX

**xmcpustate** \[*-toolkitoption* ...\] \[*-count* iterations\]  \[*-interval* seconds\] \[*-barwidth* pixels\] \[*-barheight* pixels\] \[*-idlecol* color\] \[*-usercol* pixels\] \[*-kernelcol* color\] \[*-nicecol* pixels\] \[*-systemcol* color\]

## DESCRIPTION

*Xmcpustate* displays bars showing the percentage of time the CPU spends in different states.

On a machine running Berkeley Unix, or a derivative (Suns with SunOS, microVaxen with Ultrix), the bar indicates the proportions of idle, user, nice, and system time with increasing levels of gray scale (from left to right)

On an Iris4D, there may be more than one bar, one for each CPU, and each bar indicates the proportions of idle + wait, user, kernel, sxbrk and interrupt time for each cpu.

On a Cray X/MP or Y/MP, under Unicos 5.1 or greater, it will display bars for as many cpus as are configured.  The proportions of idle, user and system time are shown for each cpu.

On Linux, it will display 4 separate bars: CPU, Memory, Swap and Ethernet load.

## OPTIONS

*Xmcpustate* accepts all of the standard X Toolkit command line options, plus:

- *-count* iterations

  The number of times it should update the display. Default is forever.

- *-interval* seconds

  the interval in between updates. Default is 1 second.

- *-barwidth* pixels

  the width of a displayed status bar. Default is 350 pixels.

- *-barheight* pixels

  the height of a displayed status bar. Default is 20 pixels.

- *-idlecol* color

  the color to use for idle. Default is green.

- *-usercol* color

  the color to use for user space. Default is magenta.

- *-kernelcol* color

  the color to use for kernel space. Default is yellow.

- *-nicecol* color

  the color to use for nice. Default is DarkRed.

- *-systemcol* color

  the color to use for system space. Default is black.

  A color must be given by it's symbolic name.

## X DEFAULTS

For *xmcpustate* the available class identifiers are:

```
xmcpustate - the application
Form - enclosing the entire application, and sub-Forms enclosing
Label/Bar pairs.
```

The default font list is lucida bold at 12pt. The default background color is SlateBlue.

For *xmcpustate,* the available name identifiers are:

```
xmcpustate - application name
The outer Form is "form".
The Forms enclosing the Label/Bar pairs are "formN", where N is the
index number, starting with the top pair as zero.
Each Label name is the same as the label string.
Each Bar name is "barN".
The form enclosing the colored labels is "colorLegend"
```

For *xmcpustate,* the available resources are:

- name interval, class Interval

  corresponds to the -interval option. Takes an integer value.

- name count, class Count

  corresponds to the -count argument, also takes and integer value.

- name barwidth, class Barwidth

  corresponds to the -barwidth option. Takes an integer value.

- name barheight, class Barheight

  corresponds to the -barheight option. Takes an integer value.

- name idlecol, class Idlecol

  corresponds to the -idlecol option. Takes a string value.

- name usercol, class Usercol

  corresponds to the -usercol option. Takes a string value.

- name kernelcol, class Kernelcol

  corresponds to the -kernelcol option. Takes a string value.

- name nicecol, class Nicecol

  corresponds to the -nicecol option. Takes a string value.

- name systemcol, class Systemcol

  corresponds to the -systemcol option. Takes a string value.

## NOTES

*Xmcpustate* is derived from Xcpustate *Xcpustate* was designed for a multiprocessor (a Silicon Graphics Iris4D/240) - it happens to work for conventional BSD uniprocessors. It is meant to be easy to port, and extend to monitor a wide variety of statistics.

## SEE ALSO

xperfmon, xload

## AUTHOR

Mark Moraes, University of Toronto Thanks to Chris Siebenmann for the code for BSD systems. Thanks to Walter D. Poxon from Cray Research for the code for Cray X/MP and Y/MPs. Modified to Xmcpustate by Koen D'Hondt (ripley@xs4all.nl) from the Delft University of  Technology, Netherlands.
