diff options
| author | Lucas Werkmeister <mail@lucaswerkmeister.de> | 2016-10-30 15:43:01 +0100 |
|---|---|---|
| committer | Lucas Werkmeister <mail@lucaswerkmeister.de> | 2018-06-25 11:13:38 +0200 |
| commit | e563e2534c074f3d10cb1eb9e9bb4eb623590587 (patch) | |
| tree | d4ff3c045d3b5e3a531af979912c243129b9f50b /man/systemd-escape.xml | |
| parent | a26fec240862c7bc466f468490bae2395f263708 (diff) | |
| download | systemd-e563e2534c074f3d10cb1eb9e9bb4eb623590587.tar.gz | |
escape: support --unescape with --template
Diffstat (limited to 'man/systemd-escape.xml')
| -rw-r--r-- | man/systemd-escape.xml | 15 |
1 files changed, 10 insertions, 5 deletions
diff --git a/man/systemd-escape.xml b/man/systemd-escape.xml index 41014abc73..8329e5d7c4 100644 --- a/man/systemd-escape.xml +++ b/man/systemd-escape.xml @@ -76,9 +76,11 @@ <listitem><para>Inserts the escaped strings in a unit name template. Takes a unit name template such as - <filename>foobar@.service</filename>. May not be used in - conjunction with <option>--suffix=</option>, - <option>--unescape</option> or + <filename>foobar@.service</filename>. With + <option>--unescape</option>, expects instantiated unit names + for this template and extracts and unescapes just the instance + part. May not be used in conjunction with + <option>--suffix=</option> or <option>--mangle</option>.</para></listitem> </varlistentry> @@ -100,8 +102,7 @@ <listitem><para>Instead of escaping the specified strings, undo the escaping, reversing the operation. May not be used in - conjunction with <option>--suffix=</option>, - <option>--template=</option> or + conjunction with <option>--suffix=</option> or <option>--mangle</option>.</para></listitem> </varlistentry> @@ -141,6 +142,10 @@ tmp-waldi-foobar.mount</programlisting> <para>To generate instance names of three strings:</para> <programlisting>$ systemd-escape --template=systemd-nspawn@.service 'My Container 1' 'containerb' 'container/III' systemd-nspawn@My\x20Container\x201.service systemd-nspawn@containerb.service systemd-nspawn@container-III.service</programlisting> + + <para>To extract the instance part of an instantiated unit:</para> + <programlisting>$ systemd-escape -u --template=systemd-nspawn@.service 'systemd-nspawn@My\x20Container\x201.service' +My Container 1</programlisting> </refsect1> <refsect1> |