1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
7 This file is part of systemd.
9 Copyright 2010 Lennart Poettering
11 systemd is free software; you can redistribute it and/or modify it
12 under the terms of the GNU Lesser General Public License as published by
13 the Free Software Foundation; either version 2.1 of the License, or
14 (at your option) any later version.
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 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public License
22 along with systemd; If not, see <http://www.gnu.org/licenses/>.
29 typedef struct Job Job
;
30 typedef struct JobDependency JobDependency
;
31 typedef struct JobBusClient JobBusClient
;
32 typedef enum JobType JobType
;
33 typedef enum JobState JobState
;
34 typedef enum JobMode JobMode
;
35 typedef enum JobResult JobResult
;
42 /* Be careful when changing the job types! Adjust job_merging_table[] accordingly! */
44 JOB_START
, /* if a unit does not support being started, we'll just wait until it becomes active */
49 JOB_RELOAD
, /* if running reload */
50 JOB_RELOAD_OR_START
, /* if running reload, if not running start */
52 /* Note that restarts are first treated like JOB_STOP, but
53 * then instead of finishing are patched to become
55 JOB_RESTART
, /* if running stop, then start unconditionally */
56 JOB_TRY_RESTART
, /* if running stop and then start */
59 _JOB_TYPE_INVALID
= -1
66 _JOB_STATE_INVALID
= -1
70 JOB_FAIL
, /* Fail if a conflicting job is already queued */
71 JOB_REPLACE
, /* Replace an existing conflicting job */
72 JOB_ISOLATE
, /* Start a unit, and stop all others */
73 JOB_IGNORE_DEPENDENCIES
, /* Ignore both requirement and ordering dependencies */
74 JOB_IGNORE_REQUIREMENTS
, /* Ignore requirement dependencies */
76 _JOB_MODE_INVALID
= -1
87 _JOB_RESULT_INVALID
= -1
90 struct JobDependency
{
91 /* Encodes that the 'subject' job needs the 'object' job in
92 * some way. This structure is used only while building a transaction. */
96 LIST_FIELDS(JobDependency
, subject
);
97 LIST_FIELDS(JobDependency
, object
);
103 struct JobBusClient
{
104 LIST_FIELDS(JobBusClient
, client
);
105 /* Note that this bus object is not ref counted here. */
114 LIST_FIELDS(Job
, transaction
);
115 LIST_FIELDS(Job
, run_queue
);
116 LIST_FIELDS(Job
, dbus_queue
);
118 LIST_HEAD(JobDependency
, subject_list
);
119 LIST_HEAD(JobDependency
, object_list
);
121 /* Used for graph algs as a "I have been here" marker */
132 /* There can be more than one client, because of job merging. */
133 LIST_HEAD(JobBusClient
, bus_client_list
);
139 bool matters_to_anchor
:1;
141 bool in_dbus_queue
:1;
142 bool sent_dbus_new_signal
:1;
146 JobBusClient
* job_bus_client_new(DBusConnection
*connection
, const char *name
);
148 Job
* job_new(Unit
*unit
, JobType type
);
149 void job_free(Job
*job
);
150 Job
* job_install(Job
*j
);
151 void job_uninstall(Job
*j
);
152 void job_dump(Job
*j
, FILE*f
, const char *prefix
);
154 JobDependency
* job_dependency_new(Job
*subject
, Job
*object
, bool matters
, bool conflicts
);
155 void job_dependency_free(JobDependency
*l
);
157 int job_merge(Job
*j
, Job
*other
);
159 JobType
job_type_lookup_merge(JobType a
, JobType b
);
161 static inline int job_type_merge(JobType
*a
, JobType b
) {
162 JobType t
= job_type_lookup_merge(*a
, b
);
169 static inline bool job_type_is_mergeable(JobType a
, JobType b
) {
170 return job_type_lookup_merge(a
, b
) >= 0;
173 static inline bool job_type_is_conflicting(JobType a
, JobType b
) {
174 return !job_type_is_mergeable(a
, b
);
177 static inline bool job_type_is_superset(JobType a
, JobType b
) {
178 /* Checks whether operation a is a "superset" of b in its actions */
179 return a
== job_type_lookup_merge(a
, b
);
182 bool job_type_is_redundant(JobType a
, UnitActiveState b
);
184 bool job_is_runnable(Job
*j
);
186 void job_add_to_run_queue(Job
*j
);
187 void job_add_to_dbus_queue(Job
*j
);
189 int job_start_timer(Job
*j
);
190 void job_timer_event(Job
*j
, uint64_t n_elapsed
, Watch
*w
);
192 int job_run_and_invalidate(Job
*j
);
193 int job_finish_and_invalidate(Job
*j
, JobResult result
);
195 char *job_dbus_path(Job
*j
);
197 const char* job_type_to_string(JobType t
);
198 JobType
job_type_from_string(const char *s
);
200 const char* job_state_to_string(JobState t
);
201 JobState
job_state_from_string(const char *s
);
203 const char* job_mode_to_string(JobMode t
);
204 JobMode
job_mode_from_string(const char *s
);
206 const char* job_result_to_string(JobResult t
);
207 JobResult
job_result_from_string(const char *s
);