1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
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;
30 #include <sys/resource.h>
31 #include <sys/capability.h>
41 /* Abstract namespace! */
42 #define LOGGER_SOCKET "/org/freedesktop/systemd1/logger"
44 /* This doesn't really belong here, but I couldn't find a better place to put this. */
45 #define SIGNALS_CRASH_HANDLER SIGSEGV,SIGILL,SIGFPE,SIGBUS,SIGQUIT,SIGABRT
46 #define SIGNALS_IGNORE SIGKILL,SIGPIPE
48 typedef enum KillMode {
49 KILL_CONTROL_GROUP = 0,
54 _KILL_MODE_INVALID = -1
57 typedef enum ExecInput {
64 _EXEC_INPUT_INVALID = -1
67 typedef enum ExecOutput {
75 _EXEC_OUTPUT_INVALID = -1
79 dual_timestamp start_timestamp;
80 dual_timestamp exit_timestamp;
82 int code; /* as in siginfo_t::si_code */
83 int status; /* as in sigingo_t::si_status */
89 ExecStatus exec_status;
91 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
96 struct rlimit *rlimit[RLIMIT_NLIMITS];
97 char *working_directory, *root_directory;
103 int cpu_sched_policy;
104 int cpu_sched_priority;
107 unsigned cpuset_ncpus;
108 unsigned long timer_slack_nsec;
111 ExecOutput std_output;
112 ExecOutput std_error;
115 char *syslog_identifier;
116 bool syslog_level_prefix;
122 /* Since resolving these names might might involve socket
123 * connections and we don't want to deadlock ourselves these
124 * names are resolved on execution only and in the child
128 char **supplementary_groups;
132 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
133 unsigned long mount_flags;
135 uint64_t capability_bounding_set_drop;
140 bool cpu_sched_reset_on_fork;
144 bool oom_adjust_set:1;
147 bool cpu_sched_set:1;
148 bool timer_slack_nsec_set:1;
150 /* This is not exposed to the user but available
151 * internally. We need it to make sure that whenever we spawn
152 * /bin/mount it is run in the same process group as us so
153 * that the autofs logic detects that it belongs to us and we
154 * don't enter a trigger loop. */
157 /* Not relevant for spawning processes, just for killing */
162 typedef enum ExitStatus {
163 /* EXIT_SUCCESS defined by libc */
164 /* EXIT_FAILURE defined by libc */
165 EXIT_INVALIDARGUMENT = 2,
166 EXIT_NOTIMPLEMENTED = 3,
167 EXIT_NOPERMISSION = 4,
168 EXIT_NOTINSTALLED = 5,
169 EXIT_NOTCONFIGURED = 6,
172 /* The LSB suggests that error codes >= 200 are "reserved". We
173 * use them here under the assumption that they hence are
174 * unused by init scripts.
176 * http://refspecs.freestandards.org/LSB_3.1.0/LSB-Core-generic/LSB-Core-generic/iniscrptact.html */
188 EXIT_CHROOT, /* 210 */
198 EXIT_SETSID, /* 220 */
206 int exec_spawn(ExecCommand *command,
208 const ExecContext *context,
209 int fds[], unsigned n_fds,
211 bool apply_permissions,
213 bool apply_tty_stdin,
215 struct CGroupBonding *cgroup_bondings,
218 void exec_command_done(ExecCommand *c);
219 void exec_command_done_array(ExecCommand *c, unsigned n);
221 void exec_command_free_list(ExecCommand *c);
222 void exec_command_free_array(ExecCommand **c, unsigned n);
224 char *exec_command_line(char **argv);
226 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
227 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
228 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
229 int exec_command_set(ExecCommand *c, const char *path, ...);
231 void exec_context_init(ExecContext *c);
232 void exec_context_done(ExecContext *c);
233 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
235 void exec_status_start(ExecStatus *s, pid_t pid);
236 void exec_status_exit(ExecStatus *s, pid_t pid, int code, int status);
237 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
239 const char* exec_output_to_string(ExecOutput i);
240 int exec_output_from_string(const char *s);
242 const char* exec_input_to_string(ExecInput i);
243 int exec_input_from_string(const char *s);
245 const char* exit_status_to_string(ExitStatus status);