C H A P T E R

C H A P T E R 5

DR User Interfaces on the Domain

This chapter describes the user interfaces on the Sun Fire 15K domain, which include the commands and options that are available to the user, and important files.

DR Commands and Options on the Domain

The cfgadm (1M) command is used to perform DR operations on the domain. DR operations are passed to the libcfgadm (3LIB) library interface, which dynamically loads a hardware-specific library plugin that actually performs the DR operations.

The sbd.so.1 hardware-specific plug-in provides DR functionality: connecting, configuring, unconfiguring, and disconnecting system boards, which enables you to connect or disconnect a system board from a running system without having to reboot the system.

The cfgadm (1M) command resides in the /usr/sbin directory. (See the cfgadm (1M) man page for more information.)

Each board slot appears as a single attachment point in the device tree. You can view the type, state, and condition of each component, and the state and condition of each board slot, by using the cfgadm(1M) command with its -a option.

State Change Functions

State change functions, which change the state of a board slot or a component on the board, can be issued against any attachment point.

The following are state change functions:

configure
unconfigure
connect
disconnect

Availability Change Functions

Availability change functions, which change the availability of a board, can be issued against any attachment point.

The following are availability change functions:

assign
unassign

Condition Change Functions

Condition change functions, which change the condition of a board slot or a component on the board, can be issued against any attachment point.

The following are condition change functions:

poweron
poweroff
test

Options and Operands

The following options and operands are supported for the functions shown:

Options and Operands	Specifies
`-c connect ap_id`	A change in the receptacle state to connected
`-c disconnect ap_id`	A change in the receptacle state to disconnected
`-c configure ap_id`	A change in the occupancy state to configured
`-c unconfigure ap_id`	A change in the occupancy state to unconfigured
`-x function ap_id`	A platform-specific function
`-t ap_id`	The system board to be tested
`-l ap_id`	The state, status, and condition of system boards and components to be displayed

The ap_id operand corresponds to the attachment point of the system board or component.