NAME    [Toc]    [Back]

       uadmin - provides administrative control

SYNOPSIS    [Toc]    [Back]

       #include <sys/uadmin.h>

       int uadmin(
               int cmd,
               int fcn,
               int mdep );

PARAMETERS    [Toc]    [Back]

       Specifies  the  type  of  administrative action to be performed
 on the system.  Specifies the  type  of  action  to
       perform  after  the  system  is  shutdown or stopped using
       A_SHUTDOWN or A_REBOOT.

              The available  actions  are  AD_HALT,  AD_BOOT,  or
              AD_IBOOT.   These  are  described  in  more  detail
              below.  Specifies machine-dependent use. It is currently
 not used and is ignored if defined.

DESCRIPTION    [Toc]    [Back]

       The uadmin function enables control of some basic administrative
 functions.  Mostly, it is called by  other  system
       administrative  procedures  which  must  perform automatic
       shutdowns, halts, and reboots of the system.   Using  this
       function as a general interface is not recommended.

       To  perform a shutdown, halt, or reboot of the system, you
       must use the cmd parameter which specifies the function to
       be performed. The values for the cmd parameter are as follows:
 Signals that the system stop immediately without any
       further  processing. The operation to be performed next is
       specified by the fcn parameter.  Specifies  a  remount  of
       the  root  file  system  after  errors have been resolved.
       This command should only be used during the  startup  process.
  For this release, this command is unsupported.  See
       the RESTRICTIONS section for more information.   Specifies
       a  systematic  shutdown  of  the system by terminating all
       user processes, flushing the buffer cache, and  unmounting
       the  root file system.  The operation to be performed next
       must be specified by the fcn parameter.

       The fcn parameter specifies the operation that  is  to  be
       performed  after  the system has been shutdown or rebooted
       using the A_SHUTDOWN or A_REBOOT commands.  The fcn parameter
  has  the following values: Halts the processor.  The
       machine is then in a state where power can be turned  off.
       Reboots  the  system  in standalone mode using the default
       kernel.  Reboots the system in interactive mode.  You must
       provide the kernel name upon a reboot of the machine.

RESTRICTIONS    [Toc]    [Back]

       Specifying  A_REMOUNT  is  not supported for this release.
       If it is specified, a value of -1 is returned and errno is
       set to ENOSYS.

RETURN VALUES    [Toc]    [Back]

       On  success, specifying either A_SHUTDOWN or A_REBOOT does
       not return a value.  Specifying A_REMOUNT returns zero (0)
       on success.

       On  error,  a  value of -1 is returned and errno is set to
       indicate error.

ERRORS    [Toc]    [Back]

       Indicates that a command was specified that is invalid.



                                                        uadmin(2)