chiark / gitweb /
device: don't allow definiing additional aliases via SYSTEMD_NAMES
[elogind.git] / 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
31 #include "set.h"
32 #include "unit.h"
33 #include "macro.h"
34 #include "strv.h"
35 #include "load-fragment.h"
36 #include "load-dropin.h"
37 #include "log.h"
38 #include "unit-name.h"
39 #include "specifier.h"
40 #include "dbus-unit.h"
41
42 const UnitVTable * const unit_vtable[_UNIT_TYPE_MAX] = {
43         [UNIT_SERVICE] = &service_vtable,
44         [UNIT_TIMER] = &timer_vtable,
45         [UNIT_SOCKET] = &socket_vtable,
46         [UNIT_TARGET] = &target_vtable,
47         [UNIT_DEVICE] = &device_vtable,
48         [UNIT_MOUNT] = &mount_vtable,
49         [UNIT_AUTOMOUNT] = &automount_vtable,
50         [UNIT_SNAPSHOT] = &snapshot_vtable
51 };
52
53 Unit *unit_new(Manager *m) {
54         Unit *u;
55
56         assert(m);
57
58         if (!(u = new0(Unit, 1)))
59                 return NULL;
60
61         if (!(u->meta.names = set_new(string_hash_func, string_compare_func))) {
62                 free(u);
63                 return NULL;
64         }
65
66         u->meta.manager = m;
67         u->meta.type = _UNIT_TYPE_INVALID;
68
69         return u;
70 }
71
72 bool unit_has_name(Unit *u, const char *name) {
73         assert(u);
74         assert(name);
75
76         return !!set_get(u->meta.names, (char*) name);
77 }
78
79 int unit_add_name(Unit *u, const char *text) {
80         UnitType t;
81         char *s = NULL, *i = NULL;
82         int r;
83
84         assert(u);
85         assert(text);
86
87         if (unit_name_is_template(text)) {
88                 if (!u->meta.instance)
89                         return -EINVAL;
90
91                 s = unit_name_replace_instance(text, u->meta.instance);
92         } else
93                 s = strdup(text);
94
95         if (!s)
96                 return -ENOMEM;
97
98         if (!unit_name_is_valid(s)) {
99                 r = -EINVAL;
100                 goto fail;
101         }
102
103         assert_se((t = unit_name_to_type(s)) >= 0);
104
105         if (u->meta.type != _UNIT_TYPE_INVALID && t != u->meta.type) {
106                 r = -EINVAL;
107                 goto fail;
108         }
109
110         if ((r = unit_name_to_instance(s, &i)) < 0)
111                 goto fail;
112
113         if (i && unit_vtable[t]->no_instances)
114                 goto fail;
115
116         if (u->meta.type != _UNIT_TYPE_INVALID && !streq_ptr(u->meta.instance, i)) {
117                 r = -EINVAL;
118                 goto fail;
119         }
120
121         if (unit_vtable[t]->no_alias &&
122             !set_isempty(u->meta.names) &&
123             !set_get(u->meta.names, s)) {
124                 r = -EEXIST;
125                 goto fail;
126         }
127
128         if ((r = set_put(u->meta.names, s)) < 0) {
129                 if (r == -EEXIST)
130                         r = 0;
131                 goto fail;
132         }
133
134         if ((r = hashmap_put(u->meta.manager->units, s, u)) < 0) {
135                 set_remove(u->meta.names, s);
136                 goto fail;
137         }
138
139         if (u->meta.type == _UNIT_TYPE_INVALID) {
140
141                 u->meta.type = t;
142                 u->meta.id = s;
143                 u->meta.instance = i;
144
145                 LIST_PREPEND(Meta, units_per_type, u->meta.manager->units_per_type[t], &u->meta);
146
147                 if (UNIT_VTABLE(u)->init)
148                         UNIT_VTABLE(u)->init(u);
149         } else
150                 free(i);
151
152         unit_add_to_dbus_queue(u);
153         return 0;
154
155 fail:
156         free(s);
157         free(i);
158
159         return r;
160 }
161
162 int unit_choose_id(Unit *u, const char *name) {
163         char *s, *t = NULL;
164
165         assert(u);
166         assert(name);
167
168         if (unit_name_is_template(name)) {
169
170                 if (!u->meta.instance)
171                         return -EINVAL;
172
173                 if (!(t = unit_name_replace_instance(name, u->meta.instance)))
174                         return -ENOMEM;
175
176                 name = t;
177         }
178
179         /* Selects one of the names of this unit as the id */
180         s = set_get(u->meta.names, (char*) name);
181         free(t);
182
183         if (!s)
184                 return -ENOENT;
185
186         u->meta.id = s;
187         unit_add_to_dbus_queue(u);
188
189         return 0;
190 }
191
192 int unit_set_description(Unit *u, const char *description) {
193         char *s;
194
195         assert(u);
196
197         if (!(s = strdup(description)))
198                 return -ENOMEM;
199
200         free(u->meta.description);
201         u->meta.description = s;
202
203         unit_add_to_dbus_queue(u);
204         return 0;
205 }
206
207 void unit_add_to_load_queue(Unit *u) {
208         assert(u);
209         assert(u->meta.type != _UNIT_TYPE_INVALID);
210
211         if (u->meta.load_state != UNIT_STUB || u->meta.in_load_queue)
212                 return;
213
214         LIST_PREPEND(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
215         u->meta.in_load_queue = true;
216 }
217
218 void unit_add_to_cleanup_queue(Unit *u) {
219         assert(u);
220
221         if (u->meta.in_cleanup_queue)
222                 return;
223
224         LIST_PREPEND(Meta, cleanup_queue, u->meta.manager->cleanup_queue, &u->meta);
225         u->meta.in_cleanup_queue = true;
226 }
227
228 void unit_add_to_dbus_queue(Unit *u) {
229         assert(u);
230         assert(u->meta.type != _UNIT_TYPE_INVALID);
231
232         if (u->meta.load_state == UNIT_STUB || u->meta.in_dbus_queue || set_isempty(u->meta.manager->subscribed))
233                 return;
234
235         LIST_PREPEND(Meta, dbus_queue, u->meta.manager->dbus_unit_queue, &u->meta);
236         u->meta.in_dbus_queue = true;
237 }
238
239 static void bidi_set_free(Unit *u, Set *s) {
240         Iterator i;
241         Unit *other;
242
243         assert(u);
244
245         /* Frees the set and makes sure we are dropped from the
246          * inverse pointers */
247
248         SET_FOREACH(other, s, i) {
249                 UnitDependency d;
250
251                 for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
252                         set_remove(other->meta.dependencies[d], u);
253         }
254
255         set_free(s);
256 }
257
258 void unit_free(Unit *u) {
259         UnitDependency d;
260         Iterator i;
261         char *t;
262
263         assert(u);
264
265         bus_unit_send_removed_signal(u);
266
267         /* Detach from next 'bigger' objects */
268         SET_FOREACH(t, u->meta.names, i)
269                 hashmap_remove_value(u->meta.manager->units, t, u);
270
271         if (u->meta.type != _UNIT_TYPE_INVALID)
272                 LIST_REMOVE(Meta, units_per_type, u->meta.manager->units_per_type[u->meta.type], &u->meta);
273
274         if (u->meta.in_load_queue)
275                 LIST_REMOVE(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
276
277         if (u->meta.in_dbus_queue)
278                 LIST_REMOVE(Meta, dbus_queue, u->meta.manager->dbus_unit_queue, &u->meta);
279
280         if (u->meta.in_cleanup_queue)
281                 LIST_REMOVE(Meta, cleanup_queue, u->meta.manager->cleanup_queue, &u->meta);
282
283         /* Free data and next 'smaller' objects */
284         if (u->meta.job)
285                 job_free(u->meta.job);
286
287         if (u->meta.load_state != UNIT_STUB)
288                 if (UNIT_VTABLE(u)->done)
289                         UNIT_VTABLE(u)->done(u);
290
291         cgroup_bonding_free_list(u->meta.cgroup_bondings);
292
293         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
294                 bidi_set_free(u, u->meta.dependencies[d]);
295
296         free(u->meta.description);
297         free(u->meta.fragment_path);
298
299         while ((t = set_steal_first(u->meta.names)))
300                 free(t);
301         set_free(u->meta.names);
302
303         free(u->meta.instance);
304
305         free(u);
306 }
307
308 UnitActiveState unit_active_state(Unit *u) {
309         assert(u);
310
311         if (u->meta.load_state != UNIT_LOADED)
312                 return UNIT_INACTIVE;
313
314         return UNIT_VTABLE(u)->active_state(u);
315 }
316
317 const char* unit_sub_state_to_string(Unit *u) {
318         assert(u);
319
320         return UNIT_VTABLE(u)->sub_state_to_string(u);
321 }
322
323 static void complete_move(Set **s, Set **other) {
324         assert(s);
325         assert(other);
326
327         if (!*other)
328                 return;
329
330         if (*s)
331                 set_move(*s, *other);
332         else {
333                 *s = *other;
334                 *other = NULL;
335         }
336 }
337
338 static void merge_names(Unit *u, Unit *other) {
339         char *t;
340         Iterator i;
341
342         assert(u);
343         assert(other);
344
345         complete_move(&u->meta.names, &other->meta.names);
346
347         while ((t = set_steal_first(other->meta.names)))
348                 free(t);
349
350         set_free(other->meta.names);
351         other->meta.names = NULL;
352         other->meta.id = NULL;
353
354         SET_FOREACH(t, u->meta.names, i)
355                 assert_se(hashmap_replace(u->meta.manager->units, t, u) == 0);
356 }
357
358 static void merge_dependencies(Unit *u, Unit *other, UnitDependency d) {
359         Iterator i;
360         Unit *back;
361         int r;
362
363         assert(u);
364         assert(other);
365         assert(d < _UNIT_DEPENDENCY_MAX);
366
367         SET_FOREACH(back, other->meta.dependencies[d], i) {
368                 UnitDependency k;
369
370                 for (k = 0; k < _UNIT_DEPENDENCY_MAX; k++)
371                         if ((r = set_remove_and_put(back->meta.dependencies[k], other, u)) < 0) {
372
373                                 if (r == -EEXIST)
374                                         set_remove(back->meta.dependencies[k], other);
375                                 else
376                                         assert(r == -ENOENT);
377                         }
378         }
379
380         complete_move(&u->meta.dependencies[d], &other->meta.dependencies[d]);
381
382         set_free(other->meta.dependencies[d]);
383         other->meta.dependencies[d] = NULL;
384 }
385
386 int unit_merge(Unit *u, Unit *other) {
387         UnitDependency d;
388
389         assert(u);
390         assert(other);
391         assert(u->meta.manager == other->meta.manager);
392         assert(u->meta.type != _UNIT_TYPE_INVALID);
393
394         other = unit_follow_merge(other);
395
396         if (other == u)
397                 return 0;
398
399         if (u->meta.type != other->meta.type)
400                 return -EINVAL;
401
402         if (!streq_ptr(u->meta.instance, other->meta.instance))
403                 return -EINVAL;
404
405         if (other->meta.load_state != UNIT_STUB &&
406             other->meta.load_state != UNIT_FAILED)
407                 return -EEXIST;
408
409         if (other->meta.job)
410                 return -EEXIST;
411
412         if (unit_active_state(other) != UNIT_INACTIVE)
413                 return -EEXIST;
414
415         /* Merge names */
416         merge_names(u, other);
417
418         /* Merge dependencies */
419         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++)
420                 merge_dependencies(u, other, d);
421
422         other->meta.load_state = UNIT_MERGED;
423         other->meta.merged_into = u;
424
425         /* If there is still some data attached to the other node, we
426          * don't need it anymore, and can free it. */
427         if (other->meta.load_state != UNIT_STUB)
428                 if (UNIT_VTABLE(other)->done)
429                         UNIT_VTABLE(other)->done(other);
430
431         unit_add_to_dbus_queue(u);
432         unit_add_to_cleanup_queue(other);
433
434         return 0;
435 }
436
437 int unit_merge_by_name(Unit *u, const char *name) {
438         Unit *other;
439         int r;
440         char *s = NULL;
441
442         assert(u);
443         assert(name);
444
445         if (unit_name_is_template(name)) {
446                 if (!u->meta.instance)
447                         return -EINVAL;
448
449                 if (!(s = unit_name_replace_instance(name, u->meta.instance)))
450                         return -ENOMEM;
451
452                 name = s;
453         }
454
455         if (!(other = manager_get_unit(u->meta.manager, name)))
456                 r = unit_add_name(u, name);
457         else
458                 r = unit_merge(u, other);
459
460         free(s);
461         return r;
462 }
463
464 Unit* unit_follow_merge(Unit *u) {
465         assert(u);
466
467         while (u->meta.load_state == UNIT_MERGED)
468                 assert_se(u = u->meta.merged_into);
469
470         return u;
471 }
472
473 int unit_add_exec_dependencies(Unit *u, ExecContext *c) {
474         int r;
475
476         assert(u);
477         assert(c);
478
479         if (c->std_output != EXEC_OUTPUT_KERNEL && c->std_output != EXEC_OUTPUT_SYSLOG)
480                 return 0;
481
482         /* If syslog or kernel logging is requested, make sure our own
483          * logging daemon is run first. */
484
485         if ((r = unit_add_dependency_by_name(u, UNIT_AFTER, SPECIAL_LOGGER_SOCKET, NULL)) < 0)
486                 return r;
487
488         if (u->meta.manager->running_as != MANAGER_SESSION)
489                 if ((r = unit_add_dependency_by_name(u, UNIT_REQUIRES, SPECIAL_LOGGER_SOCKET, NULL)) < 0)
490                         return r;
491
492         return 0;
493 }
494
495 const char *unit_description(Unit *u) {
496         assert(u);
497
498         if (u->meta.description)
499                 return u->meta.description;
500
501         return u->meta.id;
502 }
503
504 void unit_dump(Unit *u, FILE *f, const char *prefix) {
505         char *t;
506         UnitDependency d;
507         Iterator i;
508         char *p2;
509         const char *prefix2;
510         CGroupBonding *b;
511         char timestamp1[FORMAT_TIMESTAMP_MAX], timestamp2[FORMAT_TIMESTAMP_MAX];
512
513         assert(u);
514         assert(u->meta.type >= 0);
515
516         if (!prefix)
517                 prefix = "";
518         p2 = strappend(prefix, "\t");
519         prefix2 = p2 ? p2 : prefix;
520
521         fprintf(f,
522                 "%s→ Unit %s:\n"
523                 "%s\tDescription: %s\n"
524                 "%s\tInstance: %s\n"
525                 "%s\tUnit Load State: %s\n"
526                 "%s\tUnit Active State: %s\n"
527                 "%s\tActive Enter Timestamp: %s\n"
528                 "%s\tActive Exit Timestamp: %s\n",
529                 prefix, u->meta.id,
530                 prefix, unit_description(u),
531                 prefix, strna(u->meta.instance),
532                 prefix, unit_load_state_to_string(u->meta.load_state),
533                 prefix, unit_active_state_to_string(unit_active_state(u)),
534                 prefix, strna(format_timestamp(timestamp1, sizeof(timestamp1), u->meta.active_enter_timestamp)),
535                 prefix, strna(format_timestamp(timestamp2, sizeof(timestamp2), u->meta.active_exit_timestamp)));
536
537         SET_FOREACH(t, u->meta.names, i)
538                 fprintf(f, "%s\tName: %s\n", prefix, t);
539
540         if (u->meta.fragment_path)
541                 fprintf(f, "%s\tFragment Path: %s\n", prefix, u->meta.fragment_path);
542
543         for (d = 0; d < _UNIT_DEPENDENCY_MAX; d++) {
544                 Unit *other;
545
546                 SET_FOREACH(other, u->meta.dependencies[d], i)
547                         fprintf(f, "%s\t%s: %s\n", prefix, unit_dependency_to_string(d), other->meta.id);
548         }
549
550         if (u->meta.load_state == UNIT_LOADED) {
551                 fprintf(f,
552                         "%s\tRecursive Stop: %s\n"
553                         "%s\tStop When Unneeded: %s\n",
554                         prefix, yes_no(u->meta.recursive_stop),
555                         prefix, yes_no(u->meta.stop_when_unneeded));
556
557                 LIST_FOREACH(by_unit, b, u->meta.cgroup_bondings)
558                         fprintf(f, "%s\tControlGroup: %s:%s\n",
559                                 prefix, b->controller, b->path);
560
561                 if (UNIT_VTABLE(u)->dump)
562                         UNIT_VTABLE(u)->dump(u, f, prefix2);
563
564         } else if (u->meta.load_state == UNIT_MERGED)
565                 fprintf(f,
566                         "%s\tMerged into: %s\n",
567                         prefix, u->meta.merged_into->meta.id);
568
569         if (u->meta.job)
570                 job_dump(u->meta.job, f, prefix2);
571
572         free(p2);
573 }
574
575 /* Common implementation for multiple backends */
576 int unit_load_fragment_and_dropin(Unit *u) {
577         int r;
578
579         assert(u);
580
581         /* Load a .service file */
582         if ((r = unit_load_fragment(u)) < 0)
583                 return r;
584
585         if (u->meta.load_state == UNIT_STUB)
586                 return -ENOENT;
587
588         /* Load drop-in directory data */
589         if ((r = unit_load_dropin(unit_follow_merge(u))) < 0)
590                 return r;
591
592         return 0;
593 }
594
595 /* Common implementation for multiple backends */
596 int unit_load_fragment_and_dropin_optional(Unit *u) {
597         int r;
598
599         assert(u);
600
601         /* Same as unit_load_fragment_and_dropin(), but whether
602          * something can be loaded or not doesn't matter. */
603
604         /* Load a .service file */
605         if ((r = unit_load_fragment(u)) < 0)
606                 return r;
607
608         if (u->meta.load_state == UNIT_STUB)
609                 u->meta.load_state = UNIT_LOADED;
610
611         /* Load drop-in directory data */
612         if ((r = unit_load_dropin(unit_follow_merge(u))) < 0)
613                 return r;
614
615         return 0;
616 }
617
618 int unit_load(Unit *u) {
619         int r;
620
621         assert(u);
622
623         if (u->meta.in_load_queue) {
624                 LIST_REMOVE(Meta, load_queue, u->meta.manager->load_queue, &u->meta);
625                 u->meta.in_load_queue = false;
626         }
627
628         if (u->meta.type == _UNIT_TYPE_INVALID)
629                 return -EINVAL;
630
631         if (u->meta.load_state != UNIT_STUB)
632                 return 0;
633
634         if (UNIT_VTABLE(u)->load)
635                 if ((r = UNIT_VTABLE(u)->load(u)) < 0)
636                         goto fail;
637
638         if (u->meta.load_state == UNIT_STUB) {
639                 r = -ENOENT;
640                 goto fail;
641         }
642
643         assert((u->meta.load_state != UNIT_MERGED) == !u->meta.merged_into);
644
645         unit_add_to_dbus_queue(unit_follow_merge(u));
646
647         return 0;
648
649 fail:
650         u->meta.load_state = UNIT_FAILED;
651         unit_add_to_dbus_queue(u);
652
653         log_error("Failed to load configuration for %s: %s", u->meta.id, strerror(-r));
654
655         return r;
656 }
657
658 /* Errors:
659  *         -EBADR:    This unit type does not support starting.
660  *         -EALREADY: Unit is already started.
661  *         -EAGAIN:   An operation is already in progress. Retry later.
662  */
663 int unit_start(Unit *u) {
664         UnitActiveState state;
665
666         assert(u);
667
668         /* If this is already (being) started, then this will
669          * succeed. Note that this will even succeed if this unit is
670          * not startable by the user. This is relied on to detect when
671          * we need to wait for units and when waiting is finished. */
672         state = unit_active_state(u);
673         if (UNIT_IS_ACTIVE_OR_RELOADING(state))
674                 return -EALREADY;
675
676         /* If it is stopped, but we cannot start it, then fail */
677         if (!UNIT_VTABLE(u)->start)
678                 return -EBADR;
679
680         /* We don't suppress calls to ->start() here when we are
681          * already starting, to allow this request to be used as a
682          * "hurry up" call, for example when the unit is in some "auto
683          * restart" state where it waits for a holdoff timer to elapse
684          * before it will start again. */
685
686         unit_add_to_dbus_queue(u);
687         return UNIT_VTABLE(u)->start(u);
688 }
689
690 bool unit_can_start(Unit *u) {
691         assert(u);
692
693         return !!UNIT_VTABLE(u)->start;
694 }
695
696 /* Errors:
697  *         -EBADR:    This unit type does not support stopping.
698  *         -EALREADY: Unit is already stopped.
699  *         -EAGAIN:   An operation is already in progress. Retry later.
700  */
701 int unit_stop(Unit *u) {
702         UnitActiveState state;
703
704         assert(u);
705
706         state = unit_active_state(u);
707         if (state == UNIT_INACTIVE)
708                 return -EALREADY;
709
710         if (!UNIT_VTABLE(u)->stop)
711                 return -EBADR;
712
713         unit_add_to_dbus_queue(u);
714         return UNIT_VTABLE(u)->stop(u);
715 }
716
717 /* Errors:
718  *         -EBADR:    This unit type does not support reloading.
719  *         -ENOEXEC:  Unit is not started.
720  *         -EAGAIN:   An operation is already in progress. Retry later.
721  */
722 int unit_reload(Unit *u) {
723         UnitActiveState state;
724
725         assert(u);
726
727         if (!unit_can_reload(u))
728                 return -EBADR;
729
730         state = unit_active_state(u);
731         if (unit_active_state(u) == UNIT_ACTIVE_RELOADING)
732                 return -EALREADY;
733
734         if (unit_active_state(u) != UNIT_ACTIVE)
735                 return -ENOEXEC;
736
737         unit_add_to_dbus_queue(u);
738         return UNIT_VTABLE(u)->reload(u);
739 }
740
741 bool unit_can_reload(Unit *u) {
742         assert(u);
743
744         if (!UNIT_VTABLE(u)->reload)
745                 return false;
746
747         if (!UNIT_VTABLE(u)->can_reload)
748                 return true;
749
750         return UNIT_VTABLE(u)->can_reload(u);
751 }
752
753 static void unit_check_uneeded(Unit *u) {
754         Iterator i;
755         Unit *other;
756
757         assert(u);
758
759         /* If this service shall be shut down when unneeded then do
760          * so. */
761
762         if (!u->meta.stop_when_unneeded)
763                 return;
764
765         if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)))
766                 return;
767
768         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY], i)
769                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
770                         return;
771
772         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY_OVERRIDABLE], i)
773                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
774                         return;
775
776         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTED_BY], i)
777                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
778                         return;
779
780         log_debug("Service %s is not needed anymore. Stopping.", u->meta.id);
781
782         /* Ok, nobody needs us anymore. Sniff. Then let's commit suicide */
783         manager_add_job(u->meta.manager, JOB_STOP, u, JOB_FAIL, true, NULL);
784 }
785
786 static void retroactively_start_dependencies(Unit *u) {
787         Iterator i;
788         Unit *other;
789
790         assert(u);
791         assert(UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(u)));
792
793         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES], i)
794                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
795                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL);
796
797         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES_OVERRIDABLE], i)
798                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
799                         manager_add_job(u->meta.manager, JOB_START, other, JOB_FAIL, false, NULL);
800
801         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE], i)
802                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
803                         manager_add_job(u->meta.manager, JOB_START, other, JOB_REPLACE, true, NULL);
804
805         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTS], i)
806                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
807                         manager_add_job(u->meta.manager, JOB_START, other, JOB_FAIL, false, NULL);
808
809         SET_FOREACH(other, u->meta.dependencies[UNIT_CONFLICTS], i)
810                 if (!UNIT_IS_ACTIVE_OR_ACTIVATING(unit_active_state(other)))
811                         manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL);
812 }
813
814 static void retroactively_stop_dependencies(Unit *u) {
815         Iterator i;
816         Unit *other;
817
818         assert(u);
819         assert(UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(u)));
820
821         if (u->meta.recursive_stop) {
822                 /* Pull down units need us recursively if enabled */
823                 SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRED_BY], i)
824                         if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
825                                 manager_add_job(u->meta.manager, JOB_STOP, other, JOB_REPLACE, true, NULL);
826         }
827
828         /* Garbage collect services that might not be needed anymore, if enabled */
829         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES], i)
830                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
831                         unit_check_uneeded(other);
832         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUIRES_OVERRIDABLE], i)
833                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
834                         unit_check_uneeded(other);
835         SET_FOREACH(other, u->meta.dependencies[UNIT_WANTS], i)
836                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
837                         unit_check_uneeded(other);
838         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE], i)
839                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
840                         unit_check_uneeded(other);
841         SET_FOREACH(other, u->meta.dependencies[UNIT_REQUISITE_OVERRIDABLE], i)
842                 if (!UNIT_IS_INACTIVE_OR_DEACTIVATING(unit_active_state(other)))
843                         unit_check_uneeded(other);
844 }
845
846 void unit_notify(Unit *u, UnitActiveState os, UnitActiveState ns) {
847         bool unexpected = false;
848
849         assert(u);
850         assert(os < _UNIT_ACTIVE_STATE_MAX);
851         assert(ns < _UNIT_ACTIVE_STATE_MAX);
852
853         /* Note that this is called for all low-level state changes,
854          * even if they might map to the same high-level
855          * UnitActiveState! That means that ns == os is OK an expected
856          * behaviour here. For example: if a mount point is remounted
857          * this function will be called too and the utmp code below
858          * relies on that! */
859
860         if (!UNIT_IS_ACTIVE_OR_RELOADING(os) && UNIT_IS_ACTIVE_OR_RELOADING(ns))
861                 u->meta.active_enter_timestamp = now(CLOCK_REALTIME);
862         else if (UNIT_IS_ACTIVE_OR_RELOADING(os) && !UNIT_IS_ACTIVE_OR_RELOADING(ns))
863                 u->meta.active_exit_timestamp = now(CLOCK_REALTIME);
864
865         if (u->meta.job) {
866
867                 if (u->meta.job->state == JOB_WAITING)
868
869                         /* So we reached a different state for this
870                          * job. Let's see if we can run it now if it
871                          * failed previously due to EAGAIN. */
872                         job_add_to_run_queue(u->meta.job);
873
874                 else {
875                         assert(u->meta.job->state == JOB_RUNNING);
876
877                         /* Let's check whether this state change
878                          * constitutes a finished job, or maybe
879                          * cotradicts a running job and hence needs to
880                          * invalidate jobs. */
881
882                         switch (u->meta.job->type) {
883
884                         case JOB_START:
885                         case JOB_VERIFY_ACTIVE:
886
887                                 if (UNIT_IS_ACTIVE_OR_RELOADING(ns))
888                                         job_finish_and_invalidate(u->meta.job, true);
889                                 else if (ns != UNIT_ACTIVATING) {
890                                         unexpected = true;
891                                         job_finish_and_invalidate(u->meta.job, false);
892                                 }
893
894                                 break;
895
896                         case JOB_RELOAD:
897                         case JOB_RELOAD_OR_START:
898
899                                 if (ns == UNIT_ACTIVE)
900                                         job_finish_and_invalidate(u->meta.job, true);
901                                 else if (ns != UNIT_ACTIVATING && ns != UNIT_ACTIVE_RELOADING) {
902                                         unexpected = true;
903                                         job_finish_and_invalidate(u->meta.job, false);
904                                 }
905
906                                 break;
907
908                         case JOB_STOP:
909                         case JOB_RESTART:
910                         case JOB_TRY_RESTART:
911
912                                 if (ns == UNIT_INACTIVE)
913                                         job_finish_and_invalidate(u->meta.job, true);
914                                 else if (ns != UNIT_DEACTIVATING) {
915                                         unexpected = true;
916                                         job_finish_and_invalidate(u->meta.job, false);
917                                 }
918
919                                 break;
920
921                         default:
922                                 assert_not_reached("Job type unknown");
923                         }
924                 }
925         }
926
927         /* If this state change happened without being requested by a
928          * job, then let's retroactively start or stop dependencies */
929
930         if (unexpected) {
931                 if (UNIT_IS_INACTIVE_OR_DEACTIVATING(os) && UNIT_IS_ACTIVE_OR_ACTIVATING(ns))
932                         retroactively_start_dependencies(u);
933                 else if (UNIT_IS_ACTIVE_OR_ACTIVATING(os) && UNIT_IS_INACTIVE_OR_DEACTIVATING(ns))
934                         retroactively_stop_dependencies(u);
935         }
936
937         /* Some names are special */
938         if (UNIT_IS_ACTIVE_OR_RELOADING(ns)) {
939                 if (unit_has_name(u, SPECIAL_DBUS_SERVICE)) {
940                         /* The bus just might have become available,
941                          * hence try to connect to it, if we aren't
942                          * yet connected. */
943                         bus_init_system(u->meta.manager);
944                         bus_init_api(u->meta.manager);
945                 }
946
947                 if (unit_has_name(u, SPECIAL_SYSLOG_SERVICE))
948                         /* The syslog daemon just might have become
949                          * available, hence try to connect to it, if
950                          * we aren't yet connected. */
951                         log_open_syslog();
952
953                 if (u->meta.type == UNIT_MOUNT)
954                         /* Another directory became available, let's
955                          * check if that is enough to write our utmp
956                          * entry. */
957                         manager_write_utmp_reboot(u->meta.manager);
958
959                 if (u->meta.type == UNIT_TARGET)
960                         /* A target got activated, maybe this is a runlevel? */
961                         manager_write_utmp_runlevel(u->meta.manager, u);
962
963         } else if (!UNIT_IS_ACTIVE_OR_RELOADING(ns)) {
964
965                 if (unit_has_name(u, SPECIAL_SYSLOG_SERVICE))
966                         /* The syslog daemon might just have
967                          * terminated, hence try to disconnect from
968                          * it. */
969                         log_close_syslog();
970
971                 /* We don't care about D-Bus here, since we'll get an
972                  * asynchronous notification for it anyway. */
973         }
974
975         /* Maybe we finished startup and are now ready for being
976          * stopped because unneeded? */
977         unit_check_uneeded(u);
978
979         unit_add_to_dbus_queue(u);
980 }
981
982 int unit_watch_fd(Unit *u, int fd, uint32_t events, Watch *w) {
983         struct epoll_event ev;
984
985         assert(u);
986         assert(fd >= 0);
987         assert(w);
988         assert(w->type == WATCH_INVALID || (w->type == WATCH_FD && w->fd == fd && w->data.unit == u));
989
990         zero(ev);
991         ev.data.ptr = w;
992         ev.events = events;
993
994         if (epoll_ctl(u->meta.manager->epoll_fd,
995                       w->type == WATCH_INVALID ? EPOLL_CTL_ADD : EPOLL_CTL_MOD,
996                       fd,
997                       &ev) < 0)
998                 return -errno;
999
1000         w->fd = fd;
1001         w->type = WATCH_FD;
1002         w->data.unit = u;
1003
1004         return 0;
1005 }
1006
1007 void unit_unwatch_fd(Unit *u, Watch *w) {
1008         assert(u);
1009         assert(w);
1010
1011         if (w->type == WATCH_INVALID)
1012                 return;
1013
1014         assert(w->type == WATCH_FD);
1015         assert(w->data.unit == u);
1016         assert_se(epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_DEL, w->fd, NULL) >= 0);
1017
1018         w->fd = -1;
1019         w->type = WATCH_INVALID;
1020         w->data.unit = NULL;
1021 }
1022
1023 int unit_watch_pid(Unit *u, pid_t pid) {
1024         assert(u);
1025         assert(pid >= 1);
1026
1027         /* Watch a specific PID. We only support one unit watching
1028          * each PID for now. */
1029
1030         return hashmap_put(u->meta.manager->watch_pids, UINT32_TO_PTR(pid), u);
1031 }
1032
1033 void unit_unwatch_pid(Unit *u, pid_t pid) {
1034         assert(u);
1035         assert(pid >= 1);
1036
1037         hashmap_remove_value(u->meta.manager->watch_pids, UINT32_TO_PTR(pid), u);
1038 }
1039
1040 int unit_watch_timer(Unit *u, usec_t delay, Watch *w) {
1041         struct itimerspec its;
1042         int flags, fd;
1043         bool ours;
1044
1045         assert(u);
1046         assert(w);
1047         assert(w->type == WATCH_INVALID || (w->type == WATCH_TIMER && w->data.unit == u));
1048
1049         /* This will try to reuse the old timer if there is one */
1050
1051         if (w->type == WATCH_TIMER) {
1052                 ours = false;
1053                 fd = w->fd;
1054         } else {
1055                 ours = true;
1056                 if ((fd = timerfd_create(CLOCK_MONOTONIC, TFD_NONBLOCK|TFD_CLOEXEC)) < 0)
1057                         return -errno;
1058         }
1059
1060         zero(its);
1061
1062         if (delay <= 0) {
1063                 /* Set absolute time in the past, but not 0, since we
1064                  * don't want to disarm the timer */
1065                 its.it_value.tv_sec = 0;
1066                 its.it_value.tv_nsec = 1;
1067
1068                 flags = TFD_TIMER_ABSTIME;
1069         } else {
1070                 timespec_store(&its.it_value, delay);
1071                 flags = 0;
1072         }
1073
1074         /* This will also flush the elapse counter */
1075         if (timerfd_settime(fd, flags, &its, NULL) < 0)
1076                 goto fail;
1077
1078         if (w->type == WATCH_INVALID) {
1079                 struct epoll_event ev;
1080
1081                 zero(ev);
1082                 ev.data.ptr = w;
1083                 ev.events = EPOLLIN;
1084
1085                 if (epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_ADD, fd, &ev) < 0)
1086                         goto fail;
1087         }
1088
1089         w->fd = fd;
1090         w->type = WATCH_TIMER;
1091         w->data.unit = u;
1092
1093         return 0;
1094
1095 fail:
1096         if (ours)
1097                 close_nointr_nofail(fd);
1098
1099         return -errno;
1100 }
1101
1102 void unit_unwatch_timer(Unit *u, Watch *w) {
1103         assert(u);
1104         assert(w);
1105
1106         if (w->type == WATCH_INVALID)
1107                 return;
1108
1109         assert(w->type == WATCH_TIMER && w->data.unit == u);
1110
1111         assert_se(epoll_ctl(u->meta.manager->epoll_fd, EPOLL_CTL_DEL, w->fd, NULL) >= 0);
1112         assert_se(close_nointr(w->fd) == 0);
1113
1114         w->fd = -1;
1115         w->type = WATCH_INVALID;
1116         w->data.unit = NULL;
1117 }
1118
1119 bool unit_job_is_applicable(Unit *u, JobType j) {
1120         assert(u);
1121         assert(j >= 0 && j < _JOB_TYPE_MAX);
1122
1123         switch (j) {
1124
1125         case JOB_VERIFY_ACTIVE:
1126         case JOB_START:
1127                 return true;
1128
1129         case JOB_STOP:
1130         case JOB_RESTART:
1131         case JOB_TRY_RESTART:
1132                 return unit_can_start(u);
1133
1134         case JOB_RELOAD:
1135                 return unit_can_reload(u);
1136
1137         case JOB_RELOAD_OR_START:
1138                 return unit_can_reload(u) && unit_can_start(u);
1139
1140         default:
1141                 assert_not_reached("Invalid job type");
1142         }
1143 }
1144
1145 int unit_add_dependency(Unit *u, UnitDependency d, Unit *other) {
1146
1147         static const UnitDependency inverse_table[_UNIT_DEPENDENCY_MAX] = {
1148                 [UNIT_REQUIRES] = UNIT_REQUIRED_BY,
1149                 [UNIT_REQUIRES_OVERRIDABLE] = UNIT_REQUIRED_BY_OVERRIDABLE,
1150                 [UNIT_WANTS] = UNIT_WANTED_BY,
1151                 [UNIT_REQUISITE] = UNIT_REQUIRED_BY,
1152                 [UNIT_REQUISITE_OVERRIDABLE] = UNIT_REQUIRED_BY_OVERRIDABLE,
1153                 [UNIT_REQUIRED_BY] = _UNIT_DEPENDENCY_INVALID,
1154                 [UNIT_REQUIRED_BY_OVERRIDABLE] = _UNIT_DEPENDENCY_INVALID,
1155                 [UNIT_WANTED_BY] = _UNIT_DEPENDENCY_INVALID,
1156                 [UNIT_CONFLICTS] = UNIT_CONFLICTS,
1157                 [UNIT_BEFORE] = UNIT_AFTER,
1158                 [UNIT_AFTER] = UNIT_BEFORE
1159         };
1160         int r;
1161
1162         assert(u);
1163         assert(d >= 0 && d < _UNIT_DEPENDENCY_MAX);
1164         assert(inverse_table[d] != _UNIT_DEPENDENCY_INVALID);
1165         assert(other);
1166
1167         /* We won't allow dependencies on ourselves. We will not
1168          * consider them an error however. */
1169         if (u == other)
1170                 return 0;
1171
1172         if (UNIT_VTABLE(u)->no_requires &&
1173             (d == UNIT_REQUIRES ||
1174              d == UNIT_REQUIRES_OVERRIDABLE ||
1175              d == UNIT_REQUISITE ||
1176              d == UNIT_REQUISITE_OVERRIDABLE)) {
1177                     return -EINVAL;
1178         }
1179
1180         if ((r = set_ensure_allocated(&u->meta.dependencies[d], trivial_hash_func, trivial_compare_func)) < 0)
1181                 return r;
1182
1183         if ((r = set_ensure_allocated(&other->meta.dependencies[inverse_table[d]], trivial_hash_func, trivial_compare_func)) < 0)
1184                 return r;
1185
1186         if ((r = set_put(u->meta.dependencies[d], other)) < 0)
1187                 return r;
1188
1189         if ((r = set_put(other->meta.dependencies[inverse_table[d]], u)) < 0) {
1190                 set_remove(u->meta.dependencies[d], other);
1191                 return r;
1192         }
1193
1194         unit_add_to_dbus_queue(u);
1195         return 0;
1196 }
1197
1198 static const char *resolve_template(Unit *u, const char *name, const char*path, char **p) {
1199         char *s;
1200
1201         assert(u);
1202         assert(name || path);
1203
1204         if (!name)
1205                 name = file_name_from_path(path);
1206
1207         if (!unit_name_is_template(name)) {
1208                 *p = NULL;
1209                 return name;
1210         }
1211
1212         if (u->meta.instance)
1213                 s = unit_name_replace_instance(name, u->meta.instance);
1214         else {
1215                 char *i;
1216
1217                 if (!(i = unit_name_to_prefix(u->meta.id)))
1218                         return NULL;
1219
1220                 s = unit_name_replace_instance(name, i);
1221                 free(i);
1222         }
1223
1224         if (!s)
1225                 return NULL;
1226
1227         *p = s;
1228         return s;
1229 }
1230
1231 int unit_add_dependency_by_name(Unit *u, UnitDependency d, const char *name, const char *path) {
1232         Unit *other;
1233         int r;
1234         char *s;
1235
1236         assert(u);
1237         assert(name || path);
1238
1239         if (!(name = resolve_template(u, name, path, &s)))
1240                 return -ENOMEM;
1241
1242         if ((r = manager_load_unit(u->meta.manager, name, path, &other)) < 0)
1243                 goto finish;
1244
1245         r = unit_add_dependency(u, d, other);
1246
1247 finish:
1248         free(s);
1249         return r;
1250 }
1251
1252 int unit_add_dependency_by_name_inverse(Unit *u, UnitDependency d, const char *name, const char *path) {
1253         Unit *other;
1254         int r;
1255         char *s;
1256
1257         assert(u);
1258         assert(name || path);
1259
1260         if (!(name = resolve_template(u, name, path, &s)))
1261                 return -ENOMEM;
1262
1263         if ((r = manager_load_unit(u->meta.manager, name, path, &other)) < 0)
1264                 goto finish;
1265
1266         r = unit_add_dependency(other, d, u);
1267
1268 finish:
1269         free(s);
1270         return r;
1271 }
1272
1273 int set_unit_path(const char *p) {
1274         char *cwd, *c;
1275         int r;
1276
1277         /* This is mostly for debug purposes */
1278
1279         if (path_is_absolute(p)) {
1280                 if (!(c = strdup(p)))
1281                         return -ENOMEM;
1282         } else {
1283                 if (!(cwd = get_current_dir_name()))
1284                         return -errno;
1285
1286                 r = asprintf(&c, "%s/%s", cwd, p);
1287                 free(cwd);
1288
1289                 if (r < 0)
1290                         return -ENOMEM;
1291         }
1292
1293         if (setenv("SYSTEMD_UNIT_PATH", c, 0) < 0) {
1294                 r = -errno;
1295                 free(c);
1296                 return r;
1297         }
1298
1299         return 0;
1300 }
1301
1302 char *unit_dbus_path(Unit *u) {
1303         char *p, *e;
1304
1305         assert(u);
1306
1307         if (!(e = bus_path_escape(u->meta.id)))
1308                 return NULL;
1309
1310         if (asprintf(&p, "/org/freedesktop/systemd1/unit/%s", e) < 0) {
1311                 free(e);
1312                 return NULL;
1313         }
1314
1315         free(e);
1316         return p;
1317 }
1318
1319 int unit_add_cgroup(Unit *u, CGroupBonding *b) {
1320         CGroupBonding *l;
1321         int r;
1322
1323         assert(u);
1324         assert(b);
1325         assert(b->path);
1326
1327         /* Ensure this hasn't been added yet */
1328         assert(!b->unit);
1329
1330         l = hashmap_get(u->meta.manager->cgroup_bondings, b->path);
1331         LIST_PREPEND(CGroupBonding, by_path, l, b);
1332
1333         if ((r = hashmap_replace(u->meta.manager->cgroup_bondings, b->path, l)) < 0) {
1334                 LIST_REMOVE(CGroupBonding, by_path, l, b);
1335                 return r;
1336         }
1337
1338         LIST_PREPEND(CGroupBonding, by_unit, u->meta.cgroup_bondings, b);
1339         b->unit = u;
1340
1341         return 0;
1342 }
1343
1344 static char *default_cgroup_path(Unit *u) {
1345         char *p;
1346         int r;
1347
1348         assert(u);
1349
1350         if (u->meta.instance) {
1351                 char *t;
1352
1353                 if (!(t = unit_name_template(u->meta.id)))
1354                         return NULL;
1355
1356                 r = asprintf(&p, "%s/%s/%s", u->meta.manager->cgroup_hierarchy, t, u->meta.instance);
1357                 free(t);
1358         } else
1359                 r = asprintf(&p, "%s/%s", u->meta.manager->cgroup_hierarchy, u->meta.id);
1360
1361         return r < 0 ? NULL : p;
1362 }
1363
1364 int unit_add_cgroup_from_text(Unit *u, const char *name) {
1365         size_t n;
1366         char *controller = NULL, *path = NULL;
1367         CGroupBonding *b = NULL;
1368         int r;
1369
1370         assert(u);
1371         assert(name);
1372
1373         /* Detect controller name */
1374         n = strcspn(name, ":");
1375
1376         if (name[n] == 0 ||
1377             (name[n] == ':' && name[n+1] == 0)) {
1378
1379                 /* Only controller name, no path? */
1380
1381                 if (!(path = default_cgroup_path(u)))
1382                         return -ENOMEM;
1383
1384         } else {
1385                 const char *p;
1386
1387                 /* Controller name, and path. */
1388                 p = name+n+1;
1389
1390                 if (!path_is_absolute(p))
1391                         return -EINVAL;
1392
1393                 if (!(path = strdup(p)))
1394                         return -ENOMEM;
1395         }
1396
1397         if (n > 0)
1398                 controller = strndup(name, n);
1399         else
1400                 controller = strdup(u->meta.manager->cgroup_controller);
1401
1402         if (!controller) {
1403                 r = -ENOMEM;
1404                 goto fail;
1405         }
1406
1407         if (cgroup_bonding_find_list(u->meta.cgroup_bondings, controller)) {
1408                 r = -EEXIST;
1409                 goto fail;
1410         }
1411
1412         if (!(b = new0(CGroupBonding, 1))) {
1413                 r = -ENOMEM;
1414                 goto fail;
1415         }
1416
1417         b->controller = controller;
1418         b->path = path;
1419         b->only_us = false;
1420         b->clean_up = false;
1421
1422         if ((r = unit_add_cgroup(u, b)) < 0)
1423                 goto fail;
1424
1425         return 0;
1426
1427 fail:
1428         free(path);
1429         free(controller);
1430         free(b);
1431
1432         return r;
1433 }
1434
1435 int unit_add_default_cgroup(Unit *u) {
1436         CGroupBonding *b;
1437         int r = -ENOMEM;
1438
1439         assert(u);
1440
1441         /* Adds in the default cgroup data, if it wasn't specified yet */
1442
1443         if (unit_get_default_cgroup(u))
1444                 return 0;
1445
1446         if (!(b = new0(CGroupBonding, 1)))
1447                 return -ENOMEM;
1448
1449         if (!(b->controller = strdup(u->meta.manager->cgroup_controller)))
1450                 goto fail;
1451
1452         if (!(b->path = default_cgroup_path(u)))
1453                 goto fail;
1454
1455         b->clean_up = true;
1456         b->only_us = true;
1457
1458         if ((r = unit_add_cgroup(u, b)) < 0)
1459                 goto fail;
1460
1461         return 0;
1462
1463 fail:
1464         free(b->path);
1465         free(b->controller);
1466         free(b);
1467
1468         return r;
1469 }
1470
1471 CGroupBonding* unit_get_default_cgroup(Unit *u) {
1472         assert(u);
1473
1474         return cgroup_bonding_find_list(u->meta.cgroup_bondings, u->meta.manager->cgroup_controller);
1475 }
1476
1477 int unit_load_related_unit(Unit *u, const char *type, Unit **_found) {
1478         char *t;
1479         int r;
1480
1481         assert(u);
1482         assert(type);
1483         assert(_found);
1484
1485         if (!(t = unit_name_change_suffix(u->meta.id, type)))
1486                 return -ENOMEM;
1487
1488         assert(!unit_has_name(u, t));
1489
1490         r = manager_load_unit(u->meta.manager, t, NULL, _found);
1491         free(t);
1492
1493         assert(r < 0 || *_found != u);
1494
1495         return r;
1496 }
1497
1498 static char *specifier_prefix_and_instance(char specifier, void *data, void *userdata) {
1499         Unit *u = userdata;
1500         assert(u);
1501
1502         return unit_name_to_prefix_and_instance(u->meta.id);
1503 }
1504
1505 static char *specifier_prefix(char specifier, void *data, void *userdata) {
1506         Unit *u = userdata;
1507         assert(u);
1508
1509         return unit_name_to_prefix(u->meta.id);
1510 }
1511
1512 static char *specifier_prefix_unescaped(char specifier, void *data, void *userdata) {
1513         Unit *u = userdata;
1514         char *p, *r;
1515
1516         assert(u);
1517
1518         if (!(p = unit_name_to_prefix(u->meta.id)))
1519                 return NULL;
1520
1521         r = unit_name_unescape(p);
1522         free(p);
1523
1524         return r;
1525 }
1526
1527 static char *specifier_instance_unescaped(char specifier, void *data, void *userdata) {
1528         Unit *u = userdata;
1529         assert(u);
1530
1531         if (u->meta.instance)
1532                 return unit_name_unescape(u->meta.instance);
1533
1534         return strdup("");
1535 }
1536
1537 char *unit_name_printf(Unit *u, const char* format) {
1538
1539         /*
1540          * This will use the passed string as format string and
1541          * replace the following specifiers:
1542          *
1543          * %n: the full id of the unit                 (foo@bar.waldo)
1544          * %N: the id of the unit without the suffix   (foo@bar)
1545          * %p: the prefix                              (foo)
1546          * %i: the instance                            (bar)
1547          */
1548
1549         const Specifier table[] = {
1550                 { 'n', specifier_string,              u->meta.id },
1551                 { 'N', specifier_prefix_and_instance, NULL },
1552                 { 'p', specifier_prefix,              NULL },
1553                 { 'i', specifier_string,              u->meta.instance },
1554                 { 0, NULL, NULL }
1555         };
1556
1557         assert(u);
1558         assert(format);
1559
1560         return specifier_printf(format, table, u);
1561 }
1562
1563 char *unit_full_printf(Unit *u, const char *format) {
1564
1565         /* This is similar to unit_name_printf() but also supports
1566          * unescaping */
1567
1568         const Specifier table[] = {
1569                 { 'n', specifier_string,              u->meta.id },
1570                 { 'N', specifier_prefix_and_instance, NULL },
1571                 { 'p', specifier_prefix,              NULL },
1572                 { 'P', specifier_prefix_unescaped,    NULL },
1573                 { 'i', specifier_string,              u->meta.instance },
1574                 { 'I', specifier_instance_unescaped,  NULL },
1575                 { 0, NULL, NULL }
1576         };
1577
1578         assert(u);
1579         assert(format);
1580
1581         return specifier_printf(format, table, u);
1582 }
1583
1584 char **unit_full_printf_strv(Unit *u, char **l) {
1585         size_t n;
1586         char **r, **i, **j;
1587
1588         /* Applies unit_full_printf to every entry in l */
1589
1590         assert(u);
1591
1592         n = strv_length(l);
1593         if (!(r = new(char*, n+1)))
1594                 return NULL;
1595
1596         for (i = l, j = r; *i; i++, j++)
1597                 if (!(*j = unit_full_printf(u, *i)))
1598                         goto fail;
1599
1600         *j = NULL;
1601         return r;
1602
1603 fail:
1604         j--;
1605         while (j >= r)
1606                 free(*j);
1607
1608         free(r);
1609
1610         return NULL;
1611 }
1612
1613 int unit_watch_bus_name(Unit *u, const char *name) {
1614         assert(u);
1615         assert(name);
1616
1617         /* Watch a specific name on the bus. We only support one unit
1618          * watching each name for now. */
1619
1620         return hashmap_put(u->meta.manager->watch_bus, name, u);
1621 }
1622
1623 void unit_unwatch_bus_name(Unit *u, const char *name) {
1624         assert(u);
1625         assert(name);
1626
1627         hashmap_remove_value(u->meta.manager->watch_bus, name, u);
1628 }
1629
1630 static const char* const unit_type_table[_UNIT_TYPE_MAX] = {
1631         [UNIT_SERVICE] = "service",
1632         [UNIT_TIMER] = "timer",
1633         [UNIT_SOCKET] = "socket",
1634         [UNIT_TARGET] = "target",
1635         [UNIT_DEVICE] = "device",
1636         [UNIT_MOUNT] = "mount",
1637         [UNIT_AUTOMOUNT] = "automount",
1638         [UNIT_SNAPSHOT] = "snapshot"
1639 };
1640
1641 DEFINE_STRING_TABLE_LOOKUP(unit_type, UnitType);
1642
1643 static const char* const unit_load_state_table[_UNIT_LOAD_STATE_MAX] = {
1644         [UNIT_STUB] = "stub",
1645         [UNIT_LOADED] = "loaded",
1646         [UNIT_FAILED] = "failed",
1647         [UNIT_MERGED] = "merged"
1648 };
1649
1650 DEFINE_STRING_TABLE_LOOKUP(unit_load_state, UnitLoadState);
1651
1652 static const char* const unit_active_state_table[_UNIT_ACTIVE_STATE_MAX] = {
1653         [UNIT_ACTIVE] = "active",
1654         [UNIT_INACTIVE] = "inactive",
1655         [UNIT_ACTIVATING] = "activating",
1656         [UNIT_DEACTIVATING] = "deactivating"
1657 };
1658
1659 DEFINE_STRING_TABLE_LOOKUP(unit_active_state, UnitActiveState);
1660
1661 static const char* const unit_dependency_table[_UNIT_DEPENDENCY_MAX] = {
1662         [UNIT_REQUIRES] = "Requires",
1663         [UNIT_REQUIRES_OVERRIDABLE] = "RequiresOverridable",
1664         [UNIT_WANTS] = "Wants",
1665         [UNIT_REQUISITE] = "Requisite",
1666         [UNIT_REQUISITE_OVERRIDABLE] = "RequisiteOverridable",
1667         [UNIT_REQUIRED_BY] = "RequiredBy",
1668         [UNIT_REQUIRED_BY_OVERRIDABLE] = "RequiredByOverridable",
1669         [UNIT_WANTED_BY] = "WantedBy",
1670         [UNIT_CONFLICTS] = "Conflicts",
1671         [UNIT_BEFORE] = "Before",
1672         [UNIT_AFTER] = "After",
1673 };
1674
1675 DEFINE_STRING_TABLE_LOOKUP(unit_dependency, UnitDependency);
1676
1677 static const char* const kill_mode_table[_KILL_MODE_MAX] = {
1678         [KILL_CONTROL_GROUP] = "control-group",
1679         [KILL_PROCESS_GROUP] = "process-group",
1680         [KILL_PROCESS] = "process",
1681         [KILL_NONE] = "none"
1682 };
1683
1684 DEFINE_STRING_TABLE_LOOKUP(kill_mode, KillMode);