See Bug 87688 (https://bugs.freedesktop.org/show_bug.cgi?id=87688).
This patch adds more detail to the description of how path escaping
operates and provides a pointer to the systemd-escape program. Either
would serve to answer the question raised in the bug report, so
hopefully this will allow it to be closed.
Regards>From 84fd39e106a13ec8a546c7d8ecc114f2901d1d82 Mon Sep 17 00:00:00 2001
From: Chris Atkinson
Date: Thu, 1 Jan 2015 16:16:56 -0500
Subject: [PATCH 2/2] Clarify path escaping and reference systemd-escape
---
man/systemd.unit.xml | 17 +++--
1 file changed, 11 insertions(+), 6 deletions(-)
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 1afa600..39ea429 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -229,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
--
2.2.1
___
systemd-devel mailing list
systemd-devel@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/systemd-devel
