diff --git a/man/os-release.xml b/man/os-release.xml index fbcce9bd5a2..f2e0f3ecb7b 100644 --- a/man/os-release.xml +++ b/man/os-release.xml @@ -104,7 +104,7 @@ /usr/lib/extension-release.d/extension-release.IMAGE plays the same role for extension images as os-release for the main system, and follows the syntax and rules as described in the Portable Services Documentation. The purpose of this + url="https://systemd.io/PORTABLE_SERVICES">Portable Services page. The purpose of this file is to identify the extension and to allow the operating system to verify that the extension image matches the base OS. This is typically implemented by checking that the ID= options match, and either SYSEXT_LEVEL= exists and matches too, or if it is not present, @@ -534,7 +534,7 @@ PORTABLE_PREFIXES= Takes a space-separated list of one or more valid prefix match strings for the - Portable Services Documentation logic. + Portable Services logic. This field serves two purposes: it is informational, identifying portable service images as such (and thus allowing them to be distinguished from other OS images, such as bootable system images). It is also used when a portable service image is attached: the specified or implied portable diff --git a/man/systemd-portabled.service.xml b/man/systemd-portabled.service.xml index 6dacea5e9b7..cb8cea6f6ec 100644 --- a/man/systemd-portabled.service.xml +++ b/man/systemd-portabled.service.xml @@ -35,7 +35,7 @@ Most of systemd-portabled's functionality is accessible through the portablectl1 command. - See the Portable Services Documentation + See the Portable Services page for details about the concepts this service implements. diff --git a/man/systemd-sysext.xml b/man/systemd-sysext.xml index fe980be5e7e..76076931d5f 100644 --- a/man/systemd-sysext.xml +++ b/man/systemd-sysext.xml @@ -112,7 +112,7 @@ suitable for shipping resources that are processed by subsystems running in earliest boot. Specifically, OS extension images are not suitable for shipping system services or systemd-sysusers8 - definitions. See the Portable Services Documentation + definitions. See the Portable Services page for a simple mechanism for shipping system services in disk images, in a similar fashion to OS extensions. Note the different isolation on these two mechanisms: while system extension directly extend the underlying OS image with additional files that appear in a way very similar to as if they were