chiark / gitweb /
gc: remove a lot of unused code
[elogind.git] / src / unit.c
1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
2
3 /***
4   This file is part of systemd.
5
6   Copyright 2010 Lennart Poettering
7
8   systemd is free software; you can redistribute it and/or modify it
9   under the terms of the GNU General Public License as published by
10   the Free Software Foundation; either version 2 of the License, or
11   (at your option) any later version.
12
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   General Public License for more details.
17
18   You should have received a copy of the GNU General Public License
19   along with systemd; If not, see <http://www.gnu.org/licenses/>.
20 ***/
21
22 #include <assert.h>
23 #include <errno.h>
24 #include <string.h>
25 #include <sys/epoll.h>
26 #include <sys/timerfd.h>
27 #include <sys/poll.h>
28 #include <stdlib.h>
29 #include <unistd.h>
30 #include <sys/stat.h>
31
32 #include "set.h"
33 #include "unit.h"
34 #include "macro.h"
35 #include "strv.h"
36 #include "load-fragment.h"
37 #include "load-dropin.h"
38 #include "log.h"
39 #include "unit-name.h"
40 #include "specifier.h"
41 #include "dbus-unit.h"
42 #include "special.h"
43 #include "cgroup-util.h"
44 #include "missing.h"
45
46 const UnitVTable * const unit_vtable[_UNIT_TYPE_MAX] = {
47         [UNIT_SERVICE] = &service_vtable,
48         [UNIT_TIMER] = &timer_vtable,
49         [UNIT_SOCKET] = &socket_vtable,
50         [UNIT_TARGET] = &target_vtable,
51         [UNIT_DEVICE] = &device_vtable,
52         [UNIT_MOUNT] = &mount_vtable,
53         [UNIT_AUTOMOUNT] = &automount_vtable,
54         [UNIT_SNAPSHOT] = &snapshot_vtable,
55         [UNIT_SWAP] = &swap_vtable,
56         [UNIT_PATH] = &path_vtable
57 };
58
59 Unit *unit_new(Manager *m) {
60         Unit *u;
61
62         assert(m);
63
64         if (!(u = new0(Unit, 1)))
65                 return NULL;
66
67         if (!(u->meta.names = set_new(string_hash_func, string_compare_func))) {
68                 free(u);
69                 return NULL;
70         }
71
72         u->meta.manager = m;
73         u->meta.type = _UNIT_TYPE_INVALID;
74         u->meta.deserialized_job = _JOB_TYPE_INVALID;
75         u->meta.default_dependencies = true;
76
77         return u;
78 }
79
80 bool unit_has_name(Unit *u, const char *name) {
81         assert(u);
82         assert(name);
83
84         return !!set_get(u->meta.names, (char*) name);
85 }
86
87 int unit_add_name(Unit *u, const char *text) {
88         UnitType t;
89         char *s, *i = NULL;
90         int r;
91
92         assert(u);
93         assert(text);
94
95         if (unit_name_is_template(text)) {
96                 if (!u->meta.instance)
97                         return -EINVAL;
98
99                 s = unit_name_replace_instance(text, u->meta.instance);
100         } else
101                 s = strdup(text);
102
103         if (!s)
104                 return -ENOMEM;
105
106         if (!unit_name_is_valid(s)) {
107                 r = -EINVAL;
108                 goto fail;
109         }
110
111         assert_se((t = unit_name_to_type(s)) >= 0);
112
113         if (u->meta.type != _UNIT_TYPE_INVALID && t != u->meta.type) {
114                 r = -EINVAL;
115                 goto fail;
116         }
117
118         if ((r = unit_name_to_instance(s, &i)) < 0)
119                 goto fail;
120
121         if (i && unit_vtable[t]->no_instances)
122                 goto fail;
123
124         /* Ensure that this unit is either instanced or not instanced,
125          * but not both. */
126         if (u->meta.type != _UNIT_TYPE_INVALID && !u->meta.instance != !i) {
127                 r = -EINVAL;
128                 goto fail;
129         }
130
131         if (unit_vtable[t]->no_alias &&
132             !set_isempty(u->meta.names) &&
133             !set_get(u->meta.names, s)) {
134                 r = -EEXIST;
135                 goto fail;
136         }
137
138         if (hashmap_size(u->meta.manager->units) >= MANAGER_MAX_NAMES) {
139                 r = -E2BIG;
140                 goto fail;
141         }
142
143         if ((r = set_put(u->meta.names, s)) < 0) {
144                 if (r == -EEXIST)
145                         r = 0;
146                 goto fail;
147         }
148
149         if ((r = hashmap_put(u->meta.manager->units, s, u)) < 0) {
150                 set_remove(u->meta.names, s);
151                 goto fail;
152         }
153
154         if (u->meta.type == _UNIT_TYPE_INVALID) {
155
156                 u->meta.type = t;
157                 u->meta.id = s;
158                 u->meta.instance = i;
159
160                 LIST_PREPEND(Meta, units_per_type, u->meta.manager->units_per_type[t], &u->meta);
161
162                 if (UNIT_VTABLE(u)->init)
163                         UNIT_VTABLE(u)->init(u);
164         } else
165                 free(i);
166
167         unit_add_to_dbus_queue(u);
168         return 0;
169
170 fail:
171         free(s);
172         free(i);
173
174         return r;
175 }
176
177 int unit_choose_id(Unit *u, const char *name) {
178         char *s, *t = NULL, *i;
179         int r;
180
181         assert(u);
182         assert(name);
183
184         if (unit_name_is_template(name)) {
185
186                 if (!u->meta.instance)
187                         return -EINVAL;
188
189                 if (!(t = unit_name_replace_instance(name, u->meta.instance)))
190                         return -ENOMEM;
191
192                 name = t;
193         }
194
195         /* Selects one of the names of this unit as the id */
196         s = set_get(u->meta.names, (char*) name);
197         free(t);
198
199         if (!s)
200                 return -ENOENT;
201
202         if ((r = unit_name_to_instance(s, &i)) < 0)
203                 return r;
204
205         u->meta.id = s;
206
207         free(u->meta.instance);
208         u->meta.instance = i;
209
210         unit_add_to_dbus_queue(u);
211
212         return 0;
213 }
214
215 int unit_set_description(Unit *u, const char *description) {
216         char *s;
217
218         assert(u);
219
220         if (!(s = strdup(description)))
221                 return -ENOMEM;
222
223         free(u->meta.description);
224         u->meta.description = s;
225
226         unit_add_to_dbus_queue(u);
227         return 0;
228 }
229
230 bool unit_check_gc(Unit *u) {
231         assert(u);
232
233         if (u->meta.load_state == UNIT_STUB)
234                 return true;
235
236         if (UNIT_VTABLE(u)->no_gc)
237                 return true;
238
239         if (u->meta.no_gc)
240                 return true;
241
242         if (u->meta.job)
243                 return true;
244
245         if (unit_active_state(u) != UNIT_INACTIVE)
246                 return true;
247
248         if (UNIT_VTABLE(u)->check_gc)
249                 if (UNIT_VTABLE(u)->check_gc(u))
250                         return true;
251
252         return false;
253 }
254
255 void unit_add_to_load_queue(Unit *u) {
256         assert(u);
257         assert(u->meta.type != _UNIT_TYPE_INVALID);
258
259         if (u->meta.load_state != UNIT_STUB || u->meta.in_load_queue)
260                 return;
261
262         LIST_PREPEND(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
263         u->meta.in_load_queue = true;
264 }
265
266 void unit_add_to_cleanup_queue(Unit *u) {
267         assert(u);
268
269         if (u->meta.in_cleanup_queue)
270                 return;
271
272         LIST_PREPEND(Meta, cleanup_queue, u->meta.manager->cleanup_queue, &u->meta);
273         u->meta.in_cleanup_queue = true;
274 }
275
276 void unit_add_to_gc_queue(Unit *u) {
277         assert(u);
278
279         if (u->meta.in_gc_queue || u->meta.in_cleanup_queue)
280                 return;
281
282         if (unit_check_gc(u))
283                 return;
284
285         LIST_PREPEND(Meta, gc_queue, u->meta.manager->gc_queue, &u->meta);
286         u->meta.in_gc_queue = true;
287
288         u->meta.manager->n_in_gc_queue ++;
289
290         if (u->meta.manager->gc_queue_timestamp <= 0)
291                 u->meta.manager->gc_queue_timestamp = now(CLOCK_MONOTONIC);
292 }
293
294 void unit_add_to_dbus_queue(Unit *u) {
295         assert(u);
296         assert(u->meta.type != _UNIT_TYPE_INVALID);
297
298         if (u->meta.load_state == UNIT_STUB || u->meta.in_dbus_queue)
299                 return;
300
301         /* Shortcut things if nobody cares */
302         if (!bus_has_subscriber(u->meta.manager)) {
303                 u->meta.sent_dbus_new_signal = true;
304                 return;
305         }
306
307         LIST_PREPEND(Meta, dbus_queue, u->meta.manager->dbus_unit_queue, &u->meta);
308         u->meta.in_dbus_queue = true;
309 }
310
311 static void bidi_set_free(Unit *u, Set *s) {
312         Iterator i;
313         Unit *other;
314
315         assert(u);
316
317         /* Frees the set and makes sure we are dropped from the
318          * inverse pointers */
319
320         SET_FOREACH(other, s, i) {
321                 UnitDependency d;
322
323                 for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
324                         set_remove(other->meta.dependencies[d], u);
325
326                 unit_add_to_gc_queue(other);
327         }
328
329         set_free(s);
330 }
331
332 void unit_free(Unit *u) {
333         UnitDependency d;
334         Iterator i;
335         char *t;
336
337         assert(u);
338
339         bus_unit_send_removed_signal(u);
340
341         if (u->meta.load_state != UNIT_STUB)
342                 if (UNIT_VTABLE(u)->done)
343                         UNIT_VTABLE(u)->done(u);
344
345         SET_FOREACH(t, u->meta.names, i)
346                 hashmap_remove_value(u->meta.manager->units, t, u);
347
348         if (u->meta.job)
349                 job_free(u->meta.job);
350
351         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
352                 bidi_set_free(u, u->meta.dependencies[d]);
353
354         if (u->meta.type != _UNIT_TYPE_INVALID)
355                 LIST_REMOVE(Meta, units_per_type, u->meta.manager->units_per_type[u->meta.type], &u->meta);
356
357         if (u->meta.in_load_queue)
358                 LIST_REMOVE(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
359
360         if (u->meta.in_dbus_queue)
361                 LIST_REMOVE(Meta, dbus_queue, u->meta.manager->dbus_unit_queue, &u->meta);
362
363         if (u->meta.in_cleanup_queue)
364                 LIST_REMOVE(Meta, cleanup_queue, u->meta.manager->cleanup_queue, &u->meta);
365
366         if (u->meta.in_gc_queue) {
367                 LIST_REMOVE(Meta, gc_queue, u->meta.manager->gc_queue, &u->meta);
368                 u->meta.manager->n_in_gc_queue--;
369         }
370
371         cgroup_bonding_free_list(u->meta.cgroup_bondings);
372
373         free(u->meta.description);
374         free(u->meta.fragment_path);
375
376         set_free_free(u->meta.names);
377
378         free(u->meta.instance);
379
380         free(u);
381 }
382
383 UnitActiveState unit_active_state(Unit *u) {
384         assert(u);
385
386         if (u->meta.load_state == UNIT_MERGED)
387                 return unit_active_state(unit_follow_merge(u));
388
389         /* After a reload it might happen that a unit is not correctly
390          * loaded but still has a process around. That's why we won't
391          * shortcut failed loading to UNIT_INACTIVE_MAINTENANCE. */
392
393         return UNIT_VTABLE(u)->active_state(u);
394 }
395
396 const char* unit_sub_state_to_string(Unit *u) {
397         assert(u);
398
399         return UNIT_VTABLE(u)->sub_state_to_string(u);
400 }
401
402 static void complete_move(Set **s, Set **other) {
403         assert(s);
404         assert(other);
405
406         if (!*other)
407                 return;
408
409         if (*s)
410                 set_move(*s, *other);
411         else {
412                 *s = *other;
413                 *other = NULL;
414         }
415 }
416
417 static void merge_names(Unit *u, Unit *other) {
418         char *t;
419         Iterator i;
420
421         assert(u);
422         assert(other);
423
424         complete_move(&u->meta.names, &other->meta.names);
425
426         set_free_free(other->meta.names);
427         other->meta.names = NULL;
428         other->meta.id = NULL;
429
430         SET_FOREACH(t, u->meta.names, i)
431                 assert_se(hashmap_replace(u->meta.manager->units, t, u) == 0);
432 }
433
434 static void merge_dependencies(Unit *u, Unit *other, UnitDependency d) {
435         Iterator i;
436         Unit *back;
437         int r;
438
439         assert(u);
440         assert(other);
441         assert(d < _UNIT_DEPENDENCY_MAX);
442
443         SET_FOREACH(back, other->meta.dependencies[d], i) {
444                 UnitDependency k;
445
446                 for (k = 0; k < _UNIT_DEPENDENCY_MAX; k++)
447                         if ((r = set_remove_and_put(back->meta.dependencies[k], other, u)) < 0) {
448
449                                 if (r == -EEXIST)
450                                         set_remove(back->meta.dependencies[k], other);
451                                 else
452                                         assert(r == -ENOENT);
453                         }
454         }
455
456         complete_move(&u->meta.dependencies[d], &other->meta.dependencies[d]);
457
458         set_free(other->meta.dependencies[d]);
459         other->meta.dependencies[d] = NULL;
460 }
461
462 int unit_merge(Unit *u, Unit *other) {
463         UnitDependency d;
464
465         assert(u);
466         assert(other);
467         assert(u->meta.manager == other->meta.manager);
468         assert(u->meta.type != _UNIT_TYPE_INVALID);
469
470         other = unit_follow_merge(other);
471
472         if (other == u)
473                 return 0;
474
475         if (u->meta.type != other->meta.type)
476                 return -EINVAL;
477
478         if (!u->meta.instance != !other->meta.instance)
479                 return -EINVAL;
480
481         if (other->meta.load_state != UNIT_STUB &&
482             other->meta.load_state != UNIT_FAILED)
483                 return -EEXIST;
484
485         if (other->meta.job)
486                 return -EEXIST;
487
488         if (!UNIT_IS_INACTIVE_OR_MAINTENANCE(unit_active_state(other)))
489                 return -EEXIST;
490
491         /* Merge names */
492         merge_names(u, other);
493
494         /* Merge dependencies */
495         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
496                 merge_dependencies(u, other, d);
497
498         other->meta.load_state = UNIT_MERGED;
499         other->meta.merged_into = u;
500
501         /* If there is still some data attached to the other node, we
502          * don't need it anymore, and can free it. */
503         if (other->meta.load_state != UNIT_STUB)
504                 if (UNIT_VTABLE(other)->done)
505                         UNIT_VTABLE(other)->done(other);
506
507         unit_add_to_dbus_queue(u);
508         unit_add_to_cleanup_queue(other);
509
510         return 0;
511 }
512
513 int unit_merge_by_name(Unit *u, const char *name) {
514         Unit *other;
515         int r;
516         char *s = NULL;
517
518         assert(u);
519         assert(name);
520
521         if (unit_name_is_template(name)) {
522                 if (!u->meta.instance)
523                         return -EINVAL;
524
525                 if (!(s = unit_name_replace_instance(name, u->meta.instance)))
526                         return -ENOMEM;
527
528                 name = s;
529         }
530
531         if (!(other = manager_get_unit(u->meta.manager, name)))
532                 r = unit_add_name(u, name);
533         else
534                 r = unit_merge(u, other);
535
536         free(s);
537         return r;
538 }
539
540 Unit* unit_follow_merge(Unit *u) {
541         assert(u);
542
543         while (u->meta.load_state == UNIT_MERGED)
544                 assert_se(u = u->meta.merged_into);
545
546         return u;
547 }
548
549 int unit_add_exec_dependencies(Unit *u, ExecContext *c) {
550         int r;
551
552         assert(u);
553         assert(c);
554
555         if (c->std_output != EXEC_OUTPUT_KMSG &&
556             c->std_output != EXEC_OUTPUT_SYSLOG &&
557             c->std_error != EXEC_OUTPUT_KMSG &&
558             c->std_error != EXEC_OUTPUT_SYSLOG)
559                 return 0;
560
561         /* If syslog or kernel logging is requested, make sure our own
562          * logging daemon is run first. */
563
564         if ((r = unit_add_dependency_by_name(u, UNIT_AFTER, SPECIAL_LOGGER_SOCKET, NULL, true)) < 0)
565                 return r;
566
567         if (u->meta.manager->running_as == MANAGER_SYSTEM)
568                 if ((r = unit_add_dependency_by_name(u, UNIT_REQUIRES, SPECIAL_LOGGER_SOCKET, NULL, true)) < 0)
569                         return r;
570
571         return 0;
572 }
573
574 const char *unit_description(Unit *u) {
575         assert(u);
576
577         if (u->meta.description)
578                 return u->meta.description;
579
580         return u->meta.id;
581 }
582
583 void unit_dump(Unit *u, FILE *f, const char *prefix) {
584         char *t;
585         UnitDependency d;
586         Iterator i;
587         char *p2;
588         const char *prefix2;
589         CGroupBonding *b;
590         char
591                 timestamp1[FORMAT_TIMESTAMP_MAX],
592                 timestamp2[FORMAT_TIMESTAMP_MAX],
593                 timestamp3[FORMAT_TIMESTAMP_MAX],
594                 timestamp4[FORMAT_TIMESTAMP_MAX],
595                 timespan[FORMAT_TIMESPAN_MAX];
596         Unit *following;
597
598         assert(u);
599         assert(u->meta.type >= 0);
600
601         if (!prefix)
602                 prefix = "";
603         p2 = strappend(prefix, "\t");
604         prefix2 = p2 ? p2 : prefix;
605
606         fprintf(f,
607                 "%s-> Unit %s:\n"
608                 "%s\tDescription: %s\n"
609                 "%s\tInstance: %s\n"
610                 "%s\tUnit Load State: %s\n"
611                 "%s\tUnit Active State: %s\n"
612                 "%s\tInactive Exit Timestamp: %s\n"
613                 "%s\tActive Enter Timestamp: %s\n"
614                 "%s\tActive Exit Timestamp: %s\n"
615                 "%s\tInactive Enter Timestamp: %s\n"
616                 "%s\tGC Check Good: %s\n"
617                 "%s\tNeed Daemon Reload: %s\n",
618                 prefix, u->meta.id,
619                 prefix, unit_description(u),
620                 prefix, strna(u->meta.instance),
621                 prefix, unit_load_state_to_string(u->meta.load_state),
622                 prefix, unit_active_state_to_string(unit_active_state(u)),
623                 prefix, strna(format_timestamp(timestamp1, sizeof(timestamp1), u->meta.inactive_exit_timestamp.realtime)),
624                 prefix, strna(format_timestamp(timestamp2, sizeof(timestamp2), u->meta.active_enter_timestamp.realtime)),
625                 prefix, strna(format_timestamp(timestamp3, sizeof(timestamp3), u->meta.active_exit_timestamp.realtime)),
626                 prefix, strna(format_timestamp(timestamp4, sizeof(timestamp4), u->meta.inactive_enter_timestamp.realtime)),
627                 prefix, yes_no(unit_check_gc(u)),
628                 prefix, yes_no(unit_need_daemon_reload(u)));
629
630         SET_FOREACH(t, u->meta.names, i)
631                 fprintf(f, "%s\tName: %s\n", prefix, t);
632
633         if ((following = unit_following(u)))
634                 fprintf(f, "%s\tFollowing: %s\n", prefix, following->meta.id);
635
636         if (u->meta.fragment_path)
637                 fprintf(f, "%s\tFragment Path: %s\n", prefix, u->meta.fragment_path);
638
639         if (u->meta.job_timeout > 0)
640                 fprintf(f, "%s\tJob Timeout: %s\n", prefix, format_timespan(timespan, sizeof(timespan), u->meta.job_timeout));
641
642         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++) {
643                 Unit *other;
644
645                 SET_FOREACH(other, u->meta.dependencies[d], i)
646                         fprintf(f, "%s\t%s: %s\n", prefix, unit_dependency_to_string(d), other->meta.id);
647         }
648
649         if (u->meta.load_state == UNIT_LOADED) {
650                 fprintf(f,
651                         "%s\tRecursive Stop: %s\n"
652                         "%s\tStopWhenUnneeded: %s\n"
653                         "%s\tRefuseManualStart: %s\n"
654                         "%s\tRefuseManualStop: %s\n"
655                         "%s\tDefaultDependencies: %s\n"
656                         "%s\tIgnoreDependencyFailure: %s\n",
657                         prefix, yes_no(u->meta.recursive_stop),
658                         prefix, yes_no(u->meta.stop_when_unneeded),
659                         prefix, yes_no(u->meta.refuse_manual_start),
660                         prefix, yes_no(u->meta.refuse_manual_stop),
661                         prefix, yes_no(u->meta.default_dependencies),
662                         prefix, yes_no(u->meta.ignore_dependency_failure));
663
664                 LIST_FOREACH(by_unit, b, u->meta.cgroup_bondings)
665                         fprintf(f, "%s\tControlGroup: %s:%s\n",
666                                 prefix, b->controller, b->path);
667
668                 if (UNIT_VTABLE(u)->dump)
669                         UNIT_VTABLE(u)->dump(u, f, prefix2);
670
671         } else if (u->meta.load_state == UNIT_MERGED)
672                 fprintf(f,
673                         "%s\tMerged into: %s\n",
674                         prefix, u->meta.merged_into->meta.id);
675
676         if (u->meta.job)
677                 job_dump(u->meta.job, f, prefix2);
678
679         free(p2);
680 }
681
682 /* Common implementation for multiple backends */
683 int unit_load_fragment_and_dropin(Unit *u) {
684         int r;
685
686         assert(u);
687
688         /* Load a .service file */
689         if ((r = unit_load_fragment(u)) < 0)
690                 return r;
691
692         if (u->meta.load_state == UNIT_STUB)
693                 return -ENOENT;
694
695         /* Load drop-in directory data */
696         if ((r = unit_load_dropin(unit_follow_merge(u))) < 0)
697                 return r;
698
699         return 0;
700 }
701
702 /* Common implementation for multiple backends */
703 int unit_load_fragment_and_dropin_optional(Unit *u) {
704         int r;
705
706         assert(u);
707
708         /* Same as unit_load_fragment_and_dropin(), but whether
709          * something can be loaded or not doesn't matter. */
710
711         /* Load a .service file */
712         if ((r = unit_load_fragment(u)) < 0)
713                 return r;
714
715         if (u->meta.load_state == UNIT_STUB)
716                 u->meta.load_state = UNIT_LOADED;
717
718         /* Load drop-in directory data */
719         if ((r = unit_load_dropin(unit_follow_merge(u))) < 0)
720                 return r;
721
722         return 0;
723 }
724
725 int unit_load(Unit *u) {
726         int r;
727
728         assert(u);
729
730         if (u->meta.in_load_queue) {
731                 LIST_REMOVE(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
732                 u->meta.in_load_queue = false;
733         }
734
735         if (u->meta.type == _UNIT_TYPE_INVALID)
736                 return -EINVAL;
737
738         if (u->meta.load_state != UNIT_STUB)
739                 return 0;
740
741         if (UNIT_VTABLE(u)->load)
742                 if ((r = UNIT_VTABLE(u)->load(u)) < 0)
743                         goto fail;
744
745         if (u->meta.load_state == UNIT_STUB) {
746                 r = -ENOENT;
747                 goto fail;
748         }
749
750         assert((u->meta.load_state != UNIT_MERGED) == !u->meta.merged_into);
751
752         unit_add_to_dbus_queue(unit_follow_merge(u));
753         unit_add_to_gc_queue(u);
754
755         return 0;
756
757 fail:
758         u->meta.load_state = UNIT_FAILED;
759         unit_add_to_dbus_queue(u);
760
761         log_notice("Failed to load configuration for %s: %s", u->meta.id, strerror(-r));
762
763         return r;
764 }
765
766 /* Errors:
767  *         -EBADR:     This unit type does not support starting.
768  *         -EALREADY:  Unit is already started.
769  *         -EAGAIN:    An operation is already in progress. Retry later.
770  *         -ECANCELED: Too many requests for now.
771  */
772 int unit_start(Unit *u) {
773         UnitActiveState state;
774
775         assert(u);
776
777         if (u->meta.load_state != UNIT_LOADED)
778                 return -EINVAL;
779
780         /* If this is already (being) started, then this will
781          * succeed. Note that this will even succeed if this unit is
782          * not startable by the user. This is relied on to detect when
783          * we need to wait for units and when waiting is finished. */
784         state = unit_active_state(u);
785         if (UNIT_IS_ACTIVE_OR_RELOADING(state))
786                 return -EALREADY;
787
788         /* If it is stopped, but we cannot start it, then fail */
789         if (!UNIT_VTABLE(u)->start)
790                 return -EBADR;
791
792         /* We don't suppress calls to ->start() here when we are
793          * already starting, to allow this request to be used as a
794          * "hurry up" call, for example when the unit is in some "auto
795          * restart" state where it waits for a holdoff timer to elapse
796          * before it will start again. */
797
798         unit_add_to_dbus_queue(u);
799
800         unit_status_printf(u, "Starting %s...\n", unit_description(u));
801
802         return UNIT_VTABLE(u)->start(u);
803 }
804
805 bool unit_can_start(Unit *u) {
806         assert(u);
807
808         return !!UNIT_VTABLE(u)->start;
809 }
810
811 /* Errors:
812  *         -EBADR:    This unit type does not support stopping.
813  *         -EALREADY: Unit is already stopped.
814  *         -EAGAIN:   An operation is already in progress. Retry later.
815  */
816 int unit_stop(Unit *u) {
817         UnitActiveState state;
818
819         assert(u);
820
821         state = unit_active_state(u);
822         if (UNIT_IS_INACTIVE_OR_MAINTENANCE(state))
823                 return -EALREADY;
824
825         if (!UNIT_VTABLE(u)->stop)
826                 return -EBADR;
827
828         unit_add_to_dbus_queue(u);
829
830         unit_status_printf(u, "Stopping %s...\n", unit_description(u));
831
832         return UNIT_VTABLE(u)->stop(u);
833 }
834
835 /* Errors:
836  *         -EBADR:    This unit type does not support reloading.
837  *         -ENOEXEC:  Unit is not started.
838  *         -EAGAIN:   An operation is already in progress. Retry later.
839  */
840 int unit_reload(Unit *u) {
841         UnitActiveState state;
842
843         assert(u);
844
845         if (u->meta.load_state != UNIT_LOADED)
846                 return -EINVAL;
847
848         if (!unit_can_reload(u))
849                 return -EBADR;
850
851         state = unit_active_state(u);
852         if (state == UNIT_RELOADING)
853                 return -EALREADY;
854
855         if (state != UNIT_ACTIVE)
856                 return -ENOEXEC;
857
858         unit_add_to_dbus_queue(u);
859         return UNIT_VTABLE(u)->reload(u);
860 }
861
862 bool unit_can_reload(Unit *u) {
863         assert(u);
864
865         if (!UNIT_VTABLE(u)->reload)
866                 return false;
867
868         if (!UNIT_VTABLE(u)->can_reload)
869                 return true;
870
871         return UNIT_VTABLE(u)->can_reload(u);
872 }
873
874 static void unit_check_uneeded(Unit *u) {
875         Iterator i;
876         Unit *other;
877
878         assert(u);
879
880         /* If this service shall be shut down when unneeded then do
881          * so. */
882
883         if (!u->meta.stop_when_unneeded)
884                 return;
885
886         if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)))
887                 return;
888
889         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY], i)
890                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
891                         return;
892
893         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY_OVERRIDABLE], i)
894                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
895                         return;
896
897         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTED_BY], i)
898                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
899                         return;
900
901         log_info("Service %s is not needed anymore. Stopping.", u->meta.id);
902
903         /* Ok, nobody needs us anymore. Sniff. Then let's commit suicide */
904         manager_add_job(u->meta.manager, JOB_STOP, u, JOB_FAIL, true, NULL, NULL);
905 }
906
907 static void retroactively_start_dependencies(Unit *u) {
908         Iterator i;
909         Unit *other;
910
911         assert(u);
912         assert(UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)));
913
914         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES], i)
915                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
916                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL, NULL);
917
918         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES_OVERRIDABLE], i)
919                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
920                         manager_add_job(u->meta.manager, JOB_START, other, JOB_FAIL, false, NULL, NULL);
921
922         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE], i)
923                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
924                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL, NULL);
925
926         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTS], i)
927                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
928                         manager_add_job(u->meta.manager, JOB_START, other, JOB_FAIL, false, NULL, NULL);
929
930         SET_FOREACH(other, u->meta.dependencies[UNIT_CONFLICTS], i)
931                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
932                         manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL, NULL);
933
934         SET_FOREACH(other, u->meta.dependencies[UNIT_CONFLICTED_BY], i)
935                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
936                         manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL, NULL);
937 }
938
939 static void retroactively_stop_dependencies(Unit *u) {
940         Iterator i;
941         Unit *other;
942
943         assert(u);
944         assert(UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u)));
945
946         if (u->meta.recursive_stop) {
947                 /* Pull down units need us recursively if enabled */
948                 SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY], i)
949                         if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
950                                 manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL, NULL);
951         }
952
953         /* Garbage collect services that might not be needed anymore, if enabled */
954         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES], i)
955                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
956                         unit_check_uneeded(other);
957         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES_OVERRIDABLE], i)
958                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
959                         unit_check_uneeded(other);
960         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTS], i)
961                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
962                         unit_check_uneeded(other);
963         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE], i)
964                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
965                         unit_check_uneeded(other);
966         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE_OVERRIDABLE], i)
967                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
968                         unit_check_uneeded(other);
969 }
970
971 void unit_notify(Unit *u, UnitActiveState os, UnitActiveState ns) {
972         dual_timestamp ts;
973         bool unexpected;
974
975         assert(u);
976         assert(os < _UNIT_ACTIVE_STATE_MAX);
977         assert(ns < _UNIT_ACTIVE_STATE_MAX);
978
979         /* Note that this is called for all low-level state changes,
980          * even if they might map to the same high-level
981          * UnitActiveState! That means that ns == os is OK an expected
982          * behaviour here. For example: if a mount point is remounted
983          * this function will be called too! */
984
985         dual_timestamp_get(&ts);
986
987         if (UNIT_IS_INACTIVE_OR_MAINTENANCE(os) && !UNIT_IS_INACTIVE_OR_MAINTENANCE(ns))
988                 u->meta.inactive_exit_timestamp = ts;
989         else if (!UNIT_IS_INACTIVE_OR_MAINTENANCE(os) && UNIT_IS_INACTIVE_OR_MAINTENANCE(ns))
990                 u->meta.inactive_enter_timestamp = ts;
991
992         if (!UNIT_IS_ACTIVE_OR_RELOADING(os) && UNIT_IS_ACTIVE_OR_RELOADING(ns))
993                 u->meta.active_enter_timestamp = ts;
994         else if (UNIT_IS_ACTIVE_OR_RELOADING(os) && !UNIT_IS_ACTIVE_OR_RELOADING(ns))
995                 u->meta.active_exit_timestamp = ts;
996
997         if (UNIT_IS_INACTIVE_OR_MAINTENANCE(ns))
998                 cgroup_bonding_trim_list(u->meta.cgroup_bondings, true);
999
1000         timer_unit_notify(u, ns);
1001         path_unit_notify(u, ns);
1002
1003         if (u->meta.job) {
1004                 unexpected = false;
1005
1006                 if (u->meta.job->state == JOB_WAITING)
1007
1008                         /* So we reached a different state for this
1009                          * job. Let's see if we can run it now if it
1010                          * failed previously due to EAGAIN. */
1011                         job_add_to_run_queue(u->meta.job);
1012
1013                 /* Let's check whether this state change constitutes a
1014                  * finished job, or maybe cotradicts a running job and
1015                  * hence needs to invalidate jobs. */
1016
1017                 switch (u->meta.job->type) {
1018
1019                 case JOB_START:
1020                 case JOB_VERIFY_ACTIVE:
1021
1022                         if (UNIT_IS_ACTIVE_OR_RELOADING(ns))
1023                                 job_finish_and_invalidate(u->meta.job, true);
1024                         else if (u->meta.job->state == JOB_RUNNING && ns != UNIT_ACTIVATING) {
1025                                 unexpected = true;
1026
1027                                 if (UNIT_IS_INACTIVE_OR_MAINTENANCE(ns))
1028                                         job_finish_and_invalidate(u->meta.job, ns != UNIT_MAINTENANCE);
1029                         }
1030
1031                         break;
1032
1033                 case JOB_RELOAD:
1034                 case JOB_RELOAD_OR_START:
1035
1036                         if (u->meta.job->state == JOB_RUNNING) {
1037                                 if (ns == UNIT_ACTIVE)
1038                                         job_finish_and_invalidate(u->meta.job, true);
1039                                 else if (ns != UNIT_ACTIVATING && ns != UNIT_RELOADING) {
1040                                         unexpected = true;
1041
1042                                         if (UNIT_IS_INACTIVE_OR_MAINTENANCE(ns))
1043                                                 job_finish_and_invalidate(u->meta.job, ns != UNIT_MAINTENANCE);
1044                                 }
1045                         }
1046
1047                         break;
1048
1049                 case JOB_STOP:
1050                 case JOB_RESTART:
1051                 case JOB_TRY_RESTART:
1052
1053                         if (UNIT_IS_INACTIVE_OR_MAINTENANCE(ns))
1054                                 job_finish_and_invalidate(u->meta.job, true);
1055                         else if (u->meta.job->state == JOB_RUNNING && ns != UNIT_DEACTIVATING) {
1056                                 unexpected = true;
1057                                 job_finish_and_invalidate(u->meta.job, false);
1058                         }
1059
1060                         break;
1061
1062                 default:
1063                         assert_not_reached("Job type unknown");
1064                 }
1065
1066         } else
1067                 unexpected = true;
1068
1069         /* If this state change happened without being requested by a
1070          * job, then let's retroactively start or stop
1071          * dependencies. We skip that step when deserializing, since
1072          * we don't want to create any additional jobs just because
1073          * something is already activated. */
1074
1075         if (unexpected && u->meta.manager->n_deserializing <= 0) {
1076                 if (UNIT_IS_INACTIVE_OR_DEACTIVATING(os) && UNIT_IS_ACTIVE_OR_ACTIVATING(ns))
1077                         retroactively_start_dependencies(u);
1078                 else if (UNIT_IS_ACTIVE_OR_ACTIVATING(os) && UNIT_IS_INACTIVE_OR_DEACTIVATING(ns))
1079                         retroactively_stop_dependencies(u);
1080         }
1081
1082         if (ns != os && ns == UNIT_MAINTENANCE) {
1083                 Iterator i;
1084                 Unit *other;
1085
1086                 SET_FOREACH(other, u->meta.dependencies[UNIT_ON_FAILURE], i)
1087                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL, NULL);
1088
1089                 log_notice("Unit %s entered maintenance state.", u->meta.id);
1090         }
1091
1092         /* Some names are special */
1093         if (UNIT_IS_ACTIVE_OR_RELOADING(ns)) {
1094                 if (unit_has_name(u, SPECIAL_DBUS_SERVICE))
1095                         /* The bus just might have become available,
1096                          * hence try to connect to it, if we aren't
1097                          * yet connected. */
1098                         bus_init(u->meta.manager);
1099
1100                 if (unit_has_name(u, SPECIAL_SYSLOG_SERVICE))
1101                         /* The syslog daemon just might have become
1102                          * available, hence try to connect to it, if
1103                          * we aren't yet connected. */
1104                         log_open();
1105
1106                 if (u->meta.type == UNIT_SERVICE &&
1107                     !UNIT_IS_ACTIVE_OR_RELOADING(os)) {
1108                         /* Write audit record if we have just finished starting up */
1109                         manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_START, 1);
1110                         u->meta.in_audit = true;
1111                 }
1112
1113         } else {
1114
1115                 if (unit_has_name(u, SPECIAL_SYSLOG_SERVICE))
1116                         /* The syslog daemon might just have
1117                          * terminated, hence try to disconnect from
1118                          * it. */
1119                         log_close_syslog();
1120
1121                 /* We don't care about D-Bus here, since we'll get an
1122                  * asynchronous notification for it anyway. */
1123
1124                 if (u->meta.type == UNIT_SERVICE &&
1125                     UNIT_IS_INACTIVE_OR_MAINTENANCE(ns) &&
1126                     !UNIT_IS_INACTIVE_OR_MAINTENANCE(os)) {
1127
1128                         /* Hmm, if there was no start record written
1129                          * write it now, so that we always have a nice
1130                          * pair */
1131                         if (!u->meta.in_audit) {
1132                                 manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_START, ns == UNIT_INACTIVE);
1133
1134                                 if (ns == UNIT_INACTIVE)
1135                                         manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_STOP, true);
1136                         } else
1137                                 /* Write audit record if we have just finished shutting down */
1138                                 manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_STOP, ns == UNIT_INACTIVE);
1139
1140                         u->meta.in_audit = false;
1141                 }
1142         }
1143
1144         /* Maybe we finished startup and are now ready for being
1145          * stopped because unneeded? */
1146         unit_check_uneeded(u);
1147
1148         unit_add_to_dbus_queue(u);
1149         unit_add_to_gc_queue(u);
1150 }
1151
1152 int unit_watch_fd(Unit *u, int fd, uint32_t events, Watch *w) {
1153         struct epoll_event ev;
1154
1155         assert(u);
1156         assert(fd >= 0);
1157         assert(w);
1158         assert(w->type == WATCH_INVALID || (w->type == WATCH_FD && w->fd == fd && w->data.unit == u));
1159
1160         zero(ev);
1161         ev.data.ptr = w;
1162         ev.events = events;
1163
1164         if (epoll_ctl(u->meta.manager->epoll_fd,
1165                       w->type == WATCH_INVALID ? EPOLL_CTL_ADD : EPOLL_CTL_MOD,
1166                       fd,
1167                       &ev) < 0)
1168                 return -errno;
1169
1170         w->fd = fd;
1171         w->type = WATCH_FD;
1172         w->data.unit = u;
1173
1174         return 0;
1175 }
1176
1177 void unit_unwatch_fd(Unit *u, Watch *w) {
1178         assert(u);
1179         assert(w);
1180
1181         if (w->type == WATCH_INVALID)
1182                 return;
1183
1184         assert(w->type == WATCH_FD);
1185         assert(w->data.unit == u);
1186         assert_se(epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_DEL, w->fd, NULL) >= 0);
1187
1188         w->fd = -1;
1189         w->type = WATCH_INVALID;
1190         w->data.unit = NULL;
1191 }
1192
1193 int unit_watch_pid(Unit *u, pid_t pid) {
1194         assert(u);
1195         assert(pid >= 1);
1196
1197         /* Watch a specific PID. We only support one unit watching
1198          * each PID for now. */
1199
1200         return hashmap_put(u->meta.manager->watch_pids, LONG_TO_PTR(pid), u);
1201 }
1202
1203 void unit_unwatch_pid(Unit *u, pid_t pid) {
1204         assert(u);
1205         assert(pid >= 1);
1206
1207         hashmap_remove_value(u->meta.manager->watch_pids, LONG_TO_PTR(pid), u);
1208 }
1209
1210 int unit_watch_timer(Unit *u, usec_t delay, Watch *w) {
1211         struct itimerspec its;
1212         int flags, fd;
1213         bool ours;
1214
1215         assert(u);
1216         assert(w);
1217         assert(w->type == WATCH_INVALID || (w->type == WATCH_UNIT_TIMER && w->data.unit == u));
1218
1219         /* This will try to reuse the old timer if there is one */
1220
1221         if (w->type == WATCH_UNIT_TIMER) {
1222                 assert(w->data.unit == u);
1223                 assert(w->fd >= 0);
1224
1225                 ours = false;
1226                 fd = w->fd;
1227         } else if (w->type == WATCH_INVALID) {
1228
1229                 ours = true;
1230                 if ((fd = timerfd_create(CLOCK_MONOTONIC, TFD_NONBLOCK|TFD_CLOEXEC)) < 0)
1231                         return -errno;
1232         } else
1233                 assert_not_reached("Invalid watch type");
1234
1235         zero(its);
1236
1237         if (delay <= 0) {
1238                 /* Set absolute time in the past, but not 0, since we
1239                  * don't want to disarm the timer */
1240                 its.it_value.tv_sec = 0;
1241                 its.it_value.tv_nsec = 1;
1242
1243                 flags = TFD_TIMER_ABSTIME;
1244         } else {
1245                 timespec_store(&its.it_value, delay);
1246                 flags = 0;
1247         }
1248
1249         /* This will also flush the elapse counter */
1250         if (timerfd_settime(fd, flags, &its, NULL) < 0)
1251                 goto fail;
1252
1253         if (w->type == WATCH_INVALID) {
1254                 struct epoll_event ev;
1255
1256                 zero(ev);
1257                 ev.data.ptr = w;
1258                 ev.events = EPOLLIN;
1259
1260                 if (epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_ADD, fd, &ev) < 0)
1261                         goto fail;
1262         }
1263
1264         w->type = WATCH_UNIT_TIMER;
1265         w->fd = fd;
1266         w->data.unit = u;
1267
1268         return 0;
1269
1270 fail:
1271         if (ours)
1272                 close_nointr_nofail(fd);
1273
1274         return -errno;
1275 }
1276
1277 void unit_unwatch_timer(Unit *u, Watch *w) {
1278         assert(u);
1279         assert(w);
1280
1281         if (w->type == WATCH_INVALID)
1282                 return;
1283
1284         assert(w->type == WATCH_UNIT_TIMER);
1285         assert(w->data.unit == u);
1286         assert(w->fd >= 0);
1287
1288         assert_se(epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_DEL, w->fd, NULL) >= 0);
1289         close_nointr_nofail(w->fd);
1290
1291         w->fd = -1;
1292         w->type = WATCH_INVALID;
1293         w->data.unit = NULL;
1294 }
1295
1296 bool unit_job_is_applicable(Unit *u, JobType j) {
1297         assert(u);
1298         assert(j >= 0 && j < _JOB_TYPE_MAX);
1299
1300         switch (j) {
1301
1302         case JOB_VERIFY_ACTIVE:
1303         case JOB_START:
1304                 return true;
1305
1306         case JOB_STOP:
1307         case JOB_RESTART:
1308         case JOB_TRY_RESTART:
1309                 return unit_can_start(u);
1310
1311         case JOB_RELOAD:
1312                 return unit_can_reload(u);
1313
1314         case JOB_RELOAD_OR_START:
1315                 return unit_can_reload(u) && unit_can_start(u);
1316
1317         default:
1318                 assert_not_reached("Invalid job type");
1319         }
1320 }
1321
1322 int unit_add_dependency(Unit *u, UnitDependency d, Unit *other, bool add_reference) {
1323
1324         static const UnitDependency inverse_table[_UNIT_DEPENDENCY_MAX] = {
1325                 [UNIT_REQUIRES] = UNIT_REQUIRED_BY,
1326                 [UNIT_REQUIRES_OVERRIDABLE] = UNIT_REQUIRED_BY_OVERRIDABLE,
1327                 [UNIT_WANTS] = UNIT_WANTED_BY,
1328                 [UNIT_REQUISITE] = UNIT_REQUIRED_BY,
1329                 [UNIT_REQUISITE_OVERRIDABLE] = UNIT_REQUIRED_BY_OVERRIDABLE,
1330                 [UNIT_REQUIRED_BY] = _UNIT_DEPENDENCY_INVALID,
1331                 [UNIT_REQUIRED_BY_OVERRIDABLE] = _UNIT_DEPENDENCY_INVALID,
1332                 [UNIT_WANTED_BY] = _UNIT_DEPENDENCY_INVALID,
1333                 [UNIT_CONFLICTS] = UNIT_CONFLICTED_BY,
1334                 [UNIT_CONFLICTED_BY] = UNIT_CONFLICTS,
1335                 [UNIT_BEFORE] = UNIT_AFTER,
1336                 [UNIT_AFTER] = UNIT_BEFORE,
1337                 [UNIT_ON_FAILURE] = _UNIT_DEPENDENCY_INVALID,
1338                 [UNIT_REFERENCES] = UNIT_REFERENCED_BY,
1339                 [UNIT_REFERENCED_BY] = UNIT_REFERENCES
1340         };
1341         int r, q = 0, v = 0, w = 0;
1342
1343         assert(u);
1344         assert(d >= 0 && d < _UNIT_DEPENDENCY_MAX);
1345         assert(other);
1346
1347         /* We won't allow dependencies on ourselves. We will not
1348          * consider them an error however. */
1349         if (u == other)
1350                 return 0;
1351
1352         if (UNIT_VTABLE(u)->no_requires &&
1353             (d == UNIT_REQUIRES ||
1354              d == UNIT_REQUIRES_OVERRIDABLE ||
1355              d == UNIT_REQUISITE ||
1356              d == UNIT_REQUISITE_OVERRIDABLE)) {
1357                     return -EINVAL;
1358         }
1359
1360         if ((r = set_ensure_allocated(&u->meta.dependencies[d], trivial_hash_func, trivial_compare_func)) < 0)
1361                 return r;
1362
1363         if (inverse_table[d] != _UNIT_DEPENDENCY_INVALID)
1364                 if ((r = set_ensure_allocated(&other->meta.dependencies[inverse_table[d]], trivial_hash_func, trivial_compare_func)) < 0)
1365                         return r;
1366
1367         if (add_reference)
1368                 if ((r = set_ensure_allocated(&u->meta.dependencies[UNIT_REFERENCES], trivial_hash_func, trivial_compare_func)) < 0 ||
1369                     (r = set_ensure_allocated(&other->meta.dependencies[UNIT_REFERENCED_BY], trivial_hash_func, trivial_compare_func)) < 0)
1370                         return r;
1371
1372         if ((q = set_put(u->meta.dependencies[d], other)) < 0)
1373                 return q;
1374
1375         if (inverse_table[d] != _UNIT_DEPENDENCY_INVALID)
1376                 if ((v = set_put(other->meta.dependencies[inverse_table[d]], u)) < 0) {
1377                         r = v;
1378                         goto fail;
1379                 }
1380
1381         if (add_reference) {
1382                 if ((w = set_put(u->meta.dependencies[UNIT_REFERENCES], other)) < 0) {
1383                         r = w;
1384                         goto fail;
1385                 }
1386
1387                 if ((r = set_put(other->meta.dependencies[UNIT_REFERENCED_BY], u)) < 0)
1388                         goto fail;
1389         }
1390
1391         unit_add_to_dbus_queue(u);
1392         return 0;
1393
1394 fail:
1395         if (q > 0)
1396                 set_remove(u->meta.dependencies[d], other);
1397
1398         if (v > 0)
1399                 set_remove(other->meta.dependencies[inverse_table[d]], u);
1400
1401         if (w > 0)
1402                 set_remove(u->meta.dependencies[UNIT_REFERENCES], other);
1403
1404         return r;
1405 }
1406
1407 int unit_add_two_dependencies(Unit *u, UnitDependency d, UnitDependency e, Unit *other, bool add_reference) {
1408         int r;
1409
1410         assert(u);
1411
1412         if ((r = unit_add_dependency(u, d, other, add_reference)) < 0)
1413                 return r;
1414
1415         if ((r = unit_add_dependency(u, e, other, add_reference)) < 0)
1416                 return r;
1417
1418         return 0;
1419 }
1420
1421 static const char *resolve_template(Unit *u, const char *name, const char*path, char **p) {
1422         char *s;
1423
1424         assert(u);
1425         assert(name || path);
1426
1427         if (!name)
1428                 name = file_name_from_path(path);
1429
1430         if (!unit_name_is_template(name)) {
1431                 *p = NULL;
1432                 return name;
1433         }
1434
1435         if (u->meta.instance)
1436                 s = unit_name_replace_instance(name, u->meta.instance);
1437         else {
1438                 char *i;
1439
1440                 if (!(i = unit_name_to_prefix(u->meta.id)))
1441                         return NULL;
1442
1443                 s = unit_name_replace_instance(name, i);
1444                 free(i);
1445         }
1446
1447         if (!s)
1448                 return NULL;
1449
1450         *p = s;
1451         return s;
1452 }
1453
1454 int unit_add_dependency_by_name(Unit *u, UnitDependency d, const char *name, const char *path, bool add_reference) {
1455         Unit *other;
1456         int r;
1457         char *s;
1458
1459         assert(u);
1460         assert(name || path);
1461
1462         if (!(name = resolve_template(u, name, path, &s)))
1463                 return -ENOMEM;
1464
1465         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1466                 goto finish;
1467
1468         r = unit_add_dependency(u, d, other, add_reference);
1469
1470 finish:
1471         free(s);
1472         return r;
1473 }
1474
1475 int unit_add_two_dependencies_by_name(Unit *u, UnitDependency d, UnitDependency e, const char *name, const char *path, bool add_reference) {
1476         Unit *other;
1477         int r;
1478         char *s;
1479
1480         assert(u);
1481         assert(name || path);
1482
1483         if (!(name = resolve_template(u, name, path, &s)))
1484                 return -ENOMEM;
1485
1486         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1487                 goto finish;
1488
1489         r = unit_add_two_dependencies(u, d, e, other, add_reference);
1490
1491 finish:
1492         free(s);
1493         return r;
1494 }
1495
1496 int unit_add_dependency_by_name_inverse(Unit *u, UnitDependency d, const char *name, const char *path, bool add_reference) {
1497         Unit *other;
1498         int r;
1499         char *s;
1500
1501         assert(u);
1502         assert(name || path);
1503
1504         if (!(name = resolve_template(u, name, path, &s)))
1505                 return -ENOMEM;
1506
1507         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1508                 goto finish;
1509
1510         r = unit_add_dependency(other, d, u, add_reference);
1511
1512 finish:
1513         free(s);
1514         return r;
1515 }
1516
1517 int unit_add_two_dependencies_by_name_inverse(Unit *u, UnitDependency d, UnitDependency e, const char *name, const char *path, bool add_reference) {
1518         Unit *other;
1519         int r;
1520         char *s;
1521
1522         assert(u);
1523         assert(name || path);
1524
1525         if (!(name = resolve_template(u, name, path, &s)))
1526                 return -ENOMEM;
1527
1528         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1529                 goto finish;
1530
1531         if ((r = unit_add_two_dependencies(other, d, e, u, add_reference)) < 0)
1532                 goto finish;
1533
1534 finish:
1535         free(s);
1536         return r;
1537 }
1538
1539 int set_unit_path(const char *p) {
1540         char *cwd, *c;
1541         int r;
1542
1543         /* This is mostly for debug purposes */
1544
1545         if (path_is_absolute(p)) {
1546                 if (!(c = strdup(p)))
1547                         return -ENOMEM;
1548         } else {
1549                 if (!(cwd = get_current_dir_name()))
1550                         return -errno;
1551
1552                 r = asprintf(&c, "%s/%s", cwd, p);
1553                 free(cwd);
1554
1555                 if (r < 0)
1556                         return -ENOMEM;
1557         }
1558
1559         if (setenv("SYSTEMD_UNIT_PATH", c, 0) < 0) {
1560                 r = -errno;
1561                 free(c);
1562                 return r;
1563         }
1564
1565         return 0;
1566 }
1567
1568 char *unit_dbus_path(Unit *u) {
1569         char *p, *e;
1570
1571         assert(u);
1572
1573         if (!u->meta.id)
1574                 return NULL;
1575
1576         if (!(e = bus_path_escape(u->meta.id)))
1577                 return NULL;
1578
1579         p = strappend("/org/freedesktop/systemd1/unit/", e);
1580         free(e);
1581
1582         return p;
1583 }
1584
1585 int unit_add_cgroup(Unit *u, CGroupBonding *b) {
1586         CGroupBonding *l;
1587         int r;
1588
1589         assert(u);
1590         assert(b);
1591
1592         assert(b->path);
1593
1594         if (!b->controller)
1595                 if (!(b->controller = strdup(SYSTEMD_CGROUP_CONTROLLER)))
1596                         return -ENOMEM;
1597
1598         /* Ensure this hasn't been added yet */
1599         assert(!b->unit);
1600
1601         l = hashmap_get(u->meta.manager->cgroup_bondings, b->path);
1602         LIST_PREPEND(CGroupBonding, by_path, l, b);
1603
1604         if ((r = hashmap_replace(u->meta.manager->cgroup_bondings, b->path, l)) < 0) {
1605                 LIST_REMOVE(CGroupBonding, by_path, l, b);
1606                 return r;
1607         }
1608
1609         LIST_PREPEND(CGroupBonding, by_unit, u->meta.cgroup_bondings, b);
1610         b->unit = u;
1611
1612         return 0;
1613 }
1614
1615 static char *default_cgroup_path(Unit *u) {
1616         char *p;
1617         int r;
1618
1619         assert(u);
1620
1621         if (u->meta.instance) {
1622                 char *t;
1623
1624                 if (!(t = unit_name_template(u->meta.id)))
1625                         return NULL;
1626
1627                 r = asprintf(&p, "%s/%s/%s", u->meta.manager->cgroup_hierarchy, t, u->meta.instance);
1628                 free(t);
1629         } else
1630                 r = asprintf(&p, "%s/%s", u->meta.manager->cgroup_hierarchy, u->meta.id);
1631
1632         return r < 0 ? NULL : p;
1633 }
1634
1635 int unit_add_cgroup_from_text(Unit *u, const char *name) {
1636         char *controller = NULL, *path = NULL;
1637         CGroupBonding *b = NULL;
1638         int r;
1639
1640         assert(u);
1641         assert(name);
1642
1643         if ((r = cg_split_spec(name, &controller, &path)) < 0)
1644                 return r;
1645
1646         if (!path)
1647                 path = default_cgroup_path(u);
1648
1649         if (!controller)
1650                 controller = strdup(SYSTEMD_CGROUP_CONTROLLER);
1651
1652         if (!path || !controller) {
1653                 free(path);
1654                 free(controller);
1655
1656                 return -ENOMEM;
1657         }
1658
1659         if (cgroup_bonding_find_list(u->meta.cgroup_bondings, controller)) {
1660                 r = -EEXIST;
1661                 goto fail;
1662         }
1663
1664         if (!(b = new0(CGroupBonding, 1))) {
1665                 r = -ENOMEM;
1666                 goto fail;
1667         }
1668
1669         b->controller = controller;
1670         b->path = path;
1671         b->only_us = false;
1672         b->clean_up = false;
1673
1674         if ((r = unit_add_cgroup(u, b)) < 0)
1675                 goto fail;
1676
1677         return 0;
1678
1679 fail:
1680         free(path);
1681         free(controller);
1682         free(b);
1683
1684         return r;
1685 }
1686
1687 int unit_add_default_cgroup(Unit *u) {
1688         CGroupBonding *b;
1689         int r = -ENOMEM;
1690
1691         assert(u);
1692
1693         /* Adds in the default cgroup data, if it wasn't specified yet */
1694
1695         if (unit_get_default_cgroup(u))
1696                 return 0;
1697
1698         if (!(b = new0(CGroupBonding, 1)))
1699                 return -ENOMEM;
1700
1701         if (!(b->path = default_cgroup_path(u)))
1702                 goto fail;
1703
1704         b->clean_up = true;
1705         b->only_us = true;
1706
1707         if ((r = unit_add_cgroup(u, b)) < 0)
1708                 goto fail;
1709
1710         return 0;
1711
1712 fail:
1713         free(b->path);
1714         free(b->controller);
1715         free(b);
1716
1717         return r;
1718 }
1719
1720 CGroupBonding* unit_get_default_cgroup(Unit *u) {
1721         assert(u);
1722
1723         return cgroup_bonding_find_list(u->meta.cgroup_bondings, SYSTEMD_CGROUP_CONTROLLER);
1724 }
1725
1726 int unit_load_related_unit(Unit *u, const char *type, Unit **_found) {
1727         char *t;
1728         int r;
1729
1730         assert(u);
1731         assert(type);
1732         assert(_found);
1733
1734         if (!(t = unit_name_change_suffix(u->meta.id, type)))
1735                 return -ENOMEM;
1736
1737         assert(!unit_has_name(u, t));
1738
1739         r = manager_load_unit(u->meta.manager, t, NULL, NULL, _found);
1740         free(t);
1741
1742         assert(r < 0 || *_found != u);
1743
1744         return r;
1745 }
1746
1747 int unit_get_related_unit(Unit *u, const char *type, Unit **_found) {
1748         Unit *found;
1749         char *t;
1750
1751         assert(u);
1752         assert(type);
1753         assert(_found);
1754
1755         if (!(t = unit_name_change_suffix(u->meta.id, type)))
1756                 return -ENOMEM;
1757
1758         assert(!unit_has_name(u, t));
1759
1760         found = manager_get_unit(u->meta.manager, t);
1761         free(t);
1762
1763         if (!found)
1764                 return -ENOENT;
1765
1766         *_found = found;
1767         return 0;
1768 }
1769
1770 static char *specifier_prefix_and_instance(char specifier, void *data, void *userdata) {
1771         Unit *u = userdata;
1772         assert(u);
1773
1774         return unit_name_to_prefix_and_instance(u->meta.id);
1775 }
1776
1777 static char *specifier_prefix(char specifier, void *data, void *userdata) {
1778         Unit *u = userdata;
1779         assert(u);
1780
1781         return unit_name_to_prefix(u->meta.id);
1782 }
1783
1784 static char *specifier_prefix_unescaped(char specifier, void *data, void *userdata) {
1785         Unit *u = userdata;
1786         char *p, *r;
1787
1788         assert(u);
1789
1790         if (!(p = unit_name_to_prefix(u->meta.id)))
1791                 return NULL;
1792
1793         r = unit_name_unescape(p);
1794         free(p);
1795
1796         return r;
1797 }
1798
1799 static char *specifier_instance_unescaped(char specifier, void *data, void *userdata) {
1800         Unit *u = userdata;
1801         assert(u);
1802
1803         if (u->meta.instance)
1804                 return unit_name_unescape(u->meta.instance);
1805
1806         return strdup("");
1807 }
1808
1809 char *unit_name_printf(Unit *u, const char* format) {
1810
1811         /*
1812          * This will use the passed string as format string and
1813          * replace the following specifiers:
1814          *
1815          * %n: the full id of the unit                 (foo@bar.waldo)
1816          * %N: the id of the unit without the suffix   (foo@bar)
1817          * %p: the prefix                              (foo)
1818          * %i: the instance                            (bar)
1819          */
1820
1821         const Specifier table[] = {
1822                 { 'n', specifier_string,              u->meta.id },
1823                 { 'N', specifier_prefix_and_instance, NULL },
1824                 { 'p', specifier_prefix,              NULL },
1825                 { 'i', specifier_string,              u->meta.instance },
1826                 { 0, NULL, NULL }
1827         };
1828
1829         assert(u);
1830         assert(format);
1831
1832         return specifier_printf(format, table, u);
1833 }
1834
1835 char *unit_full_printf(Unit *u, const char *format) {
1836
1837         /* This is similar to unit_name_printf() but also supports
1838          * unescaping */
1839
1840         const Specifier table[] = {
1841                 { 'n', specifier_string,              u->meta.id },
1842                 { 'N', specifier_prefix_and_instance, NULL },
1843                 { 'p', specifier_prefix,              NULL },
1844                 { 'P', specifier_prefix_unescaped,    NULL },
1845                 { 'i', specifier_string,              u->meta.instance },
1846                 { 'I', specifier_instance_unescaped,  NULL },
1847                 { 0, NULL, NULL }
1848         };
1849
1850         assert(u);
1851         assert(format);
1852
1853         return specifier_printf(format, table, u);
1854 }
1855
1856 char **unit_full_printf_strv(Unit *u, char **l) {
1857         size_t n;
1858         char **r, **i, **j;
1859
1860         /* Applies unit_full_printf to every entry in l */
1861
1862         assert(u);
1863
1864         n = strv_length(l);
1865         if (!(r = new(char*, n+1)))
1866                 return NULL;
1867
1868         for (i = l, j = r; *i; i++, j++)
1869                 if (!(*j = unit_full_printf(u, *i)))
1870                         goto fail;
1871
1872         *j = NULL;
1873         return r;
1874
1875 fail:
1876         j--;
1877         while (j >= r)
1878                 free(*j);
1879
1880         free(r);
1881
1882         return NULL;
1883 }
1884
1885 int unit_watch_bus_name(Unit *u, const char *name) {
1886         assert(u);
1887         assert(name);
1888
1889         /* Watch a specific name on the bus. We only support one unit
1890          * watching each name for now. */
1891
1892         return hashmap_put(u->meta.manager->watch_bus, name, u);
1893 }
1894
1895 void unit_unwatch_bus_name(Unit *u, const char *name) {
1896         assert(u);
1897         assert(name);
1898
1899         hashmap_remove_value(u->meta.manager->watch_bus, name, u);
1900 }
1901
1902 bool unit_can_serialize(Unit *u) {
1903         assert(u);
1904
1905         return UNIT_VTABLE(u)->serialize && UNIT_VTABLE(u)->deserialize_item;
1906 }
1907
1908 int unit_serialize(Unit *u, FILE *f, FDSet *fds) {
1909         int r;
1910
1911         assert(u);
1912         assert(f);
1913         assert(fds);
1914
1915         if (!unit_can_serialize(u))
1916                 return 0;
1917
1918         if ((r = UNIT_VTABLE(u)->serialize(u, f, fds)) < 0)
1919                 return r;
1920
1921         if (u->meta.job)
1922                 unit_serialize_item(u, f, "job", job_type_to_string(u->meta.job->type));
1923
1924         /* End marker */
1925         fputc('\n', f);
1926         return 0;
1927 }
1928
1929 void unit_serialize_item_format(Unit *u, FILE *f, const char *key, const char *format, ...) {
1930         va_list ap;
1931
1932         assert(u);
1933         assert(f);
1934         assert(key);
1935         assert(format);
1936
1937         fputs(key, f);
1938         fputc('=', f);
1939
1940         va_start(ap, format);
1941         vfprintf(f, format, ap);
1942         va_end(ap);
1943
1944         fputc('\n', f);
1945 }
1946
1947 void unit_serialize_item(Unit *u, FILE *f, const char *key, const char *value) {
1948         assert(u);
1949         assert(f);
1950         assert(key);
1951         assert(value);
1952
1953         fprintf(f, "%s=%s\n", key, value);
1954 }
1955
1956 int unit_deserialize(Unit *u, FILE *f, FDSet *fds) {
1957         int r;
1958
1959         assert(u);
1960         assert(f);
1961         assert(fds);
1962
1963         if (!unit_can_serialize(u))
1964                 return 0;
1965
1966         for (;;) {
1967                 char line[1024], *l, *v;
1968                 size_t k;
1969
1970                 if (!fgets(line, sizeof(line), f)) {
1971                         if (feof(f))
1972                                 return 0;
1973                         return -errno;
1974                 }
1975
1976                 char_array_0(line);
1977                 l = strstrip(line);
1978
1979                 /* End marker */
1980                 if (l[0] == 0)
1981                         return 0;
1982
1983                 k = strcspn(l, "=");
1984
1985                 if (l[k] == '=') {
1986                         l[k] = 0;
1987                         v = l+k+1;
1988                 } else
1989                         v = l+k;
1990
1991                 if (streq(l, "job")) {
1992                         JobType type;
1993
1994                         if ((type = job_type_from_string(v)) < 0)
1995                                 log_debug("Failed to parse job type value %s", v);
1996                         else
1997                                 u->meta.deserialized_job = type;
1998
1999                         continue;
2000                 }
2001
2002                 if ((r = UNIT_VTABLE(u)->deserialize_item(u, l, v, fds)) < 0)
2003                         return r;
2004         }
2005 }
2006
2007 int unit_add_node_link(Unit *u, const char *what, bool wants) {
2008         Unit *device;
2009         char *e;
2010         int r;
2011
2012         assert(u);
2013
2014         if (!what)
2015                 return 0;
2016
2017         /* Adds in links to the device node that this unit is based on */
2018
2019         if (!is_device_path(what))
2020                 return 0;
2021
2022         if (!(e = unit_name_build_escape(what+1, NULL, ".device")))
2023                 return -ENOMEM;
2024
2025         r = manager_load_unit(u->meta.manager, e, NULL, NULL, &device);
2026         free(e);
2027
2028         if (r < 0)
2029                 return r;
2030
2031         if ((r = unit_add_two_dependencies(u, UNIT_AFTER, UNIT_REQUIRES, device, true)) < 0)
2032                 return r;
2033
2034         if (wants)
2035                 if ((r = unit_add_dependency(device, UNIT_WANTS, u, false)) < 0)
2036                         return r;
2037
2038         return 0;
2039 }
2040
2041 int unit_coldplug(Unit *u) {
2042         int r;
2043
2044         assert(u);
2045
2046         if (UNIT_VTABLE(u)->coldplug)
2047                 if ((r = UNIT_VTABLE(u)->coldplug(u)) < 0)
2048                         return r;
2049
2050         if (u->meta.deserialized_job >= 0) {
2051                 if ((r = manager_add_job(u->meta.manager, u->meta.deserialized_job, u, JOB_FAIL, false, NULL, NULL)) < 0)
2052                         return r;
2053
2054                 u->meta.deserialized_job = _JOB_TYPE_INVALID;
2055         }
2056
2057         return 0;
2058 }
2059
2060 void unit_status_printf(Unit *u, const char *format, ...) {
2061         va_list ap;
2062
2063         assert(u);
2064         assert(format);
2065
2066         if (!UNIT_VTABLE(u)->show_status)
2067                 return;
2068
2069         if (u->meta.manager->running_as != MANAGER_SYSTEM)
2070                 return;
2071
2072         if (!u->meta.manager->show_status)
2073                 return;
2074
2075         if (!manager_is_booting_or_shutting_down(u->meta.manager))
2076                 return;
2077
2078         va_start(ap, format);
2079         status_vprintf(format, ap);
2080         va_end(ap);
2081 }
2082
2083 bool unit_need_daemon_reload(Unit *u) {
2084         struct stat st;
2085
2086         assert(u);
2087
2088         if (!u->meta.fragment_path)
2089                 return false;
2090
2091         zero(st);
2092         if (stat(u->meta.fragment_path, &st) < 0)
2093                 /* What, cannot access this anymore? */
2094                 return true;
2095
2096         return
2097                 u->meta.fragment_mtime &&
2098                 timespec_load(&st.st_mtim) != u->meta.fragment_mtime;
2099 }
2100
2101 void unit_reset_maintenance(Unit *u) {
2102         assert(u);
2103
2104         if (UNIT_VTABLE(u)->reset_maintenance)
2105                 UNIT_VTABLE(u)->reset_maintenance(u);
2106 }
2107
2108 Unit *unit_following(Unit *u) {
2109         assert(u);
2110
2111         if (UNIT_VTABLE(u)->following)
2112                 return UNIT_VTABLE(u)->following(u);
2113
2114         return NULL;
2115 }
2116
2117 static const char* const unit_load_state_table[_UNIT_LOAD_STATE_MAX] = {
2118         [UNIT_STUB] = "stub",
2119         [UNIT_LOADED] = "loaded",
2120         [UNIT_FAILED] = "failed",
2121         [UNIT_MERGED] = "merged"
2122 };
2123
2124 DEFINE_STRING_TABLE_LOOKUP(unit_load_state, UnitLoadState);
2125
2126 static const char* const unit_active_state_table[_UNIT_ACTIVE_STATE_MAX] = {
2127         [UNIT_ACTIVE] = "active",
2128         [UNIT_RELOADING] = "reloading",
2129         [UNIT_INACTIVE] = "inactive",
2130         [UNIT_MAINTENANCE] = "maintenance",
2131         [UNIT_ACTIVATING] = "activating",
2132         [UNIT_DEACTIVATING] = "deactivating"
2133 };
2134
2135 DEFINE_STRING_TABLE_LOOKUP(unit_active_state, UnitActiveState);
2136
2137 static const char* const unit_dependency_table[_UNIT_DEPENDENCY_MAX] = {
2138         [UNIT_REQUIRES] = "Requires",
2139         [UNIT_REQUIRES_OVERRIDABLE] = "RequiresOverridable",
2140         [UNIT_WANTS] = "Wants",
2141         [UNIT_REQUISITE] = "Requisite",
2142         [UNIT_REQUISITE_OVERRIDABLE] = "RequisiteOverridable",
2143         [UNIT_REQUIRED_BY] = "RequiredBy",
2144         [UNIT_REQUIRED_BY_OVERRIDABLE] = "RequiredByOverridable",
2145         [UNIT_WANTED_BY] = "WantedBy",
2146         [UNIT_CONFLICTS] = "Conflicts",
2147         [UNIT_CONFLICTED_BY] = "ConflictedBy",
2148         [UNIT_BEFORE] = "Before",
2149         [UNIT_AFTER] = "After",
2150         [UNIT_REFERENCES] = "References",
2151         [UNIT_REFERENCED_BY] = "ReferencedBy",
2152         [UNIT_ON_FAILURE] = "OnFailure"
2153 };
2154
2155 DEFINE_STRING_TABLE_LOOKUP(unit_dependency, UnitDependency);
2156
2157 static const char* const kill_mode_table[_KILL_MODE_MAX] = {
2158         [KILL_CONTROL_GROUP] = "control-group",
2159         [KILL_PROCESS_GROUP] = "process-group",
2160         [KILL_PROCESS] = "process",
2161         [KILL_NONE] = "none"
2162 };
2163
2164 DEFINE_STRING_TABLE_LOOKUP(kill_mode, KillMode);