HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

systemd-mountfsd.service(8)

Disk Image File System Mount Service

Man pages use the upstream DocBook stylesheet. Build-specific template values are explicitly labelled build-dependent. Host systemd version is not inferred from this collection.

Index · Directives systemd v262.2

Name

systemd-mountfsd.service, systemd-mountfsd — Disk Image File System Mount Service

Synopsis

systemd-mountfsd.service

/usr/lib/systemd/systemd-mountfsd

Description

systemd-mountfsd is a system service that dissects disk images, and returns mount file descriptors for the file systems contained therein to clients, via a Varlink IPC API.

The disk images provided must contain a raw file system image or must follow the UAPI.2 Discoverable Partitions Specification. Before mounting any file systems authenticity of the disk image is established in one or a combination of the following ways:

  1. If the disk image is located in a regular file in one of the directories /var/lib/machines/, /var/lib/portables/, /var/lib/extensions/, /var/lib/confexts/ or their counterparts in the /etc/, /run/, /usr/lib/ it is assumed to be trusted.

  2. If the disk image contains a Verity enabled disk image, along with a signature partition with a key in the kernel keyring or in /etc/verity.d/*.crt (and related directories) the disk image is considered trusted. Note that the GPT partition table of the disk image is parsed by the kernel to discover its contents and systemd-mountfsd assumes that the GPT parser is robust against malformed input and applies no security policies or checks around it.

This service provides one Varlink service: io.systemd.MountFileSystem which accepts a file descriptor to a regular file or block device, and returns a number of file descriptors referring to an fsmount() file descriptor the client may then attach to a path of their choice.

The returned mounts are automatically allowlisted in the per-user-namespace allowlist maintained by systemd-nsresourced.service(8).

The file systems are automatically fsck(8)'ed before mounting.

See Also

systemd(1), systemd-nsresourced.service(8)

Reproduced upstream material. Formatting and navigation adapted for Half Echo. The original file and copyright notices remain available above.