summaryrefslogtreecommitdiff
path: root/man/machine-id.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2022-03-23 12:04:28 +0100
committerLennart Poettering <lennart@poettering.net>2022-03-23 12:25:01 +0100
commit8f39ecf6aa5bdfd2498e147476eb4b8f25d817bc (patch)
treecf8468460620637b2b7a64df12b7863651ea2bab /man/machine-id.xml
parenta43d2229bb3ba6b814d958c6f9d73b74f305ff82 (diff)
downloadsystemd-8f39ecf6aa5bdfd2498e147476eb4b8f25d817bc.tar.gz
docs: link up new image building docs a bit
Diffstat (limited to 'man/machine-id.xml')
-rw-r--r--man/machine-id.xml14
1 files changed, 7 insertions, 7 deletions
diff --git a/man/machine-id.xml b/man/machine-id.xml
index d5d3a1a299..9bd49582fc 100644
--- a/man/machine-id.xml
+++ b/man/machine-id.xml
@@ -80,13 +80,13 @@
<filename>/etc/machine-id</filename> may also be written using any other means.
</para>
- <para>For operating system images which are created once and used on multiple
- machines, for example for containers or in the cloud,
- <filename>/etc/machine-id</filename> should be either missing or an empty file in the generic file
- system image (the difference between the two options is described under "First Boot Semantics" below). An
- ID will be generated during boot and saved to this file if possible. Having an empty file in place is
- useful because it allows a temporary file to be bind-mounted over the real file, in case the image is
- used read-only.</para>
+ <para>For operating system images which are created once and used on multiple machines, for example for
+ containers or in the cloud, <filename>/etc/machine-id</filename> should be either missing or an empty
+ file in the generic file system image (the difference between the two options is described under "First
+ Boot Semantics" below). An ID will be generated during boot and saved to this file if possible. Having an
+ empty file in place is useful because it allows a temporary file to be bind-mounted over the real file,
+ in case the image is used read-only. Also see <ulink url="https://systemd.io/BUILDING_IMAGES">Safely
+ Building Images</ulink>.</para>
<para><citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
may be used to initialize <filename>/etc/machine-id</filename> on mounted (but not