cdist/cdist/conf/type/__systemd_unit/man.rst

86 lines
1.8 KiB
ReStructuredText

cdist-type__systemd_unit(7)
===========================
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' 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
absent
the unit is stopped, disabled and uninstalled
BOOLEAN PARAMETERS
------------------
restart
Restart the unit on unit file change or when the unit is inactive.
MESSAGES
--------
None.
EXAMPLES
--------
.. code-block:: sh
# 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.