UADMIN(2-SysV) RISC/os Reference Manual UADMIN(2-SysV)
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 adminis-
trative 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 hav-
ing 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.
Printed 1/15/91 Page 1
UADMIN(2-SysV) RISC/os Reference Manual UADMIN(2-SysV)
A_REMOUNT 0
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
Page 2 Printed 1/15/91