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 General Public License as published by
13 the Free Software Foundation; either version 2 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 General Public License for more details.
21 You should have received a copy of the GNU 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,
79 _EXEC_OUTPUT_INVALID = -1
83 dual_timestamp start_timestamp;
84 dual_timestamp exit_timestamp;
86 int code; /* as in siginfo_t::si_code */
87 int status; /* as in sigingo_t::si_status */
93 ExecStatus exec_status;
94 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
100 char **environment_files;
102 struct rlimit *rlimit[RLIMIT_NLIMITS];
103 char *working_directory, *root_directory;
106 int oom_score_adjust;
109 int cpu_sched_policy;
110 int cpu_sched_priority;
113 unsigned cpuset_ncpus;
116 ExecOutput std_output;
117 ExecOutput std_error;
119 unsigned long timer_slack_nsec;
127 bool tty_vt_disallocate;
129 /* Since resolving these names might might involve socket
130 * connections and we don't want to deadlock ourselves these
131 * names are resolved on execution only and in the child
135 char **supplementary_groups;
141 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
142 unsigned long mount_flags;
144 uint64_t capability_bounding_set_drop;
146 /* Not relevant for spawning processes, just for killing */
155 char *syslog_identifier;
156 bool syslog_level_prefix;
158 bool cpu_sched_reset_on_fork;
161 bool private_network;
163 bool control_group_modify;
165 /* This is not exposed to the user but available
166 * internally. We need it to make sure that whenever we spawn
167 * /bin/mount it is run in the same process group as us so
168 * that the autofs logic detects that it belongs to us and we
169 * don't enter a trigger loop. */
172 bool oom_score_adjust_set:1;
175 bool cpu_sched_set:1;
176 bool timer_slack_nsec_set:1;
179 int exec_spawn(ExecCommand *command,
181 const ExecContext *context,
182 int fds[], unsigned n_fds,
184 bool apply_permissions,
186 bool apply_tty_stdin,
188 struct CGroupBonding *cgroup_bondings,
189 struct CGroupAttribute *cgroup_attributes,
192 void exec_command_done(ExecCommand *c);
193 void exec_command_done_array(ExecCommand *c, unsigned n);
195 void exec_command_free_list(ExecCommand *c);
196 void exec_command_free_array(ExecCommand **c, unsigned n);
198 char *exec_command_line(char **argv);
200 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
201 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
202 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
203 int exec_command_set(ExecCommand *c, const char *path, ...);
205 void exec_context_init(ExecContext *c);
206 void exec_context_done(ExecContext *c);
207 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
208 void exec_context_tty_reset(const ExecContext *context);
210 int exec_context_load_environment(const ExecContext *c, char ***l);
212 void exec_status_start(ExecStatus *s, pid_t pid);
213 void exec_status_exit(ExecStatus *s, ExecContext *context, pid_t pid, int code, int status);
214 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
216 const char* exec_output_to_string(ExecOutput i);
217 ExecOutput exec_output_from_string(const char *s);
219 const char* exec_input_to_string(ExecInput i);
220 ExecInput exec_input_from_string(const char *s);
222 const char *kill_mode_to_string(KillMode k);
223 KillMode kill_mode_from_string(const char *s);
225 const char *kill_who_to_string(KillWho k);
226 KillWho kill_who_from_string(const char *s);