90 lines
2.0 KiB
ReStructuredText
90 lines
2.0 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', '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
|
|
--------
|
|
|
|
.. 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.
|