uadmin(2)uadmin(2)NAMEuadmin - 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 sys‐
tem. Specifies the type of action to perform after the system is shut‐
down 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 func‐
tions. Mostly, it is called by other system administrative procedures
which must perform automatic shutdowns, halts, and reboots of the sys‐
tem. 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 values
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 informa‐
tion. 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 spec‐
ified, 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)