dr_cmd_drain(1m)
NAME | SYNOPSIS | CAUTION | DESCRIPTION | OPERANDS | DIAGNOSTICS | EXIT STATUS | SEE ALSO
NAME
- dr_cmd_drain- start memory drain on a system board.
SYNOPSIS
-
dr_cmd_drain sb
CAUTION
This command, which runs in the DR shell, is dangerous; do not use it. It is included here only for completeness. Instead, use the drain(1M) command, which performs the same functions, but with the added security of safeguards and checks.
DESCRIPTION
dr_cmd_drain determines the best way to vacate memory physically located on the designated system board. It may simply flush the memory, or copy it to memory available on another system board in the same domain. If a suitable target memory for the memory copy is not available when the dr_cmd_drain command is invoked, the request is denied. If the unavailability is due to run-time conditions and system load, you should retry the dr_cmd_drain operation at a later time.
The dr_cmd_drain operation also removes the system board from the board list in the domain_config(4) file on the SSP. (Refer to the domain_config(4) man page in the Sun Enterprise 10000 SSP 3.5 Reference Manual.
dr_cmd_drain begins execution, then quickly exits. Use drshow(1M) to monitor its progress.
Note -
This command is available only for DR 2.0 domains (that is, domains that use the DR daemon) on the Sun Enterprise 10000 server. You can use domain_status(1M) to determine the DR version running on the domain.
OPERANDS
DIAGNOSTICS
See DIAGNOSTICS on drain(1M).
EXIT STATUS
If dr_cmd_drain succeeds it returns a 0 result code in the dr_return global variable. If it fails, it returns a 1 and displays diagnosic messages.
Note -
Tcl parsing errors prevent DR commands from running which, in turn, leaves dr_return uninitialized. In such cases, the dr_return error code is meaningless. See dr(1M) for more information concerning return codes.
SEE ALSO
dr_cmd_mem_info(1M)
NAME | SYNOPSIS | CAUTION | DESCRIPTION | OPERANDS | DIAGNOSTICS | EXIT STATUS | SEE ALSO
- © 2010, Oracle Corporation and/or its affiliates