]>
Commit | Line | Data |
---|---|---|
1 | #pragma once | |
2 | ||
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 | |
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 | |
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 | |
16 | Lesser General Public License for more details. | |
17 | ||
18 | You should have received a copy of the GNU Lesser General Public License | |
19 | along with systemd; If not, see <http://www.gnu.org/licenses/>. | |
20 | ***/ | |
21 | ||
22 | typedef struct ExecStatus ExecStatus; | |
23 | typedef struct ExecCommand ExecCommand; | |
24 | typedef struct ExecContext ExecContext; | |
25 | typedef struct ExecRuntime ExecRuntime; | |
26 | typedef struct ExecParameters ExecParameters; | |
27 | ||
28 | #include <sched.h> | |
29 | #include <stdbool.h> | |
30 | #include <stdio.h> | |
31 | #include <sys/capability.h> | |
32 | ||
33 | #include "fdset.h" | |
34 | #include "list.h" | |
35 | #include "missing.h" | |
36 | #include "namespace.h" | |
37 | ||
38 | typedef enum ExecUtmpMode { | |
39 | EXEC_UTMP_INIT, | |
40 | EXEC_UTMP_LOGIN, | |
41 | EXEC_UTMP_USER, | |
42 | _EXEC_UTMP_MODE_MAX, | |
43 | _EXEC_UTMP_MODE_INVALID = -1 | |
44 | } ExecUtmpMode; | |
45 | ||
46 | typedef enum ExecInput { | |
47 | EXEC_INPUT_NULL, | |
48 | EXEC_INPUT_TTY, | |
49 | EXEC_INPUT_TTY_FORCE, | |
50 | EXEC_INPUT_TTY_FAIL, | |
51 | EXEC_INPUT_SOCKET, | |
52 | _EXEC_INPUT_MAX, | |
53 | _EXEC_INPUT_INVALID = -1 | |
54 | } ExecInput; | |
55 | ||
56 | typedef enum ExecOutput { | |
57 | EXEC_OUTPUT_INHERIT, | |
58 | EXEC_OUTPUT_NULL, | |
59 | EXEC_OUTPUT_TTY, | |
60 | EXEC_OUTPUT_SYSLOG, | |
61 | EXEC_OUTPUT_SYSLOG_AND_CONSOLE, | |
62 | EXEC_OUTPUT_KMSG, | |
63 | EXEC_OUTPUT_KMSG_AND_CONSOLE, | |
64 | EXEC_OUTPUT_JOURNAL, | |
65 | EXEC_OUTPUT_JOURNAL_AND_CONSOLE, | |
66 | EXEC_OUTPUT_SOCKET, | |
67 | _EXEC_OUTPUT_MAX, | |
68 | _EXEC_OUTPUT_INVALID = -1 | |
69 | } ExecOutput; | |
70 | ||
71 | struct ExecStatus { | |
72 | dual_timestamp start_timestamp; | |
73 | dual_timestamp exit_timestamp; | |
74 | pid_t pid; | |
75 | int code; /* as in siginfo_t::si_code */ | |
76 | int status; /* as in sigingo_t::si_status */ | |
77 | }; | |
78 | ||
79 | struct ExecCommand { | |
80 | char *path; | |
81 | char **argv; | |
82 | ExecStatus exec_status; | |
83 | LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */ | |
84 | bool ignore:1; | |
85 | bool privileged:1; | |
86 | }; | |
87 | ||
88 | struct ExecRuntime { | |
89 | int n_ref; | |
90 | ||
91 | char *tmp_dir; | |
92 | char *var_tmp_dir; | |
93 | ||
94 | int netns_storage_socket[2]; | |
95 | }; | |
96 | ||
97 | struct ExecContext { | |
98 | char **environment; | |
99 | char **environment_files; | |
100 | char **pass_environment; | |
101 | ||
102 | struct rlimit *rlimit[_RLIMIT_MAX]; | |
103 | char *working_directory, *root_directory; | |
104 | bool working_directory_missing_ok; | |
105 | bool working_directory_home; | |
106 | ||
107 | mode_t umask; | |
108 | int oom_score_adjust; | |
109 | int nice; | |
110 | int ioprio; | |
111 | int cpu_sched_policy; | |
112 | int cpu_sched_priority; | |
113 | ||
114 | cpu_set_t *cpuset; | |
115 | unsigned cpuset_ncpus; | |
116 | ||
117 | ExecInput std_input; | |
118 | ExecOutput std_output; | |
119 | ExecOutput std_error; | |
120 | ||
121 | nsec_t timer_slack_nsec; | |
122 | ||
123 | bool stdio_as_fds; | |
124 | ||
125 | char *tty_path; | |
126 | ||
127 | bool tty_reset; | |
128 | bool tty_vhangup; | |
129 | bool tty_vt_disallocate; | |
130 | ||
131 | bool ignore_sigpipe; | |
132 | ||
133 | /* Since resolving these names might involve socket | |
134 | * connections and we don't want to deadlock ourselves these | |
135 | * names are resolved on execution only and in the child | |
136 | * process. */ | |
137 | char *user; | |
138 | char *group; | |
139 | char **supplementary_groups; | |
140 | ||
141 | char *pam_name; | |
142 | ||
143 | char *utmp_id; | |
144 | ExecUtmpMode utmp_mode; | |
145 | ||
146 | bool selinux_context_ignore; | |
147 | char *selinux_context; | |
148 | ||
149 | bool apparmor_profile_ignore; | |
150 | char *apparmor_profile; | |
151 | ||
152 | bool smack_process_label_ignore; | |
153 | char *smack_process_label; | |
154 | ||
155 | char **read_write_paths, **read_only_paths, **inaccessible_paths; | |
156 | unsigned long mount_flags; | |
157 | ||
158 | uint64_t capability_bounding_set; | |
159 | uint64_t capability_ambient_set; | |
160 | int secure_bits; | |
161 | ||
162 | int syslog_priority; | |
163 | char *syslog_identifier; | |
164 | bool syslog_level_prefix; | |
165 | ||
166 | bool cpu_sched_reset_on_fork; | |
167 | bool non_blocking; | |
168 | bool private_tmp; | |
169 | bool private_network; | |
170 | bool private_devices; | |
171 | ProtectSystem protect_system; | |
172 | ProtectHome protect_home; | |
173 | ||
174 | bool no_new_privileges; | |
175 | ||
176 | /* This is not exposed to the user but available | |
177 | * internally. We need it to make sure that whenever we spawn | |
178 | * /usr/bin/mount it is run in the same process group as us so | |
179 | * that the autofs logic detects that it belongs to us and we | |
180 | * don't enter a trigger loop. */ | |
181 | bool same_pgrp; | |
182 | ||
183 | unsigned long personality; | |
184 | ||
185 | Set *syscall_filter; | |
186 | Set *syscall_archs; | |
187 | int syscall_errno; | |
188 | bool syscall_whitelist:1; | |
189 | ||
190 | Set *address_families; | |
191 | bool address_families_whitelist:1; | |
192 | ||
193 | char **runtime_directory; | |
194 | mode_t runtime_directory_mode; | |
195 | ||
196 | bool memory_deny_write_execute; | |
197 | bool restrict_realtime; | |
198 | ||
199 | bool oom_score_adjust_set:1; | |
200 | bool nice_set:1; | |
201 | bool ioprio_set:1; | |
202 | bool cpu_sched_set:1; | |
203 | bool no_new_privileges_set:1; | |
204 | }; | |
205 | ||
206 | #include "cgroup-util.h" | |
207 | #include "cgroup.h" | |
208 | ||
209 | struct ExecParameters { | |
210 | char **argv; | |
211 | char **environment; | |
212 | ||
213 | int *fds; | |
214 | char **fd_names; | |
215 | unsigned n_fds; | |
216 | ||
217 | bool apply_permissions:1; | |
218 | bool apply_chroot:1; | |
219 | bool apply_tty_stdin:1; | |
220 | ||
221 | bool confirm_spawn:1; | |
222 | bool selinux_context_net:1; | |
223 | ||
224 | bool cgroup_delegate:1; | |
225 | CGroupMask cgroup_supported; | |
226 | const char *cgroup_path; | |
227 | ||
228 | const char *runtime_prefix; | |
229 | ||
230 | usec_t watchdog_usec; | |
231 | ||
232 | int *idle_pipe; | |
233 | ||
234 | int stdin_fd; | |
235 | int stdout_fd; | |
236 | int stderr_fd; | |
237 | }; | |
238 | ||
239 | int exec_spawn(Unit *unit, | |
240 | ExecCommand *command, | |
241 | const ExecContext *context, | |
242 | const ExecParameters *exec_params, | |
243 | ExecRuntime *runtime, | |
244 | pid_t *ret); | |
245 | ||
246 | void exec_command_done(ExecCommand *c); | |
247 | void exec_command_done_array(ExecCommand *c, unsigned n); | |
248 | ||
249 | ExecCommand* exec_command_free_list(ExecCommand *c); | |
250 | void exec_command_free_array(ExecCommand **c, unsigned n); | |
251 | ||
252 | char *exec_command_line(char **argv); | |
253 | ||
254 | void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix); | |
255 | void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix); | |
256 | void exec_command_append_list(ExecCommand **l, ExecCommand *e); | |
257 | int exec_command_set(ExecCommand *c, const char *path, ...); | |
258 | int exec_command_append(ExecCommand *c, const char *path, ...); | |
259 | ||
260 | void exec_context_init(ExecContext *c); | |
261 | void exec_context_done(ExecContext *c); | |
262 | void exec_context_dump(ExecContext *c, FILE* f, const char *prefix); | |
263 | ||
264 | int exec_context_destroy_runtime_directory(ExecContext *c, const char *runtime_root); | |
265 | ||
266 | int exec_context_load_environment(Unit *unit, const ExecContext *c, char ***l); | |
267 | ||
268 | bool exec_context_may_touch_console(ExecContext *c); | |
269 | bool exec_context_maintains_privileges(ExecContext *c); | |
270 | ||
271 | void exec_status_start(ExecStatus *s, pid_t pid); | |
272 | void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status); | |
273 | void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix); | |
274 | ||
275 | int exec_runtime_make(ExecRuntime **rt, ExecContext *c, const char *id); | |
276 | ExecRuntime *exec_runtime_ref(ExecRuntime *r); | |
277 | ExecRuntime *exec_runtime_unref(ExecRuntime *r); | |
278 | ||
279 | int exec_runtime_serialize(Unit *unit, ExecRuntime *rt, FILE *f, FDSet *fds); | |
280 | int exec_runtime_deserialize_item(Unit *unit, ExecRuntime **rt, const char *key, const char *value, FDSet *fds); | |
281 | ||
282 | void exec_runtime_destroy(ExecRuntime *rt); | |
283 | ||
284 | const char* exec_output_to_string(ExecOutput i) _const_; | |
285 | ExecOutput exec_output_from_string(const char *s) _pure_; | |
286 | ||
287 | const char* exec_input_to_string(ExecInput i) _const_; | |
288 | ExecInput exec_input_from_string(const char *s) _pure_; | |
289 | ||
290 | const char* exec_utmp_mode_to_string(ExecUtmpMode i) _const_; | |
291 | ExecUtmpMode exec_utmp_mode_from_string(const char *s) _pure_; |