summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJoerg Behrmann <behrmann@physik.fu-berlin.de>2020-03-10 16:34:13 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2020-03-26 14:34:04 +0100
commit6127224ef9a030fd49387fda83253efe9f3faa0b (patch)
treeda9d6ab2c9baada8a8178aa488854f0d86b23f8e
parentb431688238684405b9708a2af7106f82da04ed56 (diff)
downloadsystemd-6127224ef9a030fd49387fda83253efe9f3faa0b.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. (cherry picked from commit 1f667d8a7cff4355cd23ebebeb4d7179e3498eb8) (cherry picked from commit d1d3f2aa1561a9a75ce58026ef0a6bd4c5b464ac) (cherry picked from commit f4d5928122fe632b441145750a03d95fd8dd2cc6)
-rw-r--r--man/systemd.preset.xml16
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