deleteboard(1M) removes a location from the domain it is currently assigned to and possibly active in. The board at that location must be in either the assigned or connected|configured states. The -c option is used to specify the transition of the board from the current configuration state to the new configuration state.

Configuration states are: unconfigure, disconnect, or unassign. If the -c option is not specified, the default expected configuration state is unassign.

A domain administrator can unconfigure and disconnect a board but is not allowed to unassign a board from a domain unless the board is in the domain available component list. See setupplatform(1M). This means the deleteboard location field must appear in the domain available component list.

The following options are supported.

-c function

Valid function values are unconfigure, disconnect, or unassign. The -c option is used to control the configuration state transition. Each successive function builds upon the last. For example, unassign first unconfigures then disconnects the board before unassigning it. Note – If the deleteboard command fails, a board does not return to its original state. A dxs or dca error message is logged to the domain. If the error is recoverable you can retry the command. If it is unrecoverable, you will need to reboot the domain in order to use that board.

The possible transition states and their meaning are as follows:

unconfigure

Unconfigures the board from the Solaris operating environment running on the domain. Solaris software stops using any of the hardware resources on the board.

Transitions the board into the connected|unconfigured state. In this state the system board is assigned to the logical domain and connected (remains active). This state allows normal system access to hardware resources on the board but the hardware resources of the board are not represented by the normal Solaris software data structures and thus are not available to the Solaris operating environment. Operations allowed on the board are limited to configuration administration operations.

disconnect

Unconfigures the board from the Solaris operating environment running on the domain. See unconfigure above.

Transitions the board into the disconnected|unconfigured state. Removes the board from the physical domain. An UNCLAIM request is sent by the domain to the SC during this step. In this state the system board is assigned to the logical domain and disconnected.

unassign

Unconfigures the board from the Solaris operating environment running on the domain. See unconfigure above.

Disconnects the board. See disconnect above.

Moves the board out of the logical domain by changing its state to available.

-f

Forces the specified action to occur. Typically, this is a hardware-dependent override of a safety feature. Forcing a state change operation can allow use of the hardware resources of an occupant that is not in the ok or unknown conditions, at the discretion of any hardware-dependent safety checks.

-h

Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.

-n

Automatically answers "no" to all prompts. Prompts are displayed unless used with -q option.

-q

Quiet. Suppresses all messages to stdout including prompts.

When used alone -q defaults to the -n option for all prompts.

When used with either the -y or the -n option, -q suppresses all user prompts, and automatically answers with either 'y' or 'n' based on the option chosen.

-r retry_count -t timeout

These command arguments allow the user to specify retries in case of failures encountered during state transitions. The -r retry_count option indicates the number of times the configuration state change request should be retried by the domain. The -t timeout option specifies the number of seconds that the domain should wait before the next retry is made. This option must be specified with retry_count. The default is zero, meaning the request is retried immediately.

-y

Automatically answers "yes" to all prompts. Prompts are displayed unless used with -q option.

The following operands are supported:

location

List of board locations separated by a space. Multiple location arguments are permitted.

The following location forms are accepted:

Sun Fire 15K, Sun Fire 12K

SB(0...17), SB(0...8)

IO(0...17), IO(0...8)

Group Privileges Required

The following exit values are returned:

0

Successful completion

1

No acknowledge

2

Not supported

3

Operation not supported

4

Invalid privileges

5

Busy

6

System Busy

7

Data error

8

Library error

9

No Library

10

Insufficient condition

11

Invalid

12

Error

13

A PID doesn't exist

14

Invalid attribute

30

Invalid board ID type

31

Invalid permissions

32

Assigned to another domain

33

Unable to get permissions

34

Unable to get domain board info

35

Unable to get active board list

36

Unable to get assigned board list

37

Get blacklist failed

38

Solaris not running

56

DR command syntax error

68

DR operation failed

See attributes(5) for descriptions of the following attributes:

addboard(1m), moveboard(1m)