1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
6 This file is part of systemd.
8 Copyright 2010 Lennart Poettering
10 systemd is free software; you can redistribute it and/or modify it
11 under the terms of the GNU Lesser General Public License as published by
12 the Free Software Foundation; either version 2.1 of the License, or
13 (at your option) any later version.
15 systemd is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public License
21 along with systemd; If not, see <http://www.gnu.org/licenses/>.
30 typedef struct Job Job
;
31 typedef struct JobDependency JobDependency
;
32 typedef enum JobType JobType
;
33 typedef enum JobState JobState
;
34 typedef enum JobMode JobMode
;
35 typedef enum JobResult JobResult
;
37 /* Be careful when changing the job types! Adjust job_merging_table[] accordingly! */
39 JOB_START
, /* if a unit does not support being started, we'll just wait until it becomes active */
44 JOB_RELOAD
, /* if running, reload */
46 /* Note that restarts are first treated like JOB_STOP, but
47 * then instead of finishing are patched to become
49 JOB_RESTART
, /* If running, stop. Then start unconditionally. */
51 _JOB_TYPE_MAX_MERGING
,
53 /* JOB_NOP can enter into a transaction, but as it won't pull in
54 * any dependencies and it uses the special 'nop_job' slot in Unit,
55 * it won't have to merge with anything (except possibly into another
56 * JOB_NOP, previously installed). JOB_NOP is special-cased in
57 * job_type_is_*() functions so that the transaction can be
59 JOB_NOP
= _JOB_TYPE_MAX_MERGING
, /* do nothing */
61 _JOB_TYPE_MAX_IN_TRANSACTION
,
63 /* JOB_TRY_RESTART can never appear in a transaction, because
64 * it always collapses into JOB_RESTART or JOB_NOP before entering.
65 * Thus we never need to merge it with anything. */
66 JOB_TRY_RESTART
= _JOB_TYPE_MAX_IN_TRANSACTION
, /* if running, stop and then start */
68 /* JOB_RELOAD_OR_START won't enter into a transaction and cannot result
69 * from transaction merging (there's no way for JOB_RELOAD and
70 * JOB_START to meet in one transaction). It can result from a merge
71 * during job installation, but then it will immediately collapse into
72 * one of the two simpler types. */
73 JOB_RELOAD_OR_START
, /* if running, reload, otherwise start */
76 _JOB_TYPE_INVALID
= -1
83 _JOB_STATE_INVALID
= -1
87 JOB_FAIL
, /* Fail if a conflicting job is already queued */
88 JOB_REPLACE
, /* Replace an existing conflicting job */
89 JOB_REPLACE_IRREVERSIBLY
,/* Like JOB_REPLACE + produce irreversible jobs */
90 JOB_ISOLATE
, /* Start a unit, and stop all others */
91 JOB_FLUSH
, /* Flush out all other queued jobs when queing this one */
92 JOB_IGNORE_DEPENDENCIES
, /* Ignore both requirement and ordering dependencies */
93 JOB_IGNORE_REQUIREMENTS
, /* Ignore requirement dependencies */
95 _JOB_MODE_INVALID
= -1
99 JOB_DONE
, /* Job completed successfully */
100 JOB_CANCELED
, /* Job canceled by a conflicting job installation or by explicit cancel request */
101 JOB_TIMEOUT
, /* Job timeout elapsed */
102 JOB_FAILED
, /* Job failed */
103 JOB_DEPENDENCY
, /* A required dependency job did not result in JOB_DONE */
104 JOB_SKIPPED
, /* Negative result of JOB_VERIFY_ACTIVE */
105 JOB_INVALID
, /* JOB_RELOAD of inactive unit */
106 JOB_ASSERT
, /* Couldn't start a unit, because an assert didn't hold */
107 JOB_UNSUPPORTED
, /* Couldn't start a unit, because the unit type is not supported on the system */
109 _JOB_RESULT_INVALID
= -1
114 struct JobDependency
{
115 /* Encodes that the 'subject' job needs the 'object' job in
116 * some way. This structure is used only while building a transaction. */
120 LIST_FIELDS(JobDependency
, subject
);
121 LIST_FIELDS(JobDependency
, object
);
131 LIST_FIELDS(Job
, transaction
);
132 LIST_FIELDS(Job
, run_queue
);
133 LIST_FIELDS(Job
, dbus_queue
);
135 LIST_HEAD(JobDependency
, subject_list
);
136 LIST_HEAD(JobDependency
, object_list
);
138 /* Used for graph algs as a "I have been here" marker */
147 sd_event_source
*timer_event_source
;
151 * This tracks where to send signals, and also which clients
152 * are allowed to call DBus methods on the job (other than
155 * There can be more than one client, because of job merging.
157 sd_bus_track
*clients
;
158 char **deserialized_clients
;
164 bool matters_to_anchor
:1;
165 bool in_dbus_queue
:1;
166 bool sent_dbus_new_signal
:1;
171 Job
* job_new(Unit
*unit
, JobType type
);
172 Job
* job_new_raw(Unit
*unit
);
173 void job_free(Job
*job
);
174 Job
* job_install(Job
*j
);
175 int job_install_deserialized(Job
*j
);
176 void job_uninstall(Job
*j
);
177 void job_dump(Job
*j
, FILE*f
, const char *prefix
);
178 int job_serialize(Job
*j
, FILE *f
, FDSet
*fds
);
179 int job_deserialize(Job
*j
, FILE *f
, FDSet
*fds
);
180 int job_coldplug(Job
*j
);
182 JobDependency
* job_dependency_new(Job
*subject
, Job
*object
, bool matters
, bool conflicts
);
183 void job_dependency_free(JobDependency
*l
);
185 int job_merge(Job
*j
, Job
*other
);
187 JobType
job_type_lookup_merge(JobType a
, JobType b
) _pure_
;
189 _pure_
static inline bool job_type_is_mergeable(JobType a
, JobType b
) {
190 return job_type_lookup_merge(a
, b
) >= 0;
193 _pure_
static inline bool job_type_is_conflicting(JobType a
, JobType b
) {
194 return a
!= JOB_NOP
&& b
!= JOB_NOP
&& !job_type_is_mergeable(a
, b
);
197 _pure_
static inline bool job_type_is_superset(JobType a
, JobType b
) {
198 /* Checks whether operation a is a "superset" of b in its actions */
203 return a
== job_type_lookup_merge(a
, b
);
206 bool job_type_is_redundant(JobType a
, UnitActiveState b
) _pure_
;
208 /* Collapses a state-dependent job type into a simpler type by observing
209 * the state of the unit which it is going to be applied to. */
210 JobType
job_type_collapse(JobType t
, Unit
*u
);
212 int job_type_merge_and_collapse(JobType
*a
, JobType b
, Unit
*u
);
214 void job_add_to_run_queue(Job
*j
);
215 void job_add_to_dbus_queue(Job
*j
);
217 int job_start_timer(Job
*j
);
219 int job_run_and_invalidate(Job
*j
);
220 int job_finish_and_invalidate(Job
*j
, JobResult result
, bool recursive
);
222 char *job_dbus_path(Job
*j
);
224 void job_shutdown_magic(Job
*j
);
226 const char* job_type_to_string(JobType t
) _const_
;
227 JobType
job_type_from_string(const char *s
) _pure_
;
229 const char* job_state_to_string(JobState t
) _const_
;
230 JobState
job_state_from_string(const char *s
) _pure_
;
232 const char* job_mode_to_string(JobMode t
) _const_
;
233 JobMode
job_mode_from_string(const char *s
) _pure_
;
235 const char* job_result_to_string(JobResult t
) _const_
;
236 JobResult
job_result_from_string(const char *s
) _pure_
;
238 int job_get_timeout(Job
*j
, uint64_t *timeout
) _pure_
;