execute.h

   1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
   2
   3 #ifndef fooexecutehfoo
   4 #define fooexecutehfoo
   5
   6 /***
   7   This file is part of systemd.
   8
   9   Copyright 2010 Lennart Poettering
  10
  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.
  15
  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.
  20
  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/>.
  23 ***/
  24
  25 typedef struct ExecStatus ExecStatus;
  26 typedef struct ExecCommand ExecCommand;
  27 typedef struct ExecContext ExecContext;
  28
  29 #include <sys/time.h>
  30 #include <sys/resource.h>
  31 #include <sys/capability.h>
  32 #include <stdbool.h>
  33 #include <stdio.h>
  34 #include <sched.h>
  35
  36 struct CGroupBonding;
  37
  38 #include "list.h"
  39 #include "util.h"
  40
  41 /* Abstract namespace! */
  42 #define LOGGER_SOCKET "/org/freedesktop/systemd1/logger"
  43
  44 typedef enum ExecInput {
  45         EXEC_INPUT_NULL,
  46         EXEC_INPUT_TTY,
  47         EXEC_INPUT_TTY_FORCE,
  48         EXEC_INPUT_TTY_FAIL,
  49         EXEC_INPUT_SOCKET,
  50         _EXEC_INPUT_MAX,
  51         _EXEC_INPUT_INVALID = -1
  52 } ExecInput;
  53
  54 typedef enum ExecOutput {
  55         EXEC_OUTPUT_INHERIT,
  56         EXEC_OUTPUT_NULL,
  57         EXEC_OUTPUT_TTY,
  58         EXEC_OUTPUT_SYSLOG,
  59         EXEC_OUTPUT_KERNEL,
  60         EXEC_OUTPUT_SOCKET,
  61         _EXEC_OUTPUT_MAX,
  62         _EXEC_OUTPUT_INVALID = -1
  63 } ExecOutput;
  64
  65 struct ExecStatus {
  66         pid_t pid;
  67         usec_t start_timestamp;
  68         usec_t exit_timestamp;
  69         int code;     /* as in siginfo_t::si_code */
  70         int status;   /* as in sigingo_t::si_status */
  71 };
  72
  73 struct ExecCommand {
  74         char *path;
  75         char **argv;
  76         ExecStatus exec_status;
  77         LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
  78 };
  79
  80 struct ExecContext {
  81         char **environment;
  82         mode_t umask;
  83         struct rlimit *rlimit[RLIMIT_NLIMITS];
  84         char *working_directory, *root_directory;
  85         int oom_adjust;
  86         int nice;
  87         int ioprio;
  88         int cpu_sched_policy;
  89         int cpu_sched_priority;
  90         cpu_set_t cpu_affinity;
  91         unsigned long timer_slack_ns;
  92
  93         bool oom_adjust_set:1;
  94         bool nice_set:1;
  95         bool ioprio_set:1;
  96         bool cpu_sched_set:1;
  97         bool cpu_affinity_set:1;
  98         bool timer_slack_ns_set:1;
  99
 100         /* This is not exposed to the user but available
 101          * internally. We need it to make sure that whenever we spawn
 102          * /bin/mount it is run in the same process group as us so
 103          * that the autofs logic detects that it belongs to us and we
 104          * don't enter a trigger loop. */
 105         bool no_setsid:1;
 106
 107         bool cpu_sched_reset_on_fork;
 108         bool non_blocking;
 109
 110         ExecInput std_input;
 111         ExecOutput std_output;
 112         ExecOutput std_error;
 113
 114         char *tty_path;
 115
 116         int syslog_priority;
 117         char *syslog_identifier;
 118
 119         cap_t capabilities;
 120         int secure_bits;
 121         uint64_t capability_bounding_set_drop;
 122
 123         /* Since resolving these names might might involve socket
 124          * connections and we don't want to deadlock ourselves these
 125          * names are resolved on execution only and in the child
 126          * process. */
 127         char *user;
 128         char *group;
 129         char **supplementary_groups;
 130 };
 131
 132 typedef enum ExitStatus {
 133         /* EXIT_SUCCESS defined by libc */
 134         /* EXIT_FAILURE defined by libc */
 135         EXIT_INVALIDARGUMENT = 2,
 136         EXIT_NOTIMPLEMENTED = 3,
 137         EXIT_NOPERMISSION = 4,
 138         EXIT_NOTINSTALLED = 5,
 139         EXIT_NOTCONFIGURED = 6,
 140         EXIT_NOTRUNNING = 7,
 141
 142         /* The LSB suggests that error codes >= 200 are "reserved". We
 143          * use them here under the assumption that they hence are
 144          * unused by init scripts.
 145          *
 146          * http://refspecs.freestandards.org/LSB_3.1.0/LSB-Core-generic/LSB-Core-generic/iniscrptact.html */
 147
 148         EXIT_CHDIR = 200,
 149         EXIT_NICE,
 150         EXIT_FDS,
 151         EXIT_EXEC,
 152         EXIT_MEMORY,
 153         EXIT_LIMITS,
 154         EXIT_OOM_ADJUST,
 155         EXIT_SIGNAL_MASK,
 156         EXIT_STDIN,
 157         EXIT_STDOUT,
 158         EXIT_CHROOT,   /* 210 */
 159         EXIT_IOPRIO,
 160         EXIT_TIMERSLACK,
 161         EXIT_SECUREBITS,
 162         EXIT_SETSCHEDULER,
 163         EXIT_CPUAFFINITY,
 164         EXIT_GROUP,
 165         EXIT_USER,
 166         EXIT_CAPABILITIES,
 167         EXIT_CGROUP,
 168         EXIT_SETSID,   /* 220 */
 169         EXIT_CONFIRM,
 170         EXIT_STDERR
 171
 172 } ExitStatus;
 173
 174 int exec_spawn(ExecCommand *command,
 175                char **argv,
 176                const ExecContext *context,
 177                int fds[], unsigned n_fds,
 178                bool apply_permissions,
 179                bool apply_chroot,
 180                bool confirm_spawn,
 181                struct CGroupBonding *cgroup_bondings,
 182                pid_t *ret);
 183
 184 void exec_command_done(ExecCommand *c);
 185 void exec_command_done_array(ExecCommand *c, unsigned n);
 186
 187 void exec_command_free_list(ExecCommand *c);
 188 void exec_command_free_array(ExecCommand **c, unsigned n);
 189
 190 char *exec_command_line(char **argv);
 191
 192 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
 193 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
 194 void exec_command_append_list(ExecCommand **l, ExecCommand *e);
 195 int exec_command_set(ExecCommand *c, const char *path, ...);
 196
 197 void exec_context_init(ExecContext *c);
 198 void exec_context_done(ExecContext *c);
 199 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
 200
 201 void exec_status_fill(ExecStatus *s, pid_t pid, int code, int status);
 202 void exec_status_dump(ExecStatus *s, FILE *f, const char *prefix);
 203
 204 const char* exec_output_to_string(ExecOutput i);
 205 int exec_output_from_string(const char *s);
 206
 207 const char* exec_input_to_string(ExecInput i);
 208 int exec_input_from_string(const char *s);
 209
 210 const char* exit_status_to_string(ExitStatus status);
 211
 212 #endif