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,
904 .selinux_context_net = s->socket_fd_selinux_context_net
911 unit_realize_cgroup(UNIT(s));
913 r = unit_setup_exec_runtime(UNIT(s));
918 s->exec_context.std_input == EXEC_INPUT_SOCKET ||
919 s->exec_context.std_output == EXEC_OUTPUT_SOCKET ||
920 s->exec_context.std_error == EXEC_OUTPUT_SOCKET) {
922 if (s->socket_fd >= 0) {
926 r = service_collect_fds(s, &fdsbuf, &n_fds);
935 r = service_arm_timer(s, timeout);
939 s->timer_event_source = sd_event_source_unref(s->timer_event_source);
941 r = unit_full_printf_strv(UNIT(s), c->argv, &argv);
945 our_env = new0(char*, 4);
951 if (set_notify_socket)
952 if (asprintf(our_env + n_env++, "NOTIFY_SOCKET=%s", UNIT(s)->manager->notify_socket) < 0) {
958 if (asprintf(our_env + n_env++, "MAINPID="PID_FMT, s->main_pid) < 0) {
963 if (UNIT(s)->manager->running_as != SYSTEMD_SYSTEM)
964 if (asprintf(our_env + n_env++, "MANAGERPID="PID_FMT, getpid()) < 0) {
969 final_env = strv_env_merge(2, UNIT(s)->manager->environment, our_env, NULL);
975 if (is_control && UNIT(s)->cgroup_path) {
976 path = strappenda(UNIT(s)->cgroup_path, "/control");
977 cg_create(SYSTEMD_CGROUP_CONTROLLER, path);
979 path = UNIT(s)->cgroup_path;
982 if (s->exec_context.bus_endpoint) {
983 r = bus_kernel_create_endpoint(UNIT(s)->manager->running_as == SYSTEMD_SYSTEM ? "system" : "user",
984 UNIT(s)->id, &bus_endpoint_path);
988 /* Pass the fd to the exec_params so that the child process can upload the policy.
989 * Keep a reference to the fd in the service, so the endpoint is kept alive as long
990 * as the service is running. */
991 exec_params.bus_endpoint_fd = s->bus_endpoint_fd = r;
995 exec_params.argv = argv;
996 exec_params.fds = fds;
997 exec_params.n_fds = n_fds;
998 exec_params.environment = final_env;
999 exec_params.confirm_spawn = UNIT(s)->manager->confirm_spawn;
1000 exec_params.cgroup_supported = UNIT(s)->manager->cgroup_supported;
1001 exec_params.cgroup_path = path;
1002 exec_params.runtime_prefix = manager_get_runtime_prefix(UNIT(s)->manager);
1003 exec_params.unit_id = UNIT(s)->id;
1004 exec_params.watchdog_usec = s->watchdog_usec;
1005 exec_params.bus_endpoint_path = bus_endpoint_path;
1006 if (s->type == SERVICE_IDLE)
1007 exec_params.idle_pipe = UNIT(s)->manager->idle_pipe;
1017 r = unit_watch_pid(UNIT(s), pid);
1019 /* FIXME: we need to do something here */
1028 s->timer_event_source = sd_event_source_unref(s->timer_event_source);
1033 static int main_pid_good(Service *s) {
1036 /* Returns 0 if the pid is dead, 1 if it is good, -1 if we
1039 /* If we know the pid file, then lets just check if it is
1041 if (s->main_pid_known) {
1043 /* If it's an alien child let's check if it is still
1045 if (s->main_pid_alien && s->main_pid > 0)
1046 return pid_is_alive(s->main_pid);
1048 /* .. otherwise assume we'll get a SIGCHLD for it,
1049 * which we really should wait for to collect exit
1050 * status and code */
1051 return s->main_pid > 0;
1054 /* We don't know the pid */
1058 _pure_ static int control_pid_good(Service *s) {
1061 return s->control_pid > 0;
1064 static int cgroup_good(Service *s) {
1069 if (!UNIT(s)->cgroup_path)
1072 r = cg_is_empty_recursive(SYSTEMD_CGROUP_CONTROLLER, UNIT(s)->cgroup_path, true);
1079 static void service_enter_dead(Service *s, ServiceResult f, bool allow_restart) {
1083 if (f != SERVICE_SUCCESS)
1086 service_set_state(s, s->result != SERVICE_SUCCESS ? SERVICE_FAILED : SERVICE_DEAD);
1088 if (s->result != SERVICE_SUCCESS) {
1089 log_warning_unit(UNIT(s)->id, "%s failed.", UNIT(s)->id);
1090 failure_action(UNIT(s)->manager, s->failure_action, s->reboot_arg);
1093 if (allow_restart &&
1094 !s->forbid_restart &&
1095 (s->restart == SERVICE_RESTART_ALWAYS ||
1096 (s->restart == SERVICE_RESTART_ON_SUCCESS && s->result == SERVICE_SUCCESS) ||
1097 (s->restart == SERVICE_RESTART_ON_FAILURE && s->result != SERVICE_SUCCESS) ||
1098 (s->restart == SERVICE_RESTART_ON_ABNORMAL && !IN_SET(s->result, SERVICE_SUCCESS, SERVICE_FAILURE_EXIT_CODE)) ||
1099 (s->restart == SERVICE_RESTART_ON_WATCHDOG && s->result == SERVICE_FAILURE_WATCHDOG) ||
1100 (s->restart == SERVICE_RESTART_ON_ABORT && IN_SET(s->result, SERVICE_FAILURE_SIGNAL, SERVICE_FAILURE_CORE_DUMP)) ||
1101 (s->main_exec_status.code == CLD_EXITED && set_contains(s->restart_force_status.status, INT_TO_PTR(s->main_exec_status.status))) ||
1102 (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)))) &&
1103 (s->main_exec_status.code != CLD_EXITED || !set_contains(s->restart_prevent_status.status, INT_TO_PTR(s->main_exec_status.status))) &&
1104 (!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)))) {
1106 r = service_arm_timer(s, s->restart_usec);
1110 service_set_state(s, SERVICE_AUTO_RESTART);
1113 s->forbid_restart = false;
1115 /* We want fresh tmpdirs in case service is started again immediately */
1116 exec_runtime_destroy(s->exec_runtime);
1117 s->exec_runtime = exec_runtime_unref(s->exec_runtime);
1119 /* Also, remove the runtime directory in */
1120 exec_context_destroy_runtime_directory(&s->exec_context, manager_get_runtime_prefix(UNIT(s)->manager));
1122 /* Try to delete the pid file. At this point it will be
1123 * out-of-date, and some software might be confused by it, so
1124 * let's remove it. */
1126 unlink_noerrno(s->pid_file);
1131 log_warning_unit(UNIT(s)->id, "%s failed to run install restart timer: %s", UNIT(s)->id, strerror(-r));
1132 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, false);
1135 static void service_enter_stop_post(Service *s, ServiceResult f) {
1139 if (f != SERVICE_SUCCESS)
1142 service_unwatch_control_pid(s);
1143 unit_watch_all_pids(UNIT(s));
1145 s->control_command = s->exec_command[SERVICE_EXEC_STOP_POST];
1146 if (s->control_command) {
1147 s->control_command_id = SERVICE_EXEC_STOP_POST;
1149 r = service_spawn(s,
1151 s->timeout_stop_usec,
1153 !s->permissions_start_only,
1154 !s->root_directory_start_only,
1162 service_set_state(s, SERVICE_STOP_POST);
1164 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_SUCCESS);
1169 log_warning_unit(UNIT(s)->id, "%s failed to run 'stop-post' task: %s", UNIT(s)->id, strerror(-r));
1170 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
1173 static void service_enter_signal(Service *s, ServiceState state, ServiceResult f) {
1178 if (f != SERVICE_SUCCESS)
1181 unit_watch_all_pids(UNIT(s));
1183 r = unit_kill_context(
1186 state != SERVICE_STOP_SIGTERM && state != SERVICE_FINAL_SIGTERM,
1195 if (s->timeout_stop_usec > 0) {
1196 r = service_arm_timer(s, s->timeout_stop_usec);
1201 service_set_state(s, state);
1202 } else if (state == SERVICE_STOP_SIGTERM)
1203 service_enter_signal(s, SERVICE_STOP_SIGKILL, SERVICE_SUCCESS);
1204 else if (state == SERVICE_STOP_SIGKILL)
1205 service_enter_stop_post(s, SERVICE_SUCCESS);
1206 else if (state == SERVICE_FINAL_SIGTERM)
1207 service_enter_signal(s, SERVICE_FINAL_SIGKILL, SERVICE_SUCCESS);
1209 service_enter_dead(s, SERVICE_SUCCESS, true);
1214 log_warning_unit(UNIT(s)->id, "%s failed to kill processes: %s", UNIT(s)->id, strerror(-r));
1216 if (state == SERVICE_STOP_SIGTERM || state == SERVICE_STOP_SIGKILL)
1217 service_enter_stop_post(s, SERVICE_FAILURE_RESOURCES);
1219 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, true);
1222 static void service_enter_stop_by_notify(Service *s) {
1225 unit_watch_all_pids(UNIT(s));
1227 if (s->timeout_stop_usec > 0)
1228 service_arm_timer(s, s->timeout_stop_usec);
1230 service_set_state(s, SERVICE_STOP);
1233 static void service_enter_stop(Service *s, ServiceResult f) {
1238 if (f != SERVICE_SUCCESS)
1241 service_unwatch_control_pid(s);
1242 unit_watch_all_pids(UNIT(s));
1244 s->control_command = s->exec_command[SERVICE_EXEC_STOP];
1245 if (s->control_command) {
1246 s->control_command_id = SERVICE_EXEC_STOP;
1248 r = service_spawn(s,
1250 s->timeout_stop_usec,
1252 !s->permissions_start_only,
1253 !s->root_directory_start_only,
1261 service_set_state(s, SERVICE_STOP);
1263 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_SUCCESS);
1268 log_warning_unit(UNIT(s)->id, "%s failed to run 'stop' task: %s", UNIT(s)->id, strerror(-r));
1269 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_RESOURCES);
1272 static void service_enter_running(Service *s, ServiceResult f) {
1273 int main_pid_ok, cgroup_ok;
1276 if (f != SERVICE_SUCCESS)
1279 main_pid_ok = main_pid_good(s);
1280 cgroup_ok = cgroup_good(s);
1282 if ((main_pid_ok > 0 || (main_pid_ok < 0 && cgroup_ok != 0)) &&
1283 (s->bus_name_good || s->type != SERVICE_DBUS)) {
1285 /* If there are any queued up sd_notify()
1286 * notifications, process them now */
1287 if (s->notify_state == NOTIFY_RELOADING)
1288 service_enter_reload_by_notify(s);
1289 else if (s->notify_state == NOTIFY_STOPPING)
1290 service_enter_stop_by_notify(s);
1292 service_set_state(s, SERVICE_RUNNING);
1294 } else if (s->remain_after_exit)
1295 service_set_state(s, SERVICE_EXITED);
1297 service_enter_stop(s, SERVICE_SUCCESS);
1300 static void service_enter_start_post(Service *s) {
1304 service_unwatch_control_pid(s);
1305 service_reset_watchdog(s);
1307 s->control_command = s->exec_command[SERVICE_EXEC_START_POST];
1308 if (s->control_command) {
1309 s->control_command_id = SERVICE_EXEC_START_POST;
1311 r = service_spawn(s,
1313 s->timeout_start_usec,
1315 !s->permissions_start_only,
1316 !s->root_directory_start_only,
1324 service_set_state(s, SERVICE_START_POST);
1326 service_enter_running(s, SERVICE_SUCCESS);
1331 log_warning_unit(UNIT(s)->id, "%s failed to run 'start-post' task: %s", UNIT(s)->id, strerror(-r));
1332 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
1335 static void service_kill_control_processes(Service *s) {
1338 if (!UNIT(s)->cgroup_path)
1341 p = strappenda(UNIT(s)->cgroup_path, "/control");
1342 cg_kill_recursive(SYSTEMD_CGROUP_CONTROLLER, p, SIGKILL, true, true, true, NULL);
1345 static void service_enter_start(Service *s) {
1352 service_unwatch_control_pid(s);
1353 service_unwatch_main_pid(s);
1355 /* We want to ensure that nobody leaks processes from
1356 * START_PRE here, so let's go on a killing spree, People
1357 * should not spawn long running processes from START_PRE. */
1358 service_kill_control_processes(s);
1360 if (s->type == SERVICE_FORKING) {
1361 s->control_command_id = SERVICE_EXEC_START;
1362 c = s->control_command = s->exec_command[SERVICE_EXEC_START];
1364 s->main_command = NULL;
1366 s->control_command_id = _SERVICE_EXEC_COMMAND_INVALID;
1367 s->control_command = NULL;
1369 c = s->main_command = s->exec_command[SERVICE_EXEC_START];
1373 assert(s->type == SERVICE_ONESHOT);
1374 service_enter_start_post(s);
1378 r = service_spawn(s,
1380 IN_SET(s->type, SERVICE_FORKING, SERVICE_DBUS, SERVICE_NOTIFY, SERVICE_ONESHOT) ? s->timeout_start_usec : 0,
1385 s->notify_access != NOTIFY_NONE,
1391 if (s->type == SERVICE_SIMPLE || s->type == SERVICE_IDLE) {
1392 /* For simple services we immediately start
1393 * the START_POST binaries. */
1395 service_set_main_pid(s, pid);
1396 service_enter_start_post(s);
1398 } else if (s->type == SERVICE_FORKING) {
1400 /* For forking services we wait until the start
1401 * process exited. */
1403 s->control_pid = pid;
1404 service_set_state(s, SERVICE_START);
1406 } else if (s->type == SERVICE_ONESHOT ||
1407 s->type == SERVICE_DBUS ||
1408 s->type == SERVICE_NOTIFY) {
1410 /* For oneshot services we wait until the start
1411 * process exited, too, but it is our main process. */
1413 /* For D-Bus services we know the main pid right away,
1414 * but wait for the bus name to appear on the
1415 * bus. Notify services are similar. */
1417 service_set_main_pid(s, pid);
1418 service_set_state(s, SERVICE_START);
1420 assert_not_reached("Unknown service type");
1425 log_warning_unit(UNIT(s)->id, "%s failed to run 'start' task: %s", UNIT(s)->id, strerror(-r));
1426 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
1429 static void service_enter_start_pre(Service *s) {
1434 service_unwatch_control_pid(s);
1436 s->control_command = s->exec_command[SERVICE_EXEC_START_PRE];
1437 if (s->control_command) {
1438 /* Before we start anything, let's clear up what might
1439 * be left from previous runs. */
1440 service_kill_control_processes(s);
1442 s->control_command_id = SERVICE_EXEC_START_PRE;
1444 r = service_spawn(s,
1446 s->timeout_start_usec,
1448 !s->permissions_start_only,
1449 !s->root_directory_start_only,
1457 service_set_state(s, SERVICE_START_PRE);
1459 service_enter_start(s);
1464 log_warning_unit(UNIT(s)->id, "%s failed to run 'start-pre' task: %s", UNIT(s)->id, strerror(-r));
1465 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, true);
1468 static void service_enter_restart(Service *s) {
1469 _cleanup_bus_error_free_ sd_bus_error error = SD_BUS_ERROR_NULL;
1474 if (UNIT(s)->job && UNIT(s)->job->type == JOB_STOP) {
1475 /* Don't restart things if we are going down anyway */
1476 log_info_unit(UNIT(s)->id, "Stop job pending for unit, delaying automatic restart.");
1478 r = service_arm_timer(s, s->restart_usec);
1485 /* Any units that are bound to this service must also be
1486 * restarted. We use JOB_RESTART (instead of the more obvious
1487 * JOB_START) here so that those dependency jobs will be added
1489 r = manager_add_job(UNIT(s)->manager, JOB_RESTART, UNIT(s), JOB_FAIL, false, &error, NULL);
1493 /* Note that we stay in the SERVICE_AUTO_RESTART state here,
1494 * it will be canceled as part of the service_stop() call that
1495 * is executed as part of JOB_RESTART. */
1497 log_debug_unit(UNIT(s)->id, "%s scheduled restart job.", UNIT(s)->id);
1501 log_warning_unit(UNIT(s)->id, "%s failed to schedule restart job: %s", UNIT(s)->id, bus_error_message(&error, -r));
1502 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, false);
1505 static void service_enter_reload_by_notify(Service *s) {
1508 if (s->timeout_start_usec > 0)
1509 service_arm_timer(s, s->timeout_start_usec);
1511 service_set_state(s, SERVICE_RELOAD);
1514 static void service_enter_reload(Service *s) {
1519 service_unwatch_control_pid(s);
1521 s->control_command = s->exec_command[SERVICE_EXEC_RELOAD];
1522 if (s->control_command) {
1523 s->control_command_id = SERVICE_EXEC_RELOAD;
1525 r = service_spawn(s,
1527 s->timeout_start_usec,
1529 !s->permissions_start_only,
1530 !s->root_directory_start_only,
1538 service_set_state(s, SERVICE_RELOAD);
1540 service_enter_running(s, SERVICE_SUCCESS);
1545 log_warning_unit(UNIT(s)->id, "%s failed to run 'reload' task: %s", UNIT(s)->id, strerror(-r));
1546 s->reload_result = SERVICE_FAILURE_RESOURCES;
1547 service_enter_running(s, SERVICE_SUCCESS);
1550 static void service_run_next_control(Service *s) {
1554 assert(s->control_command);
1555 assert(s->control_command->command_next);
1557 assert(s->control_command_id != SERVICE_EXEC_START);
1559 s->control_command = s->control_command->command_next;
1560 service_unwatch_control_pid(s);
1562 r = service_spawn(s,
1564 IN_SET(s->state, SERVICE_START_PRE, SERVICE_START, SERVICE_START_POST, SERVICE_RUNNING, SERVICE_RELOAD) ? s->timeout_start_usec : s->timeout_stop_usec,
1566 !s->permissions_start_only,
1567 !s->root_directory_start_only,
1568 s->control_command_id == SERVICE_EXEC_START_PRE ||
1569 s->control_command_id == SERVICE_EXEC_STOP_POST,
1579 log_warning_unit(UNIT(s)->id, "%s failed to run next control task: %s", UNIT(s)->id, strerror(-r));
1581 if (s->state == SERVICE_START_PRE)
1582 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
1583 else if (s->state == SERVICE_STOP)
1584 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_RESOURCES);
1585 else if (s->state == SERVICE_STOP_POST)
1586 service_enter_dead(s, SERVICE_FAILURE_RESOURCES, true);
1587 else if (s->state == SERVICE_RELOAD) {
1588 s->reload_result = SERVICE_FAILURE_RESOURCES;
1589 service_enter_running(s, SERVICE_SUCCESS);
1591 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
1594 static void service_run_next_main(Service *s) {
1599 assert(s->main_command);
1600 assert(s->main_command->command_next);
1601 assert(s->type == SERVICE_ONESHOT);
1603 s->main_command = s->main_command->command_next;
1604 service_unwatch_main_pid(s);
1606 r = service_spawn(s,
1608 s->timeout_start_usec,
1613 s->notify_access != NOTIFY_NONE,
1619 service_set_main_pid(s, pid);
1624 log_warning_unit(UNIT(s)->id, "%s failed to run next main task: %s", UNIT(s)->id, strerror(-r));
1625 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
1628 static int service_start_limit_test(Service *s) {
1631 if (ratelimit_test(&s->start_limit))
1634 log_warning_unit(UNIT(s)->id, "start request repeated too quickly for %s", UNIT(s)->id);
1636 return failure_action(UNIT(s)->manager, s->start_limit_action, s->reboot_arg);
1639 static int service_start(Unit *u) {
1640 Service *s = SERVICE(u);
1645 /* We cannot fulfill this request right now, try again later
1647 if (s->state == SERVICE_STOP ||
1648 s->state == SERVICE_STOP_SIGTERM ||
1649 s->state == SERVICE_STOP_SIGKILL ||
1650 s->state == SERVICE_STOP_POST ||
1651 s->state == SERVICE_FINAL_SIGTERM ||
1652 s->state == SERVICE_FINAL_SIGKILL)
1655 /* Already on it! */
1656 if (s->state == SERVICE_START_PRE ||
1657 s->state == SERVICE_START ||
1658 s->state == SERVICE_START_POST)
1661 /* A service that will be restarted must be stopped first to
1662 * trigger BindsTo and/or OnFailure dependencies. If a user
1663 * does not want to wait for the holdoff time to elapse, the
1664 * service should be manually restarted, not started. We
1665 * simply return EAGAIN here, so that any start jobs stay
1666 * queued, and assume that the auto restart timer will
1667 * eventually trigger the restart. */
1668 if (s->state == SERVICE_AUTO_RESTART)
1671 assert(s->state == SERVICE_DEAD || s->state == SERVICE_FAILED);
1673 /* Make sure we don't enter a busy loop of some kind. */
1674 r = service_start_limit_test(s);
1676 service_enter_dead(s, SERVICE_FAILURE_START_LIMIT, false);
1680 s->result = SERVICE_SUCCESS;
1681 s->reload_result = SERVICE_SUCCESS;
1682 s->main_pid_known = false;
1683 s->main_pid_alien = false;
1684 s->forbid_restart = false;
1686 free(s->status_text);
1687 s->status_text = NULL;
1688 s->status_errno = 0;
1690 s->notify_state = NOTIFY_UNKNOWN;
1692 service_enter_start_pre(s);
1696 static int service_stop(Unit *u) {
1697 Service *s = SERVICE(u);
1701 /* Don't create restart jobs from here. */
1702 s->forbid_restart = true;
1705 if (s->state == SERVICE_STOP ||
1706 s->state == SERVICE_STOP_SIGTERM ||
1707 s->state == SERVICE_STOP_SIGKILL ||
1708 s->state == SERVICE_STOP_POST ||
1709 s->state == SERVICE_FINAL_SIGTERM ||
1710 s->state == SERVICE_FINAL_SIGKILL)
1713 /* A restart will be scheduled or is in progress. */
1714 if (s->state == SERVICE_AUTO_RESTART) {
1715 service_set_state(s, SERVICE_DEAD);
1719 /* If there's already something running we go directly into
1721 if (s->state == SERVICE_START_PRE ||
1722 s->state == SERVICE_START ||
1723 s->state == SERVICE_START_POST ||
1724 s->state == SERVICE_RELOAD) {
1725 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_SUCCESS);
1729 assert(s->state == SERVICE_RUNNING ||
1730 s->state == SERVICE_EXITED);
1732 service_enter_stop(s, SERVICE_SUCCESS);
1736 static int service_reload(Unit *u) {
1737 Service *s = SERVICE(u);
1741 assert(s->state == SERVICE_RUNNING || s->state == SERVICE_EXITED);
1743 service_enter_reload(s);
1747 _pure_ static bool service_can_reload(Unit *u) {
1748 Service *s = SERVICE(u);
1752 return !!s->exec_command[SERVICE_EXEC_RELOAD];
1755 static int service_serialize(Unit *u, FILE *f, FDSet *fds) {
1756 Service *s = SERVICE(u);
1762 unit_serialize_item(u, f, "state", service_state_to_string(s->state));
1763 unit_serialize_item(u, f, "result", service_result_to_string(s->result));
1764 unit_serialize_item(u, f, "reload-result", service_result_to_string(s->reload_result));
1766 if (s->control_pid > 0)
1767 unit_serialize_item_format(u, f, "control-pid", PID_FMT,
1770 if (s->main_pid_known && s->main_pid > 0)
1771 unit_serialize_item_format(u, f, "main-pid", PID_FMT, s->main_pid);
1773 unit_serialize_item(u, f, "main-pid-known", yes_no(s->main_pid_known));
1776 unit_serialize_item(u, f, "status-text", s->status_text);
1778 /* FIXME: There's a minor uncleanliness here: if there are
1779 * multiple commands attached here, we will start from the
1780 * first one again */
1781 if (s->control_command_id >= 0)
1782 unit_serialize_item(u, f, "control-command",
1783 service_exec_command_to_string(s->control_command_id));
1785 if (s->socket_fd >= 0) {
1788 if ((copy = fdset_put_dup(fds, s->socket_fd)) < 0)
1791 unit_serialize_item_format(u, f, "socket-fd", "%i", copy);
1794 if (s->bus_endpoint_fd >= 0) {
1797 if ((copy = fdset_put_dup(fds, s->bus_endpoint_fd)) < 0)
1800 unit_serialize_item_format(u, f, "endpoint-fd", "%i", copy);
1803 if (s->main_exec_status.pid > 0) {
1804 unit_serialize_item_format(u, f, "main-exec-status-pid", PID_FMT,
1805 s->main_exec_status.pid);
1806 dual_timestamp_serialize(f, "main-exec-status-start",
1807 &s->main_exec_status.start_timestamp);
1808 dual_timestamp_serialize(f, "main-exec-status-exit",
1809 &s->main_exec_status.exit_timestamp);
1811 if (dual_timestamp_is_set(&s->main_exec_status.exit_timestamp)) {
1812 unit_serialize_item_format(u, f, "main-exec-status-code", "%i",
1813 s->main_exec_status.code);
1814 unit_serialize_item_format(u, f, "main-exec-status-status", "%i",
1815 s->main_exec_status.status);
1818 if (dual_timestamp_is_set(&s->watchdog_timestamp))
1819 dual_timestamp_serialize(f, "watchdog-timestamp", &s->watchdog_timestamp);
1821 if (s->forbid_restart)
1822 unit_serialize_item(u, f, "forbid-restart", yes_no(s->forbid_restart));
1827 static int service_deserialize_item(Unit *u, const char *key, const char *value, FDSet *fds) {
1828 Service *s = SERVICE(u);
1835 if (streq(key, "state")) {
1838 state = service_state_from_string(value);
1840 log_debug_unit(u->id, "Failed to parse state value %s", value);
1842 s->deserialized_state = state;
1843 } else if (streq(key, "result")) {
1846 f = service_result_from_string(value);
1848 log_debug_unit(u->id, "Failed to parse result value %s", value);
1849 else if (f != SERVICE_SUCCESS)
1852 } else if (streq(key, "reload-result")) {
1855 f = service_result_from_string(value);
1857 log_debug_unit(u->id, "Failed to parse reload result value %s", value);
1858 else if (f != SERVICE_SUCCESS)
1859 s->reload_result = f;
1861 } else if (streq(key, "control-pid")) {
1864 if (parse_pid(value, &pid) < 0)
1865 log_debug_unit(u->id, "Failed to parse control-pid value %s", value);
1867 s->control_pid = pid;
1868 } else if (streq(key, "main-pid")) {
1871 if (parse_pid(value, &pid) < 0)
1872 log_debug_unit(u->id, "Failed to parse main-pid value %s", value);
1874 service_set_main_pid(s, pid);
1875 unit_watch_pid(UNIT(s), pid);
1877 } else if (streq(key, "main-pid-known")) {
1880 b = parse_boolean(value);
1882 log_debug_unit(u->id, "Failed to parse main-pid-known value %s", value);
1884 s->main_pid_known = b;
1885 } else if (streq(key, "status-text")) {
1892 free(s->status_text);
1896 } else if (streq(key, "control-command")) {
1897 ServiceExecCommand id;
1899 id = service_exec_command_from_string(value);
1901 log_debug_unit(u->id, "Failed to parse exec-command value %s", value);
1903 s->control_command_id = id;
1904 s->control_command = s->exec_command[id];
1906 } else if (streq(key, "socket-fd")) {
1909 if (safe_atoi(value, &fd) < 0 || fd < 0 || !fdset_contains(fds, fd))
1910 log_debug_unit(u->id, "Failed to parse socket-fd value %s", value);
1912 asynchronous_close(s->socket_fd);
1913 s->socket_fd = fdset_remove(fds, fd);
1915 } else if (streq(key, "endpoint-fd")) {
1918 if (safe_atoi(value, &fd) < 0 || fd < 0 || !fdset_contains(fds, fd))
1919 log_debug_unit(u->id, "Failed to parse endpoint-fd value %s", value);
1921 safe_close(s->bus_endpoint_fd);
1922 s->bus_endpoint_fd = fdset_remove(fds, fd);
1924 } else if (streq(key, "main-exec-status-pid")) {
1927 if (parse_pid(value, &pid) < 0)
1928 log_debug_unit(u->id, "Failed to parse main-exec-status-pid value %s", value);
1930 s->main_exec_status.pid = pid;
1931 } else if (streq(key, "main-exec-status-code")) {
1934 if (safe_atoi(value, &i) < 0)
1935 log_debug_unit(u->id, "Failed to parse main-exec-status-code value %s", value);
1937 s->main_exec_status.code = i;
1938 } else if (streq(key, "main-exec-status-status")) {
1941 if (safe_atoi(value, &i) < 0)
1942 log_debug_unit(u->id, "Failed to parse main-exec-status-status value %s", value);
1944 s->main_exec_status.status = i;
1945 } else if (streq(key, "main-exec-status-start"))
1946 dual_timestamp_deserialize(value, &s->main_exec_status.start_timestamp);
1947 else if (streq(key, "main-exec-status-exit"))
1948 dual_timestamp_deserialize(value, &s->main_exec_status.exit_timestamp);
1949 else if (streq(key, "watchdog-timestamp"))
1950 dual_timestamp_deserialize(value, &s->watchdog_timestamp);
1951 else if (streq(key, "forbid-restart")) {
1954 b = parse_boolean(value);
1956 log_debug_unit(u->id, "Failed to parse forbid-restart value %s", value);
1958 s->forbid_restart = b;
1960 log_debug_unit(u->id, "Unknown serialization key '%s'", key);
1965 _pure_ static UnitActiveState service_active_state(Unit *u) {
1966 const UnitActiveState *table;
1970 table = SERVICE(u)->type == SERVICE_IDLE ? state_translation_table_idle : state_translation_table;
1972 return table[SERVICE(u)->state];
1975 static const char *service_sub_state_to_string(Unit *u) {
1978 return service_state_to_string(SERVICE(u)->state);
1981 static bool service_check_gc(Unit *u) {
1982 Service *s = SERVICE(u);
1986 /* Never clean up services that still have a process around,
1987 * even if the service is formally dead. */
1988 if (cgroup_good(s) > 0 ||
1989 main_pid_good(s) > 0 ||
1990 control_pid_good(s) > 0)
1996 _pure_ static bool service_check_snapshot(Unit *u) {
1997 Service *s = SERVICE(u);
2001 return s->socket_fd < 0;
2004 static int service_retry_pid_file(Service *s) {
2007 assert(s->pid_file);
2008 assert(s->state == SERVICE_START || s->state == SERVICE_START_POST);
2010 r = service_load_pid_file(s, false);
2014 service_unwatch_pid_file(s);
2016 service_enter_running(s, SERVICE_SUCCESS);
2020 static int service_watch_pid_file(Service *s) {
2023 log_debug_unit(UNIT(s)->id, "Setting watch for %s's PID file %s", UNIT(s)->id, s->pid_file_pathspec->path);
2025 r = path_spec_watch(s->pid_file_pathspec, service_dispatch_io);
2029 /* the pidfile might have appeared just before we set the watch */
2030 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);
2031 service_retry_pid_file(s);
2035 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));
2036 service_unwatch_pid_file(s);
2040 static int service_demand_pid_file(Service *s) {
2043 assert(s->pid_file);
2044 assert(!s->pid_file_pathspec);
2046 ps = new0(PathSpec, 1);
2051 ps->path = strdup(s->pid_file);
2057 path_kill_slashes(ps->path);
2059 /* PATH_CHANGED would not be enough. There are daemons (sendmail) that
2060 * keep their PID file open all the time. */
2061 ps->type = PATH_MODIFIED;
2062 ps->inotify_fd = -1;
2064 s->pid_file_pathspec = ps;
2066 return service_watch_pid_file(s);
2069 static int service_dispatch_io(sd_event_source *source, int fd, uint32_t events, void *userdata) {
2070 PathSpec *p = userdata;
2075 s = SERVICE(p->unit);
2079 assert(s->state == SERVICE_START || s->state == SERVICE_START_POST);
2080 assert(s->pid_file_pathspec);
2081 assert(path_spec_owns_inotify_fd(s->pid_file_pathspec, fd));
2083 log_debug_unit(UNIT(s)->id, "inotify event for %s", UNIT(s)->id);
2085 if (path_spec_fd_event(p, events) < 0)
2088 if (service_retry_pid_file(s) == 0)
2091 if (service_watch_pid_file(s) < 0)
2097 service_unwatch_pid_file(s);
2098 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_RESOURCES);
2102 static void service_notify_cgroup_empty_event(Unit *u) {
2103 Service *s = SERVICE(u);
2107 log_debug_unit(u->id, "%s: cgroup is empty", u->id);
2111 /* Waiting for SIGCHLD is usually more interesting,
2112 * because it includes return codes/signals. Which is
2113 * why we ignore the cgroup events for most cases,
2114 * except when we don't know pid which to expect the
2118 case SERVICE_START_POST:
2119 /* If we were hoping for the daemon to write its PID file,
2120 * we can give up now. */
2121 if (s->pid_file_pathspec) {
2122 log_warning_unit(u->id, "%s never wrote its PID file. Failing.", UNIT(s)->id);
2124 service_unwatch_pid_file(s);
2125 if (s->state == SERVICE_START)
2126 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
2128 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
2132 case SERVICE_RUNNING:
2133 /* service_enter_running() will figure out what to do */
2134 service_enter_running(s, SERVICE_SUCCESS);
2137 case SERVICE_STOP_SIGTERM:
2138 case SERVICE_STOP_SIGKILL:
2140 if (main_pid_good(s) <= 0 && !control_pid_good(s))
2141 service_enter_stop_post(s, SERVICE_SUCCESS);
2145 case SERVICE_STOP_POST:
2146 case SERVICE_FINAL_SIGTERM:
2147 case SERVICE_FINAL_SIGKILL:
2148 if (main_pid_good(s) <= 0 && !control_pid_good(s))
2149 service_enter_dead(s, SERVICE_SUCCESS, true);
2158 static void service_sigchld_event(Unit *u, pid_t pid, int code, int status) {
2159 Service *s = SERVICE(u);
2165 if (UNIT(s)->fragment_path ? is_clean_exit(code, status, &s->success_status) :
2166 is_clean_exit_lsb(code, status, &s->success_status))
2167 f = SERVICE_SUCCESS;
2168 else if (code == CLD_EXITED)
2169 f = SERVICE_FAILURE_EXIT_CODE;
2170 else if (code == CLD_KILLED)
2171 f = SERVICE_FAILURE_SIGNAL;
2172 else if (code == CLD_DUMPED)
2173 f = SERVICE_FAILURE_CORE_DUMP;
2175 assert_not_reached("Unknown code");
2177 if (s->main_pid == pid) {
2178 /* Forking services may occasionally move to a new PID.
2179 * As long as they update the PID file before exiting the old
2180 * PID, they're fine. */
2181 if (service_load_pid_file(s, false) == 0)
2185 exec_status_exit(&s->main_exec_status, &s->exec_context, pid, code, status);
2187 if (s->main_command) {
2188 /* If this is not a forking service than the
2189 * main process got started and hence we copy
2190 * the exit status so that it is recorded both
2191 * as main and as control process exit
2194 s->main_command->exec_status = s->main_exec_status;
2196 if (s->main_command->ignore)
2197 f = SERVICE_SUCCESS;
2198 } else if (s->exec_command[SERVICE_EXEC_START]) {
2200 /* If this is a forked process, then we should
2201 * ignore the return value if this was
2202 * configured for the starter process */
2204 if (s->exec_command[SERVICE_EXEC_START]->ignore)
2205 f = SERVICE_SUCCESS;
2208 log_struct_unit(f == SERVICE_SUCCESS ? LOG_DEBUG : LOG_NOTICE,
2210 "MESSAGE=%s: main process exited, code=%s, status=%i/%s",
2211 u->id, sigchld_code_to_string(code), status,
2212 strna(code == CLD_EXITED
2213 ? exit_status_to_string(status, EXIT_STATUS_FULL)
2214 : signal_to_string(status)),
2215 "EXIT_CODE=%s", sigchld_code_to_string(code),
2216 "EXIT_STATUS=%i", status,
2219 if (f != SERVICE_SUCCESS)
2222 if (s->main_command &&
2223 s->main_command->command_next &&
2224 f == SERVICE_SUCCESS) {
2226 /* There is another command to *
2227 * execute, so let's do that. */
2229 log_debug_unit(u->id, "%s running next main command for state %s", u->id, service_state_to_string(s->state));
2230 service_run_next_main(s);
2234 /* The service exited, so the service is officially
2236 s->main_command = NULL;
2240 case SERVICE_START_POST:
2241 case SERVICE_RELOAD:
2243 /* Need to wait until the operation is
2248 if (s->type == SERVICE_ONESHOT) {
2249 /* This was our main goal, so let's go on */
2250 if (f == SERVICE_SUCCESS)
2251 service_enter_start_post(s);
2253 service_enter_signal(s, SERVICE_FINAL_SIGTERM, f);
2259 case SERVICE_RUNNING:
2260 service_enter_running(s, f);
2263 case SERVICE_STOP_SIGTERM:
2264 case SERVICE_STOP_SIGKILL:
2266 if (!control_pid_good(s))
2267 service_enter_stop_post(s, f);
2269 /* If there is still a control process, wait for that first */
2272 case SERVICE_STOP_POST:
2273 case SERVICE_FINAL_SIGTERM:
2274 case SERVICE_FINAL_SIGKILL:
2276 if (!control_pid_good(s))
2277 service_enter_dead(s, f, true);
2281 assert_not_reached("Uh, main process died at wrong time.");
2285 } else if (s->control_pid == pid) {
2288 if (s->control_command) {
2289 exec_status_exit(&s->control_command->exec_status, &s->exec_context, pid, code, status);
2291 if (s->control_command->ignore)
2292 f = SERVICE_SUCCESS;
2295 log_full_unit(f == SERVICE_SUCCESS ? LOG_DEBUG : LOG_NOTICE, u->id,
2296 "%s: control process exited, code=%s status=%i",
2297 u->id, sigchld_code_to_string(code), status);
2299 if (f != SERVICE_SUCCESS)
2302 /* Immediately get rid of the cgroup, so that the
2303 * kernel doesn't delay the cgroup empty messages for
2304 * the service cgroup any longer than necessary */
2305 service_kill_control_processes(s);
2307 if (s->control_command &&
2308 s->control_command->command_next &&
2309 f == SERVICE_SUCCESS) {
2311 /* There is another command to *
2312 * execute, so let's do that. */
2314 log_debug_unit(u->id, "%s running next control command for state %s", u->id, service_state_to_string(s->state));
2315 service_run_next_control(s);
2318 /* No further commands for this step, so let's
2319 * figure out what to do next */
2321 s->control_command = NULL;
2322 s->control_command_id = _SERVICE_EXEC_COMMAND_INVALID;
2324 log_debug_unit(u->id, "%s got final SIGCHLD for state %s", u->id, service_state_to_string(s->state));
2328 case SERVICE_START_PRE:
2329 if (f == SERVICE_SUCCESS)
2330 service_enter_start(s);
2332 service_enter_signal(s, SERVICE_FINAL_SIGTERM, f);
2336 if (s->type != SERVICE_FORKING)
2337 /* Maybe spurious event due to a reload that changed the type? */
2340 if (f != SERVICE_SUCCESS) {
2341 service_enter_signal(s, SERVICE_FINAL_SIGTERM, f);
2346 bool has_start_post;
2349 /* Let's try to load the pid file here if we can.
2350 * The PID file might actually be created by a START_POST
2351 * script. In that case don't worry if the loading fails. */
2353 has_start_post = !!s->exec_command[SERVICE_EXEC_START_POST];
2354 r = service_load_pid_file(s, !has_start_post);
2355 if (!has_start_post && r < 0) {
2356 r = service_demand_pid_file(s);
2357 if (r < 0 || !cgroup_good(s))
2358 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_RESOURCES);
2362 service_search_main_pid(s);
2364 service_enter_start_post(s);
2367 case SERVICE_START_POST:
2368 if (f != SERVICE_SUCCESS) {
2369 service_enter_stop(s, f);
2376 r = service_load_pid_file(s, true);
2378 r = service_demand_pid_file(s);
2379 if (r < 0 || !cgroup_good(s))
2380 service_enter_stop(s, SERVICE_FAILURE_RESOURCES);
2384 service_search_main_pid(s);
2386 service_enter_running(s, SERVICE_SUCCESS);
2389 case SERVICE_RELOAD:
2390 if (f == SERVICE_SUCCESS) {
2391 service_load_pid_file(s, true);
2392 service_search_main_pid(s);
2395 s->reload_result = f;
2396 service_enter_running(s, SERVICE_SUCCESS);
2400 service_enter_signal(s, SERVICE_STOP_SIGTERM, f);
2403 case SERVICE_STOP_SIGTERM:
2404 case SERVICE_STOP_SIGKILL:
2405 if (main_pid_good(s) <= 0)
2406 service_enter_stop_post(s, f);
2408 /* If there is still a service
2409 * process around, wait until
2410 * that one quit, too */
2413 case SERVICE_STOP_POST:
2414 case SERVICE_FINAL_SIGTERM:
2415 case SERVICE_FINAL_SIGKILL:
2416 if (main_pid_good(s) <= 0)
2417 service_enter_dead(s, f, true);
2421 assert_not_reached("Uh, control process died at wrong time.");
2426 /* Notify clients about changed exit status */
2427 unit_add_to_dbus_queue(u);
2429 /* We got one SIGCHLD for the service, let's watch all
2430 * processes that are now running of the service, and watch
2431 * that. Among the PIDs we then watch will be children
2432 * reassigned to us, which hopefully allows us to identify
2433 * when all children are gone */
2434 unit_tidy_watch_pids(u, s->main_pid, s->control_pid);
2435 unit_watch_all_pids(u);
2437 /* If the PID set is empty now, then let's finish this off */
2438 if (set_isempty(u->pids))
2439 service_notify_cgroup_empty_event(u);
2442 static int service_dispatch_timer(sd_event_source *source, usec_t usec, void *userdata) {
2443 Service *s = SERVICE(userdata);
2446 assert(source == s->timer_event_source);
2450 case SERVICE_START_PRE:
2452 log_warning_unit(UNIT(s)->id, "%s %s operation timed out. Terminating.", UNIT(s)->id, s->state == SERVICE_START ? "start" : "start-pre");
2453 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_TIMEOUT);
2456 case SERVICE_START_POST:
2457 log_warning_unit(UNIT(s)->id, "%s start-post operation timed out. Stopping.", UNIT(s)->id);
2458 service_enter_stop(s, SERVICE_FAILURE_TIMEOUT);
2461 case SERVICE_RELOAD:
2462 log_warning_unit(UNIT(s)->id, "%s reload operation timed out. Stopping.", UNIT(s)->id);
2463 s->reload_result = SERVICE_FAILURE_TIMEOUT;
2464 service_enter_running(s, SERVICE_SUCCESS);
2468 log_warning_unit(UNIT(s)->id, "%s stopping timed out. Terminating.", UNIT(s)->id);
2469 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_TIMEOUT);
2472 case SERVICE_STOP_SIGTERM:
2473 if (s->kill_context.send_sigkill) {
2474 log_warning_unit(UNIT(s)->id, "%s stop-sigterm timed out. Killing.", UNIT(s)->id);
2475 service_enter_signal(s, SERVICE_STOP_SIGKILL, SERVICE_FAILURE_TIMEOUT);
2477 log_warning_unit(UNIT(s)->id, "%s stop-sigterm timed out. Skipping SIGKILL.", UNIT(s)->id);
2478 service_enter_stop_post(s, SERVICE_FAILURE_TIMEOUT);
2483 case SERVICE_STOP_SIGKILL:
2484 /* Uh, we sent a SIGKILL and it is still not gone?
2485 * Must be something we cannot kill, so let's just be
2486 * weirded out and continue */
2488 log_warning_unit(UNIT(s)->id, "%s still around after SIGKILL. Ignoring.", UNIT(s)->id);
2489 service_enter_stop_post(s, SERVICE_FAILURE_TIMEOUT);
2492 case SERVICE_STOP_POST:
2493 log_warning_unit(UNIT(s)->id, "%s stop-post timed out. Terminating.", UNIT(s)->id);
2494 service_enter_signal(s, SERVICE_FINAL_SIGTERM, SERVICE_FAILURE_TIMEOUT);
2497 case SERVICE_FINAL_SIGTERM:
2498 if (s->kill_context.send_sigkill) {
2499 log_warning_unit(UNIT(s)->id, "%s stop-final-sigterm timed out. Killing.", UNIT(s)->id);
2500 service_enter_signal(s, SERVICE_FINAL_SIGKILL, SERVICE_FAILURE_TIMEOUT);
2502 log_warning_unit(UNIT(s)->id, "%s stop-final-sigterm timed out. Skipping SIGKILL. Entering failed mode.", UNIT(s)->id);
2503 service_enter_dead(s, SERVICE_FAILURE_TIMEOUT, false);
2508 case SERVICE_FINAL_SIGKILL:
2509 log_warning_unit(UNIT(s)->id, "%s still around after final SIGKILL. Entering failed mode.", UNIT(s)->id);
2510 service_enter_dead(s, SERVICE_FAILURE_TIMEOUT, true);
2513 case SERVICE_AUTO_RESTART:
2514 log_info_unit(UNIT(s)->id,
2515 s->restart_usec > 0 ?
2516 "%s holdoff time over, scheduling restart." :
2517 "%s has no holdoff time, scheduling restart.",
2519 service_enter_restart(s);
2523 assert_not_reached("Timeout at wrong time.");
2529 static int service_dispatch_watchdog(sd_event_source *source, usec_t usec, void *userdata) {
2530 Service *s = SERVICE(userdata);
2531 char t[FORMAT_TIMESPAN_MAX];
2534 assert(source == s->watchdog_event_source);
2536 log_error_unit(UNIT(s)->id, "%s watchdog timeout (limit %s)!", UNIT(s)->id,
2537 format_timespan(t, sizeof(t), s->watchdog_usec, 1));
2539 service_enter_signal(s, SERVICE_STOP_SIGTERM, SERVICE_FAILURE_WATCHDOG);
2544 static void service_notify_message(Unit *u, pid_t pid, char **tags) {
2545 Service *s = SERVICE(u);
2546 _cleanup_free_ char *cc = NULL;
2547 bool notify_dbus = false;
2552 cc = strv_join(tags, ", ");
2553 log_debug_unit(u->id, "%s: Got notification message from PID "PID_FMT" (%s)",
2554 u->id, pid, isempty(cc) ? "n/a" : cc);
2556 if (s->notify_access == NOTIFY_NONE) {
2557 log_warning_unit(u->id, "%s: Got notification message from PID "PID_FMT", but reception is disabled.", u->id, pid);
2561 if (s->notify_access == NOTIFY_MAIN && pid != s->main_pid) {
2562 if (s->main_pid != 0)
2563 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);
2565 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);
2569 /* Interpret MAINPID= */
2570 e = strv_find_startswith(tags, "MAINPID=");
2571 if (e && IN_SET(s->state, SERVICE_START, SERVICE_START_POST, SERVICE_RUNNING, SERVICE_RELOAD)) {
2572 if (parse_pid(e, &pid) < 0)
2573 log_warning_unit(u->id, "Failed to parse MAINPID= field in notification message: %s", e);
2575 log_debug_unit(u->id, "%s: got MAINPID=%s", u->id, e);
2577 service_set_main_pid(s, pid);
2578 unit_watch_pid(UNIT(s), pid);
2583 /* Interpret RELOADING= */
2584 if (strv_find(tags, "RELOADING=1")) {
2586 log_debug_unit(u->id, "%s: got RELOADING=1", u->id);
2587 s->notify_state = NOTIFY_RELOADING;
2589 if (s->state == SERVICE_RUNNING)
2590 service_enter_reload_by_notify(s);
2595 /* Interpret READY= */
2596 if (strv_find(tags, "READY=1")) {
2598 log_debug_unit(u->id, "%s: got READY=1", u->id);
2599 s->notify_state = NOTIFY_READY;
2601 /* Type=notify services inform us about completed
2602 * initialization with READY=1 */
2603 if (s->type == SERVICE_NOTIFY && s->state == SERVICE_START)
2604 service_enter_start_post(s);
2606 /* Sending READY=1 while we are reloading informs us
2607 * that the reloading is complete */
2608 if (s->state == SERVICE_RELOAD && s->control_pid == 0)
2609 service_enter_running(s, SERVICE_SUCCESS);
2614 /* Interpret STOPPING= */
2615 if (strv_find(tags, "STOPPING=1")) {
2617 log_debug_unit(u->id, "%s: got STOPPING=1", u->id);
2618 s->notify_state = NOTIFY_STOPPING;
2620 if (s->state == SERVICE_RUNNING)
2621 service_enter_stop_by_notify(s);
2626 /* Interpret STATUS= */
2627 e = strv_find_startswith(tags, "STATUS=");
2629 _cleanup_free_ char *t = NULL;
2632 if (!utf8_is_valid(e))
2633 log_warning_unit(u->id, "Status message in notification is not UTF-8 clean.");
2635 log_debug_unit(u->id, "%s: got STATUS=%s", u->id, e);
2643 if (!streq_ptr(s->status_text, t)) {
2645 free(s->status_text);
2653 /* Interpret ERRNO= */
2654 e = strv_find_startswith(tags, "ERRNO=");
2658 if (safe_atoi(e, &status_errno) < 0 || status_errno < 0)
2659 log_warning_unit(u->id, "Failed to parse ERRNO= field in notification message: %s", e);
2661 log_debug_unit(u->id, "%s: got ERRNO=%s", u->id, e);
2663 if (s->status_errno != status_errno) {
2664 s->status_errno = status_errno;
2670 /* Interpret WATCHDOG= */
2671 if (strv_find(tags, "WATCHDOG=1")) {
2672 log_debug_unit(u->id, "%s: got WATCHDOG=1", u->id);
2673 service_reset_watchdog(s);
2676 /* Notify clients about changed status or main pid */
2678 unit_add_to_dbus_queue(u);
2681 static int service_get_timeout(Unit *u, uint64_t *timeout) {
2682 Service *s = SERVICE(u);
2685 if (!s->timer_event_source)
2688 r = sd_event_source_get_time(s->timer_event_source, timeout);
2695 static void service_bus_name_owner_change(
2698 const char *old_owner,
2699 const char *new_owner) {
2701 Service *s = SERVICE(u);
2707 assert(streq(s->bus_name, name));
2708 assert(old_owner || new_owner);
2710 if (old_owner && new_owner)
2711 log_debug_unit(u->id, "%s's D-Bus name %s changed owner from %s to %s", u->id, name, old_owner, new_owner);
2713 log_debug_unit(u->id, "%s's D-Bus name %s no longer registered by %s", u->id, name, old_owner);
2715 log_debug_unit(u->id, "%s's D-Bus name %s now registered by %s", u->id, name, new_owner);
2717 s->bus_name_good = !!new_owner;
2719 if (s->type == SERVICE_DBUS) {
2721 /* service_enter_running() will figure out what to
2723 if (s->state == SERVICE_RUNNING)
2724 service_enter_running(s, SERVICE_SUCCESS);
2725 else if (s->state == SERVICE_START && new_owner)
2726 service_enter_start_post(s);
2728 } else if (new_owner &&
2730 (s->state == SERVICE_START ||
2731 s->state == SERVICE_START_POST ||
2732 s->state == SERVICE_RUNNING ||
2733 s->state == SERVICE_RELOAD)) {
2735 _cleanup_bus_creds_unref_ sd_bus_creds *creds = NULL;
2738 /* Try to acquire PID from bus service */
2740 r = sd_bus_get_owner(u->manager->api_bus, name, SD_BUS_CREDS_PID, &creds);
2742 r = sd_bus_creds_get_pid(creds, &pid);
2744 log_debug_unit(u->id, "%s's D-Bus name %s is now owned by process %u", u->id, name, (unsigned) pid);
2746 service_set_main_pid(s, pid);
2747 unit_watch_pid(UNIT(s), pid);
2752 int service_set_socket_fd(Service *s, int fd, Socket *sock, bool selinux_context_net) {
2753 _cleanup_free_ char *peer = NULL;
2759 /* This is called by the socket code when instantiating a new
2760 * service for a stream socket and the socket needs to be
2763 if (UNIT(s)->load_state != UNIT_LOADED)
2766 if (s->socket_fd >= 0)
2769 if (s->state != SERVICE_DEAD)
2772 if (getpeername_pretty(fd, &peer) >= 0) {
2774 if (UNIT(s)->description) {
2775 _cleanup_free_ char *a;
2777 a = strjoin(UNIT(s)->description, " (", peer, ")", NULL);
2781 r = unit_set_description(UNIT(s), a);
2783 r = unit_set_description(UNIT(s), peer);
2790 s->socket_fd_selinux_context_net = selinux_context_net;
2792 unit_ref_set(&s->accept_socket, UNIT(sock));
2794 return unit_add_two_dependencies(UNIT(sock), UNIT_BEFORE, UNIT_TRIGGERS, UNIT(s), false);
2797 static void service_reset_failed(Unit *u) {
2798 Service *s = SERVICE(u);
2802 if (s->state == SERVICE_FAILED)
2803 service_set_state(s, SERVICE_DEAD);
2805 s->result = SERVICE_SUCCESS;
2806 s->reload_result = SERVICE_SUCCESS;
2808 RATELIMIT_RESET(s->start_limit);
2811 static int service_kill(Unit *u, KillWho who, int signo, sd_bus_error *error) {
2812 Service *s = SERVICE(u);
2814 return unit_kill_common(u, who, signo, s->main_pid, s->control_pid, error);
2817 static const char* const service_state_table[_SERVICE_STATE_MAX] = {
2818 [SERVICE_DEAD] = "dead",
2819 [SERVICE_START_PRE] = "start-pre",
2820 [SERVICE_START] = "start",
2821 [SERVICE_START_POST] = "start-post",
2822 [SERVICE_RUNNING] = "running",
2823 [SERVICE_EXITED] = "exited",
2824 [SERVICE_RELOAD] = "reload",
2825 [SERVICE_STOP] = "stop",
2826 [SERVICE_STOP_SIGTERM] = "stop-sigterm",
2827 [SERVICE_STOP_SIGKILL] = "stop-sigkill",
2828 [SERVICE_STOP_POST] = "stop-post",
2829 [SERVICE_FINAL_SIGTERM] = "final-sigterm",
2830 [SERVICE_FINAL_SIGKILL] = "final-sigkill",
2831 [SERVICE_FAILED] = "failed",
2832 [SERVICE_AUTO_RESTART] = "auto-restart",
2835 DEFINE_STRING_TABLE_LOOKUP(service_state, ServiceState);
2837 static const char* const service_restart_table[_SERVICE_RESTART_MAX] = {
2838 [SERVICE_RESTART_NO] = "no",
2839 [SERVICE_RESTART_ON_SUCCESS] = "on-success",
2840 [SERVICE_RESTART_ON_FAILURE] = "on-failure",
2841 [SERVICE_RESTART_ON_ABNORMAL] = "on-abnormal",
2842 [SERVICE_RESTART_ON_WATCHDOG] = "on-watchdog",
2843 [SERVICE_RESTART_ON_ABORT] = "on-abort",
2844 [SERVICE_RESTART_ALWAYS] = "always",
2847 DEFINE_STRING_TABLE_LOOKUP(service_restart, ServiceRestart);
2849 static const char* const service_type_table[_SERVICE_TYPE_MAX] = {
2850 [SERVICE_SIMPLE] = "simple",
2851 [SERVICE_FORKING] = "forking",
2852 [SERVICE_ONESHOT] = "oneshot",
2853 [SERVICE_DBUS] = "dbus",
2854 [SERVICE_NOTIFY] = "notify",
2855 [SERVICE_IDLE] = "idle"
2858 DEFINE_STRING_TABLE_LOOKUP(service_type, ServiceType);
2860 static const char* const service_exec_command_table[_SERVICE_EXEC_COMMAND_MAX] = {
2861 [SERVICE_EXEC_START_PRE] = "ExecStartPre",
2862 [SERVICE_EXEC_START] = "ExecStart",
2863 [SERVICE_EXEC_START_POST] = "ExecStartPost",
2864 [SERVICE_EXEC_RELOAD] = "ExecReload",
2865 [SERVICE_EXEC_STOP] = "ExecStop",
2866 [SERVICE_EXEC_STOP_POST] = "ExecStopPost",
2869 DEFINE_STRING_TABLE_LOOKUP(service_exec_command, ServiceExecCommand);
2871 static const char* const notify_access_table[_NOTIFY_ACCESS_MAX] = {
2872 [NOTIFY_NONE] = "none",
2873 [NOTIFY_MAIN] = "main",
2874 [NOTIFY_ALL] = "all"
2877 DEFINE_STRING_TABLE_LOOKUP(notify_access, NotifyAccess);
2879 static const char* const notify_state_table[_NOTIFY_STATE_MAX] = {
2880 [NOTIFY_UNKNOWN] = "unknown",
2881 [NOTIFY_READY] = "ready",
2882 [NOTIFY_RELOADING] = "reloading",
2883 [NOTIFY_STOPPING] = "stopping",
2886 DEFINE_STRING_TABLE_LOOKUP(notify_state, NotifyState);
2888 static const char* const service_result_table[_SERVICE_RESULT_MAX] = {
2889 [SERVICE_SUCCESS] = "success",
2890 [SERVICE_FAILURE_RESOURCES] = "resources",
2891 [SERVICE_FAILURE_TIMEOUT] = "timeout",
2892 [SERVICE_FAILURE_EXIT_CODE] = "exit-code",
2893 [SERVICE_FAILURE_SIGNAL] = "signal",
2894 [SERVICE_FAILURE_CORE_DUMP] = "core-dump",
2895 [SERVICE_FAILURE_WATCHDOG] = "watchdog",
2896 [SERVICE_FAILURE_START_LIMIT] = "start-limit"
2899 DEFINE_STRING_TABLE_LOOKUP(service_result, ServiceResult);
2901 const UnitVTable service_vtable = {
2902 .object_size = sizeof(Service),
2903 .exec_context_offset = offsetof(Service, exec_context),
2904 .cgroup_context_offset = offsetof(Service, cgroup_context),
2905 .kill_context_offset = offsetof(Service, kill_context),
2906 .exec_runtime_offset = offsetof(Service, exec_runtime),
2912 .private_section = "Service",
2914 .init = service_init,
2915 .done = service_done,
2916 .load = service_load,
2918 .coldplug = service_coldplug,
2920 .dump = service_dump,
2922 .start = service_start,
2923 .stop = service_stop,
2924 .reload = service_reload,
2926 .can_reload = service_can_reload,
2928 .kill = service_kill,
2930 .serialize = service_serialize,
2931 .deserialize_item = service_deserialize_item,
2933 .active_state = service_active_state,
2934 .sub_state_to_string = service_sub_state_to_string,
2936 .check_gc = service_check_gc,
2937 .check_snapshot = service_check_snapshot,
2939 .sigchld_event = service_sigchld_event,
2941 .reset_failed = service_reset_failed,
2943 .notify_cgroup_empty = service_notify_cgroup_empty_event,
2944 .notify_message = service_notify_message,
2946 .bus_name_owner_change = service_bus_name_owner_change,
2948 .bus_interface = "org.freedesktop.systemd1.Service",
2949 .bus_vtable = bus_service_vtable,
2950 .bus_set_property = bus_service_set_property,
2951 .bus_commit_properties = bus_service_commit_properties,
2953 .get_timeout = service_get_timeout,
2954 .can_transient = true,
2956 .status_message_formats = {
2957 .starting_stopping = {
2958 [0] = "Starting %s...",
2959 [1] = "Stopping %s...",
2961 .finished_start_job = {
2962 [JOB_DONE] = "Started %s.",
2963 [JOB_FAILED] = "Failed to start %s.",
2964 [JOB_DEPENDENCY] = "Dependency failed for %s.",
2965 [JOB_TIMEOUT] = "Timed out starting %s.",
2967 .finished_stop_job = {
2968 [JOB_DONE] = "Stopped %s.",
2969 [JOB_FAILED] = "Stopped (with error) %s.",
2970 [JOB_TIMEOUT] = "Timed out stopping %s.",