@c
@c  COPYRIGHT (c) 1988-1998.
@c  On-Line Applications Research Corporation (OAR).
@c  All rights reserved. 
@c
@c  $Id$
@c

@chapter Administration Interface Manager

@section Introduction

The 
administration interface manager is ...

The directives provided by the administration interface manager are:

@itemize @bullet
@item @code{admin_shutdown} - Shutdown the system
@end itemize

@section Background

@section Operations

@section Directives

This section details the administration interface manager's directives.
A subsection is dedicated to each of this manager's directives
and describes the calling sequence, related constants, usage,
and status codes.

@page
@subsection admin_shutdown - Shutdown the system

@subheading CALLING SEQUENCE:

@ifset is-C
@example
int admin_shutdown(
  struct admin_args_   *args[],
  size_t                nargs
);
@end example
@end ifset

@ifset is-Ada
@end ifset

@subheading STATUS CODES:

@table @b
@item EINVAL
An invalid argument was passed to the function call.
@item ENOSYS
The function admin_shutdown() is not supported by this implementation.
@item EPERM
The caller does not have appropriate permission for shutting down the 
system.

@end table

@subheading DESCRIPTION:


If {_POSIX_ADMIN} is defined:

   The @code{admin_shutdown} function restarts the system.  The
   @code{args} argument specifies alternate or optional behavior
   for the @code{admin_shutdown} function.  The @code{admin_type}
   member of each element of the @code{args} array specifies the
   optional behavior to be performed.  There are som @code{admin_types} 
   values that may provoke unspecified behavior.  The @code[nargs}
   argument specifies the length of the @code{args} array.

Otherwise:

   The @code{admin_shutdown} function shall fail.

@subheading NOTES: