summaryrefslogtreecommitdiffstats
path: root/man/systemd.syntax.xml
diff options
context:
space:
mode:
authorYu Watanabe <watanabe.yu+github@gmail.com>2018-07-27 10:52:12 +0200
committerLennart Poettering <lennart@poettering.net>2018-07-30 14:13:42 +0200
commit1c57fa90be988b6f50324dbaf1996ddc3e114faf (patch)
treeba4a943851f28e70c040bfe96cb20c688fd26814 /man/systemd.syntax.xml
parentMerge pull request #9734 from irtimmer/feature/dns-over-tls-openssl (diff)
downloadsystemd-1c57fa90be988b6f50324dbaf1996ddc3e114faf.tar.xz
systemd-1c57fa90be988b6f50324dbaf1996ddc3e114faf.zip
man: move explanations about boolean and time-span value from systemd.unit to systemd.syntax
Fixes #9735.
Diffstat (limited to 'man/systemd.syntax.xml')
-rw-r--r--man/systemd.syntax.xml24
1 files changed, 24 insertions, 0 deletions
diff --git a/man/systemd.syntax.xml b/man/systemd.syntax.xml
index 1bb8e6bbd4..3c67e92dd5 100644
--- a/man/systemd.syntax.xml
+++ b/man/systemd.syntax.xml
@@ -87,6 +87,23 @@ KeyTwo=value 2 \
value 2 continued
</programlisting></example>
+ <para>Boolean arguments used in configuration files can be written in
+ various formats. For positive settings the strings
+ <option>1</option>, <option>yes</option>, <option>true</option>
+ and <option>on</option> are equivalent. For negative settings, the
+ strings <option>0</option>, <option>no</option>,
+ <option>false</option> and <option>off</option> are
+ equivalent.</para>
+
+ <para>Time span values encoded in configuration files can be written in various formats. A stand-alone
+ number specifies a time in seconds. If suffixed with a time unit, the unit is honored. A
+ concatenation of multiple values with units is supported, in which case the values are added
+ up. Example: <literal>50</literal> refers to 50 seconds; <literal>2min 200ms</literal> refers to
+ 2 minutes and 200 milliseconds, i.e. 120200 ms. The following time units are understood:
+ <literal>s</literal>, <literal>min</literal>, <literal>h</literal>, <literal>d</literal>,
+ <literal>w</literal>, <literal>ms</literal>, <literal>us</literal>. For details see
+ <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
+
<para>Various settings are allowed to be specified more than once, in which case the
interpretation depends on the setting. Often, multiple settings form a list, and setting to an
empty value "resets", which means that previous assignments are ignored. When this is allowed,
@@ -95,4 +112,11 @@ KeyTwo=value 2 \
file format.</para>
</refsect1>
+ <refsect1>
+ <title>See Also</title>
+ <para>
+ <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry>
+ </para>
+ </refsect1>
+
</refentry>