summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2014-12-25 11:12:54 -0500
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2014-12-25 11:13:13 -0500
commitb7a4d8de9273fab20e1e32e4846b6a866884e07a (patch)
treef059c1d2aca0b122244a519eb896e60ac43f92e5
parentaa1aad74e6b14730542c26a7c17c5d06c62b6089 (diff)
man: add a note why %U,%h,%s are mostly useless
The reasons were already given in the description of %U, but the are easy to overlook, and it's better to be explicit to avoid confusion.
-rw-r--r--man/systemd.unit.xml10
1 files changed, 10 insertions, 0 deletions
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 2e298ca04f..1afa600a08 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -1556,6 +1556,16 @@
</tbody>
</tgroup>
</table>
+
+ <para>Please note that specifiers
+ <literal>%U</literal>, <literal>%h</literal>,
+ <literal>%s</literal> are mostly useless when systemd
+ is running in system mode. PID 1 cannot query the
+ user account database for information, so the
+ specifiers only work as shortcuts for things which are
+ already specified in a different way in the unit
+ file. They are fully functional when systemd is
+ running in <option>--user</option> mode.</para>
</refsect1>
<refsect1>