1CDIST-TYPE__SYSTEMD_UNIT(7)          cdist         CDIST-TYPE__SYSTEMD_UNIT(7)
2
3
4

NAME

6       cdist-type__systemd_unit - Install a systemd unit
7

DESCRIPTION

9       This  type  manages  systemd  units in /etc/systemd/system/. It can in‐
10       stall, enable and start a systemd unit. This is particularly useful  on
11       systems  which  take  advantage  of systemd heavily (e.g., CoreOS). For
12       more information about systemd units, see SYSTEMD.UNIT(5).
13

REQUIRED PARAMETERS

15       None.
16

OPTIONAL PARAMETERS

18       enablement-state
19              'enabled', 'disabled' or 'masked', where:
20
21              enabled
22                     enables the unit
23
24              disabled
25                     disables the unit
26
27              masked masks the unit
28
29       source Path to the config file. If source is '-' (dash), take what  was
30              written to stdin as the config file content.
31
32       state  'present' or 'absent', defaults to 'present' where:
33
34              present
35                     the unit (or its mask) is installed
36
37              absent The  unit  is  stopped,  disabled and uninstalled. If the
38                     unit was masked, the mask is removed.
39

BOOLEAN PARAMETERS

41       restart
42              Start the unit if it was inactive. Restart the unit if the  unit
43              file changed. Stop the unit if new enablement-state is masked.
44

MESSAGES

46       None.
47

EXAMPLES

49          # Installs, enables and starts foobar.service
50          __systemd_unit foobar.service \
51              --source "${__manifest}/files/foobar.service" \
52              --enablement-state enabled \
53              --restart
54
55          # Disables the unit
56          __systemd_unit foobar.service --enablement-state disabled
57
58          # Stops, disables and uninstalls foobar.service
59          __systemd_unit foobar.service --state absent
60

AUTHORS

62       Ľubomír Kučera <lubomir.kucera.jr at gmail.com>
63

COPYING

65       Copyright  (C) 2017 Ľubomír Kučera. You can redistribute it and/or mod‐
66       ify it under the terms of the GNU General Public License  as  published
67       by  the  Free  Software Foundation, either version 3 of the License, or
68       (at your option) any later version.
69

71       ungleich GmbH 2020
72
73
74
75
766.9.6                            Apr 20, 2021      CDIST-TYPE__SYSTEMD_UNIT(7)
Impressum