]>
Commit | Line | Data |
---|---|---|
c2f1db8f | 1 | #pragma once |
5cb5a6ff | 2 | |
a7334b09 LP |
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 | |
5430f7f2 LP |
9 | under the terms of the GNU Lesser General Public License as published by |
10 | the Free Software Foundation; either version 2.1 of the License, or | |
a7334b09 LP |
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 | |
5430f7f2 | 16 | Lesser General Public License for more details. |
a7334b09 | 17 | |
5430f7f2 | 18 | You should have received a copy of the GNU Lesser General Public License |
a7334b09 LP |
19 | along with systemd; If not, see <http://www.gnu.org/licenses/>. |
20 | ***/ | |
21 | ||
5cb5a6ff LP |
22 | typedef struct ExecStatus ExecStatus; |
23 | typedef struct ExecCommand ExecCommand; | |
24 | typedef struct ExecContext ExecContext; | |
613b411c | 25 | typedef struct ExecRuntime ExecRuntime; |
9fa95f85 | 26 | typedef struct ExecParameters ExecParameters; |
5cb5a6ff | 27 | |
71d35b6b | 28 | #include <sched.h> |
5cb5a6ff LP |
29 | #include <stdbool.h> |
30 | #include <stdio.h> | |
71d35b6b | 31 | #include <sys/capability.h> |
5cb5a6ff | 32 | |
9ce93478 | 33 | #include "cgroup-util.h" |
613b411c | 34 | #include "fdset.h" |
71d35b6b | 35 | #include "list.h" |
517d56b1 | 36 | #include "missing.h" |
417116f2 | 37 | #include "namespace.h" |
add00535 | 38 | #include "nsflags.h" |
5cb5a6ff | 39 | |
023a4f67 LP |
40 | typedef enum ExecUtmpMode { |
41 | EXEC_UTMP_INIT, | |
42 | EXEC_UTMP_LOGIN, | |
43 | EXEC_UTMP_USER, | |
44 | _EXEC_UTMP_MODE_MAX, | |
2307f37e | 45 | _EXEC_UTMP_MODE_INVALID = -1 |
023a4f67 LP |
46 | } ExecUtmpMode; |
47 | ||
80876c20 LP |
48 | typedef enum ExecInput { |
49 | EXEC_INPUT_NULL, | |
50 | EXEC_INPUT_TTY, | |
51 | EXEC_INPUT_TTY_FORCE, | |
52 | EXEC_INPUT_TTY_FAIL, | |
4f2d528d | 53 | EXEC_INPUT_SOCKET, |
52c239d7 | 54 | EXEC_INPUT_NAMED_FD, |
80876c20 LP |
55 | _EXEC_INPUT_MAX, |
56 | _EXEC_INPUT_INVALID = -1 | |
57 | } ExecInput; | |
58 | ||
071830ff | 59 | typedef enum ExecOutput { |
80876c20 | 60 | EXEC_OUTPUT_INHERIT, |
94f04347 | 61 | EXEC_OUTPUT_NULL, |
80876c20 | 62 | EXEC_OUTPUT_TTY, |
94f04347 | 63 | EXEC_OUTPUT_SYSLOG, |
28dbc1e8 | 64 | EXEC_OUTPUT_SYSLOG_AND_CONSOLE, |
9a6bca7a | 65 | EXEC_OUTPUT_KMSG, |
28dbc1e8 | 66 | EXEC_OUTPUT_KMSG_AND_CONSOLE, |
706343f4 LP |
67 | EXEC_OUTPUT_JOURNAL, |
68 | EXEC_OUTPUT_JOURNAL_AND_CONSOLE, | |
4f2d528d | 69 | EXEC_OUTPUT_SOCKET, |
52c239d7 | 70 | EXEC_OUTPUT_NAMED_FD, |
94f04347 LP |
71 | _EXEC_OUTPUT_MAX, |
72 | _EXEC_OUTPUT_INVALID = -1 | |
071830ff LP |
73 | } ExecOutput; |
74 | ||
53f47dfc YW |
75 | typedef enum ExecPreserveMode { |
76 | EXEC_PRESERVE_NO, | |
77 | EXEC_PRESERVE_YES, | |
78 | EXEC_PRESERVE_RESTART, | |
79 | _EXEC_PRESERVE_MODE_MAX, | |
80 | _EXEC_PRESERVE_MODE_INVALID = -1 | |
81 | } ExecPreserveMode; | |
82 | ||
5cb5a6ff | 83 | struct ExecStatus { |
63983207 LP |
84 | dual_timestamp start_timestamp; |
85 | dual_timestamp exit_timestamp; | |
9d58f1db | 86 | pid_t pid; |
9152c765 LP |
87 | int code; /* as in siginfo_t::si_code */ |
88 | int status; /* as in sigingo_t::si_status */ | |
5cb5a6ff LP |
89 | }; |
90 | ||
3ed0cd26 LP |
91 | typedef enum ExecCommandFlags { |
92 | EXEC_COMMAND_IGNORE_FAILURE = 1, | |
93 | EXEC_COMMAND_FULLY_PRIVILEGED = 2, | |
94 | } ExecCommandFlags; | |
95 | ||
5cb5a6ff LP |
96 | struct ExecCommand { |
97 | char *path; | |
98 | char **argv; | |
034c6ed7 | 99 | ExecStatus exec_status; |
3ed0cd26 | 100 | ExecCommandFlags flags; |
034c6ed7 | 101 | LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */ |
5cb5a6ff LP |
102 | }; |
103 | ||
613b411c LP |
104 | struct ExecRuntime { |
105 | int n_ref; | |
106 | ||
107 | char *tmp_dir; | |
108 | char *var_tmp_dir; | |
109 | ||
29206d46 LP |
110 | /* An AF_UNIX socket pair, that contains a datagram containing a file descriptor referring to the network |
111 | * namespace. */ | |
613b411c LP |
112 | int netns_storage_socket[2]; |
113 | }; | |
114 | ||
3536f49e YW |
115 | typedef enum ExecDirectoryType { |
116 | EXEC_DIRECTORY_RUNTIME = 0, | |
117 | EXEC_DIRECTORY_STATE, | |
118 | EXEC_DIRECTORY_CACHE, | |
119 | EXEC_DIRECTORY_LOGS, | |
120 | EXEC_DIRECTORY_CONFIGURATION, | |
121 | _EXEC_DIRECTORY_MAX, | |
122 | _EXEC_DIRECTORY_INVALID = -1, | |
123 | } ExecDirectoryType; | |
124 | ||
125 | typedef struct ExecDirectory { | |
126 | char **paths; | |
127 | mode_t mode; | |
128 | } ExecDirectory; | |
129 | ||
5cb5a6ff LP |
130 | struct ExecContext { |
131 | char **environment; | |
8c7be95e | 132 | char **environment_files; |
b4c14404 | 133 | char **pass_environment; |
8c7be95e | 134 | |
517d56b1 | 135 | struct rlimit *rlimit[_RLIMIT_MAX]; |
915e6d16 | 136 | char *working_directory, *root_directory, *root_image; |
4c08c824 | 137 | bool working_directory_missing_ok; |
5f5d8eab | 138 | bool working_directory_home; |
9d58f1db LP |
139 | |
140 | mode_t umask; | |
dd6c17b1 | 141 | int oom_score_adjust; |
5cb5a6ff | 142 | int nice; |
9eba9da4 | 143 | int ioprio; |
94f04347 LP |
144 | int cpu_sched_policy; |
145 | int cpu_sched_priority; | |
9d58f1db | 146 | |
82c121a4 LP |
147 | cpu_set_t *cpuset; |
148 | unsigned cpuset_ncpus; | |
fb33a393 | 149 | |
80876c20 LP |
150 | ExecInput std_input; |
151 | ExecOutput std_output; | |
152 | ExecOutput std_error; | |
52c239d7 | 153 | char *stdio_fdname[3]; |
80876c20 | 154 | |
d88a251b | 155 | nsec_t timer_slack_nsec; |
071830ff | 156 | |
1e22b5cd LP |
157 | bool stdio_as_fds; |
158 | ||
9d58f1db | 159 | char *tty_path; |
5cb5a6ff | 160 | |
6ea832a2 LP |
161 | bool tty_reset; |
162 | bool tty_vhangup; | |
163 | bool tty_vt_disallocate; | |
164 | ||
353e12c2 LP |
165 | bool ignore_sigpipe; |
166 | ||
61233823 | 167 | /* Since resolving these names might involve socket |
5cb5a6ff | 168 | * connections and we don't want to deadlock ourselves these |
94f04347 LP |
169 | * names are resolved on execution only and in the child |
170 | * process. */ | |
5cb5a6ff LP |
171 | char *user; |
172 | char *group; | |
173 | char **supplementary_groups; | |
9d58f1db | 174 | |
5b6319dc LP |
175 | char *pam_name; |
176 | ||
169c1bda | 177 | char *utmp_id; |
023a4f67 | 178 | ExecUtmpMode utmp_mode; |
169c1bda | 179 | |
5f8640fb | 180 | bool selinux_context_ignore; |
7b52a628 MS |
181 | char *selinux_context; |
182 | ||
eef65bf3 MS |
183 | bool apparmor_profile_ignore; |
184 | char *apparmor_profile; | |
185 | ||
2ca620c4 WC |
186 | bool smack_process_label_ignore; |
187 | char *smack_process_label; | |
188 | ||
2a624c36 | 189 | char **read_write_paths, **read_only_paths, **inaccessible_paths; |
15ae422b | 190 | unsigned long mount_flags; |
d2d6c096 LP |
191 | BindMount *bind_mounts; |
192 | unsigned n_bind_mounts; | |
15ae422b | 193 | |
a103496c | 194 | uint64_t capability_bounding_set; |
755d4b67 | 195 | uint64_t capability_ambient_set; |
9d58f1db LP |
196 | int secure_bits; |
197 | ||
7fab9d01 LP |
198 | int syslog_priority; |
199 | char *syslog_identifier; | |
200 | bool syslog_level_prefix; | |
201 | ||
9d58f1db LP |
202 | bool cpu_sched_reset_on_fork; |
203 | bool non_blocking; | |
15ae422b | 204 | bool private_tmp; |
ff01d048 | 205 | bool private_network; |
7f112f50 | 206 | bool private_devices; |
d251207d | 207 | bool private_users; |
1b8689f9 LP |
208 | ProtectSystem protect_system; |
209 | ProtectHome protect_home; | |
59eeb84b | 210 | bool protect_kernel_tunables; |
502d704e | 211 | bool protect_kernel_modules; |
59eeb84b | 212 | bool protect_control_groups; |
5d997827 | 213 | bool mount_apivfs; |
9d58f1db | 214 | |
8351ceae LP |
215 | bool no_new_privileges; |
216 | ||
29206d46 | 217 | bool dynamic_user; |
00d9ef85 | 218 | bool remove_ipc; |
29206d46 | 219 | |
9d58f1db LP |
220 | /* This is not exposed to the user but available |
221 | * internally. We need it to make sure that whenever we spawn | |
f00929ad | 222 | * /usr/bin/mount it is run in the same process group as us so |
9d58f1db LP |
223 | * that the autofs logic detects that it belongs to us and we |
224 | * don't enter a trigger loop. */ | |
74922904 | 225 | bool same_pgrp; |
2e22afe9 | 226 | |
ac45f971 LP |
227 | unsigned long personality; |
228 | ||
add00535 LP |
229 | unsigned long restrict_namespaces; /* The CLONE_NEWxyz flags permitted to the unit's processes */ |
230 | ||
17df7223 | 231 | Set *syscall_filter; |
57183d11 | 232 | Set *syscall_archs; |
17df7223 LP |
233 | int syscall_errno; |
234 | bool syscall_whitelist:1; | |
8351ceae | 235 | |
4298d0b5 LP |
236 | Set *address_families; |
237 | bool address_families_whitelist:1; | |
238 | ||
53f47dfc | 239 | ExecPreserveMode runtime_directory_preserve_mode; |
3536f49e | 240 | ExecDirectory directories[_EXEC_DIRECTORY_MAX]; |
e66cf1a3 | 241 | |
f4170c67 LP |
242 | bool memory_deny_write_execute; |
243 | bool restrict_realtime; | |
244 | ||
dd6c17b1 | 245 | bool oom_score_adjust_set:1; |
7fab9d01 LP |
246 | bool nice_set:1; |
247 | bool ioprio_set:1; | |
248 | bool cpu_sched_set:1; | |
5cb5a6ff LP |
249 | }; |
250 | ||
add00535 LP |
251 | static inline bool exec_context_restrict_namespaces_set(const ExecContext *c) { |
252 | assert(c); | |
253 | ||
254 | return (c->restrict_namespaces & NAMESPACE_FLAGS_ALL) != NAMESPACE_FLAGS_ALL; | |
255 | } | |
256 | ||
c39f1ce2 | 257 | typedef enum ExecFlags { |
7d5ceb64 FB |
258 | EXEC_APPLY_PERMISSIONS = 1U << 0, |
259 | EXEC_APPLY_CHROOT = 1U << 1, | |
260 | EXEC_APPLY_TTY_STDIN = 1U << 2, | |
74dd6b51 | 261 | EXEC_NEW_KEYRING = 1U << 3, |
af635cf3 | 262 | EXEC_PASS_LOG_UNIT = 1U << 4, /* Whether to pass the unit name to the service's journal stream connection */ |
8679efde | 263 | EXEC_CHOWN_DIRECTORIES = 1U << 5, /* chown() the runtime/state/cache/log directories to the user we run as, under all conditions */ |
c39f1ce2 | 264 | |
9c1a61ad | 265 | /* The following are not used by execute.c, but by consumers internally */ |
8679efde LP |
266 | EXEC_PASS_FDS = 1U << 6, |
267 | EXEC_IS_CONTROL = 1U << 7, | |
268 | EXEC_SETENV_RESULT = 1U << 8, | |
269 | EXEC_SET_WATCHDOG = 1U << 9, | |
c39f1ce2 LP |
270 | } ExecFlags; |
271 | ||
9fa95f85 DM |
272 | struct ExecParameters { |
273 | char **argv; | |
a34ceba6 | 274 | char **environment; |
8dd4c05b LP |
275 | |
276 | int *fds; | |
277 | char **fd_names; | |
4c47affc | 278 | unsigned n_storage_fds; |
9b141911 | 279 | unsigned n_socket_fds; |
8dd4c05b | 280 | |
c39f1ce2 | 281 | ExecFlags flags; |
a34ceba6 | 282 | bool selinux_context_net:1; |
8dd4c05b | 283 | |
a34ceba6 | 284 | bool cgroup_delegate:1; |
efdb0237 | 285 | CGroupMask cgroup_supported; |
9fa95f85 | 286 | const char *cgroup_path; |
8dd4c05b | 287 | |
3536f49e | 288 | char **prefix; |
8dd4c05b | 289 | |
7d5ceb64 FB |
290 | const char *confirm_spawn; |
291 | ||
9fa95f85 | 292 | usec_t watchdog_usec; |
8dd4c05b | 293 | |
9fa95f85 | 294 | int *idle_pipe; |
8dd4c05b | 295 | |
a34ceba6 LP |
296 | int stdin_fd; |
297 | int stdout_fd; | |
298 | int stderr_fd; | |
9fa95f85 DM |
299 | }; |
300 | ||
9ce93478 | 301 | #include "unit.h" |
29206d46 | 302 | #include "dynamic-user.h" |
9ce93478 | 303 | |
f2341e0a LP |
304 | int exec_spawn(Unit *unit, |
305 | ExecCommand *command, | |
9fa95f85 DM |
306 | const ExecContext *context, |
307 | const ExecParameters *exec_params, | |
613b411c | 308 | ExecRuntime *runtime, |
29206d46 | 309 | DynamicCreds *dynamic_creds, |
81a2b7ce | 310 | pid_t *ret); |
5cb5a6ff | 311 | |
43d0fcbd LP |
312 | void exec_command_done(ExecCommand *c); |
313 | void exec_command_done_array(ExecCommand *c, unsigned n); | |
314 | ||
f1acf85a | 315 | ExecCommand* exec_command_free_list(ExecCommand *c); |
034c6ed7 | 316 | void exec_command_free_array(ExecCommand **c, unsigned n); |
5cb5a6ff | 317 | |
9e2f7c11 LP |
318 | char *exec_command_line(char **argv); |
319 | ||
44d8db9e LP |
320 | void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix); |
321 | void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix); | |
a6a80b4f | 322 | void exec_command_append_list(ExecCommand **l, ExecCommand *e); |
26fd040d | 323 | int exec_command_set(ExecCommand *c, const char *path, ...); |
86b23b07 | 324 | int exec_command_append(ExecCommand *c, const char *path, ...); |
44d8db9e | 325 | |
034c6ed7 | 326 | void exec_context_init(ExecContext *c); |
613b411c | 327 | void exec_context_done(ExecContext *c); |
5cb5a6ff LP |
328 | void exec_context_dump(ExecContext *c, FILE* f, const char *prefix); |
329 | ||
e66cf1a3 LP |
330 | int exec_context_destroy_runtime_directory(ExecContext *c, const char *runtime_root); |
331 | ||
f2341e0a | 332 | int exec_context_load_environment(Unit *unit, const ExecContext *c, char ***l); |
52c239d7 LB |
333 | int exec_context_named_iofds(Unit *unit, const ExecContext *c, const ExecParameters *p, int named_iofds[3]); |
334 | const char* exec_context_fdname(const ExecContext *c, int fd_index); | |
8c7be95e | 335 | |
6ac8fdc9 | 336 | bool exec_context_may_touch_console(ExecContext *c); |
a931ad47 | 337 | bool exec_context_maintains_privileges(ExecContext *c); |
6ac8fdc9 | 338 | |
7f452159 LP |
339 | int exec_context_get_effective_ioprio(ExecContext *c); |
340 | ||
b58b4116 | 341 | void exec_status_start(ExecStatus *s, pid_t pid); |
6ea832a2 | 342 | void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status); |
9fb86720 | 343 | void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix); |
5cb5a6ff | 344 | |
613b411c LP |
345 | int exec_runtime_make(ExecRuntime **rt, ExecContext *c, const char *id); |
346 | ExecRuntime *exec_runtime_ref(ExecRuntime *r); | |
347 | ExecRuntime *exec_runtime_unref(ExecRuntime *r); | |
348 | ||
f2341e0a LP |
349 | int exec_runtime_serialize(Unit *unit, ExecRuntime *rt, FILE *f, FDSet *fds); |
350 | int exec_runtime_deserialize_item(Unit *unit, ExecRuntime **rt, const char *key, const char *value, FDSet *fds); | |
613b411c LP |
351 | |
352 | void exec_runtime_destroy(ExecRuntime *rt); | |
353 | ||
44a6b1b6 ZJS |
354 | const char* exec_output_to_string(ExecOutput i) _const_; |
355 | ExecOutput exec_output_from_string(const char *s) _pure_; | |
94f04347 | 356 | |
44a6b1b6 ZJS |
357 | const char* exec_input_to_string(ExecInput i) _const_; |
358 | ExecInput exec_input_from_string(const char *s) _pure_; | |
023a4f67 LP |
359 | |
360 | const char* exec_utmp_mode_to_string(ExecUtmpMode i) _const_; | |
361 | ExecUtmpMode exec_utmp_mode_from_string(const char *s) _pure_; | |
53f47dfc YW |
362 | |
363 | const char* exec_preserve_mode_to_string(ExecPreserveMode i) _const_; | |
364 | ExecPreserveMode exec_preserve_mode_from_string(const char *s) _pure_; | |
3536f49e YW |
365 | |
366 | const char* exec_directory_type_to_string(ExecDirectoryType i) _const_; | |
367 | ExecDirectoryType exec_directory_type_from_string(const char *s) _pure_; |