14.135. cdist-type__systemd_unit(7)¶

14.135.1. NAME¶

cdist-type__systemd_unit - Install a systemd unit

14.135.2. DESCRIPTION¶

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

14.135.3. REQUIRED PARAMETERS¶

None.

14.135.4. OPTIONAL PARAMETERS¶

enablement-state

'enabled' or 'disabled', where:

enabled: enables the unit
disabled: disables 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 is installed, enabled and started
absent: the unit is stopped, disabled and uninstalled

14.135.5. BOOLEAN PARAMETERS¶

restart: Restart the unit on unit file change or when the unit is inactive.

14.135.6. MESSAGES¶

None.

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

14.135.8. AUTHORS¶

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

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