service.h

   1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
   2
   3 #ifndef fooservicehfoo
   4 #define fooservicehfoo
   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 Service Service;
  26
  27 #include "unit.h"
  28 #include "ratelimit.h"
  29
  30 typedef enum ServiceState {
  31         SERVICE_DEAD,
  32         SERVICE_START_PRE,
  33         SERVICE_START,
  34         SERVICE_START_POST,
  35         SERVICE_RUNNING,
  36         SERVICE_EXITED,            /* Nothing is running anymore, but ValidNoProcess is true, ehnce this is OK */
  37         SERVICE_RELOAD,
  38         SERVICE_STOP,              /* No STOP_PRE state, instead just register multiple STOP executables */
  39         SERVICE_STOP_SIGTERM,
  40         SERVICE_STOP_SIGKILL,
  41         SERVICE_STOP_POST,
  42         SERVICE_FINAL_SIGTERM,     /* In case the STOP_POST executable hangs, we shoot that down, too */
  43         SERVICE_FINAL_SIGKILL,
  44         SERVICE_MAINTAINANCE,
  45         SERVICE_AUTO_RESTART,
  46         _SERVICE_STATE_MAX,
  47         _SERVICE_STATE_INVALID = -1
  48 } ServiceState;
  49
  50 typedef enum ServiceRestart {
  51         SERVICE_ONCE,
  52         SERVICE_RESTART_ON_SUCCESS,
  53         SERVICE_RESTART_ALWAYS,
  54         _SERVICE_RESTART_MAX,
  55         _SERVICE_RESTART_INVALID = -1
  56 } ServiceRestart;
  57
  58 typedef enum ServiceType {
  59         SERVICE_FORKING,  /* forks by itself (i.e. traditional daemons) */
  60         SERVICE_SIMPLE,   /* we fork and go on right-away (i.e. modern socket activated daemons) */
  61         SERVICE_FINISH,   /* we fork and wait until the program finishes (i.e. programs like fsck which run and need to finish before we continue) */
  62         SERVICE_DBUS,     /* we fork and wait until a specific D-Bus name appears on the bus */
  63         _SERVICE_TYPE_MAX,
  64         _SERVICE_TYPE_INVALID = -1
  65 } ServiceType;
  66
  67 typedef enum ServiceExecCommand {
  68         SERVICE_EXEC_START_PRE,
  69         SERVICE_EXEC_START,
  70         SERVICE_EXEC_START_POST,
  71         SERVICE_EXEC_RELOAD,
  72         SERVICE_EXEC_STOP,
  73         SERVICE_EXEC_STOP_POST,
  74         _SERVICE_EXEC_COMMAND_MAX,
  75         _SERVICE_EXEC_COMMAND_INVALID = -1
  76 } ServiceExecCommand;
  77
  78 struct Service {
  79         Meta meta;
  80
  81         ServiceType type;
  82         ServiceRestart restart;
  83
  84         /* If set we'll read the main daemon PID from this file */
  85         char *pid_file;
  86
  87         usec_t restart_usec;
  88         usec_t timeout_usec;
  89
  90         ExecCommand* exec_command[_SERVICE_EXEC_COMMAND_MAX];
  91         ExecContext exec_context;
  92
  93         bool permissions_start_only;
  94         bool root_directory_start_only;
  95         bool valid_no_process;
  96
  97         ServiceState state, deserialized_state;
  98
  99         KillMode kill_mode;
 100
 101         ExecStatus main_exec_status;
 102
 103         ExecCommand *control_command;
 104         ServiceExecCommand control_command_id;
 105         pid_t main_pid, control_pid;
 106         bool main_pid_known:1;
 107
 108         /* If we shut down, remember why */
 109         bool failure:1;
 110
 111         bool bus_name_good:1;
 112
 113         bool allow_restart:1;
 114
 115         bool got_socket_fd:1;
 116
 117         bool sysv_has_lsb:1;
 118         char *sysv_path;
 119         int sysv_start_priority;
 120         char *sysv_runlevels;
 121
 122         char *bus_name;
 123
 124         RateLimit ratelimit;
 125
 126         int socket_fd;
 127
 128         Watch timer_watch;
 129 };
 130
 131 extern const UnitVTable service_vtable;
 132
 133 int service_set_socket_fd(Service *s, int fd);
 134
 135 const char* service_state_to_string(ServiceState i);
 136 ServiceState service_state_from_string(const char *s);
 137
 138 const char* service_restart_to_string(ServiceRestart i);
 139 ServiceRestart service_restart_from_string(const char *s);
 140
 141 const char* service_type_to_string(ServiceType i);
 142 ServiceType service_type_from_string(const char *s);
 143
 144 const char* service_exec_command_to_string(ServiceExecCommand i);
 145 ServiceExecCommand service_exec_command_from_string(const char *s);
 146
 147 #endif