|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | DESCRIPTION | USE | EXAMPLES | SEE ALSO | NOTES | COLOPHON |
|
|
|
SYSTEMD.IMAGE-FILTER(7) systemd.image-filter SYSTEMD.IMAGE-FILTER(7)
systemd.image-filter - Disk Image Dissection Filter
In systemd, whenever a disk image (DDI) implementing the
Discoverable Partitions Specification[1] 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 glob(7) for details on shell
globbing.
The partition identifiers currently defined are: root, usr, home,
srv, esp, xbootldr, swap, root-verity, root-verity-sig,
usr-verity, usr-verity-sig, tmp, var. These identifiers match the
relevant partition types in the Discoverable Partitions
Specification, but are agnostic to CPU architectures.
Various systemd components that support operating with disk images
support a --image-filter= 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-generator(8) 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 systemd.image_filter=.
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
systemd(1), systemd-dissect(1), systemd-gpt-auto-generator(8),
systemd.image-policy(7)
1. Discoverable Partitions Specification
https://uapi-group.org/specifications/specs/discoverable_partitions_specification
This page is part of the systemd (systemd system and service
manager) project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have a
bug report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2025-08-11. (At that
time, the date of the most recent commit that was found in the
repository was 2025-08-11.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
systemd 258~rc2 SYSTEMD.IMAGE-FILTER(7)
Pages that refer to this page: systemd-dissect(1), kernel-command-line(7), systemd.directives(7), systemd.index(7), systemd-gpt-auto-generator(8)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|