| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
- change processor operational status
psradm-f |-i |-n |-s [-v] [-F]processor_id
psradm-a-f |-i |-n |-s [-v] [-F]
Thepsradm utility changes the operational status of processors. The legal states forthe processor areon-line,off-line,spare,faulted, andno-intr.
Anon-line processor processes LWPs (lightweight processes) and can be interrupted byI/O devices in the system.
Anoff-line processor does not process any LWPs. Usually, anoff-line processor isnot interruptible by I/O devices in the system. On some processors orunder certain conditions, it might not be possible to disable interrupts for anoff-line processor. Thus, the actual effect of beingoff-line might vary frommachine to machine.
A spare processor does not process any LWPs. A spare processor canbe broughton-line,off-line or tono-intr by a privileged user of thesystem or by the kernel in response to changes in the system state.
A faulted processor is identified by the kernel, which monitors the behavior ofprocessors over time. A privileged user can set the state of a faultedprocessor to beon-line,off-line,spare orno-intr, but must use theforce option to do so.
Ano-intr processor processes LWPs but is not interruptible by I/O devices.
A processor can not be takenoff-line or madespare if thereare LWPs that are bound to the processor unless the additional-F optionis used. The-F option removes processor bindings of such LWPs before changingthe processor's operational status. On some architectures, it might not be possible totake certain processorsoff-line orspare if, for example, the system depends on someresource provided by the processor.
At least one processor in the system must be able to processLWPs. At least one processor must also be able to be interrupted. Sinceanoff-line orspare processor can be interruptible, it is possible to havean operational system with one processorno-intr and all other processorsoff-line orspare but with one or more accepting interrupts.
If any of the specified processors are powered off,psradm might poweron one or more processors.
Only users with thePRIV_SYS_RES_CONFIG privilege can use thepsradm utility.
The following options are supported:
Perform the action on all processors, or as many as possible.
Take the specified processorsoff-line.
Force the transition to the additional specified state. Required if one or more of the specified processors 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, oroff-line states. Administrators are encouraged to use the-Q option forpbind(1M) to find out which threads will be affected by forced a processor state transition.
Set the specified processorsno-intr.
Bring the specified processorson-line.
Make the specified processors spare.
Output a message giving the results of each attempted operation.
The following operands are supported:
The processor ID of the processor to be seton-line oroff-line,spare, orno-intr.
Specifyprocessor_id as an individual processor 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 possible to combine ranges and (individual or multiple)processor_ids (for example,1-3 5 7-8 9).
Example 1 Setting Processors tooff-line
The following example sets processors 2 and 3off-line:
% psradm-f 2 3
Example 2 Setting Processors to no-intr
The following example sets processors 1 and 2no-intr:
% psradm-i 1 2
Example 3 Setting Processors tospare
The following example sets processors 1 and 2 spare, even if either ofthe processors was in the faulted state:
% psradm -F -s 1 2
Example 4 Setting All Processorson-line
% psradm-a-n
Example 5 Forcing Processors tooff-line
The following example sets processors 1 and 2 offline, and revokes the processorbindings from the processes bound to them:
% psradm-F-f 1 2
The following exit values are returned:
Successful completion.
An error occurred.
Records logging processor status changes
Seeattributes(5) for descriptions of the following attributes:
|
pbind(1M),psrinfo(1M),psrset(1M),p_online(2),processor_bind(2),attributes(5)
The specified processor does not exist in the configuration.
The specified processor could not be takenoff-line because it either has LWPs bound to it, is the laston-line processor in the system, or is needed by the system because it provides some essential service.
The specified processor could not be setno-intr because it is the last interruptible processor in the system, or or it is the only processor in the system that can service interrupts needed by the system.
The specified processor is powered off, and it cannot be powered on because some platform-specific resource is unavailable.
The user does not have permission to change processor status.
The specified processor is powered off, and the platform does not support power on of individual processors.
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |