cpustat(1)						      General Commands Manual							cpustat(1)

Name
       cpustat - report CPU statistics

Syntax
       cpustat [-cfhsv] [interval [count]]

Description
       The  command  displays  statistics about the use and state of each CPU in the system.  The information about the CPU might change while the
       command is running, so the information it gives is a snapshot taken at a given time.

       Normally, the command displays the statistics and state only once. You can cause the command to repeat the display by specifying a  decimal
       number  in  the	interval argument. The command repeats the display until it is interrupted, for example, by a control character entered at
       the terminal.

       You can limit the number of times the command repeats the display by specifying an integer in the count argument.

       The command provides an interactive interface that you can invoke using the -f option.

       The following describes the fields in the display:

       Statistics: Information about how each CPU's time is being used

	    us%      Percent of time spent in user mode

	    ni%      Percent of time spent in nice mode

	    sy%      Percent of time spent in system mode

	    id%      Percent of time spent idle

	    csw      Number of context switches

	    sys      Number of system calls

	    trap     Number of traps

	    intr     Number of device interrupts

	    ipi      Number of interprocessor interrupts

	    ttyin    Number of characters input to the terminal

	    ttyout   Number of characters output to the terminal

       State: Information about the different states of each CPU

	    cpuid    Unique identifier of the CPU.

	    state    CPU state.
			B - boot CPU
			D - disable soft errors
			S - stopped
			R - running
			T - TB needs invalidation
			P - panicked

	    ipi-mask interprocessor interrupt mask
			P - panic
			R - console print
			S - schedule
			D - disable
			T - TB invalidation
			H - stop CPU

	    proc     Indication of whether the CPU has an associated process. A Y indicates that an associated process exists, while  an  N  indi-
		     cates that no associated process exists.

	    pid      Process ID of the running process.

	    If any statistic field value exceeds 9999, it is shown in a scaled representation with the suffix k, which indicates multiplication by
	    1000, or with the suffix m, which indicates multiplication by 1,000,000.  For example, the value 12,345 would appear as 12k.

Options
       -c   Displays only the statistics for each CPU.

       -f   Displays statistics and state information on a full screen.  If you use the -f option, you are prompted to enter one of the  following
	    commands:

	    c	 Displays only statistics about each CPU.

	    d	 Uses the default mode of display.

	    h	 Displays the help screen. To return to the original display screen, enter any character.

	    q	 Quits from the full screen display.

	    s	 Displays only state information about each CPU.

	    v	 Displays information about each vector processor and omits information about other processors.

       -s   Displays only state information about each CPU.

       -h   Provides help information about the usage of the command.

       -v   Displays  information about each vector processor and omits information about other processors. When displays information about vector
	    processors, it adds the following information to the display:

	    vp state  Indicates that the vector processor is operational (OK), not usable (DEAD), enabled (ENA), or disabled  (DIS).  The  command
		      display may contain a combination of these states.

	    vp owner  PID of the vector process whose context is stored in the vector processor.

	    chp cxsw  Number  of context switches in which the process whose context changed is the only process using a particular vector proces-
		      sor. Because no other process uses the vector processor, the register data associated with the processor	does  not  change.
		      Therefore,  the  system  does  not  need	to save and restore the register data; the data remains in the registers until the
		      process is ready to use it.

	    exp cxsw  Number of context switches in which a number of processes might be using the same vector	processor.   When  more  than  one
		      process uses the same processor, the register data associated with the processor might be changed by any process. Therefore,
		      the system saves and restores the register data during a context switch for any process.

	    succ req  Number of times the vector process has successfully allocated the vector processor.

	    failed req
		      Number of times the vector process has been refused vector processor allocation.

       If you omit all options, reports a summary of the statistics since the system has been booted and the state of each CPU.

Examples
       To print the system status every five seconds ten times, enter the following command:
       % cpustat 5 10

Files
       Virtual main memory image

       System namelist

See Also
       iostat(1), vmstat(1)

																	cpustat(1)