manager.h

   1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
   2
   3 #ifndef foomanagerhfoo
   4 #define foomanagerhfoo
   5
   6 /***
   7   This file is part of systemd.
   8
   9   Copyright 2010 Lennart Poettering
  10
  11   systemd is free software; you can redistribute it and/or modify it
  12   under the terms of the GNU General Public License as published by
  13   the Free Software Foundation; either version 2 of the License, or
  14   (at your option) any later version.
  15
  16   systemd is distributed in the hope that it will be useful, but
  17   WITHOUT ANY WARRANTY; without even the implied warranty of
  18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19   General Public License for more details.
  20
  21   You should have received a copy of the GNU General Public License
  22   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  23 ***/
  24
  25 #include <stdbool.h>
  26 #include <inttypes.h>
  27 #include <stdio.h>
  28
  29 #include <dbus/dbus.h>
  30
  31 typedef struct Manager Manager;
  32 typedef enum WatchType WatchType;
  33 typedef struct Watch Watch;
  34
  35 enum WatchType {
  36         WATCH_INVALID,
  37         WATCH_SIGNAL,
  38         WATCH_FD,
  39         WATCH_TIMER,
  40         WATCH_MOUNT,
  41         WATCH_UDEV,
  42         WATCH_DBUS_WATCH,
  43         WATCH_DBUS_TIMEOUT
  44 };
  45
  46 struct Watch {
  47         int fd;
  48         WatchType type;
  49         bool fd_is_dupped;
  50         union {
  51                 union Unit *unit;
  52                 DBusWatch *bus_watch;
  53                 DBusTimeout *bus_timeout;
  54         } data;
  55 };
  56
  57 #include "unit.h"
  58 #include "job.h"
  59 #include "hashmap.h"
  60 #include "list.h"
  61 #include "set.h"
  62 #include "dbus.h"
  63
  64 #define SPECIAL_DEFAULT_TARGET "default.target"
  65 #define SPECIAL_SYSLOG_SERVICE "syslog.service"
  66 #define SPECIAL_DBUS_SERVICE "messagebus.service"
  67 #define SPECIAL_LOGGER_SOCKET "systemd-logger.socket"
  68 #define SPECIAL_KBREQUEST_TARGET "kbrequest.target"
  69 #define SPECIAL_CTRL_ALT_DEL_TARGET "ctrl-alt-del.target"
  70
  71 struct Manager {
  72         uint32_t current_job_id;
  73
  74         /* Note that the set of units we know of is allowed to be
  75          * incosistent. However the subset of it that is loaded may
  76          * not, and the list of jobs may neither. */
  77
  78         /* Active jobs and units */
  79         Hashmap *units;  /* name string => Unit object n:1 */
  80         Hashmap *jobs;   /* job id => Job object 1:1 */
  81
  82         /* To make it easy to iterate through the units of a specific
  83          * type we maintain a per type linked list */
  84         LIST_HEAD(Meta, units_per_type[_UNIT_TYPE_MAX]);
  85
  86         /* Units that need to be loaded */
  87         LIST_HEAD(Meta, load_queue); /* this is actually more a stack than a queue, but uh. */
  88
  89         /* Jobs that need to be run */
  90         LIST_HEAD(Job, run_queue);   /* more a stack than a queue, too */
  91
  92         /* Units and jobs that have not yet been announced via
  93          * D-Bus. When something about a job changes it is added here
  94          * if it is not in there yet. This allows easy coalescing of
  95          * D-Bus change signals. */
  96         LIST_HEAD(Meta, dbus_unit_queue);
  97         LIST_HEAD(Job, dbus_job_queue);
  98
  99         /* Jobs to be added */
 100         Hashmap *transaction_jobs;      /* Unit object => Job object list 1:1 */
 101         JobDependency *transaction_anchor;
 102
 103         bool dispatching_load_queue:1;
 104         bool dispatching_run_queue:1;
 105         bool dispatching_dbus_queue:1;
 106
 107         bool is_init:1;
 108
 109         bool request_bus_dispatch:1;
 110
 111         Hashmap *watch_pids;  /* pid => Unit object n:1 */
 112
 113         int epoll_fd;
 114
 115         Watch signal_watch;
 116
 117         /* Data specific to the device subsystem */
 118         struct udev* udev;
 119         struct udev_monitor* udev_monitor;
 120         Watch udev_watch;
 121
 122         /* Data specific to the mount subsystem */
 123         FILE *proc_self_mountinfo;
 124         Watch mount_watch;
 125
 126         /* Data specific to the D-Bus subsystem */
 127         DBusConnection *bus;
 128         Set *subscribed;
 129 };
 130
 131 Manager* manager_new(void);
 132 void manager_free(Manager *m);
 133
 134 int manager_coldplug(Manager *m);
 135
 136 Job *manager_get_job(Manager *m, uint32_t id);
 137 Unit *manager_get_unit(Manager *m, const char *name);
 138
 139 int manager_get_unit_from_dbus_path(Manager *m, const char *s, Unit **_u);
 140 int manager_get_job_from_dbus_path(Manager *m, const char *s, Job **_j);
 141
 142 int manager_load_unit(Manager *m, const char *path_or_name, Unit **_ret);
 143 int manager_add_job(Manager *m, JobType type, Unit *unit, JobMode mode, bool force, Job **_ret);
 144
 145 void manager_dump_units(Manager *s, FILE *f, const char *prefix);
 146 void manager_dump_jobs(Manager *s, FILE *f, const char *prefix);
 147
 148 void manager_transaction_unlink_job(Manager *m, Job *j);
 149
 150 void manager_clear_jobs(Manager *m);
 151
 152 unsigned manager_dispatch_load_queue(Manager *m);
 153 unsigned manager_dispatch_run_queue(Manager *m);
 154 unsigned manager_dispatch_dbus_queue(Manager *m);
 155
 156 int manager_loop(Manager *m);
 157
 158 #endif