psradm(1M)

NAME

     psradm - change processor operational status

SYNOPSIS

     psradm -f | -i | -n [-v] processor_id...

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

DESCRIPTION

     The  psradm utility changes the operational status  of  pro-
     cessors.  The  legal  states  for the processor are on-line,
     off-line, and no-intr.

     An on-line processor processes LWPs (lightweight  processes)
     and may 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 may not be possible to disable interrupts for an off-line
     processor. Thus, the actual effect  of  being  off-line  may
     vary from machine to machine.

     A no-intr processor processes LWPs but is not  interruptible
     by I/O devices.

     A processor may not be taken off-line if there are LWPs 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 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 processor may be interruptible, it
     is possible to have an operational system with one processor
     no-intr and all other processors off-line but  with  one  or
     more accepting interrupts.

     If any of the specified processors are powered  off,  psradm
     may power on one or more processors.

     Only superusers 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.

     -i    Set the specified processors no-intr.

     -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 or no-intr.

           Specify processor_id as an individual processor number
           (for example, 3), multiple processor numbers separated
           by spaces (for example, 1 2 3), or a range of  proces-
           sor 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).

EXAMPLES

     Example 1: Examples of psradm.

     The following example sets processors 2 and 3 off-line.

     psradm -f 2 3

     The following example sets processors 1 and 2 no-intr.

     psradm -i 1 2

     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/wtmpx
           records logging processor status changes

ATTRIBUTES

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

     ____________________________________________________________
    |       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  confi-
           guration.

     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 service 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  plat-
           form   does not support power on of individual proces-
           sors.