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/>.
29 #include "sd-messages.h"
34 #include "path-util.h"
35 #include "load-fragment.h"
36 #include "load-dropin.h"
38 #include "unit-name.h"
39 #include "dbus-unit.h"
41 #include "cgroup-util.h"
44 #include "fileio-label.h"
45 #include "bus-common-errors.h"
49 #include "formats-util.h"
50 #include "process-util.h"
52 const UnitVTable
* const unit_vtable
[_UNIT_TYPE_MAX
] = {
53 [UNIT_SERVICE
] = &service_vtable
,
54 [UNIT_SOCKET
] = &socket_vtable
,
55 [UNIT_BUSNAME
] = &busname_vtable
,
56 [UNIT_TARGET
] = &target_vtable
,
57 [UNIT_SNAPSHOT
] = &snapshot_vtable
,
58 [UNIT_DEVICE
] = &device_vtable
,
59 [UNIT_MOUNT
] = &mount_vtable
,
60 [UNIT_AUTOMOUNT
] = &automount_vtable
,
61 [UNIT_SWAP
] = &swap_vtable
,
62 [UNIT_TIMER
] = &timer_vtable
,
63 [UNIT_PATH
] = &path_vtable
,
64 [UNIT_SLICE
] = &slice_vtable
,
65 [UNIT_SCOPE
] = &scope_vtable
68 static void maybe_warn_about_dependency(Unit
*u
, const char *other
, UnitDependency dependency
);
70 Unit
*unit_new(Manager
*m
, size_t size
) {
74 assert(size
>= sizeof(Unit
));
80 u
->names
= set_new(&string_hash_ops
);
87 u
->type
= _UNIT_TYPE_INVALID
;
88 u
->default_dependencies
= true;
89 u
->unit_file_state
= _UNIT_FILE_STATE_INVALID
;
90 u
->unit_file_preset
= -1;
91 u
->on_failure_job_mode
= JOB_REPLACE
;
93 RATELIMIT_INIT(u
->auto_stop_ratelimit
, 10 * USEC_PER_SEC
, 16);
98 bool unit_has_name(Unit
*u
, const char *name
) {
102 return !!set_get(u
->names
, (char*) name
);
105 static void unit_init(Unit
*u
) {
112 assert(u
->type
>= 0);
114 cc
= unit_get_cgroup_context(u
);
116 cgroup_context_init(cc
);
118 /* Copy in the manager defaults into the cgroup
119 * context, _before_ the rest of the settings have
120 * been initialized */
122 cc
->cpu_accounting
= u
->manager
->default_cpu_accounting
;
123 cc
->blockio_accounting
= u
->manager
->default_blockio_accounting
;
124 cc
->memory_accounting
= u
->manager
->default_memory_accounting
;
127 ec
= unit_get_exec_context(u
);
129 exec_context_init(ec
);
131 kc
= unit_get_kill_context(u
);
133 kill_context_init(kc
);
135 if (UNIT_VTABLE(u
)->init
)
136 UNIT_VTABLE(u
)->init(u
);
139 int unit_add_name(Unit
*u
, const char *text
) {
140 _cleanup_free_
char *s
= NULL
, *i
= NULL
;
147 if (unit_name_is_valid(text
, UNIT_NAME_TEMPLATE
)) {
152 r
= unit_name_replace_instance(text
, u
->instance
, &s
);
161 if (set_contains(u
->names
, s
))
163 if (hashmap_contains(u
->manager
->units
, s
))
166 if (!unit_name_is_valid(s
, UNIT_NAME_PLAIN
|UNIT_NAME_INSTANCE
))
169 t
= unit_name_to_type(s
);
173 if (u
->type
!= _UNIT_TYPE_INVALID
&& t
!= u
->type
)
176 r
= unit_name_to_instance(s
, &i
);
180 if (i
&& unit_vtable
[t
]->no_instances
)
183 /* Ensure that this unit is either instanced or not instanced,
184 * but not both. Note that we do allow names with different
185 * instance names however! */
186 if (u
->type
!= _UNIT_TYPE_INVALID
&& !u
->instance
!= !i
)
189 if (unit_vtable
[t
]->no_alias
&& !set_isempty(u
->names
))
192 if (hashmap_size(u
->manager
->units
) >= MANAGER_MAX_NAMES
)
195 r
= set_put(u
->names
, s
);
200 r
= hashmap_put(u
->manager
->units
, s
, u
);
202 (void) set_remove(u
->names
, s
);
206 if (u
->type
== _UNIT_TYPE_INVALID
) {
211 LIST_PREPEND(units_by_type
, u
->manager
->units_by_type
[t
], u
);
220 unit_add_to_dbus_queue(u
);
224 int unit_choose_id(Unit
*u
, const char *name
) {
225 _cleanup_free_
char *t
= NULL
;
232 if (unit_name_is_valid(name
, UNIT_NAME_TEMPLATE
)) {
237 r
= unit_name_replace_instance(name
, u
->instance
, &t
);
244 /* Selects one of the names of this unit as the id */
245 s
= set_get(u
->names
, (char*) name
);
249 /* Determine the new instance from the new id */
250 r
= unit_name_to_instance(s
, &i
);
259 unit_add_to_dbus_queue(u
);
264 int unit_set_description(Unit
*u
, const char *description
) {
269 if (isempty(description
))
272 s
= strdup(description
);
277 free(u
->description
);
280 unit_add_to_dbus_queue(u
);
284 bool unit_check_gc(Unit
*u
) {
285 UnitActiveState state
;
294 state
= unit_active_state(u
);
296 /* If the unit is inactive and failed and no job is queued for
297 * it, then release its runtime resources */
298 if (UNIT_IS_INACTIVE_OR_FAILED(state
) &&
299 UNIT_VTABLE(u
)->release_resources
)
300 UNIT_VTABLE(u
)->release_resources(u
);
302 /* But we keep the unit object around for longer when it is
303 * referenced or configured to not be gc'ed */
304 if (state
!= UNIT_INACTIVE
)
307 if (UNIT_VTABLE(u
)->no_gc
)
316 if (UNIT_VTABLE(u
)->check_gc
)
317 if (UNIT_VTABLE(u
)->check_gc(u
))
323 void unit_add_to_load_queue(Unit
*u
) {
325 assert(u
->type
!= _UNIT_TYPE_INVALID
);
327 if (u
->load_state
!= UNIT_STUB
|| u
->in_load_queue
)
330 LIST_PREPEND(load_queue
, u
->manager
->load_queue
, u
);
331 u
->in_load_queue
= true;
334 void unit_add_to_cleanup_queue(Unit
*u
) {
337 if (u
->in_cleanup_queue
)
340 LIST_PREPEND(cleanup_queue
, u
->manager
->cleanup_queue
, u
);
341 u
->in_cleanup_queue
= true;
344 void unit_add_to_gc_queue(Unit
*u
) {
347 if (u
->in_gc_queue
|| u
->in_cleanup_queue
)
350 if (unit_check_gc(u
))
353 LIST_PREPEND(gc_queue
, u
->manager
->gc_queue
, u
);
354 u
->in_gc_queue
= true;
356 u
->manager
->n_in_gc_queue
++;
359 void unit_add_to_dbus_queue(Unit
*u
) {
361 assert(u
->type
!= _UNIT_TYPE_INVALID
);
363 if (u
->load_state
== UNIT_STUB
|| u
->in_dbus_queue
)
366 /* Shortcut things if nobody cares */
367 if (sd_bus_track_count(u
->manager
->subscribed
) <= 0 &&
368 set_isempty(u
->manager
->private_buses
)) {
369 u
->sent_dbus_new_signal
= true;
373 LIST_PREPEND(dbus_queue
, u
->manager
->dbus_unit_queue
, u
);
374 u
->in_dbus_queue
= true;
377 static void bidi_set_free(Unit
*u
, Set
*s
) {
383 /* Frees the set and makes sure we are dropped from the
384 * inverse pointers */
386 SET_FOREACH(other
, s
, i
) {
389 for (d
= 0; d
< _UNIT_DEPENDENCY_MAX
; d
++)
390 set_remove(other
->dependencies
[d
], u
);
392 unit_add_to_gc_queue(other
);
398 static void unit_remove_transient(Unit
*u
) {
406 if (u
->fragment_path
)
407 unlink(u
->fragment_path
);
409 STRV_FOREACH(i
, u
->dropin_paths
) {
410 _cleanup_free_
char *p
= NULL
;
415 r
= path_get_parent(*i
, &p
);
421 static void unit_free_requires_mounts_for(Unit
*u
) {
424 STRV_FOREACH(j
, u
->requires_mounts_for
) {
425 char s
[strlen(*j
) + 1];
427 PATH_FOREACH_PREFIX_MORE(s
, *j
) {
431 x
= hashmap_get2(u
->manager
->units_requiring_mounts_for
, s
, (void**) &y
);
437 if (set_isempty(x
)) {
438 hashmap_remove(u
->manager
->units_requiring_mounts_for
, y
);
445 strv_free(u
->requires_mounts_for
);
446 u
->requires_mounts_for
= NULL
;
449 static void unit_done(Unit
*u
) {
458 if (UNIT_VTABLE(u
)->done
)
459 UNIT_VTABLE(u
)->done(u
);
461 ec
= unit_get_exec_context(u
);
463 exec_context_done(ec
);
465 cc
= unit_get_cgroup_context(u
);
467 cgroup_context_done(cc
);
470 void unit_free(Unit
*u
) {
477 if (u
->manager
->n_reloading
<= 0)
478 unit_remove_transient(u
);
480 bus_unit_send_removed_signal(u
);
484 unit_free_requires_mounts_for(u
);
486 SET_FOREACH(t
, u
->names
, i
)
487 hashmap_remove_value(u
->manager
->units
, t
, u
);
501 for (d
= 0; d
< _UNIT_DEPENDENCY_MAX
; d
++)
502 bidi_set_free(u
, u
->dependencies
[d
]);
504 if (u
->type
!= _UNIT_TYPE_INVALID
)
505 LIST_REMOVE(units_by_type
, u
->manager
->units_by_type
[u
->type
], u
);
507 if (u
->in_load_queue
)
508 LIST_REMOVE(load_queue
, u
->manager
->load_queue
, u
);
510 if (u
->in_dbus_queue
)
511 LIST_REMOVE(dbus_queue
, u
->manager
->dbus_unit_queue
, u
);
513 if (u
->in_cleanup_queue
)
514 LIST_REMOVE(cleanup_queue
, u
->manager
->cleanup_queue
, u
);
516 if (u
->in_gc_queue
) {
517 LIST_REMOVE(gc_queue
, u
->manager
->gc_queue
, u
);
518 u
->manager
->n_in_gc_queue
--;
521 if (u
->in_cgroup_queue
)
522 LIST_REMOVE(cgroup_queue
, u
->manager
->cgroup_queue
, u
);
524 if (u
->cgroup_path
) {
525 hashmap_remove(u
->manager
->cgroup_unit
, u
->cgroup_path
);
526 free(u
->cgroup_path
);
529 manager_update_failed_units(u
->manager
, u
, false);
530 set_remove(u
->manager
->startup_units
, u
);
532 free(u
->description
);
533 strv_free(u
->documentation
);
534 free(u
->fragment_path
);
535 free(u
->source_path
);
536 strv_free(u
->dropin_paths
);
539 free(u
->job_timeout_reboot_arg
);
541 set_free_free(u
->names
);
543 unit_unwatch_all_pids(u
);
545 condition_free_list(u
->conditions
);
546 condition_free_list(u
->asserts
);
548 unit_ref_unset(&u
->slice
);
551 unit_ref_unset(u
->refs
);
556 UnitActiveState
unit_active_state(Unit
*u
) {
559 if (u
->load_state
== UNIT_MERGED
)
560 return unit_active_state(unit_follow_merge(u
));
562 /* After a reload it might happen that a unit is not correctly
563 * loaded but still has a process around. That's why we won't
564 * shortcut failed loading to UNIT_INACTIVE_FAILED. */
566 return UNIT_VTABLE(u
)->active_state(u
);
569 const char* unit_sub_state_to_string(Unit
*u
) {
572 return UNIT_VTABLE(u
)->sub_state_to_string(u
);
575 static int complete_move(Set
**s
, Set
**other
) {
585 r
= set_move(*s
, *other
);
596 static int merge_names(Unit
*u
, Unit
*other
) {
604 r
= complete_move(&u
->names
, &other
->names
);
608 set_free_free(other
->names
);
612 SET_FOREACH(t
, u
->names
, i
)
613 assert_se(hashmap_replace(u
->manager
->units
, t
, u
) == 0);
618 static int reserve_dependencies(Unit
*u
, Unit
*other
, UnitDependency d
) {
623 assert(d
< _UNIT_DEPENDENCY_MAX
);
626 * If u does not have this dependency set allocated, there is no need
627 * to reserve anything. In that case other's set will be transferred
628 * as a whole to u by complete_move().
630 if (!u
->dependencies
[d
])
633 /* merge_dependencies() will skip a u-on-u dependency */
634 n_reserve
= set_size(other
->dependencies
[d
]) - !!set_get(other
->dependencies
[d
], u
);
636 return set_reserve(u
->dependencies
[d
], n_reserve
);
639 static void merge_dependencies(Unit
*u
, Unit
*other
, const char *other_id
, UnitDependency d
) {
646 assert(d
< _UNIT_DEPENDENCY_MAX
);
648 /* Fix backwards pointers */
649 SET_FOREACH(back
, other
->dependencies
[d
], i
) {
652 for (k
= 0; k
< _UNIT_DEPENDENCY_MAX
; k
++) {
653 /* Do not add dependencies between u and itself */
655 if (set_remove(back
->dependencies
[k
], other
))
656 maybe_warn_about_dependency(u
, other_id
, k
);
658 r
= set_remove_and_put(back
->dependencies
[k
], other
, u
);
660 set_remove(back
->dependencies
[k
], other
);
662 assert(r
>= 0 || r
== -ENOENT
);
667 /* Also do not move dependencies on u to itself */
668 back
= set_remove(other
->dependencies
[d
], u
);
670 maybe_warn_about_dependency(u
, other_id
, d
);
672 /* The move cannot fail. The caller must have performed a reservation. */
673 assert_se(complete_move(&u
->dependencies
[d
], &other
->dependencies
[d
]) == 0);
675 set_free(other
->dependencies
[d
]);
676 other
->dependencies
[d
] = NULL
;
679 int unit_merge(Unit
*u
, Unit
*other
) {
681 const char *other_id
= NULL
;
686 assert(u
->manager
== other
->manager
);
687 assert(u
->type
!= _UNIT_TYPE_INVALID
);
689 other
= unit_follow_merge(other
);
694 if (u
->type
!= other
->type
)
697 if (!u
->instance
!= !other
->instance
)
700 if (other
->load_state
!= UNIT_STUB
&&
701 other
->load_state
!= UNIT_NOT_FOUND
)
710 if (!UNIT_IS_INACTIVE_OR_FAILED(unit_active_state(other
)))
714 other_id
= strdupa(other
->id
);
716 /* Make reservations to ensure merge_dependencies() won't fail */
717 for (d
= 0; d
< _UNIT_DEPENDENCY_MAX
; d
++) {
718 r
= reserve_dependencies(u
, other
, d
);
720 * We don't rollback reservations if we fail. We don't have
721 * a way to undo reservations. A reservation is not a leak.
728 r
= merge_names(u
, other
);
732 /* Redirect all references */
734 unit_ref_set(other
->refs
, u
);
736 /* Merge dependencies */
737 for (d
= 0; d
< _UNIT_DEPENDENCY_MAX
; d
++)
738 merge_dependencies(u
, other
, other_id
, d
);
740 other
->load_state
= UNIT_MERGED
;
741 other
->merged_into
= u
;
743 /* If there is still some data attached to the other node, we
744 * don't need it anymore, and can free it. */
745 if (other
->load_state
!= UNIT_STUB
)
746 if (UNIT_VTABLE(other
)->done
)
747 UNIT_VTABLE(other
)->done(other
);
749 unit_add_to_dbus_queue(u
);
750 unit_add_to_cleanup_queue(other
);
755 int unit_merge_by_name(Unit
*u
, const char *name
) {
758 _cleanup_free_
char *s
= NULL
;
763 if (unit_name_is_valid(name
, UNIT_NAME_TEMPLATE
)) {
767 r
= unit_name_replace_instance(name
, u
->instance
, &s
);
774 other
= manager_get_unit(u
->manager
, name
);
776 return unit_merge(u
, other
);
778 return unit_add_name(u
, name
);
781 Unit
* unit_follow_merge(Unit
*u
) {
784 while (u
->load_state
== UNIT_MERGED
)
785 assert_se(u
= u
->merged_into
);
790 int unit_add_exec_dependencies(Unit
*u
, ExecContext
*c
) {
796 if (c
->working_directory
) {
797 r
= unit_require_mounts_for(u
, c
->working_directory
);
802 if (c
->root_directory
) {
803 r
= unit_require_mounts_for(u
, c
->root_directory
);
808 if (u
->manager
->running_as
!= MANAGER_SYSTEM
)
811 if (c
->private_tmp
) {
812 r
= unit_require_mounts_for(u
, "/tmp");
816 r
= unit_require_mounts_for(u
, "/var/tmp");
821 if (c
->std_output
!= EXEC_OUTPUT_KMSG
&&
822 c
->std_output
!= EXEC_OUTPUT_SYSLOG
&&
823 c
->std_output
!= EXEC_OUTPUT_JOURNAL
&&
824 c
->std_output
!= EXEC_OUTPUT_KMSG_AND_CONSOLE
&&
825 c
->std_output
!= EXEC_OUTPUT_SYSLOG_AND_CONSOLE
&&
826 c
->std_output
!= EXEC_OUTPUT_JOURNAL_AND_CONSOLE
&&
827 c
->std_error
!= EXEC_OUTPUT_KMSG
&&
828 c
->std_error
!= EXEC_OUTPUT_SYSLOG
&&
829 c
->std_error
!= EXEC_OUTPUT_JOURNAL
&&
830 c
->std_error
!= EXEC_OUTPUT_KMSG_AND_CONSOLE
&&
831 c
->std_error
!= EXEC_OUTPUT_JOURNAL_AND_CONSOLE
&&
832 c
->std_error
!= EXEC_OUTPUT_SYSLOG_AND_CONSOLE
)
835 /* If syslog or kernel logging is requested, make sure our own
836 * logging daemon is run first. */
838 r
= unit_add_dependency_by_name(u
, UNIT_AFTER
, SPECIAL_JOURNALD_SOCKET
, NULL
, true);
845 const char *unit_description(Unit
*u
) {
849 return u
->description
;
854 void unit_dump(Unit
*u
, FILE *f
, const char *prefix
) {
860 timestamp1
[FORMAT_TIMESTAMP_MAX
],
861 timestamp2
[FORMAT_TIMESTAMP_MAX
],
862 timestamp3
[FORMAT_TIMESTAMP_MAX
],
863 timestamp4
[FORMAT_TIMESTAMP_MAX
],
864 timespan
[FORMAT_TIMESPAN_MAX
];
866 _cleanup_set_free_ Set
*following_set
= NULL
;
870 assert(u
->type
>= 0);
872 prefix
= strempty(prefix
);
873 prefix2
= strjoina(prefix
, "\t");
877 "%s\tDescription: %s\n"
879 "%s\tUnit Load State: %s\n"
880 "%s\tUnit Active State: %s\n"
881 "%s\tInactive Exit Timestamp: %s\n"
882 "%s\tActive Enter Timestamp: %s\n"
883 "%s\tActive Exit Timestamp: %s\n"
884 "%s\tInactive Enter Timestamp: %s\n"
885 "%s\tGC Check Good: %s\n"
886 "%s\tNeed Daemon Reload: %s\n"
887 "%s\tTransient: %s\n"
890 "%s\tCGroup realized: %s\n"
891 "%s\tCGroup mask: 0x%x\n"
892 "%s\tCGroup members mask: 0x%x\n",
894 prefix
, unit_description(u
),
895 prefix
, strna(u
->instance
),
896 prefix
, unit_load_state_to_string(u
->load_state
),
897 prefix
, unit_active_state_to_string(unit_active_state(u
)),
898 prefix
, strna(format_timestamp(timestamp1
, sizeof(timestamp1
), u
->inactive_exit_timestamp
.realtime
)),
899 prefix
, strna(format_timestamp(timestamp2
, sizeof(timestamp2
), u
->active_enter_timestamp
.realtime
)),
900 prefix
, strna(format_timestamp(timestamp3
, sizeof(timestamp3
), u
->active_exit_timestamp
.realtime
)),
901 prefix
, strna(format_timestamp(timestamp4
, sizeof(timestamp4
), u
->inactive_enter_timestamp
.realtime
)),
902 prefix
, yes_no(unit_check_gc(u
)),
903 prefix
, yes_no(unit_need_daemon_reload(u
)),
904 prefix
, yes_no(u
->transient
),
905 prefix
, strna(unit_slice_name(u
)),
906 prefix
, strna(u
->cgroup_path
),
907 prefix
, yes_no(u
->cgroup_realized
),
908 prefix
, u
->cgroup_realized_mask
,
909 prefix
, u
->cgroup_members_mask
);
911 SET_FOREACH(t
, u
->names
, i
)
912 fprintf(f
, "%s\tName: %s\n", prefix
, t
);
914 STRV_FOREACH(j
, u
->documentation
)
915 fprintf(f
, "%s\tDocumentation: %s\n", prefix
, *j
);
917 following
= unit_following(u
);
919 fprintf(f
, "%s\tFollowing: %s\n", prefix
, following
->id
);
921 r
= unit_following_set(u
, &following_set
);
925 SET_FOREACH(other
, following_set
, i
)
926 fprintf(f
, "%s\tFollowing Set Member: %s\n", prefix
, other
->id
);
929 if (u
->fragment_path
)
930 fprintf(f
, "%s\tFragment Path: %s\n", prefix
, u
->fragment_path
);
933 fprintf(f
, "%s\tSource Path: %s\n", prefix
, u
->source_path
);
935 STRV_FOREACH(j
, u
->dropin_paths
)
936 fprintf(f
, "%s\tDropIn Path: %s\n", prefix
, *j
);
938 if (u
->job_timeout
> 0)
939 fprintf(f
, "%s\tJob Timeout: %s\n", prefix
, format_timespan(timespan
, sizeof(timespan
), u
->job_timeout
, 0));
941 if (u
->job_timeout_action
!= FAILURE_ACTION_NONE
)
942 fprintf(f
, "%s\tJob Timeout Action: %s\n", prefix
, failure_action_to_string(u
->job_timeout_action
));
944 if (u
->job_timeout_reboot_arg
)
945 fprintf(f
, "%s\tJob Timeout Reboot Argument: %s\n", prefix
, u
->job_timeout_reboot_arg
);
947 condition_dump_list(u
->conditions
, f
, prefix
, condition_type_to_string
);
948 condition_dump_list(u
->asserts
, f
, prefix
, assert_type_to_string
);
950 if (dual_timestamp_is_set(&u
->condition_timestamp
))
952 "%s\tCondition Timestamp: %s\n"
953 "%s\tCondition Result: %s\n",
954 prefix
, strna(format_timestamp(timestamp1
, sizeof(timestamp1
), u
->condition_timestamp
.realtime
)),
955 prefix
, yes_no(u
->condition_result
));
957 if (dual_timestamp_is_set(&u
->assert_timestamp
))
959 "%s\tAssert Timestamp: %s\n"
960 "%s\tAssert Result: %s\n",
961 prefix
, strna(format_timestamp(timestamp1
, sizeof(timestamp1
), u
->assert_timestamp
.realtime
)),
962 prefix
, yes_no(u
->assert_result
));
964 for (d
= 0; d
< _UNIT_DEPENDENCY_MAX
; d
++) {
967 SET_FOREACH(other
, u
->dependencies
[d
], i
)
968 fprintf(f
, "%s\t%s: %s\n", prefix
, unit_dependency_to_string(d
), other
->id
);
971 if (!strv_isempty(u
->requires_mounts_for
)) {
973 "%s\tRequiresMountsFor:", prefix
);
975 STRV_FOREACH(j
, u
->requires_mounts_for
)
976 fprintf(f
, " %s", *j
);
981 if (u
->load_state
== UNIT_LOADED
) {
984 "%s\tStopWhenUnneeded: %s\n"
985 "%s\tRefuseManualStart: %s\n"
986 "%s\tRefuseManualStop: %s\n"
987 "%s\tDefaultDependencies: %s\n"
988 "%s\tOnFailureJobMode: %s\n"
989 "%s\tIgnoreOnIsolate: %s\n"
990 "%s\tIgnoreOnSnapshot: %s\n",
991 prefix
, yes_no(u
->stop_when_unneeded
),
992 prefix
, yes_no(u
->refuse_manual_start
),
993 prefix
, yes_no(u
->refuse_manual_stop
),
994 prefix
, yes_no(u
->default_dependencies
),
995 prefix
, job_mode_to_string(u
->on_failure_job_mode
),
996 prefix
, yes_no(u
->ignore_on_isolate
),
997 prefix
, yes_no(u
->ignore_on_snapshot
));
999 if (UNIT_VTABLE(u
)->dump
)
1000 UNIT_VTABLE(u
)->dump(u
, f
, prefix2
);
1002 } else if (u
->load_state
== UNIT_MERGED
)
1004 "%s\tMerged into: %s\n",
1005 prefix
, u
->merged_into
->id
);
1006 else if (u
->load_state
== UNIT_ERROR
)
1007 fprintf(f
, "%s\tLoad Error Code: %s\n", prefix
, strerror(-u
->load_error
));
1011 job_dump(u
->job
, f
, prefix2
);
1014 job_dump(u
->nop_job
, f
, prefix2
);
1018 /* Common implementation for multiple backends */
1019 int unit_load_fragment_and_dropin(Unit
*u
) {
1024 /* Load a .{service,socket,...} file */
1025 r
= unit_load_fragment(u
);
1029 if (u
->load_state
== UNIT_STUB
)
1032 /* Load drop-in directory data */
1033 r
= unit_load_dropin(unit_follow_merge(u
));
1040 /* Common implementation for multiple backends */
1041 int unit_load_fragment_and_dropin_optional(Unit
*u
) {
1046 /* Same as unit_load_fragment_and_dropin(), but whether
1047 * something can be loaded or not doesn't matter. */
1049 /* Load a .service file */
1050 r
= unit_load_fragment(u
);
1054 if (u
->load_state
== UNIT_STUB
)
1055 u
->load_state
= UNIT_LOADED
;
1057 /* Load drop-in directory data */
1058 r
= unit_load_dropin(unit_follow_merge(u
));
1065 int unit_add_default_target_dependency(Unit
*u
, Unit
*target
) {
1069 if (target
->type
!= UNIT_TARGET
)
1072 /* Only add the dependency if both units are loaded, so that
1073 * that loop check below is reliable */
1074 if (u
->load_state
!= UNIT_LOADED
||
1075 target
->load_state
!= UNIT_LOADED
)
1078 /* If either side wants no automatic dependencies, then let's
1080 if (!u
->default_dependencies
||
1081 !target
->default_dependencies
)
1084 /* Don't create loops */
1085 if (set_get(target
->dependencies
[UNIT_BEFORE
], u
))
1088 return unit_add_dependency(target
, UNIT_AFTER
, u
, true);
1091 static int unit_add_target_dependencies(Unit
*u
) {
1093 static const UnitDependency deps
[] = {
1095 UNIT_REQUIRED_BY_OVERRIDABLE
,
1097 UNIT_REQUISITE_OF_OVERRIDABLE
,
1109 for (k
= 0; k
< ELEMENTSOF(deps
); k
++)
1110 SET_FOREACH(target
, u
->dependencies
[deps
[k
]], i
) {
1111 r
= unit_add_default_target_dependency(u
, target
);
1119 static int unit_add_slice_dependencies(Unit
*u
) {
1122 if (!unit_get_cgroup_context(u
))
1125 if (UNIT_ISSET(u
->slice
))
1126 return unit_add_two_dependencies(u
, UNIT_AFTER
, UNIT_WANTS
, UNIT_DEREF(u
->slice
), true);
1128 if (streq(u
->id
, SPECIAL_ROOT_SLICE
))
1131 return unit_add_two_dependencies_by_name(u
, UNIT_AFTER
, UNIT_WANTS
, SPECIAL_ROOT_SLICE
, NULL
, true);
1134 static int unit_add_mount_dependencies(Unit
*u
) {
1140 STRV_FOREACH(i
, u
->requires_mounts_for
) {
1141 char prefix
[strlen(*i
) + 1];
1143 PATH_FOREACH_PREFIX_MORE(prefix
, *i
) {
1146 r
= manager_get_unit_by_path(u
->manager
, prefix
, ".mount", &m
);
1154 if (m
->load_state
!= UNIT_LOADED
)
1157 r
= unit_add_dependency(u
, UNIT_AFTER
, m
, true);
1161 if (m
->fragment_path
) {
1162 r
= unit_add_dependency(u
, UNIT_REQUIRES
, m
, true);
1172 static int unit_add_startup_units(Unit
*u
) {
1175 c
= unit_get_cgroup_context(u
);
1179 if (c
->startup_cpu_shares
== (unsigned long) -1 &&
1180 c
->startup_blockio_weight
== (unsigned long) -1)
1183 return set_put(u
->manager
->startup_units
, u
);
1186 int unit_load(Unit
*u
) {
1191 if (u
->in_load_queue
) {
1192 LIST_REMOVE(load_queue
, u
->manager
->load_queue
, u
);
1193 u
->in_load_queue
= false;
1196 if (u
->type
== _UNIT_TYPE_INVALID
)
1199 if (u
->load_state
!= UNIT_STUB
)
1202 if (UNIT_VTABLE(u
)->load
) {
1203 r
= UNIT_VTABLE(u
)->load(u
);
1208 if (u
->load_state
== UNIT_STUB
) {
1213 if (u
->load_state
== UNIT_LOADED
) {
1215 r
= unit_add_target_dependencies(u
);
1219 r
= unit_add_slice_dependencies(u
);
1223 r
= unit_add_mount_dependencies(u
);
1227 r
= unit_add_startup_units(u
);
1231 if (u
->on_failure_job_mode
== JOB_ISOLATE
&& set_size(u
->dependencies
[UNIT_ON_FAILURE
]) > 1) {
1232 log_unit_error(u
, "More than one OnFailure= dependencies specified but OnFailureJobMode=isolate set. Refusing.");
1237 unit_update_cgroup_members_masks(u
);
1240 assert((u
->load_state
!= UNIT_MERGED
) == !u
->merged_into
);
1242 unit_add_to_dbus_queue(unit_follow_merge(u
));
1243 unit_add_to_gc_queue(u
);
1248 u
->load_state
= u
->load_state
== UNIT_STUB
? UNIT_NOT_FOUND
: UNIT_ERROR
;
1250 unit_add_to_dbus_queue(u
);
1251 unit_add_to_gc_queue(u
);
1253 log_unit_debug_errno(u
, r
, "Failed to load configuration: %m");
1258 static bool unit_condition_test_list(Unit
*u
, Condition
*first
, const char *(*to_string
)(ConditionType t
)) {
1265 /* If the condition list is empty, then it is true */
1269 /* Otherwise, if all of the non-trigger conditions apply and
1270 * if any of the trigger conditions apply (unless there are
1271 * none) we return true */
1272 LIST_FOREACH(conditions
, c
, first
) {
1275 r
= condition_test(c
);
1278 "Couldn't determine result for %s=%s%s%s, assuming failed: %m",
1280 c
->trigger
? "|" : "",
1281 c
->negate
? "!" : "",
1287 c
->trigger
? "|" : "",
1288 c
->negate
? "!" : "",
1290 condition_result_to_string(c
->result
));
1292 if (!c
->trigger
&& r
<= 0)
1295 if (c
->trigger
&& triggered
<= 0)
1299 return triggered
!= 0;
1302 static bool unit_condition_test(Unit
*u
) {
1305 dual_timestamp_get(&u
->condition_timestamp
);
1306 u
->condition_result
= unit_condition_test_list(u
, u
->conditions
, condition_type_to_string
);
1308 return u
->condition_result
;
1311 static bool unit_assert_test(Unit
*u
) {
1314 dual_timestamp_get(&u
->assert_timestamp
);
1315 u
->assert_result
= unit_condition_test_list(u
, u
->asserts
, assert_type_to_string
);
1317 return u
->assert_result
;
1320 _pure_
static const char* unit_get_status_message_format(Unit
*u
, JobType t
) {
1322 const UnitStatusMessageFormats
*format_table
;
1325 assert(t
== JOB_START
|| t
== JOB_STOP
|| t
== JOB_RELOAD
);
1327 if (t
!= JOB_RELOAD
) {
1328 format_table
= &UNIT_VTABLE(u
)->status_message_formats
;
1330 format
= format_table
->starting_stopping
[t
== JOB_STOP
];
1336 /* Return generic strings */
1338 return "Starting %s.";
1339 else if (t
== JOB_STOP
)
1340 return "Stopping %s.";
1342 return "Reloading %s.";
1345 static void unit_status_print_starting_stopping(Unit
*u
, JobType t
) {
1350 format
= unit_get_status_message_format(u
, t
);
1352 DISABLE_WARNING_FORMAT_NONLITERAL
;
1353 unit_status_printf(u
, "", format
);
1357 static void unit_status_log_starting_stopping_reloading(Unit
*u
, JobType t
) {
1364 if (t
!= JOB_START
&& t
!= JOB_STOP
&& t
!= JOB_RELOAD
)
1367 if (log_on_console())
1370 /* We log status messages for all units and all operations. */
1372 format
= unit_get_status_message_format(u
, t
);
1374 DISABLE_WARNING_FORMAT_NONLITERAL
;
1375 snprintf(buf
, sizeof(buf
), format
, unit_description(u
));
1378 mid
= t
== JOB_START
? SD_MESSAGE_UNIT_STARTING
:
1379 t
== JOB_STOP
? SD_MESSAGE_UNIT_STOPPING
:
1380 SD_MESSAGE_UNIT_RELOADING
;
1382 /* Note that we deliberately use LOG_MESSAGE() instead of
1383 * LOG_UNIT_MESSAGE() here, since this is supposed to mimic
1384 * closely what is written to screen using the status output,
1385 * which is supposed the highest level, friendliest output
1386 * possible, which means we should avoid the low-level unit
1388 log_struct(LOG_INFO
,
1389 LOG_MESSAGE_ID(mid
),
1391 LOG_MESSAGE("%s", buf
),
1395 void unit_status_emit_starting_stopping_reloading(Unit
*u
, JobType t
) {
1397 unit_status_log_starting_stopping_reloading(u
, t
);
1399 /* Reload status messages have traditionally not been printed to console. */
1400 if (t
!= JOB_RELOAD
)
1401 unit_status_print_starting_stopping(u
, t
);
1405 * -EBADR: This unit type does not support starting.
1406 * -EALREADY: Unit is already started.
1407 * -EAGAIN: An operation is already in progress. Retry later.
1408 * -ECANCELED: Too many requests for now.
1409 * -EPROTO: Assert failed
1411 int unit_start(Unit
*u
) {
1412 UnitActiveState state
;
1417 if (u
->load_state
!= UNIT_LOADED
)
1420 /* If this is already started, then this will succeed. Note
1421 * that this will even succeed if this unit is not startable
1422 * by the user. This is relied on to detect when we need to
1423 * wait for units and when waiting is finished. */
1424 state
= unit_active_state(u
);
1425 if (UNIT_IS_ACTIVE_OR_RELOADING(state
))
1428 /* If the conditions failed, don't do anything at all. If we
1429 * already are activating this call might still be useful to
1430 * speed up activation in case there is some hold-off time,
1431 * but we don't want to recheck the condition in that case. */
1432 if (state
!= UNIT_ACTIVATING
&&
1433 !unit_condition_test(u
)) {
1434 log_unit_debug(u
, "Starting requested but condition failed. Not starting unit.");
1438 /* If the asserts failed, fail the entire job */
1439 if (state
!= UNIT_ACTIVATING
&&
1440 !unit_assert_test(u
)) {
1441 log_unit_notice(u
, "Starting requested but asserts failed.");
1445 /* Forward to the main object, if we aren't it. */
1446 following
= unit_following(u
);
1448 log_unit_debug(u
, "Redirecting start request from %s to %s.", u
->id
, following
->id
);
1449 return unit_start(following
);
1452 if (!unit_supported(u
))
1455 /* If it is stopped, but we cannot start it, then fail */
1456 if (!UNIT_VTABLE(u
)->start
)
1459 /* We don't suppress calls to ->start() here when we are
1460 * already starting, to allow this request to be used as a
1461 * "hurry up" call, for example when the unit is in some "auto
1462 * restart" state where it waits for a holdoff timer to elapse
1463 * before it will start again. */
1465 unit_add_to_dbus_queue(u
);
1467 return UNIT_VTABLE(u
)->start(u
);
1470 bool unit_can_start(Unit
*u
) {
1473 return !!UNIT_VTABLE(u
)->start
;
1476 bool unit_can_isolate(Unit
*u
) {
1479 return unit_can_start(u
) &&
1484 * -EBADR: This unit type does not support stopping.
1485 * -EALREADY: Unit is already stopped.
1486 * -EAGAIN: An operation is already in progress. Retry later.
1488 int unit_stop(Unit
*u
) {
1489 UnitActiveState state
;
1494 state
= unit_active_state(u
);
1495 if (UNIT_IS_INACTIVE_OR_FAILED(state
))
1498 following
= unit_following(u
);
1500 log_unit_debug(u
, "Redirecting stop request from %s to %s.", u
->id
, following
->id
);
1501 return unit_stop(following
);
1504 if (!UNIT_VTABLE(u
)->stop
)
1507 unit_add_to_dbus_queue(u
);
1509 return UNIT_VTABLE(u
)->stop(u
);
1513 * -EBADR: This unit type does not support reloading.
1514 * -ENOEXEC: Unit is not started.
1515 * -EAGAIN: An operation is already in progress. Retry later.
1517 int unit_reload(Unit
*u
) {
1518 UnitActiveState state
;
1523 if (u
->load_state
!= UNIT_LOADED
)
1526 if (!unit_can_reload(u
))
1529 state
= unit_active_state(u
);
1530 if (state
== UNIT_RELOADING
)
1533 if (state
!= UNIT_ACTIVE
) {
1534 log_unit_warning(u
, "Unit cannot be reloaded because it is inactive.");
1538 following
= unit_following(u
);
1540 log_unit_debug(u
, "Redirecting reload request from %s to %s.", u
->id
, following
->id
);
1541 return unit_reload(following
);
1544 unit_add_to_dbus_queue(u
);
1546 return UNIT_VTABLE(u
)->reload(u
);
1549 bool unit_can_reload(Unit
*u
) {
1552 if (!UNIT_VTABLE(u
)->reload
)
1555 if (!UNIT_VTABLE(u
)->can_reload
)
1558 return UNIT_VTABLE(u
)->can_reload(u
);
1561 static void unit_check_unneeded(Unit
*u
) {
1563 static const UnitDependency needed_dependencies
[] = {
1565 UNIT_REQUIRED_BY_OVERRIDABLE
,
1567 UNIT_REQUISITE_OF_OVERRIDABLE
,
1579 /* If this service shall be shut down when unneeded then do
1582 if (!u
->stop_when_unneeded
)
1585 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u
)))
1588 for (j
= 0; j
< ELEMENTSOF(needed_dependencies
); j
++)
1589 SET_FOREACH(other
, u
->dependencies
[needed_dependencies
[j
]], i
)
1590 if (unit_active_or_pending(other
))
1593 /* If stopping a unit fails continously we might enter a stop
1594 * loop here, hence stop acting on the service being
1595 * unnecessary after a while. */
1596 if (!ratelimit_test(&u
->auto_stop_ratelimit
)) {
1597 log_unit_warning(u
, "Unit not needed anymore, but not stopping since we tried this too often recently.");
1601 log_unit_info(u
, "Unit not needed anymore. Stopping.");
1603 /* Ok, nobody needs us anymore. Sniff. Then let's commit suicide */
1604 r
= manager_add_job(u
->manager
, JOB_STOP
, u
, JOB_FAIL
, true, NULL
, NULL
);
1606 log_unit_warning_errno(u
, r
, "Failed to enqueue stop job, ignoring: %m");
1609 static void unit_check_binds_to(Unit
*u
) {
1620 if (unit_active_state(u
) != UNIT_ACTIVE
)
1623 SET_FOREACH(other
, u
->dependencies
[UNIT_BINDS_TO
], i
) {
1627 if (!UNIT_IS_INACTIVE_OR_FAILED(unit_active_state(other
)))
1637 /* If stopping a unit fails continously we might enter a stop
1638 * loop here, hence stop acting on the service being
1639 * unnecessary after a while. */
1640 if (!ratelimit_test(&u
->auto_stop_ratelimit
)) {
1641 log_unit_warning(u
, "Unit is bound to inactive unit %s, but not stopping since we tried this too often recently.", other
->id
);
1646 log_unit_info(u
, "Unit is bound to inactive unit %s. Stopping, too.", other
->id
);
1648 /* A unit we need to run is gone. Sniff. Let's stop this. */
1649 r
= manager_add_job(u
->manager
, JOB_STOP
, u
, JOB_FAIL
, true, NULL
, NULL
);
1651 log_unit_warning_errno(u
, r
, "Failed to enqueue stop job, ignoring: %m");
1654 static void retroactively_start_dependencies(Unit
*u
) {
1659 assert(UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u
)));
1661 SET_FOREACH(other
, u
->dependencies
[UNIT_REQUIRES
], i
)
1662 if (!set_get(u
->dependencies
[UNIT_AFTER
], other
) &&
1663 !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other
)))
1664 manager_add_job(u
->manager
, JOB_START
, other
, JOB_REPLACE
, true, NULL
, NULL
);
1666 SET_FOREACH(other
, u
->dependencies
[UNIT_BINDS_TO
], i
)
1667 if (!set_get(u
->dependencies
[UNIT_AFTER
], other
) &&
1668 !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other
)))
1669 manager_add_job(u
->manager
, JOB_START
, other
, JOB_REPLACE
, true, NULL
, NULL
);
1671 SET_FOREACH(other
, u
->dependencies
[UNIT_REQUIRES_OVERRIDABLE
], i
)
1672 if (!set_get(u
->dependencies
[UNIT_AFTER
], other
) &&
1673 !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other
)))
1674 manager_add_job(u
->manager
, JOB_START
, other
, JOB_FAIL
, false, NULL
, NULL
);
1676 SET_FOREACH(other
, u
->dependencies
[UNIT_WANTS
], i
)
1677 if (!set_get(u
->dependencies
[UNIT_AFTER
], other
) &&
1678 !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other
)))
1679 manager_add_job(u
->manager
, JOB_START
, other
, JOB_FAIL
, false, NULL
, NULL
);
1681 SET_FOREACH(other
, u
->dependencies
[UNIT_CONFLICTS
], i
)
1682 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1683 manager_add_job(u
->manager
, JOB_STOP
, other
, JOB_REPLACE
, true, NULL
, NULL
);
1685 SET_FOREACH(other
, u
->dependencies
[UNIT_CONFLICTED_BY
], i
)
1686 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1687 manager_add_job(u
->manager
, JOB_STOP
, other
, JOB_REPLACE
, true, NULL
, NULL
);
1690 static void retroactively_stop_dependencies(Unit
*u
) {
1695 assert(UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u
)));
1697 /* Pull down units which are bound to us recursively if enabled */
1698 SET_FOREACH(other
, u
->dependencies
[UNIT_BOUND_BY
], i
)
1699 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1700 manager_add_job(u
->manager
, JOB_STOP
, other
, JOB_REPLACE
, true, NULL
, NULL
);
1703 static void check_unneeded_dependencies(Unit
*u
) {
1708 assert(UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u
)));
1710 /* Garbage collect services that might not be needed anymore, if enabled */
1711 SET_FOREACH(other
, u
->dependencies
[UNIT_REQUIRES
], i
)
1712 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1713 unit_check_unneeded(other
);
1714 SET_FOREACH(other
, u
->dependencies
[UNIT_REQUIRES_OVERRIDABLE
], i
)
1715 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1716 unit_check_unneeded(other
);
1717 SET_FOREACH(other
, u
->dependencies
[UNIT_WANTS
], i
)
1718 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1719 unit_check_unneeded(other
);
1720 SET_FOREACH(other
, u
->dependencies
[UNIT_REQUISITE
], i
)
1721 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1722 unit_check_unneeded(other
);
1723 SET_FOREACH(other
, u
->dependencies
[UNIT_REQUISITE_OVERRIDABLE
], i
)
1724 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1725 unit_check_unneeded(other
);
1726 SET_FOREACH(other
, u
->dependencies
[UNIT_BINDS_TO
], i
)
1727 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other
)))
1728 unit_check_unneeded(other
);
1731 void unit_start_on_failure(Unit
*u
) {
1737 if (set_size(u
->dependencies
[UNIT_ON_FAILURE
]) <= 0)
1740 log_unit_info(u
, "Triggering OnFailure= dependencies.");
1742 SET_FOREACH(other
, u
->dependencies
[UNIT_ON_FAILURE
], i
) {
1745 r
= manager_add_job(u
->manager
, JOB_START
, other
, u
->on_failure_job_mode
, true, NULL
, NULL
);
1747 log_unit_error_errno(u
, r
, "Failed to enqueue OnFailure= job: %m");
1751 void unit_trigger_notify(Unit
*u
) {
1757 SET_FOREACH(other
, u
->dependencies
[UNIT_TRIGGERED_BY
], i
)
1758 if (UNIT_VTABLE(other
)->trigger_notify
)
1759 UNIT_VTABLE(other
)->trigger_notify(other
, u
);
1762 void unit_notify(Unit
*u
, UnitActiveState os
, UnitActiveState ns
, bool reload_success
) {
1767 assert(os
< _UNIT_ACTIVE_STATE_MAX
);
1768 assert(ns
< _UNIT_ACTIVE_STATE_MAX
);
1770 /* Note that this is called for all low-level state changes,
1771 * even if they might map to the same high-level
1772 * UnitActiveState! That means that ns == os is an expected
1773 * behavior here. For example: if a mount point is remounted
1774 * this function will be called too! */
1778 /* Update timestamps for state changes */
1779 if (m
->n_reloading
<= 0) {
1782 dual_timestamp_get(&ts
);
1784 if (UNIT_IS_INACTIVE_OR_FAILED(os
) && !UNIT_IS_INACTIVE_OR_FAILED(ns
))
1785 u
->inactive_exit_timestamp
= ts
;
1786 else if (!UNIT_IS_INACTIVE_OR_FAILED(os
) && UNIT_IS_INACTIVE_OR_FAILED(ns
))
1787 u
->inactive_enter_timestamp
= ts
;
1789 if (!UNIT_IS_ACTIVE_OR_RELOADING(os
) && UNIT_IS_ACTIVE_OR_RELOADING(ns
))
1790 u
->active_enter_timestamp
= ts
;
1791 else if (UNIT_IS_ACTIVE_OR_RELOADING(os
) && !UNIT_IS_ACTIVE_OR_RELOADING(ns
))
1792 u
->active_exit_timestamp
= ts
;
1795 /* Keep track of failed units */
1796 manager_update_failed_units(u
->manager
, u
, ns
== UNIT_FAILED
);
1798 /* Make sure the cgroup is always removed when we become inactive */
1799 if (UNIT_IS_INACTIVE_OR_FAILED(ns
))
1800 unit_destroy_cgroup_if_empty(u
);
1802 /* Note that this doesn't apply to RemainAfterExit services exiting
1803 * successfully, since there's no change of state in that case. Which is
1804 * why it is handled in service_set_state() */
1805 if (UNIT_IS_INACTIVE_OR_FAILED(os
) != UNIT_IS_INACTIVE_OR_FAILED(ns
)) {
1808 ec
= unit_get_exec_context(u
);
1809 if (ec
&& exec_context_may_touch_console(ec
)) {
1810 if (UNIT_IS_INACTIVE_OR_FAILED(ns
)) {
1813 if (m
->n_on_console
== 0)
1814 /* unset no_console_output flag, since the console is free */
1815 m
->no_console_output
= false;
1824 if (u
->job
->state
== JOB_WAITING
)
1826 /* So we reached a different state for this
1827 * job. Let's see if we can run it now if it
1828 * failed previously due to EAGAIN. */
1829 job_add_to_run_queue(u
->job
);
1831 /* Let's check whether this state change constitutes a
1832 * finished job, or maybe contradicts a running job and
1833 * hence needs to invalidate jobs. */
1835 switch (u
->job
->type
) {
1838 case JOB_VERIFY_ACTIVE
:
1840 if (UNIT_IS_ACTIVE_OR_RELOADING(ns
))
1841 job_finish_and_invalidate(u
->job
, JOB_DONE
, true);
1842 else if (u
->job
->state
== JOB_RUNNING
&& ns
!= UNIT_ACTIVATING
) {
1845 if (UNIT_IS_INACTIVE_OR_FAILED(ns
))
1846 job_finish_and_invalidate(u
->job
, ns
== UNIT_FAILED
? JOB_FAILED
: JOB_DONE
, true);
1852 case JOB_RELOAD_OR_START
:
1854 if (u
->job
->state
== JOB_RUNNING
) {
1855 if (ns
== UNIT_ACTIVE
)
1856 job_finish_and_invalidate(u
->job
, reload_success
? JOB_DONE
: JOB_FAILED
, true);
1857 else if (ns
!= UNIT_ACTIVATING
&& ns
!= UNIT_RELOADING
) {
1860 if (UNIT_IS_INACTIVE_OR_FAILED(ns
))
1861 job_finish_and_invalidate(u
->job
, ns
== UNIT_FAILED
? JOB_FAILED
: JOB_DONE
, true);
1869 case JOB_TRY_RESTART
:
1871 if (UNIT_IS_INACTIVE_OR_FAILED(ns
))
1872 job_finish_and_invalidate(u
->job
, JOB_DONE
, true);
1873 else if (u
->job
->state
== JOB_RUNNING
&& ns
!= UNIT_DEACTIVATING
) {
1875 job_finish_and_invalidate(u
->job
, JOB_FAILED
, true);
1881 assert_not_reached("Job type unknown");
1887 if (m
->n_reloading
<= 0) {
1889 /* If this state change happened without being
1890 * requested by a job, then let's retroactively start
1891 * or stop dependencies. We skip that step when
1892 * deserializing, since we don't want to create any
1893 * additional jobs just because something is already
1897 if (UNIT_IS_INACTIVE_OR_FAILED(os
) && UNIT_IS_ACTIVE_OR_ACTIVATING(ns
))
1898 retroactively_start_dependencies(u
);
1899 else if (UNIT_IS_ACTIVE_OR_ACTIVATING(os
) && UNIT_IS_INACTIVE_OR_DEACTIVATING(ns
))
1900 retroactively_stop_dependencies(u
);
1903 /* stop unneeded units regardless if going down was expected or not */
1904 if (UNIT_IS_INACTIVE_OR_DEACTIVATING(ns
))
1905 check_unneeded_dependencies(u
);
1907 if (ns
!= os
&& ns
== UNIT_FAILED
) {
1908 log_unit_notice(u
, "Unit entered failed state.");
1909 unit_start_on_failure(u
);
1913 /* Some names are special */
1914 if (UNIT_IS_ACTIVE_OR_RELOADING(ns
)) {
1916 if (unit_has_name(u
, SPECIAL_DBUS_SERVICE
))
1917 /* The bus might have just become available,
1918 * hence try to connect to it, if we aren't
1922 if (u
->type
== UNIT_SERVICE
&&
1923 !UNIT_IS_ACTIVE_OR_RELOADING(os
) &&
1924 m
->n_reloading
<= 0) {
1925 /* Write audit record if we have just finished starting up */
1926 manager_send_unit_audit(m
, u
, AUDIT_SERVICE_START
, true);
1930 if (!UNIT_IS_ACTIVE_OR_RELOADING(os
))
1931 manager_send_unit_plymouth(m
, u
);
1935 /* We don't care about D-Bus here, since we'll get an
1936 * asynchronous notification for it anyway. */
1938 if (u
->type
== UNIT_SERVICE
&&
1939 UNIT_IS_INACTIVE_OR_FAILED(ns
) &&
1940 !UNIT_IS_INACTIVE_OR_FAILED(os
) &&
1941 m
->n_reloading
<= 0) {
1943 /* Hmm, if there was no start record written
1944 * write it now, so that we always have a nice
1947 manager_send_unit_audit(m
, u
, AUDIT_SERVICE_START
, ns
== UNIT_INACTIVE
);
1949 if (ns
== UNIT_INACTIVE
)
1950 manager_send_unit_audit(m
, u
, AUDIT_SERVICE_STOP
, true);
1952 /* Write audit record if we have just finished shutting down */
1953 manager_send_unit_audit(m
, u
, AUDIT_SERVICE_STOP
, ns
== UNIT_INACTIVE
);
1955 u
->in_audit
= false;
1959 manager_recheck_journal(m
);
1960 unit_trigger_notify(u
);
1962 if (u
->manager
->n_reloading
<= 0) {
1963 /* Maybe we finished startup and are now ready for
1964 * being stopped because unneeded? */
1965 unit_check_unneeded(u
);
1967 /* Maybe we finished startup, but something we needed
1968 * has vanished? Let's die then. (This happens when
1969 * something BindsTo= to a Type=oneshot unit, as these
1970 * units go directly from starting to inactive,
1971 * without ever entering started.) */
1972 unit_check_binds_to(u
);
1975 unit_add_to_dbus_queue(u
);
1976 unit_add_to_gc_queue(u
);
1979 int unit_watch_pid(Unit
*u
, pid_t pid
) {
1985 /* Watch a specific PID. We only support one or two units
1986 * watching each PID for now, not more. */
1988 r
= set_ensure_allocated(&u
->pids
, NULL
);
1992 r
= hashmap_ensure_allocated(&u
->manager
->watch_pids1
, NULL
);
1996 r
= hashmap_put(u
->manager
->watch_pids1
, LONG_TO_PTR(pid
), u
);
1998 r
= hashmap_ensure_allocated(&u
->manager
->watch_pids2
, NULL
);
2002 r
= hashmap_put(u
->manager
->watch_pids2
, LONG_TO_PTR(pid
), u
);
2005 q
= set_put(u
->pids
, LONG_TO_PTR(pid
));
2012 void unit_unwatch_pid(Unit
*u
, pid_t pid
) {
2016 hashmap_remove_value(u
->manager
->watch_pids1
, LONG_TO_PTR(pid
), u
);
2017 hashmap_remove_value(u
->manager
->watch_pids2
, LONG_TO_PTR(pid
), u
);
2018 set_remove(u
->pids
, LONG_TO_PTR(pid
));
2021 void unit_unwatch_all_pids(Unit
*u
) {
2024 while (!set_isempty(u
->pids
))
2025 unit_unwatch_pid(u
, PTR_TO_LONG(set_first(u
->pids
)));
2031 static int unit_watch_pids_in_path(Unit
*u
, const char *path
) {
2032 _cleanup_closedir_
DIR *d
= NULL
;
2033 _cleanup_fclose_
FILE *f
= NULL
;
2039 /* Adds all PIDs from a specific cgroup path to the set of PIDs we watch. */
2041 r
= cg_enumerate_processes(SYSTEMD_CGROUP_CONTROLLER
, path
, &f
);
2045 while ((r
= cg_read_pid(f
, &pid
)) > 0) {
2046 r
= unit_watch_pid(u
, pid
);
2047 if (r
< 0 && ret
>= 0)
2050 if (r
< 0 && ret
>= 0)
2053 } else if (ret
>= 0)
2056 r
= cg_enumerate_subgroups(SYSTEMD_CGROUP_CONTROLLER
, path
, &d
);
2060 while ((r
= cg_read_subgroup(d
, &fn
)) > 0) {
2061 _cleanup_free_
char *p
= NULL
;
2063 p
= strjoin(path
, "/", fn
, NULL
);
2069 r
= unit_watch_pids_in_path(u
, p
);
2070 if (r
< 0 && ret
>= 0)
2073 if (r
< 0 && ret
>= 0)
2076 } else if (ret
>= 0)
2082 int unit_watch_all_pids(Unit
*u
) {
2085 /* Adds all PIDs from our cgroup to the set of PIDs we watch */
2087 if (!u
->cgroup_path
)
2090 return unit_watch_pids_in_path(u
, u
->cgroup_path
);
2093 void unit_tidy_watch_pids(Unit
*u
, pid_t except1
, pid_t except2
) {
2099 /* Cleans dead PIDs from our list */
2101 SET_FOREACH(e
, u
->pids
, i
) {
2102 pid_t pid
= PTR_TO_LONG(e
);
2104 if (pid
== except1
|| pid
== except2
)
2107 if (!pid_is_unwaited(pid
))
2108 unit_unwatch_pid(u
, pid
);
2112 bool unit_job_is_applicable(Unit
*u
, JobType j
) {
2114 assert(j
>= 0 && j
< _JOB_TYPE_MAX
);
2118 case JOB_VERIFY_ACTIVE
:
2125 case JOB_TRY_RESTART
:
2126 return unit_can_start(u
);
2129 return unit_can_reload(u
);
2131 case JOB_RELOAD_OR_START
:
2132 return unit_can_reload(u
) && unit_can_start(u
);
2135 assert_not_reached("Invalid job type");
2139 static void maybe_warn_about_dependency(Unit
*u
, const char *other
, UnitDependency dependency
) {
2142 /* Only warn about some unit types */
2143 if (!IN_SET(dependency
, UNIT_CONFLICTS
, UNIT_CONFLICTED_BY
, UNIT_BEFORE
, UNIT_AFTER
, UNIT_ON_FAILURE
, UNIT_TRIGGERS
, UNIT_TRIGGERED_BY
))
2146 if (streq_ptr(u
->id
, other
))
2147 log_unit_warning(u
, "Dependency %s=%s dropped", unit_dependency_to_string(dependency
), u
->id
);
2149 log_unit_warning(u
, "Dependency %s=%s dropped, merged into %s", unit_dependency_to_string(dependency
), strna(other
), u
->id
);
2152 int unit_add_dependency(Unit
*u
, UnitDependency d
, Unit
*other
, bool add_reference
) {
2154 static const UnitDependency inverse_table
[_UNIT_DEPENDENCY_MAX
] = {
2155 [UNIT_REQUIRES
] = UNIT_REQUIRED_BY
,
2156 [UNIT_REQUIRES_OVERRIDABLE
] = UNIT_REQUIRED_BY_OVERRIDABLE
,
2157 [UNIT_WANTS
] = UNIT_WANTED_BY
,
2158 [UNIT_REQUISITE
] = UNIT_REQUISITE_OF
,
2159 [UNIT_REQUISITE_OVERRIDABLE
] = UNIT_REQUISITE_OF_OVERRIDABLE
,
2160 [UNIT_BINDS_TO
] = UNIT_BOUND_BY
,
2161 [UNIT_PART_OF
] = UNIT_CONSISTS_OF
,
2162 [UNIT_REQUIRED_BY
] = UNIT_REQUIRES
,
2163 [UNIT_REQUIRED_BY_OVERRIDABLE
] = UNIT_REQUIRES_OVERRIDABLE
,
2164 [UNIT_REQUISITE_OF
] = UNIT_REQUISITE
,
2165 [UNIT_REQUISITE_OF_OVERRIDABLE
] = UNIT_REQUISITE_OVERRIDABLE
,
2166 [UNIT_WANTED_BY
] = UNIT_WANTS
,
2167 [UNIT_BOUND_BY
] = UNIT_BINDS_TO
,
2168 [UNIT_CONSISTS_OF
] = UNIT_PART_OF
,
2169 [UNIT_CONFLICTS
] = UNIT_CONFLICTED_BY
,
2170 [UNIT_CONFLICTED_BY
] = UNIT_CONFLICTS
,
2171 [UNIT_BEFORE
] = UNIT_AFTER
,
2172 [UNIT_AFTER
] = UNIT_BEFORE
,
2173 [UNIT_ON_FAILURE
] = _UNIT_DEPENDENCY_INVALID
,
2174 [UNIT_REFERENCES
] = UNIT_REFERENCED_BY
,
2175 [UNIT_REFERENCED_BY
] = UNIT_REFERENCES
,
2176 [UNIT_TRIGGERS
] = UNIT_TRIGGERED_BY
,
2177 [UNIT_TRIGGERED_BY
] = UNIT_TRIGGERS
,
2178 [UNIT_PROPAGATES_RELOAD_TO
] = UNIT_RELOAD_PROPAGATED_FROM
,
2179 [UNIT_RELOAD_PROPAGATED_FROM
] = UNIT_PROPAGATES_RELOAD_TO
,
2180 [UNIT_JOINS_NAMESPACE_OF
] = UNIT_JOINS_NAMESPACE_OF
,
2182 int r
, q
= 0, v
= 0, w
= 0;
2183 Unit
*orig_u
= u
, *orig_other
= other
;
2186 assert(d
>= 0 && d
< _UNIT_DEPENDENCY_MAX
);
2189 u
= unit_follow_merge(u
);
2190 other
= unit_follow_merge(other
);
2192 /* We won't allow dependencies on ourselves. We will not
2193 * consider them an error however. */
2195 maybe_warn_about_dependency(orig_u
, orig_other
->id
, d
);
2199 r
= set_ensure_allocated(&u
->dependencies
[d
], NULL
);
2203 if (inverse_table
[d
] != _UNIT_DEPENDENCY_INVALID
) {
2204 r
= set_ensure_allocated(&other
->dependencies
[inverse_table
[d
]], NULL
);
2209 if (add_reference
) {
2210 r
= set_ensure_allocated(&u
->dependencies
[UNIT_REFERENCES
], NULL
);
2214 r
= set_ensure_allocated(&other
->dependencies
[UNIT_REFERENCED_BY
], NULL
);
2219 q
= set_put(u
->dependencies
[d
], other
);
2223 if (inverse_table
[d
] != _UNIT_DEPENDENCY_INVALID
&& inverse_table
[d
] != d
) {
2224 v
= set_put(other
->dependencies
[inverse_table
[d
]], u
);
2231 if (add_reference
) {
2232 w
= set_put(u
->dependencies
[UNIT_REFERENCES
], other
);
2238 r
= set_put(other
->dependencies
[UNIT_REFERENCED_BY
], u
);
2243 unit_add_to_dbus_queue(u
);
2248 set_remove(u
->dependencies
[d
], other
);
2251 set_remove(other
->dependencies
[inverse_table
[d
]], u
);
2254 set_remove(u
->dependencies
[UNIT_REFERENCES
], other
);
2259 int unit_add_two_dependencies(Unit
*u
, UnitDependency d
, UnitDependency e
, Unit
*other
, bool add_reference
) {
2264 r
= unit_add_dependency(u
, d
, other
, add_reference
);
2268 return unit_add_dependency(u
, e
, other
, add_reference
);
2271 static int resolve_template(Unit
*u
, const char *name
, const char*path
, char **buf
, const char **ret
) {
2275 assert(name
|| path
);
2280 name
= basename(path
);
2282 if (!unit_name_is_valid(name
, UNIT_NAME_TEMPLATE
)) {
2289 r
= unit_name_replace_instance(name
, u
->instance
, buf
);
2291 _cleanup_free_
char *i
= NULL
;
2293 r
= unit_name_to_prefix(u
->id
, &i
);
2297 r
= unit_name_replace_instance(name
, i
, buf
);
2306 int unit_add_dependency_by_name(Unit
*u
, UnitDependency d
, const char *name
, const char *path
, bool add_reference
) {
2307 _cleanup_free_
char *buf
= NULL
;
2312 assert(name
|| path
);
2314 r
= resolve_template(u
, name
, path
, &buf
, &name
);
2318 r
= manager_load_unit(u
->manager
, name
, path
, NULL
, &other
);
2322 return unit_add_dependency(u
, d
, other
, add_reference
);
2325 int unit_add_two_dependencies_by_name(Unit
*u
, UnitDependency d
, UnitDependency e
, const char *name
, const char *path
, bool add_reference
) {
2326 _cleanup_free_
char *buf
= NULL
;
2331 assert(name
|| path
);
2333 r
= resolve_template(u
, name
, path
, &buf
, &name
);
2337 r
= manager_load_unit(u
->manager
, name
, path
, NULL
, &other
);
2341 return unit_add_two_dependencies(u
, d
, e
, other
, add_reference
);
2344 int unit_add_dependency_by_name_inverse(Unit
*u
, UnitDependency d
, const char *name
, const char *path
, bool add_reference
) {
2345 _cleanup_free_
char *buf
= NULL
;
2350 assert(name
|| path
);
2352 r
= resolve_template(u
, name
, path
, &buf
, &name
);
2356 r
= manager_load_unit(u
->manager
, name
, path
, NULL
, &other
);
2360 return unit_add_dependency(other
, d
, u
, add_reference
);
2363 int unit_add_two_dependencies_by_name_inverse(Unit
*u
, UnitDependency d
, UnitDependency e
, const char *name
, const char *path
, bool add_reference
) {
2364 _cleanup_free_
char *buf
= NULL
;
2369 assert(name
|| path
);
2371 r
= resolve_template(u
, name
, path
, &buf
, &name
);
2375 r
= manager_load_unit(u
->manager
, name
, path
, NULL
, &other
);
2379 return unit_add_two_dependencies(other
, d
, e
, u
, add_reference
);
2382 int set_unit_path(const char *p
) {
2383 /* This is mostly for debug purposes */
2384 if (setenv("SYSTEMD_UNIT_PATH", p
, 0) < 0)
2390 char *unit_dbus_path(Unit
*u
) {
2396 return unit_dbus_path_from_name(u
->id
);
2399 char *unit_default_cgroup_path(Unit
*u
) {
2400 _cleanup_free_
char *escaped
= NULL
, *slice
= NULL
;
2405 if (unit_has_name(u
, SPECIAL_ROOT_SLICE
))
2406 return strdup(u
->manager
->cgroup_root
);
2408 if (UNIT_ISSET(u
->slice
) && !unit_has_name(UNIT_DEREF(u
->slice
), SPECIAL_ROOT_SLICE
)) {
2409 r
= cg_slice_to_path(UNIT_DEREF(u
->slice
)->id
, &slice
);
2414 escaped
= cg_escape(u
->id
);
2419 return strjoin(u
->manager
->cgroup_root
, "/", slice
, "/", escaped
, NULL
);
2421 return strjoin(u
->manager
->cgroup_root
, "/", escaped
, NULL
);
2424 int unit_add_default_slice(Unit
*u
, CGroupContext
*c
) {
2425 _cleanup_free_
char *b
= NULL
;
2426 const char *slice_name
;
2433 if (UNIT_ISSET(u
->slice
))
2437 _cleanup_free_
char *prefix
= NULL
, *escaped
= NULL
;
2439 /* Implicitly place all instantiated units in their
2440 * own per-template slice */
2442 r
= unit_name_to_prefix(u
->id
, &prefix
);
2446 /* The prefix is already escaped, but it might include
2447 * "-" which has a special meaning for slice units,
2448 * hence escape it here extra. */
2449 escaped
= unit_name_escape(prefix
);
2453 if (u
->manager
->running_as
== MANAGER_SYSTEM
)
2454 b
= strjoin("system-", escaped
, ".slice", NULL
);
2456 b
= strappend(escaped
, ".slice");
2463 u
->manager
->running_as
== MANAGER_SYSTEM
2464 ? SPECIAL_SYSTEM_SLICE
2465 : SPECIAL_ROOT_SLICE
;
2467 r
= manager_load_unit(u
->manager
, slice_name
, NULL
, NULL
, &slice
);
2471 unit_ref_set(&u
->slice
, slice
);
2475 const char *unit_slice_name(Unit
*u
) {
2478 if (!UNIT_ISSET(u
->slice
))
2481 return UNIT_DEREF(u
->slice
)->id
;
2484 int unit_load_related_unit(Unit
*u
, const char *type
, Unit
**_found
) {
2485 _cleanup_free_
char *t
= NULL
;
2492 r
= unit_name_change_suffix(u
->id
, type
, &t
);
2495 if (unit_has_name(u
, t
))
2498 r
= manager_load_unit(u
->manager
, t
, NULL
, NULL
, _found
);
2499 assert(r
< 0 || *_found
!= u
);
2503 int unit_watch_bus_name(Unit
*u
, const char *name
) {
2507 /* Watch a specific name on the bus. We only support one unit
2508 * watching each name for now. */
2510 return hashmap_put(u
->manager
->watch_bus
, name
, u
);
2513 void unit_unwatch_bus_name(Unit
*u
, const char *name
) {
2517 hashmap_remove_value(u
->manager
->watch_bus
, name
, u
);
2520 bool unit_can_serialize(Unit
*u
) {
2523 return UNIT_VTABLE(u
)->serialize
&& UNIT_VTABLE(u
)->deserialize_item
;
2526 int unit_serialize(Unit
*u
, FILE *f
, FDSet
*fds
, bool serialize_jobs
) {
2533 if (unit_can_serialize(u
)) {
2536 r
= UNIT_VTABLE(u
)->serialize(u
, f
, fds
);
2540 rt
= unit_get_exec_runtime(u
);
2542 r
= exec_runtime_serialize(u
, rt
, f
, fds
);
2548 dual_timestamp_serialize(f
, "inactive-exit-timestamp", &u
->inactive_exit_timestamp
);
2549 dual_timestamp_serialize(f
, "active-enter-timestamp", &u
->active_enter_timestamp
);
2550 dual_timestamp_serialize(f
, "active-exit-timestamp", &u
->active_exit_timestamp
);
2551 dual_timestamp_serialize(f
, "inactive-enter-timestamp", &u
->inactive_enter_timestamp
);
2552 dual_timestamp_serialize(f
, "condition-timestamp", &u
->condition_timestamp
);
2553 dual_timestamp_serialize(f
, "assert-timestamp", &u
->assert_timestamp
);
2555 if (dual_timestamp_is_set(&u
->condition_timestamp
))
2556 unit_serialize_item(u
, f
, "condition-result", yes_no(u
->condition_result
));
2558 if (dual_timestamp_is_set(&u
->assert_timestamp
))
2559 unit_serialize_item(u
, f
, "assert-result", yes_no(u
->assert_result
));
2561 unit_serialize_item(u
, f
, "transient", yes_no(u
->transient
));
2562 unit_serialize_item_format(u
, f
, "cpuacct-usage-base", "%" PRIu64
, u
->cpuacct_usage_base
);
2565 unit_serialize_item(u
, f
, "cgroup", u
->cgroup_path
);
2566 unit_serialize_item(u
, f
, "cgroup-realized", yes_no(u
->cgroup_realized
));
2568 if (serialize_jobs
) {
2570 fprintf(f
, "job\n");
2571 job_serialize(u
->job
, f
, fds
);
2575 fprintf(f
, "job\n");
2576 job_serialize(u
->nop_job
, f
, fds
);
2585 void unit_serialize_item_format(Unit
*u
, FILE *f
, const char *key
, const char *format
, ...) {
2596 va_start(ap
, format
);
2597 vfprintf(f
, format
, ap
);
2603 void unit_serialize_item(Unit
*u
, FILE *f
, const char *key
, const char *value
) {
2609 fprintf(f
, "%s=%s\n", key
, value
);
2612 static int unit_set_cgroup_path(Unit
*u
, const char *path
) {
2613 _cleanup_free_
char *p
= NULL
;
2625 if (streq_ptr(u
->cgroup_path
, p
))
2629 r
= hashmap_put(u
->manager
->cgroup_unit
, p
, u
);
2634 if (u
->cgroup_path
) {
2635 log_unit_debug(u
, "Changing cgroup path from %s to %s.", u
->cgroup_path
, strna(p
));
2636 hashmap_remove(u
->manager
->cgroup_unit
, u
->cgroup_path
);
2637 free(u
->cgroup_path
);
2646 int unit_deserialize(Unit
*u
, FILE *f
, FDSet
*fds
) {
2647 ExecRuntime
**rt
= NULL
;
2655 offset
= UNIT_VTABLE(u
)->exec_runtime_offset
;
2657 rt
= (ExecRuntime
**) ((uint8_t*) u
+ offset
);
2660 char line
[LINE_MAX
], *l
, *v
;
2663 if (!fgets(line
, sizeof(line
), f
)) {
2676 k
= strcspn(l
, "=");
2684 if (streq(l
, "job")) {
2686 /* new-style serialized job */
2693 r
= job_deserialize(j
, f
, fds
);
2699 r
= hashmap_put(u
->manager
->jobs
, UINT32_TO_PTR(j
->id
), j
);
2705 r
= job_install_deserialized(j
);
2707 hashmap_remove(u
->manager
->jobs
, UINT32_TO_PTR(j
->id
));
2711 } else /* legacy for pre-44 */
2712 log_unit_warning(u
, "Update from too old systemd versions are unsupported, cannot deserialize job: %s", v
);
2714 } else if (streq(l
, "inactive-exit-timestamp")) {
2715 dual_timestamp_deserialize(v
, &u
->inactive_exit_timestamp
);
2717 } else if (streq(l
, "active-enter-timestamp")) {
2718 dual_timestamp_deserialize(v
, &u
->active_enter_timestamp
);
2720 } else if (streq(l
, "active-exit-timestamp")) {
2721 dual_timestamp_deserialize(v
, &u
->active_exit_timestamp
);
2723 } else if (streq(l
, "inactive-enter-timestamp")) {
2724 dual_timestamp_deserialize(v
, &u
->inactive_enter_timestamp
);
2726 } else if (streq(l
, "condition-timestamp")) {
2727 dual_timestamp_deserialize(v
, &u
->condition_timestamp
);
2729 } else if (streq(l
, "assert-timestamp")) {
2730 dual_timestamp_deserialize(v
, &u
->assert_timestamp
);
2732 } else if (streq(l
, "condition-result")) {
2734 r
= parse_boolean(v
);
2736 log_unit_debug(u
, "Failed to parse condition result value %s, ignoring.", v
);
2738 u
->condition_result
= r
;
2742 } else if (streq(l
, "assert-result")) {
2744 r
= parse_boolean(v
);
2746 log_unit_debug(u
, "Failed to parse assert result value %s, ignoring.", v
);
2748 u
->assert_result
= r
;
2752 } else if (streq(l
, "transient")) {
2754 r
= parse_boolean(v
);
2756 log_unit_debug(u
, "Failed to parse transient bool %s, ignoring.", v
);
2762 } else if (streq(l
, "cpuacct-usage-base")) {
2764 r
= safe_atou64(v
, &u
->cpuacct_usage_base
);
2766 log_unit_debug(u
, "Failed to parse CPU usage %s, ignoring.", v
);
2770 } else if (streq(l
, "cgroup")) {
2772 r
= unit_set_cgroup_path(u
, v
);
2774 log_unit_debug_errno(u
, r
, "Failed to set cgroup path %s, ignoring: %m", v
);
2777 } else if (streq(l
, "cgroup-realized")) {
2780 b
= parse_boolean(v
);
2782 log_unit_debug(u
, "Failed to parse cgroup-realized bool %s, ignoring.", v
);
2784 u
->cgroup_realized
= b
;
2789 if (unit_can_serialize(u
)) {
2791 r
= exec_runtime_deserialize_item(u
, rt
, l
, v
, fds
);
2793 log_unit_warning(u
, "Failed to deserialize runtime parameter '%s', ignoring.", l
);
2797 /* Returns positive if key was handled by the call */
2802 r
= UNIT_VTABLE(u
)->deserialize_item(u
, l
, v
, fds
);
2804 log_unit_warning(u
, "Failed to deserialize unit parameter '%s', ignoring.", l
);
2809 int unit_add_node_link(Unit
*u
, const char *what
, bool wants
) {
2811 _cleanup_free_
char *e
= NULL
;
2816 /* Adds in links to the device node that this unit is based on */
2820 if (!is_device_path(what
))
2823 /* When device units aren't supported (such as in a
2824 * container), don't create dependencies on them. */
2825 if (!unit_type_supported(UNIT_DEVICE
))
2828 r
= unit_name_from_path(what
, ".device", &e
);
2832 r
= manager_load_unit(u
->manager
, e
, NULL
, NULL
, &device
);
2836 r
= unit_add_two_dependencies(u
, UNIT_AFTER
, u
->manager
->running_as
== MANAGER_SYSTEM
? UNIT_BINDS_TO
: UNIT_WANTS
, device
, true);
2841 r
= unit_add_dependency(device
, UNIT_WANTS
, u
, false);
2849 int unit_coldplug(Unit
*u
) {
2854 /* Make sure we don't enter a loop, when coldplugging
2859 u
->coldplugged
= true;
2861 if (UNIT_VTABLE(u
)->coldplug
) {
2862 r
= UNIT_VTABLE(u
)->coldplug(u
);
2868 r
= job_coldplug(u
->job
);
2876 void unit_status_printf(Unit
*u
, const char *status
, const char *unit_status_msg_format
) {
2877 DISABLE_WARNING_FORMAT_NONLITERAL
;
2878 manager_status_printf(u
->manager
, STATUS_TYPE_NORMAL
,
2879 status
, unit_status_msg_format
, unit_description(u
));
2883 bool unit_need_daemon_reload(Unit
*u
) {
2884 _cleanup_strv_free_
char **t
= NULL
;
2887 unsigned loaded_cnt
, current_cnt
;
2891 if (u
->fragment_path
) {
2893 if (stat(u
->fragment_path
, &st
) < 0)
2894 /* What, cannot access this anymore? */
2897 if (u
->fragment_mtime
> 0 &&
2898 timespec_load(&st
.st_mtim
) != u
->fragment_mtime
)
2902 if (u
->source_path
) {
2904 if (stat(u
->source_path
, &st
) < 0)
2907 if (u
->source_mtime
> 0 &&
2908 timespec_load(&st
.st_mtim
) != u
->source_mtime
)
2912 (void) unit_find_dropin_paths(u
, &t
);
2913 loaded_cnt
= strv_length(t
);
2914 current_cnt
= strv_length(u
->dropin_paths
);
2916 if (loaded_cnt
== current_cnt
) {
2917 if (loaded_cnt
== 0)
2920 if (strv_overlap(u
->dropin_paths
, t
)) {
2921 STRV_FOREACH(path
, u
->dropin_paths
) {
2923 if (stat(*path
, &st
) < 0)
2926 if (u
->dropin_mtime
> 0 &&
2927 timespec_load(&st
.st_mtim
) > u
->dropin_mtime
)
2938 void unit_reset_failed(Unit
*u
) {
2941 if (UNIT_VTABLE(u
)->reset_failed
)
2942 UNIT_VTABLE(u
)->reset_failed(u
);
2945 Unit
*unit_following(Unit
*u
) {
2948 if (UNIT_VTABLE(u
)->following
)
2949 return UNIT_VTABLE(u
)->following(u
);
2954 bool unit_stop_pending(Unit
*u
) {
2957 /* This call does check the current state of the unit. It's
2958 * hence useful to be called from state change calls of the
2959 * unit itself, where the state isn't updated yet. This is
2960 * different from unit_inactive_or_pending() which checks both
2961 * the current state and for a queued job. */
2963 return u
->job
&& u
->job
->type
== JOB_STOP
;
2966 bool unit_inactive_or_pending(Unit
*u
) {
2969 /* Returns true if the unit is inactive or going down */
2971 if (UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u
)))
2974 if (unit_stop_pending(u
))
2980 bool unit_active_or_pending(Unit
*u
) {
2983 /* Returns true if the unit is active or going up */
2985 if (UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u
)))
2989 (u
->job
->type
== JOB_START
||
2990 u
->job
->type
== JOB_RELOAD_OR_START
||
2991 u
->job
->type
== JOB_RESTART
))
2997 int unit_kill(Unit
*u
, KillWho w
, int signo
, sd_bus_error
*error
) {
2999 assert(w
>= 0 && w
< _KILL_WHO_MAX
);
3001 assert(signo
< _NSIG
);
3003 if (!UNIT_VTABLE(u
)->kill
)
3006 return UNIT_VTABLE(u
)->kill(u
, w
, signo
, error
);
3009 static Set
*unit_pid_set(pid_t main_pid
, pid_t control_pid
) {
3013 pid_set
= set_new(NULL
);
3017 /* Exclude the main/control pids from being killed via the cgroup */
3019 r
= set_put(pid_set
, LONG_TO_PTR(main_pid
));
3024 if (control_pid
> 0) {
3025 r
= set_put(pid_set
, LONG_TO_PTR(control_pid
));
3037 int unit_kill_common(
3043 sd_bus_error
*error
) {
3047 if (who
== KILL_MAIN
&& main_pid
<= 0) {
3049 return sd_bus_error_setf(error
, BUS_ERROR_NO_SUCH_PROCESS
, "%s units have no main processes", unit_type_to_string(u
->type
));
3051 return sd_bus_error_set_const(error
, BUS_ERROR_NO_SUCH_PROCESS
, "No main process to kill");
3054 if (who
== KILL_CONTROL
&& control_pid
<= 0) {
3055 if (control_pid
< 0)
3056 return sd_bus_error_setf(error
, BUS_ERROR_NO_SUCH_PROCESS
, "%s units have no control processes", unit_type_to_string(u
->type
));
3058 return sd_bus_error_set_const(error
, BUS_ERROR_NO_SUCH_PROCESS
, "No control process to kill");
3061 if (who
== KILL_CONTROL
|| who
== KILL_ALL
)
3062 if (control_pid
> 0)
3063 if (kill(control_pid
, signo
) < 0)
3066 if (who
== KILL_MAIN
|| who
== KILL_ALL
)
3068 if (kill(main_pid
, signo
) < 0)
3071 if (who
== KILL_ALL
&& u
->cgroup_path
) {
3072 _cleanup_set_free_ Set
*pid_set
= NULL
;
3075 /* Exclude the main/control pids from being killed via the cgroup */
3076 pid_set
= unit_pid_set(main_pid
, control_pid
);
3080 q
= cg_kill_recursive(SYSTEMD_CGROUP_CONTROLLER
, u
->cgroup_path
, signo
, false, true, false, pid_set
);
3081 if (q
< 0 && q
!= -EAGAIN
&& q
!= -ESRCH
&& q
!= -ENOENT
)
3088 int unit_following_set(Unit
*u
, Set
**s
) {
3092 if (UNIT_VTABLE(u
)->following_set
)
3093 return UNIT_VTABLE(u
)->following_set(u
, s
);
3099 UnitFileState
unit_get_unit_file_state(Unit
*u
) {
3102 if (u
->unit_file_state
< 0 && u
->fragment_path
)
3103 u
->unit_file_state
= unit_file_get_state(
3104 u
->manager
->running_as
== MANAGER_SYSTEM
? UNIT_FILE_SYSTEM
: UNIT_FILE_USER
,
3105 NULL
, basename(u
->fragment_path
));
3107 return u
->unit_file_state
;
3110 int unit_get_unit_file_preset(Unit
*u
) {
3113 if (u
->unit_file_preset
< 0 && u
->fragment_path
)
3114 u
->unit_file_preset
= unit_file_query_preset(
3115 u
->manager
->running_as
== MANAGER_SYSTEM
? UNIT_FILE_SYSTEM
: UNIT_FILE_USER
,
3116 NULL
, basename(u
->fragment_path
));
3118 return u
->unit_file_preset
;
3121 Unit
* unit_ref_set(UnitRef
*ref
, Unit
*u
) {
3126 unit_ref_unset(ref
);
3129 LIST_PREPEND(refs
, u
->refs
, ref
);
3133 void unit_ref_unset(UnitRef
*ref
) {
3139 LIST_REMOVE(refs
, ref
->unit
->refs
, ref
);
3143 int unit_patch_contexts(Unit
*u
) {
3151 /* Patch in the manager defaults into the exec and cgroup
3152 * contexts, _after_ the rest of the settings have been
3155 ec
= unit_get_exec_context(u
);
3157 /* This only copies in the ones that need memory */
3158 for (i
= 0; i
< _RLIMIT_MAX
; i
++)
3159 if (u
->manager
->rlimit
[i
] && !ec
->rlimit
[i
]) {
3160 ec
->rlimit
[i
] = newdup(struct rlimit
, u
->manager
->rlimit
[i
], 1);
3165 if (u
->manager
->running_as
== MANAGER_USER
&&
3166 !ec
->working_directory
) {
3168 r
= get_home_dir(&ec
->working_directory
);
3172 /* Allow user services to run, even if the
3173 * home directory is missing */
3174 ec
->working_directory_missing_ok
= true;
3177 if (u
->manager
->running_as
== MANAGER_USER
&&
3178 (ec
->syscall_whitelist
||
3179 !set_isempty(ec
->syscall_filter
) ||
3180 !set_isempty(ec
->syscall_archs
) ||
3181 ec
->address_families_whitelist
||
3182 !set_isempty(ec
->address_families
)))
3183 ec
->no_new_privileges
= true;
3185 if (ec
->private_devices
)
3186 ec
->capability_bounding_set_drop
|= (uint64_t) 1ULL << (uint64_t) CAP_MKNOD
;
3189 cc
= unit_get_cgroup_context(u
);
3193 ec
->private_devices
&&
3194 cc
->device_policy
== CGROUP_AUTO
)
3195 cc
->device_policy
= CGROUP_CLOSED
;
3201 ExecContext
*unit_get_exec_context(Unit
*u
) {
3208 offset
= UNIT_VTABLE(u
)->exec_context_offset
;
3212 return (ExecContext
*) ((uint8_t*) u
+ offset
);
3215 KillContext
*unit_get_kill_context(Unit
*u
) {
3222 offset
= UNIT_VTABLE(u
)->kill_context_offset
;
3226 return (KillContext
*) ((uint8_t*) u
+ offset
);
3229 CGroupContext
*unit_get_cgroup_context(Unit
*u
) {
3235 offset
= UNIT_VTABLE(u
)->cgroup_context_offset
;
3239 return (CGroupContext
*) ((uint8_t*) u
+ offset
);
3242 ExecRuntime
*unit_get_exec_runtime(Unit
*u
) {
3248 offset
= UNIT_VTABLE(u
)->exec_runtime_offset
;
3252 return *(ExecRuntime
**) ((uint8_t*) u
+ offset
);
3255 static int unit_drop_in_dir(Unit
*u
, UnitSetPropertiesMode mode
, bool transient
, char **dir
) {
3256 if (u
->manager
->running_as
== MANAGER_USER
) {
3259 if (mode
== UNIT_PERSISTENT
&& !transient
)
3260 r
= user_config_home(dir
);
3262 r
= user_runtime_dir(dir
);
3269 if (mode
== UNIT_PERSISTENT
&& !transient
)
3270 *dir
= strdup("/etc/systemd/system");
3272 *dir
= strdup("/run/systemd/system");
3279 static int unit_drop_in_file(Unit
*u
,
3280 UnitSetPropertiesMode mode
, const char *name
, char **p
, char **q
) {
3281 _cleanup_free_
char *dir
= NULL
;
3286 r
= unit_drop_in_dir(u
, mode
, u
->transient
, &dir
);
3290 return drop_in_file(dir
, u
->id
, 50, name
, p
, q
);
3293 int unit_write_drop_in(Unit
*u
, UnitSetPropertiesMode mode
, const char *name
, const char *data
) {
3295 _cleanup_free_
char *dir
= NULL
, *p
= NULL
, *q
= NULL
;
3300 if (!IN_SET(mode
, UNIT_PERSISTENT
, UNIT_RUNTIME
))
3303 r
= unit_drop_in_dir(u
, mode
, u
->transient
, &dir
);
3307 r
= write_drop_in(dir
, u
->id
, 50, name
, data
);
3311 r
= drop_in_file(dir
, u
->id
, 50, name
, &p
, &q
);
3315 r
= strv_extend(&u
->dropin_paths
, q
);
3319 strv_sort(u
->dropin_paths
);
3320 strv_uniq(u
->dropin_paths
);
3322 u
->dropin_mtime
= now(CLOCK_REALTIME
);
3327 int unit_write_drop_in_format(Unit
*u
, UnitSetPropertiesMode mode
, const char *name
, const char *format
, ...) {
3328 _cleanup_free_
char *p
= NULL
;
3336 if (!IN_SET(mode
, UNIT_PERSISTENT
, UNIT_RUNTIME
))
3339 va_start(ap
, format
);
3340 r
= vasprintf(&p
, format
, ap
);
3346 return unit_write_drop_in(u
, mode
, name
, p
);
3349 int unit_write_drop_in_private(Unit
*u
, UnitSetPropertiesMode mode
, const char *name
, const char *data
) {
3350 _cleanup_free_
char *ndata
= NULL
;
3356 if (!UNIT_VTABLE(u
)->private_section
)
3359 if (!IN_SET(mode
, UNIT_PERSISTENT
, UNIT_RUNTIME
))
3362 ndata
= strjoin("[", UNIT_VTABLE(u
)->private_section
, "]\n", data
, NULL
);
3366 return unit_write_drop_in(u
, mode
, name
, ndata
);
3369 int unit_write_drop_in_private_format(Unit
*u
, UnitSetPropertiesMode mode
, const char *name
, const char *format
, ...) {
3370 _cleanup_free_
char *p
= NULL
;
3378 if (!IN_SET(mode
, UNIT_PERSISTENT
, UNIT_RUNTIME
))
3381 va_start(ap
, format
);
3382 r
= vasprintf(&p
, format
, ap
);
3388 return unit_write_drop_in_private(u
, mode
, name
, p
);
3391 int unit_remove_drop_in(Unit
*u
, UnitSetPropertiesMode mode
, const char *name
) {
3392 _cleanup_free_
char *p
= NULL
, *q
= NULL
;
3397 if (!IN_SET(mode
, UNIT_PERSISTENT
, UNIT_RUNTIME
))
3400 r
= unit_drop_in_file(u
, mode
, name
, &p
, &q
);
3405 r
= errno
== ENOENT
? 0 : -errno
;
3413 int unit_make_transient(Unit
*u
) {
3418 u
->load_state
= UNIT_STUB
;
3420 u
->transient
= true;
3422 free(u
->fragment_path
);
3423 u
->fragment_path
= NULL
;
3425 if (u
->manager
->running_as
== MANAGER_USER
) {
3426 _cleanup_free_
char *c
= NULL
;
3428 r
= user_runtime_dir(&c
);
3434 u
->fragment_path
= strjoin(c
, "/", u
->id
, NULL
);
3435 if (!u
->fragment_path
)
3440 u
->fragment_path
= strappend("/run/systemd/system/", u
->id
);
3441 if (!u
->fragment_path
)
3444 mkdir_p("/run/systemd/system", 0755);
3447 return write_string_file_atomic_label(u
->fragment_path
, "# Transient stub");
3450 int unit_kill_context(
3456 bool main_pid_alien
) {
3458 int sig
, wait_for_exit
= false, r
;
3463 if (c
->kill_mode
== KILL_NONE
)
3473 case KILL_TERMINATE
:
3474 sig
= c
->kill_signal
;
3477 assert_not_reached("KillOperation unknown");
3481 r
= kill_and_sigcont(main_pid
, sig
);
3483 if (r
< 0 && r
!= -ESRCH
) {
3484 _cleanup_free_
char *comm
= NULL
;
3485 get_process_comm(main_pid
, &comm
);
3487 log_unit_warning_errno(u
, r
, "Failed to kill main process " PID_FMT
" (%s): %m", main_pid
, strna(comm
));
3489 if (!main_pid_alien
)
3490 wait_for_exit
= true;
3492 if (c
->send_sighup
&& k
!= KILL_KILL
)
3493 kill(main_pid
, SIGHUP
);
3497 if (control_pid
> 0) {
3498 r
= kill_and_sigcont(control_pid
, sig
);
3500 if (r
< 0 && r
!= -ESRCH
) {
3501 _cleanup_free_
char *comm
= NULL
;
3502 get_process_comm(control_pid
, &comm
);
3504 log_unit_warning_errno(u
, r
, "Failed to kill control process " PID_FMT
" (%s): %m", control_pid
, strna(comm
));
3506 wait_for_exit
= true;
3508 if (c
->send_sighup
&& k
!= KILL_KILL
)
3509 kill(control_pid
, SIGHUP
);
3513 if ((c
->kill_mode
== KILL_CONTROL_GROUP
|| (c
->kill_mode
== KILL_MIXED
&& k
== KILL_KILL
)) && u
->cgroup_path
) {
3514 _cleanup_set_free_ Set
*pid_set
= NULL
;
3516 /* Exclude the main/control pids from being killed via the cgroup */
3517 pid_set
= unit_pid_set(main_pid
, control_pid
);
3521 r
= cg_kill_recursive(SYSTEMD_CGROUP_CONTROLLER
, u
->cgroup_path
, sig
, true, true, false, pid_set
);
3523 if (r
!= -EAGAIN
&& r
!= -ESRCH
&& r
!= -ENOENT
)
3524 log_unit_warning_errno(u
, r
, "Failed to kill control group: %m");
3527 /* FIXME: For now, we will not wait for the
3528 * cgroup members to die, simply because
3529 * cgroup notification is unreliable. It
3530 * doesn't work at all in containers, and
3531 * outside of containers it can be confused
3532 * easily by leaving directories in the
3535 /* wait_for_exit = true; */
3537 if (c
->send_sighup
&& k
!= KILL_KILL
) {
3540 pid_set
= unit_pid_set(main_pid
, control_pid
);
3544 cg_kill_recursive(SYSTEMD_CGROUP_CONTROLLER
, u
->cgroup_path
, SIGHUP
, false, true, false, pid_set
);
3549 return wait_for_exit
;
3552 int unit_require_mounts_for(Unit
*u
, const char *path
) {
3553 char prefix
[strlen(path
) + 1], *p
;
3559 /* Registers a unit for requiring a certain path and all its
3560 * prefixes. We keep a simple array of these paths in the
3561 * unit, since its usually short. However, we build a prefix
3562 * table for all possible prefixes so that new appearing mount
3563 * units can easily determine which units to make themselves a
3566 if (!path_is_absolute(path
))
3573 path_kill_slashes(p
);
3575 if (!path_is_safe(p
)) {
3580 if (strv_contains(u
->requires_mounts_for
, p
)) {
3585 r
= strv_consume(&u
->requires_mounts_for
, p
);
3589 PATH_FOREACH_PREFIX_MORE(prefix
, p
) {
3592 x
= hashmap_get(u
->manager
->units_requiring_mounts_for
, prefix
);
3596 r
= hashmap_ensure_allocated(&u
->manager
->units_requiring_mounts_for
, &string_hash_ops
);
3610 r
= hashmap_put(u
->manager
->units_requiring_mounts_for
, q
, x
);
3626 int unit_setup_exec_runtime(Unit
*u
) {
3632 offset
= UNIT_VTABLE(u
)->exec_runtime_offset
;
3635 /* Check if there already is an ExecRuntime for this unit? */
3636 rt
= (ExecRuntime
**) ((uint8_t*) u
+ offset
);
3640 /* Try to get it from somebody else */
3641 SET_FOREACH(other
, u
->dependencies
[UNIT_JOINS_NAMESPACE_OF
], i
) {
3643 *rt
= unit_get_exec_runtime(other
);
3645 exec_runtime_ref(*rt
);
3650 return exec_runtime_make(rt
, unit_get_exec_context(u
), u
->id
);
3653 bool unit_type_supported(UnitType t
) {
3654 if (_unlikely_(t
< 0))
3656 if (_unlikely_(t
>= _UNIT_TYPE_MAX
))
3659 if (!unit_vtable
[t
]->supported
)
3662 return unit_vtable
[t
]->supported();
3665 void unit_warn_if_dir_nonempty(Unit
*u
, const char* where
) {
3671 r
= dir_is_empty(where
);
3675 log_unit_warning_errno(u
, r
, "Failed to check directory %s: %m", where
);
3679 log_struct(LOG_NOTICE
,
3680 LOG_MESSAGE_ID(SD_MESSAGE_OVERMOUNTING
),
3682 LOG_UNIT_MESSAGE(u
, "Directory %s to mount over is not empty, mounting anyway.", where
),
3687 int unit_fail_if_symlink(Unit
*u
, const char* where
) {
3693 r
= is_symlink(where
);
3695 log_unit_debug_errno(u
, r
, "Failed to check symlink %s, ignoring: %m", where
);
3702 LOG_MESSAGE_ID(SD_MESSAGE_OVERMOUNTING
),
3704 LOG_UNIT_MESSAGE(u
, "Mount on symlink %s not allowed.", where
),
3711 static const char* const unit_active_state_table
[_UNIT_ACTIVE_STATE_MAX
] = {
3712 [UNIT_ACTIVE
] = "active",
3713 [UNIT_RELOADING
] = "reloading",
3714 [UNIT_INACTIVE
] = "inactive",
3715 [UNIT_FAILED
] = "failed",
3716 [UNIT_ACTIVATING
] = "activating",
3717 [UNIT_DEACTIVATING
] = "deactivating"
3720 DEFINE_STRING_TABLE_LOOKUP(unit_active_state
, UnitActiveState
);