1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
4 #include <linux/loop.h>
14 #include "alloc-util.h"
15 #include "base-filesystem.h"
17 #include "dev-setup.h"
18 #include "devnum-util.h"
21 #include "extension-util.h"
23 #include "format-util.h"
24 #include "glyph-util.h"
25 #include "label-util.h"
27 #include "lock-util.h"
28 #include "loop-util.h"
29 #include "loopback-setup.h"
30 #include "missing_syscall.h"
31 #include "mkdir-label.h"
32 #include "mount-util.h"
33 #include "mountpoint-util.h"
34 #include "namespace-util.h"
35 #include "namespace.h"
37 #include "nulstr-util.h"
39 #include "path-util.h"
40 #include "selinux-util.h"
41 #include "socket-util.h"
42 #include "sort-util.h"
43 #include "stat-util.h"
44 #include "string-table.h"
45 #include "string-util.h"
47 #include "tmpfile-util.h"
48 #include "umask-util.h"
49 #include "user-util.h"
51 #define DEV_MOUNT_OPTIONS (MS_NOSUID|MS_STRICTATIME|MS_NOEXEC)
53 typedef enum MountMode
{
54 /* This is ordered by priority! */
74 EXTENSION_DIRECTORIES
, /* Bind-mounted outside the root directory, and used by subsequent mounts */
75 EXTENSION_IMAGES
, /* Mounted outside the root directory, and used by subsequent mounts */
77 READWRITE_IMPLICIT
, /* Should have the lowest priority. */
81 typedef struct MountEntry
{
82 const char *path_const
; /* Memory allocated on stack or static */
84 bool ignore
:1; /* Ignore if path does not exist? */
85 bool has_prefix
:1; /* Already is prefixed by the root dir? */
86 bool read_only
:1; /* Shall this mount point be read-only? */
87 bool nosuid
:1; /* Shall set MS_NOSUID on the mount itself */
88 bool noexec
:1; /* Shall set MS_NOEXEC on the mount itself */
89 bool exec
:1; /* Shall clear MS_NOEXEC on the mount itself */
90 bool applied
:1; /* Already applied */
91 char *path_malloc
; /* Use this instead of 'path_const' if we had to allocate memory */
92 const char *unprefixed_path_const
; /* If the path was amended with a prefix, these will save the original */
93 char *unprefixed_path_malloc
;
94 const char *source_const
; /* The source path, for bind mounts or images */
96 const char *options_const
;/* Mount options for tmpfs */
98 unsigned long flags
; /* Mount flags used by EMPTY_DIR and TMPFS. Do not include MS_RDONLY here, but please use read_only. */
100 LIST_HEAD(MountOptions
, image_options
);
103 /* If MountAPIVFS= is used, let's mount /sys, /proc, /dev and /run into the it, but only as a fallback if the user hasn't mounted
104 * something there already. These mounts are hence overridden by any other explicitly configured mounts. */
105 static const MountEntry apivfs_table
[] = {
106 { "/proc", PROCFS
, false },
107 { "/dev", BIND_DEV
, false },
108 { "/sys", BIND_SYSFS
, false },
109 { "/run", RUN
, false, .options_const
= "mode=0755" TMPFS_LIMITS_RUN
, .flags
= MS_NOSUID
|MS_NODEV
|MS_STRICTATIME
},
112 /* ProtectKernelTunables= option and the related filesystem APIs */
113 static const MountEntry protect_kernel_tunables_proc_table
[] = {
114 { "/proc/acpi", READONLY
, true },
115 { "/proc/apm", READONLY
, true }, /* Obsolete API, there's no point in permitting access to this, ever */
116 { "/proc/asound", READONLY
, true },
117 { "/proc/bus", READONLY
, true },
118 { "/proc/fs", READONLY
, true },
119 { "/proc/irq", READONLY
, true },
120 { "/proc/kallsyms", INACCESSIBLE
, true },
121 { "/proc/kcore", INACCESSIBLE
, true },
122 { "/proc/latency_stats", READONLY
, true },
123 { "/proc/mtrr", READONLY
, true },
124 { "/proc/scsi", READONLY
, true },
125 { "/proc/sys", READONLY
, true },
126 { "/proc/sysrq-trigger", READONLY
, true },
127 { "/proc/timer_stats", READONLY
, true },
130 static const MountEntry protect_kernel_tunables_sys_table
[] = {
131 { "/sys", READONLY
, false },
132 { "/sys/fs/bpf", READONLY
, true },
133 { "/sys/fs/cgroup", READWRITE_IMPLICIT
, false }, /* READONLY is set by ProtectControlGroups= option */
134 { "/sys/fs/selinux", READWRITE_IMPLICIT
, true },
135 { "/sys/kernel/debug", READONLY
, true },
136 { "/sys/kernel/tracing", READONLY
, true },
139 /* ProtectKernelModules= option */
140 static const MountEntry protect_kernel_modules_table
[] = {
141 { "/usr/lib/modules", INACCESSIBLE
, true },
144 /* ProtectKernelLogs= option */
145 static const MountEntry protect_kernel_logs_proc_table
[] = {
146 { "/proc/kmsg", INACCESSIBLE
, true },
149 static const MountEntry protect_kernel_logs_dev_table
[] = {
150 { "/dev/kmsg", INACCESSIBLE
, true },
154 * ProtectHome=read-only table, protect $HOME and $XDG_RUNTIME_DIR and rest of
155 * system should be protected by ProtectSystem=
157 static const MountEntry protect_home_read_only_table
[] = {
158 { "/home", READONLY
, true },
159 { "/run/user", READONLY
, true },
160 { "/root", READONLY
, true },
163 /* ProtectHome=tmpfs table */
164 static const MountEntry protect_home_tmpfs_table
[] = {
165 { "/home", TMPFS
, true, .read_only
= true, .options_const
= "mode=0755" TMPFS_LIMITS_EMPTY_OR_ALMOST
, .flags
= MS_NODEV
|MS_STRICTATIME
},
166 { "/run/user", TMPFS
, true, .read_only
= true, .options_const
= "mode=0755" TMPFS_LIMITS_EMPTY_OR_ALMOST
, .flags
= MS_NODEV
|MS_STRICTATIME
},
167 { "/root", TMPFS
, true, .read_only
= true, .options_const
= "mode=0700" TMPFS_LIMITS_EMPTY_OR_ALMOST
, .flags
= MS_NODEV
|MS_STRICTATIME
},
170 /* ProtectHome=yes table */
171 static const MountEntry protect_home_yes_table
[] = {
172 { "/home", INACCESSIBLE
, true },
173 { "/run/user", INACCESSIBLE
, true },
174 { "/root", INACCESSIBLE
, true },
177 /* ProtectSystem=yes table */
178 static const MountEntry protect_system_yes_table
[] = {
179 { "/usr", READONLY
, false },
180 { "/boot", READONLY
, true },
181 { "/efi", READONLY
, true },
184 /* ProtectSystem=full includes ProtectSystem=yes */
185 static const MountEntry protect_system_full_table
[] = {
186 { "/usr", READONLY
, false },
187 { "/boot", READONLY
, true },
188 { "/efi", READONLY
, true },
189 { "/etc", READONLY
, false },
193 * ProtectSystem=strict table. In this strict mode, we mount everything
194 * read-only, except for /proc, /dev, /sys which are the kernel API VFS,
195 * which are left writable, but PrivateDevices= + ProtectKernelTunables=
196 * protect those, and these options should be fully orthogonal.
197 * (And of course /home and friends are also left writable, as ProtectHome=
198 * shall manage those, orthogonally).
200 static const MountEntry protect_system_strict_table
[] = {
201 { "/", READONLY
, false },
202 { "/proc", READWRITE_IMPLICIT
, false }, /* ProtectKernelTunables= */
203 { "/sys", READWRITE_IMPLICIT
, false }, /* ProtectKernelTunables= */
204 { "/dev", READWRITE_IMPLICIT
, false }, /* PrivateDevices= */
205 { "/home", READWRITE_IMPLICIT
, true }, /* ProtectHome= */
206 { "/run/user", READWRITE_IMPLICIT
, true }, /* ProtectHome= */
207 { "/root", READWRITE_IMPLICIT
, true }, /* ProtectHome= */
210 static const char * const mount_mode_table
[_MOUNT_MODE_MAX
] = {
211 [INACCESSIBLE
] = "inaccessible",
212 [OVERLAY_MOUNT
] = "overlay",
213 [MOUNT_IMAGES
] = "mount-images",
214 [BIND_MOUNT
] = "bind",
215 [BIND_MOUNT_RECURSIVE
] = "rbind",
216 [PRIVATE_TMP
] = "private-tmp",
217 [PRIVATE_TMP_READONLY
] = "private-tmp-read-only",
218 [PRIVATE_DEV
] = "private-dev",
219 [BIND_DEV
] = "bind-dev",
220 [EMPTY_DIR
] = "empty",
221 [PRIVATE_SYSFS
] = "private-sysfs",
222 [BIND_SYSFS
] = "bind-sysfs",
224 [READONLY
] = "read-only",
225 [READWRITE
] = "read-write",
230 [EXTENSION_DIRECTORIES
] = "extension-directories",
231 [EXTENSION_IMAGES
] = "extension-images",
232 [MQUEUEFS
] = "mqueuefs",
233 [READWRITE_IMPLICIT
] = "read-write-implicit",
236 /* Helper struct for naming simplicity and reusability */
237 static const struct {
238 const char *level_env
;
239 const char *level_env_print
;
240 } image_class_info
[_IMAGE_CLASS_MAX
] = {
242 .level_env
= "SYSEXT_LEVEL",
243 .level_env_print
= " SYSEXT_LEVEL=",
246 .level_env
= "CONFEXT_LEVEL",
247 .level_env_print
= " CONFEXT_LEVEL=",
251 DEFINE_PRIVATE_STRING_TABLE_LOOKUP_TO_STRING(mount_mode
, MountMode
);
253 static const char *mount_entry_path(const MountEntry
*p
) {
256 /* Returns the path of this bind mount. If the malloc()-allocated ->path_buffer field is set we return that,
257 * otherwise the stack/static ->path field is returned. */
259 return p
->path_malloc
?: p
->path_const
;
262 static const char *mount_entry_unprefixed_path(const MountEntry
*p
) {
265 /* Returns the unprefixed path (ie: before prefix_where_needed() ran), if any */
267 return p
->unprefixed_path_malloc
?: p
->unprefixed_path_const
?: mount_entry_path(p
);
270 static void mount_entry_consume_prefix(MountEntry
*p
, char *new_path
) {
272 assert(p
->path_malloc
|| p
->path_const
);
275 /* Saves current path in unprefixed_ variable, and takes over new_path */
277 free_and_replace(p
->unprefixed_path_malloc
, p
->path_malloc
);
278 /* If we didn't have a path on the heap, then it's a static one */
279 if (!p
->unprefixed_path_malloc
)
280 p
->unprefixed_path_const
= p
->path_const
;
281 p
->path_malloc
= new_path
;
282 p
->has_prefix
= true;
285 static bool mount_entry_read_only(const MountEntry
*p
) {
288 return p
->read_only
|| IN_SET(p
->mode
, READONLY
, INACCESSIBLE
, PRIVATE_TMP_READONLY
);
291 static bool mount_entry_noexec(const MountEntry
*p
) {
294 return p
->noexec
|| IN_SET(p
->mode
, NOEXEC
, INACCESSIBLE
, PRIVATE_SYSFS
, BIND_SYSFS
, PROCFS
);
297 static bool mount_entry_exec(const MountEntry
*p
) {
300 return p
->exec
|| p
->mode
== EXEC
;
303 static const char *mount_entry_source(const MountEntry
*p
) {
306 return p
->source_malloc
?: p
->source_const
;
309 static const char *mount_entry_options(const MountEntry
*p
) {
312 return p
->options_malloc
?: p
->options_const
;
315 static void mount_entry_done(MountEntry
*p
) {
318 p
->path_malloc
= mfree(p
->path_malloc
);
319 p
->unprefixed_path_malloc
= mfree(p
->unprefixed_path_malloc
);
320 p
->source_malloc
= mfree(p
->source_malloc
);
321 p
->options_malloc
= mfree(p
->options_malloc
);
322 p
->image_options
= mount_options_free_all(p
->image_options
);
325 static int append_access_mounts(MountEntry
**p
, char **strv
, MountMode mode
, bool forcibly_require_prefix
) {
328 /* Adds a list of user-supplied READWRITE/READWRITE_IMPLICIT/READONLY/INACCESSIBLE entries */
330 STRV_FOREACH(i
, strv
) {
331 bool ignore
= false, needs_prefix
= false;
334 /* Look for any prefixes */
335 if (startswith(e
, "-")) {
339 if (startswith(e
, "+")) {
344 if (!path_is_absolute(e
))
345 return log_debug_errno(SYNTHETIC_ERRNO(EINVAL
),
346 "Path is not absolute: %s", e
);
348 *((*p
)++) = (MountEntry
) {
352 .has_prefix
= !needs_prefix
&& !forcibly_require_prefix
,
359 static int append_empty_dir_mounts(MountEntry
**p
, char **strv
) {
362 /* Adds tmpfs mounts to provide readable but empty directories. This is primarily used to implement the
363 * "/private/" boundary directories for DynamicUser=1. */
365 STRV_FOREACH(i
, strv
) {
367 *((*p
)++) = (MountEntry
) {
372 .options_const
= "mode=0755" TMPFS_LIMITS_EMPTY_OR_ALMOST
,
373 .flags
= MS_NOSUID
|MS_NOEXEC
|MS_NODEV
|MS_STRICTATIME
,
380 static int append_bind_mounts(MountEntry
**p
, const BindMount
*binds
, size_t n
) {
383 for (size_t i
= 0; i
< n
; i
++) {
384 const BindMount
*b
= binds
+ i
;
386 *((*p
)++) = (MountEntry
) {
387 .path_const
= b
->destination
,
388 .mode
= b
->recursive
? BIND_MOUNT_RECURSIVE
: BIND_MOUNT
,
389 .read_only
= b
->read_only
,
391 .source_const
= b
->source
,
392 .ignore
= b
->ignore_enoent
,
399 static int append_mount_images(MountEntry
**p
, const MountImage
*mount_images
, size_t n
) {
402 for (size_t i
= 0; i
< n
; i
++) {
403 const MountImage
*m
= mount_images
+ i
;
405 *((*p
)++) = (MountEntry
) {
406 .path_const
= m
->destination
,
407 .mode
= MOUNT_IMAGES
,
408 .source_const
= m
->source
,
409 .image_options
= m
->mount_options
,
410 .ignore
= m
->ignore_enoent
,
417 static int append_extensions(
420 const char *extension_dir
,
422 const MountImage
*mount_images
,
424 char **extension_directories
) {
426 _cleanup_strv_free_
char **overlays
= NULL
;
429 if (n
== 0 && strv_isempty(extension_directories
))
433 assert(extension_dir
);
435 /* Prepare a list of overlays, that will have as each element a string suitable for being
436 * passed as a lowerdir= parameter, so start with the hierarchy on the root.
437 * The overlays vector will have the same number of elements and will correspond to the
438 * hierarchies vector, so they can be iterated upon together. */
439 STRV_FOREACH(hierarchy
, hierarchies
) {
440 _cleanup_free_
char *prefixed_hierarchy
= NULL
;
442 prefixed_hierarchy
= path_join(root
, *hierarchy
);
443 if (!prefixed_hierarchy
)
446 r
= strv_consume(&overlays
, TAKE_PTR(prefixed_hierarchy
));
451 /* First, prepare a mount for each image, but these won't be visible to the unit, instead
452 * they will be mounted in our propagate directory, and used as a source for the overlay. */
453 for (size_t i
= 0; i
< n
; i
++) {
454 _cleanup_free_
char *mount_point
= NULL
;
455 const MountImage
*m
= mount_images
+ i
;
457 r
= asprintf(&mount_point
, "%s/%zu", extension_dir
, i
);
461 for (size_t j
= 0; hierarchies
&& hierarchies
[j
]; ++j
) {
462 _cleanup_free_
char *prefixed_hierarchy
= NULL
, *escaped
= NULL
, *lowerdir
= NULL
;
464 prefixed_hierarchy
= path_join(mount_point
, hierarchies
[j
]);
465 if (!prefixed_hierarchy
)
468 escaped
= shell_escape(prefixed_hierarchy
, ",:");
472 /* Note that lowerdir= parameters are in 'reverse' order, so the
473 * top-most directory in the overlay comes first in the list. */
474 lowerdir
= strjoin(escaped
, ":", overlays
[j
]);
478 free_and_replace(overlays
[j
], lowerdir
);
481 *((*p
)++) = (MountEntry
) {
482 .path_malloc
= TAKE_PTR(mount_point
),
483 .image_options
= m
->mount_options
,
484 .ignore
= m
->ignore_enoent
,
485 .source_const
= m
->source
,
486 .mode
= EXTENSION_IMAGES
,
491 /* Secondly, extend the lowerdir= parameters with each ExtensionDirectory.
492 * Bind mount them in the same location as the ExtensionImages, so that we
493 * can check that they are valid trees (extension-release.d). */
494 STRV_FOREACH(extension_directory
, extension_directories
) {
495 _cleanup_free_
char *mount_point
= NULL
, *source
= NULL
;
496 const char *e
= *extension_directory
;
497 bool ignore_enoent
= false;
499 /* Pick up the counter where the ExtensionImages left it. */
500 r
= asprintf(&mount_point
, "%s/%zu", extension_dir
, n
++);
504 /* Look for any prefixes */
505 if (startswith(e
, "-")) {
507 ignore_enoent
= true;
509 /* Ignore this for now */
510 if (startswith(e
, "+"))
517 for (size_t j
= 0; hierarchies
&& hierarchies
[j
]; ++j
) {
518 _cleanup_free_
char *prefixed_hierarchy
= NULL
, *escaped
= NULL
, *lowerdir
= NULL
;
520 prefixed_hierarchy
= path_join(mount_point
, hierarchies
[j
]);
521 if (!prefixed_hierarchy
)
524 escaped
= shell_escape(prefixed_hierarchy
, ",:");
528 /* Note that lowerdir= parameters are in 'reverse' order, so the
529 * top-most directory in the overlay comes first in the list. */
530 lowerdir
= strjoin(escaped
, ":", overlays
[j
]);
534 free_and_replace(overlays
[j
], lowerdir
);
537 *((*p
)++) = (MountEntry
) {
538 .path_malloc
= TAKE_PTR(mount_point
),
539 .source_malloc
= TAKE_PTR(source
),
540 .mode
= EXTENSION_DIRECTORIES
,
541 .ignore
= ignore_enoent
,
547 /* Then, for each hierarchy, prepare an overlay with the list of lowerdir= strings
549 for (size_t i
= 0; hierarchies
&& hierarchies
[i
]; ++i
) {
550 _cleanup_free_
char *prefixed_hierarchy
= NULL
;
552 prefixed_hierarchy
= path_join(root
, hierarchies
[i
]);
553 if (!prefixed_hierarchy
)
556 *((*p
)++) = (MountEntry
) {
557 .path_malloc
= TAKE_PTR(prefixed_hierarchy
),
558 .options_malloc
= TAKE_PTR(overlays
[i
]),
559 .mode
= OVERLAY_MOUNT
,
561 .ignore
= true, /* If the source image doesn't set the ignore bit it will fail earlier. */
568 static int append_tmpfs_mounts(MountEntry
**p
, const TemporaryFileSystem
*tmpfs
, size_t n
) {
571 for (size_t i
= 0; i
< n
; i
++) {
572 const TemporaryFileSystem
*t
= tmpfs
+ i
;
573 _cleanup_free_
char *o
= NULL
, *str
= NULL
;
578 if (!path_is_absolute(t
->path
))
579 return log_debug_errno(SYNTHETIC_ERRNO(EINVAL
),
580 "Path is not absolute: %s",
583 str
= strjoin("mode=0755" NESTED_TMPFS_LIMITS
",", t
->options
);
587 r
= mount_option_mangle(str
, MS_NODEV
|MS_STRICTATIME
, &flags
, &o
);
589 return log_debug_errno(r
, "Failed to parse mount option '%s': %m", str
);
591 ro
= flags
& MS_RDONLY
;
595 *((*p
)++) = (MountEntry
) {
596 .path_const
= t
->path
,
599 .options_malloc
= TAKE_PTR(o
),
607 static int append_static_mounts(MountEntry
**p
, const MountEntry
*mounts
, size_t n
, bool ignore_protect
) {
611 /* Adds a list of static pre-defined entries */
613 for (size_t i
= 0; i
< n
; i
++)
614 *((*p
)++) = (MountEntry
) {
615 .path_const
= mount_entry_path(mounts
+i
),
616 .mode
= mounts
[i
].mode
,
617 .ignore
= mounts
[i
].ignore
|| ignore_protect
,
623 static int append_protect_home(MountEntry
**p
, ProtectHome protect_home
, bool ignore_protect
) {
626 switch (protect_home
) {
628 case PROTECT_HOME_NO
:
631 case PROTECT_HOME_READ_ONLY
:
632 return append_static_mounts(p
, protect_home_read_only_table
, ELEMENTSOF(protect_home_read_only_table
), ignore_protect
);
634 case PROTECT_HOME_TMPFS
:
635 return append_static_mounts(p
, protect_home_tmpfs_table
, ELEMENTSOF(protect_home_tmpfs_table
), ignore_protect
);
637 case PROTECT_HOME_YES
:
638 return append_static_mounts(p
, protect_home_yes_table
, ELEMENTSOF(protect_home_yes_table
), ignore_protect
);
641 assert_not_reached();
645 static int append_protect_system(MountEntry
**p
, ProtectSystem protect_system
, bool ignore_protect
) {
648 switch (protect_system
) {
650 case PROTECT_SYSTEM_NO
:
653 case PROTECT_SYSTEM_STRICT
:
654 return append_static_mounts(p
, protect_system_strict_table
, ELEMENTSOF(protect_system_strict_table
), ignore_protect
);
656 case PROTECT_SYSTEM_YES
:
657 return append_static_mounts(p
, protect_system_yes_table
, ELEMENTSOF(protect_system_yes_table
), ignore_protect
);
659 case PROTECT_SYSTEM_FULL
:
660 return append_static_mounts(p
, protect_system_full_table
, ELEMENTSOF(protect_system_full_table
), ignore_protect
);
663 assert_not_reached();
667 static int mount_path_compare(const MountEntry
*a
, const MountEntry
*b
) {
670 /* ExtensionImages/Directories will be used by other mounts as a base, so sort them first
671 * regardless of the prefix - they are set up in the propagate directory anyway */
672 d
= -CMP(a
->mode
== EXTENSION_IMAGES
, b
->mode
== EXTENSION_IMAGES
);
675 d
= -CMP(a
->mode
== EXTENSION_DIRECTORIES
, b
->mode
== EXTENSION_DIRECTORIES
);
679 /* If the paths are not equal, then order prefixes first */
680 d
= path_compare(mount_entry_path(a
), mount_entry_path(b
));
684 /* If the paths are equal, check the mode */
685 return CMP((int) a
->mode
, (int) b
->mode
);
688 static int prefix_where_needed(MountEntry
*m
, size_t n
, const char *root_directory
) {
689 /* Prefixes all paths in the bind mount table with the root directory if the entry needs that. */
693 for (size_t i
= 0; i
< n
; i
++) {
699 s
= path_join(root_directory
, mount_entry_path(m
+i
));
703 mount_entry_consume_prefix(&m
[i
], s
);
709 static void drop_duplicates(MountEntry
*m
, size_t *n
) {
710 MountEntry
*f
, *t
, *previous
;
715 /* Drops duplicate entries. Expects that the array is properly ordered already. */
717 for (f
= m
, t
= m
, previous
= NULL
; f
< m
+ *n
; f
++) {
719 /* The first one wins (which is the one with the more restrictive mode), see mount_path_compare()
720 * above. Note that we only drop duplicates that haven't been mounted yet. */
722 path_equal(mount_entry_path(f
), mount_entry_path(previous
)) &&
723 !f
->applied
&& !previous
->applied
) {
724 log_debug("%s (%s) is duplicate.", mount_entry_path(f
), mount_mode_to_string(f
->mode
));
725 /* Propagate the flags to the remaining entry */
726 previous
->read_only
= previous
->read_only
|| mount_entry_read_only(f
);
727 previous
->noexec
= previous
->noexec
|| mount_entry_noexec(f
);
728 previous
->exec
= previous
->exec
|| mount_entry_exec(f
);
741 static void drop_inaccessible(MountEntry
*m
, size_t *n
) {
743 const char *clear
= NULL
;
748 /* Drops all entries obstructed by another entry further up the tree. Expects that the array is properly
749 * ordered already. */
751 for (f
= m
, t
= m
; f
< m
+ *n
; f
++) {
753 /* If we found a path set for INACCESSIBLE earlier, and this entry has it as prefix we should drop
754 * it, as inaccessible paths really should drop the entire subtree. */
755 if (clear
&& path_startswith(mount_entry_path(f
), clear
)) {
756 log_debug("%s is masked by %s.", mount_entry_path(f
), clear
);
761 clear
= f
->mode
== INACCESSIBLE
? mount_entry_path(f
) : NULL
;
770 static void drop_nop(MountEntry
*m
, size_t *n
) {
776 /* Drops all entries which have an immediate parent that has the same type, as they are redundant. Assumes the
777 * list is ordered by prefixes. */
779 for (f
= m
, t
= m
; f
< m
+ *n
; f
++) {
781 /* Only suppress such subtrees for READONLY, READWRITE and READWRITE_IMPLICIT entries */
782 if (IN_SET(f
->mode
, READONLY
, READWRITE
, READWRITE_IMPLICIT
)) {
783 MountEntry
*found
= NULL
;
785 /* Now let's find the first parent of the entry we are looking at. */
786 for (MountEntry
*p
= PTR_SUB1(t
, m
); p
; p
= PTR_SUB1(p
, m
))
787 if (path_startswith(mount_entry_path(f
), mount_entry_path(p
))) {
792 /* We found it, let's see if it's the same mode, if so, we can drop this entry */
793 if (found
&& found
->mode
== f
->mode
) {
794 log_debug("%s (%s) is made redundant by %s (%s)",
795 mount_entry_path(f
), mount_mode_to_string(f
->mode
),
796 mount_entry_path(found
), mount_mode_to_string(found
->mode
));
809 static void drop_outside_root(const char *root_directory
, MountEntry
*m
, size_t *n
) {
819 /* Drops all mounts that are outside of the root directory. */
821 for (f
= m
, t
= m
; f
< m
+ *n
; f
++) {
823 /* ExtensionImages/Directories bases are opened in /run/systemd/unit-extensions on the host */
824 if (!IN_SET(f
->mode
, EXTENSION_IMAGES
, EXTENSION_DIRECTORIES
) && !path_startswith(mount_entry_path(f
), root_directory
)) {
825 log_debug("%s is outside of root directory.", mount_entry_path(f
));
837 static int clone_device_node(
839 const char *temporary_mount
,
840 bool *make_devnode
) {
842 _cleanup_free_
char *sl
= NULL
;
843 const char *dn
, *bn
, *t
;
847 if (stat(d
, &st
) < 0) {
848 if (errno
== ENOENT
) {
849 log_debug_errno(errno
, "Device node '%s' to clone does not exist, ignoring.", d
);
853 return log_debug_errno(errno
, "Failed to stat() device node '%s' to clone, ignoring: %m", d
);
856 if (!S_ISBLK(st
.st_mode
) &&
857 !S_ISCHR(st
.st_mode
))
858 return log_debug_errno(SYNTHETIC_ERRNO(EINVAL
),
859 "Device node '%s' to clone is not a device node, ignoring.",
862 dn
= strjoina(temporary_mount
, d
);
864 /* First, try to create device node properly */
866 mac_selinux_create_file_prepare(d
, st
.st_mode
);
867 r
= mknod(dn
, st
.st_mode
, st
.st_rdev
);
868 mac_selinux_create_file_clear();
872 return log_debug_errno(errno
, "mknod failed for %s: %m", d
);
874 /* This didn't work, let's not try this again for the next iterations. */
875 *make_devnode
= false;
878 /* We're about to fall back to bind-mounting the device node. So create a dummy bind-mount target.
879 * Do not prepare device-node SELinux label (see issue 13762) */
880 r
= mknod(dn
, S_IFREG
, 0);
881 if (r
< 0 && errno
!= EEXIST
)
882 return log_debug_errno(errno
, "mknod() fallback failed for '%s': %m", d
);
884 /* Fallback to bind-mounting: The assumption here is that all used device nodes carry standard
885 * properties. Specifically, the devices nodes we bind-mount should either be owned by root:root or
886 * root:tty (e.g. /dev/tty, /dev/ptmx) and should not carry ACLs. */
887 r
= mount_nofollow_verbose(LOG_DEBUG
, d
, dn
, NULL
, MS_BIND
, NULL
);
892 bn
= path_startswith(d
, "/dev/");
896 /* Create symlinks like /dev/char/1:9 → ../urandom */
897 if (asprintf(&sl
, "%s/dev/%s/" DEVNUM_FORMAT_STR
,
899 S_ISCHR(st
.st_mode
) ? "char" : "block",
900 DEVNUM_FORMAT_VAL(st
.st_rdev
)) < 0)
903 (void) mkdir_parents(sl
, 0755);
905 t
= strjoina("../", bn
);
906 if (symlink(t
, sl
) < 0)
907 log_debug_errno(errno
, "Failed to symlink '%s' to '%s', ignoring: %m", t
, sl
);
912 static int mount_private_dev(MountEntry
*m
) {
913 static const char devnodes
[] =
921 char temporary_mount
[] = "/tmp/namespace-dev-XXXXXX";
922 const char *dev
= NULL
, *devpts
= NULL
, *devshm
= NULL
, *devhugepages
= NULL
, *devmqueue
= NULL
, *devlog
= NULL
, *devptmx
= NULL
;
923 bool can_mknod
= true;
928 if (!mkdtemp(temporary_mount
))
929 return log_debug_errno(errno
, "Failed to create temporary directory '%s': %m", temporary_mount
);
931 dev
= strjoina(temporary_mount
, "/dev");
932 (void) mkdir(dev
, 0755);
933 r
= mount_nofollow_verbose(LOG_DEBUG
, "tmpfs", dev
, "tmpfs", DEV_MOUNT_OPTIONS
, "mode=0755" TMPFS_LIMITS_PRIVATE_DEV
);
937 r
= label_fix_full(AT_FDCWD
, dev
, "/dev", 0);
939 log_debug_errno(r
, "Failed to fix label of '%s' as /dev: %m", dev
);
943 devpts
= strjoina(temporary_mount
, "/dev/pts");
944 (void) mkdir(devpts
, 0755);
945 r
= mount_nofollow_verbose(LOG_DEBUG
, "/dev/pts", devpts
, NULL
, MS_BIND
, NULL
);
949 /* /dev/ptmx can either be a device node or a symlink to /dev/pts/ptmx.
950 * When /dev/ptmx a device node, /dev/pts/ptmx has 000 permissions making it inaccessible.
951 * Thus, in that case make a clone.
952 * In nspawn and other containers it will be a symlink, in that case make it a symlink. */
953 r
= is_symlink("/dev/ptmx");
955 log_debug_errno(r
, "Failed to detect whether /dev/ptmx is a symlink or not: %m");
958 devptmx
= strjoina(temporary_mount
, "/dev/ptmx");
959 if (symlink("pts/ptmx", devptmx
) < 0) {
960 r
= log_debug_errno(errno
, "Failed to create a symlink '%s' to pts/ptmx: %m", devptmx
);
964 r
= clone_device_node("/dev/ptmx", temporary_mount
, &can_mknod
);
969 devshm
= strjoina(temporary_mount
, "/dev/shm");
970 (void) mkdir(devshm
, 0755);
971 r
= mount_nofollow_verbose(LOG_DEBUG
, "/dev/shm", devshm
, NULL
, MS_BIND
, NULL
);
975 devmqueue
= strjoina(temporary_mount
, "/dev/mqueue");
976 (void) mkdir(devmqueue
, 0755);
977 (void) mount_nofollow_verbose(LOG_DEBUG
, "/dev/mqueue", devmqueue
, NULL
, MS_BIND
, NULL
);
979 devhugepages
= strjoina(temporary_mount
, "/dev/hugepages");
980 (void) mkdir(devhugepages
, 0755);
981 (void) mount_nofollow_verbose(LOG_DEBUG
, "/dev/hugepages", devhugepages
, NULL
, MS_BIND
, NULL
);
983 devlog
= strjoina(temporary_mount
, "/dev/log");
984 if (symlink("/run/systemd/journal/dev-log", devlog
) < 0)
985 log_debug_errno(errno
, "Failed to create a symlink '%s' to /run/systemd/journal/dev-log, ignoring: %m", devlog
);
987 NULSTR_FOREACH(d
, devnodes
) {
988 r
= clone_device_node(d
, temporary_mount
, &can_mknod
);
989 /* ENXIO means the *source* is not a device file, skip creation in that case */
990 if (r
< 0 && r
!= -ENXIO
)
994 r
= dev_setup(temporary_mount
, UID_INVALID
, GID_INVALID
);
996 log_debug_errno(r
, "Failed to set up basic device tree at '%s', ignoring: %m", temporary_mount
);
998 /* Create the /dev directory if missing. It is more likely to be missing when the service is started
999 * with RootDirectory. This is consistent with mount units creating the mount points when missing. */
1000 (void) mkdir_p_label(mount_entry_path(m
), 0755);
1002 /* Unmount everything in old /dev */
1003 r
= umount_recursive(mount_entry_path(m
), 0);
1005 log_debug_errno(r
, "Failed to unmount directories below '%s', ignoring: %m", mount_entry_path(m
));
1007 r
= mount_nofollow_verbose(LOG_DEBUG
, dev
, mount_entry_path(m
), NULL
, MS_MOVE
, NULL
);
1012 (void) rmdir(temporary_mount
);
1018 (void) umount_verbose(LOG_DEBUG
, devpts
, UMOUNT_NOFOLLOW
);
1021 (void) umount_verbose(LOG_DEBUG
, devshm
, UMOUNT_NOFOLLOW
);
1024 (void) umount_verbose(LOG_DEBUG
, devhugepages
, UMOUNT_NOFOLLOW
);
1027 (void) umount_verbose(LOG_DEBUG
, devmqueue
, UMOUNT_NOFOLLOW
);
1029 (void) umount_verbose(LOG_DEBUG
, dev
, UMOUNT_NOFOLLOW
);
1031 (void) rmdir(temporary_mount
);
1036 static int mount_bind_dev(const MountEntry
*m
) {
1041 /* Implements the little brother of mount_private_dev(): simply bind mounts the host's /dev into the
1042 * service's /dev. This is only used when RootDirectory= is set. */
1044 (void) mkdir_p_label(mount_entry_path(m
), 0755);
1046 r
= path_is_mount_point(mount_entry_path(m
), NULL
, 0);
1048 return log_debug_errno(r
, "Unable to determine whether /dev is already mounted: %m");
1049 if (r
> 0) /* make this a NOP if /dev is already a mount point */
1052 return mount_nofollow_verbose(LOG_DEBUG
, "/dev", mount_entry_path(m
), NULL
, MS_BIND
|MS_REC
, NULL
);
1055 static int mount_bind_sysfs(const MountEntry
*m
) {
1060 (void) mkdir_p_label(mount_entry_path(m
), 0755);
1062 r
= path_is_mount_point(mount_entry_path(m
), NULL
, 0);
1064 return log_debug_errno(r
, "Unable to determine whether /sys is already mounted: %m");
1065 if (r
> 0) /* make this a NOP if /sys is already a mount point */
1068 /* Bind mount the host's version so that we get all child mounts of it, too. */
1069 return mount_nofollow_verbose(LOG_DEBUG
, "/sys", mount_entry_path(m
), NULL
, MS_BIND
|MS_REC
, NULL
);
1072 static int mount_private_sysfs(const MountEntry
*m
) {
1073 const char *entry_path
= mount_entry_path(ASSERT_PTR(m
));
1076 (void) mkdir_p_label(entry_path
, 0755);
1078 n
= umount_recursive(entry_path
, 0);
1080 r
= mount_nofollow_verbose(LOG_DEBUG
, "sysfs", entry_path
, "sysfs", MS_NOSUID
|MS_NOEXEC
|MS_NODEV
, NULL
);
1081 if (ERRNO_IS_NEG_PRIVILEGE(r
)) {
1082 /* When we do not have enough privileges to mount sysfs, fall back to use existing /sys. */
1085 /* /sys or some of sub-mounts are umounted in the above. Refuse incomplete tree.
1086 * Propagate the original error code returned by mount() in the above. */
1089 return mount_bind_sysfs(m
);
1094 /* We mounted a new instance now. Let's bind mount the children over now. */
1095 (void) bind_mount_submounts("/sys", entry_path
);
1099 static int mount_procfs(const MountEntry
*m
, const NamespaceInfo
*ns_info
) {
1100 _cleanup_free_
char *opts
= NULL
;
1101 const char *entry_path
;
1107 if (ns_info
->protect_proc
!= PROTECT_PROC_DEFAULT
||
1108 ns_info
->proc_subset
!= PROC_SUBSET_ALL
) {
1110 /* Starting with kernel 5.8 procfs' hidepid= logic is truly per-instance (previously it
1111 * pretended to be per-instance but actually was per-namespace), hence let's make use of it
1112 * if requested. To make sure this logic succeeds only on kernels where hidepid= is
1113 * per-instance, we'll exclusively use the textual value for hidepid=, since support was
1114 * added in the same commit: if it's supported it is thus also per-instance. */
1116 const char *hpv
= ns_info
->protect_proc
== PROTECT_PROC_DEFAULT
?
1118 protect_proc_to_string(ns_info
->protect_proc
);
1120 /* hidepid= support was added in 5.8, so we can use fsconfig()/fsopen() (which were added in
1121 * 5.2) to check if hidepid= is supported. This avoids a noisy dmesg log by the kernel when
1122 * trying to use hidepid= on systems where it isn't supported. The same applies for subset=.
1123 * fsopen()/fsconfig() was also backported on some distros which allows us to detect
1124 * hidepid=/subset= support in even more scenarios. */
1126 if (mount_option_supported("proc", "hidepid", hpv
) != 0) {
1127 opts
= strjoin("hidepid=", hpv
);
1132 if (ns_info
->proc_subset
== PROC_SUBSET_PID
&&
1133 mount_option_supported("proc", "subset", "pid") != 0)
1134 if (!strextend_with_separator(&opts
, ",", "subset=pid"))
1138 entry_path
= mount_entry_path(m
);
1139 (void) mkdir_p_label(entry_path
, 0755);
1141 /* Mount a new instance, so that we get the one that matches our user namespace, if we are running in
1142 * one. i.e we don't reuse existing mounts here under any condition, we want a new instance owned by
1143 * our user namespace and with our hidepid= settings applied. Hence, let's get rid of everything
1144 * mounted on /proc/ first. */
1146 n
= umount_recursive(entry_path
, 0);
1148 r
= mount_nofollow_verbose(LOG_DEBUG
, "proc", entry_path
, "proc", MS_NOSUID
|MS_NOEXEC
|MS_NODEV
, opts
);
1149 if (r
== -EINVAL
&& opts
)
1150 /* If this failed with EINVAL then this likely means the textual hidepid= stuff is
1151 * not supported by the kernel, and thus the per-instance hidepid= neither, which
1152 * means we really don't want to use it, since it would affect our host's /proc
1153 * mount. Hence let's gracefully fallback to a classic, unrestricted version. */
1154 r
= mount_nofollow_verbose(LOG_DEBUG
, "proc", entry_path
, "proc", MS_NOSUID
|MS_NOEXEC
|MS_NODEV
, NULL
);
1155 if (ERRNO_IS_NEG_PRIVILEGE(r
)) {
1156 /* When we do not have enough privileges to mount /proc, fall back to use existing /proc. */
1159 /* /proc or some of sub-mounts are umounted in the above. Refuse incomplete tree.
1160 * Propagate the original error code returned by mount() in the above. */
1163 r
= path_is_mount_point(entry_path
, NULL
, 0);
1165 return log_debug_errno(r
, "Unable to determine whether /proc is already mounted: %m");
1169 /* We lack permissions to mount a new instance of /proc, and it is not already mounted. But
1170 * we can access the host's, so as a final fallback bind-mount it to the destination, as most
1171 * likely we are inside a user manager in an unprivileged user namespace. */
1172 return mount_nofollow_verbose(LOG_DEBUG
, "/proc", entry_path
, NULL
, MS_BIND
|MS_REC
, NULL
);
1177 /* We mounted a new instance now. Let's bind mount the children over now. This matters for nspawn
1178 * where a bunch of files are overmounted, in particular the boot id */
1179 (void) bind_mount_submounts("/proc", entry_path
);
1183 static int mount_tmpfs(const MountEntry
*m
) {
1184 const char *entry_path
, *inner_path
;
1189 entry_path
= mount_entry_path(m
);
1190 inner_path
= mount_entry_unprefixed_path(m
);
1192 /* First, get rid of everything that is below if there is anything. Then, overmount with our new
1195 (void) mkdir_p_label(entry_path
, 0755);
1196 (void) umount_recursive(entry_path
, 0);
1198 r
= mount_nofollow_verbose(LOG_DEBUG
, "tmpfs", entry_path
, "tmpfs", m
->flags
, mount_entry_options(m
));
1202 r
= label_fix_full(AT_FDCWD
, entry_path
, inner_path
, 0);
1204 return log_debug_errno(r
, "Failed to fix label of '%s' as '%s': %m", entry_path
, inner_path
);
1209 static int mount_run(const MountEntry
*m
) {
1214 r
= path_is_mount_point(mount_entry_path(m
), NULL
, 0);
1215 if (r
< 0 && r
!= -ENOENT
)
1216 return log_debug_errno(r
, "Unable to determine whether /run is already mounted: %m");
1217 if (r
> 0) /* make this a NOP if /run is already a mount point */
1220 return mount_tmpfs(m
);
1223 static int mount_mqueuefs(const MountEntry
*m
) {
1225 const char *entry_path
;
1229 entry_path
= mount_entry_path(m
);
1231 (void) mkdir_p_label(entry_path
, 0755);
1232 (void) umount_recursive(entry_path
, 0);
1234 r
= mount_nofollow_verbose(LOG_DEBUG
, "mqueue", entry_path
, "mqueue", m
->flags
, mount_entry_options(m
));
1241 static int mount_image(
1242 const MountEntry
*m
,
1243 const char *root_directory
,
1244 const ImagePolicy
*image_policy
) {
1246 _cleanup_free_
char *host_os_release_id
= NULL
, *host_os_release_version_id
= NULL
,
1247 *host_os_release_level
= NULL
, *extension_name
= NULL
;
1248 _cleanup_strv_free_
char **extension_release
= NULL
;
1249 ImageClass
class = IMAGE_SYSEXT
;
1254 r
= path_extract_filename(mount_entry_source(m
), &extension_name
);
1256 return log_debug_errno(r
, "Failed to extract extension name from %s: %m", mount_entry_source(m
));
1258 if (m
->mode
== EXTENSION_IMAGES
) {
1259 r
= load_extension_release_pairs(mount_entry_source(m
), IMAGE_SYSEXT
, extension_name
, /* relax_extension_release_check= */ false, &extension_release
);
1261 r
= load_extension_release_pairs(mount_entry_source(m
), IMAGE_CONFEXT
, extension_name
, /* relax_extension_release_check= */ false, &extension_release
);
1263 class = IMAGE_CONFEXT
;
1268 r
= parse_os_release(
1269 empty_to_root(root_directory
),
1270 "ID", &host_os_release_id
,
1271 "VERSION_ID", &host_os_release_version_id
,
1272 image_class_info
[class].level_env
, &host_os_release_level
,
1275 return log_debug_errno(r
, "Failed to acquire 'os-release' data of OS tree '%s': %m", empty_to_root(root_directory
));
1276 if (isempty(host_os_release_id
))
1277 return log_debug_errno(SYNTHETIC_ERRNO(EINVAL
), "'ID' field not found or empty in 'os-release' data of OS tree '%s': %m", empty_to_root(root_directory
));
1280 r
= verity_dissect_and_mount(
1282 mount_entry_source(m
),
1283 mount_entry_path(m
),
1287 host_os_release_version_id
,
1288 host_os_release_level
,
1290 if (r
== -ENOENT
&& m
->ignore
)
1292 if (r
== -ESTALE
&& host_os_release_id
)
1293 return log_error_errno(r
,
1294 "Failed to mount image %s, extension-release metadata does not match the lower layer's: ID=%s%s%s%s%s",
1295 mount_entry_source(m
),
1297 host_os_release_version_id
? " VERSION_ID=" : "",
1298 strempty(host_os_release_version_id
),
1299 host_os_release_level
? image_class_info
[class].level_env_print
: "",
1300 strempty(host_os_release_level
));
1302 return log_debug_errno(r
, "Failed to mount image %s on %s: %m", mount_entry_source(m
), mount_entry_path(m
));
1307 static int mount_overlay(const MountEntry
*m
) {
1308 const char *options
;
1313 options
= strjoina("lowerdir=", mount_entry_options(m
));
1315 (void) mkdir_p_label(mount_entry_path(m
), 0755);
1317 r
= mount_nofollow_verbose(LOG_DEBUG
, "overlay", mount_entry_path(m
), "overlay", MS_RDONLY
, options
);
1318 if (r
== -ENOENT
&& m
->ignore
)
1324 static int follow_symlink(
1325 const char *root_directory
,
1328 _cleanup_free_
char *target
= NULL
;
1331 /* Let's chase symlinks, but only one step at a time. That's because depending where the symlink points we
1332 * might need to change the order in which we mount stuff. Hence: let's normalize piecemeal, and do one step at
1333 * a time by specifying CHASE_STEP. This function returns 0 if we resolved one step, and > 0 if we reached the
1334 * end and already have a fully normalized name. */
1336 r
= chase(mount_entry_path(m
), root_directory
, CHASE_STEP
|CHASE_NONEXISTENT
, &target
, NULL
);
1338 return log_debug_errno(r
, "Failed to chase symlinks '%s': %m", mount_entry_path(m
));
1339 if (r
> 0) /* Reached the end, nothing more to resolve */
1342 if (m
->n_followed
>= CHASE_MAX
) /* put a boundary on things */
1343 return log_debug_errno(SYNTHETIC_ERRNO(ELOOP
),
1344 "Symlink loop on '%s'.",
1345 mount_entry_path(m
));
1347 log_debug("Followed mount entry path symlink %s %s %s.",
1348 mount_entry_path(m
), special_glyph(SPECIAL_GLYPH_ARROW_RIGHT
), target
);
1350 mount_entry_consume_prefix(m
, TAKE_PTR(target
));
1357 static int apply_one_mount(
1358 const char *root_directory
,
1360 const ImagePolicy
*mount_image_policy
,
1361 const ImagePolicy
*extension_image_policy
,
1362 const NamespaceInfo
*ns_info
) {
1364 _cleanup_free_
char *inaccessible
= NULL
;
1365 bool rbind
= true, make
= false;
1372 log_debug("Applying namespace mount on %s", mount_entry_path(m
));
1376 case INACCESSIBLE
: {
1377 _cleanup_free_
char *tmp
= NULL
;
1378 const char *runtime_dir
;
1381 /* First, get rid of everything that is below if there
1382 * is anything... Then, overmount it with an
1383 * inaccessible path. */
1384 (void) umount_recursive(mount_entry_path(m
), 0);
1386 if (lstat(mount_entry_path(m
), &target
) < 0) {
1387 if (errno
== ENOENT
&& m
->ignore
)
1390 return log_debug_errno(errno
, "Failed to lstat() %s to determine what to mount over it: %m",
1391 mount_entry_path(m
));
1395 runtime_dir
= "/run";
1397 if (asprintf(&tmp
, "/run/user/" UID_FMT
, geteuid()) < 0)
1403 r
= mode_to_inaccessible_node(runtime_dir
, target
.st_mode
, &inaccessible
);
1405 return log_debug_errno(SYNTHETIC_ERRNO(ELOOP
),
1406 "File type not supported for inaccessible mounts. Note that symlinks are not allowed");
1407 what
= inaccessible
;
1413 case READWRITE_IMPLICIT
:
1416 r
= path_is_mount_point(mount_entry_path(m
), root_directory
, 0);
1417 if (r
== -ENOENT
&& m
->ignore
)
1420 return log_debug_errno(r
, "Failed to determine whether %s is already a mount point: %m",
1421 mount_entry_path(m
));
1422 if (r
> 0) /* Nothing to do here, it is already a mount. We just later toggle the MS_RDONLY
1423 * and MS_NOEXEC bits for the mount point if needed. */
1425 /* This isn't a mount point yet, let's make it one. */
1426 what
= mount_entry_path(m
);
1429 case EXTENSION_DIRECTORIES
: {
1430 _cleanup_free_
char *host_os_release_id
= NULL
, *host_os_release_version_id
= NULL
,
1431 *host_os_release_level
= NULL
, *extension_name
= NULL
;
1432 _cleanup_strv_free_
char **extension_release
= NULL
;
1433 ImageClass
class = IMAGE_SYSEXT
;
1435 r
= path_extract_filename(mount_entry_source(m
), &extension_name
);
1437 return log_debug_errno(r
, "Failed to extract extension name from %s: %m", mount_entry_source(m
));
1439 r
= load_extension_release_pairs(mount_entry_source(m
), IMAGE_SYSEXT
, extension_name
, /* relax_extension_release_check= */ false, &extension_release
);
1441 r
= load_extension_release_pairs(mount_entry_source(m
), IMAGE_CONFEXT
, extension_name
, /* relax_extension_release_check= */ false, &extension_release
);
1443 class = IMAGE_CONFEXT
;
1448 r
= parse_os_release(
1449 empty_to_root(root_directory
),
1450 "ID", &host_os_release_id
,
1451 "VERSION_ID", &host_os_release_version_id
,
1452 image_class_info
[class].level_env
, &host_os_release_level
,
1455 return log_debug_errno(r
, "Failed to acquire 'os-release' data of OS tree '%s': %m", empty_to_root(root_directory
));
1456 if (isempty(host_os_release_id
))
1457 return log_debug_errno(SYNTHETIC_ERRNO(EINVAL
), "'ID' field not found or empty in 'os-release' data of OS tree '%s': %m", empty_to_root(root_directory
));
1459 r
= load_extension_release_pairs(mount_entry_source(m
), class, extension_name
, /* relax_extension_release_check= */ false, &extension_release
);
1460 if (r
== -ENOENT
&& m
->ignore
)
1463 return log_debug_errno(r
, "Failed to parse directory %s extension-release metadata: %m", extension_name
);
1465 r
= extension_release_validate(
1468 host_os_release_version_id
,
1469 host_os_release_level
,
1470 /* host_extension_scope */ NULL
, /* Leave empty, we need to accept both system and portable */
1474 return log_debug_errno(SYNTHETIC_ERRNO(ESTALE
), "Directory %s extension-release metadata does not match the root's", extension_name
);
1476 return log_debug_errno(r
, "Failed to compare directory %s extension-release metadata with the root's os-release: %m", extension_name
);
1485 case BIND_MOUNT_RECURSIVE
: {
1486 _cleanup_free_
char *chased
= NULL
;
1488 /* Since mount() will always follow symlinks we chase the symlinks on our own first. Note
1489 * that bind mount source paths are always relative to the host root, hence we pass NULL as
1490 * root directory to chase() here. */
1492 r
= chase(mount_entry_source(m
), NULL
, CHASE_TRAIL_SLASH
, &chased
, NULL
);
1493 if (r
== -ENOENT
&& m
->ignore
) {
1494 log_debug_errno(r
, "Path %s does not exist, ignoring.", mount_entry_source(m
));
1498 return log_debug_errno(r
, "Failed to follow symlinks on %s: %m", mount_entry_source(m
));
1500 log_debug("Followed source symlinks %s %s %s.",
1501 mount_entry_source(m
), special_glyph(SPECIAL_GLYPH_ARROW_RIGHT
), chased
);
1503 free_and_replace(m
->source_malloc
, chased
);
1505 what
= mount_entry_source(m
);
1512 return mount_tmpfs(m
);
1515 case PRIVATE_TMP_READONLY
:
1516 what
= mount_entry_source(m
);
1521 return mount_private_dev(m
);
1524 return mount_bind_dev(m
);
1527 return mount_private_sysfs(m
);
1530 return mount_bind_sysfs(m
);
1533 return mount_procfs(m
, ns_info
);
1536 return mount_run(m
);
1539 return mount_mqueuefs(m
);
1542 return mount_image(m
, NULL
, mount_image_policy
);
1544 case EXTENSION_IMAGES
:
1545 return mount_image(m
, root_directory
, extension_image_policy
);
1548 return mount_overlay(m
);
1551 assert_not_reached();
1556 r
= mount_nofollow_verbose(LOG_DEBUG
, what
, mount_entry_path(m
), NULL
, MS_BIND
|(rbind
? MS_REC
: 0), NULL
);
1558 bool try_again
= false;
1560 if (r
== -ENOENT
&& make
) {
1563 /* Hmm, either the source or the destination are missing. Let's see if we can create
1564 the destination, then try again. */
1566 (void) mkdir_parents(mount_entry_path(m
), 0755);
1568 q
= make_mount_point_inode_from_path(what
, mount_entry_path(m
), 0755);
1569 if (q
< 0 && q
!= -EEXIST
)
1570 log_error_errno(q
, "Failed to create destination mount point node '%s': %m",
1571 mount_entry_path(m
));
1577 r
= mount_nofollow_verbose(LOG_DEBUG
, what
, mount_entry_path(m
), NULL
, MS_BIND
|(rbind
? MS_REC
: 0), NULL
);
1579 return log_error_errno(r
, "Failed to mount %s to %s: %m", what
, mount_entry_path(m
));
1582 log_debug("Successfully mounted %s to %s", what
, mount_entry_path(m
));
1586 static int make_read_only(const MountEntry
*m
, char **deny_list
, FILE *proc_self_mountinfo
) {
1587 unsigned long new_flags
= 0, flags_mask
= 0;
1592 assert(proc_self_mountinfo
);
1594 if (mount_entry_read_only(m
) || m
->mode
== PRIVATE_DEV
) {
1595 new_flags
|= MS_RDONLY
;
1596 flags_mask
|= MS_RDONLY
;
1600 new_flags
|= MS_NOSUID
;
1601 flags_mask
|= MS_NOSUID
;
1604 if (flags_mask
== 0) /* No Change? */
1607 /* We generally apply these changes recursively, except for /dev, and the cases we know there's
1608 * nothing further down. Set /dev readonly, but not submounts like /dev/shm. Also, we only set the
1609 * per-mount read-only flag. We can't set it on the superblock, if we are inside a user namespace
1610 * and running Linux <= 4.17. */
1612 mount_entry_read_only(m
) &&
1613 !IN_SET(m
->mode
, EMPTY_DIR
, TMPFS
);
1615 r
= bind_remount_recursive_with_mountinfo(mount_entry_path(m
), new_flags
, flags_mask
, deny_list
, proc_self_mountinfo
);
1617 r
= bind_remount_one_with_mountinfo(mount_entry_path(m
), new_flags
, flags_mask
, proc_self_mountinfo
);
1619 /* Note that we only turn on the MS_RDONLY flag here, we never turn it off. Something that was marked
1620 * read-only already stays this way. This improves compatibility with container managers, where we
1621 * won't attempt to undo read-only mounts already applied. */
1623 if (r
== -ENOENT
&& m
->ignore
)
1626 return log_debug_errno(r
, "Failed to re-mount '%s'%s: %m", mount_entry_path(m
),
1627 submounts
? " and its submounts" : "");
1631 static int make_noexec(const MountEntry
*m
, char **deny_list
, FILE *proc_self_mountinfo
) {
1632 unsigned long new_flags
= 0, flags_mask
= 0;
1637 assert(proc_self_mountinfo
);
1639 if (mount_entry_noexec(m
)) {
1640 new_flags
|= MS_NOEXEC
;
1641 flags_mask
|= MS_NOEXEC
;
1642 } else if (mount_entry_exec(m
)) {
1643 new_flags
&= ~MS_NOEXEC
;
1644 flags_mask
|= MS_NOEXEC
;
1647 if (flags_mask
== 0) /* No Change? */
1650 submounts
= !IN_SET(m
->mode
, EMPTY_DIR
, TMPFS
);
1653 r
= bind_remount_recursive_with_mountinfo(mount_entry_path(m
), new_flags
, flags_mask
, deny_list
, proc_self_mountinfo
);
1655 r
= bind_remount_one_with_mountinfo(mount_entry_path(m
), new_flags
, flags_mask
, proc_self_mountinfo
);
1657 if (r
== -ENOENT
&& m
->ignore
)
1660 return log_debug_errno(r
, "Failed to re-mount '%s'%s: %m", mount_entry_path(m
),
1661 submounts
? " and its submounts" : "");
1665 static int make_nosuid(const MountEntry
*m
, FILE *proc_self_mountinfo
) {
1670 assert(proc_self_mountinfo
);
1672 submounts
= !IN_SET(m
->mode
, EMPTY_DIR
, TMPFS
);
1675 r
= bind_remount_recursive_with_mountinfo(mount_entry_path(m
), MS_NOSUID
, MS_NOSUID
, NULL
, proc_self_mountinfo
);
1677 r
= bind_remount_one_with_mountinfo(mount_entry_path(m
), MS_NOSUID
, MS_NOSUID
, proc_self_mountinfo
);
1678 if (r
== -ENOENT
&& m
->ignore
)
1681 return log_debug_errno(r
, "Failed to re-mount '%s'%s: %m", mount_entry_path(m
),
1682 submounts
? " and its submounts" : "");
1686 static bool namespace_info_mount_apivfs(const NamespaceInfo
*ns_info
) {
1690 * ProtectControlGroups= and ProtectKernelTunables= imply MountAPIVFS=,
1691 * since to protect the API VFS mounts, they need to be around in the
1695 return ns_info
->mount_apivfs
||
1696 ns_info
->protect_control_groups
||
1697 ns_info
->protect_kernel_tunables
||
1698 ns_info
->protect_proc
!= PROTECT_PROC_DEFAULT
||
1699 ns_info
->proc_subset
!= PROC_SUBSET_ALL
;
1702 static size_t namespace_calculate_mounts(
1703 const NamespaceInfo
*ns_info
,
1704 char** read_write_paths
,
1705 char** read_only_paths
,
1706 char** inaccessible_paths
,
1708 char** no_exec_paths
,
1709 char** empty_directories
,
1710 size_t n_bind_mounts
,
1711 size_t n_temporary_filesystems
,
1712 size_t n_mount_images
,
1713 size_t n_extension_images
,
1714 size_t n_extension_directories
,
1715 size_t n_hierarchies
,
1716 const char* tmp_dir
,
1717 const char* var_tmp_dir
,
1718 const char *creds_path
,
1719 const char* log_namespace
,
1720 bool setup_propagate
,
1721 const char* notify_socket
,
1722 const char* host_os_release
) {
1724 size_t protect_home_cnt
;
1725 size_t protect_system_cnt
=
1726 (ns_info
->protect_system
== PROTECT_SYSTEM_STRICT
?
1727 ELEMENTSOF(protect_system_strict_table
) :
1728 ((ns_info
->protect_system
== PROTECT_SYSTEM_FULL
) ?
1729 ELEMENTSOF(protect_system_full_table
) :
1730 ((ns_info
->protect_system
== PROTECT_SYSTEM_YES
) ?
1731 ELEMENTSOF(protect_system_yes_table
) : 0)));
1734 (ns_info
->protect_home
== PROTECT_HOME_YES
?
1735 ELEMENTSOF(protect_home_yes_table
) :
1736 ((ns_info
->protect_home
== PROTECT_HOME_READ_ONLY
) ?
1737 ELEMENTSOF(protect_home_read_only_table
) :
1738 ((ns_info
->protect_home
== PROTECT_HOME_TMPFS
) ?
1739 ELEMENTSOF(protect_home_tmpfs_table
) : 0)));
1741 return !!tmp_dir
+ !!var_tmp_dir
+
1742 strv_length(read_write_paths
) +
1743 strv_length(read_only_paths
) +
1744 strv_length(inaccessible_paths
) +
1745 strv_length(exec_paths
) +
1746 strv_length(no_exec_paths
) +
1747 strv_length(empty_directories
) +
1750 (n_extension_images
> 0 || n_extension_directories
> 0 ? /* Mount each image and directory plus an overlay per hierarchy */
1751 n_hierarchies
+ n_extension_images
+ n_extension_directories
: 0) +
1752 n_temporary_filesystems
+
1753 ns_info
->private_dev
+
1754 (ns_info
->protect_kernel_tunables
?
1755 ELEMENTSOF(protect_kernel_tunables_proc_table
) + ELEMENTSOF(protect_kernel_tunables_sys_table
) : 0) +
1756 (ns_info
->protect_kernel_modules
? ELEMENTSOF(protect_kernel_modules_table
) : 0) +
1757 (ns_info
->protect_kernel_logs
?
1758 ELEMENTSOF(protect_kernel_logs_proc_table
) + ELEMENTSOF(protect_kernel_logs_dev_table
) : 0) +
1759 (ns_info
->protect_control_groups
? 1 : 0) +
1760 protect_home_cnt
+ protect_system_cnt
+
1761 (ns_info
->protect_hostname
? 2 : 0) +
1762 (namespace_info_mount_apivfs(ns_info
) ? ELEMENTSOF(apivfs_table
) : 0) +
1763 (creds_path
? 2 : 1) +
1765 setup_propagate
+ /* /run/systemd/incoming */
1768 ns_info
->private_network
+ /* /sys */
1769 ns_info
->private_ipc
; /* /dev/mqueue */
1772 /* Walk all mount entries and dropping any unused mounts. This affects all
1774 * - that are implicitly protected by a path that has been rendered inaccessible
1775 * - whose immediate parent requests the same protection mode as the mount itself
1776 * - that are outside of the relevant root directory
1777 * - which are duplicates
1779 static void drop_unused_mounts(const char *root_directory
, MountEntry
*mounts
, size_t *n_mounts
) {
1780 assert(root_directory
);
1782 assert(mounts
|| *n_mounts
== 0);
1784 typesafe_qsort(mounts
, *n_mounts
, mount_path_compare
);
1786 drop_duplicates(mounts
, n_mounts
);
1787 drop_outside_root(root_directory
, mounts
, n_mounts
);
1788 drop_inaccessible(mounts
, n_mounts
);
1789 drop_nop(mounts
, n_mounts
);
1792 static int create_symlinks_from_tuples(const char *root
, char **strv_symlinks
) {
1795 STRV_FOREACH_PAIR(src
, dst
, strv_symlinks
) {
1796 _cleanup_free_
char *src_abs
= NULL
, *dst_abs
= NULL
;
1798 src_abs
= path_join(root
, *src
);
1799 dst_abs
= path_join(root
, *dst
);
1800 if (!src_abs
|| !dst_abs
)
1803 r
= mkdir_parents_label(dst_abs
, 0755);
1807 r
= symlink_idempotent(src_abs
, dst_abs
, true);
1815 static void mount_entry_path_debug_string(const char *root
, MountEntry
*m
, char **error_path
) {
1818 /* Create a string suitable for debugging logs, stripping for example the local working directory.
1819 * For example, with a BindPaths=/var/bar that does not exist on the host:
1822 * foo.service: Failed to set up mount namespacing: /run/systemd/unit-root/var/bar: No such file or directory
1824 * foo.service: Failed to set up mount namespacing: /var/bar: No such file or directory
1826 * Note that this is an error path, so no OOM check is done on purpose. */
1831 if (!mount_entry_path(m
)) {
1837 const char *e
= startswith(mount_entry_path(m
), root
);
1839 *error_path
= strdup(e
);
1844 *error_path
= strdup(mount_entry_path(m
));
1848 static int apply_mounts(
1850 const ImagePolicy
*mount_image_policy
,
1851 const ImagePolicy
*extension_image_policy
,
1852 const NamespaceInfo
*ns_info
,
1856 char **error_path
) {
1858 _cleanup_fclose_
FILE *proc_self_mountinfo
= NULL
;
1859 _cleanup_free_
char **deny_list
= NULL
;
1862 if (n_mounts
== 0) /* Shortcut: nothing to do */
1869 /* Open /proc/self/mountinfo now as it may become unavailable if we mount anything on top of
1870 * /proc. For example, this is the case with the option: 'InaccessiblePaths=/proc'. */
1871 proc_self_mountinfo
= fopen("/proc/self/mountinfo", "re");
1872 if (!proc_self_mountinfo
) {
1876 *error_path
= strdup("/proc/self/mountinfo");
1878 return log_debug_errno(r
, "Failed to open /proc/self/mountinfo: %m");
1881 /* First round, establish all mounts we need */
1885 for (MountEntry
*m
= mounts
; m
< mounts
+ *n_mounts
; ++m
) {
1890 /* ExtensionImages/Directories are first opened in the propagate directory, not in the root_directory */
1891 r
= follow_symlink(!IN_SET(m
->mode
, EXTENSION_IMAGES
, EXTENSION_DIRECTORIES
) ? root
: NULL
, m
);
1893 mount_entry_path_debug_string(root
, m
, error_path
);
1897 /* We hit a symlinked mount point. The entry got rewritten and might
1898 * point to a very different place now. Let's normalize the changed
1899 * list, and start from the beginning. After all to mount the entry
1900 * at the new location we might need some other mounts first */
1905 r
= apply_one_mount(root
, m
, mount_image_policy
, extension_image_policy
, ns_info
);
1907 mount_entry_path_debug_string(root
, m
, error_path
);
1917 drop_unused_mounts(root
, mounts
, n_mounts
);
1920 /* Now that all filesystems have been set up, but before the
1921 * read-only switches are flipped, create the exec dirs and other symlinks.
1922 * Note that when /var/lib is not empty/tmpfs, these symlinks will already
1923 * exist, which means this will be a no-op. */
1924 r
= create_symlinks_from_tuples(root
, symlinks
);
1926 return log_debug_errno(r
, "Failed to set up symlinks inside mount namespace: %m");
1928 /* Create a deny list we can pass to bind_mount_recursive() */
1929 deny_list
= new(char*, (*n_mounts
)+1);
1932 for (size_t j
= 0; j
< *n_mounts
; j
++)
1933 deny_list
[j
] = (char*) mount_entry_path(mounts
+j
);
1934 deny_list
[*n_mounts
] = NULL
;
1936 /* Second round, flip the ro bits if necessary. */
1937 for (MountEntry
*m
= mounts
; m
< mounts
+ *n_mounts
; ++m
) {
1938 r
= make_read_only(m
, deny_list
, proc_self_mountinfo
);
1940 mount_entry_path_debug_string(root
, m
, error_path
);
1945 /* Third round, flip the noexec bits with a simplified deny list. */
1946 for (size_t j
= 0; j
< *n_mounts
; j
++)
1947 if (IN_SET((mounts
+j
)->mode
, EXEC
, NOEXEC
))
1948 deny_list
[j
] = (char*) mount_entry_path(mounts
+j
);
1949 deny_list
[*n_mounts
] = NULL
;
1951 for (MountEntry
*m
= mounts
; m
< mounts
+ *n_mounts
; ++m
) {
1952 r
= make_noexec(m
, deny_list
, proc_self_mountinfo
);
1954 mount_entry_path_debug_string(root
, m
, error_path
);
1959 /* Fourth round, flip the nosuid bits without a deny list. */
1960 if (ns_info
->mount_nosuid
)
1961 for (MountEntry
*m
= mounts
; m
< mounts
+ *n_mounts
; ++m
) {
1962 r
= make_nosuid(m
, proc_self_mountinfo
);
1964 mount_entry_path_debug_string(root
, m
, error_path
);
1972 static bool root_read_only(
1973 char **read_only_paths
,
1974 ProtectSystem protect_system
) {
1976 /* Determine whether the root directory is going to be read-only given the configured settings. */
1978 if (protect_system
== PROTECT_SYSTEM_STRICT
)
1981 if (prefixed_path_strv_contains(read_only_paths
, "/"))
1987 static bool home_read_only(
1988 char** read_only_paths
,
1989 char** inaccessible_paths
,
1990 char** empty_directories
,
1991 const BindMount
*bind_mounts
,
1992 size_t n_bind_mounts
,
1993 const TemporaryFileSystem
*temporary_filesystems
,
1994 size_t n_temporary_filesystems
,
1995 ProtectHome protect_home
) {
1997 /* Determine whether the /home directory is going to be read-only given the configured settings. Yes,
1998 * this is a bit sloppy, since we don't bother checking for cases where / is affected by multiple
2001 if (protect_home
!= PROTECT_HOME_NO
)
2004 if (prefixed_path_strv_contains(read_only_paths
, "/home") ||
2005 prefixed_path_strv_contains(inaccessible_paths
, "/home") ||
2006 prefixed_path_strv_contains(empty_directories
, "/home"))
2009 for (size_t i
= 0; i
< n_temporary_filesystems
; i
++)
2010 if (path_equal(temporary_filesystems
[i
].path
, "/home"))
2013 /* If /home is overmounted with some dir from the host it's not writable. */
2014 for (size_t i
= 0; i
< n_bind_mounts
; i
++)
2015 if (path_equal(bind_mounts
[i
].destination
, "/home"))
2021 int setup_namespace(
2022 const char* root_directory
,
2023 const char* root_image
,
2024 const MountOptions
*root_image_mount_options
,
2025 const ImagePolicy
*root_image_policy
,
2026 const NamespaceInfo
*ns_info
,
2027 char** read_write_paths
,
2028 char** read_only_paths
,
2029 char** inaccessible_paths
,
2031 char** no_exec_paths
,
2032 char** empty_directories
,
2034 const BindMount
*bind_mounts
,
2035 size_t n_bind_mounts
,
2036 const TemporaryFileSystem
*temporary_filesystems
,
2037 size_t n_temporary_filesystems
,
2038 const MountImage
*mount_images
,
2039 size_t n_mount_images
,
2040 const ImagePolicy
*mount_image_policy
,
2041 const char* tmp_dir
,
2042 const char* var_tmp_dir
,
2043 const char *creds_path
,
2044 const char *log_namespace
,
2045 unsigned long mount_propagation_flag
,
2046 VeritySettings
*verity
,
2047 const MountImage
*extension_images
,
2048 size_t n_extension_images
,
2049 const ImagePolicy
*extension_image_policy
,
2050 char **extension_directories
,
2051 const char *propagate_dir
,
2052 const char *incoming_dir
,
2053 const char *extension_dir
,
2054 const char *notify_socket
,
2055 const char *host_os_release_stage
,
2056 char **error_path
) {
2058 _cleanup_(loop_device_unrefp
) LoopDevice
*loop_device
= NULL
;
2059 _cleanup_(dissected_image_unrefp
) DissectedImage
*dissected_image
= NULL
;
2060 _cleanup_strv_free_
char **hierarchies
= NULL
;
2061 MountEntry
*m
= NULL
, *mounts
= NULL
;
2062 bool require_prefix
= false, setup_propagate
= false;
2064 DissectImageFlags dissect_image_flags
=
2065 DISSECT_IMAGE_GENERIC_ROOT
|
2066 DISSECT_IMAGE_REQUIRE_ROOT
|
2067 DISSECT_IMAGE_DISCARD_ON_LOOP
|
2068 DISSECT_IMAGE_RELAX_VAR_CHECK
|
2069 DISSECT_IMAGE_FSCK
|
2070 DISSECT_IMAGE_USR_NO_ROOT
|
2071 DISSECT_IMAGE_GROWFS
|
2072 DISSECT_IMAGE_ADD_PARTITION_DEVICES
|
2073 DISSECT_IMAGE_PIN_PARTITION_DEVICES
;
2079 /* Make sure that all mknod(), mkdir() calls we do are unaffected by the umask, and the access modes
2080 * we configure take effect */
2081 BLOCK_WITH_UMASK(0000);
2083 if (!isempty(propagate_dir
) && !isempty(incoming_dir
))
2084 setup_propagate
= true;
2086 if (mount_propagation_flag
== 0)
2087 mount_propagation_flag
= MS_SHARED
;
2090 /* Make the whole image read-only if we can determine that we only access it in a read-only fashion. */
2091 if (root_read_only(read_only_paths
,
2092 ns_info
->protect_system
) &&
2093 home_read_only(read_only_paths
, inaccessible_paths
, empty_directories
,
2094 bind_mounts
, n_bind_mounts
, temporary_filesystems
, n_temporary_filesystems
,
2095 ns_info
->protect_home
) &&
2096 strv_isempty(read_write_paths
))
2097 dissect_image_flags
|= DISSECT_IMAGE_READ_ONLY
;
2099 SET_FLAG(dissect_image_flags
, DISSECT_IMAGE_NO_PARTITION_TABLE
, verity
&& verity
->data_path
);
2101 r
= loop_device_make_by_path(
2103 FLAGS_SET(dissect_image_flags
, DISSECT_IMAGE_DEVICE_READ_ONLY
) ? O_RDONLY
: -1 /* < 0 means writable if possible, read-only as fallback */,
2104 /* sector_size= */ UINT32_MAX
,
2105 FLAGS_SET(dissect_image_flags
, DISSECT_IMAGE_NO_PARTITION_TABLE
) ? 0 : LO_FLAGS_PARTSCAN
,
2109 return log_debug_errno(r
, "Failed to create loop device for root image: %m");
2111 r
= dissect_loop_device(
2114 root_image_mount_options
,
2116 dissect_image_flags
,
2119 return log_debug_errno(r
, "Failed to dissect image: %m");
2121 r
= dissected_image_load_verity_sig_partition(
2128 r
= dissected_image_decrypt(
2132 dissect_image_flags
);
2134 return log_debug_errno(r
, "Failed to decrypt dissected image: %m");
2138 root
= root_directory
;
2140 /* /run/systemd should have been created by PID 1 early on already, but in some cases, like
2141 * when running tests (test-execute), it might not have been created yet so let's make sure
2142 * we create it if it doesn't already exist. */
2143 (void) mkdir_p_label("/run/systemd", 0755);
2145 /* Always create the mount namespace in a temporary directory, instead of operating directly
2146 * in the root. The temporary directory prevents any mounts from being potentially obscured
2147 * my other mounts we already applied. We use the same mount point for all images, which is
2148 * safe, since they all live in their own namespaces after all, and hence won't see each
2149 * other. (Note: this directory is also created by PID 1 early on, we create it here for
2150 * similar reasons as /run/systemd/ first.) */
2151 root
= "/run/systemd/mount-rootfs";
2152 (void) mkdir_label(root
, 0555);
2154 require_prefix
= true;
2157 if (n_extension_images
> 0 || !strv_isempty(extension_directories
)) {
2158 /* Hierarchy population needs to be done for sysext and confext extension images */
2159 r
= parse_env_extension_hierarchies(&hierarchies
, "SYSTEMD_SYSEXT_AND_CONFEXT_HIERARCHIES");
2164 n_mounts
= namespace_calculate_mounts(
2173 n_temporary_filesystems
,
2176 strv_length(extension_directories
),
2177 strv_length(hierarchies
),
2178 tmp_dir
, var_tmp_dir
,
2183 host_os_release_stage
);
2186 m
= mounts
= new0(MountEntry
, n_mounts
);
2190 r
= append_access_mounts(&m
, read_write_paths
, READWRITE
, require_prefix
);
2194 r
= append_access_mounts(&m
, read_only_paths
, READONLY
, require_prefix
);
2198 r
= append_access_mounts(&m
, inaccessible_paths
, INACCESSIBLE
, require_prefix
);
2202 r
= append_access_mounts(&m
, exec_paths
, EXEC
, require_prefix
);
2206 r
= append_access_mounts(&m
, no_exec_paths
, NOEXEC
, require_prefix
);
2210 r
= append_empty_dir_mounts(&m
, empty_directories
);
2214 r
= append_bind_mounts(&m
, bind_mounts
, n_bind_mounts
);
2218 r
= append_tmpfs_mounts(&m
, temporary_filesystems
, n_temporary_filesystems
);
2223 bool ro
= streq(tmp_dir
, RUN_SYSTEMD_EMPTY
);
2225 *(m
++) = (MountEntry
) {
2226 .path_const
= "/tmp",
2227 .mode
= ro
? PRIVATE_TMP_READONLY
: PRIVATE_TMP
,
2228 .source_const
= tmp_dir
,
2233 bool ro
= streq(var_tmp_dir
, RUN_SYSTEMD_EMPTY
);
2235 *(m
++) = (MountEntry
) {
2236 .path_const
= "/var/tmp",
2237 .mode
= ro
? PRIVATE_TMP_READONLY
: PRIVATE_TMP
,
2238 .source_const
= var_tmp_dir
,
2242 r
= append_mount_images(&m
, mount_images
, n_mount_images
);
2246 r
= append_extensions(&m
, root
, extension_dir
, hierarchies
, extension_images
, n_extension_images
, extension_directories
);
2250 if (ns_info
->private_dev
)
2251 *(m
++) = (MountEntry
) {
2252 .path_const
= "/dev",
2253 .mode
= PRIVATE_DEV
,
2254 .flags
= DEV_MOUNT_OPTIONS
,
2257 /* In case /proc is successfully mounted with pid tree subset only (ProcSubset=pid), the
2258 protective mounts to non-pid /proc paths would fail. But the pid only option may have
2259 failed gracefully, so let's try the mounts but it's not fatal if they don't succeed. */
2260 bool ignore_protect_proc
= ns_info
->ignore_protect_paths
|| ns_info
->proc_subset
== PROC_SUBSET_PID
;
2261 if (ns_info
->protect_kernel_tunables
) {
2262 r
= append_static_mounts(&m
,
2263 protect_kernel_tunables_proc_table
,
2264 ELEMENTSOF(protect_kernel_tunables_proc_table
),
2265 ignore_protect_proc
);
2269 r
= append_static_mounts(&m
,
2270 protect_kernel_tunables_sys_table
,
2271 ELEMENTSOF(protect_kernel_tunables_sys_table
),
2272 ns_info
->ignore_protect_paths
);
2277 if (ns_info
->protect_kernel_modules
) {
2278 r
= append_static_mounts(&m
,
2279 protect_kernel_modules_table
,
2280 ELEMENTSOF(protect_kernel_modules_table
),
2281 ns_info
->ignore_protect_paths
);
2286 if (ns_info
->protect_kernel_logs
) {
2287 r
= append_static_mounts(&m
,
2288 protect_kernel_logs_proc_table
,
2289 ELEMENTSOF(protect_kernel_logs_proc_table
),
2290 ignore_protect_proc
);
2294 r
= append_static_mounts(&m
,
2295 protect_kernel_logs_dev_table
,
2296 ELEMENTSOF(protect_kernel_logs_dev_table
),
2297 ns_info
->ignore_protect_paths
);
2302 if (ns_info
->protect_control_groups
)
2303 *(m
++) = (MountEntry
) {
2304 .path_const
= "/sys/fs/cgroup",
2308 r
= append_protect_home(&m
, ns_info
->protect_home
, ns_info
->ignore_protect_paths
);
2312 r
= append_protect_system(&m
, ns_info
->protect_system
, false);
2316 if (namespace_info_mount_apivfs(ns_info
)) {
2317 r
= append_static_mounts(&m
,
2319 ELEMENTSOF(apivfs_table
),
2320 ns_info
->ignore_protect_paths
);
2325 /* Note, if proc is mounted with subset=pid then neither of the
2326 * two paths will exist, i.e. they are implicitly protected by
2327 * the mount option. */
2328 if (ns_info
->protect_hostname
) {
2329 *(m
++) = (MountEntry
) {
2330 .path_const
= "/proc/sys/kernel/hostname",
2332 .ignore
= ignore_protect_proc
,
2334 *(m
++) = (MountEntry
) {
2335 .path_const
= "/proc/sys/kernel/domainname",
2337 .ignore
= ignore_protect_proc
,
2341 if (ns_info
->private_network
)
2342 *(m
++) = (MountEntry
) {
2343 .path_const
= "/sys",
2344 .mode
= PRIVATE_SYSFS
,
2347 if (ns_info
->private_ipc
)
2348 *(m
++) = (MountEntry
) {
2349 .path_const
= "/dev/mqueue",
2351 .flags
= MS_NOSUID
| MS_NODEV
| MS_NOEXEC
| MS_RELATIME
,
2355 /* If our service has a credentials store configured, then bind that one in, but hide
2356 * everything else. */
2358 *(m
++) = (MountEntry
) {
2359 .path_const
= "/run/credentials",
2362 .options_const
= "mode=0755" TMPFS_LIMITS_EMPTY_OR_ALMOST
,
2363 .flags
= MS_NODEV
|MS_STRICTATIME
|MS_NOSUID
|MS_NOEXEC
,
2366 *(m
++) = (MountEntry
) {
2367 .path_const
= creds_path
,
2370 .source_const
= creds_path
,
2374 /* If our service has no credentials store configured, then make the whole
2375 * credentials tree inaccessible wholesale. */
2377 *(m
++) = (MountEntry
) {
2378 .path_const
= "/run/credentials",
2379 .mode
= INACCESSIBLE
,
2384 if (log_namespace
) {
2385 _cleanup_free_
char *q
= NULL
;
2387 q
= strjoin("/run/systemd/journal.", log_namespace
);
2393 *(m
++) = (MountEntry
) {
2394 .path_const
= "/run/systemd/journal",
2395 .mode
= BIND_MOUNT_RECURSIVE
,
2397 .source_malloc
= TAKE_PTR(q
),
2401 /* Will be used to add bind mounts at runtime */
2402 if (setup_propagate
)
2403 *(m
++) = (MountEntry
) {
2404 .source_const
= propagate_dir
,
2405 .path_const
= incoming_dir
,
2411 *(m
++) = (MountEntry
) {
2412 .path_const
= notify_socket
,
2413 .source_const
= notify_socket
,
2418 if (host_os_release_stage
)
2419 *(m
++) = (MountEntry
) {
2420 .path_const
= "/run/host/.os-release-stage/",
2421 .source_const
= host_os_release_stage
,
2424 .ignore
= true, /* Live copy, don't hard-fail if it goes missing */
2427 assert(mounts
+ n_mounts
== m
);
2429 /* Prepend the root directory where that's necessary */
2430 r
= prefix_where_needed(mounts
, n_mounts
, root
);
2434 drop_unused_mounts(root
, mounts
, &n_mounts
);
2437 /* All above is just preparation, figuring out what to do. Let's now actually start doing something. */
2439 if (unshare(CLONE_NEWNS
) < 0) {
2440 r
= log_debug_errno(errno
, "Failed to unshare the mount namespace: %m");
2441 if (ERRNO_IS_PRIVILEGE(r
) ||
2442 ERRNO_IS_NOT_SUPPORTED(r
))
2443 /* If the kernel doesn't support namespaces, or when there's a MAC or seccomp filter
2444 * in place that doesn't allow us to create namespaces (or a missing cap), then
2445 * propagate a recognizable error back, which the caller can use to detect this case
2446 * (and only this) and optionally continue without namespacing applied. */
2452 /* Create the source directory to allow runtime propagation of mounts */
2453 if (setup_propagate
)
2454 (void) mkdir_p(propagate_dir
, 0600);
2456 if (n_extension_images
> 0 || !strv_isempty(extension_directories
))
2457 /* ExtensionImages/Directories mountpoint directories will be created while parsing the
2458 * mounts to create, so have the parent ready */
2459 (void) mkdir_p(extension_dir
, 0600);
2461 /* Remount / as SLAVE so that nothing now mounted in the namespace
2462 * shows up in the parent */
2463 if (mount(NULL
, "/", NULL
, MS_SLAVE
|MS_REC
, NULL
) < 0) {
2464 r
= log_debug_errno(errno
, "Failed to remount '/' as SLAVE: %m");
2469 /* A root image is specified, mount it to the right place */
2470 r
= dissected_image_mount(dissected_image
, root
, UID_INVALID
, UID_INVALID
, dissect_image_flags
);
2472 log_debug_errno(r
, "Failed to mount root image: %m");
2476 /* Now release the block device lock, so that udevd is free to call BLKRRPART on the device
2478 r
= loop_device_flock(loop_device
, LOCK_UN
);
2480 log_debug_errno(r
, "Failed to release lock on loopback block device: %m");
2484 r
= dissected_image_relinquish(dissected_image
);
2486 log_debug_errno(r
, "Failed to relinquish dissected image: %m");
2490 } else if (root_directory
) {
2492 /* A root directory is specified. Turn its directory into bind mount, if it isn't one yet. */
2493 r
= path_is_mount_point(root
, NULL
, AT_SYMLINK_FOLLOW
);
2495 log_debug_errno(r
, "Failed to detect that %s is a mount point or not: %m", root
);
2499 r
= mount_nofollow_verbose(LOG_DEBUG
, root
, root
, NULL
, MS_BIND
|MS_REC
, NULL
);
2505 /* Let's mount the main root directory to the root directory to use */
2506 r
= mount_nofollow_verbose(LOG_DEBUG
, "/", root
, NULL
, MS_BIND
|MS_REC
, NULL
);
2511 /* Try to set up the new root directory before mounting anything else there. */
2512 if (root_image
|| root_directory
)
2513 (void) base_filesystem_create(root
, UID_INVALID
, GID_INVALID
);
2515 /* Now make the magic happen */
2516 r
= apply_mounts(root
, mount_image_policy
, extension_image_policy
, ns_info
, mounts
, &n_mounts
, symlinks
, error_path
);
2520 /* MS_MOVE does not work on MS_SHARED so the remount MS_SHARED will be done later */
2521 r
= mount_switch_root(root
, /* mount_propagation_flag = */ 0);
2522 if (r
== -EINVAL
&& root_directory
) {
2523 /* If we are using root_directory and we don't have privileges (ie: user manager in a user
2524 * namespace) and the root_directory is already a mount point in the parent namespace,
2525 * MS_MOVE will fail as we don't have permission to change it (with EINVAL rather than
2526 * EPERM). Attempt to bind-mount it over itself (like we do above if it's not already a
2527 * mount point) and try again. */
2528 r
= mount_nofollow_verbose(LOG_DEBUG
, root
, root
, NULL
, MS_BIND
|MS_REC
, NULL
);
2531 r
= mount_switch_root(root
, /* mount_propagation_flag = */ 0);
2534 log_debug_errno(r
, "Failed to mount root with MS_MOVE: %m");
2538 /* Remount / as the desired mode. Note that this will not reestablish propagation from our side to
2539 * the host, since what's disconnected is disconnected. */
2540 if (mount(NULL
, "/", NULL
, mount_propagation_flag
| MS_REC
, NULL
) < 0) {
2541 r
= log_debug_errno(errno
, "Failed to remount '/' with desired mount flags: %m");
2545 /* bind_mount_in_namespace() will MS_MOVE into that directory, and that's only
2546 * supported for non-shared mounts. This needs to happen after remounting / or it will fail. */
2547 if (setup_propagate
) {
2548 r
= mount(NULL
, incoming_dir
, NULL
, MS_SLAVE
, NULL
);
2550 log_error_errno(r
, "Failed to remount %s with MS_SLAVE: %m", incoming_dir
);
2559 for (m
= mounts
; m
< mounts
+ n_mounts
; m
++)
2560 mount_entry_done(m
);
2567 void bind_mount_free_many(BindMount
*b
, size_t n
) {
2568 assert(b
|| n
== 0);
2570 for (size_t i
= 0; i
< n
; i
++) {
2572 free(b
[i
].destination
);
2578 int bind_mount_add(BindMount
**b
, size_t *n
, const BindMount
*item
) {
2579 _cleanup_free_
char *s
= NULL
, *d
= NULL
;
2586 s
= strdup(item
->source
);
2590 d
= strdup(item
->destination
);
2594 c
= reallocarray(*b
, *n
+ 1, sizeof(BindMount
));
2600 c
[(*n
) ++] = (BindMount
) {
2601 .source
= TAKE_PTR(s
),
2602 .destination
= TAKE_PTR(d
),
2603 .read_only
= item
->read_only
,
2604 .nosuid
= item
->nosuid
,
2605 .recursive
= item
->recursive
,
2606 .ignore_enoent
= item
->ignore_enoent
,
2612 MountImage
* mount_image_free_many(MountImage
*m
, size_t *n
) {
2614 assert(m
|| *n
== 0);
2616 for (size_t i
= 0; i
< *n
; i
++) {
2618 free(m
[i
].destination
);
2619 mount_options_free_all(m
[i
].mount_options
);
2627 int mount_image_add(MountImage
**m
, size_t *n
, const MountImage
*item
) {
2628 _cleanup_free_
char *s
= NULL
, *d
= NULL
;
2629 _cleanup_(mount_options_free_allp
) MountOptions
*options
= NULL
;
2636 s
= strdup(item
->source
);
2640 if (item
->destination
) {
2641 d
= strdup(item
->destination
);
2646 LIST_FOREACH(mount_options
, i
, item
->mount_options
) {
2647 _cleanup_(mount_options_free_allp
) MountOptions
*o
= NULL
;
2649 o
= new(MountOptions
, 1);
2653 *o
= (MountOptions
) {
2654 .partition_designator
= i
->partition_designator
,
2655 .options
= strdup(i
->options
),
2660 LIST_APPEND(mount_options
, options
, TAKE_PTR(o
));
2663 c
= reallocarray(*m
, *n
+ 1, sizeof(MountImage
));
2669 c
[(*n
) ++] = (MountImage
) {
2670 .source
= TAKE_PTR(s
),
2671 .destination
= TAKE_PTR(d
),
2672 .mount_options
= TAKE_PTR(options
),
2673 .ignore_enoent
= item
->ignore_enoent
,
2680 void temporary_filesystem_free_many(TemporaryFileSystem
*t
, size_t n
) {
2681 assert(t
|| n
== 0);
2683 for (size_t i
= 0; i
< n
; i
++) {
2691 int temporary_filesystem_add(
2692 TemporaryFileSystem
**t
,
2695 const char *options
) {
2697 _cleanup_free_
char *p
= NULL
, *o
= NULL
;
2698 TemporaryFileSystem
*c
;
2708 if (!isempty(options
)) {
2709 o
= strdup(options
);
2714 c
= reallocarray(*t
, *n
+ 1, sizeof(TemporaryFileSystem
));
2720 c
[(*n
) ++] = (TemporaryFileSystem
) {
2721 .path
= TAKE_PTR(p
),
2722 .options
= TAKE_PTR(o
),
2728 static int make_tmp_prefix(const char *prefix
) {
2729 _cleanup_free_
char *t
= NULL
;
2730 _cleanup_close_
int fd
= -EBADF
;
2733 /* Don't do anything unless we know the dir is actually missing */
2734 r
= access(prefix
, F_OK
);
2737 if (errno
!= ENOENT
)
2741 r
= mkdir_parents(prefix
, 0755);
2745 r
= tempfn_random(prefix
, NULL
, &t
);
2749 /* umask will corrupt this access mode, but that doesn't matter, we need to call chmod() anyway for
2750 * the suid bit, below. */
2751 fd
= open_mkdir_at(AT_FDCWD
, t
, O_EXCL
|O_CLOEXEC
, 0777);
2755 r
= RET_NERRNO(fchmod(fd
, 01777));
2761 r
= RET_NERRNO(rename(t
, prefix
));
2764 return r
== -EEXIST
? 0 : r
; /* it's fine if someone else created the dir by now */
2771 static int setup_one_tmp_dir(const char *id
, const char *prefix
, char **path
, char **tmp_path
) {
2772 _cleanup_free_
char *x
= NULL
;
2773 _cleanup_free_
char *y
= NULL
;
2782 /* We include the boot id in the directory so that after a
2783 * reboot we can easily identify obsolete directories. */
2785 r
= sd_id128_get_boot(&boot_id
);
2789 x
= strjoin(prefix
, "/systemd-private-", SD_ID128_TO_STRING(boot_id
), "-", id
, "-XXXXXX");
2793 r
= make_tmp_prefix(prefix
);
2799 if (errno
== EROFS
|| ERRNO_IS_DISK_SPACE(errno
))
2806 y
= strjoin(x
, "/tmp");
2811 if (mkdir(y
, 0777 | S_ISVTX
) < 0)
2814 r
= label_fix_full(AT_FDCWD
, y
, prefix
, 0);
2819 *tmp_path
= TAKE_PTR(y
);
2821 /* Trouble: we failed to create the directory. Instead of failing, let's simulate /tmp being
2822 * read-only. This way the service will get the EROFS result as if it was writing to the real
2825 r
= mkdir_p(RUN_SYSTEMD_EMPTY
, 0500);
2829 r
= free_and_strdup(&x
, RUN_SYSTEMD_EMPTY
);
2834 *path
= TAKE_PTR(x
);
2838 int setup_tmp_dirs(const char *id
, char **tmp_dir
, char **var_tmp_dir
) {
2839 _cleanup_(namespace_cleanup_tmpdirp
) char *a
= NULL
;
2840 _cleanup_(rmdir_and_freep
) char *a_tmp
= NULL
;
2846 assert(var_tmp_dir
);
2848 r
= setup_one_tmp_dir(id
, "/tmp", &a
, &a_tmp
);
2852 r
= setup_one_tmp_dir(id
, "/var/tmp", &b
, NULL
);
2856 a_tmp
= mfree(a_tmp
); /* avoid rmdir */
2857 *tmp_dir
= TAKE_PTR(a
);
2858 *var_tmp_dir
= TAKE_PTR(b
);
2863 int setup_shareable_ns(int ns_storage_socket
[static 2], unsigned long nsflag
) {
2864 _cleanup_close_
int ns
= -EBADF
;
2866 const char *ns_name
, *ns_path
;
2868 assert(ns_storage_socket
);
2869 assert(ns_storage_socket
[0] >= 0);
2870 assert(ns_storage_socket
[1] >= 0);
2872 ns_name
= namespace_single_flag_to_string(nsflag
);
2875 /* We use the passed socketpair as a storage buffer for our
2876 * namespace reference fd. Whatever process runs this first
2877 * shall create a new namespace, all others should just join
2878 * it. To serialize that we use a file lock on the socket
2881 * It's a bit crazy, but hey, works great! */
2883 r
= posix_lock(ns_storage_socket
[0], LOCK_EX
);
2887 CLEANUP_POSIX_UNLOCK(ns_storage_socket
[0]);
2889 ns
= receive_one_fd(ns_storage_socket
[0], MSG_PEEK
|MSG_DONTWAIT
);
2891 /* Yay, found something, so let's join the namespace */
2892 r
= RET_NERRNO(setns(ns
, nsflag
));
2902 /* Nothing stored yet, so let's create a new namespace. */
2904 if (unshare(nsflag
) < 0)
2907 (void) loopback_setup();
2909 ns_path
= strjoina("/proc/self/ns/", ns_name
);
2910 ns
= open(ns_path
, O_RDONLY
|O_CLOEXEC
|O_NOCTTY
);
2914 r
= send_one_fd(ns_storage_socket
[1], ns
, MSG_DONTWAIT
);
2921 int open_shareable_ns_path(int ns_storage_socket
[static 2], const char *path
, unsigned long nsflag
) {
2922 _cleanup_close_
int ns
= -EBADF
;
2925 assert(ns_storage_socket
);
2926 assert(ns_storage_socket
[0] >= 0);
2927 assert(ns_storage_socket
[1] >= 0);
2930 /* If the storage socket doesn't contain a ns fd yet, open one via the file system and store it in
2931 * it. This is supposed to be called ahead of time, i.e. before setup_shareable_ns() which will
2932 * allocate a new anonymous ns if needed. */
2934 r
= posix_lock(ns_storage_socket
[0], LOCK_EX
);
2938 CLEANUP_POSIX_UNLOCK(ns_storage_socket
[0]);
2940 ns
= receive_one_fd(ns_storage_socket
[0], MSG_PEEK
|MSG_DONTWAIT
);
2946 /* Nothing stored yet. Open the file from the file system. */
2948 ns
= open(path
, O_RDONLY
|O_NOCTTY
|O_CLOEXEC
);
2952 r
= fd_is_ns(ns
, nsflag
);
2955 if (r
< 0 && r
!= -EUCLEAN
) /* EUCLEAN: we don't know */
2958 r
= send_one_fd(ns_storage_socket
[1], ns
, MSG_DONTWAIT
);
2965 bool ns_type_supported(NamespaceType type
) {
2966 const char *t
, *ns_proc
;
2968 t
= namespace_type_to_string(type
);
2969 if (!t
) /* Don't know how to translate this? Then it's not supported */
2972 ns_proc
= strjoina("/proc/self/ns/", t
);
2973 return access(ns_proc
, F_OK
) == 0;
2976 static const char *const protect_home_table
[_PROTECT_HOME_MAX
] = {
2977 [PROTECT_HOME_NO
] = "no",
2978 [PROTECT_HOME_YES
] = "yes",
2979 [PROTECT_HOME_READ_ONLY
] = "read-only",
2980 [PROTECT_HOME_TMPFS
] = "tmpfs",
2983 DEFINE_STRING_TABLE_LOOKUP_WITH_BOOLEAN(protect_home
, ProtectHome
, PROTECT_HOME_YES
);
2985 static const char *const protect_system_table
[_PROTECT_SYSTEM_MAX
] = {
2986 [PROTECT_SYSTEM_NO
] = "no",
2987 [PROTECT_SYSTEM_YES
] = "yes",
2988 [PROTECT_SYSTEM_FULL
] = "full",
2989 [PROTECT_SYSTEM_STRICT
] = "strict",
2992 DEFINE_STRING_TABLE_LOOKUP_WITH_BOOLEAN(protect_system
, ProtectSystem
, PROTECT_SYSTEM_YES
);
2994 static const char* const namespace_type_table
[] = {
2995 [NAMESPACE_MOUNT
] = "mnt",
2996 [NAMESPACE_CGROUP
] = "cgroup",
2997 [NAMESPACE_UTS
] = "uts",
2998 [NAMESPACE_IPC
] = "ipc",
2999 [NAMESPACE_USER
] = "user",
3000 [NAMESPACE_PID
] = "pid",
3001 [NAMESPACE_NET
] = "net",
3002 [NAMESPACE_TIME
] = "time",
3005 DEFINE_STRING_TABLE_LOOKUP(namespace_type
, NamespaceType
);
3007 static const char* const protect_proc_table
[_PROTECT_PROC_MAX
] = {
3008 [PROTECT_PROC_DEFAULT
] = "default",
3009 [PROTECT_PROC_NOACCESS
] = "noaccess",
3010 [PROTECT_PROC_INVISIBLE
] = "invisible",
3011 [PROTECT_PROC_PTRACEABLE
] = "ptraceable",
3014 DEFINE_STRING_TABLE_LOOKUP(protect_proc
, ProtectProc
);
3016 static const char* const proc_subset_table
[_PROC_SUBSET_MAX
] = {
3017 [PROC_SUBSET_ALL
] = "all",
3018 [PROC_SUBSET_PID
] = "pid",
3021 DEFINE_STRING_TABLE_LOOKUP(proc_subset
, ProcSubset
);