psradm

 

---

 
 
 
 Maintenance Commands                                   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.
 
 
 
 
 SunOS 5.8           Last change: 10 Dec 1998                    1
 
 
 
 
 
 
 Maintenance Commands                                   psradm(1M)
 
 
 
      -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:
 
 
 
 
 
 SunOS 5.8           Last change: 10 Dec 1998                    2
 
 
 
 
 
 
 Maintenance Commands                                   psradm(1M)
 
 
 
      ____________________________________________________________
     |       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.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 10 Dec 1998                    3
 
 
 

---