1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
7 This file is part of systemd.
9 Copyright 2010 Lennart Poettering
11 systemd is free software; you can redistribute it and/or modify it
12 under the terms of the GNU Lesser General Public License as published by
13 the Free Software Foundation; either version 2.1 of the License, or
14 (at your option) any later version.
16 systemd is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public License
22 along with systemd; If not, see <http://www.gnu.org/licenses/>.
25 typedef struct ExecStatus ExecStatus;
26 typedef struct ExecCommand ExecCommand;
27 typedef struct ExecContext ExecContext;
29 #include <linux/types.h>
31 #include <sys/resource.h>
32 #include <sys/capability.h>
38 struct CGroupAttribute;
43 typedef enum KillMode {
44 KILL_CONTROL_GROUP = 0,
48 _KILL_MODE_INVALID = -1
51 typedef enum KillWho {
56 _KILL_WHO_INVALID = -1
59 typedef enum ExecInput {
66 _EXEC_INPUT_INVALID = -1
69 typedef enum ExecOutput {
74 EXEC_OUTPUT_SYSLOG_AND_CONSOLE,
76 EXEC_OUTPUT_KMSG_AND_CONSOLE,
78 EXEC_OUTPUT_JOURNAL_AND_CONSOLE,
81 _EXEC_OUTPUT_INVALID = -1
85 dual_timestamp start_timestamp;
86 dual_timestamp exit_timestamp;
88 int code; /* as in siginfo_t::si_code */
89 int status; /* as in sigingo_t::si_status */
95 ExecStatus exec_status;
96 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
102 char **environment_files;
104 struct rlimit *rlimit[RLIMIT_NLIMITS];
105 char *working_directory, *root_directory;
108 int oom_score_adjust;
111 int cpu_sched_policy;
112 int cpu_sched_priority;
115 unsigned cpuset_ncpus;
118 ExecOutput std_output;
119 ExecOutput std_error;
121 nsec_t timer_slack_nsec;
129 bool tty_vt_disallocate;
133 /* Since resolving these names might 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
139 char **supplementary_groups;
145 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
146 unsigned long mount_flags;
148 uint64_t capability_bounding_set_drop;
150 /* Not relevant for spawning processes, just for killing */
159 char *syslog_identifier;
160 bool syslog_level_prefix;
162 bool cpu_sched_reset_on_fork;
165 bool private_network;
167 bool control_group_modify;
168 int control_group_persistent;
170 /* This is not exposed to the user but available
171 * internally. We need it to make sure that whenever we spawn
172 * /bin/mount it is run in the same process group as us so
173 * that the autofs logic detects that it belongs to us and we
174 * don't enter a trigger loop. */
177 bool oom_score_adjust_set:1;
180 bool cpu_sched_set:1;
183 int exec_spawn(ExecCommand *command,
185 const ExecContext *context,
186 int fds[], unsigned n_fds,
188 bool apply_permissions,
190 bool apply_tty_stdin,
192 struct CGroupBonding *cgroup_bondings,
193 struct CGroupAttribute *cgroup_attributes,
194 const char *cgroup_suffix,
198 void exec_command_done(ExecCommand *c);
199 void exec_command_done_array(ExecCommand *c, unsigned n);
201 void exec_command_free_list(ExecCommand *c);
202 void exec_command_free_array(ExecCommand **c, unsigned n);
204 char *exec_command_line(char **argv);
206 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
207 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
208 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
209 int exec_command_set(ExecCommand *c, const char *path, ...);
211 void exec_context_init(ExecContext *c);
212 void exec_context_done(ExecContext *c);
213 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
214 void exec_context_tty_reset(const ExecContext *context);
216 int exec_context_load_environment(const ExecContext *c, char ***l);
218 void exec_status_start(ExecStatus *s, pid_t pid);
219 void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status);
220 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
222 const char* exec_output_to_string(ExecOutput i);
223 ExecOutput exec_output_from_string(const char *s);
225 const char* exec_input_to_string(ExecInput i);
226 ExecInput exec_input_from_string(const char *s);
228 const char *kill_mode_to_string(KillMode k);
229 KillMode kill_mode_from_string(const char *s);
231 const char *kill_who_to_string(KillWho k);
232 KillWho kill_who_from_string(const char *s);