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;
28 #include <linux/types.h>
30 #include <sys/resource.h>
31 #include <sys/capability.h>
37 struct CGroupAttribute;
42 typedef enum KillMode {
43 KILL_CONTROL_GROUP = 0,
47 _KILL_MODE_INVALID = -1
50 typedef enum KillWho {
55 _KILL_WHO_INVALID = -1
58 typedef enum ExecInput {
65 _EXEC_INPUT_INVALID = -1
68 typedef enum ExecOutput {
73 EXEC_OUTPUT_SYSLOG_AND_CONSOLE,
75 EXEC_OUTPUT_KMSG_AND_CONSOLE,
77 EXEC_OUTPUT_JOURNAL_AND_CONSOLE,
80 _EXEC_OUTPUT_INVALID = -1
84 dual_timestamp start_timestamp;
85 dual_timestamp exit_timestamp;
87 int code; /* as in siginfo_t::si_code */
88 int status; /* as in sigingo_t::si_status */
94 ExecStatus exec_status;
95 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
101 char **environment_files;
103 struct rlimit *rlimit[RLIMIT_NLIMITS];
104 char *working_directory, *root_directory;
107 int oom_score_adjust;
110 int cpu_sched_policy;
111 int cpu_sched_priority;
114 unsigned cpuset_ncpus;
117 ExecOutput std_output;
118 ExecOutput std_error;
120 nsec_t timer_slack_nsec;
128 bool tty_vt_disallocate;
132 /* Since resolving these names might might involve socket
133 * connections and we don't want to deadlock ourselves these
134 * names are resolved on execution only and in the child
138 char **supplementary_groups;
144 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
145 unsigned long mount_flags;
147 uint64_t capability_bounding_set_drop;
149 /* Not relevant for spawning processes, just for killing */
158 char *syslog_identifier;
159 bool syslog_level_prefix;
161 bool cpu_sched_reset_on_fork;
164 bool private_network;
166 bool no_new_privileges;
168 bool control_group_modify;
169 int control_group_persistent;
171 /* This is not exposed to the user but available
172 * internally. We need it to make sure that whenever we spawn
173 * /bin/mount it is run in the same process group as us so
174 * that the autofs logic detects that it belongs to us and we
175 * don't enter a trigger loop. */
178 uint32_t *syscall_filter;
180 bool oom_score_adjust_set:1;
183 bool cpu_sched_set:1;
186 int exec_spawn(ExecCommand *command,
188 const ExecContext *context,
189 int fds[], unsigned n_fds,
191 bool apply_permissions,
193 bool apply_tty_stdin,
195 struct CGroupBonding *cgroup_bondings,
196 struct CGroupAttribute *cgroup_attributes,
197 const char *cgroup_suffix,
202 void exec_command_done(ExecCommand *c);
203 void exec_command_done_array(ExecCommand *c, unsigned n);
205 void exec_command_free_list(ExecCommand *c);
206 void exec_command_free_array(ExecCommand **c, unsigned n);
208 char *exec_command_line(char **argv);
210 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
211 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
212 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
213 int exec_command_set(ExecCommand *c, const char *path, ...);
215 void exec_context_init(ExecContext *c);
216 void exec_context_done(ExecContext *c);
217 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
218 void exec_context_tty_reset(const ExecContext *context);
220 int exec_context_load_environment(const ExecContext *c, char ***l);
222 void exec_status_start(ExecStatus *s, pid_t pid);
223 void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status);
224 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
226 const char* exec_output_to_string(ExecOutput i);
227 ExecOutput exec_output_from_string(const char *s);
229 const char* exec_input_to_string(ExecInput i);
230 ExecInput exec_input_from_string(const char *s);
232 const char *kill_mode_to_string(KillMode k);
233 KillMode kill_mode_from_string(const char *s);
235 const char *kill_who_to_string(KillWho k);
236 KillWho kill_who_from_string(const char *s);