deleteboard(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ERROR MESSAGES | NOTES | SEE ALSO

NAME

deleteboard- detach a system board from a domain

SYNOPSIS

deleteboard -b board_number [-r retry_count [-t timeout]] [-q]
deleteboard [-r retry_count [-t timeout]] [-q] SBx
deleteboard -h

DESCRIPTION

The deleteboard command detaches a system board from its current domain. It also writes progress messages to the platform log on the SSP and to standard output.

If deleteboard fails, it writes error information to standard error and returns a nonzero exit status. The board stays in the state it is in when the command fails. You can rerun deleteboard, or you can use addboard(1M) to return the board to its original state.

The -r option specifies the maximum number of retry attempts, retry_count, in the event that a detach operation fails. The -t option specifies a time period in seconds, timeout, between retry attempts. If you specify the number of retries, but no timeout, there is no delay between retry attempts. If you specify a timeout, you must also specify the number of retries.

To be eligible for detachment, a board must be powered on and in one of the following states:

• In a domain

• An addboard(1M) operation was initiated, but not completed

• A deleteboard operation was initiated, but not completed

• A moveboard(1M) operation was initiated, but not completed

If the specified board is not in a domain or has already been detached from its source domain, deleteboard returns an exit value of zero, indicating success. A DR platform error message indicates that the board is already detached.

OPTIONS

The following options are supported:

-b board_number

Specifies the system board number, 0 through 15.

-h

Displays a usage message.

-r retry_count

Specifies the number of retry attempts. There are no limits to the possible retries.

-t timeout

Specifies the time in seconds between retry attempts. There is no limit to the amount of time.

-q

Turns on quiet mode, which means informational messages are not written to standard output.

OPERANDS

The following operand is supported:

SBx

Specifies the system board, where x equals an integer from 0 through 15.

EXAMPLES

In the following examples, the command detaches system board 2 from its current domain. If the first attempt to detach the board fails, two retries are made, if necessary, with a wait time of 10 minutes between retries.

---

Example 1 To Delete a Board With the -b Option




# deleteboard -b 2 -r 2 -t 600

---

---

Example 2 To Delete a Board Without the -b Option




# deleteboard -r 2 -t 600 SB2

---

EXIT STATUS

The following exit values are supported.

0

Successfully detached the specified board from its domain.

1

Command syntax error occurred.

2

Failed to acquire DR lock.

3

Failed to release DR lock.

4

Failed to initialize DR communications.

5

Board or current domain is not eligible for detachment.

6

A board in the current domain is in an intermediate detach state.

7

DR daemon does not allow a detach operation when it removes the last processor from the domain or when it drops the memory in the domain below the minimum requirement.

8

Failed during memory drain operation.

9

Drain operation failed to make progress.

10

Failed in attempting to complete the detach.

15

Failed to dynamically link with DR library.

17

A termination signal was received.

51

The command was not completed because of a negative acknowledgment from the confp->confirm function.

52

System configuration administration is not supported on this attachment point.

53

System configuration administration operation is not supported on this attachment point.

54

The caller does not have the required process privileges. For example, if configuration administration is performed through a device driver, the permissions on the device node are used to control access.

55

The command was not completed because an element of the system configuration administration system was busy.

56

The command required a service interruption and was not completed because part of the system could not be suspended (that is, quiesced).

57

A procedural error occurred in the data.

58

A procedural error occurred in the library, including a failure to obtain process resources such as memory and file descriptors.

59

A hardware-specific library could not be located by using the specified attachment point.

60

The operation failed because of the condition of the attachment point.

61

The system configuration administration operation requested is not supported on the specified attachment point.

62

An error occurred during the processing of the requested operation. This error code includes validation of the command arguments by the hardware-specific code.

63

No such attachment point exists.

64

No attachment point with the specified attributes exists.

65

An invalid board ID was specified.

ERROR MESSAGES

If deleteboard fails, it writes diagnostic messages to standard error.

NOTES

The deleteboard command prevents more than one attach or detach operation from executing concurrently.

SEE ALSO

addboard(1M), moveboard(1M), rcfgadm(1M)

domain_status(1M) and showdevices(1M) in the Sun Enterprise 10000 SSP 3.5 Reference Manual

dcs(1M) and dr_daemon(1M) in man pages section 1M: System Administration Commands in the Solaris 8 Reference Manual

Sun Enterprise 10000 Dynamic Reconfiguration User Guide

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ERROR MESSAGES | NOTES | SEE ALSO