src/functions/functions.service

   1 #!/bin/bash
   2 ###############################################################################
   3 #                                                                             #
   4 # IPFire.org - A linux based firewall                                         #
   5 # Copyright (C) 2010  Michael Tremer & Christian Schmidt                      #
   6 #                                                                             #
   7 # This program is free software: you can redistribute it and/or modify        #
   8 # it under the terms of the GNU General Public License as published by        #
   9 # the Free Software Foundation, either version 3 of the License, or           #
  10 # (at your option) any later version.                                         #
  11 #                                                                             #
  12 # This program is distributed in the hope that it will be useful,             #
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of              #
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               #
  15 # GNU General Public License for more details.                                #
  16 #                                                                             #
  17 # You should have received a copy of the GNU General Public License           #
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.       #
  19 #                                                                             #
  20 ###############################################################################
  21
  22 service_start() {
  23         local name=${1}
  24         assert isset name
  25
  26         # Don't start anything if this is already running
  27         if service_is_active "${name}"; then
  28                 return ${EXIT_OK}
  29         fi
  30
  31         systemctl start "${name}"
  32
  33         # Check, if the service was successfully started and
  34         # return a proper exit code.
  35         service_is_active "${name}"
  36         local ret=$?
  37
  38         log INFO "Started service '${name}', code=${ret}."
  39
  40         return ${ret}
  41 }
  42
  43 service_stop() {
  44         local name="${1}"
  45         assert isset name
  46
  47         systemctl stop "${name}"
  48 }
  49
  50 service_restart() {
  51         local name="${1}"
  52         assert isset name
  53
  54         systemctl restart "${name}"
  55 }
  56
  57 service_reload() {
  58         local name="${1}"
  59         assert isset name
  60
  61         if service_status "${name}"; then
  62                 systemctl reload "${name}"
  63                 return $?
  64         else
  65                 log WARNING "Cannot reload service '${name}' which is currently not running."
  66         fi
  67 }
  68
  69 service_status() {
  70         local name="${1}"
  71         assert isset name
  72
  73         systemctl status "${name}" >/dev/null 2>&1
  74         return $?
  75 }
  76
  77 # This function calls the "enable" command from systemd,
  78 # to mark services to be automatically started during
  79 # boot up.
  80 service_enable() {
  81         local name="${1}"
  82         assert isset name
  83
  84         systemctl enable "${name}" >/dev/null 2>&1
  85 }
  86
  87 # This function calls the "disable" command of systemd,
  88 # to drop the autostart ability of the service during the
  89 # boot up.
  90 service_disable() {
  91         local name="${1}"
  92         assert isset name
  93
  94         systemctl disable "${name}" >/dev/null 2>&1
  95 }
  96
  97 # This function uses the systemd command "is-enabled" to check,
  98 # if a service has been enabled or not.
  99 service_is_enabled() {
 100         local name="${1}"
 101         assert isset name
 102
 103         systemctl is-enabled "${name}" >/dev/null 2>&1
 104         return $?
 105 }
 106
 107 service_is_active() {
 108         local name="${1}"
 109         assert isset name
 110
 111         systemctl is-active "${name}" >/dev/null 2>&1
 112         return $?
 113 }
 114
 115 service_get_exitcode() {
 116         local name=${1}
 117         assert isset name
 118
 119         local output=$(systemctl show "${name}" --property="ExecMainStatus")
 120         cli_get_val "${output}"
 121 }