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 typedef enum ExecInput {
51 _EXEC_INPUT_INVALID = -1
54 typedef enum ExecOutput {
62 _EXEC_OUTPUT_INVALID = -1
66 usec_t start_timestamp;
67 usec_t exit_timestamp;
69 int code; /* as in siginfo_t::si_code */
70 int status; /* as in sigingo_t::si_status */
76 ExecStatus exec_status;
77 LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
82 struct rlimit *rlimit[RLIMIT_NLIMITS];
83 char *working_directory, *root_directory;
90 int cpu_sched_priority;
92 cpu_set_t cpu_affinity;
93 unsigned long timer_slack_ns;
96 ExecOutput std_output;
100 char *syslog_identifier;
101 bool syslog_no_prefix;
105 /* Since resolving these names might might involve socket
106 * connections and we don't want to deadlock ourselves these
107 * names are resolved on execution only and in the child
111 char **supplementary_groups;
113 char **read_write_dirs, **read_only_dirs, **inaccessible_dirs;
114 unsigned long mount_flags;
116 uint64_t capability_bounding_set_drop;
121 bool cpu_sched_reset_on_fork;
125 bool oom_adjust_set:1;
128 bool cpu_sched_set:1;
129 bool cpu_affinity_set:1;
130 bool timer_slack_ns_set:1;
132 /* This is not exposed to the user but available
133 * internally. We need it to make sure that whenever we spawn
134 * /bin/mount it is run in the same process group as us so
135 * that the autofs logic detects that it belongs to us and we
136 * don't enter a trigger loop. */
140 typedef enum ExitStatus {
141 /* EXIT_SUCCESS defined by libc */
142 /* EXIT_FAILURE defined by libc */
143 EXIT_INVALIDARGUMENT = 2,
144 EXIT_NOTIMPLEMENTED = 3,
145 EXIT_NOPERMISSION = 4,
146 EXIT_NOTINSTALLED = 5,
147 EXIT_NOTCONFIGURED = 6,
150 /* The LSB suggests that error codes >= 200 are "reserved". We
151 * use them here under the assumption that they hence are
152 * unused by init scripts.
154 * http://refspecs.freestandards.org/LSB_3.1.0/LSB-Core-generic/LSB-Core-generic/iniscrptact.html */
166 EXIT_CHROOT, /* 210 */
176 EXIT_SETSID, /* 220 */
182 int exec_spawn(ExecCommand *command,
184 const ExecContext *context,
185 int fds[], unsigned n_fds,
187 bool apply_permissions,
190 struct CGroupBonding *cgroup_bondings,
193 void exec_command_done(ExecCommand *c);
194 void exec_command_done_array(ExecCommand *c, unsigned n);
196 void exec_command_free_list(ExecCommand *c);
197 void exec_command_free_array(ExecCommand **c, unsigned n);
199 char *exec_command_line(char **argv);
201 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
202 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
203 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
204 int exec_command_set(ExecCommand *c, const char *path, ...);
206 void exec_context_init(ExecContext *c);
207 void exec_context_done(ExecContext *c);
208 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
210 void exec_status_fill(ExecStatus *s, pid_t pid, int code, int status);
211 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
213 const char* exec_output_to_string(ExecOutput i);
214 int exec_output_from_string(const char *s);
216 const char* exec_input_to_string(ExecInput i);
217 int exec_input_from_string(const char *s);
219 const char* exit_status_to_string(ExitStatus status);