]>
Commit | Line | Data |
---|---|---|
1 | /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/ | |
2 | ||
3 | #ifndef fooservicehfoo | |
4 | #define fooservicehfoo | |
5 | ||
6 | /*** | |
7 | This file is part of systemd. | |
8 | ||
9 | Copyright 2010 Lennart Poettering | |
10 | ||
11 | systemd is free software; you can redistribute it and/or modify it | |
12 | under the terms of the GNU Lesser General Public License as published by | |
13 | the Free Software Foundation; either version 2.1 of the License, or | |
14 | (at your option) any later version. | |
15 | ||
16 | systemd is distributed in the hope that it will be useful, but | |
17 | WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
19 | Lesser General Public License for more details. | |
20 | ||
21 | You should have received a copy of the GNU Lesser General Public License | |
22 | along with systemd; If not, see <http://www.gnu.org/licenses/>. | |
23 | ***/ | |
24 | ||
25 | typedef struct Service Service; | |
26 | ||
27 | #include "unit.h" | |
28 | #include "path.h" | |
29 | #include "ratelimit.h" | |
30 | #include "service.h" | |
31 | ||
32 | typedef enum ServiceState { | |
33 | SERVICE_DEAD, | |
34 | SERVICE_START_PRE, | |
35 | SERVICE_START, | |
36 | SERVICE_START_POST, | |
37 | SERVICE_RUNNING, | |
38 | SERVICE_EXITED, /* Nothing is running anymore, but RemainAfterExit is true hence this is OK */ | |
39 | SERVICE_RELOAD, | |
40 | SERVICE_STOP, /* No STOP_PRE state, instead just register multiple STOP executables */ | |
41 | SERVICE_STOP_SIGTERM, | |
42 | SERVICE_STOP_SIGKILL, | |
43 | SERVICE_STOP_POST, | |
44 | SERVICE_FINAL_SIGTERM, /* In case the STOP_POST executable hangs, we shoot that down, too */ | |
45 | SERVICE_FINAL_SIGKILL, | |
46 | SERVICE_FAILED, | |
47 | SERVICE_AUTO_RESTART, | |
48 | _SERVICE_STATE_MAX, | |
49 | _SERVICE_STATE_INVALID = -1 | |
50 | } ServiceState; | |
51 | ||
52 | typedef enum ServiceRestart { | |
53 | SERVICE_RESTART_NO, | |
54 | SERVICE_RESTART_ON_SUCCESS, | |
55 | SERVICE_RESTART_ON_FAILURE, | |
56 | SERVICE_RESTART_ON_ABORT, | |
57 | SERVICE_RESTART_ALWAYS, | |
58 | _SERVICE_RESTART_MAX, | |
59 | _SERVICE_RESTART_INVALID = -1 | |
60 | } ServiceRestart; | |
61 | ||
62 | typedef enum ServiceType { | |
63 | SERVICE_SIMPLE, /* we fork and go on right-away (i.e. modern socket activated daemons) */ | |
64 | SERVICE_FORKING, /* forks by itself (i.e. traditional daemons) */ | |
65 | SERVICE_ONESHOT, /* we fork and wait until the program finishes (i.e. programs like fsck which run and need to finish before we continue) */ | |
66 | SERVICE_DBUS, /* we fork and wait until a specific D-Bus name appears on the bus */ | |
67 | SERVICE_NOTIFY, /* we fork and wait until a daemon sends us a ready message with sd_notify() */ | |
68 | _SERVICE_TYPE_MAX, | |
69 | _SERVICE_TYPE_INVALID = -1 | |
70 | } ServiceType; | |
71 | ||
72 | typedef enum ServiceExecCommand { | |
73 | SERVICE_EXEC_START_PRE, | |
74 | SERVICE_EXEC_START, | |
75 | SERVICE_EXEC_START_POST, | |
76 | SERVICE_EXEC_RELOAD, | |
77 | SERVICE_EXEC_STOP, | |
78 | SERVICE_EXEC_STOP_POST, | |
79 | _SERVICE_EXEC_COMMAND_MAX, | |
80 | _SERVICE_EXEC_COMMAND_INVALID = -1 | |
81 | } ServiceExecCommand; | |
82 | ||
83 | typedef enum NotifyAccess { | |
84 | NOTIFY_NONE, | |
85 | NOTIFY_ALL, | |
86 | NOTIFY_MAIN, | |
87 | _NOTIFY_ACCESS_MAX, | |
88 | _NOTIFY_ACCESS_INVALID = -1 | |
89 | } NotifyAccess; | |
90 | ||
91 | typedef enum ServiceResult { | |
92 | SERVICE_SUCCESS, | |
93 | SERVICE_FAILURE_RESOURCES, | |
94 | SERVICE_FAILURE_TIMEOUT, | |
95 | SERVICE_FAILURE_EXIT_CODE, | |
96 | SERVICE_FAILURE_SIGNAL, | |
97 | SERVICE_FAILURE_CORE_DUMP, | |
98 | SERVICE_FAILURE_WATCHDOG, | |
99 | _SERVICE_RESULT_MAX, | |
100 | _SERVICE_RESULT_INVALID = -1 | |
101 | } ServiceResult; | |
102 | ||
103 | typedef enum StartLimitAction { | |
104 | SERVICE_START_LIMIT_NONE, | |
105 | SERVICE_START_LIMIT_REBOOT, | |
106 | SERVICE_START_LIMIT_REBOOT_FORCE, | |
107 | SERVICE_START_LIMIT_REBOOT_IMMEDIATE, | |
108 | _SERVICE_START_LIMIT_MAX, | |
109 | _SERVICE_START_LIMIT_INVALID = -1 | |
110 | } StartLimitAction; | |
111 | ||
112 | struct Service { | |
113 | Unit meta; | |
114 | ||
115 | ServiceType type; | |
116 | ServiceRestart restart; | |
117 | ||
118 | /* If set we'll read the main daemon PID from this file */ | |
119 | char *pid_file; | |
120 | ||
121 | usec_t restart_usec; | |
122 | usec_t timeout_usec; | |
123 | ||
124 | dual_timestamp watchdog_timestamp; | |
125 | usec_t watchdog_usec; | |
126 | Watch watchdog_watch; | |
127 | ||
128 | ExecCommand* exec_command[_SERVICE_EXEC_COMMAND_MAX]; | |
129 | ExecContext exec_context; | |
130 | ||
131 | ServiceState state, deserialized_state; | |
132 | ||
133 | /* The exit status of the real main process */ | |
134 | ExecStatus main_exec_status; | |
135 | ||
136 | /* The currently executed control process */ | |
137 | ExecCommand *control_command; | |
138 | ||
139 | /* The currently executed main process, which may be NULL if | |
140 | * the main process got started via forking mode and not by | |
141 | * us */ | |
142 | ExecCommand *main_command; | |
143 | ||
144 | /* The ID of the control command currently being executed */ | |
145 | ServiceExecCommand control_command_id; | |
146 | ||
147 | pid_t main_pid, control_pid; | |
148 | int socket_fd; | |
149 | ||
150 | int fsck_passno; | |
151 | ||
152 | bool permissions_start_only; | |
153 | bool root_directory_start_only; | |
154 | bool remain_after_exit; | |
155 | bool guess_main_pid; | |
156 | ||
157 | /* If we shut down, remember why */ | |
158 | ServiceResult result; | |
159 | ServiceResult reload_result; | |
160 | ||
161 | bool main_pid_known:1; | |
162 | bool main_pid_alien:1; | |
163 | bool bus_name_good:1; | |
164 | bool forbid_restart:1; | |
165 | bool got_socket_fd:1; | |
166 | #ifdef HAVE_SYSV_COMPAT | |
167 | bool sysv_has_lsb:1; | |
168 | bool sysv_enabled:1; | |
169 | int sysv_start_priority_from_rcnd; | |
170 | int sysv_start_priority; | |
171 | ||
172 | char *sysv_path; | |
173 | char *sysv_runlevels; | |
174 | usec_t sysv_mtime; | |
175 | #endif | |
176 | ||
177 | char *bus_name; | |
178 | ||
179 | char *status_text; | |
180 | ||
181 | RateLimit start_limit; | |
182 | StartLimitAction start_limit_action; | |
183 | ||
184 | ||
185 | UnitRef accept_socket; | |
186 | ||
187 | Watch timer_watch; | |
188 | PathSpec *pid_file_pathspec; | |
189 | ||
190 | NotifyAccess notify_access; | |
191 | }; | |
192 | ||
193 | extern const UnitVTable service_vtable; | |
194 | ||
195 | struct Socket; | |
196 | ||
197 | int service_set_socket_fd(Service *s, int fd, struct Socket *socket); | |
198 | ||
199 | const char* service_state_to_string(ServiceState i); | |
200 | ServiceState service_state_from_string(const char *s); | |
201 | ||
202 | const char* service_restart_to_string(ServiceRestart i); | |
203 | ServiceRestart service_restart_from_string(const char *s); | |
204 | ||
205 | const char* service_type_to_string(ServiceType i); | |
206 | ServiceType service_type_from_string(const char *s); | |
207 | ||
208 | const char* service_exec_command_to_string(ServiceExecCommand i); | |
209 | ServiceExecCommand service_exec_command_from_string(const char *s); | |
210 | ||
211 | const char* notify_access_to_string(NotifyAccess i); | |
212 | NotifyAccess notify_access_from_string(const char *s); | |
213 | ||
214 | const char* service_result_to_string(ServiceResult i); | |
215 | ServiceResult service_result_from_string(const char *s); | |
216 | ||
217 | const char* start_limit_action_to_string(StartLimitAction i); | |
218 | StartLimitAction start_limit_action_from_string(const char *s); | |
219 | ||
220 | #endif |