1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
4 This file is part of systemd.
6 Copyright 2010 Lennart Poettering
8 systemd is free software; you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as published by
10 the Free Software Foundation; either version 2.1 of the License, or
11 (at your option) any later version.
13 systemd is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with systemd; If not, see <http://www.gnu.org/licenses/>.
31 #include "load-fragment.h"
32 #include "load-dropin.h"
35 #include "unit-name.h"
36 #include "unit-printf.h"
37 #include "dbus-service.h"
39 #include "exit-status.h"
41 #include "path-util.h"
46 #include "bus-error.h"
48 #include "bus-kernel.h"
50 static const UnitActiveState state_translation_table[_SERVICE_STATE_MAX] = {
51 [SERVICE_DEAD] = UNIT_INACTIVE,
52 [SERVICE_START_PRE] = UNIT_ACTIVATING,
53 [SERVICE_START] = UNIT_ACTIVATING,
54 [SERVICE_START_POST] = UNIT_ACTIVATING,
55 [SERVICE_RUNNING] = UNIT_ACTIVE,
56 [SERVICE_EXITED] = UNIT_ACTIVE,
57 [SERVICE_RELOAD] = UNIT_RELOADING,
58 [SERVICE_STOP] = UNIT_DEACTIVATING,
59 [SERVICE_STOP_SIGTERM] = UNIT_DEACTIVATING,
60 [SERVICE_STOP_SIGKILL] = UNIT_DEACTIVATING,
61 [SERVICE_STOP_POST] = UNIT_DEACTIVATING,
62 [SERVICE_FINAL_SIGTERM] = UNIT_DEACTIVATING,
63 [SERVICE_FINAL_SIGKILL] = UNIT_DEACTIVATING,
64 [SERVICE_FAILED] = UNIT_FAILED,
65 [SERVICE_AUTO_RESTART] = UNIT_ACTIVATING
68 /* For Type=idle we never want to delay any other jobs, hence we
69 * consider idle jobs active as soon as we start working on them */
70 static const UnitActiveState state_translation_table_idle[_SERVICE_STATE_MAX] = {
71 [SERVICE_DEAD] = UNIT_INACTIVE,
72 [SERVICE_START_PRE] = UNIT_ACTIVE,
73 [SERVICE_START] = UNIT_ACTIVE,
74 [SERVICE_START_POST] = UNIT_ACTIVE,
75 [SERVICE_RUNNING] = UNIT_ACTIVE,
76 [SERVICE_EXITED] = UNIT_ACTIVE,
77 [SERVICE_RELOAD] = UNIT_RELOADING,
78 [SERVICE_STOP] = UNIT_DEACTIVATING,
79 [SERVICE_STOP_SIGTERM] = UNIT_DEACTIVATING,
80 [SERVICE_STOP_SIGKILL] = UNIT_DEACTIVATING,
81 [SERVICE_STOP_POST] = UNIT_DEACTIVATING,
82 [SERVICE_FINAL_SIGTERM] = UNIT_DEACTIVATING,
83 [SERVICE_FINAL_SIGKILL] = UNIT_DEACTIVATING,
84 [SERVICE_FAILED] = UNIT_FAILED,
85 [SERVICE_AUTO_RESTART] = UNIT_ACTIVATING
88 static int service_dispatch_io(sd_event_source *source, int fd, uint32_t events, void *userdata);
89 static int service_dispatch_timer(sd_event_source *source, usec_t usec, void *userdata);
90 static int service_dispatch_watchdog(sd_event_source *source, usec_t usec, void *userdata);
92 static void service_enter_signal(Service *s, ServiceState state, ServiceResult f);
93 static void service_enter_reload_by_notify(Service *s);
95 static void service_init(Unit *u) {
96 Service *s = SERVICE(u);
99 assert(u->load_state == UNIT_STUB);
101 s->timeout_start_usec = u->manager->default_timeout_start_usec;
102 s->timeout_stop_usec = u->manager->default_timeout_stop_usec;
103 s->restart_usec = u->manager->default_restart_usec;
104 s->type = _SERVICE_TYPE_INVALID;
106 s->bus_endpoint_fd = -1;
107 s->guess_main_pid = true;
109 RATELIMIT_INIT(s->start_limit, u->manager->default_start_limit_interval, u->manager->default_start_limit_burst);
111 s->control_command_id = _SERVICE_EXEC_COMMAND_INVALID;
114 static void service_unwatch_control_pid(Service *s) {
117 if (s->control_pid <= 0)
120 unit_unwatch_pid(UNIT(s), s->control_pid);
124 static void service_unwatch_main_pid(Service *s) {
127 if (s->main_pid <= 0)
130 unit_unwatch_pid(UNIT(s), s->main_pid);
134 static void service_unwatch_pid_file(Service *s) {
135 if (!s->pid_file_pathspec)
138 log_debug_unit(UNIT(s)->id, "Stopping watch for %s's PID file %s", UNIT(s)->id, s->pid_file_pathspec->path);
139 path_spec_unwatch(s->pid_file_pathspec);
140 path_spec_done(s->pid_file_pathspec);
141 free(s->pid_file_pathspec);
142 s->pid_file_pathspec = NULL;
145 static int service_set_main_pid(Service *s, pid_t pid) {
156 if (s->main_pid == pid && s->main_pid_known)
159 if (s->main_pid != pid) {
160 service_unwatch_main_pid(s);
161 exec_status_start(&s->main_exec_status, pid);
165 s->main_pid_known = true;
167 if (get_parent_of_pid(pid, &ppid) >= 0 && ppid != getpid()) {
168 log_warning_unit(UNIT(s)->id, "%s: Supervising process "PID_FMT" which is not our child. We'll most likely not notice when it exits.", UNIT(s)->id, pid);
169 s->main_pid_alien = true;
171 s->main_pid_alien = false;
176 static void service_close_socket_fd(Service *s) {
179 s->socket_fd = asynchronous_close(s->socket_fd);
182 static void service_connection_unref(Service *s) {
185 if (!UNIT_ISSET(s->accept_socket))
188 socket_connection_unref(SOCKET(UNIT_DEREF(s->accept_socket)));
189 unit_ref_unset(&s->accept_socket);
192 static void service_stop_watchdog(Service *s) {
195 s->watchdog_event_source = sd_event_source_unref(s->watchdog_event_source);
196 s->watchdog_timestamp = DUAL_TIMESTAMP_NULL;
199 static void service_start_watchdog(Service *s) {
204 if (s->watchdog_usec <= 0)
207 if (s->watchdog_event_source) {
208 r = sd_event_source_set_time(s->watchdog_event_source, s->watchdog_timestamp.monotonic + s->watchdog_usec);
210 log_warning_unit(UNIT(s)->id, "%s failed to reset watchdog timer: %s", UNIT(s)->id, strerror(-r));
214 r = sd_event_source_set_enabled(s->watchdog_event_source, SD_EVENT_ONESHOT);
216 r = sd_event_add_time(
217 UNIT(s)->manager->event,
218 &s->watchdog_event_source,
220 s->watchdog_timestamp.monotonic + s->watchdog_usec, 0,
221 service_dispatch_watchdog, s);
223 log_warning_unit(UNIT(s)->id, "%s failed to add watchdog timer: %s", UNIT(s)->id, strerror(-r));
227 /* Let's process everything else which might be a sign
228 * of living before we consider a service died. */
229 r = sd_event_source_set_priority(s->watchdog_event_source, SD_EVENT_PRIORITY_IDLE);
233 log_warning_unit(UNIT(s)->id, "%s failed to install watchdog timer: %s", UNIT(s)->id, strerror(-r));
236 static void service_reset_watchdog(Service *s) {
239 dual_timestamp_get(&s->watchdog_timestamp);
240 service_start_watchdog(s);
243 static void service_done(Unit *u) {
244 Service *s = SERVICE(u);
251 free(s->status_text);
252 s->status_text = NULL;
255 s->reboot_arg = NULL;
257 s->exec_runtime = exec_runtime_unref(s->exec_runtime);
258 exec_command_free_array(s->exec_command, _SERVICE_EXEC_COMMAND_MAX);
259 s->control_command = NULL;
260 s->main_command = NULL;
262 exit_status_set_free(&s->restart_prevent_status);
263 exit_status_set_free(&s->restart_force_status);
264 exit_status_set_free(&s->success_status);
266 /* This will leak a process, but at least no memory or any of
268 service_unwatch_main_pid(s);
269 service_unwatch_control_pid(s);
270 service_unwatch_pid_file(s);
273 unit_unwatch_bus_name(u, s->bus_name);
278 s->bus_endpoint_fd = safe_close(s->bus_endpoint_fd);
279 service_close_socket_fd(s);
280 service_connection_unref(s);
282 unit_ref_unset(&s->accept_socket);
284 service_stop_watchdog(s);
286 s->timer_event_source = sd_event_source_unref(s->timer_event_source);
289 static int service_arm_timer(Service *s, usec_t usec) {
294 if (s->timer_event_source) {
295 r = sd_event_source_set_time(s->timer_event_source, now(CLOCK_MONOTONIC) + usec);
299 return sd_event_source_set_enabled(s->timer_event_source, SD_EVENT_ONESHOT);
302 return sd_event_add_time(
303 UNIT(s)->manager->event,
304 &s->timer_event_source,
306 now(CLOCK_MONOTONIC) + usec, 0,
307 service_dispatch_timer, s);
310 static int service_verify(Service *s) {
313 if (UNIT(s)->load_state != UNIT_LOADED)
316 if (!s->exec_command[SERVICE_EXEC_START] && !s->exec_command[SERVICE_EXEC_STOP]) {
317 log_error_unit(UNIT(s)->id, "%s lacks both ExecStart= and ExecStop= setting. Refusing.", UNIT(s)->id);
321 if (s->type != SERVICE_ONESHOT && !s->exec_command[SERVICE_EXEC_START]) {
322 log_error_unit(UNIT(s)->id, "%s has no ExecStart= setting, which is only allowed for Type=oneshot services. Refusing.", UNIT(s)->id);
326 if (!s->remain_after_exit && !s->exec_command[SERVICE_EXEC_START]) {
327 log_error_unit(UNIT(s)->id, "%s has no ExecStart= setting, which is only allowed for RemainAfterExit=yes services. Refusing.", UNIT(s)->id);
331 if (s->type != SERVICE_ONESHOT && s->exec_command[SERVICE_EXEC_START]->command_next) {
332 log_error_unit(UNIT(s)->id, "%s has more than one ExecStart= setting, which is only allowed for Type=oneshot services. Refusing.", UNIT(s)->id);
336 if (s->type == SERVICE_ONESHOT && s->restart != SERVICE_RESTART_NO) {
337 log_error_unit(UNIT(s)->id, "%s has Restart= setting other than no, which isn't allowed for Type=oneshot services. Refusing.", UNIT(s)->id);
341 if (s->type == SERVICE_ONESHOT && !exit_status_set_is_empty(&s->restart_force_status)) {
342 log_error_unit(UNIT(s)->id, "%s has RestartForceStatus= set, which isn't allowed for Type=oneshot services. Refusing.", UNIT(s)->id);
346 if (s->type == SERVICE_DBUS && !s->bus_name) {
347 log_error_unit(UNIT(s)->id, "%s is of type D-Bus but no D-Bus service name has been specified. Refusing.", UNIT(s)->id);
351 if (s->bus_name && s->type != SERVICE_DBUS)
352 log_warning_unit(UNIT(s)->id, "%s has a D-Bus service name specified, but is not of type dbus. Ignoring.", UNIT(s)->id);
354 if (s->exec_context.pam_name && !(s->kill_context.kill_mode == KILL_CONTROL_GROUP || s->kill_context.kill_mode == KILL_MIXED)) {
355 log_error_unit(UNIT(s)->id, "%s has PAM enabled. Kill mode must be set to 'control-group' or 'mixed'. Refusing.", UNIT(s)->id);
362 static int service_add_default_dependencies(Service *s) {
367 /* Add a number of automatic dependencies useful for the
368 * majority of services. */
370 /* First, pull in base system */
371 r = unit_add_two_dependencies_by_name(UNIT(s), UNIT_AFTER, UNIT_REQUIRES, SPECIAL_BASIC_TARGET, NULL, true);
375 /* Second, activate normal shutdown */
376 r = unit_add_two_dependencies_by_name(UNIT(s), UNIT_BEFORE, UNIT_CONFLICTS, SPECIAL_SHUTDOWN_TARGET, NULL, true);
380 static void service_fix_output(Service *s) {
383 /* If nothing has been explicitly configured, patch default
384 * output in. If input is socket/tty we avoid this however,
385 * since in that case we want output to default to the same
386 * place as we read input from. */
388 if (s->exec_context.std_error == EXEC_OUTPUT_INHERIT &&
389 s->exec_context.std_output == EXEC_OUTPUT_INHERIT &&
390 s->exec_context.std_input == EXEC_INPUT_NULL)
391 s->exec_context.std_error = UNIT(s)->manager->default_std_error;
393 if (s->exec_context.std_output == EXEC_OUTPUT_INHERIT &&
394 s->exec_context.std_input == EXEC_INPUT_NULL)
395 s->exec_context.std_output = UNIT(s)->manager->default_std_output;
398 static int service_load(Unit *u) {
399 Service *s = SERVICE(u);
404 /* Load a .service file */
405 r = unit_load_fragment(u);
409 /* Still nothing found? Then let's give up */
410 if (u->load_state == UNIT_STUB)
413 /* This is a new unit? Then let's add in some extras */
414 if (u->load_state == UNIT_LOADED) {
416 /* We were able to load something, then let's add in
417 * the dropin directories. */
418 r = unit_load_dropin(u);
422 if (s->type == _SERVICE_TYPE_INVALID) {
423 /* Figure out a type automatically */
425 s->type = SERVICE_DBUS;
426 else if (s->exec_command[SERVICE_EXEC_START])
427 s->type = SERVICE_SIMPLE;
429 s->type = SERVICE_ONESHOT;
432 /* Oneshot services have disabled start timeout by default */
433 if (s->type == SERVICE_ONESHOT && !s->start_timeout_defined)
434 s->timeout_start_usec = 0;
436 service_fix_output(s);
438 r = unit_patch_contexts(u);
442 r = unit_add_exec_dependencies(u, &s->exec_context);
446 r = unit_add_default_slice(u, &s->cgroup_context);
450 if (s->type == SERVICE_NOTIFY && s->notify_access == NOTIFY_NONE)
451 s->notify_access = NOTIFY_MAIN;
453 if (s->watchdog_usec > 0 && s->notify_access == NOTIFY_NONE)
454 s->notify_access = NOTIFY_MAIN;
457 r = unit_watch_bus_name(u, s->bus_name);
462 if (u->default_dependencies) {
463 r = service_add_default_dependencies(s);
470 return service_verify(s);
473 static void service_dump(Unit *u, FILE *f, const char *prefix) {
474 ServiceExecCommand c;
475 Service *s = SERVICE(u);
480 prefix = strempty(prefix);
481 prefix2 = strappenda(prefix, "\t");
484 "%sService State: %s\n"
486 "%sReload Result: %s\n"
487 "%sPermissionsStartOnly: %s\n"
488 "%sRootDirectoryStartOnly: %s\n"
489 "%sRemainAfterExit: %s\n"
490 "%sGuessMainPID: %s\n"
493 "%sNotifyAccess: %s\n"
494 "%sNotifyState: %s\n",
495 prefix, service_state_to_string(s->state),
496 prefix, service_result_to_string(s->result),
497 prefix, service_result_to_string(s->reload_result),
498 prefix, yes_no(s->permissions_start_only),
499 prefix, yes_no(s->root_directory_start_only),
500 prefix, yes_no(s->remain_after_exit),
501 prefix, yes_no(s->guess_main_pid),
502 prefix, service_type_to_string(s->type),
503 prefix, service_restart_to_string(s->restart),
504 prefix, notify_access_to_string(s->notify_access),
505 prefix, notify_state_to_string(s->notify_state));
507 if (s->control_pid > 0)
509 "%sControl PID: "PID_FMT"\n",
510 prefix, s->control_pid);
514 "%sMain PID: "PID_FMT"\n"
515 "%sMain PID Known: %s\n"
516 "%sMain PID Alien: %s\n",
518 prefix, yes_no(s->main_pid_known),
519 prefix, yes_no(s->main_pid_alien));
524 prefix, s->pid_file);
529 "%sBus Name Good: %s\n",
531 prefix, yes_no(s->bus_name_good));
533 kill_context_dump(&s->kill_context, f, prefix);
534 exec_context_dump(&s->exec_context, f, prefix);
536 for (c = 0; c < _SERVICE_EXEC_COMMAND_MAX; c++) {
538 if (!s->exec_command[c])
541 fprintf(f, "%s-> %s:\n",
542 prefix, service_exec_command_to_string(c));
544 exec_command_dump_list(s->exec_command[c], f, prefix2);
547 #ifdef HAVE_SYSV_COMPAT
548 if (s->sysv_start_priority >= 0)
550 "%sSysVStartPriority: %i\n",
551 prefix, s->sysv_start_priority);
555 fprintf(f, "%sStatus Text: %s\n",
556 prefix, s->status_text);
559 static int service_load_pid_file(Service *s, bool may_warn) {
560 _cleanup_free_ char *k = NULL;
569 r = read_one_line_file(s->pid_file, &k);
572 log_info_unit(UNIT(s)->id, "PID file %s not readable (yet?) after %s.", s->pid_file, service_state_to_string(s->state));
576 r = parse_pid(k, &pid);
579 log_info_unit(UNIT(s)->id, "Failed to read PID from file %s: %s", s->pid_file, strerror(-r));
583 if (!pid_is_alive(pid)) {
585 log_info_unit(UNIT(s)->id, "PID "PID_FMT" read from file %s does not exist or is a zombie.", pid, s->pid_file);
589 if (s->main_pid_known) {
590 if (pid == s->main_pid)
593 log_debug_unit(UNIT(s)->id, "Main PID changing: "PID_FMT" -> "PID_FMT, s->main_pid, pid);
595 service_unwatch_main_pid(s);
596 s->main_pid_known = false;
598 log_debug_unit(UNIT(s)->id, "Main PID loaded: "PID_FMT, pid);
600 r = service_set_main_pid(s, pid);
604 r = unit_watch_pid(UNIT(s), pid);
606 /* FIXME: we need to do something here */
607 log_warning_unit(UNIT(s)->id, "Failed to watch PID "PID_FMT" from service %s", pid, UNIT(s)->id);
614 static int service_search_main_pid(Service *s) {
620 /* If we know it anyway, don't ever fallback to unreliable
622 if (s->main_pid_known)
625 if (!s->guess_main_pid)
628 assert(s->main_pid <= 0);
630 pid = unit_search_main_pid(UNIT(s));
634 log_debug_unit(UNIT(s)->id, "Main PID guessed: "PID_FMT, pid);
635 r = service_set_main_pid(s, pid);
639 r = unit_watch_pid(UNIT(s), pid);
641 /* FIXME: we need to do something here */
642 log_warning_unit(UNIT(s)->id, "Failed to watch PID "PID_FMT" from service %s", pid, UNIT(s)->id);
649 static void service_set_state(Service *s, ServiceState state) {
650 ServiceState old_state;
651 const UnitActiveState *table;
655 table = s->type == SERVICE_IDLE ? state_translation_table_idle : state_translation_table;
657 old_state = s->state;
660 service_unwatch_pid_file(s);
663 SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST,
665 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL,
667 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL,
668 SERVICE_AUTO_RESTART))
669 s->timer_event_source = sd_event_source_unref(s->timer_event_source);
672 SERVICE_START, SERVICE_START_POST,
673 SERVICE_RUNNING, SERVICE_RELOAD,
674 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL,
676 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL)) {
677 service_unwatch_main_pid(s);
678 s->main_command = NULL;
682 SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST,
684 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL,
686 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL)) {
687 service_unwatch_control_pid(s);
688 s->control_command = NULL;
689 s->control_command_id = _SERVICE_EXEC_COMMAND_INVALID;
692 if (IN_SET(state, SERVICE_DEAD, SERVICE_FAILED, SERVICE_AUTO_RESTART))
693 unit_unwatch_all_pids(UNIT(s));
696 SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST,
697 SERVICE_RUNNING, SERVICE_RELOAD,
698 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL, SERVICE_STOP_POST,
699 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL) &&
700 !(state == SERVICE_DEAD && UNIT(s)->job)) {
701 service_close_socket_fd(s);
702 service_connection_unref(s);
705 if (!IN_SET(state, SERVICE_START_POST, SERVICE_RUNNING, SERVICE_RELOAD))
706 service_stop_watchdog(s);
708 /* For the inactive states unit_notify() will trim the cgroup,
709 * but for exit we have to do that ourselves... */
710 if (state == SERVICE_EXITED && UNIT(s)->manager->n_reloading <= 0)
711 unit_destroy_cgroup(UNIT(s));
713 /* For remain_after_exit services, let's see if we can "release" the
714 * hold on the console, since unit_notify() only does that in case of
716 if (state == SERVICE_EXITED &&
717 s->remain_after_exit &&
718 UNIT(s)->manager->n_on_console > 0) {
722 ec = unit_get_exec_context(UNIT(s));
723 if (ec && exec_context_may_touch_console(ec)) {
724 Manager *m = UNIT(s)->manager;
727 if (m->n_on_console == 0)
728 /* unset no_console_output flag, since the console is free */
729 m->no_console_output = false;
733 if (old_state != state)
734 log_debug_unit(UNIT(s)->id, "%s changed %s -> %s", UNIT(s)->id, service_state_to_string(old_state), service_state_to_string(state));
736 unit_notify(UNIT(s), table[old_state], table[state], s->reload_result == SERVICE_SUCCESS);
737 s->reload_result = SERVICE_SUCCESS;
740 static int service_coldplug(Unit *u) {
741 Service *s = SERVICE(u);
745 assert(s->state == SERVICE_DEAD);
747 if (s->deserialized_state != s->state) {
749 if (IN_SET(s->deserialized_state,
750 SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST,
752 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL,
754 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL)) {
758 k = IN_SET(s->deserialized_state, SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST, SERVICE_RELOAD) ? s->timeout_start_usec : s->timeout_stop_usec;
760 /* For the start/stop timeouts 0 means off */
762 r = service_arm_timer(s, k);
768 if (s->deserialized_state == SERVICE_AUTO_RESTART) {
770 /* The restart timeouts 0 means immediately */
771 r = service_arm_timer(s, s->restart_usec);
776 if (pid_is_unwaited(s->main_pid) &&
777 ((s->deserialized_state == SERVICE_START && IN_SET(s->type, SERVICE_FORKING, SERVICE_DBUS, SERVICE_ONESHOT, SERVICE_NOTIFY)) ||
778 IN_SET(s->deserialized_state,
779 SERVICE_START, SERVICE_START_POST,
780 SERVICE_RUNNING, SERVICE_RELOAD,
781 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL,
783 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL))) {
784 r = unit_watch_pid(UNIT(s), s->main_pid);
789 if (pid_is_unwaited(s->control_pid) &&
790 IN_SET(s->deserialized_state,
791 SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST,
793 SERVICE_STOP, SERVICE_STOP_SIGTERM, SERVICE_STOP_SIGKILL,
795 SERVICE_FINAL_SIGTERM, SERVICE_FINAL_SIGKILL)) {
796 r = unit_watch_pid(UNIT(s), s->control_pid);
801 if (!IN_SET(s->deserialized_state, SERVICE_DEAD, SERVICE_FAILED, SERVICE_AUTO_RESTART))
802 unit_watch_all_pids(UNIT(s));
804 if (IN_SET(s->deserialized_state, SERVICE_START_POST, SERVICE_RUNNING, SERVICE_RELOAD))
805 service_start_watchdog(s);
807 service_set_state(s, s->deserialized_state);
813 static int service_collect_fds(Service *s, int **fds, unsigned *n_fds) {
824 if (s->socket_fd >= 0)
827 SET_FOREACH(u, UNIT(s)->dependencies[UNIT_TRIGGERED_BY], i) {
832 if (u->type != UNIT_SOCKET)
837 r = socket_collect_fds(sock, &cfds, &cn_fds);
850 t = new(int, rn_fds+cn_fds);
857 memcpy(t, rfds, rn_fds * sizeof(int));
858 memcpy(t+rn_fds, cfds, cn_fds * sizeof(int));
863 rn_fds = rn_fds+cn_fds;
878 static int service_spawn(
883 bool apply_permissions,
885 bool apply_tty_stdin,
886 bool set_notify_socket,
893 _cleanup_free_ int *fdsbuf = NULL;
894 unsigned n_fds = 0, n_env = 0;
895 _cleanup_free_ char *bus_endpoint_path = NULL;
896 _cleanup_strv_free_ char
897 **argv = NULL, **final_env = NULL, **our_env = NULL;
899 ExecParameters exec_params = {
900 .apply_permissions = apply_permissions,
901 .apply_chroot = apply_chroot,
902 .apply_tty_stdin = apply_tty_stdin,
903 .bus_endpoint_fd = -1,
910 unit_realize_cgroup(UNIT(s));
912 r = unit_setup_exec_runtime(UNIT(s));
917 s->exec_context.std_input == EXEC_INPUT_SOCKET ||
918 s->exec_context.std_output == EXEC_OUTPUT_SOCKET ||
919 s->exec_context.std_error == EXEC_OUTPUT_SOCKET) {
921 if (s->socket_fd >= 0) {
925 r = service_collect_fds(s, &fdsbuf, &n_fds);
934 r = service_arm_timer(s, timeout);
938 s->timer_event_source = sd_event_source_unref(s->timer_event_source);
940 r = unit_full_printf_strv(UNIT(s), c->argv, &argv);
944 our_env = new0(char*, 4);
950 if (set_notify_socket)
951 if (asprintf(our_env + n_env++, "NOTIFY_SOCKET=%s", UNIT(s)->manager->notify_socket) < 0) {
957 if (asprintf(our_env + n_env++, "MAINPID="PID_FMT, s->main_pid) < 0) {
962 if (UNIT(s)->manager->running_as != SYSTEMD_SYSTEM)
963 if (asprintf(our_env + n_env++, "MANAGERPID="PID_FMT, getpid()) < 0) {
968 final_env = strv_env_merge(2, UNIT(s)->manager->environment, our_env, NULL);
974 if (is_control && UNIT(s)->cgroup_path) {
975 path = strappenda(UNIT(s)->cgroup_path, "/control");
976 cg_create(SYSTEMD_CGROUP_CONTROLLER, path);
978 path = UNIT(s)->cgroup_path;
981 if (s->exec_context.bus_endpoint) {
982 r = bus_kernel_create_endpoint(UNIT(s)->manager->running_as == SYSTEMD_SYSTEM ? "system" : "user",
983 UNIT(s)->id, &bus_endpoint_path);
987 /* Pass the fd to the exec_params so that the child process can upload the policy.
988 * Keep a reference to the fd in the service, so the endpoint is kept alive as long
989 * as the service is running. */
990 exec_params.bus_endpoint_fd = s->bus_endpoint_fd = r;
994 exec_params.argv = argv;
995 exec_params.fds = fds;
996 exec_params.n_fds = n_fds;
997 exec_params.environment = final_env;
998 exec_params.confirm_spawn = UNIT(s)->manager->confirm_spawn;
999 exec_params.cgroup_supported = UNIT(s)->manager->cgroup_supported;
1000 exec_params.cgroup_path = path;
1001 exec_params.runtime_prefix = manager_get_runtime_prefix(UNIT(s)->manager);
1002 exec_params.unit_id = UNIT(s)->id;
1003 exec_params.watchdog_usec = s->watchdog_usec;
1004 exec_params.bus_endpoint_path = bus_endpoint_path;
1005 if (s->type == SERVICE_IDLE)
1006 exec_params.idle_pipe = UNIT(s)->manager->idle_pipe;
1016 r = unit_watch_pid(UNIT(s), pid);
1018 /* FIXME: we need to do something here */
1027 s->timer_event_source = sd_event_source_unref(s->timer_event_source);
1032 static int main_pid_good(Service *s) {
1035 /* Returns 0 if the pid is dead, 1 if it is good, -1 if we
1038 /* If we know the pid file, then lets just check if it is
1040 if (s->main_pid_known) {
1042 /* If it's an alien child let's check if it is still
1044 if (s->main_pid_alien && s->main_pid > 0)
1045 return pid_is_alive(s->main_pid);
1047 /* .. otherwise assume we'll get a SIGCHLD for it,
1048 * which we really should wait for to collect exit
1049 * status and code */
1050 return s->main_pid > 0;
1053 /* We don't know the pid */
1057 _pure_ static int control_pid_good(Service *s) {
1060 return s->control_pid > 0;
1063 static int cgroup_good(Service *s) {
1068 if (!UNIT(s)->cgroup_path)
1071 r = cg_is_empty_recursive(SYSTEMD_CGROUP_CONTROLLER, UNIT(s)->cgroup_path, true);
1078 static void service_enter_dead(Service *s, ServiceResult f, bool allow_restart) {
1082 if (f != SERVICE_SUCCESS)
1085 service_set_state(s, s->result != SERVICE_SUCCESS ? SERVICE_FAILED : SERVICE_DEAD);
1087 if (s->result != SERVICE_SUCCESS) {
1088 log_warning_unit(UNIT(s)->id, "%s failed.", UNIT(s)->id);
1089 failure_action(UNIT(s)->manager, s->failure_action, s->reboot_arg);
1092 if (allow_restart &&
1093 !s->forbid_restart &&
1094 (s->restart == SERVICE_RESTART_ALWAYS ||
1095 (s->restart == SERVICE_RESTART_ON_SUCCESS && s->result == SERVICE_SUCCESS) ||
1096 (s->restart == SERVICE_RESTART_ON_FAILURE && s->result != SERVICE_SUCCESS) ||
1097 (s->restart == SERVICE_RESTART_ON_ABNORMAL && !IN_SET(s->result, SERVICE_SUCCESS, SERVICE_FAILURE_EXIT_CODE)) ||
1098 (s->restart == SERVICE_RESTART_ON_WATCHDOG && s->result == SERVICE_FAILURE_WATCHDOG) ||
1099 (s->restart == SERVICE_RESTART_ON_ABORT && IN_SET(s->result, SERVICE_FAILURE_SIGNAL, SERVICE_FAILURE_CORE_DUMP)) ||
1100 (s->main_exec_status.code == CLD_EXITED && set_contains(s->restart_force_status.status, INT_TO_PTR(s->main_exec_status.status))) ||
1101 (IN_SET(s->main_exec_status.code, CLD_KILLED, CLD_DUMPED) && set_contains(s->restart_force_status.signal, INT_TO_PTR(s->main_exec_status.status)))) &&
1102 (s->main_exec_status.code != CLD_EXITED || !set_contains(s->restart_prevent_status.status, INT_TO_PTR(s->main_exec_status.status))) &&
1103 (!IN_SET(s->main_exec_status.code, CLD_KILLED, CLD_DUMPED) || !set_contains(s->restart_prevent_status.signal, INT_TO_PTR(s->main_exec_status.status)))) {
1105 r = service_arm_timer(s, s->restart_usec);
1109 service_set_state(s, SERVICE_AUTO_RESTART);
1112 s->forbid_restart = false;
1114 /* We want fresh tmpdirs in case service is started again immediately */
1115 exec_runtime_destroy(s->exec_runtime);
1116 s->exec_runtime = exec_runtime_unref(s->exec_runtime);
1118 /* Also, remove the runtime directory in */
1119 exec_context_destroy_runtime_directory(&s->exec_context, manager_get_runtime_prefix(UNIT(s)->manager));
1121 /* Try to delete the pid file. At this point it will be
1122 * out-of-date, and some software might be confused by it, so
1123 * let's remove it. */
1125 unlink_noerrno(s->pid_file);
1130 log_warning_unit(UNIT(s)->id, "%s failed to run install restart timer: %s", UNIT(s)->id, strerror(-r));
1131 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, false);
1134 static void service_enter_stop_post(Service *s, ServiceResult f) {
1138 if (f != SERVICE_SUCCESS)
1141 service_unwatch_control_pid(s);
1142 unit_watch_all_pids(UNIT(s));
1144 s->control_command = s->exec_command[SERVICE_EXEC_STOP_POST];
1145 if (s->control_command) {
1146 s->control_command_id = SERVICE_EXEC_STOP_POST;
1148 r = service_spawn(s,
1150 s->timeout_stop_usec,
1152 !s->permissions_start_only,
1153 !s->root_directory_start_only,
1161 service_set_state(s, SERVICE_STOP_POST);
1163 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_SUCCESS);
1168 log_warning_unit(UNIT(s)->id, "%s failed to run 'stop-post' task: %s", UNIT(s)->id, strerror(-r));
1169 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
1172 static void service_enter_signal(Service *s, ServiceState state, ServiceResult f) {
1177 if (f != SERVICE_SUCCESS)
1180 unit_watch_all_pids(UNIT(s));
1182 r = unit_kill_context(
1185 state != SERVICE_STOP_SIGTERM && state != SERVICE_FINAL_SIGTERM,
1194 if (s->timeout_stop_usec > 0) {
1195 r = service_arm_timer(s, s->timeout_stop_usec);
1200 service_set_state(s, state);
1201 } else if (state == SERVICE_STOP_SIGTERM)
1202 service_enter_signal(s, SERVICE_STOP_SIGKILL, SERVICE_SUCCESS);
1203 else if (state == SERVICE_STOP_SIGKILL)
1204 service_enter_stop_post(s, SERVICE_SUCCESS);
1205 else if (state == SERVICE_FINAL_SIGTERM)
1206 service_enter_signal(s, SERVICE_FINAL_SIGKILL, SERVICE_SUCCESS);
1208 service_enter_dead(s, SERVICE_SUCCESS, true);
1213 log_warning_unit(UNIT(s)->id, "%s failed to kill processes: %s", UNIT(s)->id, strerror(-r));
1215 if (state == SERVICE_STOP_SIGTERM || state == SERVICE_STOP_SIGKILL)
1216 service_enter_stop_post(s, SERVICE_FAILURE_RESOURCES);
1218 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, true);
1221 static void service_enter_stop_by_notify(Service *s) {
1224 unit_watch_all_pids(UNIT(s));
1226 if (s->timeout_stop_usec > 0)
1227 service_arm_timer(s, s->timeout_stop_usec);
1229 service_set_state(s, SERVICE_STOP);
1232 static void service_enter_stop(Service *s, ServiceResult f) {
1237 if (f != SERVICE_SUCCESS)
1240 service_unwatch_control_pid(s);
1241 unit_watch_all_pids(UNIT(s));
1243 s->control_command = s->exec_command[SERVICE_EXEC_STOP];
1244 if (s->control_command) {
1245 s->control_command_id = SERVICE_EXEC_STOP;
1247 r = service_spawn(s,
1249 s->timeout_stop_usec,
1251 !s->permissions_start_only,
1252 !s->root_directory_start_only,
1260 service_set_state(s, SERVICE_STOP);
1262 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_SUCCESS);
1267 log_warning_unit(UNIT(s)->id, "%s failed to run 'stop' task: %s", UNIT(s)->id, strerror(-r));
1268 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_RESOURCES);
1271 static void service_enter_running(Service *s, ServiceResult f) {
1272 int main_pid_ok, cgroup_ok;
1275 if (f != SERVICE_SUCCESS)
1278 main_pid_ok = main_pid_good(s);
1279 cgroup_ok = cgroup_good(s);
1281 if ((main_pid_ok > 0 || (main_pid_ok < 0 && cgroup_ok != 0)) &&
1282 (s->bus_name_good || s->type != SERVICE_DBUS)) {
1284 /* If there are any queued up sd_notify()
1285 * notifications, process them now */
1286 if (s->notify_state == NOTIFY_RELOADING)
1287 service_enter_reload_by_notify(s);
1288 else if (s->notify_state == NOTIFY_STOPPING)
1289 service_enter_stop_by_notify(s);
1291 service_set_state(s, SERVICE_RUNNING);
1293 } else if (s->remain_after_exit)
1294 service_set_state(s, SERVICE_EXITED);
1296 service_enter_stop(s, SERVICE_SUCCESS);
1299 static void service_enter_start_post(Service *s) {
1303 service_unwatch_control_pid(s);
1304 service_reset_watchdog(s);
1306 s->control_command = s->exec_command[SERVICE_EXEC_START_POST];
1307 if (s->control_command) {
1308 s->control_command_id = SERVICE_EXEC_START_POST;
1310 r = service_spawn(s,
1312 s->timeout_start_usec,
1314 !s->permissions_start_only,
1315 !s->root_directory_start_only,
1323 service_set_state(s, SERVICE_START_POST);
1325 service_enter_running(s, SERVICE_SUCCESS);
1330 log_warning_unit(UNIT(s)->id, "%s failed to run 'start-post' task: %s", UNIT(s)->id, strerror(-r));
1331 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
1334 static void service_kill_control_processes(Service *s) {
1337 if (!UNIT(s)->cgroup_path)
1340 p = strappenda(UNIT(s)->cgroup_path, "/control");
1341 cg_kill_recursive(SYSTEMD_CGROUP_CONTROLLER, p, SIGKILL, true, true, true, NULL);
1344 static void service_enter_start(Service *s) {
1351 service_unwatch_control_pid(s);
1352 service_unwatch_main_pid(s);
1354 /* We want to ensure that nobody leaks processes from
1355 * START_PRE here, so let's go on a killing spree, People
1356 * should not spawn long running processes from START_PRE. */
1357 service_kill_control_processes(s);
1359 if (s->type == SERVICE_FORKING) {
1360 s->control_command_id = SERVICE_EXEC_START;
1361 c = s->control_command = s->exec_command[SERVICE_EXEC_START];
1363 s->main_command = NULL;
1365 s->control_command_id = _SERVICE_EXEC_COMMAND_INVALID;
1366 s->control_command = NULL;
1368 c = s->main_command = s->exec_command[SERVICE_EXEC_START];
1372 assert(s->type == SERVICE_ONESHOT);
1373 service_enter_start_post(s);
1377 r = service_spawn(s,
1379 IN_SET(s->type, SERVICE_FORKING, SERVICE_DBUS, SERVICE_NOTIFY, SERVICE_ONESHOT) ? s->timeout_start_usec : 0,
1384 s->notify_access != NOTIFY_NONE,
1390 if (s->type == SERVICE_SIMPLE || s->type == SERVICE_IDLE) {
1391 /* For simple services we immediately start
1392 * the START_POST binaries. */
1394 service_set_main_pid(s, pid);
1395 service_enter_start_post(s);
1397 } else if (s->type == SERVICE_FORKING) {
1399 /* For forking services we wait until the start
1400 * process exited. */
1402 s->control_pid = pid;
1403 service_set_state(s, SERVICE_START);
1405 } else if (s->type == SERVICE_ONESHOT ||
1406 s->type == SERVICE_DBUS ||
1407 s->type == SERVICE_NOTIFY) {
1409 /* For oneshot services we wait until the start
1410 * process exited, too, but it is our main process. */
1412 /* For D-Bus services we know the main pid right away,
1413 * but wait for the bus name to appear on the
1414 * bus. Notify services are similar. */
1416 service_set_main_pid(s, pid);
1417 service_set_state(s, SERVICE_START);
1419 assert_not_reached("Unknown service type");
1424 log_warning_unit(UNIT(s)->id, "%s failed to run 'start' task: %s", UNIT(s)->id, strerror(-r));
1425 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
1428 static void service_enter_start_pre(Service *s) {
1433 service_unwatch_control_pid(s);
1435 s->control_command = s->exec_command[SERVICE_EXEC_START_PRE];
1436 if (s->control_command) {
1437 /* Before we start anything, let's clear up what might
1438 * be left from previous runs. */
1439 service_kill_control_processes(s);
1441 s->control_command_id = SERVICE_EXEC_START_PRE;
1443 r = service_spawn(s,
1445 s->timeout_start_usec,
1447 !s->permissions_start_only,
1448 !s->root_directory_start_only,
1456 service_set_state(s, SERVICE_START_PRE);
1458 service_enter_start(s);
1463 log_warning_unit(UNIT(s)->id, "%s failed to run 'start-pre' task: %s", UNIT(s)->id, strerror(-r));
1464 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, true);
1467 static void service_enter_restart(Service *s) {
1468 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
1473 if (UNIT(s)->job && UNIT(s)->job->type == JOB_STOP) {
1474 /* Don't restart things if we are going down anyway */
1475 log_info_unit(UNIT(s)->id, "Stop job pending for unit, delaying automatic restart.");
1477 r = service_arm_timer(s, s->restart_usec);
1484 /* Any units that are bound to this service must also be
1485 * restarted. We use JOB_RESTART (instead of the more obvious
1486 * JOB_START) here so that those dependency jobs will be added
1488 r = manager_add_job(UNIT(s)->manager, JOB_RESTART, UNIT(s), JOB_FAIL, false, &error, NULL);
1492 /* Note that we stay in the SERVICE_AUTO_RESTART state here,
1493 * it will be canceled as part of the service_stop() call that
1494 * is executed as part of JOB_RESTART. */
1496 log_debug_unit(UNIT(s)->id, "%s scheduled restart job.", UNIT(s)->id);
1500 log_warning_unit(UNIT(s)->id, "%s failed to schedule restart job: %s", UNIT(s)->id, bus_error_message(&error, -r));
1501 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, false);
1504 static void service_enter_reload_by_notify(Service *s) {
1507 if (s->timeout_start_usec > 0)
1508 service_arm_timer(s, s->timeout_start_usec);
1510 service_set_state(s, SERVICE_RELOAD);
1513 static void service_enter_reload(Service *s) {
1518 service_unwatch_control_pid(s);
1520 s->control_command = s->exec_command[SERVICE_EXEC_RELOAD];
1521 if (s->control_command) {
1522 s->control_command_id = SERVICE_EXEC_RELOAD;
1524 r = service_spawn(s,
1526 s->timeout_start_usec,
1528 !s->permissions_start_only,
1529 !s->root_directory_start_only,
1537 service_set_state(s, SERVICE_RELOAD);
1539 service_enter_running(s, SERVICE_SUCCESS);
1544 log_warning_unit(UNIT(s)->id, "%s failed to run 'reload' task: %s", UNIT(s)->id, strerror(-r));
1545 s->reload_result = SERVICE_FAILURE_RESOURCES;
1546 service_enter_running(s, SERVICE_SUCCESS);
1549 static void service_run_next_control(Service *s) {
1553 assert(s->control_command);
1554 assert(s->control_command->command_next);
1556 assert(s->control_command_id != SERVICE_EXEC_START);
1558 s->control_command = s->control_command->command_next;
1559 service_unwatch_control_pid(s);
1561 r = service_spawn(s,
1563 IN_SET(s->state, SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST, SERVICE_RUNNING, SERVICE_RELOAD) ? s->timeout_start_usec : s->timeout_stop_usec,
1565 !s->permissions_start_only,
1566 !s->root_directory_start_only,
1567 s->control_command_id == SERVICE_EXEC_START_PRE ||
1568 s->control_command_id == SERVICE_EXEC_STOP_POST,
1578 log_warning_unit(UNIT(s)->id, "%s failed to run next control task: %s", UNIT(s)->id, strerror(-r));
1580 if (s->state == SERVICE_START_PRE)
1581 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
1582 else if (s->state == SERVICE_STOP)
1583 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_RESOURCES);
1584 else if (s->state == SERVICE_STOP_POST)
1585 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, true);
1586 else if (s->state == SERVICE_RELOAD) {
1587 s->reload_result = SERVICE_FAILURE_RESOURCES;
1588 service_enter_running(s, SERVICE_SUCCESS);
1590 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
1593 static void service_run_next_main(Service *s) {
1598 assert(s->main_command);
1599 assert(s->main_command->command_next);
1600 assert(s->type == SERVICE_ONESHOT);
1602 s->main_command = s->main_command->command_next;
1603 service_unwatch_main_pid(s);
1605 r = service_spawn(s,
1607 s->timeout_start_usec,
1612 s->notify_access != NOTIFY_NONE,
1618 service_set_main_pid(s, pid);
1623 log_warning_unit(UNIT(s)->id, "%s failed to run next main task: %s", UNIT(s)->id, strerror(-r));
1624 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
1627 static int service_start_limit_test(Service *s) {
1630 if (ratelimit_test(&s->start_limit))
1633 log_warning_unit(UNIT(s)->id, "start request repeated too quickly for %s", UNIT(s)->id);
1635 return failure_action(UNIT(s)->manager, s->start_limit_action, s->reboot_arg);
1638 static int service_start(Unit *u) {
1639 Service *s = SERVICE(u);
1644 /* We cannot fulfill this request right now, try again later
1646 if (s->state == SERVICE_STOP ||
1647 s->state == SERVICE_STOP_SIGTERM ||
1648 s->state == SERVICE_STOP_SIGKILL ||
1649 s->state == SERVICE_STOP_POST ||
1650 s->state == SERVICE_FINAL_SIGTERM ||
1651 s->state == SERVICE_FINAL_SIGKILL)
1654 /* Already on it! */
1655 if (s->state == SERVICE_START_PRE ||
1656 s->state == SERVICE_START ||
1657 s->state == SERVICE_START_POST)
1660 /* A service that will be restarted must be stopped first to
1661 * trigger BindsTo and/or OnFailure dependencies. If a user
1662 * does not want to wait for the holdoff time to elapse, the
1663 * service should be manually restarted, not started. We
1664 * simply return EAGAIN here, so that any start jobs stay
1665 * queued, and assume that the auto restart timer will
1666 * eventually trigger the restart. */
1667 if (s->state == SERVICE_AUTO_RESTART)
1670 assert(s->state == SERVICE_DEAD || s->state == SERVICE_FAILED);
1672 /* Make sure we don't enter a busy loop of some kind. */
1673 r = service_start_limit_test(s);
1675 service_enter_dead(s, SERVICE_FAILURE_START_LIMIT, false);
1679 s->result = SERVICE_SUCCESS;
1680 s->reload_result = SERVICE_SUCCESS;
1681 s->main_pid_known = false;
1682 s->main_pid_alien = false;
1683 s->forbid_restart = false;
1685 free(s->status_text);
1686 s->status_text = NULL;
1687 s->status_errno = 0;
1689 s->notify_state = NOTIFY_UNKNOWN;
1691 service_enter_start_pre(s);
1695 static int service_stop(Unit *u) {
1696 Service *s = SERVICE(u);
1700 /* Don't create restart jobs from here. */
1701 s->forbid_restart = true;
1704 if (s->state == SERVICE_STOP ||
1705 s->state == SERVICE_STOP_SIGTERM ||
1706 s->state == SERVICE_STOP_SIGKILL ||
1707 s->state == SERVICE_STOP_POST ||
1708 s->state == SERVICE_FINAL_SIGTERM ||
1709 s->state == SERVICE_FINAL_SIGKILL)
1712 /* A restart will be scheduled or is in progress. */
1713 if (s->state == SERVICE_AUTO_RESTART) {
1714 service_set_state(s, SERVICE_DEAD);
1718 /* If there's already something running we go directly into
1720 if (s->state == SERVICE_START_PRE ||
1721 s->state == SERVICE_START ||
1722 s->state == SERVICE_START_POST ||
1723 s->state == SERVICE_RELOAD) {
1724 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_SUCCESS);
1728 assert(s->state == SERVICE_RUNNING ||
1729 s->state == SERVICE_EXITED);
1731 service_enter_stop(s, SERVICE_SUCCESS);
1735 static int service_reload(Unit *u) {
1736 Service *s = SERVICE(u);
1740 assert(s->state == SERVICE_RUNNING || s->state == SERVICE_EXITED);
1742 service_enter_reload(s);
1746 _pure_ static bool service_can_reload(Unit *u) {
1747 Service *s = SERVICE(u);
1751 return !!s->exec_command[SERVICE_EXEC_RELOAD];
1754 static int service_serialize(Unit *u, FILE *f, FDSet *fds) {
1755 Service *s = SERVICE(u);
1761 unit_serialize_item(u, f, "state", service_state_to_string(s->state));
1762 unit_serialize_item(u, f, "result", service_result_to_string(s->result));
1763 unit_serialize_item(u, f, "reload-result", service_result_to_string(s->reload_result));
1765 if (s->control_pid > 0)
1766 unit_serialize_item_format(u, f, "control-pid", PID_FMT,
1769 if (s->main_pid_known && s->main_pid > 0)
1770 unit_serialize_item_format(u, f, "main-pid", PID_FMT, s->main_pid);
1772 unit_serialize_item(u, f, "main-pid-known", yes_no(s->main_pid_known));
1775 unit_serialize_item(u, f, "status-text", s->status_text);
1777 /* FIXME: There's a minor uncleanliness here: if there are
1778 * multiple commands attached here, we will start from the
1779 * first one again */
1780 if (s->control_command_id >= 0)
1781 unit_serialize_item(u, f, "control-command",
1782 service_exec_command_to_string(s->control_command_id));
1784 if (s->socket_fd >= 0) {
1787 if ((copy = fdset_put_dup(fds, s->socket_fd)) < 0)
1790 unit_serialize_item_format(u, f, "socket-fd", "%i", copy);
1793 if (s->bus_endpoint_fd >= 0) {
1796 if ((copy = fdset_put_dup(fds, s->bus_endpoint_fd)) < 0)
1799 unit_serialize_item_format(u, f, "endpoint-fd", "%i", copy);
1802 if (s->main_exec_status.pid > 0) {
1803 unit_serialize_item_format(u, f, "main-exec-status-pid", PID_FMT,
1804 s->main_exec_status.pid);
1805 dual_timestamp_serialize(f, "main-exec-status-start",
1806 &s->main_exec_status.start_timestamp);
1807 dual_timestamp_serialize(f, "main-exec-status-exit",
1808 &s->main_exec_status.exit_timestamp);
1810 if (dual_timestamp_is_set(&s->main_exec_status.exit_timestamp)) {
1811 unit_serialize_item_format(u, f, "main-exec-status-code", "%i",
1812 s->main_exec_status.code);
1813 unit_serialize_item_format(u, f, "main-exec-status-status", "%i",
1814 s->main_exec_status.status);
1817 if (dual_timestamp_is_set(&s->watchdog_timestamp))
1818 dual_timestamp_serialize(f, "watchdog-timestamp", &s->watchdog_timestamp);
1820 if (s->forbid_restart)
1821 unit_serialize_item(u, f, "forbid-restart", yes_no(s->forbid_restart));
1826 static int service_deserialize_item(Unit *u, const char *key, const char *value, FDSet *fds) {
1827 Service *s = SERVICE(u);
1834 if (streq(key, "state")) {
1837 state = service_state_from_string(value);
1839 log_debug_unit(u->id, "Failed to parse state value %s", value);
1841 s->deserialized_state = state;
1842 } else if (streq(key, "result")) {
1845 f = service_result_from_string(value);
1847 log_debug_unit(u->id, "Failed to parse result value %s", value);
1848 else if (f != SERVICE_SUCCESS)
1851 } else if (streq(key, "reload-result")) {
1854 f = service_result_from_string(value);
1856 log_debug_unit(u->id, "Failed to parse reload result value %s", value);
1857 else if (f != SERVICE_SUCCESS)
1858 s->reload_result = f;
1860 } else if (streq(key, "control-pid")) {
1863 if (parse_pid(value, &pid) < 0)
1864 log_debug_unit(u->id, "Failed to parse control-pid value %s", value);
1866 s->control_pid = pid;
1867 } else if (streq(key, "main-pid")) {
1870 if (parse_pid(value, &pid) < 0)
1871 log_debug_unit(u->id, "Failed to parse main-pid value %s", value);
1873 service_set_main_pid(s, pid);
1874 unit_watch_pid(UNIT(s), pid);
1876 } else if (streq(key, "main-pid-known")) {
1879 b = parse_boolean(value);
1881 log_debug_unit(u->id, "Failed to parse main-pid-known value %s", value);
1883 s->main_pid_known = b;
1884 } else if (streq(key, "status-text")) {
1891 free(s->status_text);
1895 } else if (streq(key, "control-command")) {
1896 ServiceExecCommand id;
1898 id = service_exec_command_from_string(value);
1900 log_debug_unit(u->id, "Failed to parse exec-command value %s", value);
1902 s->control_command_id = id;
1903 s->control_command = s->exec_command[id];
1905 } else if (streq(key, "socket-fd")) {
1908 if (safe_atoi(value, &fd) < 0 || fd < 0 || !fdset_contains(fds, fd))
1909 log_debug_unit(u->id, "Failed to parse socket-fd value %s", value);
1911 asynchronous_close(s->socket_fd);
1912 s->socket_fd = fdset_remove(fds, fd);
1914 } else if (streq(key, "endpoint-fd")) {
1917 if (safe_atoi(value, &fd) < 0 || fd < 0 || !fdset_contains(fds, fd))
1918 log_debug_unit(u->id, "Failed to parse endpoint-fd value %s", value);
1920 safe_close(s->bus_endpoint_fd);
1921 s->bus_endpoint_fd = fdset_remove(fds, fd);
1923 } else if (streq(key, "main-exec-status-pid")) {
1926 if (parse_pid(value, &pid) < 0)
1927 log_debug_unit(u->id, "Failed to parse main-exec-status-pid value %s", value);
1929 s->main_exec_status.pid = pid;
1930 } else if (streq(key, "main-exec-status-code")) {
1933 if (safe_atoi(value, &i) < 0)
1934 log_debug_unit(u->id, "Failed to parse main-exec-status-code value %s", value);
1936 s->main_exec_status.code = i;
1937 } else if (streq(key, "main-exec-status-status")) {
1940 if (safe_atoi(value, &i) < 0)
1941 log_debug_unit(u->id, "Failed to parse main-exec-status-status value %s", value);
1943 s->main_exec_status.status = i;
1944 } else if (streq(key, "main-exec-status-start"))
1945 dual_timestamp_deserialize(value, &s->main_exec_status.start_timestamp);
1946 else if (streq(key, "main-exec-status-exit"))
1947 dual_timestamp_deserialize(value, &s->main_exec_status.exit_timestamp);
1948 else if (streq(key, "watchdog-timestamp"))
1949 dual_timestamp_deserialize(value, &s->watchdog_timestamp);
1950 else if (streq(key, "forbid-restart")) {
1953 b = parse_boolean(value);
1955 log_debug_unit(u->id, "Failed to parse forbid-restart value %s", value);
1957 s->forbid_restart = b;
1959 log_debug_unit(u->id, "Unknown serialization key '%s'", key);
1964 _pure_ static UnitActiveState service_active_state(Unit *u) {
1965 const UnitActiveState *table;
1969 table = SERVICE(u)->type == SERVICE_IDLE ? state_translation_table_idle : state_translation_table;
1971 return table[SERVICE(u)->state];
1974 static const char *service_sub_state_to_string(Unit *u) {
1977 return service_state_to_string(SERVICE(u)->state);
1980 static bool service_check_gc(Unit *u) {
1981 Service *s = SERVICE(u);
1985 /* Never clean up services that still have a process around,
1986 * even if the service is formally dead. */
1987 if (cgroup_good(s) > 0 ||
1988 main_pid_good(s) > 0 ||
1989 control_pid_good(s) > 0)
1995 _pure_ static bool service_check_snapshot(Unit *u) {
1996 Service *s = SERVICE(u);
2000 return s->socket_fd < 0;
2003 static int service_retry_pid_file(Service *s) {
2006 assert(s->pid_file);
2007 assert(s->state == SERVICE_START || s->state == SERVICE_START_POST);
2009 r = service_load_pid_file(s, false);
2013 service_unwatch_pid_file(s);
2015 service_enter_running(s, SERVICE_SUCCESS);
2019 static int service_watch_pid_file(Service *s) {
2022 log_debug_unit(UNIT(s)->id, "Setting watch for %s's PID file %s", UNIT(s)->id, s->pid_file_pathspec->path);
2024 r = path_spec_watch(s->pid_file_pathspec, service_dispatch_io);
2028 /* the pidfile might have appeared just before we set the watch */
2029 log_debug_unit(UNIT(s)->id, "Trying to read %s's PID file %s in case it changed", UNIT(s)->id, s->pid_file_pathspec->path);
2030 service_retry_pid_file(s);
2034 log_error_unit(UNIT(s)->id, "Failed to set a watch for %s's PID file %s: %s", UNIT(s)->id, s->pid_file_pathspec->path, strerror(-r));
2035 service_unwatch_pid_file(s);
2039 static int service_demand_pid_file(Service *s) {
2042 assert(s->pid_file);
2043 assert(!s->pid_file_pathspec);
2045 ps = new0(PathSpec, 1);
2050 ps->path = strdup(s->pid_file);
2056 path_kill_slashes(ps->path);
2058 /* PATH_CHANGED would not be enough. There are daemons (sendmail) that
2059 * keep their PID file open all the time. */
2060 ps->type = PATH_MODIFIED;
2061 ps->inotify_fd = -1;
2063 s->pid_file_pathspec = ps;
2065 return service_watch_pid_file(s);
2068 static int service_dispatch_io(sd_event_source *source, int fd, uint32_t events, void *userdata) {
2069 PathSpec *p = userdata;
2074 s = SERVICE(p->unit);
2078 assert(s->state == SERVICE_START || s->state == SERVICE_START_POST);
2079 assert(s->pid_file_pathspec);
2080 assert(path_spec_owns_inotify_fd(s->pid_file_pathspec, fd));
2082 log_debug_unit(UNIT(s)->id, "inotify event for %s", UNIT(s)->id);
2084 if (path_spec_fd_event(p, events) < 0)
2087 if (service_retry_pid_file(s) == 0)
2090 if (service_watch_pid_file(s) < 0)
2096 service_unwatch_pid_file(s);
2097 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_RESOURCES);
2101 static void service_notify_cgroup_empty_event(Unit *u) {
2102 Service *s = SERVICE(u);
2106 log_debug_unit(u->id, "%s: cgroup is empty", u->id);
2110 /* Waiting for SIGCHLD is usually more interesting,
2111 * because it includes return codes/signals. Which is
2112 * why we ignore the cgroup events for most cases,
2113 * except when we don't know pid which to expect the
2117 case SERVICE_START_POST:
2118 /* If we were hoping for the daemon to write its PID file,
2119 * we can give up now. */
2120 if (s->pid_file_pathspec) {
2121 log_warning_unit(u->id, "%s never wrote its PID file. Failing.", UNIT(s)->id);
2123 service_unwatch_pid_file(s);
2124 if (s->state == SERVICE_START)
2125 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
2127 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
2131 case SERVICE_RUNNING:
2132 /* service_enter_running() will figure out what to do */
2133 service_enter_running(s, SERVICE_SUCCESS);
2136 case SERVICE_STOP_SIGTERM:
2137 case SERVICE_STOP_SIGKILL:
2139 if (main_pid_good(s) <= 0 && !control_pid_good(s))
2140 service_enter_stop_post(s, SERVICE_SUCCESS);
2144 case SERVICE_STOP_POST:
2145 case SERVICE_FINAL_SIGTERM:
2146 case SERVICE_FINAL_SIGKILL:
2147 if (main_pid_good(s) <= 0 && !control_pid_good(s))
2148 service_enter_dead(s, SERVICE_SUCCESS, true);
2157 static void service_sigchld_event(Unit *u, pid_t pid, int code, int status) {
2158 Service *s = SERVICE(u);
2164 if (UNIT(s)->fragment_path ? is_clean_exit(code, status, &s->success_status) :
2165 is_clean_exit_lsb(code, status, &s->success_status))
2166 f = SERVICE_SUCCESS;
2167 else if (code == CLD_EXITED)
2168 f = SERVICE_FAILURE_EXIT_CODE;
2169 else if (code == CLD_KILLED)
2170 f = SERVICE_FAILURE_SIGNAL;
2171 else if (code == CLD_DUMPED)
2172 f = SERVICE_FAILURE_CORE_DUMP;
2174 assert_not_reached("Unknown code");
2176 if (s->main_pid == pid) {
2177 /* Forking services may occasionally move to a new PID.
2178 * As long as they update the PID file before exiting the old
2179 * PID, they're fine. */
2180 if (service_load_pid_file(s, false) == 0)
2184 exec_status_exit(&s->main_exec_status, &s->exec_context, pid, code, status);
2186 if (s->main_command) {
2187 /* If this is not a forking service than the
2188 * main process got started and hence we copy
2189 * the exit status so that it is recorded both
2190 * as main and as control process exit
2193 s->main_command->exec_status = s->main_exec_status;
2195 if (s->main_command->ignore)
2196 f = SERVICE_SUCCESS;
2197 } else if (s->exec_command[SERVICE_EXEC_START]) {
2199 /* If this is a forked process, then we should
2200 * ignore the return value if this was
2201 * configured for the starter process */
2203 if (s->exec_command[SERVICE_EXEC_START]->ignore)
2204 f = SERVICE_SUCCESS;
2207 log_struct_unit(f == SERVICE_SUCCESS ? LOG_DEBUG : LOG_NOTICE,
2209 "MESSAGE=%s: main process exited, code=%s, status=%i/%s",
2210 u->id, sigchld_code_to_string(code), status,
2211 strna(code == CLD_EXITED
2212 ? exit_status_to_string(status, EXIT_STATUS_FULL)
2213 : signal_to_string(status)),
2214 "EXIT_CODE=%s", sigchld_code_to_string(code),
2215 "EXIT_STATUS=%i", status,
2218 if (f != SERVICE_SUCCESS)
2221 if (s->main_command &&
2222 s->main_command->command_next &&
2223 f == SERVICE_SUCCESS) {
2225 /* There is another command to *
2226 * execute, so let's do that. */
2228 log_debug_unit(u->id, "%s running next main command for state %s", u->id, service_state_to_string(s->state));
2229 service_run_next_main(s);
2233 /* The service exited, so the service is officially
2235 s->main_command = NULL;
2239 case SERVICE_START_POST:
2240 case SERVICE_RELOAD:
2242 /* Need to wait until the operation is
2247 if (s->type == SERVICE_ONESHOT) {
2248 /* This was our main goal, so let's go on */
2249 if (f == SERVICE_SUCCESS)
2250 service_enter_start_post(s);
2252 service_enter_signal(s, SERVICE_FINAL_SIGTERM, f);
2258 case SERVICE_RUNNING:
2259 service_enter_running(s, f);
2262 case SERVICE_STOP_SIGTERM:
2263 case SERVICE_STOP_SIGKILL:
2265 if (!control_pid_good(s))
2266 service_enter_stop_post(s, f);
2268 /* If there is still a control process, wait for that first */
2271 case SERVICE_STOP_POST:
2272 case SERVICE_FINAL_SIGTERM:
2273 case SERVICE_FINAL_SIGKILL:
2275 if (!control_pid_good(s))
2276 service_enter_dead(s, f, true);
2280 assert_not_reached("Uh, main process died at wrong time.");
2284 } else if (s->control_pid == pid) {
2287 if (s->control_command) {
2288 exec_status_exit(&s->control_command->exec_status, &s->exec_context, pid, code, status);
2290 if (s->control_command->ignore)
2291 f = SERVICE_SUCCESS;
2294 log_full_unit(f == SERVICE_SUCCESS ? LOG_DEBUG : LOG_NOTICE, u->id,
2295 "%s: control process exited, code=%s status=%i",
2296 u->id, sigchld_code_to_string(code), status);
2298 if (f != SERVICE_SUCCESS)
2301 /* Immediately get rid of the cgroup, so that the
2302 * kernel doesn't delay the cgroup empty messages for
2303 * the service cgroup any longer than necessary */
2304 service_kill_control_processes(s);
2306 if (s->control_command &&
2307 s->control_command->command_next &&
2308 f == SERVICE_SUCCESS) {
2310 /* There is another command to *
2311 * execute, so let's do that. */
2313 log_debug_unit(u->id, "%s running next control command for state %s", u->id, service_state_to_string(s->state));
2314 service_run_next_control(s);
2317 /* No further commands for this step, so let's
2318 * figure out what to do next */
2320 s->control_command = NULL;
2321 s->control_command_id = _SERVICE_EXEC_COMMAND_INVALID;
2323 log_debug_unit(u->id, "%s got final SIGCHLD for state %s", u->id, service_state_to_string(s->state));
2327 case SERVICE_START_PRE:
2328 if (f == SERVICE_SUCCESS)
2329 service_enter_start(s);
2331 service_enter_signal(s, SERVICE_FINAL_SIGTERM, f);
2335 if (s->type != SERVICE_FORKING)
2336 /* Maybe spurious event due to a reload that changed the type? */
2339 if (f != SERVICE_SUCCESS) {
2340 service_enter_signal(s, SERVICE_FINAL_SIGTERM, f);
2345 bool has_start_post;
2348 /* Let's try to load the pid file here if we can.
2349 * The PID file might actually be created by a START_POST
2350 * script. In that case don't worry if the loading fails. */
2352 has_start_post = !!s->exec_command[SERVICE_EXEC_START_POST];
2353 r = service_load_pid_file(s, !has_start_post);
2354 if (!has_start_post && r < 0) {
2355 r = service_demand_pid_file(s);
2356 if (r < 0 || !cgroup_good(s))
2357 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
2361 service_search_main_pid(s);
2363 service_enter_start_post(s);
2366 case SERVICE_START_POST:
2367 if (f != SERVICE_SUCCESS) {
2368 service_enter_stop(s, f);
2375 r = service_load_pid_file(s, true);
2377 r = service_demand_pid_file(s);
2378 if (r < 0 || !cgroup_good(s))
2379 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
2383 service_search_main_pid(s);
2385 service_enter_running(s, SERVICE_SUCCESS);
2388 case SERVICE_RELOAD:
2389 if (f == SERVICE_SUCCESS) {
2390 service_load_pid_file(s, true);
2391 service_search_main_pid(s);
2394 s->reload_result = f;
2395 service_enter_running(s, SERVICE_SUCCESS);
2399 service_enter_signal(s, SERVICE_STOP_SIGTERM, f);
2402 case SERVICE_STOP_SIGTERM:
2403 case SERVICE_STOP_SIGKILL:
2404 if (main_pid_good(s) <= 0)
2405 service_enter_stop_post(s, f);
2407 /* If there is still a service
2408 * process around, wait until
2409 * that one quit, too */
2412 case SERVICE_STOP_POST:
2413 case SERVICE_FINAL_SIGTERM:
2414 case SERVICE_FINAL_SIGKILL:
2415 if (main_pid_good(s) <= 0)
2416 service_enter_dead(s, f, true);
2420 assert_not_reached("Uh, control process died at wrong time.");
2425 /* Notify clients about changed exit status */
2426 unit_add_to_dbus_queue(u);
2428 /* We got one SIGCHLD for the service, let's watch all
2429 * processes that are now running of the service, and watch
2430 * that. Among the PIDs we then watch will be children
2431 * reassigned to us, which hopefully allows us to identify
2432 * when all children are gone */
2433 unit_tidy_watch_pids(u, s->main_pid, s->control_pid);
2434 unit_watch_all_pids(u);
2436 /* If the PID set is empty now, then let's finish this off */
2437 if (set_isempty(u->pids))
2438 service_notify_cgroup_empty_event(u);
2441 static int service_dispatch_timer(sd_event_source *source, usec_t usec, void *userdata) {
2442 Service *s = SERVICE(userdata);
2445 assert(source == s->timer_event_source);
2449 case SERVICE_START_PRE:
2451 log_warning_unit(UNIT(s)->id, "%s %s operation timed out. Terminating.", UNIT(s)->id, s->state == SERVICE_START ? "start" : "start-pre");
2452 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_TIMEOUT);
2455 case SERVICE_START_POST:
2456 log_warning_unit(UNIT(s)->id, "%s start-post operation timed out. Stopping.", UNIT(s)->id);
2457 service_enter_stop(s, SERVICE_FAILURE_TIMEOUT);
2460 case SERVICE_RELOAD:
2461 log_warning_unit(UNIT(s)->id, "%s reload operation timed out. Stopping.", UNIT(s)->id);
2462 s->reload_result = SERVICE_FAILURE_TIMEOUT;
2463 service_enter_running(s, SERVICE_SUCCESS);
2467 log_warning_unit(UNIT(s)->id, "%s stopping timed out. Terminating.", UNIT(s)->id);
2468 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_TIMEOUT);
2471 case SERVICE_STOP_SIGTERM:
2472 if (s->kill_context.send_sigkill) {
2473 log_warning_unit(UNIT(s)->id, "%s stop-sigterm timed out. Killing.", UNIT(s)->id);
2474 service_enter_signal(s, SERVICE_STOP_SIGKILL, SERVICE_FAILURE_TIMEOUT);
2476 log_warning_unit(UNIT(s)->id, "%s stop-sigterm timed out. Skipping SIGKILL.", UNIT(s)->id);
2477 service_enter_stop_post(s, SERVICE_FAILURE_TIMEOUT);
2482 case SERVICE_STOP_SIGKILL:
2483 /* Uh, we sent a SIGKILL and it is still not gone?
2484 * Must be something we cannot kill, so let's just be
2485 * weirded out and continue */
2487 log_warning_unit(UNIT(s)->id, "%s still around after SIGKILL. Ignoring.", UNIT(s)->id);
2488 service_enter_stop_post(s, SERVICE_FAILURE_TIMEOUT);
2491 case SERVICE_STOP_POST:
2492 log_warning_unit(UNIT(s)->id, "%s stop-post timed out. Terminating.", UNIT(s)->id);
2493 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_TIMEOUT);
2496 case SERVICE_FINAL_SIGTERM:
2497 if (s->kill_context.send_sigkill) {
2498 log_warning_unit(UNIT(s)->id, "%s stop-final-sigterm timed out. Killing.", UNIT(s)->id);
2499 service_enter_signal(s, SERVICE_FINAL_SIGKILL, SERVICE_FAILURE_TIMEOUT);
2501 log_warning_unit(UNIT(s)->id, "%s stop-final-sigterm timed out. Skipping SIGKILL. Entering failed mode.", UNIT(s)->id);
2502 service_enter_dead(s, SERVICE_FAILURE_TIMEOUT, false);
2507 case SERVICE_FINAL_SIGKILL:
2508 log_warning_unit(UNIT(s)->id, "%s still around after final SIGKILL. Entering failed mode.", UNIT(s)->id);
2509 service_enter_dead(s, SERVICE_FAILURE_TIMEOUT, true);
2512 case SERVICE_AUTO_RESTART:
2513 log_info_unit(UNIT(s)->id,
2514 s->restart_usec > 0 ?
2515 "%s holdoff time over, scheduling restart." :
2516 "%s has no holdoff time, scheduling restart.",
2518 service_enter_restart(s);
2522 assert_not_reached("Timeout at wrong time.");
2528 static int service_dispatch_watchdog(sd_event_source *source, usec_t usec, void *userdata) {
2529 Service *s = SERVICE(userdata);
2530 char t[FORMAT_TIMESPAN_MAX];
2533 assert(source == s->watchdog_event_source);
2535 log_error_unit(UNIT(s)->id, "%s watchdog timeout (limit %s)!", UNIT(s)->id,
2536 format_timespan(t, sizeof(t), s->watchdog_usec, 1));
2538 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_WATCHDOG);
2543 static void service_notify_message(Unit *u, pid_t pid, char **tags) {
2544 Service *s = SERVICE(u);
2545 _cleanup_free_ char *cc = NULL;
2546 bool notify_dbus = false;
2551 cc = strv_join(tags, ", ");
2552 log_debug_unit(u->id, "%s: Got notification message from PID "PID_FMT" (%s)",
2553 u->id, pid, isempty(cc) ? "n/a" : cc);
2555 if (s->notify_access == NOTIFY_NONE) {
2556 log_warning_unit(u->id, "%s: Got notification message from PID "PID_FMT", but reception is disabled.", u->id, pid);
2560 if (s->notify_access == NOTIFY_MAIN && pid != s->main_pid) {
2561 if (s->main_pid != 0)
2562 log_warning_unit(u->id, "%s: Got notification message from PID "PID_FMT", but reception only permitted for main PID "PID_FMT, u->id, pid, s->main_pid);
2564 log_debug_unit(u->id, "%s: Got notification message from PID "PID_FMT", but reception only permitted for main PID which is currently not known", u->id, pid);
2568 /* Interpret MAINPID= */
2569 e = strv_find_startswith(tags, "MAINPID=");
2570 if (e && IN_SET(s->state, SERVICE_START, SERVICE_START_POST, SERVICE_RUNNING, SERVICE_RELOAD)) {
2571 if (parse_pid(e, &pid) < 0)
2572 log_warning_unit(u->id, "Failed to parse MAINPID= field in notification message: %s", e);
2574 log_debug_unit(u->id, "%s: got MAINPID=%s", u->id, e);
2576 service_set_main_pid(s, pid);
2577 unit_watch_pid(UNIT(s), pid);
2582 /* Interpret RELOADING= */
2583 if (strv_find(tags, "RELOADING=1")) {
2585 log_debug_unit(u->id, "%s: got RELOADING=1", u->id);
2586 s->notify_state = NOTIFY_RELOADING;
2588 if (s->state == SERVICE_RUNNING)
2589 service_enter_reload_by_notify(s);
2594 /* Interpret READY= */
2595 if (strv_find(tags, "READY=1")) {
2597 log_debug_unit(u->id, "%s: got READY=1", u->id);
2598 s->notify_state = NOTIFY_READY;
2600 /* Type=notify services inform us about completed
2601 * initialization with READY=1 */
2602 if (s->type == SERVICE_NOTIFY && s->state == SERVICE_START)
2603 service_enter_start_post(s);
2605 /* Sending READY=1 while we are reloading informs us
2606 * that the reloading is complete */
2607 if (s->state == SERVICE_RELOAD && s->control_pid == 0)
2608 service_enter_running(s, SERVICE_SUCCESS);
2613 /* Interpret STOPPING= */
2614 if (strv_find(tags, "STOPPING=1")) {
2616 log_debug_unit(u->id, "%s: got STOPPING=1", u->id);
2617 s->notify_state = NOTIFY_STOPPING;
2619 if (s->state == SERVICE_RUNNING)
2620 service_enter_stop_by_notify(s);
2625 /* Interpret STATUS= */
2626 e = strv_find_startswith(tags, "STATUS=");
2628 _cleanup_free_ char *t = NULL;
2631 if (!utf8_is_valid(e))
2632 log_warning_unit(u->id, "Status message in notification is not UTF-8 clean.");
2634 log_debug_unit(u->id, "%s: got STATUS=%s", u->id, e);
2642 if (!streq_ptr(s->status_text, t)) {
2644 free(s->status_text);
2652 /* Interpret ERRNO= */
2653 e = strv_find_startswith(tags, "ERRNO=");
2657 if (safe_atoi(e, &status_errno) < 0 || status_errno < 0)
2658 log_warning_unit(u->id, "Failed to parse ERRNO= field in notification message: %s", e);
2660 log_debug_unit(u->id, "%s: got ERRNO=%s", u->id, e);
2662 if (s->status_errno != status_errno) {
2663 s->status_errno = status_errno;
2669 /* Interpret WATCHDOG= */
2670 if (strv_find(tags, "WATCHDOG=1")) {
2671 log_debug_unit(u->id, "%s: got WATCHDOG=1", u->id);
2672 service_reset_watchdog(s);
2675 /* Notify clients about changed status or main pid */
2677 unit_add_to_dbus_queue(u);
2680 static int service_get_timeout(Unit *u, uint64_t *timeout) {
2681 Service *s = SERVICE(u);
2684 if (!s->timer_event_source)
2687 r = sd_event_source_get_time(s->timer_event_source, timeout);
2694 static void service_bus_name_owner_change(
2697 const char *old_owner,
2698 const char *new_owner) {
2700 Service *s = SERVICE(u);
2706 assert(streq(s->bus_name, name));
2707 assert(old_owner || new_owner);
2709 if (old_owner && new_owner)
2710 log_debug_unit(u->id, "%s's D-Bus name %s changed owner from %s to %s", u->id, name, old_owner, new_owner);
2712 log_debug_unit(u->id, "%s's D-Bus name %s no longer registered by %s", u->id, name, old_owner);
2714 log_debug_unit(u->id, "%s's D-Bus name %s now registered by %s", u->id, name, new_owner);
2716 s->bus_name_good = !!new_owner;
2718 if (s->type == SERVICE_DBUS) {
2720 /* service_enter_running() will figure out what to
2722 if (s->state == SERVICE_RUNNING)
2723 service_enter_running(s, SERVICE_SUCCESS);
2724 else if (s->state == SERVICE_START && new_owner)
2725 service_enter_start_post(s);
2727 } else if (new_owner &&
2729 (s->state == SERVICE_START ||
2730 s->state == SERVICE_START_POST ||
2731 s->state == SERVICE_RUNNING ||
2732 s->state == SERVICE_RELOAD)) {
2734 _cleanup_bus_creds_unref_ sd_bus_creds *creds = NULL;
2737 /* Try to acquire PID from bus service */
2739 r = sd_bus_get_owner(u->manager->api_bus, name, SD_BUS_CREDS_PID, &creds);
2741 r = sd_bus_creds_get_pid(creds, &pid);
2743 log_debug_unit(u->id, "%s's D-Bus name %s is now owned by process %u", u->id, name, (unsigned) pid);
2745 service_set_main_pid(s, pid);
2746 unit_watch_pid(UNIT(s), pid);
2751 int service_set_socket_fd(Service *s, int fd, Socket *sock) {
2752 _cleanup_free_ char *peer = NULL;
2758 /* This is called by the socket code when instantiating a new
2759 * service for a stream socket and the socket needs to be
2762 if (UNIT(s)->load_state != UNIT_LOADED)
2765 if (s->socket_fd >= 0)
2768 if (s->state != SERVICE_DEAD)
2771 if (getpeername_pretty(fd, &peer) >= 0) {
2773 if (UNIT(s)->description) {
2774 _cleanup_free_ char *a;
2776 a = strjoin(UNIT(s)->description, " (", peer, ")", NULL);
2780 r = unit_set_description(UNIT(s), a);
2782 r = unit_set_description(UNIT(s), peer);
2790 unit_ref_set(&s->accept_socket, UNIT(sock));
2792 return unit_add_two_dependencies(UNIT(sock), UNIT_BEFORE, UNIT_TRIGGERS, UNIT(s), false);
2795 static void service_reset_failed(Unit *u) {
2796 Service *s = SERVICE(u);
2800 if (s->state == SERVICE_FAILED)
2801 service_set_state(s, SERVICE_DEAD);
2803 s->result = SERVICE_SUCCESS;
2804 s->reload_result = SERVICE_SUCCESS;
2806 RATELIMIT_RESET(s->start_limit);
2809 static int service_kill(Unit *u, KillWho who, int signo, sd_bus_error *error) {
2810 Service *s = SERVICE(u);
2812 return unit_kill_common(u, who, signo, s->main_pid, s->control_pid, error);
2815 static const char* const service_state_table[_SERVICE_STATE_MAX] = {
2816 [SERVICE_DEAD] = "dead",
2817 [SERVICE_START_PRE] = "start-pre",
2818 [SERVICE_START] = "start",
2819 [SERVICE_START_POST] = "start-post",
2820 [SERVICE_RUNNING] = "running",
2821 [SERVICE_EXITED] = "exited",
2822 [SERVICE_RELOAD] = "reload",
2823 [SERVICE_STOP] = "stop",
2824 [SERVICE_STOP_SIGTERM] = "stop-sigterm",
2825 [SERVICE_STOP_SIGKILL] = "stop-sigkill",
2826 [SERVICE_STOP_POST] = "stop-post",
2827 [SERVICE_FINAL_SIGTERM] = "final-sigterm",
2828 [SERVICE_FINAL_SIGKILL] = "final-sigkill",
2829 [SERVICE_FAILED] = "failed",
2830 [SERVICE_AUTO_RESTART] = "auto-restart",
2833 DEFINE_STRING_TABLE_LOOKUP(service_state, ServiceState);
2835 static const char* const service_restart_table[_SERVICE_RESTART_MAX] = {
2836 [SERVICE_RESTART_NO] = "no",
2837 [SERVICE_RESTART_ON_SUCCESS] = "on-success",
2838 [SERVICE_RESTART_ON_FAILURE] = "on-failure",
2839 [SERVICE_RESTART_ON_ABNORMAL] = "on-abnormal",
2840 [SERVICE_RESTART_ON_WATCHDOG] = "on-watchdog",
2841 [SERVICE_RESTART_ON_ABORT] = "on-abort",
2842 [SERVICE_RESTART_ALWAYS] = "always",
2845 DEFINE_STRING_TABLE_LOOKUP(service_restart, ServiceRestart);
2847 static const char* const service_type_table[_SERVICE_TYPE_MAX] = {
2848 [SERVICE_SIMPLE] = "simple",
2849 [SERVICE_FORKING] = "forking",
2850 [SERVICE_ONESHOT] = "oneshot",
2851 [SERVICE_DBUS] = "dbus",
2852 [SERVICE_NOTIFY] = "notify",
2853 [SERVICE_IDLE] = "idle"
2856 DEFINE_STRING_TABLE_LOOKUP(service_type, ServiceType);
2858 static const char* const service_exec_command_table[_SERVICE_EXEC_COMMAND_MAX] = {
2859 [SERVICE_EXEC_START_PRE] = "ExecStartPre",
2860 [SERVICE_EXEC_START] = "ExecStart",
2861 [SERVICE_EXEC_START_POST] = "ExecStartPost",
2862 [SERVICE_EXEC_RELOAD] = "ExecReload",
2863 [SERVICE_EXEC_STOP] = "ExecStop",
2864 [SERVICE_EXEC_STOP_POST] = "ExecStopPost",
2867 DEFINE_STRING_TABLE_LOOKUP(service_exec_command, ServiceExecCommand);
2869 static const char* const notify_access_table[_NOTIFY_ACCESS_MAX] = {
2870 [NOTIFY_NONE] = "none",
2871 [NOTIFY_MAIN] = "main",
2872 [NOTIFY_ALL] = "all"
2875 DEFINE_STRING_TABLE_LOOKUP(notify_access, NotifyAccess);
2877 static const char* const notify_state_table[_NOTIFY_STATE_MAX] = {
2878 [NOTIFY_UNKNOWN] = "unknown",
2879 [NOTIFY_READY] = "ready",
2880 [NOTIFY_RELOADING] = "reloading",
2881 [NOTIFY_STOPPING] = "stopping",
2884 DEFINE_STRING_TABLE_LOOKUP(notify_state, NotifyState);
2886 static const char* const service_result_table[_SERVICE_RESULT_MAX] = {
2887 [SERVICE_SUCCESS] = "success",
2888 [SERVICE_FAILURE_RESOURCES] = "resources",
2889 [SERVICE_FAILURE_TIMEOUT] = "timeout",
2890 [SERVICE_FAILURE_EXIT_CODE] = "exit-code",
2891 [SERVICE_FAILURE_SIGNAL] = "signal",
2892 [SERVICE_FAILURE_CORE_DUMP] = "core-dump",
2893 [SERVICE_FAILURE_WATCHDOG] = "watchdog",
2894 [SERVICE_FAILURE_START_LIMIT] = "start-limit"
2897 DEFINE_STRING_TABLE_LOOKUP(service_result, ServiceResult);
2899 const UnitVTable service_vtable = {
2900 .object_size = sizeof(Service),
2901 .exec_context_offset = offsetof(Service, exec_context),
2902 .cgroup_context_offset = offsetof(Service, cgroup_context),
2903 .kill_context_offset = offsetof(Service, kill_context),
2904 .exec_runtime_offset = offsetof(Service, exec_runtime),
2910 .private_section = "Service",
2912 .init = service_init,
2913 .done = service_done,
2914 .load = service_load,
2916 .coldplug = service_coldplug,
2918 .dump = service_dump,
2920 .start = service_start,
2921 .stop = service_stop,
2922 .reload = service_reload,
2924 .can_reload = service_can_reload,
2926 .kill = service_kill,
2928 .serialize = service_serialize,
2929 .deserialize_item = service_deserialize_item,
2931 .active_state = service_active_state,
2932 .sub_state_to_string = service_sub_state_to_string,
2934 .check_gc = service_check_gc,
2935 .check_snapshot = service_check_snapshot,
2937 .sigchld_event = service_sigchld_event,
2939 .reset_failed = service_reset_failed,
2941 .notify_cgroup_empty = service_notify_cgroup_empty_event,
2942 .notify_message = service_notify_message,
2944 .bus_name_owner_change = service_bus_name_owner_change,
2946 .bus_interface = "org.freedesktop.systemd1.Service",
2947 .bus_vtable = bus_service_vtable,
2948 .bus_set_property = bus_service_set_property,
2949 .bus_commit_properties = bus_service_commit_properties,
2951 .get_timeout = service_get_timeout,
2952 .can_transient = true,
2954 .status_message_formats = {
2955 .starting_stopping = {
2956 [0] = "Starting %s...",
2957 [1] = "Stopping %s...",
2959 .finished_start_job = {
2960 [JOB_DONE] = "Started %s.",
2961 [JOB_FAILED] = "Failed to start %s.",
2962 [JOB_DEPENDENCY] = "Dependency failed for %s.",
2963 [JOB_TIMEOUT] = "Timed out starting %s.",
2965 .finished_stop_job = {
2966 [JOB_DONE] = "Stopped %s.",
2967 [JOB_FAILED] = "Stopped (with error) %s.",
2968 [JOB_TIMEOUT] = "Timed out stopping %s.",