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,
99 _SERVICE_RESULT_INVALID = -1
106 ServiceRestart restart;
108 /* If set we'll read the main daemon PID from this file */
114 dual_timestamp watchdog_timestamp;
116 ExecCommand* exec_command[_SERVICE_EXEC_COMMAND_MAX];
117 ExecContext exec_context;
119 ServiceState state, deserialized_state;
121 /* The exit status of the real main process */
122 ExecStatus main_exec_status;
124 /* The currently executed control process */
125 ExecCommand *control_command;
127 /* The currently executed main process, which may be NULL if
128 * the main process got started via forking mode and not by
130 ExecCommand *main_command;
132 /* The ID of the control command currently being executed */
133 ServiceExecCommand control_command_id;
135 pid_t main_pid, control_pid;
140 bool permissions_start_only;
141 bool root_directory_start_only;
142 bool remain_after_exit;
145 /* If we shut down, remember why */
146 ServiceResult result;
147 ServiceResult reload_result;
149 bool main_pid_known:1;
150 bool main_pid_alien:1;
151 bool bus_name_good:1;
152 bool forbid_restart:1;
153 bool got_socket_fd:1;
154 #ifdef HAVE_SYSV_COMPAT
157 int sysv_start_priority_from_rcnd;
158 int sysv_start_priority;
161 char *sysv_runlevels;
171 UnitRef accept_socket;
174 PathSpec *pid_file_pathspec;
176 NotifyAccess notify_access;
179 extern const UnitVTable service_vtable;
183 int service_set_socket_fd(Service *s, int fd, struct Socket *socket);
185 const char* service_state_to_string(ServiceState i);
186 ServiceState service_state_from_string(const char *s);
188 const char* service_restart_to_string(ServiceRestart i);
189 ServiceRestart service_restart_from_string(const char *s);
191 const char* service_type_to_string(ServiceType i);
192 ServiceType service_type_from_string(const char *s);
194 const char* service_exec_command_to_string(ServiceExecCommand i);
195 ServiceExecCommand service_exec_command_from_string(const char *s);
197 const char* notify_access_to_string(NotifyAccess i);
198 NotifyAccess notify_access_from_string(const char *s);
200 const char* service_result_to_string(ServiceResult i);
201 ServiceResult service_result_from_string(const char *s);