diff options
author | Joerg Behrmann <behrmann@physik.fu-berlin.de> | 2020-03-10 16:34:13 +0100 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2020-03-17 17:12:06 +0100 |
commit | 1f667d8a7cff4355cd23ebebeb4d7179e3498eb8 (patch) | |
tree | 62e5e6970755e8d30a90ab504d432b97fd011a5f /man/systemd.preset.xml | |
parent | 34bc838f1529f2d0bd8f4e3247dfed703b68a8ca (diff) | |
download | systemd-1f667d8a7cff4355cd23ebebeb4d7179e3498eb8.tar.gz |
docs: Add syntax for templated units to systemd.preset man page
This documents the syntax
enable template@.service foo bar baz
that was introduced in #9901 to preset templated units.
Diffstat (limited to 'man/systemd.preset.xml')
-rw-r--r-- | man/systemd.preset.xml | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/man/systemd.preset.xml b/man/systemd.preset.xml index 795da35ec8..092c186738 100644 --- a/man/systemd.preset.xml +++ b/man/systemd.preset.xml @@ -71,7 +71,10 @@ <literal>disable</literal> followed by a space and a unit name (possibly with shell style wildcards), separated by newlines. Empty lines and lines whose first non-whitespace character is <literal>#</literal> or - <literal>;</literal> are ignored.</para> + <literal>;</literal> are ignored. Multiple instance names for unit + templates may be specified as a space separated list at the end of + the line instead of the customary position between <literal>@</literal> + and the unit suffix.</para> <para>Presets must refer to the "real" unit file, and not to any aliases. See <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> @@ -124,6 +127,17 @@ disable *</programlisting> be overridden by spin or administrator preset policy.</para> <example> + <title>Enable multiple template instances</title> + + <programlisting># /usr/lib/systemd/system-preset/80-dirsrv.preset + +enable dirsrv@.service foo bar baz</programlisting> + </example> + + <para>This enables all three of <filename>dirsrv@foo.service</filename>, + <filename>dirsrv@bar.service</filename> and <filename>dirsrv@baz.service</filename>.</para> + + <example> <title>A GNOME spin</title> <programlisting># /usr/lib/systemd/system-preset/50-gnome.preset |