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