sigbcmd(1M)

NAME | SYNOPSIS | CAUTION | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT VARIABLES | NOTES

NAME

sigbcmd- send commands from SSP to domain

SYNOPSIS

sigbcmd [-svif] [-t retries] [-p proc] cmd
sigbcmd [-vif] [-t retries] -p proc -r

CAUTION

Only authorized service providers should use this command. Improper use may disrupt activity on the domain, causing unexpected results and, possibly, catastrophic operating system failure.

DESCRIPTION

The SSP utility sigbcmd performs one of the following actions: sends the given command, cmd, to the Sun Enterprise 10000 domain specified in the SUNW_HOSTNAME environment variable; displays status of a mailbox (-s); or resets the mailbox flag of a processor to empty (-r). If cmd expects a response, sigbcmd also retrieves that response from the domain.

sigbcmd uses the signature block mailbox interface to communicate with the kernel for execution of commands. This mailbox resides in BBSRAM.

OPTIONS

sigbcmd executes only one command, then exits. Therefore, the -r, -s and cmd options are mutually exclusive. If you specify more than one at a time, only one is executed, in the following order of precedence: -r, -s, cmd.

cmd

An ASCII name representing the command to send to the domain. Currently supported commands are obp (make domain enter OBP) and panic (make domain panic).

---

Note -

You cannot send a panic or obp command to an IDN domain unless option -f was used. You must first use domain_unlink to unlink such a domain.

---

-s

Display the current status - the flag, cmd, and data fields - of the mailbox. Only the first 32 bytes (SIGB_MBOX_SIZE/2) of the data field are displayed.

-v

Execute in verbose mode, printing some debugging information. The default is terse mode.

-i

Query the user to confirm execution of the command. The default is no query.

-f

Force execution, overriding the mailbox flag. If -f is not set (the default) and something is detected in the mailbox (for example, flag != SIGB_MBOX_EMPTY), sigbcmd does not write out the mailbox command. Using -f will force it to do so. This option will force execution against an IDN domain. However, a panic in an IDN domain can cause a cluster arbstop.

-r

Reset to empty the mailbox flag of the target processor specified by -p proc.

-t retries

If a response is expected, read the mailbox for that response the specified number of times, where retries is an integer, with one-second pauses between reads. If a response is never detected, an error message appears stating so. The default is 10 retries, which takes about 10 seconds.

-p proc

Make the specified processor the target of the given command. The default is to pick any present and available processor, usually the boot processor.

EXAMPLES

---

Example 1 Going to OBP




Make target domain enter OBP.

sigbcmd -p 4 obp

---

---

Example 2 Sending Commands




Send a domain panic command to processor 4. Pause or acknowledgement from the user before actually sending the command.

sigbcmd -i -p 4 panic

---

ENVIRONMENT VARIABLES

The environment variable SUNW_HOSTNAME must be set to the name of the domain.

NOTES

This command assumes the domain's operating system is coherent enough to receive the mailbox command (through NMI level 15 interrupt).

Be careful: this utility does not check for permissions.

SSP 3.5  Last Revised 1 Aug 1999

NAME | SYNOPSIS | CAUTION | DESCRIPTION | OPTIONS | EXAMPLES | ENVIRONMENT VARIABLES | NOTES