diff --git a/man/kernel-command-line.xml b/man/kernel-command-line.xml
index 3a4619edee..17740fb4e4 100644
--- a/man/kernel-command-line.xml
+++ b/man/kernel-command-line.xml
@@ -481,6 +481,18 @@
+
+ systemd.image_filter=
+
+ When GPT-based partition auto-discovery is used, configures the image dissection
+ filter string to apply, as per
+ systemd.image-filter7. For
+ details see
+ systemd-gpt-auto-generator8.
+
+
+
+
systemd.default_timeout_start_sec=
diff --git a/man/rules/meson.build b/man/rules/meson.build
index c33d9fee0e..0b930d3beb 100644
--- a/man/rules/meson.build
+++ b/man/rules/meson.build
@@ -1188,6 +1188,7 @@ manpages = [
['systemd.environment-generator', '7', [], 'ENABLE_ENVIRONMENT_D'],
['systemd.exec', '5', [], ''],
['systemd.generator', '7', [], ''],
+ ['systemd.image-filter', '7', [], ''],
['systemd.image-policy', '7', [], ''],
['systemd.journal-fields', '7', [], ''],
['systemd.kill', '5', [], ''],
diff --git a/man/standard-options.xml b/man/standard-options.xml
index 1e958594ad..d07ea4a09a 100644
--- a/man/standard-options.xml
+++ b/man/standard-options.xml
@@ -114,6 +114,14 @@
in the image are used.
+
+ Takes an
+ image filter string as argument, as per
+ systemd.image-filter7. The
+ filter is taken into consideration when operating on the disk image specified via
+ , see above. If not specified no filtering is applied.
+
+
diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml
index 4b51fb887c..3094a1e6d9 100644
--- a/man/systemd-dissect.xml
+++ b/man/systemd-dissect.xml
@@ -582,6 +582,7 @@
+
diff --git a/man/systemd-gpt-auto-generator.xml b/man/systemd-gpt-auto-generator.xml
index af450f9fbe..11b08f0b8d 100644
--- a/man/systemd-gpt-auto-generator.xml
+++ b/man/systemd-gpt-auto-generator.xml
@@ -320,6 +320,17 @@
+
+ systemd.image_filter=
+
+ Takes an image dissection filter string as argument (as per
+ systemd.image-filter7),
+ and allows enforcing a set of globbing patterns on the partition matching of the automatically
+ discovered GPT partition table entries.
+
+
+
+
root=rootfstype=
diff --git a/man/systemd.image-filter.xml b/man/systemd.image-filter.xml
new file mode 100644
index 0000000000..f5a8a811da
--- /dev/null
+++ b/man/systemd.image-filter.xml
@@ -0,0 +1,80 @@
+
+
+
+
+
+
+
+ systemd.image-filter
+ systemd
+
+
+
+ systemd.image-filter
+ 7
+
+
+
+ systemd.image-filter
+ Disk Image Dissection Filter
+
+
+
+ Description
+
+ In systemd, whenever a disk image (DDI) implementing the Discoverable
+ Partitions Specification is activated, a filter may be specified controlling which partitions to
+ consider for mounting. Such a disk image dissection filter is a string that contains per-partition-type
+ patterns, separated by colons (:). The individual rules consist of a partition
+ identifier, an equal sign (=), and a shell globbing pattern applied to the GPT label
+ string of the partition. See glob7 for
+ details on shell globbing.
+
+ The partition identifiers currently defined are: , ,
+ , , , ,
+ , , ,
+ , , ,
+ . These identifiers match the relevant partition types in the Discoverable Partitions
+ Specification, but are agnostic to CPU architectures.
+
+
+
+ Use
+
+ Various systemd components that support operating with disk images support a
+ command line option to specify the image filter to use. If no filter is
+ specified all partitions in partition table are considered and no per-label filtering is applied (except
+ that partitions with the _empty label are always ignored).
+
+ For the host root file system image itself
+ systemd-gpt-auto-generator8
+ is responsible for processing the GPT partition table and making use of the included discoverable
+ partitions. It accepts an image filter via the kernel command line option
+ .
+
+
+
+ Examples
+
+ The following image filter string dictates that for the root file system partition only partitions
+ shall be considered whose label begins with ParticleOS-. For the
+ /usr/ partition the precise label ParticleOS_47110815 is
+ required.
+
+ root=ParticleOS-*:usr=ParticleOS_47110815
+
+
+
+ See Also
+
+ systemd1
+ systemd-dissect1
+ systemd-gpt-auto-generator8
+ systemd.image-policy7
+
+
+
+
diff --git a/man/systemd.image-policy.xml b/man/systemd.image-policy.xml
index 36a8395bf0..d351ffeea5 100644
--- a/man/systemd.image-policy.xml
+++ b/man/systemd.image-policy.xml
@@ -185,6 +185,7 @@
systemd-gpt-auto-generator8systemd-sysext8systemd-analyze1
+ systemd.filter7