diff --git a/TODO b/TODO
index 24ec98416a1..a91b5b3d731 100644
--- a/TODO
+++ b/TODO
@@ -825,6 +825,7 @@ Features:
- man: document the very specific env the shutdown drop-in tools live in
- man: add more examples to man pages
- man: maybe sort directives in man pages, and take sections from --help and apply them to man too
+ - document root=gpt-auto properly
* systemctl:
- add systemctl switch to dump transaction without executing it
diff --git a/man/kernel-command-line.xml b/man/kernel-command-line.xml
index 9d86bdf2032..85813e473dc 100644
--- a/man/kernel-command-line.xml
+++ b/man/kernel-command-line.xml
@@ -329,7 +329,7 @@
Configures the root file system and its file system
type and mount options, as well as whether it shall be
- mounted read-only or read-writable initially. For details,
+ mounted read-only or read-write initially. For details,
see
systemd-fstab-generator8.
diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml
index d98ef2003f3..5ae43437056 100644
--- a/man/systemd-gpt-auto-generator.xml
+++ b/man/systemd-gpt-auto-generator.xml
@@ -196,6 +196,45 @@
systemd.generator7.
+
+ Kernel Command Line
+
+ systemd-gpt-auto-generator understands the following kernel command line
+ parameters:
+
+
+
+
+ systemd.gpt_auto
+ rd.systemd.gpt_auto
+
+ Those options take an optional boolean argument, and default to yes.
+ The generator is enabled by default, and a negative value may be used to disable it.
+
+
+
+
+ root=
+
+ When used with the special value gpt-auto, automatic discovery of
+ the root parition based on the GPT partition type is enabled. Any other value disables this
+ generator.
+
+
+
+ rw
+ ro
+
+ Mount the root partition read-write or read-only initially.
+
+ Note that unlike most kernel command line options these settings do not override configuration
+ in the file system, and the file system may be remounted later. See
+ systemd-remount-fs.service8.
+
+
+
+
+
See Also
diff --git a/man/systemd-remount-fs.service.xml b/man/systemd-remount-fs.service.xml
index 0c1562142fd..46ab56eb0ba 100644
--- a/man/systemd-remount-fs.service.xml
+++ b/man/systemd-remount-fs.service.xml
@@ -30,22 +30,20 @@
Description
- systemd-remount-fs.service is an
- early boot service that applies mount options listed in
- fstab5
- to the root file system, the /usr file system,
- and the kernel API file systems. This is required so that the
- mount options of these file systems — which are pre-mounted by
- the kernel, the initial RAM disk, container environments or system
- manager code — are updated to those listed in
- /etc/fstab. This service ignores normal file
- systems and only changes the root file system (i.e.
- /), /usr and the virtual
- kernel API file systems such as /proc,
- /sys or /dev. This
- service executes no operation if /etc/fstab
- does not exist or lists no entries for the mentioned file
- systems.
+ systemd-remount-fs.service is an early boot service that applies mount options
+ listed in fstab5, or
+ gathered from the partition table (when
+ systemd-gpt-auto-generator8
+ is active) to the root file system, the /usr file system, and the kernel API file
+ systems. This is required so that the mount options of these file systems — which are pre-mounted by the
+ kernel, the initial RAM disk, container environments or system manager code — are updated to those
+ configured in /etc/fstab and the other sources. This service ignores normal file
+ systems and only changes the root file system (i.e. /), /usr,
+ and the virtual kernel API file systems such as /proc, /sys or
+ /dev. This service executes no operation if no configuration is found
+ (/etc/fstab does not exist or lists no entries for the mentioned file systems, or
+ the partition table does not contain relevant entries).
For a longer discussion of kernel API file systems see
API