X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.unit.xml;h=bf0deb1f97cd64d983a67daf1f9e0f25b58e4281;hb=56e6c2abb8f18bba2bb9d96d66ac7e633349ddfb;hp=dddcf09e3dc343573f9446d2a48a85b38b50dc7e;hpb=90a2ec10f2d43a8530aae856013518eb567c4039;p=elogind.git
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index dddcf09e3..bf0deb1f9 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -211,6 +211,10 @@
template .d/ subdirectory and reads
its .conf files.
+
+
Note that while systemd offers a flexible
dependency system between units it is recommended to
use this functionality only sparingly and instead rely
@@ -225,12 +229,17 @@
the file system namespace. If this applies, a special
way to escape the path name is used, so that the
result is usable as part of a filename. Basically,
- given a path, "/" is replaced by "-", and all
- unprintable characters and the "-" are replaced by
- C-style "\x2d" escapes. The root directory "/" is
- encoded as single dash, while otherwise the initial
- and ending "/" is removed from all paths during
- transformation. This escaping is reversible.
+ given a path, "/" is replaced by "-" and all other
+ characters which are not ASCII alphanumerics are
+ replaced by C-style "\x2d" escapes (except that "_"
+ is never replaced and "." is only replaced when it
+ would be the first character in the escaped path).
+ The root directory "/" is encoded as single dash,
+ while otherwise the initial and ending "/" are removed
+ from all paths during transformation. This escaping
+ is reversible. Properly escaped paths can be generated
+ using the systemd-escape1
+ command.
Optionally, units may be instantiated from a
template file at runtime. This allows creation of
@@ -1552,6 +1561,16 @@
+
+ Please note that specifiers
+ %U, %h,
+ %s 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 mode.
@@ -1573,7 +1592,7 @@
systemd.scope5,
systemd.slice5,
systemd.time7,
- systemd-verify1,
+ systemd-analyze1,
capabilities7,
systemd.directives7,
uname1