summaryrefslogtreecommitdiff
path: root/src/modules/services-systemd/services-systemd.conf
diff options
context:
space:
mode:
Diffstat (limited to 'src/modules/services-systemd/services-systemd.conf')
-rw-r--r--src/modules/services-systemd/services-systemd.conf92
1 files changed, 92 insertions, 0 deletions
diff --git a/src/modules/services-systemd/services-systemd.conf b/src/modules/services-systemd/services-systemd.conf
new file mode 100644
index 000000000..c4afc6efc
--- /dev/null
+++ b/src/modules/services-systemd/services-systemd.conf
@@ -0,0 +1,92 @@
+# Systemd services manipulation.
+#
+# This module can enable services and targets for systemd
+# (if packaging doesn't already do that). It can calso
+# disable services (but not targets).
+#
+# First, services are enabled; then targets; then services
+# are disabled -- this order of operations is fixed.
+---
+
+# There are three configuration keys for this module:
+# *services*, *targets* and *disable*. The value of each
+# key is a list of entries. Each entry has two keys:
+# - *name* is the (string) name of the service or target that is being
+# changed. Use quotes. Don't include ".target" or ".service"
+# in the name.
+# - *mandatory* is a boolean option, which states whether the change
+# must be done successfully. If systemd reports an error while changing
+# a mandatory entry, the installation will fail. When mandatory is false,
+# errors for that entry (service or target) are ignored. If mandatory
+# is not specified, the default is false.
+#
+# An entry may also be given as a single string, which is then
+# interpreted as the name of the service. In this case, mandatory
+# is also set to the default of false.
+#
+# Use [] to express an empty list.
+
+# # This example enables NetworkManager (and fails if it can't),
+# # disables cups (and ignores failure). Then it enables the
+# # graphical target (e.g. so that SDDM runs for login), and
+# # finally disables pacman-init (an ArchLinux-only service).
+# #
+# # Enables <name>.service
+# services:
+# - name: "NetworkManager"
+# mandatory: true
+# - name: "cups"
+# mandatory: false
+#
+# # Enables <name>.target
+# targets:
+# - name: "graphical"
+# mandatory: true
+#
+# # Disables <name>.service
+# disable:
+# - name: "pacman-init"
+# mandatory: false
+#
+# # Disables <name>.target
+# # .. this shows how to use just the name
+# disable-targets:
+# - graphical
+#
+# # Masks (stronger version of disable). This section
+# # is unusual because you **must** include the suffix
+# # (e.g. ".service") as part of the name, so, e.g. to mask
+# # NetworkManager (rather than just disable it) you must
+# # specify "NetworkManager.service" as name.
+# mask:
+# - name: "NetworkManager.service"
+# - mandatory: true
+
+# By default, no changes are made.
+services: [] # deferred
+targets: [] # deferred
+disable: [] # deferred
+disable-targets: []
+mask: []
+
+systemd-services:
+ - name: "NetworkManager"
+ mandatory: false
+ - name: "cups"
+ mandatory: false
+
+lxde-services:
+ - name: "lxdm"
+ mandatory: true
+
+mate-services:
+ - name: "lightdm"
+ mandatory: true
+
+systemd-targets:
+ - name: "graphical"
+ mandatory: true
+
+systemd-disable:
+ - name: "pacman-init"
+ mandatory: false