uadmin(2) SDK R4.11 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
The calling process must have appropriate privilege to halt the
system processor(s). For systems supporting the DG/UX Capability
Option, appropriate privilege is defined as having one or more
specific capabilities enabled in the effective capability set of the
calling process. See capdefaults(5) for the default capability for
this system call.
On systems without the DG/UX Capability Option, appropriate privilege
means that the process has an effective UID of root. See the
appropriateprivilege(5) man page for more information.
RETURN VALUE
If successful, this call never returns. Otherwise, a -1 is returned
and errno is set to indicate the error.
DIAGNOSTICS
EPERM The calling process does not have appropriate
privilege.
SEE ALSO
dgsysctl(2), appropriateprivilege(5).
capdefaults(5).
Licensed material--property of copyright holder(s)