*** UNIX MANUAL PAGE BROWSER ***

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 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 im- mediately 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_RE- BOOT 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. delim off uadmin(2)