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 Return to PROM monitor. 

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 during the startup process. 

uadmin fails in the following case:

[EPERM] The effective user ID is not super-user. 

DIAGNOSTICS

Upon successful completion, the value returned depends on cmd as follows:

A_SHUTDOWNNever returns.
A_REBOOTNever returns.
A_REMOUNT0

Otherwise, a value of -1 is returned and errno is set to indicate the error. 

September 29, 2021