blob: c38b551e96f61d65648cf078d16587919f0ca44f (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
@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 provides a portable
interface for some system administrative functions.
The capabilities in this manager are defined in the POSIX
1003.1h/D3 proposed standard titled @b{Services for Reliable,
Available, and Serviceable Systems}.
The directives provided by the administration interface manager are:
@itemize @bullet
@item @code{admin_shutdown} - Shutdown the system
@end itemize
@section Background
@subsection admin_args Structure
@example
put structure here
@end example
@table @b
@item admin_type
This field ...
@table @b
@item ADMIN_AUTOBOOT
The default, causing the system to reboot in its usual fashion. The
@code{admin_data} field points to an implementation defined string
that specifies the system image to reboot.
@item ADMIN_HALT
The system is simply halted; no reboot takes place.
@item ADMIN_FAST
The system does no send SIGTERM to active processes before halting.
@item ADMIN_IMMEDIATE
The system does not perform any of the normal shutdown procedures.
@item ADMIN_ALTSYSTEM
The system reboots using the @code{admin_data} string as a specification
of the system to be booted.
@item ADMIN_ALTCONFIG
The system reboots using the @code{admin_data} string as a specification
of the initial implicit configuration space.
@item ADMIN_SYSDUMP
Dump kernal memory before rebooting.
@item ADMIN_INIT
An option allowing the specification of an alternate initial program
to be run when the system reboots.
@end table
@item admin_data
This field ...
@end table
@section Operations
@subsection Shutting Down the System
@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
#include <admin.h>
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 EPERM
The caller does not have appropriate permission for shutting down the
system.
@end table
@subheading DESCRIPTION:
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 some @code{admin_types}
values that may provoke unspecified behavior. The @code{nargs}
argument specifies the length of the @code{args} array.
@subheading NOTES:
The @code{_POSIX_ADMIN} feature flag is defined to indicate
this service is available.
|
