NAME

complete_detach - complete a DR detach operation

SYNOPSIS

complete_detach sb [force]

AVAILABILITY

Sun Enterprise 10000 servers only.

DESCRIPTION

Execute this command at the dr (1M)shell prompt to complete an attempt to DR Detach a board. The drain(1M) command must have been previously executed and the drain operation must have completed before complete_detach can proceed. You can use the drshow(1M) command to check the status of the drain operation.

A board can be detached only after all use of its devices has ceased. DR automatically terminates the use of memory and network devices and, in almost all cases, processors; but you must terminate use of the board's I/O devices. You can use the drshow(1M) command to list the devices in use on the board.

If the detaching board contains non-pageable kernel or OBP memory, the domain is quiesced during the complete_detach operation. The quiesce operation may fail due to forcible conditions. See the Sun Enterprise 10000 Dynamic Reconfiguration User's Guide for a description of such conditions. You can use the force argument to force the quiesce in such situations.

OPTIONS

sb

The board number (0 to 15) of the system board to be detached.

force

Force the domain quiesce operation. See the Sun Enterprise 10000 Dynamic Reconfiguration User's Guide. for information about forcing a quiesce.

EXIT STATUS

If successful, complete_detach returns a 0 in the dr_return global variable; if not, it returns a 1, along with one or more diagnostic messages.

EXAMPLE

dr> complete_detach 5

Completing detach of board 5.
Operating System has detached the board.
Processors on board 5 reset.
Board 5 placed into loopback.
Board detachment completed successfully.

DIAGNOSTICS

Cannot COMPLETE detach until drain completes

The drain operation is still in-progress. Use drshow(1M) to monitor the drain. After it has completed, repeat the complete_detach command.

Board detachment failed
Retry the COMPLETE or ABORT the operation

A condition on the target domain's operating system has prevented the detach from completing. Retry the operation at a later time, or use abort_detach(1M) to abort the detach.

NOTES

If DR detects a usage syntax error, it immediately aborts the dr (1M)command, displays the dr (1M)shell prompt, and leaves dr_return unmodified.

complete_detach ( 1M ) SEE ALSO

abort_detach(1M), dr (1M),drain(1M), drshow(1M)