UADMIN(2) UADMIN(2)
NAME
uadmin - administrative control
SYNOPSIS
#include <sys/uadmin.h>
int uadmin (cmd, fcn, mdep)
int cmd, fcn, 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:
A_SHUTDOWN The system is shutdown. All user processes
are killed, the buffer cache is flushed, and
the root file system 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.
AD_HALT Halt the processor and turn off
the power.
AD_BOOT Reboot the system, using /unix.
AD_IBOOT Interactive reboot; user is
prompted for system name.
A_REBOOT The system stops immediately without any
further processing. The action to be taken
next is specified by fcn as above.
A_REMOUNT The root file system is mounted again after
having been fixed. This should be used only
Page 1 May 1989
UADMIN(2) UADMIN(2)
during the startup process.
uadmin fails if any of the following are true:
[EPERM] The effective user ID is not super-user.
DIAGNOSTICS
Upon successful completion, the value returned depends on
cmd as follows:
A_SHUTDOWN Never returns.
A_REBOOT Never returns.
A_REMOUNT 0
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
Page 2 May 1989