psradm(1M)                                                psradm(1M)


       NAME
             psradm - processor administration

       SYNOPSIS
             psradm -a -f|n [-v]
             psradm -f|n [-v] processor_id [ . . .]

       DESCRIPTION
             The psradm command is the interface to processor configuration
             management on a multiprocessor system.  It is used by system
             administrators and operators to manage the administrative
             state of individual processors in a multiprocessor system.
             The processor_id is an integer that uniquely identifies a
             processor; one or more processors can be specified.

             Successful state transitions are recorded in the /var/adm/wtmp
             file for later system activity accounting.

             When the -n option is specified, the following message is
             written to the kernel log driver:

             UX:psradm:INFO:At MM/DD/YY HH:MM:SS, processor_id was brought on-line.

             When the -f option is specified, the following message is
             written to the kernel log driver:

             UX:psradm:INFO:At MM/DD/YY HH:MM:SS, processor_id was taken off-line.

             The message also is written to the standard output when the -v
             option is specified.

             System activity such as a system reboot or putting a processor
             on-line is recorded in the /var/adm/wtmp file.

             The options are:

             -a    Specifies that all processors are targeted for the
                   operation.

             -f    Take the specified processor(s) off-line, and make
                   unavailable for use.  This token specifies a transition
                   from an on-line or unlocked state to an off-line or
                   locked administrative state.  If the -a option is
                   specified, all on-line processors except the boot
                   processor will be taken off-line.  A processor can not
                   be taken off-line until the processor is in an idle


                           Copyright 1994 Novell, Inc.               Page 1

      psradm(1M)                                                psradm(1M)


                  usage state.

            -n    Bring the specified processor(s) on-line or all
                  processors on-line if no processor_id is specified.  -n
                  specifies a transition from a locked administrative
                  state to an unlocked administrative state.  If the -a
                  option is specified, all off-line processors will be
                  brought on-line.  The named processors must be in an
                  enabled operational state before this operation will
                  succeed.

            -v    By default, the command executes silently.  The -v
                  forces the command to report the completing status per
                  processor_id.

         Errors
            The following conditions will result in abnormal program
            termination:

                  user does not have appropriate privilege

                  processor_id specified is invalid

                  specified processor has one or more LWPs bound to it and
                  cannot be taken off-line

      EXAMPLES
            To unlock a processor, or bring it online:

                        psradm -n processor_id

            To lock a processor, or take it off-line:

                        psradm -f processor_id

      REFERENCES
            psrinfo(1M)











                          Copyright 1994 Novell, Inc.               Page 2