Debian Codegraph @

upstream/debian-unstable/man8/systemd-mountfsd.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-MOUNTFSD\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-mountfsd.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-mountfsd.service, systemd-mountfsd \- Disk Image File System Mount Service
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-mountfsd\&.service
27 .PP
28 /usr/lib/systemd/systemd\-mountfsd
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-mountfsd\fR
32 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\&.
33 .PP
34 The disk images provided must contain a raw file system image or must follow the
35 \m[blue]\fBUAPI\&.2 Discoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. Before mounting any file systems authenticity of the disk image is established in one or a combination of the following ways:
36 .sp
37 .RS 4
38 .ie n \{\
39 \h'-04' 1.\h'+01'\c
40 .\}
41 .el \{\
42 .sp -1
43 .IP " 1." 4.2
44 .\}
45 If the disk image is located in a regular file in one of the directories
46 /var/lib/machines/,
47 /var/lib/portables/,
48 /var/lib/extensions/,
49 /var/lib/confexts/
50 or their counterparts in the
51 /etc/,
52 /run/,
53 /usr/lib/
54 it is assumed to be trusted\&.
55 .RE
56 .sp
57 .RS 4
58 .ie n \{\
59 \h'-04' 2.\h'+01'\c
60 .\}
61 .el \{\
62 .sp -1
63 .IP " 2." 4.2
64 .\}
65 If the disk image contains a Verity enabled disk image, along with a signature partition with a key in the kernel keyring or in
66 /etc/verity\&.d/*\&.crt
67 (and related directories) the disk image is considered trusted\&.
68 .RE
69 .PP
70 This service provides one
71 \m[blue]\fBVarlink\fR\m[]\&\s-2\u[2]\d\s+2
72 service:
73 \fBio\&.systemd\&.MountFileSystem\fR
74 which accepts a file descriptor to a regular file or block device, and returns a number of file descriptors referring to an
75 \fBfsmount()\fR
76 file descriptor the client may then attach to a path of their choice\&.
77 .PP
78 The returned mounts are automatically allowlisted in the per\-user\-namespace allowlist maintained by
79 \fBsystemd-nsresourced.service\fR(8)\&.
80 .PP
81 The file systems are automatically
82 \fBfsck\fR(8)\*(Aqed before mounting\&.
83 .SH "SEE ALSO"
84 .PP
85 \fBsystemd\fR(1), \fBsystemd-nsresourced.service\fR(8)
86 .SH "NOTES"
87 .IP " 1." 4
88 UAPI.2 Discoverable Partitions Specification
89 .RS 4
90 \%https://uapi-group.org/specifications/specs/discoverable_partitions_specification/
91 .RE
92 .IP " 2." 4
93 Varlink
94 .RS 4
95 \%https://varlink.org/
96 .RE