| |
| System Administration | poweroff(1m) |
| | poweroff - control power off |
SYNOPSIS
| | poweroff [-q] [-y|-n] [location] |
| |
poweroff(1M) powers off the specified dual 48V power supply, fan tray, or board. If no arguments are specified and you have platform administrator privileges, the entire system, with the exception of the bulk power supplies, the fan trays, and the spare system controller (SC), powers off. If there are active domains utilizing the component that is going to be powered off, a listing of those domains and a "Are you sure?" prompt will be given by default.
If you do not have platform administrator privileges, the [location] command operand must be specified and the board must be assigned to a domain for which you have domain administrator or configurator privileges.
Note – This command has no effect on the position of the virtual keyswitch. |
| |
The following options are supported:
- -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.
- -y
- Automatically answers "yes" to all prompts. Prompts are displayed unless used with the -q option.
|
| |
The following operands are supported:
-
location
- Component location separated by a space. Multiple location forms are not 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)
CS(0|1), CS(0|1)
FT(0...7), FT(0...7)
PS(0...5), PS(0...5)
EX(0...17), EX (0...8)
SC(0|1), SC(0|1) [only the spare SC can be powered off.]
|
| |
Group Privileges Required
| |
You must have either platform administrator or domain administrator/configurator privileges to run this command.
If you have domain privileges, you must also specify the [location] operand and the [location] must be a domain configuration unit (DCU) that is assigned to a domain for which you have domain privileges.
Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.
|
|
| | Example 1. Powering Off a CPU Board at Expander Position 0
| |
In this example, poweroff forces the board off by suppressing any stdout messages and answering 'yes' to all prompts.
| |
sc0:sms-user:> poweroff -qy SB0
|
|
|
| |
The following exit values are returned:
-
0
- Successful completion
- >0
- An error occurred.
|
| |
See attributes(5) for descriptions of the following attributes:
| Attribute Types | Attribute Values |
| Availability | SUNWSMSop |
|
| |
