System Administration Commands psradm(1M)
NAME
psradm - change processor operational status
SYNOPSIS
psradm -f -i -n -s [-v] [-F] processorid
psradm -a -f -i -n -s [-v] [-F]
DESCRIPTION
The psradm utility changes the operational status of proces-
sors. The legal states for the processor are on-line, off-
line, spare, faulted, and no-intr.
An on-line processor processes LWPs (lightweight processes)
and can be interrupted by I/O devices in the system.
An off-line processor does not process any LWPs. Usually, an
off-line processor is not interruptible by I/O devices in
the system. On some processors or under certain conditions,
it might not be possible to disable interrupts for an off-
line processor. Thus, the actual effect of being off-line
might vary from machine to machine.
A spare processor does not process any LWPs. A spare proces-
sor can be brought on-line, off-line or to no-intr by a
privileged user of the system or by the kernel in response
to changes in the system state.
A faulted processor is identified by the kernel, which moni-
tors the behavior of processors over time. A privileged user
can set the state of a faulted processor to be on-line,
off-line, spare or no-intr, but must use the force option to
do so.
A no-intr processor processes LWPs but is not interruptible
by I/O devices.
A processor can not be taken off-line or made spare if there
are LWPs that are bound to the processor unless the addi-
tional -F option is used. The -F option removes processor
bindings of such LWPs before changing the processor's opera-
tional status. On some architectures, it might not be possi-
ble to take certain processors off-line or spare if, for
example, the system depends on some resource provided by the
SunOS 5.11 Last change: 25 Feb 2008 1
System Administration Commands psradm(1M)
processor.
At least one processor in the system must be able to process
LWPs. At least one processor must also be able to be inter-
rupted. Since an off-line or spare processor can be inter-
ruptible, it is possible to have an operational system with
one processor no-intr and all other processors off-line or
spare but with one or more accepting interrupts.
If any of the specified processors are powered off, psradm
might power on one or more processors.
Only users with the PRIVSYSRESCONFIG privilege can use
the psradm utility.
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.
-F Force the transition to the additional specified
state. Required if one or more of the specified pro-
cessors was in the faulted state. Set the specified
processors to faulted, if no other transition option
was specified. Forced transitions can only be made to
faulted, spare, or off-line states. Administrators are
encouraged to use the -Q option for pbind(1M) to find
out which threads will be affected by forced a proces-
sor state transition.
-i Set the specified processors no-intr.
-n Bring the specified processors on-line.
-s Make the specified processors spare.
-v Output a message giving the results of each attempted
operation.
SunOS 5.11 Last change: 25 Feb 2008 2
System Administration Commands psradm(1M)
OPERANDS
The following operands are supported:
processorid The processor ID of the processor to be set
on-line or off-line, spare, or no-intr.
Specify processorid as an individual pro-
cessor number (for example, 3), multiple
processor numbers separated by spaces (for
example, 1 2 3), or a range of processor
numbers (for example, 1-4). It is also pos-
sible to combine ranges and (individual or
multiple) processorids (for example, 1-3 5
7-8 9).
EXAMPLES
Example 1 Setting Processors to off-line
The following example sets processors 2 and 3 off-line:
% psradm -f 2 3
Example 2 Setting Processors to no-intr
The following example sets processors 1 and 2 no-intr:
% psradm -i 1 2
Example 3 Setting Processors to spare
The following example sets processors 1 and 2 spare, even if
either of the processors was in the faulted state:
% psradm -F -s 1 2
Example 4 Setting All Processors on-line
% psradm -a -n
SunOS 5.11 Last change: 25 Feb 2008 3
System Administration Commands psradm(1M)
Example 5 Forcing Processors to off-line
The following example sets processors 1 and 2 offline, and
revokes the processor bindings from the processes bound to
them:
% psradm -F -f 1 2
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
FILES
/etc/wtmpx Records logging processor status changes
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
SEE ALSO
pbind(1M), psrinfo(1M), psrset(1M), ponline(2),
processorbind(2), attributes(5)
DIAGNOSTICS
psradm: processor 4: Invalid argument
The specified processor does not exist in the configura-
tion.
psradm: processor 3: Device busy
The specified processor could not be taken off-line
SunOS 5.11 Last change: 25 Feb 2008 4
System Administration Commands psradm(1M)
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 could not be set no-intr because
it is the last interruptible processor in the system, or
or it is the only processor in the system that can ser-
vice interrupts needed by the system.
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.11 Last change: 25 Feb 2008 5
|
