UADMIN(S) UNIX System V UADMIN(S)
Name
uadmin - administrative control
Syntax
#include <sys/uadmin.h>
int uadmin (cmd, fcn, mdep)
int cmd, fcn, mdep;
Description
The uadmin system call 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 until a
key is entered to reboot the
system.
AD_BOOT Interactive reboot; user is
prompted for system name.
AD_IBOOT Interactive reboot; user is
prompted for system name.
AD_PWRDOWN Halt the processor; system
remains down with no reboot
option given.
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.
A_SETCONFIG Sets the system configuration. Currently,
only the following function is available:
AD_PANICBOOT If mdep is 1, this function
causes the machine to reboot
automatically after a kernel
panic. If mdep is 0, this
function causes the machine
to wait for user intervention
at the console before
rebooting after a kernel
panic.
The uadmin system call fails if any of the following is
true:
[EPERM] The effective user ID is not super-user.
Diagnostics
Upon successful completion, the value returned depends on
cmd as follows:
A_SHUTDOWN No return value.
A_REBOOT No return value.
A_REMOUNT 0
A_SETCONFIG 0
Otherwise, a value of -1 is returned, and errno is set to
indicate the error.
(printed 6/20/89)