Index for Section 2

Alphabetical listing for U

Bottom of page

uadmin(2)
NAME
  uadmin - provides administrative control

SYNOPSIS
  #include <sys/uadmin.h>

  int uadmin(
	  int cmd,
	  int fcn,
	  int mdep );

PARAMETERS
  cmd Specifies the type of administrative action to be performed on the
      system.

  fcn 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.

  mdep
      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:

  A_REBOOT
      Signals that the system stop immediately without any further
      processing. The operation to be performed next is specified by the fcn
      parameter.

  A_REMOUNT
      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.

  A_SHUTDOWN
      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:

  AD_HALT
      Halts the processor.  The machine is then in a state where power can be
      turned off.

  AD_BOOT
      Reboots the system in standalone mode using the default kernel.

  AD_IBOOT
      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
  [ENOSYS]
      Indicates that a command was specified that is invalid.

Index for Section 2

Alphabetical listing for U

Top of page