From d6e843ab308ed78887a12f6ea0e1748e75f5c161 Mon Sep 17 00:00:00 2001 From: Antoine Cotten Date: Mon, 3 Aug 2026 11:56:07 +0200 Subject: [PATCH] nixos/systemd-initrd: disambiguate doc for root="gpt-auto" --- nixos/modules/system/boot/systemd/initrd.nix | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/nixos/modules/system/boot/systemd/initrd.nix b/nixos/modules/system/boot/systemd/initrd.nix index 311bf9cc9aa1..c30acd2cf732 100644 --- a/nixos/modules/system/boot/systemd/initrd.nix +++ b/nixos/modules/system/boot/systemd/initrd.nix @@ -229,7 +229,7 @@ in KExecWatchdogSec = "5min"; }; description = '' - Options for the global systemd service manager used in initrd. See {manpage}`systemd-system.conf(5)` man page + Options for the global systemd service manager used in initrd. See {manpage}`systemd-system.conf(5)` for available options. ''; }; @@ -311,10 +311,19 @@ in example = "gpt-auto"; description = '' Controls how systemd will interpret the root FS in initrd. See - {manpage}`kernel-command-line(7)`. NixOS currently does not - allow specifying the root file system itself this - way. Instead, the `fstab` value is used in order to interpret - the root file system specified with the `fileSystems` option. + the description of the `root=` argument in {manpage}`kernel-command-line(7)`. + + When set to "gpt-auto", {manpage}`systemd-gpt-auto-generator(8)` + automatically discovers and mounts the root, EFI System (ESP), + swap, and various other partitions based on their partition + type, allowing them to be effectively omitted from + {option}`fileSystems.`. + Note however that {option}`boot.initrd.supportedFilesystems` + will not be inferred for partitions without an explicit + {option}`fileSystems..fsType`, therefore the filesystem + names of all partitions mounted through "gpt-auto" must be + manually appended to `supportedFilesystems`. + If root shall be omitted, set this option to `null`. ''; };