uadmin(2)                                                            uadmin(2)



NAME
     uadmin - administrative control

SYNOPSIS
     #include <sys/uadmin.h>

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

DESCRIPTION
     uadmin provides control for basic administrative functions.  This system
     call is tightly coupled to the system administrative procedures and is
     not intended for general use.  The argument mdep is provided for
     machine-dependent use and is not defined here.

     As specified by cmd, the following commands are available:

     ASHUTDOWN     The system is shut down.  All user processes are killed,
                    the buffer cache is flushed, and the root file system (and
                    no other) is unmounted.  The action to be taken after the
                    system has been shut down is specified by fcn.  The
                    functions are generic; the hardware capabilities vary on
                    specific machines.

                    ADHALT     Halt the system.

                    ADBOOT     Reboot the system.

                    ADIBOOT    Interactive reboot; the system goes to
                                firmware mode and the user is prompted for
                                bootable program name.  Not supported; it is
                                treated the same as ADHALT.

                    ADPOWEROFF Halt the processor and turn off the power with
                                AREBOOT or ASHUTDOWN.  With ASETFLAG,
                                simply sets the flag so that a subsequent
                                ASHUTDOWN or AREBOOT also powers off.

     AREBOOT       The system stops immediately without any further
                    processing.  The action to be taken next is specified by
                    fcn as above.

     AREMOUNT      The root file system is mounted again after having been
                    fixed.  This should be used only during the startup
                    process.

     AKILLALL      All processes are killed except those belonging to the
                    process group specified by fcn.  They are sent the signal
                    specified by mdep.

     ASETFLAG      Set a flag to control later actions.  Currently
                    implemented only for ADPOWEROFF.




                                                                        Page 1

uadmin(2)                                                            uadmin(2)



     uadmin fails if any of the following are true:

     EPERM          The calling process does not have super-user privilege.

DIAGNOSTICS
     Upon successful completion, the value returned depends on cmd as follows:

          ASHUTDOWN   Never returns.
          AREBOOT     Never returns.
          AREMOUNT    0
          AKILLALL    0

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

SEE ALSO
     syssgi(2), uadmin(1).






































                                                                        Page 2