NAME

       cdist-type__systemd_unit - Install a systemd unit

DESCRIPTION

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

REQUIRED PARAMETERS

       None.

OPTIONAL PARAMETERS

       enablement-state
              'enabled', 'disabled' or 'masked', where:

              enabled
                     enables the unit

              disabled
                     disables the unit

              masked masks the unit

       source Path to the config file. If source is '-' (dash), take what was written to  stdin  as  the  config
              file content.

       state  'present' or 'absent', defaults to 'present' where:

              present
                     the unit (or its mask) is installed

              absent The unit is stopped, disabled and uninstalled. If the unit was masked, the mask is removed.

BOOLEAN PARAMETERS

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

MESSAGES

       None.

EXAMPLES

          # Installs, enables and starts foobar.service
          __systemd_unit foobar.service \
              --source "${__manifest}/files/foobar.service" \
              --enablement-state enabled \
              --restart

          # Disables the unit
          __systemd_unit foobar.service --enablement-state disabled

          # Stops, disables and uninstalls foobar.service
          __systemd_unit foobar.service --state absent

AUTHORS

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

COPYING

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

COPYRIGHT

       ungleich GmbH 2021

7.0.0                                             Sep 11, 2024                       CDIST-TYPE__SYSTEMD_UNIT(7)