Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎


     psradm - change processor operational status

     psradm -f | -i | -n | -s [-v] [-F] processor_id

     psradm -a -f | -i | -n | -s [-v] [-F]

     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

     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 PRIV_SYS_RES_CONFIG  privilege  can  use
     the psradm utility.

     The following options are supported:

     -a    Perform the action on all processors, or  as  many  as

     -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

     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 processor
                     numbers (for example, 1-4). It is also  pos-
                     sible  to  combine ranges and (individual or
                     multiple) processor_ids (for example, 1-3  5
                     7-8 9).

     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

     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

       % psradm -F -f 1 2

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

     /etc/wtmpx    Records logging processor status changes

     See attributes(5) for descriptions of the  following  attri-

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWcsu                     |

     pbind(1M),     psrinfo(1M),     psrset(1M),     p_online(2),
     processor_bind(2), attributes(5)

     psradm: processor 4: Invalid argument

         The specified processor does not exist in the configura-

     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 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

     psradm: processor 0: Not owner

         The user does not have permission  to  change  processor

     psradm: processor 2: Operation not supported

         The specified processor is powered off, and the platform
         does not support power on of individual processors.

Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.