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)