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/>.
24 typedef struct ExecStatus ExecStatus;
25 typedef struct ExecCommand ExecCommand;
26 typedef struct ExecContext ExecContext;
27 typedef struct ExecRuntime ExecRuntime;
28 typedef struct ExecParameters ExecParameters;
30 #include <linux/types.h>
32 #include <sys/resource.h>
33 #include <sys/capability.h>
43 #include "namespace.h"
44 #include "bus-endpoint.h"
46 typedef enum ExecInput {
53 _EXEC_INPUT_INVALID = -1
56 typedef enum ExecOutput {
61 EXEC_OUTPUT_SYSLOG_AND_CONSOLE,
63 EXEC_OUTPUT_KMSG_AND_CONSOLE,
65 EXEC_OUTPUT_JOURNAL_AND_CONSOLE,
68 _EXEC_OUTPUT_INVALID = -1
72 dual_timestamp start_timestamp;
73 dual_timestamp exit_timestamp;
75 int code; /* as in siginfo_t::si_code */
76 int status; /* as in sigingo_t::si_status */
82 ExecStatus exec_status;
83 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
93 int netns_storage_socket[2];
98 char **environment_files;
100 struct rlimit *rlimit[_RLIMIT_MAX];
101 char *working_directory, *root_directory;
104 int oom_score_adjust;
107 int cpu_sched_policy;
108 int cpu_sched_priority;
111 unsigned cpuset_ncpus;
114 ExecOutput std_output;
115 ExecOutput std_error;
117 nsec_t timer_slack_nsec;
123 bool tty_vt_disallocate;
127 /* Since resolving these names might might involve socket
128 * connections and we don't want to deadlock ourselves these
129 * names are resolved on execution only and in the child
133 char **supplementary_groups;
139 bool selinux_context_ignore;
140 char *selinux_context;
142 bool apparmor_profile_ignore;
143 char *apparmor_profile;
145 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
146 unsigned long mount_flags;
148 uint64_t capability_bounding_set_drop;
154 char *syslog_identifier;
155 bool syslog_level_prefix;
157 bool cpu_sched_reset_on_fork;
160 bool private_network;
161 bool private_devices;
162 ProtectSystem protect_system;
163 ProtectHome protect_home;
165 bool no_new_privileges;
167 /* This is not exposed to the user but available
168 * internally. We need it to make sure that whenever we spawn
169 * /bin/mount it is run in the same process group as us so
170 * that the autofs logic detects that it belongs to us and we
171 * don't enter a trigger loop. */
174 unsigned long personality;
179 bool syscall_whitelist:1;
181 Set *address_families;
182 bool address_families_whitelist:1;
184 char **runtime_directory;
185 mode_t runtime_directory_mode;
187 bool oom_score_adjust_set:1;
190 bool cpu_sched_set:1;
191 bool no_new_privileges_set:1;
193 /* custom dbus enpoint */
194 BusEndpoint *bus_endpoint;
199 struct ExecParameters {
201 int *fds; unsigned n_fds;
203 bool apply_permissions;
205 bool apply_tty_stdin;
207 bool selinux_context_net;
208 CGroupControllerMask cgroup_supported;
209 const char *cgroup_path;
210 bool cgroup_delegate;
211 const char *runtime_prefix;
213 usec_t watchdog_usec;
215 char *bus_endpoint_path;
219 int exec_spawn(ExecCommand *command,
220 const ExecContext *context,
221 const ExecParameters *exec_params,
222 ExecRuntime *runtime,
225 void exec_command_done(ExecCommand *c);
226 void exec_command_done_array(ExecCommand *c, unsigned n);
228 void exec_command_free_list(ExecCommand *c);
229 void exec_command_free_array(ExecCommand **c, unsigned n);
231 char *exec_command_line(char **argv);
233 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
234 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
235 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
236 int exec_command_set(ExecCommand *c, const char *path, ...);
237 int exec_command_append(ExecCommand *c, const char *path, ...);
239 void exec_context_init(ExecContext *c);
240 void exec_context_done(ExecContext *c);
241 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
243 int exec_context_destroy_runtime_directory(ExecContext *c, const char *runtime_root);
245 int exec_context_load_environment(const ExecContext *c, const char *unit_id, char ***l);
247 bool exec_context_may_touch_console(ExecContext *c);
248 bool exec_context_maintains_privileges(ExecContext *c);
250 void exec_status_start(ExecStatus *s, pid_t pid);
251 void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status);
252 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
254 int exec_runtime_make(ExecRuntime **rt, ExecContext *c, const char *id);
255 ExecRuntime *exec_runtime_ref(ExecRuntime *r);
256 ExecRuntime *exec_runtime_unref(ExecRuntime *r);
258 int exec_runtime_serialize(ExecRuntime *rt, Unit *u, FILE *f, FDSet *fds);
259 int exec_runtime_deserialize_item(ExecRuntime **rt, Unit *u, const char *key, const char *value, FDSet *fds);
261 void exec_runtime_destroy(ExecRuntime *rt);
263 const char* exec_output_to_string(ExecOutput i) _const_;
264 ExecOutput exec_output_from_string(const char *s) _pure_;
266 const char* exec_input_to_string(ExecInput i) _const_;
267 ExecInput exec_input_from_string(const char *s) _pure_;