Manual page for psradm(1M)
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.
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 07/October/97
