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-26 14:34:04 +0100 |
commit | 6127224ef9a030fd49387fda83253efe9f3faa0b (patch) | |
tree | da9d6ab2c9baada8a8178aa488854f0d86b23f8e | |
parent | b431688238684405b9708a2af7106f82da04ed56 (diff) | |
download | systemd-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.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 |