uadmin(2) — DG/UX 5.4R3.00



uadmin(2)                      DG/UX 5.4R3.00                      uadmin(2)


NAME
       uadmin - request administrative shutdown and reboot options

SYNOPSIS
       #include <sys/uadmin.h>

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

   where:
       cmd    is ASHUTDOWN or AREBOOT
       fcn    is ADHALT, ADBOOT, or ADIBOOT
       mdep   is provided for machine-dependent use: undefined at present.

DESCRIPTION
       Use uadmin to request system shutdown and reboot options.  Note: this
       system call is provided for the system administrator; it is not
       intended for general use.

       Valid values for cmd are:

       ASHUTDOWN     Shut down the system; kill all user processes, flush
                      the buffer cache, and perform the action(s) specified
                      by fcn.

       AREBOOT       Stop the system immediately without any further
                      processing, and perform the action(s) specified by
                      fcn.

       Valid values for fcn are:

       ADHALT        Halt the processor(s).

       ADBOOT        Reboot the system, using the same boot flags as the
                      last time it was booted.

       ADIBOOT       The same as ADHALT.  Return control to the system
                      control monitor, allowing the user to specify a new
                      boot path.

ACCESS CONTROL
       Only the superuser may halt the system processor(s).

RETURN VALUE
       If successful, this call never returns.  Otherwise, a -1 is returned
       and errno is set to indicate the error.

DIAGNOSTICS
       EPERM          The effective user ID is not superuser.

SEE ALSO
       dgsysctl(2).






Licensed material--property of copyright holder(s)                         1
Museum
