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, and 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 cannot 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 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 and then disconnects the board before unassigning it.

The possible transition states and their meanings 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 in the active state). 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.

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.

Disconnects the board. See disconnect.

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 the -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 enable the user to specify retries in case of failures encountered during state transitions. The -r retry_count option can be used alone and indicates the number of times the configuration state change request should be retried by the domain. The -t timeout option cannot be used without the -r retry_count option and specifies the number of seconds that the domain should wait before the next retry is made. If the -t timeout is not specified, the default timeout is zero, meaning that the request is retried immediately.

-y

Automatically answers yes to all prompts. Prompts are displayed unless used with the -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 does not 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.

38

Solaris not running.

39

Unable to assign/unassign domain state.

40

Unable to get domain permissions.

41

Unable to get platform permissions.

52

Invalid privileges

53

Internal error.

54

Library error.

56

DR command syntax error.

58

Internal error.

68

Location not assigned.

69

Location not configured.

70

DR operation failed.

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

addboard(1m), moveboard(1m)