cdist-type__systemd_unit - Install a systemd unit

Authors

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

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.

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)

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).

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

Messages

       None.

Name

       cdist-type__systemd_unit - Install a systemd unit

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.