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