summaryrefslogtreecommitdiff
path: root/man/portablectl.xml
diff options
context:
space:
mode:
authorLuca Boccassi <luca.boccassi@microsoft.com>2022-01-17 15:11:29 +0000
committerYu Watanabe <watanabe.yu+github@gmail.com>2022-01-18 14:28:03 +0900
commite91aa2ea23e17c3f589376aab626adc2096e97c7 (patch)
treefdfc163728b1e2420316a5d0052bfa99211fd0e0 /man/portablectl.xml
parentcd7b60a7ed94f43ed0581e2c510bc239a70752f9 (diff)
downloadsystemd-e91aa2ea23e17c3f589376aab626adc2096e97c7.tar.gz
man: add more references for extensions to portablectl
Link in systemd.io and systemd-sysext Fixes #22146
Diffstat (limited to 'man/portablectl.xml')
-rw-r--r--man/portablectl.xml13
1 files changed, 9 insertions, 4 deletions
diff --git a/man/portablectl.xml b/man/portablectl.xml
index c5404db0ba..f58275b158 100644
--- a/man/portablectl.xml
+++ b/man/portablectl.xml
@@ -47,7 +47,8 @@
<para>Portable service images are an efficient way to bundle multiple related services and other units together,
and transfer them as a whole between systems. When these images are attached the local system the contained units
may run in most ways like regular system-provided units, either with full privileges or inside strict sandboxing,
- depending on the selected configuration.</para>
+ depending on the selected configuration. For more details, see
+ <ulink url="https://systemd.io/PORTABLE_SERVICES">Portable Services</ulink>.</para>
<para>Specifically portable service images may be of the following kind:</para>
@@ -359,10 +360,13 @@
top of <replaceable>IMAGE</replaceable> when attaching/detaching. This argument can be specified
multiple times, in which case the order in which images are laid down follows the rules specified in
<citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>
- for the <varname>ExtensionImages=</varname> directive. The image(s) must contain an
- <filename>extension-release</filename> file with metadata that matches what is defined in the
- <filename>os-release</filename> of <replaceable>IMAGE</replaceable>. See:
+ for the <varname>ExtensionImages=</varname> directive and for the
+ <citerefentry><refentrytitle>systemd-sysext</refentrytitle><manvolnum>8</manvolnum></citerefentry> tool.
+ The image(s) must contain an <filename>extension-release</filename> file with metadata that matches
+ what is defined in the <filename>os-release</filename> of <replaceable>IMAGE</replaceable>. See:
<citerefentry><refentrytitle>os-release</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
+ For more information on portable services with extensions, see the <literal>Extension Images</literal>
+ paragraph on <ulink url="https://systemd.io/PORTABLE_SERVICES">Portable Services</ulink>.
</para>
<para>Note that the same extensions have to be specified, in the same order, when attaching
@@ -451,6 +455,7 @@
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>systemd-sysext</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>org.freedesktop.portable1</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-portabled.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>