unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



uadmin(2)							    uadmin(2)



NAME

  uadmin - provides administrative control

SYNOPSIS

  #include <&lt;sys/uadmin.h>&gt;


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

PARAMETERS

  cmd Specifies	the type of administrative action to be	performed on the sys-
      tem.

  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 process-
      ing. The operation to be performed next is specified by the fcn parame-
      ter.

  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 sys-
      tem.  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 speci-
  fied,	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.