src/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 #include <dbus/dbus.h>
  29
  30 #include "fdset.h"
  31
  32 /* Enforce upper limit how many names we allow */
  33 #define MANAGER_MAX_NAMES 2048
  34
  35 typedef struct Manager Manager;
  36 typedef enum WatchType WatchType;
  37 typedef struct Watch Watch;
  38
  39 typedef enum ManagerExitCode {
  40         MANAGER_RUNNING,
  41         MANAGER_EXIT,
  42         MANAGER_RELOAD,
  43         MANAGER_REEXECUTE,
  44         _MANAGER_EXIT_CODE_MAX,
  45         _MANAGER_EXIT_CODE_INVALID = -1
  46 } ManagerExitCode;
  47
  48 typedef enum ManagerRunningAs {
  49         MANAGER_SYSTEM,
  50         MANAGER_SESSION,
  51         _MANAGER_RUNNING_AS_MAX,
  52         _MANAGER_RUNNING_AS_INVALID = -1
  53 } ManagerRunningAs;
  54
  55 enum WatchType {
  56         WATCH_INVALID,
  57         WATCH_SIGNAL,
  58         WATCH_NOTIFY,
  59         WATCH_FD,
  60         WATCH_TIMER,
  61         WATCH_MOUNT,
  62         WATCH_UDEV,
  63         WATCH_DBUS_WATCH,
  64         WATCH_DBUS_TIMEOUT
  65 };
  66
  67 struct Watch {
  68         int fd;
  69         WatchType type;
  70         union {
  71                 union Unit *unit;
  72                 DBusWatch *bus_watch;
  73                 DBusTimeout *bus_timeout;
  74         } data;
  75         bool fd_is_dupped:1;
  76         bool socket_accept:1;
  77 };
  78
  79 #include "unit.h"
  80 #include "job.h"
  81 #include "hashmap.h"
  82 #include "list.h"
  83 #include "set.h"
  84 #include "dbus.h"
  85 #include "path-lookup.h"
  86
  87 struct Manager {
  88         uint32_t current_job_id;
  89
  90         /* Note that the set of units we know of is allowed to be
  91          * incosistent. However the subset of it that is loaded may
  92          * not, and the list of jobs may neither. */
  93
  94         /* Active jobs and units */
  95         Hashmap *units;  /* name string => Unit object n:1 */
  96         Hashmap *jobs;   /* job id => Job object 1:1 */
  97
  98         /* To make it easy to iterate through the units of a specific
  99          * type we maintain a per type linked list */
 100         LIST_HEAD(Meta, units_per_type[_UNIT_TYPE_MAX]);
 101
 102         /* Units that need to be loaded */
 103         LIST_HEAD(Meta, load_queue); /* this is actually more a stack than a queue, but uh. */
 104
 105         /* Jobs that need to be run */
 106         LIST_HEAD(Job, run_queue);   /* more a stack than a queue, too */
 107
 108         /* Units and jobs that have not yet been announced via
 109          * D-Bus. When something about a job changes it is added here
 110          * if it is not in there yet. This allows easy coalescing of
 111          * D-Bus change signals. */
 112         LIST_HEAD(Meta, dbus_unit_queue);
 113         LIST_HEAD(Job, dbus_job_queue);
 114
 115         /* Units to remove */
 116         LIST_HEAD(Meta, cleanup_queue);
 117
 118         /* Units to check when doing GC */
 119         LIST_HEAD(Meta, gc_queue);
 120
 121         /* Jobs to be added */
 122         Hashmap *transaction_jobs;      /* Unit object => Job object list 1:1 */
 123         JobDependency *transaction_anchor;
 124
 125         Hashmap *watch_pids;  /* pid => Unit object n:1 */
 126
 127         char *notify_socket;
 128
 129         Watch notify_watch;
 130         Watch signal_watch;
 131
 132         int epoll_fd;
 133
 134         unsigned n_snapshots;
 135
 136         LookupPaths lookup_paths;
 137
 138         char **environment;
 139
 140         dual_timestamp startup_timestamp;
 141
 142         /* Data specific to the device subsystem */
 143         struct udev* udev;
 144         struct udev_monitor* udev_monitor;
 145         Watch udev_watch;
 146
 147         /* Data specific to the mount subsystem */
 148         FILE *proc_self_mountinfo;
 149         Watch mount_watch;
 150
 151         /* Data specific to the swap filesystem */
 152         FILE *proc_swaps;
 153
 154         /* Data specific to the D-Bus subsystem */
 155         DBusConnection *api_bus, *system_bus;
 156         DBusServer *private_bus;
 157         Set *bus_connections, *bus_connections_for_dispatch;
 158
 159         DBusMessage *queued_message; /* This is used during reloading:
 160                                       * before the reload we queue the
 161                                       * reply message here, and
 162                                       * afterwards we send it */
 163         DBusConnection *queued_message_connection; /* The connection to send the queued message on */
 164
 165         Hashmap *watch_bus;  /* D-Bus names => Unit object n:1 */
 166         int32_t name_data_slot;
 167         int32_t subscribed_data_slot;
 168
 169         /* Data specific to the Automount subsystem */
 170         int dev_autofs_fd;
 171
 172         /* Data specific to the cgroup subsystem */
 173         Hashmap *cgroup_bondings; /* path string => CGroupBonding object 1:n */
 174         char *cgroup_hierarchy;
 175
 176         usec_t gc_queue_timestamp;
 177         int gc_marker;
 178         unsigned n_in_gc_queue;
 179
 180         /* Make sure the user cannot accidentaly unmount our cgroup
 181          * file system */
 182         int pin_cgroupfs_fd;
 183
 184         /* Flags */
 185         ManagerRunningAs running_as;
 186         ManagerExitCode exit_code:4;
 187
 188         bool dispatching_load_queue:1;
 189         bool dispatching_run_queue:1;
 190         bool dispatching_dbus_queue:1;
 191
 192         bool utmp_reboot_written:1;
 193
 194         bool deserializing:1;
 195
 196         bool show_status;
 197         bool confirm_spawn;
 198 };
 199
 200 int manager_new(ManagerRunningAs running_as, Manager **m);
 201 void manager_free(Manager *m);
 202
 203 int manager_enumerate(Manager *m);
 204 int manager_coldplug(Manager *m);
 205 int manager_startup(Manager *m, FILE *serialization, FDSet *fds);
 206
 207 Job *manager_get_job(Manager *m, uint32_t id);
 208 Unit *manager_get_unit(Manager *m, const char *name);
 209
 210 int manager_get_unit_from_dbus_path(Manager *m, const char *s, Unit **_u);
 211 int manager_get_job_from_dbus_path(Manager *m, const char *s, Job **_j);
 212
 213 int manager_load_unit_prepare(Manager *m, const char *name, const char *path, DBusError *e, Unit **_ret);
 214 int manager_load_unit(Manager *m, const char *name, const char *path, DBusError *e, Unit **_ret);
 215
 216 int manager_add_job(Manager *m, JobType type, Unit *unit, JobMode mode, bool force, DBusError *e, Job **_ret);
 217 int manager_add_job_by_name(Manager *m, JobType type, const char *name, JobMode mode, bool force, DBusError *e, Job **_ret);
 218
 219 void manager_dump_units(Manager *s, FILE *f, const char *prefix);
 220 void manager_dump_jobs(Manager *s, FILE *f, const char *prefix);
 221
 222 void manager_transaction_unlink_job(Manager *m, Job *j, bool delete_dependencies);
 223
 224 void manager_clear_jobs(Manager *m);
 225
 226 unsigned manager_dispatch_load_queue(Manager *m);
 227 unsigned manager_dispatch_run_queue(Manager *m);
 228 unsigned manager_dispatch_dbus_queue(Manager *m);
 229
 230 int manager_loop(Manager *m);
 231
 232 void manager_write_utmp_reboot(Manager *m);
 233 void manager_write_utmp_runlevel(Manager *m, Unit *t);
 234
 235 void manager_dispatch_bus_name_owner_changed(Manager *m, const char *name, const char* old_owner, const char *new_owner);
 236 void manager_dispatch_bus_query_pid_done(Manager *m, const char *name, pid_t pid);
 237
 238 int manager_open_serialization(FILE **_f);
 239
 240 int manager_serialize(Manager *m, FILE *f, FDSet *fds);
 241 int manager_deserialize(Manager *m, FILE *f, FDSet *fds);
 242
 243 int manager_reload(Manager *m);
 244
 245 bool manager_is_booting_or_shutting_down(Manager *m);
 246
 247 const char *manager_running_as_to_string(ManagerRunningAs i);
 248 ManagerRunningAs manager_running_as_from_string(const char *s);
 249
 250 #endif