uadmin(2) System Calls Manual uadmin(2)
NAME
uadmin - provides administrative control
SYNOPSIS
#include <sys/uadmin.h>
int uadmin(
int cmd,
int fcn,
int mdep );
PARAMETERS
Specifies the type of administrative action to be performed on the system. Specifies the type of action to perform after the system is
shutdown or stopped using A_SHUTDOWN or A_REBOOT.
The available actions are AD_HALT, AD_BOOT, or AD_IBOOT. These are described in more detail below. Specifies machine-dependent
use. It is currently not used and is ignored if defined.
DESCRIPTION
The uadmin function enables control of some basic administrative functions. Mostly, it is called by other system administrative procedures
which must perform automatic shutdowns, halts, and reboots of the system. Using this function as a general interface is not recommended.
To perform a shutdown, halt, or reboot of the system, you must use the cmd parameter which specifies the function to be performed. The val-
ues for the cmd parameter are as follows: Signals that the system stop immediately without any further processing. The operation to be per-
formed next is specified by the fcn parameter. Specifies a remount of the root file system after errors have been resolved. This command
should only be used during the startup process. For this release, this command is unsupported. See the RESTRICTIONS section for more
information. Specifies a systematic shutdown of the system by terminating all user processes, flushing the buffer cache, and unmounting
the root file system. The operation to be performed next must be specified by the fcn parameter.
The fcn parameter specifies the operation that is to be performed after the system has been shutdown or rebooted using the A_SHUTDOWN or
A_REBOOT commands. The fcn parameter has the following values: Halts the processor. The machine is then in a state where power can be
turned off. Reboots the system in standalone mode using the default kernel. Reboots the system in interactive mode. You must provide the
kernel name upon a reboot of the machine.
RESTRICTIONS
Specifying A_REMOUNT is not supported for this release. If it is specified, a value of -1 is returned and errno is set to ENOSYS.
RETURN VALUES
On success, specifying either A_SHUTDOWN or A_REBOOT does not return a value. Specifying A_REMOUNT returns zero (0) on success.
On error, a value of -1 is returned and errno is set to indicate error.
ERRORS
Indicates that a command was specified that is invalid.
uadmin(2)
