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;
29 #include <linux/types.h>
31 #include <sys/resource.h>
32 #include <sys/capability.h>
41 typedef struct Unit Unit;
43 typedef enum ExecInput {
50 _EXEC_INPUT_INVALID = -1
53 typedef enum ExecOutput {
58 EXEC_OUTPUT_SYSLOG_AND_CONSOLE,
60 EXEC_OUTPUT_KMSG_AND_CONSOLE,
62 EXEC_OUTPUT_JOURNAL_AND_CONSOLE,
65 _EXEC_OUTPUT_INVALID = -1
69 dual_timestamp start_timestamp;
70 dual_timestamp exit_timestamp;
72 int code; /* as in siginfo_t::si_code */
73 int status; /* as in sigingo_t::si_status */
79 ExecStatus exec_status;
80 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
90 int netns_storage_socket[2];
95 char **environment_files;
97 struct rlimit *rlimit[RLIMIT_NLIMITS];
98 char *working_directory, *root_directory;
101 int oom_score_adjust;
104 int cpu_sched_policy;
105 int cpu_sched_priority;
108 unsigned cpuset_ncpus;
111 ExecOutput std_output;
112 ExecOutput std_error;
114 nsec_t timer_slack_nsec;
122 bool tty_vt_disallocate;
126 /* Since resolving these names might might involve socket
127 * connections and we don't want to deadlock ourselves these
128 * names are resolved on execution only and in the child
132 char **supplementary_groups;
138 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
139 unsigned long mount_flags;
141 uint64_t capability_bounding_set_drop;
147 char *syslog_identifier;
148 bool syslog_level_prefix;
150 bool cpu_sched_reset_on_fork;
153 bool private_network;
155 bool no_new_privileges;
157 /* This is not exposed to the user but available
158 * internally. We need it to make sure that whenever we spawn
159 * /bin/mount it is run in the same process group as us so
160 * that the autofs logic detects that it belongs to us and we
161 * don't enter a trigger loop. */
164 uint32_t *syscall_filter;
166 bool oom_score_adjust_set:1;
169 bool cpu_sched_set:1;
174 int exec_spawn(ExecCommand *command,
176 ExecContext *context,
177 int fds[], unsigned n_fds,
179 bool apply_permissions,
181 bool apply_tty_stdin,
183 CGroupControllerMask cgroup_mask,
184 const char *cgroup_path,
187 ExecRuntime *runtime,
190 void exec_command_done(ExecCommand *c);
191 void exec_command_done_array(ExecCommand *c, unsigned n);
193 void exec_command_free_list(ExecCommand *c);
194 void exec_command_free_array(ExecCommand **c, unsigned n);
196 char *exec_command_line(char **argv);
198 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
199 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
200 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
201 int exec_command_set(ExecCommand *c, const char *path, ...);
203 void exec_context_init(ExecContext *c);
204 void exec_context_done(ExecContext *c);
205 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
207 int exec_context_load_environment(const ExecContext *c, char ***l);
209 bool exec_context_may_touch_console(ExecContext *c);
211 void exec_status_start(ExecStatus *s, pid_t pid);
212 void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status);
213 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
215 int exec_runtime_make(ExecRuntime **rt, ExecContext *c, const char *id);
216 ExecRuntime *exec_runtime_ref(ExecRuntime *r);
217 ExecRuntime *exec_runtime_unref(ExecRuntime *r);
219 int exec_runtime_serialize(ExecRuntime *rt, Unit *u, FILE *f, FDSet *fds);
220 int exec_runtime_deserialize_item(ExecRuntime **rt, Unit *u, const char *key, const char *value, FDSet *fds);
222 void exec_runtime_destroy(ExecRuntime *rt);
224 const char* exec_output_to_string(ExecOutput i) _const_;
225 ExecOutput exec_output_from_string(const char *s) _pure_;
227 const char* exec_input_to_string(ExecInput i) _const_;
228 ExecInput exec_input_from_string(const char *s) _pure_;