System Administration Commands psradm(1M)
NAME
psradm - change processor operational status
SYNOPSIS
psradm -f | -i | -n | -s [-v] [-F] processor_id
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 usercan 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 theSunOS 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 processLWPs. 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 withone 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 PRIV_SYS_RES_CONFIG 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 tofaulted, 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:processor_id The processor ID of the processor to be set
on-line or off-line, spare, or no-intr.
Specify processor_id as an individual pro-
cessor number (for example, 3), multiple processor numbers separated by spaces (for example, 1 2 3), or a range of processornumbers (for example, 1-4). It is also pos-
sible to combine ranges and (individual ormultiple) processor_ids (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 changesATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcs ||_____________________________|_____________________________|
SEE ALSO
pbind(1M), psrinfo(1M), psrset(1M), p_online(2),
processor_bind(2), attributes(5)
DIAGNOSTICSpsradm: 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, oror 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 bepowered 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