[832e33c] | 1 | @c |
---|
| 2 | @c COPYRIGHT (c) 1988-1998. |
---|
| 3 | @c On-Line Applications Research Corporation (OAR). |
---|
| 4 | @c All rights reserved. |
---|
| 5 | @c |
---|
| 6 | @c $Id$ |
---|
| 7 | @c |
---|
| 8 | |
---|
| 9 | @chapter Administration Interface Manager |
---|
| 10 | |
---|
| 11 | @section Introduction |
---|
| 12 | |
---|
[d1a859c] | 13 | The administration interface manager provides a portable |
---|
| 14 | interface for some system administrative functions. |
---|
| 15 | The capabilities in this manager were defined in the POSIX |
---|
| 16 | 1003.1h/D3 proposed standard titled @b{Services for Reliable, |
---|
| 17 | Available, and Serviceable Systems}. |
---|
[832e33c] | 18 | |
---|
| 19 | The directives provided by the administration interface manager are: |
---|
| 20 | |
---|
| 21 | @itemize @bullet |
---|
[b044905b] | 22 | @item @code{admin_shutdown} - Shutdown the system |
---|
[832e33c] | 23 | @end itemize |
---|
| 24 | |
---|
| 25 | @section Background |
---|
| 26 | |
---|
[d1a859c] | 27 | @subsection admin_args Structure |
---|
| 28 | |
---|
| 29 | @example |
---|
| 30 | put structure here |
---|
| 31 | @end example |
---|
| 32 | |
---|
| 33 | @table @b |
---|
| 34 | @item admin_type |
---|
| 35 | This field ... |
---|
| 36 | |
---|
| 37 | @table @b |
---|
| 38 | @item ADMIN_AUTOBOOT |
---|
| 39 | This field ... |
---|
| 40 | |
---|
| 41 | @item ADMIN_HALT |
---|
| 42 | This field ... |
---|
| 43 | |
---|
| 44 | @item ADMIN_FAST |
---|
| 45 | This field ... |
---|
| 46 | |
---|
| 47 | @item ADMIN_IMMEDIATE |
---|
| 48 | This field ... |
---|
| 49 | |
---|
| 50 | @item ADMIN_ALTSYSTEM |
---|
| 51 | This field ... |
---|
| 52 | |
---|
| 53 | @item ADMIN_ALTCONFIG |
---|
| 54 | This field ... |
---|
| 55 | |
---|
| 56 | @item ADMIN_SYSDUMP |
---|
| 57 | This field ... |
---|
| 58 | |
---|
| 59 | @item ADMIN_INIT |
---|
| 60 | This field ... |
---|
| 61 | |
---|
| 62 | |
---|
| 63 | @end table |
---|
| 64 | |
---|
| 65 | @item admin_data |
---|
| 66 | This field ... |
---|
| 67 | |
---|
| 68 | @end table |
---|
| 69 | |
---|
[832e33c] | 70 | @section Operations |
---|
| 71 | |
---|
| 72 | @section Directives |
---|
| 73 | |
---|
| 74 | This section details the administration interface manager's directives. |
---|
| 75 | A subsection is dedicated to each of this manager's directives |
---|
| 76 | and describes the calling sequence, related constants, usage, |
---|
| 77 | and status codes. |
---|
| 78 | |
---|
| 79 | @page |
---|
[b044905b] | 80 | @subsection admin_shutdown - Shutdown the system |
---|
[832e33c] | 81 | |
---|
| 82 | @subheading CALLING SEQUENCE: |
---|
| 83 | |
---|
| 84 | @ifset is-C |
---|
| 85 | @example |
---|
| 86 | int admin_shutdown( |
---|
[d1a859c] | 87 | struct admin_args *args[], |
---|
| 88 | size_t nargs |
---|
[832e33c] | 89 | ); |
---|
| 90 | @end example |
---|
| 91 | @end ifset |
---|
| 92 | |
---|
| 93 | @ifset is-Ada |
---|
| 94 | @end ifset |
---|
| 95 | |
---|
| 96 | @subheading STATUS CODES: |
---|
| 97 | |
---|
[16bed8a] | 98 | @table @b |
---|
[b044905b] | 99 | @item EINVAL |
---|
| 100 | An invalid argument was passed to the function call. |
---|
[d1a859c] | 101 | |
---|
[b044905b] | 102 | @item EPERM |
---|
| 103 | The caller does not have appropriate permission for shutting down the |
---|
| 104 | system. |
---|
[16bed8a] | 105 | |
---|
| 106 | @end table |
---|
| 107 | |
---|
[832e33c] | 108 | @subheading DESCRIPTION: |
---|
| 109 | |
---|
[d1a859c] | 110 | The @code{admin_shutdown} function restarts the system. The |
---|
| 111 | @code{args} argument specifies alternate or optional behavior |
---|
| 112 | for the @code{admin_shutdown} function. The @code{admin_type} |
---|
| 113 | member of each element of the @code{args} array specifies the |
---|
| 114 | optional behavior to be performed. There are som @code{admin_types} |
---|
| 115 | values that may provoke unspecified behavior. The @code{nargs} |
---|
| 116 | argument specifies the length of the @code{args} array. |
---|
[b044905b] | 117 | |
---|
[832e33c] | 118 | @subheading NOTES: |
---|
| 119 | |
---|
[d1a859c] | 120 | The @code{_POSIX_ADMIN} feature flag is defined to indicate |
---|
| 121 | this service is available. |
---|