diff options
Diffstat (limited to 'docs/BUILDING_IMAGES.md')
| -rw-r--r-- | docs/BUILDING_IMAGES.md | 27 |
1 files changed, 13 insertions, 14 deletions
diff --git a/docs/BUILDING_IMAGES.md b/docs/BUILDING_IMAGES.md index 88c7a6167d..955dd90e55 100644 --- a/docs/BUILDING_IMAGES.md +++ b/docs/BUILDING_IMAGES.md @@ -66,15 +66,15 @@ boot. For that it's essential to: The [`kernel-install(8)`](https://www.freedesktop.org/software/systemd/man/kernel-install.html) -logic used to generate [Boot Loader Specification Type -1](https://systemd.io/BOOT_LOADER_SPECIFICATION) entries by default uses the -machine ID as stored in `/etc/machine-id` for naming boot menu entries and the -directories in the ESP to place kernel images in. This is done in order to -allow multiple installations of the same OS on the same system without -conflicts. However, this is problematic if the machine ID shall be generated -automatically on first boot: if the ID is not known before the first boot it -cannot be used to name the most basic resources required for the boot process -to complete. +logic used to generate +[Boot Loader Specification Type 1](BOOT_LOADER_SPECIFICATION.md) entries by +default uses the machine ID as stored in `/etc/machine-id` for naming boot menu +entries and the directories in the ESP to place kernel images in. This is done +in order to allow multiple installations of the same OS on the same system +without conflicts. However, this is problematic if the machine ID shall be +generated automatically on first boot: if the ID is not known before the first +boot it cannot be used to name the most basic resources required for the boot +process to complete. Thus, for images that shall acquire their identity on first boot only, it is required to use a different identifier for naming boot menu entries. To allow @@ -203,9 +203,8 @@ it, then format it. in. The `x-systemd.growfs` mount option in `/etc/fstab` is sufficient to enable this logic for specific mounts. Alternatively appropriately set up partitions can set GPT partition flag 59 to request this behaviour, see the - [Discoverable Partitions - Specification](https://systemd.io/DISCOVERABLE_PARTITIONS) for details. If - the file system is already grown it executes no operation. + [Discoverable Partitions Specification](DISCOVERABLE_PARTITIONS.md) for + details. If the file system is already grown it executes no operation. 3. Similar, the `systemd-makefs@.service` and `systemd-makeswap@.service` services can format file systems and swap spaces before first use, if they @@ -268,8 +267,8 @@ fields. [`machine-id(5)`](https://www.freedesktop.org/software/systemd/man/machine-id.html)<br> [`systemd-random-seed(8)`](https://www.freedesktop.org/software/systemd/man/systemd-random-seed.service.html)<br> [`os-release(5)`](https://www.freedesktop.org/software/systemd/man/os-release.html)<br> -[Boot Loader Specification](https://systemd.io/BOOT_LOADER_SPECIFICATION)<br> -[Discoverable Partitions Specification](https://systemd.io/DISCOVERABLE_PARTITIONS)<br> +[Boot Loader Specification](BOOT_LOADER_SPECIFICATION.md)<br> +[Discoverable Partitions Specification](DISCOVERABLE_PARTITIONS.md)<br> [`mkosi`](https://github.com/systemd/mkosi)<br> [`systemd-boot(7)`](https://www.freedesktop.org/software/systemd/man/systemd-boot.html)<br> [`systemd-repart(8)`](https://www.freedesktop.org/software/systemd/man/systemd-repart.service.html)<br> |