execute.h

   1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
   2
   3 #ifndef fooexecutehfoo
   4 #define fooexecutehfoo
   5
   6 typedef struct ExecStatus ExecStatus;
   7 typedef struct ExecCommand ExecCommand;
   8 typedef struct ExecContext ExecContext;
   9
  10 #include <sys/time.h>
  11 #include <sys/resource.h>
  12 #include <sys/capability.h>
  13 #include <stdbool.h>
  14 #include <stdio.h>
  15
  16 #include "list.h"
  17 #include "util.h"
  18
  19 /* Abstract namespace! */
  20 #define LOGGER_SOCKET "/systemd/logger"
  21
  22 typedef enum ExecOutput {
  23         EXEC_CONSOLE,
  24         EXEC_NULL,
  25         EXEC_SYSLOG,
  26         EXEC_KERNEL
  27 } ExecOutput;
  28
  29 struct ExecStatus {
  30         pid_t pid;
  31         usec_t timestamp;
  32         int code;     /* as in siginfo_t::si_code */
  33         int status;   /* as in sigingo_t::si_status */
  34 };
  35
  36 struct ExecCommand {
  37         char *path;
  38         char **argv;
  39         ExecStatus exec_status;
  40         LIST_FIELDS(ExecCommand, command); /* useful for chaining commands */
  41 };
  42
  43 struct ExecContext {
  44         char **environment;
  45         mode_t umask;
  46         struct rlimit *rlimit[RLIMIT_NLIMITS];  /* FIXME: load-fragment parser missing */
  47         int oom_adjust;
  48         int nice;
  49         char *directory;
  50
  51         ExecOutput output;
  52         int syslog_priority;
  53         char *syslog_identifier;
  54
  55          /* FIXME: all privs related settings need parser and enforcer */
  56         cap_t capabilities;
  57         bool capabilities_set:1;
  58
  59         /* since resolving these names might might involve socket
  60          * connections and we don't want to deadlock ourselves these
  61          * names are resolved on execution only. */
  62         char *user;
  63         char *group;
  64         char **supplementary_groups;
  65 };
  66
  67 typedef enum ExitStatus {
  68         /* EXIT_SUCCESS defined by libc */
  69         /* EXIT_FAILURE defined by libc */
  70         EXIT_INVALIDARGUMENT = 2,
  71         EXIT_NOTIMPLEMENTED = 3,
  72         EXIT_NOPERMISSION = 4,
  73         EXIT_NOTINSTALLED = 5,
  74         EXIT_NOTCONFIGURED = 6,
  75         EXIT_NOTRUNNING = 7,
  76
  77         /* The LSB suggests that error codes >= 200 are "reserved". We
  78          * use them here under the assumption that they hence are
  79          * unused by init scripts.
  80          *
  81          * http://refspecs.freestandards.org/LSB_3.1.0/LSB-Core-generic/LSB-Core-generic/iniscrptact.html */
  82
  83         EXIT_CHDIR = 200,
  84         EXIT_NICE,
  85         EXIT_FDS,
  86         EXIT_EXEC,
  87         EXIT_MEMORY,
  88         EXIT_LIMITS,
  89         EXIT_OOM_ADJUST,
  90         EXIT_SIGNAL_MASK,
  91         EXIT_OUTPUT
  92 } ExitStatus;
  93
  94 int exec_spawn(const ExecCommand *command, const ExecContext *context, int *fds, unsigned n_fds, pid_t *ret);
  95
  96 void exec_command_free_list(ExecCommand *c);
  97 void exec_command_free_array(ExecCommand **c, unsigned n);
  98
  99 char *exec_command_line(ExecCommand *c);
 100 void exec_command_dump(ExecCommand *c, FILE *f, const char *prefix);
 101 void exec_command_dump_list(ExecCommand *c, FILE *f, const char *prefix);
 102
 103 void exec_context_init(ExecContext *c);
 104 void exec_context_done(ExecContext *c);
 105 void exec_context_dump(ExecContext *c, FILE* f, const char *prefix);
 106
 107 void exec_status_fill(ExecStatus *s, pid_t pid, int code, int status);
 108
 109 #endif