showusage(1M) (Sun Enterprise 10000 SSP 3.5 Reference Manual)

Sun Enterprise 10000 SSP 3.5 Reference Manual

showusage(1M)

NAME

showusage- display DR and board resource information

SYNOPSIS

showusage

-b

board_number

-r

report_type

-r

report_type

showusage

-b

board_number

-s

DESCRIPTION

showusage used with the -r option displays information on stdout about board resources, system resources, and DR. It presents the information in a tabular format.

showusage used with the -s option returns an integer exit status indicating the state of the specified board. If the specified board is in a domain, showusage writes the domain name to stdout. The -s option is intended for use in ADR scripts. The -s option can also be used to determine the eligibility of a board for an ADR operation before performing any ADR operations.

Note -

This command applies only to Sun Enterprise 10000 domains running DR model 2.0. To find out which DR model is running on your domains, use the domain_status -m command.

OPTIONS

The following options are supported:

-b board_number

System board number, 0 through 15, for which status information is to be obtained.

-r report_type

The type of information to be displayed. report_type can be one of the following:

CPU: Show processor information for the board.
DRAIN: Show the progess of any active drain operation.
IO: Show information for any devices attached to this board.
OBP: Display the board configuration as OBP sees it. You can use the OBP display on a board that has been initially attached, but not yet completely attached. The OBP display might not be as accurate as the CPU, MEM, and IO displays for boards that are in use.
MEM: Show the memory configuration for this board.
UNSAFE: Display all suspend unsafe devices that are open in the specified domain. If this option is used, the -b option is ignored.

You must use multiple -r options to specify more than one type of report. For example, to see processor and device information for board 12, you would use the following command:

showusage -b 12 -r CPU -r IO

-s

Report board state as exit status and write domain name on stdout. If the specified board does not currently belong to a domain, no text is written to stdout.

EXIT STATUS

The showusage command returns different sets of exit status values depending on the command option specified.

The following exit values are returned when the -s option is specified:

0: Board is not present and is not in a software domain. A software domain is an active domain listed in the domain_config file, but the CPU is not running.
1: Board is not present and is in a software domain.
2: Board is present, powered off, and not in a software domain.
3: Board is present, powered on, and not in a software domain (the board is eligible for attachment).
4: Board is present, powered off, and in a software domain.
5: Board is unconfigured (present, powered on, and in a software domain, but not in a hardware domain). A hardware domain is a booted domain.
6: Board is configured (present, powered on, and in both a software and hardware domain), but not in a detachable DR state. For a description of the conditions that can prevent board detachment, see the Sun Enterprise 10000 Dynamic Reconfiguration User Guide.
7: Board is configured (present, powered on, and in both a software and hardware domain), and possibly detachable. For a description of conditions that can prevent board detachment, see the Sun Enterprise 10000 Dynamic Reconfiguration User Guide.
8: Board belongs to a DR model 3.0 domain. The showusage command is not supported on this domain.
15: Failed to dynamically link with DR library.
255: showusage syntax error.

The following exit values are returned when the -r option is specified:

0: Successfully displayed report.
255: showusage syntax error.

ERROR MESSAGES

If showusage fails, it writes diagnostic messages to stderr.