chiark / gitweb /
getty: automatically add getty on hvsi0 virtualizer console
[elogind.git] / src / unit.c
1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
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 #include "cgroup-attr.h"
46
47 const UnitVTable * const unit_vtable[_UNIT_TYPE_MAX] = {
48         [UNIT_SERVICE] = &service_vtable,
49         [UNIT_TIMER] = &timer_vtable,
50         [UNIT_SOCKET] = &socket_vtable,
51         [UNIT_TARGET] = &target_vtable,
52         [UNIT_DEVICE] = &device_vtable,
53         [UNIT_MOUNT] = &mount_vtable,
54         [UNIT_AUTOMOUNT] = &automount_vtable,
55         [UNIT_SNAPSHOT] = &snapshot_vtable,
56         [UNIT_SWAP] = &swap_vtable,
57         [UNIT_PATH] = &path_vtable
58 };
59
60 Unit *unit_new(Manager *m) {
61         Unit *u;
62
63         assert(m);
64
65         if (!(u = new0(Unit, 1)))
66                 return NULL;
67
68         if (!(u->meta.names = set_new(string_hash_func, string_compare_func))) {
69                 free(u);
70                 return NULL;
71         }
72
73         u->meta.manager = m;
74         u->meta.type = _UNIT_TYPE_INVALID;
75         u->meta.deserialized_job = _JOB_TYPE_INVALID;
76         u->meta.default_dependencies = true;
77         u->meta.unit_file_state = _UNIT_FILE_STATE_INVALID;
78
79         return u;
80 }
81
82 bool unit_has_name(Unit *u, const char *name) {
83         assert(u);
84         assert(name);
85
86         return !!set_get(u->meta.names, (char*) name);
87 }
88
89 int unit_add_name(Unit *u, const char *text) {
90         UnitType t;
91         char *s, *i = NULL;
92         int r;
93
94         assert(u);
95         assert(text);
96
97         if (unit_name_is_template(text)) {
98                 if (!u->meta.instance)
99                         return -EINVAL;
100
101                 s = unit_name_replace_instance(text, u->meta.instance);
102         } else
103                 s = strdup(text);
104
105         if (!s)
106                 return -ENOMEM;
107
108         if (!unit_name_is_valid(s, false)) {
109                 r = -EINVAL;
110                 goto fail;
111         }
112
113         assert_se((t = unit_name_to_type(s)) >= 0);
114
115         if (u->meta.type != _UNIT_TYPE_INVALID && t != u->meta.type) {
116                 r = -EINVAL;
117                 goto fail;
118         }
119
120         if ((r = unit_name_to_instance(s, &i)) < 0)
121                 goto fail;
122
123         if (i && unit_vtable[t]->no_instances) {
124                 r = -EINVAL;
125                 goto fail;
126         }
127
128         /* Ensure that this unit is either instanced or not instanced,
129          * but not both. */
130         if (u->meta.type != _UNIT_TYPE_INVALID && !u->meta.instance != !i) {
131                 r = -EINVAL;
132                 goto fail;
133         }
134
135         if (unit_vtable[t]->no_alias &&
136             !set_isempty(u->meta.names) &&
137             !set_get(u->meta.names, s)) {
138                 r = -EEXIST;
139                 goto fail;
140         }
141
142         if (hashmap_size(u->meta.manager->units) >= MANAGER_MAX_NAMES) {
143                 r = -E2BIG;
144                 goto fail;
145         }
146
147         if ((r = set_put(u->meta.names, s)) < 0) {
148                 if (r == -EEXIST)
149                         r = 0;
150                 goto fail;
151         }
152
153         if ((r = hashmap_put(u->meta.manager->units, s, u)) < 0) {
154                 set_remove(u->meta.names, s);
155                 goto fail;
156         }
157
158         if (u->meta.type == _UNIT_TYPE_INVALID) {
159
160                 u->meta.type = t;
161                 u->meta.id = s;
162                 u->meta.instance = i;
163
164                 LIST_PREPEND(Meta, units_by_type, u->meta.manager->units_by_type[t], &u->meta);
165
166                 if (UNIT_VTABLE(u)->init)
167                         UNIT_VTABLE(u)->init(u);
168         } else
169                 free(i);
170
171         unit_add_to_dbus_queue(u);
172         return 0;
173
174 fail:
175         free(s);
176         free(i);
177
178         return r;
179 }
180
181 int unit_choose_id(Unit *u, const char *name) {
182         char *s, *t = NULL, *i;
183         int r;
184
185         assert(u);
186         assert(name);
187
188         if (unit_name_is_template(name)) {
189
190                 if (!u->meta.instance)
191                         return -EINVAL;
192
193                 if (!(t = unit_name_replace_instance(name, u->meta.instance)))
194                         return -ENOMEM;
195
196                 name = t;
197         }
198
199         /* Selects one of the names of this unit as the id */
200         s = set_get(u->meta.names, (char*) name);
201         free(t);
202
203         if (!s)
204                 return -ENOENT;
205
206         if ((r = unit_name_to_instance(s, &i)) < 0)
207                 return r;
208
209         u->meta.id = s;
210
211         free(u->meta.instance);
212         u->meta.instance = i;
213
214         unit_add_to_dbus_queue(u);
215
216         return 0;
217 }
218
219 int unit_set_description(Unit *u, const char *description) {
220         char *s;
221
222         assert(u);
223
224         if (!(s = strdup(description)))
225                 return -ENOMEM;
226
227         free(u->meta.description);
228         u->meta.description = s;
229
230         unit_add_to_dbus_queue(u);
231         return 0;
232 }
233
234 bool unit_check_gc(Unit *u) {
235         assert(u);
236
237         if (u->meta.load_state == UNIT_STUB)
238                 return true;
239
240         if (UNIT_VTABLE(u)->no_gc)
241                 return true;
242
243         if (u->meta.no_gc)
244                 return true;
245
246         if (u->meta.job)
247                 return true;
248
249         if (unit_active_state(u) != UNIT_INACTIVE)
250                 return true;
251
252         if (UNIT_VTABLE(u)->check_gc)
253                 if (UNIT_VTABLE(u)->check_gc(u))
254                         return true;
255
256         return false;
257 }
258
259 void unit_add_to_load_queue(Unit *u) {
260         assert(u);
261         assert(u->meta.type != _UNIT_TYPE_INVALID);
262
263         if (u->meta.load_state != UNIT_STUB || u->meta.in_load_queue)
264                 return;
265
266         LIST_PREPEND(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
267         u->meta.in_load_queue = true;
268 }
269
270 void unit_add_to_cleanup_queue(Unit *u) {
271         assert(u);
272
273         if (u->meta.in_cleanup_queue)
274                 return;
275
276         LIST_PREPEND(Meta, cleanup_queue, u->meta.manager->cleanup_queue, &u->meta);
277         u->meta.in_cleanup_queue = true;
278 }
279
280 void unit_add_to_gc_queue(Unit *u) {
281         assert(u);
282
283         if (u->meta.in_gc_queue || u->meta.in_cleanup_queue)
284                 return;
285
286         if (unit_check_gc(u))
287                 return;
288
289         LIST_PREPEND(Meta, gc_queue, u->meta.manager->gc_queue, &u->meta);
290         u->meta.in_gc_queue = true;
291
292         u->meta.manager->n_in_gc_queue ++;
293
294         if (u->meta.manager->gc_queue_timestamp <= 0)
295                 u->meta.manager->gc_queue_timestamp = now(CLOCK_MONOTONIC);
296 }
297
298 void unit_add_to_dbus_queue(Unit *u) {
299         assert(u);
300         assert(u->meta.type != _UNIT_TYPE_INVALID);
301
302         if (u->meta.load_state == UNIT_STUB || u->meta.in_dbus_queue)
303                 return;
304
305         /* Shortcut things if nobody cares */
306         if (!bus_has_subscriber(u->meta.manager)) {
307                 u->meta.sent_dbus_new_signal = true;
308                 return;
309         }
310
311         LIST_PREPEND(Meta, dbus_queue, u->meta.manager->dbus_unit_queue, &u->meta);
312         u->meta.in_dbus_queue = true;
313 }
314
315 static void bidi_set_free(Unit *u, Set *s) {
316         Iterator i;
317         Unit *other;
318
319         assert(u);
320
321         /* Frees the set and makes sure we are dropped from the
322          * inverse pointers */
323
324         SET_FOREACH(other, s, i) {
325                 UnitDependency d;
326
327                 for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
328                         set_remove(other->meta.dependencies[d], u);
329
330                 unit_add_to_gc_queue(other);
331         }
332
333         set_free(s);
334 }
335
336 void unit_free(Unit *u) {
337         UnitDependency d;
338         Iterator i;
339         char *t;
340
341         assert(u);
342
343         bus_unit_send_removed_signal(u);
344
345         if (u->meta.load_state != UNIT_STUB)
346                 if (UNIT_VTABLE(u)->done)
347                         UNIT_VTABLE(u)->done(u);
348
349         SET_FOREACH(t, u->meta.names, i)
350                 hashmap_remove_value(u->meta.manager->units, t, u);
351
352         if (u->meta.job)
353                 job_free(u->meta.job);
354
355         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
356                 bidi_set_free(u, u->meta.dependencies[d]);
357
358         if (u->meta.type != _UNIT_TYPE_INVALID)
359                 LIST_REMOVE(Meta, units_by_type, u->meta.manager->units_by_type[u->meta.type], &u->meta);
360
361         if (u->meta.in_load_queue)
362                 LIST_REMOVE(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
363
364         if (u->meta.in_dbus_queue)
365                 LIST_REMOVE(Meta, dbus_queue, u->meta.manager->dbus_unit_queue, &u->meta);
366
367         if (u->meta.in_cleanup_queue)
368                 LIST_REMOVE(Meta, cleanup_queue, u->meta.manager->cleanup_queue, &u->meta);
369
370         if (u->meta.in_gc_queue) {
371                 LIST_REMOVE(Meta, gc_queue, u->meta.manager->gc_queue, &u->meta);
372                 u->meta.manager->n_in_gc_queue--;
373         }
374
375         cgroup_bonding_free_list(u->meta.cgroup_bondings, u->meta.manager->n_reloading <= 0);
376         cgroup_attribute_free_list(u->meta.cgroup_attributes);
377
378         free(u->meta.description);
379         free(u->meta.fragment_path);
380
381         set_free_free(u->meta.names);
382
383         condition_free_list(u->meta.conditions);
384
385         free(u->meta.instance);
386         free(u);
387 }
388
389 UnitActiveState unit_active_state(Unit *u) {
390         assert(u);
391
392         if (u->meta.load_state == UNIT_MERGED)
393                 return unit_active_state(unit_follow_merge(u));
394
395         /* After a reload it might happen that a unit is not correctly
396          * loaded but still has a process around. That's why we won't
397          * shortcut failed loading to UNIT_INACTIVE_FAILED. */
398
399         return UNIT_VTABLE(u)->active_state(u);
400 }
401
402 const char* unit_sub_state_to_string(Unit *u) {
403         assert(u);
404
405         return UNIT_VTABLE(u)->sub_state_to_string(u);
406 }
407
408 static void complete_move(Set **s, Set **other) {
409         assert(s);
410         assert(other);
411
412         if (!*other)
413                 return;
414
415         if (*s)
416                 set_move(*s, *other);
417         else {
418                 *s = *other;
419                 *other = NULL;
420         }
421 }
422
423 static void merge_names(Unit *u, Unit *other) {
424         char *t;
425         Iterator i;
426
427         assert(u);
428         assert(other);
429
430         complete_move(&u->meta.names, &other->meta.names);
431
432         set_free_free(other->meta.names);
433         other->meta.names = NULL;
434         other->meta.id = NULL;
435
436         SET_FOREACH(t, u->meta.names, i)
437                 assert_se(hashmap_replace(u->meta.manager->units, t, u) == 0);
438 }
439
440 static void merge_dependencies(Unit *u, Unit *other, UnitDependency d) {
441         Iterator i;
442         Unit *back;
443         int r;
444
445         assert(u);
446         assert(other);
447         assert(d < _UNIT_DEPENDENCY_MAX);
448
449         /* Fix backwards pointers */
450         SET_FOREACH(back, other->meta.dependencies[d], i) {
451                 UnitDependency k;
452
453                 for (k = 0; k < _UNIT_DEPENDENCY_MAX; k++)
454                         if ((r = set_remove_and_put(back->meta.dependencies[k], other, u)) < 0) {
455
456                                 if (r == -EEXIST)
457                                         set_remove(back->meta.dependencies[k], other);
458                                 else
459                                         assert(r == -ENOENT);
460                         }
461         }
462
463         complete_move(&u->meta.dependencies[d], &other->meta.dependencies[d]);
464
465         set_free(other->meta.dependencies[d]);
466         other->meta.dependencies[d] = NULL;
467 }
468
469 int unit_merge(Unit *u, Unit *other) {
470         UnitDependency d;
471
472         assert(u);
473         assert(other);
474         assert(u->meta.manager == other->meta.manager);
475         assert(u->meta.type != _UNIT_TYPE_INVALID);
476
477         other = unit_follow_merge(other);
478
479         if (other == u)
480                 return 0;
481
482         if (u->meta.type != other->meta.type)
483                 return -EINVAL;
484
485         if (!u->meta.instance != !other->meta.instance)
486                 return -EINVAL;
487
488         if (other->meta.load_state != UNIT_STUB &&
489             other->meta.load_state != UNIT_ERROR)
490                 return -EEXIST;
491
492         if (other->meta.job)
493                 return -EEXIST;
494
495         if (!UNIT_IS_INACTIVE_OR_FAILED(unit_active_state(other)))
496                 return -EEXIST;
497
498         /* Merge names */
499         merge_names(u, other);
500
501         /* Merge dependencies */
502         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
503                 merge_dependencies(u, other, d);
504
505         other->meta.load_state = UNIT_MERGED;
506         other->meta.merged_into = u;
507
508         /* If there is still some data attached to the other node, we
509          * don't need it anymore, and can free it. */
510         if (other->meta.load_state != UNIT_STUB)
511                 if (UNIT_VTABLE(other)->done)
512                         UNIT_VTABLE(other)->done(other);
513
514         unit_add_to_dbus_queue(u);
515         unit_add_to_cleanup_queue(other);
516
517         return 0;
518 }
519
520 int unit_merge_by_name(Unit *u, const char *name) {
521         Unit *other;
522         int r;
523         char *s = NULL;
524
525         assert(u);
526         assert(name);
527
528         if (unit_name_is_template(name)) {
529                 if (!u->meta.instance)
530                         return -EINVAL;
531
532                 if (!(s = unit_name_replace_instance(name, u->meta.instance)))
533                         return -ENOMEM;
534
535                 name = s;
536         }
537
538         if (!(other = manager_get_unit(u->meta.manager, name)))
539                 r = unit_add_name(u, name);
540         else
541                 r = unit_merge(u, other);
542
543         free(s);
544         return r;
545 }
546
547 Unit* unit_follow_merge(Unit *u) {
548         assert(u);
549
550         while (u->meta.load_state == UNIT_MERGED)
551                 assert_se(u = u->meta.merged_into);
552
553         return u;
554 }
555
556 int unit_add_exec_dependencies(Unit *u, ExecContext *c) {
557         int r;
558
559         assert(u);
560         assert(c);
561
562         if (c->std_output != EXEC_OUTPUT_KMSG &&
563             c->std_output != EXEC_OUTPUT_SYSLOG &&
564             c->std_output != EXEC_OUTPUT_KMSG_AND_CONSOLE &&
565             c->std_output != EXEC_OUTPUT_SYSLOG_AND_CONSOLE &&
566             c->std_error != EXEC_OUTPUT_KMSG &&
567             c->std_error != EXEC_OUTPUT_SYSLOG_AND_CONSOLE &&
568             c->std_error != EXEC_OUTPUT_KMSG &&
569             c->std_error != EXEC_OUTPUT_SYSLOG_AND_CONSOLE)
570                 return 0;
571
572         /* If syslog or kernel logging is requested, make sure our own
573          * logging daemon is run first. */
574
575         if (u->meta.manager->running_as == MANAGER_SYSTEM)
576                 if ((r = unit_add_two_dependencies_by_name(u, UNIT_REQUIRES, UNIT_AFTER, SPECIAL_STDOUT_SYSLOG_BRIDGE_SOCKET, NULL, true)) < 0)
577                         return r;
578
579         return 0;
580 }
581
582 const char *unit_description(Unit *u) {
583         assert(u);
584
585         if (u->meta.description)
586                 return u->meta.description;
587
588         return strna(u->meta.id);
589 }
590
591 void unit_dump(Unit *u, FILE *f, const char *prefix) {
592         char *t;
593         UnitDependency d;
594         Iterator i;
595         char *p2;
596         const char *prefix2;
597         char
598                 timestamp1[FORMAT_TIMESTAMP_MAX],
599                 timestamp2[FORMAT_TIMESTAMP_MAX],
600                 timestamp3[FORMAT_TIMESTAMP_MAX],
601                 timestamp4[FORMAT_TIMESTAMP_MAX],
602                 timespan[FORMAT_TIMESPAN_MAX];
603         Unit *following;
604
605         assert(u);
606         assert(u->meta.type >= 0);
607
608         if (!prefix)
609                 prefix = "";
610         p2 = strappend(prefix, "\t");
611         prefix2 = p2 ? p2 : prefix;
612
613         fprintf(f,
614                 "%s-> Unit %s:\n"
615                 "%s\tDescription: %s\n"
616                 "%s\tInstance: %s\n"
617                 "%s\tUnit Load State: %s\n"
618                 "%s\tUnit Active State: %s\n"
619                 "%s\tInactive Exit Timestamp: %s\n"
620                 "%s\tActive Enter Timestamp: %s\n"
621                 "%s\tActive Exit Timestamp: %s\n"
622                 "%s\tInactive Enter Timestamp: %s\n"
623                 "%s\tGC Check Good: %s\n"
624                 "%s\tNeed Daemon Reload: %s\n",
625                 prefix, u->meta.id,
626                 prefix, unit_description(u),
627                 prefix, strna(u->meta.instance),
628                 prefix, unit_load_state_to_string(u->meta.load_state),
629                 prefix, unit_active_state_to_string(unit_active_state(u)),
630                 prefix, strna(format_timestamp(timestamp1, sizeof(timestamp1), u->meta.inactive_exit_timestamp.realtime)),
631                 prefix, strna(format_timestamp(timestamp2, sizeof(timestamp2), u->meta.active_enter_timestamp.realtime)),
632                 prefix, strna(format_timestamp(timestamp3, sizeof(timestamp3), u->meta.active_exit_timestamp.realtime)),
633                 prefix, strna(format_timestamp(timestamp4, sizeof(timestamp4), u->meta.inactive_enter_timestamp.realtime)),
634                 prefix, yes_no(unit_check_gc(u)),
635                 prefix, yes_no(unit_need_daemon_reload(u)));
636
637         SET_FOREACH(t, u->meta.names, i)
638                 fprintf(f, "%s\tName: %s\n", prefix, t);
639
640         if ((following = unit_following(u)))
641                 fprintf(f, "%s\tFollowing: %s\n", prefix, following->meta.id);
642
643         if (u->meta.fragment_path)
644                 fprintf(f, "%s\tFragment Path: %s\n", prefix, u->meta.fragment_path);
645
646         if (u->meta.job_timeout > 0)
647                 fprintf(f, "%s\tJob Timeout: %s\n", prefix, format_timespan(timespan, sizeof(timespan), u->meta.job_timeout));
648
649         condition_dump_list(u->meta.conditions, f, prefix);
650
651         if (dual_timestamp_is_set(&u->meta.condition_timestamp))
652                 fprintf(f,
653                         "%s\tCondition Timestamp: %s\n"
654                         "%s\tCondition Result: %s\n",
655                         prefix, strna(format_timestamp(timestamp1, sizeof(timestamp1), u->meta.condition_timestamp.realtime)),
656                         prefix, yes_no(u->meta.condition_result));
657
658         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++) {
659                 Unit *other;
660
661                 SET_FOREACH(other, u->meta.dependencies[d], i)
662                         fprintf(f, "%s\t%s: %s\n", prefix, unit_dependency_to_string(d), other->meta.id);
663         }
664
665         if (u->meta.load_state == UNIT_LOADED) {
666                 CGroupBonding *b;
667                 CGroupAttribute *a;
668
669                 fprintf(f,
670                         "%s\tStopWhenUnneeded: %s\n"
671                         "%s\tRefuseManualStart: %s\n"
672                         "%s\tRefuseManualStop: %s\n"
673                         "%s\tDefaultDependencies: %s\n"
674                         "%s\tOnFailureIsolate: %s\n"
675                         "%s\tIgnoreOnIsolate: %s\n"
676                         "%s\tIgnoreOnSnapshot: %s\n",
677                         prefix, yes_no(u->meta.stop_when_unneeded),
678                         prefix, yes_no(u->meta.refuse_manual_start),
679                         prefix, yes_no(u->meta.refuse_manual_stop),
680                         prefix, yes_no(u->meta.default_dependencies),
681                         prefix, yes_no(u->meta.on_failure_isolate),
682                         prefix, yes_no(u->meta.ignore_on_isolate),
683                         prefix, yes_no(u->meta.ignore_on_snapshot));
684
685                 LIST_FOREACH(by_unit, b, u->meta.cgroup_bondings)
686                         fprintf(f, "%s\tControlGroup: %s:%s\n",
687                                 prefix, b->controller, b->path);
688
689                 LIST_FOREACH(by_unit, a, u->meta.cgroup_attributes) {
690                         char *v = NULL;
691
692                         if (a->map_callback)
693                                 a->map_callback(a->controller, a->name, a->value, &v);
694
695                         fprintf(f, "%s\tControlGroupAttribute: %s %s \"%s\"\n",
696                                 prefix, a->controller, a->name, v ? v : a->value);
697
698                         free(v);
699                 }
700
701                 if (UNIT_VTABLE(u)->dump)
702                         UNIT_VTABLE(u)->dump(u, f, prefix2);
703
704         } else if (u->meta.load_state == UNIT_MERGED)
705                 fprintf(f,
706                         "%s\tMerged into: %s\n",
707                         prefix, u->meta.merged_into->meta.id);
708         else if (u->meta.load_state == UNIT_ERROR)
709                 fprintf(f, "%s\tLoad Error Code: %s\n", prefix, strerror(-u->meta.load_error));
710
711
712         if (u->meta.job)
713                 job_dump(u->meta.job, f, prefix2);
714
715         free(p2);
716 }
717
718 /* Common implementation for multiple backends */
719 int unit_load_fragment_and_dropin(Unit *u) {
720         int r;
721
722         assert(u);
723
724         /* Load a .service file */
725         if ((r = unit_load_fragment(u)) < 0)
726                 return r;
727
728         if (u->meta.load_state == UNIT_STUB)
729                 return -ENOENT;
730
731         /* Load drop-in directory data */
732         if ((r = unit_load_dropin(unit_follow_merge(u))) < 0)
733                 return r;
734
735         return 0;
736 }
737
738 /* Common implementation for multiple backends */
739 int unit_load_fragment_and_dropin_optional(Unit *u) {
740         int r;
741
742         assert(u);
743
744         /* Same as unit_load_fragment_and_dropin(), but whether
745          * something can be loaded or not doesn't matter. */
746
747         /* Load a .service file */
748         if ((r = unit_load_fragment(u)) < 0)
749                 return r;
750
751         if (u->meta.load_state == UNIT_STUB)
752                 u->meta.load_state = UNIT_LOADED;
753
754         /* Load drop-in directory data */
755         if ((r = unit_load_dropin(unit_follow_merge(u))) < 0)
756                 return r;
757
758         return 0;
759 }
760
761 int unit_add_default_target_dependency(Unit *u, Unit *target) {
762         assert(u);
763         assert(target);
764
765         if (target->meta.type != UNIT_TARGET)
766                 return 0;
767
768         /* Only add the dependency if both units are loaded, so that
769          * that loop check below is reliable */
770         if (u->meta.load_state != UNIT_LOADED ||
771             target->meta.load_state != UNIT_LOADED)
772                 return 0;
773
774         /* If either side wants no automatic dependencies, then let's
775          * skip this */
776         if (!u->meta.default_dependencies ||
777             target->meta.default_dependencies)
778                 return 0;
779
780         /* Don't create loops */
781         if (set_get(target->meta.dependencies[UNIT_BEFORE], u))
782                 return 0;
783
784         return unit_add_dependency(target, UNIT_AFTER, u, true);
785 }
786
787 static int unit_add_default_dependencies(Unit *u) {
788         static const UnitDependency deps[] = {
789                 UNIT_REQUIRED_BY,
790                 UNIT_REQUIRED_BY_OVERRIDABLE,
791                 UNIT_WANTED_BY,
792                 UNIT_BOUND_BY
793         };
794
795         Unit *target;
796         Iterator i;
797         int r;
798         unsigned k;
799
800         assert(u);
801
802         for (k = 0; k < ELEMENTSOF(deps); k++)
803                 SET_FOREACH(target, u->meta.dependencies[deps[k]], i)
804                         if ((r = unit_add_default_target_dependency(u, target)) < 0)
805                                 return r;
806
807         return 0;
808 }
809
810 int unit_load(Unit *u) {
811         int r;
812
813         assert(u);
814
815         if (u->meta.in_load_queue) {
816                 LIST_REMOVE(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
817                 u->meta.in_load_queue = false;
818         }
819
820         if (u->meta.type == _UNIT_TYPE_INVALID)
821                 return -EINVAL;
822
823         if (u->meta.load_state != UNIT_STUB)
824                 return 0;
825
826         if (UNIT_VTABLE(u)->load)
827                 if ((r = UNIT_VTABLE(u)->load(u)) < 0)
828                         goto fail;
829
830         if (u->meta.load_state == UNIT_STUB) {
831                 r = -ENOENT;
832                 goto fail;
833         }
834
835         if (u->meta.load_state == UNIT_LOADED &&
836             u->meta.default_dependencies)
837                 if ((r = unit_add_default_dependencies(u)) < 0)
838                         goto fail;
839
840         if (u->meta.on_failure_isolate &&
841             set_size(u->meta.dependencies[UNIT_ON_FAILURE]) > 1) {
842
843                 log_error("More than one OnFailure= dependencies specified for %s but OnFailureIsolate= enabled. Refusing.",
844                           u->meta.id);
845
846                 r = -EINVAL;
847                 goto fail;
848         }
849
850         assert((u->meta.load_state != UNIT_MERGED) == !u->meta.merged_into);
851
852         unit_add_to_dbus_queue(unit_follow_merge(u));
853         unit_add_to_gc_queue(u);
854
855         return 0;
856
857 fail:
858         u->meta.load_state = UNIT_ERROR;
859         u->meta.load_error = r;
860         unit_add_to_dbus_queue(u);
861
862         log_debug("Failed to load configuration for %s: %s", u->meta.id, strerror(-r));
863
864         return r;
865 }
866
867 bool unit_condition_test(Unit *u) {
868         assert(u);
869
870         dual_timestamp_get(&u->meta.condition_timestamp);
871         u->meta.condition_result = condition_test_list(u->meta.conditions);
872
873         return u->meta.condition_result;
874 }
875
876 /* Errors:
877  *         -EBADR:     This unit type does not support starting.
878  *         -EALREADY:  Unit is already started.
879  *         -EAGAIN:    An operation is already in progress. Retry later.
880  *         -ECANCELED: Too many requests for now.
881  */
882 int unit_start(Unit *u) {
883         UnitActiveState state;
884         Unit *following;
885
886         assert(u);
887
888         if (u->meta.load_state != UNIT_LOADED)
889                 return -EINVAL;
890
891         /* If this is already (being) started, then this will
892          * succeed. Note that this will even succeed if this unit is
893          * not startable by the user. This is relied on to detect when
894          * we need to wait for units and when waiting is finished. */
895         state = unit_active_state(u);
896         if (UNIT_IS_ACTIVE_OR_RELOADING(state))
897                 return -EALREADY;
898
899         /* If the conditions failed, don't do anything at all */
900         if (!unit_condition_test(u)) {
901                 log_debug("Starting of %s requested but condition failed. Ignoring.", u->meta.id);
902                 return -EALREADY;
903         }
904
905         /* Forward to the main object, if we aren't it. */
906         if ((following = unit_following(u))) {
907                 log_debug("Redirecting start request from %s to %s.", u->meta.id, following->meta.id);
908                 return unit_start(following);
909         }
910
911         /* If it is stopped, but we cannot start it, then fail */
912         if (!UNIT_VTABLE(u)->start)
913                 return -EBADR;
914
915         /* We don't suppress calls to ->start() here when we are
916          * already starting, to allow this request to be used as a
917          * "hurry up" call, for example when the unit is in some "auto
918          * restart" state where it waits for a holdoff timer to elapse
919          * before it will start again. */
920
921         unit_add_to_dbus_queue(u);
922
923         unit_status_printf(u, "Starting %s...\n", unit_description(u));
924         return UNIT_VTABLE(u)->start(u);
925 }
926
927 bool unit_can_start(Unit *u) {
928         assert(u);
929
930         return !!UNIT_VTABLE(u)->start;
931 }
932
933 bool unit_can_isolate(Unit *u) {
934         assert(u);
935
936         return unit_can_start(u) &&
937                 u->meta.allow_isolate;
938 }
939
940 /* Errors:
941  *         -EBADR:    This unit type does not support stopping.
942  *         -EALREADY: Unit is already stopped.
943  *         -EAGAIN:   An operation is already in progress. Retry later.
944  */
945 int unit_stop(Unit *u) {
946         UnitActiveState state;
947         Unit *following;
948
949         assert(u);
950
951         state = unit_active_state(u);
952         if (UNIT_IS_INACTIVE_OR_FAILED(state))
953                 return -EALREADY;
954
955         if ((following = unit_following(u))) {
956                 log_debug("Redirecting stop request from %s to %s.", u->meta.id, following->meta.id);
957                 return unit_stop(following);
958         }
959
960         if (!UNIT_VTABLE(u)->stop)
961                 return -EBADR;
962
963         unit_add_to_dbus_queue(u);
964
965         unit_status_printf(u, "Stopping %s...\n", unit_description(u));
966         return UNIT_VTABLE(u)->stop(u);
967 }
968
969 /* Errors:
970  *         -EBADR:    This unit type does not support reloading.
971  *         -ENOEXEC:  Unit is not started.
972  *         -EAGAIN:   An operation is already in progress. Retry later.
973  */
974 int unit_reload(Unit *u) {
975         UnitActiveState state;
976         Unit *following;
977
978         assert(u);
979
980         if (u->meta.load_state != UNIT_LOADED)
981                 return -EINVAL;
982
983         if (!unit_can_reload(u))
984                 return -EBADR;
985
986         state = unit_active_state(u);
987         if (state == UNIT_RELOADING)
988                 return -EALREADY;
989
990         if (state != UNIT_ACTIVE)
991                 return -ENOEXEC;
992
993         if ((following = unit_following(u))) {
994                 log_debug("Redirecting reload request from %s to %s.", u->meta.id, following->meta.id);
995                 return unit_reload(following);
996         }
997
998         unit_add_to_dbus_queue(u);
999         return UNIT_VTABLE(u)->reload(u);
1000 }
1001
1002 bool unit_can_reload(Unit *u) {
1003         assert(u);
1004
1005         if (!UNIT_VTABLE(u)->reload)
1006                 return false;
1007
1008         if (!UNIT_VTABLE(u)->can_reload)
1009                 return true;
1010
1011         return UNIT_VTABLE(u)->can_reload(u);
1012 }
1013
1014 static void unit_check_unneeded(Unit *u) {
1015         Iterator i;
1016         Unit *other;
1017
1018         assert(u);
1019
1020         /* If this service shall be shut down when unneeded then do
1021          * so. */
1022
1023         if (!u->meta.stop_when_unneeded)
1024                 return;
1025
1026         if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)))
1027                 return;
1028
1029         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY], i)
1030                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1031                         return;
1032
1033         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY_OVERRIDABLE], i)
1034                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1035                         return;
1036
1037         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTED_BY], i)
1038                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1039                         return;
1040
1041         SET_FOREACH(other, u->meta.dependencies[UNIT_BOUND_BY], i)
1042                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1043                         return;
1044
1045         log_info("Service %s is not needed anymore. Stopping.", u->meta.id);
1046
1047         /* Ok, nobody needs us anymore. Sniff. Then let's commit suicide */
1048         manager_add_job(u->meta.manager, JOB_STOP, u, JOB_FAIL, true, NULL, NULL);
1049 }
1050
1051 static void retroactively_start_dependencies(Unit *u) {
1052         Iterator i;
1053         Unit *other;
1054
1055         assert(u);
1056         assert(UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)));
1057
1058         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES], i)
1059                 if (!set_get(u->meta.dependencies[UNIT_AFTER], other) &&
1060                     !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
1061                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL, NULL);
1062
1063         SET_FOREACH(other, u->meta.dependencies[UNIT_BIND_TO], i)
1064                 if (!set_get(u->meta.dependencies[UNIT_AFTER], other) &&
1065                     !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
1066                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL, NULL);
1067
1068         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES_OVERRIDABLE], i)
1069                 if (!set_get(u->meta.dependencies[UNIT_AFTER], other) &&
1070                     !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
1071                         manager_add_job(u->meta.manager, JOB_START, other, JOB_FAIL, false, NULL, NULL);
1072
1073         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE], i)
1074                 if (!set_get(u->meta.dependencies[UNIT_AFTER], other) &&
1075                     !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
1076                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL, NULL);
1077
1078         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTS], i)
1079                 if (!set_get(u->meta.dependencies[UNIT_AFTER], other) &&
1080                     !UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
1081                         manager_add_job(u->meta.manager, JOB_START, other, JOB_FAIL, false, NULL, NULL);
1082
1083         SET_FOREACH(other, u->meta.dependencies[UNIT_CONFLICTS], i)
1084                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1085                         manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL, NULL);
1086
1087         SET_FOREACH(other, u->meta.dependencies[UNIT_CONFLICTED_BY], i)
1088                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1089                         manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL, NULL);
1090 }
1091
1092 static void retroactively_stop_dependencies(Unit *u) {
1093         Iterator i;
1094         Unit *other;
1095
1096         assert(u);
1097         assert(UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u)));
1098
1099         /* Pull down units which are bound to us recursively if enabled */
1100         SET_FOREACH(other, u->meta.dependencies[UNIT_BOUND_BY], i)
1101                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1102                         manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL, NULL);
1103
1104         /* Garbage collect services that might not be needed anymore, if enabled */
1105         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES], i)
1106                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1107                         unit_check_unneeded(other);
1108         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES_OVERRIDABLE], i)
1109                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1110                         unit_check_unneeded(other);
1111         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTS], i)
1112                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1113                         unit_check_unneeded(other);
1114         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE], i)
1115                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1116                         unit_check_unneeded(other);
1117         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE_OVERRIDABLE], i)
1118                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1119                         unit_check_unneeded(other);
1120         SET_FOREACH(other, u->meta.dependencies[UNIT_BIND_TO], i)
1121                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
1122                         unit_check_unneeded(other);
1123 }
1124
1125 void unit_trigger_on_failure(Unit *u) {
1126         Unit *other;
1127         Iterator i;
1128
1129         assert(u);
1130
1131         if (set_size(u->meta.dependencies[UNIT_ON_FAILURE]) <= 0)
1132                 return;
1133
1134         log_info("Triggering OnFailure= dependencies of %s.", u->meta.id);
1135
1136         SET_FOREACH(other, u->meta.dependencies[UNIT_ON_FAILURE], i) {
1137                 int r;
1138
1139                 if ((r = manager_add_job(u->meta.manager, JOB_START, other, u->meta.on_failure_isolate ? JOB_ISOLATE : JOB_REPLACE, true, NULL, NULL)) < 0)
1140                         log_error("Failed to enqueue OnFailure= job: %s", strerror(-r));
1141         }
1142 }
1143
1144 void unit_notify(Unit *u, UnitActiveState os, UnitActiveState ns, bool reload_success) {
1145         bool unexpected;
1146
1147         assert(u);
1148         assert(os < _UNIT_ACTIVE_STATE_MAX);
1149         assert(ns < _UNIT_ACTIVE_STATE_MAX);
1150
1151         /* Note that this is called for all low-level state changes,
1152          * even if they might map to the same high-level
1153          * UnitActiveState! That means that ns == os is OK an expected
1154          * behaviour here. For example: if a mount point is remounted
1155          * this function will be called too! */
1156
1157         if (u->meta.manager->n_reloading <= 0) {
1158                 dual_timestamp ts;
1159
1160                 dual_timestamp_get(&ts);
1161
1162                 if (UNIT_IS_INACTIVE_OR_FAILED(os) && !UNIT_IS_INACTIVE_OR_FAILED(ns))
1163                         u->meta.inactive_exit_timestamp = ts;
1164                 else if (!UNIT_IS_INACTIVE_OR_FAILED(os) && UNIT_IS_INACTIVE_OR_FAILED(ns))
1165                         u->meta.inactive_enter_timestamp = ts;
1166
1167                 if (!UNIT_IS_ACTIVE_OR_RELOADING(os) && UNIT_IS_ACTIVE_OR_RELOADING(ns))
1168                         u->meta.active_enter_timestamp = ts;
1169                 else if (UNIT_IS_ACTIVE_OR_RELOADING(os) && !UNIT_IS_ACTIVE_OR_RELOADING(ns))
1170                         u->meta.active_exit_timestamp = ts;
1171
1172                 timer_unit_notify(u, ns);
1173                 path_unit_notify(u, ns);
1174         }
1175
1176         if (UNIT_IS_INACTIVE_OR_FAILED(ns))
1177                 cgroup_bonding_trim_list(u->meta.cgroup_bondings, true);
1178
1179         if (u->meta.job) {
1180                 unexpected = false;
1181
1182                 if (u->meta.job->state == JOB_WAITING)
1183
1184                         /* So we reached a different state for this
1185                          * job. Let's see if we can run it now if it
1186                          * failed previously due to EAGAIN. */
1187                         job_add_to_run_queue(u->meta.job);
1188
1189                 /* Let's check whether this state change constitutes a
1190                  * finished job, or maybe contradicts a running job and
1191                  * hence needs to invalidate jobs. */
1192
1193                 switch (u->meta.job->type) {
1194
1195                 case JOB_START:
1196                 case JOB_VERIFY_ACTIVE:
1197
1198                         if (UNIT_IS_ACTIVE_OR_RELOADING(ns))
1199                                 job_finish_and_invalidate(u->meta.job, JOB_DONE);
1200                         else if (u->meta.job->state == JOB_RUNNING && ns != UNIT_ACTIVATING) {
1201                                 unexpected = true;
1202
1203                                 if (UNIT_IS_INACTIVE_OR_FAILED(ns))
1204                                         job_finish_and_invalidate(u->meta.job, ns == UNIT_FAILED ? JOB_FAILED : JOB_DONE);
1205                         }
1206
1207                         break;
1208
1209                 case JOB_RELOAD:
1210                 case JOB_RELOAD_OR_START:
1211
1212                         if (u->meta.job->state == JOB_RUNNING) {
1213                                 if (ns == UNIT_ACTIVE)
1214                                         job_finish_and_invalidate(u->meta.job, reload_success ? JOB_DONE : JOB_FAILED);
1215                                 else if (ns != UNIT_ACTIVATING && ns != UNIT_RELOADING) {
1216                                         unexpected = true;
1217
1218                                         if (UNIT_IS_INACTIVE_OR_FAILED(ns))
1219                                                 job_finish_and_invalidate(u->meta.job, ns == UNIT_FAILED ? JOB_FAILED : JOB_DONE);
1220                                 }
1221                         }
1222
1223                         break;
1224
1225                 case JOB_STOP:
1226                 case JOB_RESTART:
1227                 case JOB_TRY_RESTART:
1228
1229                         if (UNIT_IS_INACTIVE_OR_FAILED(ns))
1230                                 job_finish_and_invalidate(u->meta.job, JOB_DONE);
1231                         else if (u->meta.job->state == JOB_RUNNING && ns != UNIT_DEACTIVATING) {
1232                                 unexpected = true;
1233                                 job_finish_and_invalidate(u->meta.job, JOB_FAILED);
1234                         }
1235
1236                         break;
1237
1238                 default:
1239                         assert_not_reached("Job type unknown");
1240                 }
1241
1242         } else
1243                 unexpected = true;
1244
1245         if (u->meta.manager->n_reloading <= 0) {
1246
1247                 /* If this state change happened without being
1248                  * requested by a job, then let's retroactively start
1249                  * or stop dependencies. We skip that step when
1250                  * deserializing, since we don't want to create any
1251                  * additional jobs just because something is already
1252                  * activated. */
1253
1254                 if (unexpected) {
1255                         if (UNIT_IS_INACTIVE_OR_FAILED(os) && UNIT_IS_ACTIVE_OR_ACTIVATING(ns))
1256                                 retroactively_start_dependencies(u);
1257                         else if (UNIT_IS_ACTIVE_OR_ACTIVATING(os) && UNIT_IS_INACTIVE_OR_DEACTIVATING(ns))
1258                                 retroactively_stop_dependencies(u);
1259                 }
1260
1261                 if (ns != os && ns == UNIT_FAILED) {
1262                         log_notice("Unit %s entered failed state.", u->meta.id);
1263                         unit_trigger_on_failure(u);
1264                 }
1265         }
1266
1267         /* Some names are special */
1268         if (UNIT_IS_ACTIVE_OR_RELOADING(ns)) {
1269
1270                 if (unit_has_name(u, SPECIAL_DBUS_SERVICE))
1271                         /* The bus just might have become available,
1272                          * hence try to connect to it, if we aren't
1273                          * yet connected. */
1274                         bus_init(u->meta.manager, true);
1275
1276                 if (u->meta.type == UNIT_SERVICE &&
1277                     !UNIT_IS_ACTIVE_OR_RELOADING(os) &&
1278                     u->meta.manager->n_reloading <= 0) {
1279                         /* Write audit record if we have just finished starting up */
1280                         manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_START, true);
1281                         u->meta.in_audit = true;
1282                 }
1283
1284                 if (!UNIT_IS_ACTIVE_OR_RELOADING(os))
1285                         manager_send_unit_plymouth(u->meta.manager, u);
1286
1287         } else {
1288
1289                 /* We don't care about D-Bus here, since we'll get an
1290                  * asynchronous notification for it anyway. */
1291
1292                 if (u->meta.type == UNIT_SERVICE &&
1293                     UNIT_IS_INACTIVE_OR_FAILED(ns) &&
1294                     !UNIT_IS_INACTIVE_OR_FAILED(os) &&
1295                     u->meta.manager->n_reloading <= 0) {
1296
1297                         /* Hmm, if there was no start record written
1298                          * write it now, so that we always have a nice
1299                          * pair */
1300                         if (!u->meta.in_audit) {
1301                                 manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_START, ns == UNIT_INACTIVE);
1302
1303                                 if (ns == UNIT_INACTIVE)
1304                                         manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_STOP, true);
1305                         } else
1306                                 /* Write audit record if we have just finished shutting down */
1307                                 manager_send_unit_audit(u->meta.manager, u, AUDIT_SERVICE_STOP, ns == UNIT_INACTIVE);
1308
1309                         u->meta.in_audit = false;
1310                 }
1311         }
1312
1313         manager_recheck_syslog(u->meta.manager);
1314
1315         /* Maybe we finished startup and are now ready for being
1316          * stopped because unneeded? */
1317         unit_check_unneeded(u);
1318
1319         unit_add_to_dbus_queue(u);
1320         unit_add_to_gc_queue(u);
1321 }
1322
1323 int unit_watch_fd(Unit *u, int fd, uint32_t events, Watch *w) {
1324         struct epoll_event ev;
1325
1326         assert(u);
1327         assert(fd >= 0);
1328         assert(w);
1329         assert(w->type == WATCH_INVALID || (w->type == WATCH_FD && w->fd == fd && w->data.unit == u));
1330
1331         zero(ev);
1332         ev.data.ptr = w;
1333         ev.events = events;
1334
1335         if (epoll_ctl(u->meta.manager->epoll_fd,
1336                       w->type == WATCH_INVALID ? EPOLL_CTL_ADD : EPOLL_CTL_MOD,
1337                       fd,
1338                       &ev) < 0)
1339                 return -errno;
1340
1341         w->fd = fd;
1342         w->type = WATCH_FD;
1343         w->data.unit = u;
1344
1345         return 0;
1346 }
1347
1348 void unit_unwatch_fd(Unit *u, Watch *w) {
1349         assert(u);
1350         assert(w);
1351
1352         if (w->type == WATCH_INVALID)
1353                 return;
1354
1355         assert(w->type == WATCH_FD);
1356         assert(w->data.unit == u);
1357         assert_se(epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_DEL, w->fd, NULL) >= 0);
1358
1359         w->fd = -1;
1360         w->type = WATCH_INVALID;
1361         w->data.unit = NULL;
1362 }
1363
1364 int unit_watch_pid(Unit *u, pid_t pid) {
1365         assert(u);
1366         assert(pid >= 1);
1367
1368         /* Watch a specific PID. We only support one unit watching
1369          * each PID for now. */
1370
1371         return hashmap_put(u->meta.manager->watch_pids, LONG_TO_PTR(pid), u);
1372 }
1373
1374 void unit_unwatch_pid(Unit *u, pid_t pid) {
1375         assert(u);
1376         assert(pid >= 1);
1377
1378         hashmap_remove_value(u->meta.manager->watch_pids, LONG_TO_PTR(pid), u);
1379 }
1380
1381 int unit_watch_timer(Unit *u, usec_t delay, Watch *w) {
1382         struct itimerspec its;
1383         int flags, fd;
1384         bool ours;
1385
1386         assert(u);
1387         assert(w);
1388         assert(w->type == WATCH_INVALID || (w->type == WATCH_UNIT_TIMER && w->data.unit == u));
1389
1390         /* This will try to reuse the old timer if there is one */
1391
1392         if (w->type == WATCH_UNIT_TIMER) {
1393                 assert(w->data.unit == u);
1394                 assert(w->fd >= 0);
1395
1396                 ours = false;
1397                 fd = w->fd;
1398         } else if (w->type == WATCH_INVALID) {
1399
1400                 ours = true;
1401                 if ((fd = timerfd_create(CLOCK_MONOTONIC, TFD_NONBLOCK|TFD_CLOEXEC)) < 0)
1402                         return -errno;
1403         } else
1404                 assert_not_reached("Invalid watch type");
1405
1406         zero(its);
1407
1408         if (delay <= 0) {
1409                 /* Set absolute time in the past, but not 0, since we
1410                  * don't want to disarm the timer */
1411                 its.it_value.tv_sec = 0;
1412                 its.it_value.tv_nsec = 1;
1413
1414                 flags = TFD_TIMER_ABSTIME;
1415         } else {
1416                 timespec_store(&its.it_value, delay);
1417                 flags = 0;
1418         }
1419
1420         /* This will also flush the elapse counter */
1421         if (timerfd_settime(fd, flags, &its, NULL) < 0)
1422                 goto fail;
1423
1424         if (w->type == WATCH_INVALID) {
1425                 struct epoll_event ev;
1426
1427                 zero(ev);
1428                 ev.data.ptr = w;
1429                 ev.events = EPOLLIN;
1430
1431                 if (epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_ADD, fd, &ev) < 0)
1432                         goto fail;
1433         }
1434
1435         w->type = WATCH_UNIT_TIMER;
1436         w->fd = fd;
1437         w->data.unit = u;
1438
1439         return 0;
1440
1441 fail:
1442         if (ours)
1443                 close_nointr_nofail(fd);
1444
1445         return -errno;
1446 }
1447
1448 void unit_unwatch_timer(Unit *u, Watch *w) {
1449         assert(u);
1450         assert(w);
1451
1452         if (w->type == WATCH_INVALID)
1453                 return;
1454
1455         assert(w->type == WATCH_UNIT_TIMER);
1456         assert(w->data.unit == u);
1457         assert(w->fd >= 0);
1458
1459         assert_se(epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_DEL, w->fd, NULL) >= 0);
1460         close_nointr_nofail(w->fd);
1461
1462         w->fd = -1;
1463         w->type = WATCH_INVALID;
1464         w->data.unit = NULL;
1465 }
1466
1467 bool unit_job_is_applicable(Unit *u, JobType j) {
1468         assert(u);
1469         assert(j >= 0 && j < _JOB_TYPE_MAX);
1470
1471         switch (j) {
1472
1473         case JOB_VERIFY_ACTIVE:
1474         case JOB_START:
1475         case JOB_STOP:
1476                 return true;
1477
1478         case JOB_RESTART:
1479         case JOB_TRY_RESTART:
1480                 return unit_can_start(u);
1481
1482         case JOB_RELOAD:
1483                 return unit_can_reload(u);
1484
1485         case JOB_RELOAD_OR_START:
1486                 return unit_can_reload(u) && unit_can_start(u);
1487
1488         default:
1489                 assert_not_reached("Invalid job type");
1490         }
1491 }
1492
1493 int unit_add_dependency(Unit *u, UnitDependency d, Unit *other, bool add_reference) {
1494
1495         static const UnitDependency inverse_table[_UNIT_DEPENDENCY_MAX] = {
1496                 [UNIT_REQUIRES] = UNIT_REQUIRED_BY,
1497                 [UNIT_REQUIRES_OVERRIDABLE] = UNIT_REQUIRED_BY_OVERRIDABLE,
1498                 [UNIT_WANTS] = UNIT_WANTED_BY,
1499                 [UNIT_REQUISITE] = UNIT_REQUIRED_BY,
1500                 [UNIT_REQUISITE_OVERRIDABLE] = UNIT_REQUIRED_BY_OVERRIDABLE,
1501                 [UNIT_BIND_TO] = UNIT_BOUND_BY,
1502                 [UNIT_REQUIRED_BY] = _UNIT_DEPENDENCY_INVALID,
1503                 [UNIT_REQUIRED_BY_OVERRIDABLE] = _UNIT_DEPENDENCY_INVALID,
1504                 [UNIT_WANTED_BY] = _UNIT_DEPENDENCY_INVALID,
1505                 [UNIT_BOUND_BY] = UNIT_BIND_TO,
1506                 [UNIT_CONFLICTS] = UNIT_CONFLICTED_BY,
1507                 [UNIT_CONFLICTED_BY] = UNIT_CONFLICTS,
1508                 [UNIT_BEFORE] = UNIT_AFTER,
1509                 [UNIT_AFTER] = UNIT_BEFORE,
1510                 [UNIT_ON_FAILURE] = _UNIT_DEPENDENCY_INVALID,
1511                 [UNIT_REFERENCES] = UNIT_REFERENCED_BY,
1512                 [UNIT_REFERENCED_BY] = UNIT_REFERENCES
1513         };
1514         int r, q = 0, v = 0, w = 0;
1515
1516         assert(u);
1517         assert(d >= 0 && d < _UNIT_DEPENDENCY_MAX);
1518         assert(other);
1519
1520         u = unit_follow_merge(u);
1521         other = unit_follow_merge(other);
1522
1523         /* We won't allow dependencies on ourselves. We will not
1524          * consider them an error however. */
1525         if (u == other)
1526                 return 0;
1527
1528         if ((r = set_ensure_allocated(&u->meta.dependencies[d], trivial_hash_func, trivial_compare_func)) < 0)
1529                 return r;
1530
1531         if (inverse_table[d] != _UNIT_DEPENDENCY_INVALID)
1532                 if ((r = set_ensure_allocated(&other->meta.dependencies[inverse_table[d]], trivial_hash_func, trivial_compare_func)) < 0)
1533                         return r;
1534
1535         if (add_reference)
1536                 if ((r = set_ensure_allocated(&u->meta.dependencies[UNIT_REFERENCES], trivial_hash_func, trivial_compare_func)) < 0 ||
1537                     (r = set_ensure_allocated(&other->meta.dependencies[UNIT_REFERENCED_BY], trivial_hash_func, trivial_compare_func)) < 0)
1538                         return r;
1539
1540         if ((q = set_put(u->meta.dependencies[d], other)) < 0)
1541                 return q;
1542
1543         if (inverse_table[d] != _UNIT_DEPENDENCY_INVALID)
1544                 if ((v = set_put(other->meta.dependencies[inverse_table[d]], u)) < 0) {
1545                         r = v;
1546                         goto fail;
1547                 }
1548
1549         if (add_reference) {
1550                 if ((w = set_put(u->meta.dependencies[UNIT_REFERENCES], other)) < 0) {
1551                         r = w;
1552                         goto fail;
1553                 }
1554
1555                 if ((r = set_put(other->meta.dependencies[UNIT_REFERENCED_BY], u)) < 0)
1556                         goto fail;
1557         }
1558
1559         unit_add_to_dbus_queue(u);
1560         return 0;
1561
1562 fail:
1563         if (q > 0)
1564                 set_remove(u->meta.dependencies[d], other);
1565
1566         if (v > 0)
1567                 set_remove(other->meta.dependencies[inverse_table[d]], u);
1568
1569         if (w > 0)
1570                 set_remove(u->meta.dependencies[UNIT_REFERENCES], other);
1571
1572         return r;
1573 }
1574
1575 int unit_add_two_dependencies(Unit *u, UnitDependency d, UnitDependency e, Unit *other, bool add_reference) {
1576         int r;
1577
1578         assert(u);
1579
1580         if ((r = unit_add_dependency(u, d, other, add_reference)) < 0)
1581                 return r;
1582
1583         if ((r = unit_add_dependency(u, e, other, add_reference)) < 0)
1584                 return r;
1585
1586         return 0;
1587 }
1588
1589 static const char *resolve_template(Unit *u, const char *name, const char*path, char **p) {
1590         char *s;
1591
1592         assert(u);
1593         assert(name || path);
1594
1595         if (!name)
1596                 name = file_name_from_path(path);
1597
1598         if (!unit_name_is_template(name)) {
1599                 *p = NULL;
1600                 return name;
1601         }
1602
1603         if (u->meta.instance)
1604                 s = unit_name_replace_instance(name, u->meta.instance);
1605         else {
1606                 char *i;
1607
1608                 if (!(i = unit_name_to_prefix(u->meta.id)))
1609                         return NULL;
1610
1611                 s = unit_name_replace_instance(name, i);
1612                 free(i);
1613         }
1614
1615         if (!s)
1616                 return NULL;
1617
1618         *p = s;
1619         return s;
1620 }
1621
1622 int unit_add_dependency_by_name(Unit *u, UnitDependency d, const char *name, const char *path, bool add_reference) {
1623         Unit *other;
1624         int r;
1625         char *s;
1626
1627         assert(u);
1628         assert(name || path);
1629
1630         if (!(name = resolve_template(u, name, path, &s)))
1631                 return -ENOMEM;
1632
1633         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1634                 goto finish;
1635
1636         r = unit_add_dependency(u, d, other, add_reference);
1637
1638 finish:
1639         free(s);
1640         return r;
1641 }
1642
1643 int unit_add_two_dependencies_by_name(Unit *u, UnitDependency d, UnitDependency e, const char *name, const char *path, bool add_reference) {
1644         Unit *other;
1645         int r;
1646         char *s;
1647
1648         assert(u);
1649         assert(name || path);
1650
1651         if (!(name = resolve_template(u, name, path, &s)))
1652                 return -ENOMEM;
1653
1654         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1655                 goto finish;
1656
1657         r = unit_add_two_dependencies(u, d, e, other, add_reference);
1658
1659 finish:
1660         free(s);
1661         return r;
1662 }
1663
1664 int unit_add_dependency_by_name_inverse(Unit *u, UnitDependency d, const char *name, const char *path, bool add_reference) {
1665         Unit *other;
1666         int r;
1667         char *s;
1668
1669         assert(u);
1670         assert(name || path);
1671
1672         if (!(name = resolve_template(u, name, path, &s)))
1673                 return -ENOMEM;
1674
1675         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1676                 goto finish;
1677
1678         r = unit_add_dependency(other, d, u, add_reference);
1679
1680 finish:
1681         free(s);
1682         return r;
1683 }
1684
1685 int unit_add_two_dependencies_by_name_inverse(Unit *u, UnitDependency d, UnitDependency e, const char *name, const char *path, bool add_reference) {
1686         Unit *other;
1687         int r;
1688         char *s;
1689
1690         assert(u);
1691         assert(name || path);
1692
1693         if (!(name = resolve_template(u, name, path, &s)))
1694                 return -ENOMEM;
1695
1696         if ((r = manager_load_unit(u->meta.manager, name, path, NULL, &other)) < 0)
1697                 goto finish;
1698
1699         if ((r = unit_add_two_dependencies(other, d, e, u, add_reference)) < 0)
1700                 goto finish;
1701
1702 finish:
1703         free(s);
1704         return r;
1705 }
1706
1707 int set_unit_path(const char *p) {
1708         char *cwd, *c;
1709         int r;
1710
1711         /* This is mostly for debug purposes */
1712
1713         if (path_is_absolute(p)) {
1714                 if (!(c = strdup(p)))
1715                         return -ENOMEM;
1716         } else {
1717                 if (!(cwd = get_current_dir_name()))
1718                         return -errno;
1719
1720                 r = asprintf(&c, "%s/%s", cwd, p);
1721                 free(cwd);
1722
1723                 if (r < 0)
1724                         return -ENOMEM;
1725         }
1726
1727         if (setenv("SYSTEMD_UNIT_PATH", c, 0) < 0) {
1728                 r = -errno;
1729                 free(c);
1730                 return r;
1731         }
1732
1733         return 0;
1734 }
1735
1736 char *unit_dbus_path(Unit *u) {
1737         char *p, *e;
1738
1739         assert(u);
1740
1741         if (!u->meta.id)
1742                 return NULL;
1743
1744         if (!(e = bus_path_escape(u->meta.id)))
1745                 return NULL;
1746
1747         p = strappend("/org/freedesktop/systemd1/unit/", e);
1748         free(e);
1749
1750         return p;
1751 }
1752
1753 int unit_add_cgroup(Unit *u, CGroupBonding *b) {
1754         int r;
1755
1756         assert(u);
1757         assert(b);
1758
1759         assert(b->path);
1760
1761         if (!b->controller) {
1762                 if (!(b->controller = strdup(SYSTEMD_CGROUP_CONTROLLER)))
1763                         return -ENOMEM;
1764
1765                 b->ours = true;
1766         }
1767
1768         /* Ensure this hasn't been added yet */
1769         assert(!b->unit);
1770
1771         if (streq(b->controller, SYSTEMD_CGROUP_CONTROLLER)) {
1772                 CGroupBonding *l;
1773
1774                 l = hashmap_get(u->meta.manager->cgroup_bondings, b->path);
1775                 LIST_PREPEND(CGroupBonding, by_path, l, b);
1776
1777                 if ((r = hashmap_replace(u->meta.manager->cgroup_bondings, b->path, l)) < 0) {
1778                         LIST_REMOVE(CGroupBonding, by_path, l, b);
1779                         return r;
1780                 }
1781         }
1782
1783         LIST_PREPEND(CGroupBonding, by_unit, u->meta.cgroup_bondings, b);
1784         b->unit = u;
1785
1786         return 0;
1787 }
1788
1789 static char *default_cgroup_path(Unit *u) {
1790         char *p;
1791
1792         assert(u);
1793
1794         if (u->meta.instance) {
1795                 char *t;
1796
1797                 t = unit_name_template(u->meta.id);
1798                 if (!t)
1799                         return NULL;
1800
1801                 p = join(u->meta.manager->cgroup_hierarchy, "/", t, "/", u->meta.instance, NULL);
1802                 free(t);
1803         } else
1804                 p = join(u->meta.manager->cgroup_hierarchy, "/", u->meta.id, NULL);
1805
1806         return p;
1807 }
1808
1809 int unit_add_cgroup_from_text(Unit *u, const char *name) {
1810         char *controller = NULL, *path = NULL;
1811         CGroupBonding *b = NULL;
1812         bool ours = false;
1813         int r;
1814
1815         assert(u);
1816         assert(name);
1817
1818         if ((r = cg_split_spec(name, &controller, &path)) < 0)
1819                 return r;
1820
1821         if (!path) {
1822                 path = default_cgroup_path(u);
1823                 ours = true;
1824         }
1825
1826         if (!controller) {
1827                 controller = strdup(SYSTEMD_CGROUP_CONTROLLER);
1828                 ours = true;
1829         }
1830
1831         if (!path || !controller) {
1832                 free(path);
1833                 free(controller);
1834
1835                 return -ENOMEM;
1836         }
1837
1838         if (cgroup_bonding_find_list(u->meta.cgroup_bondings, controller)) {
1839                 r = -EEXIST;
1840                 goto fail;
1841         }
1842
1843         if (!(b = new0(CGroupBonding, 1))) {
1844                 r = -ENOMEM;
1845                 goto fail;
1846         }
1847
1848         b->controller = controller;
1849         b->path = path;
1850         b->ours = ours;
1851         b->essential = streq(controller, SYSTEMD_CGROUP_CONTROLLER);
1852
1853         if ((r = unit_add_cgroup(u, b)) < 0)
1854                 goto fail;
1855
1856         return 0;
1857
1858 fail:
1859         free(path);
1860         free(controller);
1861         free(b);
1862
1863         return r;
1864 }
1865
1866 static int unit_add_one_default_cgroup(Unit *u, const char *controller) {
1867         CGroupBonding *b = NULL;
1868         int r = -ENOMEM;
1869
1870         assert(u);
1871
1872         if (!controller)
1873                 controller = SYSTEMD_CGROUP_CONTROLLER;
1874
1875         if (cgroup_bonding_find_list(u->meta.cgroup_bondings, controller))
1876                 return 0;
1877
1878         if (!(b = new0(CGroupBonding, 1)))
1879                 return -ENOMEM;
1880
1881         if (!(b->controller = strdup(controller)))
1882                 goto fail;
1883
1884         if (!(b->path = default_cgroup_path(u)))
1885                 goto fail;
1886
1887         b->ours = true;
1888         b->essential = streq(controller, SYSTEMD_CGROUP_CONTROLLER);
1889
1890         if ((r = unit_add_cgroup(u, b)) < 0)
1891                 goto fail;
1892
1893         return 0;
1894
1895 fail:
1896         free(b->path);
1897         free(b->controller);
1898         free(b);
1899
1900         return r;
1901 }
1902
1903 int unit_add_default_cgroups(Unit *u) {
1904         CGroupAttribute *a;
1905         char **c;
1906         int r;
1907
1908         assert(u);
1909
1910         /* Adds in the default cgroups, if they weren't specified
1911          * otherwise. */
1912
1913         if (!u->meta.manager->cgroup_hierarchy)
1914                 return 0;
1915
1916         if ((r = unit_add_one_default_cgroup(u, NULL)) < 0)
1917                 return r;
1918
1919         STRV_FOREACH(c, u->meta.manager->default_controllers)
1920                 unit_add_one_default_cgroup(u, *c);
1921
1922         LIST_FOREACH(by_unit, a, u->meta.cgroup_attributes)
1923                 unit_add_one_default_cgroup(u, a->controller);
1924
1925         return 0;
1926 }
1927
1928 CGroupBonding* unit_get_default_cgroup(Unit *u) {
1929         assert(u);
1930
1931         return cgroup_bonding_find_list(u->meta.cgroup_bondings, SYSTEMD_CGROUP_CONTROLLER);
1932 }
1933
1934 int unit_add_cgroup_attribute(Unit *u, const char *controller, const char *name, const char *value, CGroupAttributeMapCallback map_callback) {
1935         int r;
1936         char *c = NULL;
1937         CGroupAttribute *a;
1938
1939         assert(u);
1940         assert(name);
1941         assert(value);
1942
1943         if (!controller) {
1944                 const char *dot;
1945
1946                 dot = strchr(name, '.');
1947                 if (!dot)
1948                         return -EINVAL;
1949
1950                 c = strndup(name, dot - name);
1951                 if (!c)
1952                         return -ENOMEM;
1953
1954                 controller = c;
1955         }
1956
1957         if (streq(controller, SYSTEMD_CGROUP_CONTROLLER)) {
1958                 r = -EINVAL;
1959                 goto finish;
1960         }
1961
1962         a = new0(CGroupAttribute, 1);
1963         if (!a) {
1964                 r = -ENOMEM;
1965                 goto finish;
1966         }
1967
1968         if (c) {
1969                 a->controller = c;
1970                 c = NULL;
1971         } else
1972                 a->controller = strdup(controller);
1973
1974         a->name = strdup(name);
1975         a->value = strdup(value);
1976
1977         if (!a->controller || !a->name || !a->value) {
1978                 free(a->controller);
1979                 free(a->name);
1980                 free(a->value);
1981                 free(a);
1982
1983                 return -ENOMEM;
1984         }
1985
1986         a->map_callback = map_callback;
1987
1988         LIST_PREPEND(CGroupAttribute, by_unit, u->meta.cgroup_attributes, a);
1989
1990         r = 0;
1991
1992 finish:
1993         free(c);
1994         return r;
1995 }
1996
1997 int unit_load_related_unit(Unit *u, const char *type, Unit **_found) {
1998         char *t;
1999         int r;
2000
2001         assert(u);
2002         assert(type);
2003         assert(_found);
2004
2005         if (!(t = unit_name_change_suffix(u->meta.id, type)))
2006                 return -ENOMEM;
2007
2008         assert(!unit_has_name(u, t));
2009
2010         r = manager_load_unit(u->meta.manager, t, NULL, NULL, _found);
2011         free(t);
2012
2013         assert(r < 0 || *_found != u);
2014
2015         return r;
2016 }
2017
2018 int unit_get_related_unit(Unit *u, const char *type, Unit **_found) {
2019         Unit *found;
2020         char *t;
2021
2022         assert(u);
2023         assert(type);
2024         assert(_found);
2025
2026         if (!(t = unit_name_change_suffix(u->meta.id, type)))
2027                 return -ENOMEM;
2028
2029         assert(!unit_has_name(u, t));
2030
2031         found = manager_get_unit(u->meta.manager, t);
2032         free(t);
2033
2034         if (!found)
2035                 return -ENOENT;
2036
2037         *_found = found;
2038         return 0;
2039 }
2040
2041 static char *specifier_prefix_and_instance(char specifier, void *data, void *userdata) {
2042         Unit *u = userdata;
2043         assert(u);
2044
2045         return unit_name_to_prefix_and_instance(u->meta.id);
2046 }
2047
2048 static char *specifier_prefix(char specifier, void *data, void *userdata) {
2049         Unit *u = userdata;
2050         assert(u);
2051
2052         return unit_name_to_prefix(u->meta.id);
2053 }
2054
2055 static char *specifier_prefix_unescaped(char specifier, void *data, void *userdata) {
2056         Unit *u = userdata;
2057         char *p, *r;
2058
2059         assert(u);
2060
2061         if (!(p = unit_name_to_prefix(u->meta.id)))
2062                 return NULL;
2063
2064         r = unit_name_unescape(p);
2065         free(p);
2066
2067         return r;
2068 }
2069
2070 static char *specifier_instance_unescaped(char specifier, void *data, void *userdata) {
2071         Unit *u = userdata;
2072         assert(u);
2073
2074         if (u->meta.instance)
2075                 return unit_name_unescape(u->meta.instance);
2076
2077         return strdup("");
2078 }
2079
2080 static char *specifier_filename(char specifier, void *data, void *userdata) {
2081         Unit *u = userdata;
2082         assert(u);
2083
2084         if (u->meta.instance)
2085                 return unit_name_path_unescape(u->meta.instance);
2086
2087         return unit_name_to_path(u->meta.instance);
2088 }
2089
2090 static char *specifier_cgroup(char specifier, void *data, void *userdata) {
2091         Unit *u = userdata;
2092         assert(u);
2093
2094         return default_cgroup_path(u);
2095 }
2096
2097 static char *specifier_cgroup_root(char specifier, void *data, void *userdata) {
2098         Unit *u = userdata;
2099         char *p;
2100         assert(u);
2101
2102         if (specifier == 'r')
2103                 return strdup(u->meta.manager->cgroup_hierarchy);
2104
2105         if (parent_of_path(u->meta.manager->cgroup_hierarchy, &p) < 0)
2106                 return strdup("");
2107
2108         if (streq(p, "/")) {
2109                 free(p);
2110                 return strdup("");
2111         }
2112
2113         return p;
2114 }
2115
2116 static char *specifier_runtime(char specifier, void *data, void *userdata) {
2117         Unit *u = userdata;
2118         assert(u);
2119
2120         if (u->meta.manager->running_as == MANAGER_USER) {
2121                 const char *e;
2122
2123                 e = getenv("XDG_RUNTIME_DIR");
2124                 if (e)
2125                         return strdup(e);
2126         }
2127
2128         return strdup("/run");
2129 }
2130
2131 char *unit_name_printf(Unit *u, const char* format) {
2132
2133         /*
2134          * This will use the passed string as format string and
2135          * replace the following specifiers:
2136          *
2137          * %n: the full id of the unit                 (foo@bar.waldo)
2138          * %N: the id of the unit without the suffix   (foo@bar)
2139          * %p: the prefix                              (foo)
2140          * %i: the instance                            (bar)
2141          */
2142
2143         const Specifier table[] = {
2144                 { 'n', specifier_string,              u->meta.id },
2145                 { 'N', specifier_prefix_and_instance, NULL },
2146                 { 'p', specifier_prefix,              NULL },
2147                 { 'i', specifier_string,              u->meta.instance },
2148                 { 0, NULL, NULL }
2149         };
2150
2151         assert(u);
2152         assert(format);
2153
2154         return specifier_printf(format, table, u);
2155 }
2156
2157 char *unit_full_printf(Unit *u, const char *format) {
2158
2159         /* This is similar to unit_name_printf() but also supports
2160          * unescaping. Also, adds a couple of additional codes:
2161          *
2162          * %c cgroup path of unit
2163          * %r root cgroup path of this systemd instance (e.g. "/user/lennart/shared/systemd-4711")
2164          * %R parent of root cgroup path (e.g. "/usr/lennart/shared")
2165          * %t the runtime directory to place sockets in (e.g. "/run" or $XDG_RUNTIME_DIR)
2166          */
2167
2168         const Specifier table[] = {
2169                 { 'n', specifier_string,              u->meta.id },
2170                 { 'N', specifier_prefix_and_instance, NULL },
2171                 { 'p', specifier_prefix,              NULL },
2172                 { 'P', specifier_prefix_unescaped,    NULL },
2173                 { 'i', specifier_string,              u->meta.instance },
2174                 { 'I', specifier_instance_unescaped,  NULL },
2175                 { 'f', specifier_filename,            NULL },
2176                 { 'c', specifier_cgroup,              NULL },
2177                 { 'r', specifier_cgroup_root,         NULL },
2178                 { 'R', specifier_cgroup_root,         NULL },
2179                 { 't', specifier_runtime,             NULL },
2180                 { 0, NULL, NULL }
2181         };
2182
2183         assert(u);
2184         assert(format);
2185
2186         return specifier_printf(format, table, u);
2187 }
2188
2189 char **unit_full_printf_strv(Unit *u, char **l) {
2190         size_t n;
2191         char **r, **i, **j;
2192
2193         /* Applies unit_full_printf to every entry in l */
2194
2195         assert(u);
2196
2197         n = strv_length(l);
2198         if (!(r = new(char*, n+1)))
2199                 return NULL;
2200
2201         for (i = l, j = r; *i; i++, j++)
2202                 if (!(*j = unit_full_printf(u, *i)))
2203                         goto fail;
2204
2205         *j = NULL;
2206         return r;
2207
2208 fail:
2209         for (j--; j >= r; j--)
2210                 free(*j);
2211
2212         free(r);
2213
2214         return NULL;
2215 }
2216
2217 int unit_watch_bus_name(Unit *u, const char *name) {
2218         assert(u);
2219         assert(name);
2220
2221         /* Watch a specific name on the bus. We only support one unit
2222          * watching each name for now. */
2223
2224         return hashmap_put(u->meta.manager->watch_bus, name, u);
2225 }
2226
2227 void unit_unwatch_bus_name(Unit *u, const char *name) {
2228         assert(u);
2229         assert(name);
2230
2231         hashmap_remove_value(u->meta.manager->watch_bus, name, u);
2232 }
2233
2234 bool unit_can_serialize(Unit *u) {
2235         assert(u);
2236
2237         return UNIT_VTABLE(u)->serialize && UNIT_VTABLE(u)->deserialize_item;
2238 }
2239
2240 int unit_serialize(Unit *u, FILE *f, FDSet *fds) {
2241         int r;
2242
2243         assert(u);
2244         assert(f);
2245         assert(fds);
2246
2247         if (!unit_can_serialize(u))
2248                 return 0;
2249
2250         if ((r = UNIT_VTABLE(u)->serialize(u, f, fds)) < 0)
2251                 return r;
2252
2253         if (u->meta.job)
2254                 unit_serialize_item(u, f, "job", job_type_to_string(u->meta.job->type));
2255
2256         dual_timestamp_serialize(f, "inactive-exit-timestamp", &u->meta.inactive_exit_timestamp);
2257         dual_timestamp_serialize(f, "active-enter-timestamp", &u->meta.active_enter_timestamp);
2258         dual_timestamp_serialize(f, "active-exit-timestamp", &u->meta.active_exit_timestamp);
2259         dual_timestamp_serialize(f, "inactive-enter-timestamp", &u->meta.inactive_enter_timestamp);
2260         dual_timestamp_serialize(f, "condition-timestamp", &u->meta.condition_timestamp);
2261
2262         if (dual_timestamp_is_set(&u->meta.condition_timestamp))
2263                 unit_serialize_item(u, f, "condition-result", yes_no(u->meta.condition_result));
2264
2265         /* End marker */
2266         fputc('\n', f);
2267         return 0;
2268 }
2269
2270 void unit_serialize_item_format(Unit *u, FILE *f, const char *key, const char *format, ...) {
2271         va_list ap;
2272
2273         assert(u);
2274         assert(f);
2275         assert(key);
2276         assert(format);
2277
2278         fputs(key, f);
2279         fputc('=', f);
2280
2281         va_start(ap, format);
2282         vfprintf(f, format, ap);
2283         va_end(ap);
2284
2285         fputc('\n', f);
2286 }
2287
2288 void unit_serialize_item(Unit *u, FILE *f, const char *key, const char *value) {
2289         assert(u);
2290         assert(f);
2291         assert(key);
2292         assert(value);
2293
2294         fprintf(f, "%s=%s\n", key, value);
2295 }
2296
2297 int unit_deserialize(Unit *u, FILE *f, FDSet *fds) {
2298         int r;
2299
2300         assert(u);
2301         assert(f);
2302         assert(fds);
2303
2304         if (!unit_can_serialize(u))
2305                 return 0;
2306
2307         for (;;) {
2308                 char line[LINE_MAX], *l, *v;
2309                 size_t k;
2310
2311                 if (!fgets(line, sizeof(line), f)) {
2312                         if (feof(f))
2313                                 return 0;
2314                         return -errno;
2315                 }
2316
2317                 char_array_0(line);
2318                 l = strstrip(line);
2319
2320                 /* End marker */
2321                 if (l[0] == 0)
2322                         return 0;
2323
2324                 k = strcspn(l, "=");
2325
2326                 if (l[k] == '=') {
2327                         l[k] = 0;
2328                         v = l+k+1;
2329                 } else
2330                         v = l+k;
2331
2332                 if (streq(l, "job")) {
2333                         JobType type;
2334
2335                         if ((type = job_type_from_string(v)) < 0)
2336                                 log_debug("Failed to parse job type value %s", v);
2337                         else
2338                                 u->meta.deserialized_job = type;
2339
2340                         continue;
2341                 } else if (streq(l, "inactive-exit-timestamp")) {
2342                         dual_timestamp_deserialize(v, &u->meta.inactive_exit_timestamp);
2343                         continue;
2344                 } else if (streq(l, "active-enter-timestamp")) {
2345                         dual_timestamp_deserialize(v, &u->meta.active_enter_timestamp);
2346                         continue;
2347                 } else if (streq(l, "active-exit-timestamp")) {
2348                         dual_timestamp_deserialize(v, &u->meta.active_exit_timestamp);
2349                         continue;
2350                 } else if (streq(l, "inactive-enter-timestamp")) {
2351                         dual_timestamp_deserialize(v, &u->meta.inactive_enter_timestamp);
2352                         continue;
2353                 } else if (streq(l, "condition-timestamp")) {
2354                         dual_timestamp_deserialize(v, &u->meta.condition_timestamp);
2355                         continue;
2356                 } else if (streq(l, "condition-result")) {
2357                         int b;
2358
2359                         if ((b = parse_boolean(v)) < 0)
2360                                 log_debug("Failed to parse condition result value %s", v);
2361                         else
2362                                 u->meta.condition_result = b;
2363
2364                         continue;
2365                 }
2366
2367                 if ((r = UNIT_VTABLE(u)->deserialize_item(u, l, v, fds)) < 0)
2368                         return r;
2369         }
2370 }
2371
2372 int unit_add_node_link(Unit *u, const char *what, bool wants) {
2373         Unit *device;
2374         char *e;
2375         int r;
2376
2377         assert(u);
2378
2379         if (!what)
2380                 return 0;
2381
2382         /* Adds in links to the device node that this unit is based on */
2383
2384         if (!is_device_path(what))
2385                 return 0;
2386
2387         if (!(e = unit_name_build_escape(what+1, NULL, ".device")))
2388                 return -ENOMEM;
2389
2390         r = manager_load_unit(u->meta.manager, e, NULL, NULL, &device);
2391         free(e);
2392
2393         if (r < 0)
2394                 return r;
2395
2396         if ((r = unit_add_two_dependencies(u, UNIT_AFTER, UNIT_BIND_TO, device, true)) < 0)
2397                 return r;
2398
2399         if (wants)
2400                 if ((r = unit_add_dependency(device, UNIT_WANTS, u, false)) < 0)
2401                         return r;
2402
2403         return 0;
2404 }
2405
2406 int unit_coldplug(Unit *u) {
2407         int r;
2408
2409         assert(u);
2410
2411         if (UNIT_VTABLE(u)->coldplug)
2412                 if ((r = UNIT_VTABLE(u)->coldplug(u)) < 0)
2413                         return r;
2414
2415         if (u->meta.deserialized_job >= 0) {
2416                 if ((r = manager_add_job(u->meta.manager, u->meta.deserialized_job, u, JOB_IGNORE_REQUIREMENTS, false, NULL, NULL)) < 0)
2417                         return r;
2418
2419                 u->meta.deserialized_job = _JOB_TYPE_INVALID;
2420         }
2421
2422         return 0;
2423 }
2424
2425 void unit_status_printf(Unit *u, const char *format, ...) {
2426         va_list ap;
2427
2428         assert(u);
2429         assert(format);
2430
2431         if (!UNIT_VTABLE(u)->show_status)
2432                 return;
2433
2434         if (u->meta.manager->running_as != MANAGER_SYSTEM)
2435                 return;
2436
2437         /* If Plymouth is running make sure we show the status, so
2438          * that there's something nice to see when people press Esc */
2439
2440         if (!u->meta.manager->show_status && !plymouth_running())
2441                 return;
2442
2443         if (!manager_is_booting_or_shutting_down(u->meta.manager))
2444                 return;
2445
2446         va_start(ap, format);
2447         status_vprintf(format, ap);
2448         va_end(ap);
2449 }
2450
2451 bool unit_need_daemon_reload(Unit *u) {
2452         assert(u);
2453
2454         if (u->meta.fragment_path) {
2455                 struct stat st;
2456
2457                 zero(st);
2458                 if (stat(u->meta.fragment_path, &st) < 0)
2459                         /* What, cannot access this anymore? */
2460                         return true;
2461
2462                 if (u->meta.fragment_mtime > 0 &&
2463                     timespec_load(&st.st_mtim) != u->meta.fragment_mtime)
2464                         return true;
2465         }
2466
2467         if (UNIT_VTABLE(u)->need_daemon_reload)
2468                 return UNIT_VTABLE(u)->need_daemon_reload(u);
2469
2470         return false;
2471 }
2472
2473 void unit_reset_failed(Unit *u) {
2474         assert(u);
2475
2476         if (UNIT_VTABLE(u)->reset_failed)
2477                 UNIT_VTABLE(u)->reset_failed(u);
2478 }
2479
2480 Unit *unit_following(Unit *u) {
2481         assert(u);
2482
2483         if (UNIT_VTABLE(u)->following)
2484                 return UNIT_VTABLE(u)->following(u);
2485
2486         return NULL;
2487 }
2488
2489 bool unit_pending_inactive(Unit *u) {
2490         assert(u);
2491
2492         /* Returns true if the unit is inactive or going down */
2493
2494         if (UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u)))
2495                 return true;
2496
2497         if (u->meta.job && u->meta.job->type == JOB_STOP)
2498                 return true;
2499
2500         return false;
2501 }
2502
2503 bool unit_pending_active(Unit *u) {
2504         assert(u);
2505
2506         /* Returns true if the unit is inactive or going down */
2507
2508         if (UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)))
2509                 return true;
2510
2511         if (u->meta.job &&
2512             (u->meta.job->type == JOB_START ||
2513              u->meta.job->type == JOB_RELOAD_OR_START ||
2514              u->meta.job->type == JOB_RESTART))
2515                 return true;
2516
2517         return false;
2518 }
2519
2520 UnitType unit_name_to_type(const char *n) {
2521         UnitType t;
2522
2523         assert(n);
2524
2525         for (t = 0; t < _UNIT_TYPE_MAX; t++)
2526                 if (endswith(n, unit_vtable[t]->suffix))
2527                         return t;
2528
2529         return _UNIT_TYPE_INVALID;
2530 }
2531
2532 bool unit_name_is_valid(const char *n, bool template_ok) {
2533         UnitType t;
2534
2535         t = unit_name_to_type(n);
2536         if (t < 0 || t >= _UNIT_TYPE_MAX)
2537                 return false;
2538
2539         return unit_name_is_valid_no_type(n, template_ok);
2540 }
2541
2542 int unit_kill(Unit *u, KillWho w, KillMode m, int signo, DBusError *error) {
2543         assert(u);
2544         assert(w >= 0 && w < _KILL_WHO_MAX);
2545         assert(m >= 0 && m < _KILL_MODE_MAX);
2546         assert(signo > 0);
2547         assert(signo < _NSIG);
2548
2549         if (m == KILL_NONE)
2550                 return 0;
2551
2552         if (!UNIT_VTABLE(u)->kill)
2553                 return -ENOTSUP;
2554
2555         return UNIT_VTABLE(u)->kill(u, w, m, signo, error);
2556 }
2557
2558 int unit_following_set(Unit *u, Set **s) {
2559         assert(u);
2560         assert(s);
2561
2562         if (UNIT_VTABLE(u)->following_set)
2563                 return UNIT_VTABLE(u)->following_set(u, s);
2564
2565         *s = NULL;
2566         return 0;
2567 }
2568
2569 UnitFileState unit_get_unit_file_state(Unit *u) {
2570         assert(u);
2571
2572         if (u->meta.unit_file_state < 0 && u->meta.fragment_path)
2573                 u->meta.unit_file_state = unit_file_get_state(
2574                                 u->meta.manager->running_as == MANAGER_SYSTEM ? UNIT_FILE_SYSTEM : UNIT_FILE_USER,
2575                                 NULL, file_name_from_path(u->meta.fragment_path));
2576
2577         return u->meta.unit_file_state;
2578 }
2579
2580 static const char* const unit_load_state_table[_UNIT_LOAD_STATE_MAX] = {
2581         [UNIT_STUB] = "stub",
2582         [UNIT_LOADED] = "loaded",
2583         [UNIT_ERROR] = "error",
2584         [UNIT_MERGED] = "merged",
2585         [UNIT_MASKED] = "masked"
2586 };
2587
2588 DEFINE_STRING_TABLE_LOOKUP(unit_load_state, UnitLoadState);
2589
2590 static const char* const unit_active_state_table[_UNIT_ACTIVE_STATE_MAX] = {
2591         [UNIT_ACTIVE] = "active",
2592         [UNIT_RELOADING] = "reloading",
2593         [UNIT_INACTIVE] = "inactive",
2594         [UNIT_FAILED] = "failed",
2595         [UNIT_ACTIVATING] = "activating",
2596         [UNIT_DEACTIVATING] = "deactivating"
2597 };
2598
2599 DEFINE_STRING_TABLE_LOOKUP(unit_active_state, UnitActiveState);
2600
2601 static const char* const unit_dependency_table[_UNIT_DEPENDENCY_MAX] = {
2602         [UNIT_REQUIRES] = "Requires",
2603         [UNIT_REQUIRES_OVERRIDABLE] = "RequiresOverridable",
2604         [UNIT_WANTS] = "Wants",
2605         [UNIT_REQUISITE] = "Requisite",
2606         [UNIT_REQUISITE_OVERRIDABLE] = "RequisiteOverridable",
2607         [UNIT_REQUIRED_BY] = "RequiredBy",
2608         [UNIT_REQUIRED_BY_OVERRIDABLE] = "RequiredByOverridable",
2609         [UNIT_BIND_TO] = "BindTo",
2610         [UNIT_WANTED_BY] = "WantedBy",
2611         [UNIT_CONFLICTS] = "Conflicts",
2612         [UNIT_CONFLICTED_BY] = "ConflictedBy",
2613         [UNIT_BOUND_BY] = "BoundBy",
2614         [UNIT_BEFORE] = "Before",
2615         [UNIT_AFTER] = "After",
2616         [UNIT_REFERENCES] = "References",
2617         [UNIT_REFERENCED_BY] = "ReferencedBy",
2618         [UNIT_ON_FAILURE] = "OnFailure"
2619 };
2620
2621 DEFINE_STRING_TABLE_LOOKUP(unit_dependency, UnitDependency);