Content-type: text/html Man page of uadmin

uadmin

Section: System Calls (2)
Index Return to Main Contents
 

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 values for the cmd parameter are as follows: Signals that the system stop immediately without any further processing. The operation to be performed 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.


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RESTRICTIONS
RETURN VALUES
ERRORS

This document was created by man2html, using the manual pages.
Time: 02:40:16 GMT, October 02, 2010