psradm(8) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

psradm(8)

psradm(8)               System Administration Commands               psradm(8)

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 processors. 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 processor  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 monitors the be‐
       havior 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 de‐
       vices.


       A processor can not be taken off-line or made spare if there  are  LWPs
       that  are  bound  to  the  processor unless the additional -F option is
       used. The -F option removes processor  bindings  of  such  LWPs  before
       changing  the processor's operational status. On some architectures, it
       might not be possible to take certain processors off-line or spare  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 interrupted. Since an off-
       line or spare processor can be interruptible, 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.

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 processors  was  in  the  faulted
             state. Set the specified processors to faulted, if no other tran‐
             sition  option was specified. Forced transitions can only be made
             to faulted, spare, or off-line states. Administrators are encour‐
             aged to use the -Q option for pbind(8) to find out which  threads
             will be affected by forced a processor 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.


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 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 com‐
                       bine ranges and (individual or multiple)  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


       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 changes


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/core-os


SEE ALSO
       processor_bind(2), p_online(2),  attributes(7),  pbind(8),  psrinfo(8),
       psrset(8)

DIAGNOSTICS
       psradm: processor 4: Invalid argument

           The specified processor does not exist in the configuration.


       psradm: processor 3: Device busy

           The  specified processor could not be taken off-line because it ei‐
           ther has LWPs bound to it, is the last  on-line  processor  in  the
           system,  or is needed by the system because it provides some essen‐
           tial 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: Insufficient privileges

           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.


Oracle Solaris 11.4             18 August 2020                       psradm(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3