1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
7 This file is part of systemd.
9 Copyright 2010 Lennart Poettering
11 systemd is free software; you can redistribute it and/or modify it
12 under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
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 General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with systemd; If not, see <http://www.gnu.org/licenses/>.
25 typedef struct Service Service;
29 #include "ratelimit.h"
32 typedef enum ServiceState {
38 SERVICE_EXITED, /* Nothing is running anymore, but RemainAfterExit is true hence this is OK */
40 SERVICE_STOP, /* No STOP_PRE state, instead just register multiple STOP executables */
44 SERVICE_FINAL_SIGTERM, /* In case the STOP_POST executable hangs, we shoot that down, too */
45 SERVICE_FINAL_SIGKILL,
49 _SERVICE_STATE_INVALID = -1
52 typedef enum ServiceRestart {
54 SERVICE_RESTART_ON_SUCCESS,
55 SERVICE_RESTART_ON_FAILURE,
56 SERVICE_RESTART_ON_ABORT,
57 SERVICE_RESTART_ALWAYS,
59 _SERVICE_RESTART_INVALID = -1
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() */
69 _SERVICE_TYPE_INVALID = -1
72 typedef enum ServiceExecCommand {
73 SERVICE_EXEC_START_PRE,
75 SERVICE_EXEC_START_POST,
78 SERVICE_EXEC_STOP_POST,
79 _SERVICE_EXEC_COMMAND_MAX,
80 _SERVICE_EXEC_COMMAND_INVALID = -1
83 typedef enum NotifyAccess {
88 _NOTIFY_ACCESS_INVALID = -1
91 typedef enum ServiceResult {
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,
100 _SERVICE_RESULT_INVALID = -1
107 ServiceRestart restart;
109 /* If set we'll read the main daemon PID from this file */
115 dual_timestamp watchdog_timestamp;
116 usec_t watchdog_usec;
117 Watch watchdog_watch;
119 ExecCommand* exec_command[_SERVICE_EXEC_COMMAND_MAX];
120 ExecContext exec_context;
122 ServiceState state, deserialized_state;
124 /* The exit status of the real main process */
125 ExecStatus main_exec_status;
127 /* The currently executed control process */
128 ExecCommand *control_command;
130 /* The currently executed main process, which may be NULL if
131 * the main process got started via forking mode and not by
133 ExecCommand *main_command;
135 /* The ID of the control command currently being executed */
136 ServiceExecCommand control_command_id;
138 pid_t main_pid, control_pid;
143 bool permissions_start_only;
144 bool root_directory_start_only;
145 bool remain_after_exit;
148 /* If we shut down, remember why */
149 ServiceResult result;
150 ServiceResult reload_result;
152 bool main_pid_known:1;
153 bool main_pid_alien:1;
154 bool bus_name_good:1;
155 bool forbid_restart:1;
156 bool got_socket_fd:1;
157 #ifdef HAVE_SYSV_COMPAT
160 int sysv_start_priority_from_rcnd;
161 int sysv_start_priority;
164 char *sysv_runlevels;
174 UnitRef accept_socket;
177 PathSpec *pid_file_pathspec;
179 NotifyAccess notify_access;
182 extern const UnitVTable service_vtable;
186 int service_set_socket_fd(Service *s, int fd, struct Socket *socket);
188 const char* service_state_to_string(ServiceState i);
189 ServiceState service_state_from_string(const char *s);
191 const char* service_restart_to_string(ServiceRestart i);
192 ServiceRestart service_restart_from_string(const char *s);
194 const char* service_type_to_string(ServiceType i);
195 ServiceType service_type_from_string(const char *s);
197 const char* service_exec_command_to_string(ServiceExecCommand i);
198 ServiceExecCommand service_exec_command_from_string(const char *s);
200 const char* notify_access_to_string(NotifyAccess i);
201 NotifyAccess notify_access_from_string(const char *s);
203 const char* service_result_to_string(ServiceResult i);
204 ServiceResult service_result_from_string(const char *s);