cpupstat Command

Purpose

Detects configurations that could cause a CPU DR operation to fail.

Syntax

cpupstat [-v] -i identifier

Description

The purpose of this command is to detect configurations that could cause a CPU DR operation to fail. There are multiple steps to the command.
  1. Parse and validate the input.
  2. Check all the WLM class control block rsets for rsets with a single active CPU matching the passed in CPU. Class control block rsets are located in ccb[cid]->cl_rset, to iterate through all of them the value of CID must be incremented and class validity checked for each possible value. A count of the number of classes with such an rset will printed. If the verbose option is given, the names of the classes will be printed as well.
  3. Check all the kernel registry rsets for rsets with a single active cpu matching the passed in CPU. A count of the number of processes with attachments to such rsets will be printed to the user. If the verbose option is given, the process IDs will be printed as well.
  4. A count of bindprocessor attachments for the highest numbered bind ID will be printed for the user. If the verbose option is given, the process IDs will be printed as well.

Flags

Item Description
-i The index of the logical CPU ID.
-v Verbose option.

Exit Status

If an error is encountered in the execution a suitable error message is written to stderr, and the command exits with a non-zero exit status.

Examples

  1. # cpupstat -i 2

3 WLM classes have single CPU rsets with CPU ID 2.
0 processes have single CPU rset attachments with CPU ID 2.
0 processes are bound to bind ID 2.

  2. # cpupstat -v -i 2

3 WLM classes have single CPU rsets with CPU ID 2.
        c1
        c1.Default
        c1.Shared
0 processes have single CPU rset attachments with CPU ID 2.
0 processes are bound to bind ID 2.

  3. # cpupstat -i 2

0 WLM classes have single CPU rsets with CPU ID 2.
2 processes have single CPU rset attachments with CPU ID 2.
0 processes are bound to bind ID 2.

  4. # cpupstat -v -i 2

0 WLM classes have single CPU rsets with CPU ID 2.
2 processes have single CPU rset attachments with CPU ID 2.
        16600
        26444
0 processes are bound to bind ID 2.
    For bound processes, the last list, the output is the same as for rset attachments, where the PID gets printed if the -v option is specified.

Location

/usr/bin/cpupstat