UADMIN(2) SysV 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 the file /sauN/domain_os
(N is an integer identifying a directory
containing stand-alone utilities compatible with
specific models of workstations).
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 during the startup process.
ERRORS
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.