psradm(1M)
NAME
psradm − set processors on-line or off-line
SYNOPSIS
psradm −f | −n [ −v ] processor_id ...
psradm −a −f | −n [ −v ]
DESCRIPTION
psradm sets processors on-line or off-line. An off-line processor does little or no work. The actual effect of being off-line may vary from machine to machine.
A processor may not be taken off-line if there are LWPs (lightweight processes) that are bound to the processor. On some architectures, it might not be possible to take certain processors off-line if, for example, the system depends on some resource provided by the processor.
At least one processor must remain on-line. If any of the specified processors are powered off, psradm may power on one or more processors.
Only superusers can use the psradm command.
OPTIONS
The following options are supported:
−a Perform the action on all processors, or as many as possible.
−f Take the specified processors off-line.
−n Bring the specified processors on-line.
−v Output a message giving the results of each attempted operation.
OPERANDS
The following operands are supported:
processor_id The processor ID of the processor to be set on-line or off-line.
EXAMPLES
The following example sets processors 2 and 3 off-line.
psradm −f 2 3
The following example sets all processors on-line.
psradm −a −n
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
FILES
/etc/wtmp for records logging processor status changes
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWcsu |
SEE ALSO
psrinfo(1M), psrset(1M), p_online(2), attributes(5)
DIAGNOSTICS
psradm: processor 4: Invalid argument
The specified processor does not exist in the configuration.
psradm: processor 3: Device busy
The specified processor could not be taken off-line because it either has LWPs bound to it, is the last on-line processor in the system, or is needed by the system because it provides some essential service.
psradm: processor 3: Device busy
The specified processor is powered off, and it cannot be powered on because some platform-specific resource is unavailable.
psradm: processor 0: Not owner
The user does not have permission to change processor status.
psradm: processor 2: Operation not supported
The specified processor is powered off, and the platform does not support power on of individual processors.
SunOS 5.6 — Last change: 10 Jan 1997