1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
8 #include "sd-messages.h"
10 #include "alloc-util.h"
11 #include "dbus-mount.h"
12 #include "dbus-unit.h"
14 #include "exit-status.h"
15 #include "format-util.h"
17 #include "fstab-util.h"
18 #include "initrd-util.h"
19 #include "libmount-util.h"
22 #include "mkdir-label.h"
23 #include "mount-setup.h"
25 #include "mountpoint-util.h"
26 #include "parse-util.h"
27 #include "path-util.h"
28 #include "process-util.h"
29 #include "serialize.h"
31 #include "stat-util.h"
32 #include "string-table.h"
33 #include "string-util.h"
35 #include "unit-name.h"
38 #define RETRY_UMOUNT_MAX 32
40 static const UnitActiveState state_translation_table
[_MOUNT_STATE_MAX
] = {
41 [MOUNT_DEAD
] = UNIT_INACTIVE
,
42 [MOUNT_MOUNTING
] = UNIT_ACTIVATING
,
43 [MOUNT_MOUNTING_DONE
] = UNIT_ACTIVATING
,
44 [MOUNT_MOUNTED
] = UNIT_ACTIVE
,
45 [MOUNT_REMOUNTING
] = UNIT_RELOADING
,
46 [MOUNT_UNMOUNTING
] = UNIT_DEACTIVATING
,
47 [MOUNT_REMOUNTING_SIGTERM
] = UNIT_RELOADING
,
48 [MOUNT_REMOUNTING_SIGKILL
] = UNIT_RELOADING
,
49 [MOUNT_UNMOUNTING_SIGTERM
] = UNIT_DEACTIVATING
,
50 [MOUNT_UNMOUNTING_SIGKILL
] = UNIT_DEACTIVATING
,
51 [MOUNT_FAILED
] = UNIT_FAILED
,
52 [MOUNT_CLEANING
] = UNIT_MAINTENANCE
,
55 static int mount_dispatch_timer(sd_event_source
*source
, usec_t usec
, void *userdata
);
56 static int mount_dispatch_io(sd_event_source
*source
, int fd
, uint32_t revents
, void *userdata
);
57 static void mount_enter_dead(Mount
*m
, MountResult f
);
58 static void mount_enter_mounted(Mount
*m
, MountResult f
);
59 static void mount_cycle_clear(Mount
*m
);
60 static int mount_process_proc_self_mountinfo(Manager
*m
);
62 static bool MOUNT_STATE_WITH_PROCESS(MountState state
) {
67 MOUNT_REMOUNTING_SIGTERM
,
68 MOUNT_REMOUNTING_SIGKILL
,
70 MOUNT_UNMOUNTING_SIGTERM
,
71 MOUNT_UNMOUNTING_SIGKILL
,
75 static MountParameters
* get_mount_parameters_fragment(Mount
*m
) {
79 return &m
->parameters_fragment
;
84 static MountParameters
* get_mount_parameters(Mount
*m
) {
87 if (m
->from_proc_self_mountinfo
)
88 return &m
->parameters_proc_self_mountinfo
;
90 return get_mount_parameters_fragment(m
);
93 static bool mount_is_network(const MountParameters
*p
) {
96 if (fstab_test_option(p
->options
, "_netdev\0"))
99 if (p
->fstype
&& fstype_is_network(p
->fstype
))
105 static bool mount_is_nofail(const Mount
*m
) {
108 if (!m
->from_fragment
)
111 return fstab_test_yes_no_option(m
->parameters_fragment
.options
, "nofail\0" "fail\0");
114 static bool mount_is_loop(const MountParameters
*p
) {
117 if (fstab_test_option(p
->options
, "loop\0"))
123 static bool mount_is_bind(const MountParameters
*p
) {
125 return fstab_is_bind(p
->options
, p
->fstype
);
128 static bool mount_is_bound_to_device(Mount
*m
) {
129 const MountParameters
*p
;
133 /* Determines whether to place a Requires= or BindsTo= dependency on the backing device unit. We do
134 * this by checking for the x-systemd.device-bound mount option. Iff it is set we use BindsTo=,
135 * otherwise Requires=. But note that we might combine the latter with StopPropagatedFrom=, see
138 p
= get_mount_parameters(m
);
142 return fstab_test_option(p
->options
, "x-systemd.device-bound\0");
145 static bool mount_propagate_stop(Mount
*m
) {
148 if (mount_is_bound_to_device(m
)) /* If we are using BindsTo= the stop propagation is implicit, no need to bother */
151 return m
->from_fragment
; /* let's propagate stop whenever this is an explicitly configured unit,
152 * otherwise let's not bother. */
155 static bool mount_needs_quota(const MountParameters
*p
) {
158 if (p
->fstype
&& !fstype_needs_quota(p
->fstype
))
161 if (mount_is_bind(p
))
164 return fstab_test_option(p
->options
,
165 "usrquota\0" "grpquota\0" "quota\0" "usrjquota\0" "grpjquota\0");
168 static void mount_init(Unit
*u
) {
173 assert(u
->load_state
== UNIT_STUB
);
175 m
->timeout_usec
= u
->manager
->default_timeout_start_usec
;
177 m
->exec_context
.std_output
= u
->manager
->default_std_output
;
178 m
->exec_context
.std_error
= u
->manager
->default_std_error
;
180 m
->directory_mode
= 0755;
182 /* We need to make sure that /usr/bin/mount is always called
183 * in the same process group as us, so that the autofs kernel
184 * side doesn't send us another mount request while we are
185 * already trying to comply its last one. */
186 m
->exec_context
.same_pgrp
= true;
188 m
->control_command_id
= _MOUNT_EXEC_COMMAND_INVALID
;
190 u
->ignore_on_isolate
= true;
193 static int mount_arm_timer(Mount
*m
, usec_t usec
) {
198 if (usec
== USEC_INFINITY
)
199 return sd_event_source_set_enabled(m
->timer_event_source
, SD_EVENT_OFF
);
201 if (m
->timer_event_source
) {
202 r
= sd_event_source_set_time(m
->timer_event_source
, usec
);
206 return sd_event_source_set_enabled(m
->timer_event_source
, SD_EVENT_ONESHOT
);
209 r
= sd_event_add_time(
210 UNIT(m
)->manager
->event
,
211 &m
->timer_event_source
,
214 mount_dispatch_timer
, m
);
218 (void) sd_event_source_set_description(m
->timer_event_source
, "mount-timer");
223 static void mount_unwatch_control_pid(Mount
*m
) {
226 if (m
->control_pid
<= 0)
229 unit_unwatch_pid(UNIT(m
), TAKE_PID(m
->control_pid
));
232 static void mount_parameters_done(MountParameters
*p
) {
235 p
->what
= mfree(p
->what
);
236 p
->options
= mfree(p
->options
);
237 p
->fstype
= mfree(p
->fstype
);
240 static void mount_done(Unit
*u
) {
245 m
->where
= mfree(m
->where
);
247 mount_parameters_done(&m
->parameters_proc_self_mountinfo
);
248 mount_parameters_done(&m
->parameters_fragment
);
250 m
->exec_runtime
= exec_runtime_free(m
->exec_runtime
);
251 exec_command_done_array(m
->exec_command
, _MOUNT_EXEC_COMMAND_MAX
);
252 m
->control_command
= NULL
;
254 mount_unwatch_control_pid(m
);
256 m
->timer_event_source
= sd_event_source_disable_unref(m
->timer_event_source
);
259 static int update_parameters_proc_self_mountinfo(
263 const char *fstype
) {
268 p
= &m
->parameters_proc_self_mountinfo
;
270 r
= free_and_strdup(&p
->what
, what
);
274 q
= free_and_strdup(&p
->options
, options
);
278 w
= free_and_strdup(&p
->fstype
, fstype
);
282 return r
> 0 || q
> 0 || w
> 0;
285 static int mount_add_mount_dependencies(Mount
*m
) {
293 if (!path_equal(m
->where
, "/")) {
294 _cleanup_free_
char *parent
= NULL
;
296 /* Adds in links to other mount points that might lie further up in the hierarchy */
298 r
= path_extract_directory(m
->where
, &parent
);
302 r
= unit_require_mounts_for(UNIT(m
), parent
, UNIT_DEPENDENCY_IMPLICIT
);
307 /* Adds in dependencies to other mount points that might be needed for the source path (if this is a bind mount
308 * or a loop mount) to be available. */
309 pm
= get_mount_parameters_fragment(m
);
310 if (pm
&& pm
->what
&&
311 path_is_absolute(pm
->what
) &&
312 (mount_is_bind(pm
) || mount_is_loop(pm
) || !mount_is_network(pm
))) {
314 r
= unit_require_mounts_for(UNIT(m
), pm
->what
, UNIT_DEPENDENCY_FILE
);
319 /* Adds in dependencies to other units that use this path or paths further down in the hierarchy */
320 s
= manager_get_units_requiring_mounts_for(UNIT(m
)->manager
, m
->where
);
321 SET_FOREACH(other
, s
) {
323 if (other
->load_state
!= UNIT_LOADED
)
326 if (other
== UNIT(m
))
329 r
= unit_add_dependency(other
, UNIT_AFTER
, UNIT(m
), true, UNIT_DEPENDENCY_PATH
);
333 if (UNIT(m
)->fragment_path
) {
334 /* If we have fragment configuration, then make this dependency required */
335 r
= unit_add_dependency(other
, UNIT_REQUIRES
, UNIT(m
), true, UNIT_DEPENDENCY_PATH
);
344 static int mount_add_device_dependencies(Mount
*m
) {
345 UnitDependencyMask mask
;
352 log_unit_trace(UNIT(m
), "Processing implicit device dependencies");
354 p
= get_mount_parameters(m
);
356 log_unit_trace(UNIT(m
), "Missing mount parameters, skipping implicit device dependencies");
361 log_unit_trace(UNIT(m
), "Missing mount source, skipping implicit device dependencies");
365 if (mount_is_bind(p
)) {
366 log_unit_trace(UNIT(m
), "Mount unit is a bind mount, skipping implicit device dependencies");
370 if (!is_device_path(p
->what
)) {
371 log_unit_trace(UNIT(m
), "Mount source is not a device path, skipping implicit device dependencies");
375 /* /dev/root is a really weird thing, it's not a real device, but just a path the kernel exports for
376 * the root file system specified on the kernel command line. Ignore it here. */
377 if (PATH_IN_SET(p
->what
, "/dev/root", "/dev/nfs")) {
378 log_unit_trace(UNIT(m
), "Mount source is in /dev/root or /dev/nfs, skipping implicit device dependencies");
382 if (path_equal(m
->where
, "/")) {
383 log_unit_trace(UNIT(m
), "Mount destination is '/', skipping implicit device dependencies");
387 /* Mount units from /proc/self/mountinfo are not bound to devices by default since they're subject to
388 * races when mounts are established by other tools with different backing devices than what we
389 * maintain. The user can still force this to be a BindsTo= dependency with an appropriate option (or
390 * udev property) so the mount units are automatically stopped when the device disappears
392 dep
= mount_is_bound_to_device(m
) ? UNIT_BINDS_TO
: UNIT_REQUIRES
;
394 /* We always use 'what' from /proc/self/mountinfo if mounted */
395 mask
= m
->from_proc_self_mountinfo
? UNIT_DEPENDENCY_MOUNTINFO
: UNIT_DEPENDENCY_MOUNT_FILE
;
397 r
= unit_add_node_dependency(UNIT(m
), p
->what
, dep
, mask
);
401 log_unit_trace(UNIT(m
), "Added %s dependency on %s", unit_dependency_to_string(dep
), p
->what
);
403 if (mount_propagate_stop(m
)) {
404 r
= unit_add_node_dependency(UNIT(m
), p
->what
, UNIT_STOP_PROPAGATED_FROM
, mask
);
408 log_unit_trace(UNIT(m
), "Added %s dependency on %s",
409 unit_dependency_to_string(UNIT_STOP_PROPAGATED_FROM
), p
->what
);
412 r
= unit_add_blockdev_dependency(UNIT(m
), p
->what
, mask
);
414 log_unit_trace(UNIT(m
), "Added %s dependency on %s", unit_dependency_to_string(UNIT_AFTER
), p
->what
);
419 static int mount_add_quota_dependencies(Mount
*m
) {
425 if (!MANAGER_IS_SYSTEM(UNIT(m
)->manager
))
428 p
= get_mount_parameters_fragment(m
);
432 if (!mount_needs_quota(p
))
435 r
= unit_add_two_dependencies_by_name(UNIT(m
), UNIT_BEFORE
, UNIT_WANTS
, SPECIAL_QUOTACHECK_SERVICE
,
436 /* add_reference= */ true, UNIT_DEPENDENCY_FILE
);
440 r
= unit_add_two_dependencies_by_name(UNIT(m
), UNIT_BEFORE
, UNIT_WANTS
, SPECIAL_QUOTAON_SERVICE
,
441 /* add_reference= */true, UNIT_DEPENDENCY_FILE
);
448 static bool mount_is_extrinsic(Unit
*u
) {
453 /* Returns true for all units that are "magic" and should be excluded from the usual
454 * start-up and shutdown dependencies. We call them "extrinsic" here, as they are generally
455 * mounted outside of the systemd dependency logic. We shouldn't attempt to manage them
456 * ourselves but it's fine if the user operates on them with us. */
458 /* We only automatically manage mounts if we are in system mode */
459 if (MANAGER_IS_USER(u
->manager
))
462 p
= get_mount_parameters(m
);
463 if (p
&& fstab_is_extrinsic(m
->where
, p
->options
))
469 static bool mount_is_credentials(Mount
*m
) {
474 /* Returns true if this is a credentials mount. We don't want automatic dependencies on credential
475 * mounts, since they are managed by us for even the earliest services, and we never want anything to
476 * be ordered before them hence. */
478 e
= path_startswith(m
->where
, UNIT(m
)->manager
->prefix
[EXEC_DIRECTORY_RUNTIME
]);
482 return !isempty(path_startswith(e
, "credentials"));
485 static int mount_add_default_ordering_dependencies(Mount
*m
, MountParameters
*p
, UnitDependencyMask mask
) {
486 const char *after
, *before
, *e
;
491 e
= path_startswith(m
->where
, "/sysroot");
492 if (e
&& in_initrd()) {
493 /* All mounts under /sysroot need to happen later, at initrd-fs.target time. IOW,
494 * it's not technically part of the basic initrd filesystem itself, and so
495 * shouldn't inherit the default Before=local-fs.target dependency. However,
496 * these mounts still need to start after local-fs-pre.target, as a sync point
497 * for things like systemd-hibernate-resume.service that should start before
500 after
= SPECIAL_LOCAL_FS_PRE_TARGET
;
501 before
= isempty(e
) ? SPECIAL_INITRD_ROOT_FS_TARGET
: SPECIAL_INITRD_FS_TARGET
;
503 } else if (in_initrd() && path_startswith(m
->where
, "/sysusr/usr")) {
504 after
= SPECIAL_LOCAL_FS_PRE_TARGET
;
505 before
= SPECIAL_INITRD_USR_FS_TARGET
;
507 } else if (mount_is_credentials(m
))
508 after
= before
= NULL
;
510 else if (mount_is_network(p
)) {
511 after
= SPECIAL_REMOTE_FS_PRE_TARGET
;
512 before
= SPECIAL_REMOTE_FS_TARGET
;
515 after
= SPECIAL_LOCAL_FS_PRE_TARGET
;
516 before
= SPECIAL_LOCAL_FS_TARGET
;
519 if (before
&& !mount_is_nofail(m
)) {
520 r
= unit_add_dependency_by_name(UNIT(m
), UNIT_BEFORE
, before
, /* add_reference= */ true, mask
);
526 r
= unit_add_dependency_by_name(UNIT(m
), UNIT_AFTER
, after
, /* add_reference= */ true, mask
);
531 r
= unit_add_two_dependencies_by_name(UNIT(m
), UNIT_BEFORE
, UNIT_CONFLICTS
, SPECIAL_UMOUNT_TARGET
,
532 /* add_reference= */ true, mask
);
536 /* If this is a tmpfs mount then we have to unmount it before we try to deactivate swaps */
537 if (streq_ptr(p
->fstype
, "tmpfs") && !mount_is_credentials(m
)) {
538 r
= unit_add_dependency_by_name(UNIT(m
), UNIT_AFTER
, SPECIAL_SWAP_TARGET
,
539 /* add_reference= */ true, mask
);
547 static int mount_add_default_network_dependencies(Mount
*m
, MountParameters
*p
, UnitDependencyMask mask
) {
552 if (!mount_is_network(p
))
555 /* We order ourselves after network.target. This is primarily useful at shutdown: services that take
556 * down the network should order themselves before network.target, so that they are shut down only
557 * after this mount unit is stopped. */
559 r
= unit_add_dependency_by_name(UNIT(m
), UNIT_AFTER
, SPECIAL_NETWORK_TARGET
,
560 /* add_reference= */ true, mask
);
564 /* We pull in network-online.target, and order ourselves after it. This is useful at start-up to
565 * actively pull in tools that want to be started before we start mounting network file systems, and
566 * whose purpose it is to delay this until the network is "up". */
568 return unit_add_two_dependencies_by_name(UNIT(m
), UNIT_WANTS
, UNIT_AFTER
, SPECIAL_NETWORK_ONLINE_TARGET
,
569 /* add_reference= */ true, mask
);
572 static int mount_add_default_dependencies(Mount
*m
) {
573 UnitDependencyMask mask
;
579 if (!UNIT(m
)->default_dependencies
)
582 /* We do not add any default dependencies to /, /usr or /run/initramfs/, since they are
583 * guaranteed to stay mounted the whole time, since our system is on it. Also, don't
584 * bother with anything mounted below virtual file systems, it's also going to be virtual,
585 * and hence not worth the effort. */
586 if (mount_is_extrinsic(UNIT(m
)))
589 p
= get_mount_parameters(m
);
593 mask
= m
->from_proc_self_mountinfo
? UNIT_DEPENDENCY_MOUNTINFO
: UNIT_DEPENDENCY_MOUNT_FILE
;
595 r
= mount_add_default_ordering_dependencies(m
, p
, mask
);
599 r
= mount_add_default_network_dependencies(m
, p
, mask
);
606 static int mount_verify(Mount
*m
) {
607 _cleanup_free_
char *e
= NULL
;
612 assert(UNIT(m
)->load_state
== UNIT_LOADED
);
614 if (!m
->from_fragment
&& !m
->from_proc_self_mountinfo
&& !UNIT(m
)->perpetual
)
617 r
= unit_name_from_path(m
->where
, ".mount", &e
);
619 return log_unit_error_errno(UNIT(m
), r
, "Failed to generate unit name from mount path: %m");
621 if (!unit_has_name(UNIT(m
), e
))
622 return log_unit_error_errno(UNIT(m
), SYNTHETIC_ERRNO(ENOEXEC
), "Where= setting doesn't match unit name. Refusing.");
624 if (mount_point_is_api(m
->where
) || mount_point_ignore(m
->where
))
625 return log_unit_error_errno(UNIT(m
), SYNTHETIC_ERRNO(ENOEXEC
), "Cannot create mount unit for API file system %s. Refusing.", m
->where
);
627 p
= get_mount_parameters_fragment(m
);
628 if (p
&& !p
->what
&& !UNIT(m
)->perpetual
)
629 return log_unit_error_errno(UNIT(m
), SYNTHETIC_ERRNO(ENOEXEC
),
630 "What= setting is missing. Refusing.");
632 if (m
->exec_context
.pam_name
&& m
->kill_context
.kill_mode
!= KILL_CONTROL_GROUP
)
633 return log_unit_error_errno(UNIT(m
), SYNTHETIC_ERRNO(ENOEXEC
), "Unit has PAM enabled. Kill mode must be set to control-group'. Refusing.");
638 static int mount_add_non_exec_dependencies(Mount
*m
) {
643 /* We may be called due to this mount appearing in /proc/self/mountinfo, hence we clear all existing
644 * dependencies that were initialized from the unit file but whose final value really depends on the
645 * content of /proc/self/mountinfo. Some (such as m->where) might have become stale now. */
646 unit_remove_dependencies(UNIT(m
), UNIT_DEPENDENCY_MOUNTINFO
| UNIT_DEPENDENCY_MOUNT_FILE
);
651 /* Adds in all dependencies directly responsible for ordering the mount, as opposed to dependencies
652 * resulting from the ExecContext and such. */
654 r
= mount_add_device_dependencies(m
);
658 r
= mount_add_mount_dependencies(m
);
662 r
= mount_add_quota_dependencies(m
);
666 r
= mount_add_default_dependencies(m
);
673 static int mount_add_extras(Mount
*m
) {
679 /* Note: this call might be called after we already have been loaded once (and even when it has already been
680 * activated), in case data from /proc/self/mountinfo has changed. This means all code here needs to be ready
681 * to run with an already set up unit. */
683 if (u
->fragment_path
)
684 m
->from_fragment
= true;
687 r
= unit_name_to_path(u
->id
, &m
->where
);
688 if (r
== -ENAMETOOLONG
)
689 log_unit_error_errno(u
, r
, "Failed to derive mount point path from unit name, because unit name is hashed. "
690 "Set \"Where=\" in the unit file explicitly.");
695 path_simplify(m
->where
);
697 if (!u
->description
) {
698 r
= unit_set_description(u
, m
->where
);
703 r
= unit_patch_contexts(u
);
707 r
= unit_add_exec_dependencies(u
, &m
->exec_context
);
711 r
= unit_set_default_slice(u
);
715 r
= mount_add_non_exec_dependencies(m
);
722 static void mount_load_root_mount(Unit
*u
) {
725 if (!unit_has_name(u
, SPECIAL_ROOT_MOUNT
))
729 u
->default_dependencies
= false;
731 /* The stdio/kmsg bridge socket is on /, in order to avoid a dep loop, don't use kmsg logging for -.mount */
732 MOUNT(u
)->exec_context
.std_output
= EXEC_OUTPUT_NULL
;
733 MOUNT(u
)->exec_context
.std_input
= EXEC_INPUT_NULL
;
736 u
->description
= strdup("Root Mount");
739 static int mount_load(Unit
*u
) {
745 assert(u
->load_state
== UNIT_STUB
);
747 mount_load_root_mount(u
);
749 bool fragment_optional
= m
->from_proc_self_mountinfo
|| u
->perpetual
;
750 r
= unit_load_fragment_and_dropin(u
, !fragment_optional
);
752 /* Add in some extras. Note we do this in all cases (even if we failed to load the unit) when announced by the
753 * kernel, because we need some things to be set up no matter what when the kernel establishes a mount and thus
754 * we need to update the state in our unit to track it. After all, consider that we don't allow changing the
755 * 'slice' field for a unit once it is active. */
756 if (u
->load_state
== UNIT_LOADED
|| m
->from_proc_self_mountinfo
|| u
->perpetual
)
757 q
= mount_add_extras(m
);
763 if (u
->load_state
!= UNIT_LOADED
)
766 return mount_verify(m
);
769 static void mount_set_state(Mount
*m
, MountState state
) {
770 MountState old_state
;
773 if (m
->state
!= state
)
774 bus_unit_send_pending_change_signal(UNIT(m
), false);
776 old_state
= m
->state
;
779 if (!MOUNT_STATE_WITH_PROCESS(state
)) {
780 m
->timer_event_source
= sd_event_source_disable_unref(m
->timer_event_source
);
781 mount_unwatch_control_pid(m
);
782 m
->control_command
= NULL
;
783 m
->control_command_id
= _MOUNT_EXEC_COMMAND_INVALID
;
786 if (state
!= old_state
)
787 log_unit_debug(UNIT(m
), "Changed %s -> %s", mount_state_to_string(old_state
), mount_state_to_string(state
));
789 unit_notify(UNIT(m
), state_translation_table
[old_state
], state_translation_table
[state
], m
->reload_result
== MOUNT_SUCCESS
);
792 static int mount_coldplug(Unit
*u
) {
797 assert(m
->state
== MOUNT_DEAD
);
799 if (m
->deserialized_state
== m
->state
)
802 if (m
->control_pid
> 0 &&
803 pid_is_unwaited(m
->control_pid
) &&
804 MOUNT_STATE_WITH_PROCESS(m
->deserialized_state
)) {
806 r
= unit_watch_pid(UNIT(m
), m
->control_pid
, false);
810 r
= mount_arm_timer(m
, usec_add(u
->state_change_timestamp
.monotonic
, m
->timeout_usec
));
815 if (!IN_SET(m
->deserialized_state
, MOUNT_DEAD
, MOUNT_FAILED
))
816 (void) unit_setup_exec_runtime(u
);
818 mount_set_state(m
, m
->deserialized_state
);
822 static void mount_catchup(Unit
*u
) {
823 Mount
*m
= MOUNT(ASSERT_PTR(u
));
827 /* Adjust the deserialized state. See comments in mount_process_proc_self_mountinfo(). */
828 if (m
->from_proc_self_mountinfo
)
832 assert(m
->control_pid
== 0);
833 (void) unit_acquire_invocation_id(u
);
834 mount_cycle_clear(m
);
835 mount_enter_mounted(m
, MOUNT_SUCCESS
);
838 assert(m
->control_pid
> 0);
839 mount_set_state(m
, MOUNT_MOUNTING_DONE
);
846 case MOUNT_MOUNTING_DONE
:
847 assert(m
->control_pid
> 0);
848 mount_set_state(m
, MOUNT_MOUNTING
);
851 assert(m
->control_pid
== 0);
852 mount_enter_dead(m
, MOUNT_SUCCESS
);
859 static void mount_dump(Unit
*u
, FILE *f
, const char *prefix
) {
866 p
= get_mount_parameters(m
);
869 "%sMount State: %s\n"
871 "%sClean Result: %s\n"
874 "%sFile System Type: %s\n"
876 "%sFrom /proc/self/mountinfo: %s\n"
877 "%sFrom fragment: %s\n"
879 "%sDirectoryMode: %04o\n"
880 "%sSloppyOptions: %s\n"
881 "%sLazyUnmount: %s\n"
882 "%sForceUnmount: %s\n"
883 "%sReadWriteOnly: %s\n"
884 "%sTimeoutSec: %s\n",
885 prefix
, mount_state_to_string(m
->state
),
886 prefix
, mount_result_to_string(m
->result
),
887 prefix
, mount_result_to_string(m
->clean_result
),
889 prefix
, p
? strna(p
->what
) : "n/a",
890 prefix
, p
? strna(p
->fstype
) : "n/a",
891 prefix
, p
? strna(p
->options
) : "n/a",
892 prefix
, yes_no(m
->from_proc_self_mountinfo
),
893 prefix
, yes_no(m
->from_fragment
),
894 prefix
, yes_no(mount_is_extrinsic(u
)),
895 prefix
, m
->directory_mode
,
896 prefix
, yes_no(m
->sloppy_options
),
897 prefix
, yes_no(m
->lazy_unmount
),
898 prefix
, yes_no(m
->force_unmount
),
899 prefix
, yes_no(m
->read_write_only
),
900 prefix
, FORMAT_TIMESPAN(m
->timeout_usec
, USEC_PER_SEC
));
902 if (m
->control_pid
> 0)
904 "%sControl PID: "PID_FMT
"\n",
905 prefix
, m
->control_pid
);
907 exec_context_dump(&m
->exec_context
, f
, prefix
);
908 kill_context_dump(&m
->kill_context
, f
, prefix
);
909 cgroup_context_dump(UNIT(m
), f
, prefix
);
912 static int mount_spawn(Mount
*m
, ExecCommand
*c
, pid_t
*ret_pid
) {
914 _cleanup_(exec_params_clear
) ExecParameters exec_params
= {
915 .flags
= EXEC_APPLY_SANDBOXING
|EXEC_APPLY_CHROOT
|EXEC_APPLY_TTY_STDIN
,
928 r
= unit_prepare_exec(UNIT(m
));
932 r
= mount_arm_timer(m
, usec_add(now(CLOCK_MONOTONIC
), m
->timeout_usec
));
936 r
= unit_set_exec_params(UNIT(m
), &exec_params
);
940 r
= exec_spawn(UNIT(m
),
950 r
= unit_watch_pid(UNIT(m
), pid
, true);
958 static void mount_enter_dead(Mount
*m
, MountResult f
) {
961 if (m
->result
== MOUNT_SUCCESS
)
964 unit_log_result(UNIT(m
), m
->result
== MOUNT_SUCCESS
, mount_result_to_string(m
->result
));
965 unit_warn_leftover_processes(UNIT(m
), unit_log_leftover_process_stop
);
967 mount_set_state(m
, m
->result
!= MOUNT_SUCCESS
? MOUNT_FAILED
: MOUNT_DEAD
);
969 m
->exec_runtime
= exec_runtime_destroy(m
->exec_runtime
);
971 unit_destroy_runtime_data(UNIT(m
), &m
->exec_context
);
973 unit_unref_uid_gid(UNIT(m
), true);
975 /* Any dependencies based on /proc/self/mountinfo are now stale. Let's re-generate dependencies from
977 (void) mount_add_non_exec_dependencies(m
);
980 static void mount_enter_mounted(Mount
*m
, MountResult f
) {
983 if (m
->result
== MOUNT_SUCCESS
)
986 mount_set_state(m
, MOUNT_MOUNTED
);
989 static void mount_enter_dead_or_mounted(Mount
*m
, MountResult f
) {
992 /* Enter DEAD or MOUNTED state, depending on what the kernel currently says about the mount point. We use this
993 * whenever we executed an operation, so that our internal state reflects what the kernel says again, after all
994 * ultimately we just mirror the kernel's internal state on this. */
996 if (m
->from_proc_self_mountinfo
)
997 mount_enter_mounted(m
, f
);
999 mount_enter_dead(m
, f
);
1002 static int state_to_kill_operation(MountState state
) {
1005 case MOUNT_REMOUNTING_SIGTERM
:
1006 return KILL_RESTART
;
1008 case MOUNT_UNMOUNTING_SIGTERM
:
1009 return KILL_TERMINATE
;
1011 case MOUNT_REMOUNTING_SIGKILL
:
1012 case MOUNT_UNMOUNTING_SIGKILL
:
1016 return _KILL_OPERATION_INVALID
;
1020 static void mount_enter_signal(Mount
*m
, MountState state
, MountResult f
) {
1025 if (m
->result
== MOUNT_SUCCESS
)
1028 r
= unit_kill_context(
1031 state_to_kill_operation(state
),
1039 r
= mount_arm_timer(m
, usec_add(now(CLOCK_MONOTONIC
), m
->timeout_usec
));
1043 mount_set_state(m
, state
);
1044 } else if (state
== MOUNT_REMOUNTING_SIGTERM
&& m
->kill_context
.send_sigkill
)
1045 mount_enter_signal(m
, MOUNT_REMOUNTING_SIGKILL
, MOUNT_SUCCESS
);
1046 else if (IN_SET(state
, MOUNT_REMOUNTING_SIGTERM
, MOUNT_REMOUNTING_SIGKILL
))
1047 mount_enter_mounted(m
, MOUNT_SUCCESS
);
1048 else if (state
== MOUNT_UNMOUNTING_SIGTERM
&& m
->kill_context
.send_sigkill
)
1049 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGKILL
, MOUNT_SUCCESS
);
1051 mount_enter_dead_or_mounted(m
, MOUNT_SUCCESS
);
1056 log_unit_warning_errno(UNIT(m
), r
, "Failed to kill processes: %m");
1057 mount_enter_dead_or_mounted(m
, MOUNT_FAILURE_RESOURCES
);
1060 static void mount_enter_unmounting(Mount
*m
) {
1065 /* Start counting our attempts */
1066 if (!IN_SET(m
->state
,
1068 MOUNT_UNMOUNTING_SIGTERM
,
1069 MOUNT_UNMOUNTING_SIGKILL
))
1070 m
->n_retry_umount
= 0;
1072 m
->control_command_id
= MOUNT_EXEC_UNMOUNT
;
1073 m
->control_command
= m
->exec_command
+ MOUNT_EXEC_UNMOUNT
;
1075 r
= exec_command_set(m
->control_command
, UMOUNT_PATH
, m
->where
, "-c", NULL
);
1076 if (r
>= 0 && m
->lazy_unmount
)
1077 r
= exec_command_append(m
->control_command
, "-l", NULL
);
1078 if (r
>= 0 && m
->force_unmount
)
1079 r
= exec_command_append(m
->control_command
, "-f", NULL
);
1083 mount_unwatch_control_pid(m
);
1085 r
= mount_spawn(m
, m
->control_command
, &m
->control_pid
);
1089 mount_set_state(m
, MOUNT_UNMOUNTING
);
1094 log_unit_warning_errno(UNIT(m
), r
, "Failed to run 'umount' task: %m");
1095 mount_enter_dead_or_mounted(m
, MOUNT_FAILURE_RESOURCES
);
1098 static void mount_enter_mounting(Mount
*m
) {
1101 bool source_is_dir
= true;
1105 r
= unit_fail_if_noncanonical(UNIT(m
), m
->where
);
1109 p
= get_mount_parameters_fragment(m
);
1110 if (p
&& mount_is_bind(p
)) {
1111 r
= is_dir(p
->what
, /* follow = */ true);
1112 if (r
< 0 && r
!= -ENOENT
)
1113 log_unit_info_errno(UNIT(m
), r
, "Failed to determine type of bind mount source '%s', ignoring: %m", p
->what
);
1115 source_is_dir
= false;
1119 (void) mkdir_p_label(m
->where
, m
->directory_mode
);
1121 (void) touch_file(m
->where
, /* parents = */ true, USEC_INFINITY
, UID_INVALID
, GID_INVALID
, MODE_INVALID
);
1124 unit_warn_if_dir_nonempty(UNIT(m
), m
->where
);
1125 unit_warn_leftover_processes(UNIT(m
), unit_log_leftover_process_start
);
1127 m
->control_command_id
= MOUNT_EXEC_MOUNT
;
1128 m
->control_command
= m
->exec_command
+ MOUNT_EXEC_MOUNT
;
1130 /* Create the source directory for bind-mounts if needed */
1131 if (p
&& mount_is_bind(p
)) {
1132 r
= mkdir_p_label(p
->what
, m
->directory_mode
);
1133 /* mkdir_p_label() can return -EEXIST if the target path exists and is not a directory - which is
1134 * totally OK, in case the user wants us to overmount a non-directory inode. Also -EROFS can be
1135 * returned on read-only filesystem. Moreover, -EACCES (and also maybe -EPERM?) may be returned
1136 * when the path is on NFS. See issue #24120. All such errors will be logged in the debug level. */
1137 if (r
< 0 && r
!= -EEXIST
)
1138 log_unit_full_errno(UNIT(m
),
1139 (r
== -EROFS
|| ERRNO_IS_PRIVILEGE(r
)) ? LOG_DEBUG
: LOG_WARNING
,
1140 r
, "Failed to make bind mount source '%s', ignoring: %m", p
->what
);
1144 _cleanup_free_
char *opts
= NULL
;
1146 r
= fstab_filter_options(p
->options
, "nofail\0" "noauto\0" "auto\0", NULL
, NULL
, NULL
, &opts
);
1150 r
= exec_command_set(m
->control_command
, MOUNT_PATH
, p
->what
, m
->where
, NULL
);
1151 if (r
>= 0 && m
->sloppy_options
)
1152 r
= exec_command_append(m
->control_command
, "-s", NULL
);
1153 if (r
>= 0 && m
->read_write_only
)
1154 r
= exec_command_append(m
->control_command
, "-w", NULL
);
1155 if (r
>= 0 && p
->fstype
)
1156 r
= exec_command_append(m
->control_command
, "-t", p
->fstype
, NULL
);
1157 if (r
>= 0 && !isempty(opts
))
1158 r
= exec_command_append(m
->control_command
, "-o", opts
, NULL
);
1164 mount_unwatch_control_pid(m
);
1166 r
= mount_spawn(m
, m
->control_command
, &m
->control_pid
);
1170 mount_set_state(m
, MOUNT_MOUNTING
);
1175 log_unit_warning_errno(UNIT(m
), r
, "Failed to run 'mount' task: %m");
1176 mount_enter_dead_or_mounted(m
, MOUNT_FAILURE_RESOURCES
);
1179 static void mount_set_reload_result(Mount
*m
, MountResult result
) {
1182 /* Only store the first error we encounter */
1183 if (m
->reload_result
!= MOUNT_SUCCESS
)
1186 m
->reload_result
= result
;
1189 static void mount_enter_remounting(Mount
*m
) {
1195 /* Reset reload result when we are about to start a new remount operation */
1196 m
->reload_result
= MOUNT_SUCCESS
;
1198 m
->control_command_id
= MOUNT_EXEC_REMOUNT
;
1199 m
->control_command
= m
->exec_command
+ MOUNT_EXEC_REMOUNT
;
1201 p
= get_mount_parameters_fragment(m
);
1206 o
= strjoina("remount,", p
->options
);
1210 r
= exec_command_set(m
->control_command
, MOUNT_PATH
,
1213 if (r
>= 0 && m
->sloppy_options
)
1214 r
= exec_command_append(m
->control_command
, "-s", NULL
);
1215 if (r
>= 0 && m
->read_write_only
)
1216 r
= exec_command_append(m
->control_command
, "-w", NULL
);
1217 if (r
>= 0 && p
->fstype
)
1218 r
= exec_command_append(m
->control_command
, "-t", p
->fstype
, NULL
);
1224 mount_unwatch_control_pid(m
);
1226 r
= mount_spawn(m
, m
->control_command
, &m
->control_pid
);
1230 mount_set_state(m
, MOUNT_REMOUNTING
);
1235 log_unit_warning_errno(UNIT(m
), r
, "Failed to run 'remount' task: %m");
1236 mount_set_reload_result(m
, MOUNT_FAILURE_RESOURCES
);
1237 mount_enter_dead_or_mounted(m
, MOUNT_SUCCESS
);
1240 static void mount_cycle_clear(Mount
*m
) {
1243 /* Clear all state we shall forget for this new cycle */
1245 m
->result
= MOUNT_SUCCESS
;
1246 m
->reload_result
= MOUNT_SUCCESS
;
1247 exec_command_reset_status_array(m
->exec_command
, _MOUNT_EXEC_COMMAND_MAX
);
1248 UNIT(m
)->reset_accounting
= true;
1251 static int mount_start(Unit
*u
) {
1252 Mount
*m
= MOUNT(u
);
1257 /* We cannot fulfill this request right now, try again later
1259 if (IN_SET(m
->state
,
1261 MOUNT_UNMOUNTING_SIGTERM
,
1262 MOUNT_UNMOUNTING_SIGKILL
,
1266 /* Already on it! */
1267 if (IN_SET(m
->state
, MOUNT_MOUNTING
, MOUNT_MOUNTING_DONE
))
1270 assert(IN_SET(m
->state
, MOUNT_DEAD
, MOUNT_FAILED
));
1272 r
= unit_acquire_invocation_id(u
);
1276 mount_cycle_clear(m
);
1277 mount_enter_mounting(m
);
1282 static int mount_stop(Unit
*u
) {
1283 Mount
*m
= MOUNT(u
);
1289 case MOUNT_UNMOUNTING
:
1290 case MOUNT_UNMOUNTING_SIGKILL
:
1291 case MOUNT_UNMOUNTING_SIGTERM
:
1295 case MOUNT_MOUNTING
:
1296 case MOUNT_MOUNTING_DONE
:
1297 case MOUNT_REMOUNTING
:
1298 /* If we are still waiting for /bin/mount, we go directly into kill mode. */
1299 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGTERM
, MOUNT_SUCCESS
);
1302 case MOUNT_REMOUNTING_SIGTERM
:
1303 /* If we are already waiting for a hung remount, convert this to the matching unmounting state */
1304 mount_set_state(m
, MOUNT_UNMOUNTING_SIGTERM
);
1307 case MOUNT_REMOUNTING_SIGKILL
:
1309 mount_set_state(m
, MOUNT_UNMOUNTING_SIGKILL
);
1313 mount_enter_unmounting(m
);
1316 case MOUNT_CLEANING
:
1317 /* If we are currently cleaning, then abort it, brutally. */
1318 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGKILL
, MOUNT_SUCCESS
);
1322 assert_not_reached();
1326 static int mount_reload(Unit
*u
) {
1327 Mount
*m
= MOUNT(u
);
1330 assert(m
->state
== MOUNT_MOUNTED
);
1332 mount_enter_remounting(m
);
1337 static int mount_serialize(Unit
*u
, FILE *f
, FDSet
*fds
) {
1338 Mount
*m
= MOUNT(u
);
1344 (void) serialize_item(f
, "state", mount_state_to_string(m
->state
));
1345 (void) serialize_item(f
, "result", mount_result_to_string(m
->result
));
1346 (void) serialize_item(f
, "reload-result", mount_result_to_string(m
->reload_result
));
1347 (void) serialize_item_format(f
, "n-retry-umount", "%u", m
->n_retry_umount
);
1349 if (m
->control_pid
> 0)
1350 (void) serialize_item_format(f
, "control-pid", PID_FMT
, m
->control_pid
);
1352 if (m
->control_command_id
>= 0)
1353 (void) serialize_item(f
, "control-command", mount_exec_command_to_string(m
->control_command_id
));
1358 static int mount_deserialize_item(Unit
*u
, const char *key
, const char *value
, FDSet
*fds
) {
1359 Mount
*m
= MOUNT(u
);
1368 if (streq(key
, "state")) {
1371 state
= mount_state_from_string(value
);
1373 log_unit_debug_errno(u
, state
, "Failed to parse state value: %s", value
);
1375 m
->deserialized_state
= state
;
1377 } else if (streq(key
, "result")) {
1380 f
= mount_result_from_string(value
);
1382 log_unit_debug_errno(u
, f
, "Failed to parse result value: %s", value
);
1383 else if (f
!= MOUNT_SUCCESS
)
1386 } else if (streq(key
, "reload-result")) {
1389 f
= mount_result_from_string(value
);
1391 log_unit_debug_errno(u
, f
, "Failed to parse reload result value: %s", value
);
1392 else if (f
!= MOUNT_SUCCESS
)
1393 m
->reload_result
= f
;
1395 } else if (streq(key
, "n-retry-umount")) {
1397 r
= safe_atou(value
, &m
->n_retry_umount
);
1399 log_unit_debug_errno(u
, r
, "Failed to parse n-retry-umount value: %s", value
);
1401 } else if (streq(key
, "control-pid")) {
1403 r
= parse_pid(value
, &m
->control_pid
);
1405 log_unit_debug_errno(u
, r
, "Failed to parse control-pid value: %s", value
);
1407 } else if (streq(key
, "control-command")) {
1408 MountExecCommand id
;
1410 id
= mount_exec_command_from_string(value
);
1412 log_unit_debug_errno(u
, id
, "Failed to parse exec-command value: %s", value
);
1414 m
->control_command_id
= id
;
1415 m
->control_command
= m
->exec_command
+ id
;
1418 log_unit_debug(u
, "Unknown serialization key: %s", key
);
1423 static UnitActiveState
mount_active_state(Unit
*u
) {
1426 return state_translation_table
[MOUNT(u
)->state
];
1429 static const char *mount_sub_state_to_string(Unit
*u
) {
1432 return mount_state_to_string(MOUNT(u
)->state
);
1435 static bool mount_may_gc(Unit
*u
) {
1436 Mount
*m
= MOUNT(u
);
1440 if (m
->from_proc_self_mountinfo
)
1446 static void mount_sigchld_event(Unit
*u
, pid_t pid
, int code
, int status
) {
1447 Mount
*m
= MOUNT(u
);
1453 if (pid
!= m
->control_pid
)
1456 /* So here's the thing, we really want to know before /usr/bin/mount or /usr/bin/umount exit whether
1457 * they established/remove a mount. This is important when mounting, but even more so when unmounting
1458 * since we need to deal with nested mounts and otherwise cannot safely determine whether to repeat
1459 * the unmounts. In theory, the kernel fires /proc/self/mountinfo changes off before returning from
1460 * the mount() or umount() syscalls, and thus we should see the changes to the proc file before we
1461 * process the waitid() for the /usr/bin/(u)mount processes. However, this is unfortunately racy: we
1462 * have to waitid() for processes using P_ALL (since we need to reap unexpected children that got
1463 * reparented to PID 1), but when using P_ALL we might end up reaping processes that terminated just
1464 * instants ago, i.e. already after our last event loop iteration (i.e. after the last point we might
1465 * have noticed /proc/self/mountinfo events via epoll). This means event loop priorities for
1466 * processing SIGCHLD vs. /proc/self/mountinfo IO events are not as relevant as we want. To fix that
1467 * race, let's explicitly scan /proc/self/mountinfo before we start processing /usr/bin/(u)mount
1468 * dying. It's ugly, but it makes our ordering systematic again, and makes sure we always see
1469 * /proc/self/mountinfo changes before our mount/umount exits. */
1470 (void) mount_process_proc_self_mountinfo(u
->manager
);
1474 if (is_clean_exit(code
, status
, EXIT_CLEAN_COMMAND
, NULL
))
1476 else if (code
== CLD_EXITED
)
1477 f
= MOUNT_FAILURE_EXIT_CODE
;
1478 else if (code
== CLD_KILLED
)
1479 f
= MOUNT_FAILURE_SIGNAL
;
1480 else if (code
== CLD_DUMPED
)
1481 f
= MOUNT_FAILURE_CORE_DUMP
;
1483 assert_not_reached();
1485 if (IN_SET(m
->state
, MOUNT_REMOUNTING
, MOUNT_REMOUNTING_SIGKILL
, MOUNT_REMOUNTING_SIGTERM
))
1486 mount_set_reload_result(m
, f
);
1487 else if (m
->result
== MOUNT_SUCCESS
)
1490 if (m
->control_command
) {
1491 exec_status_exit(&m
->control_command
->exec_status
, &m
->exec_context
, pid
, code
, status
);
1493 m
->control_command
= NULL
;
1494 m
->control_command_id
= _MOUNT_EXEC_COMMAND_INVALID
;
1497 unit_log_process_exit(
1500 mount_exec_command_to_string(m
->control_command_id
),
1504 /* Note that due to the io event priority logic, we can be sure the new mountinfo is loaded
1505 * before we process the SIGCHLD for the mount command. */
1509 case MOUNT_MOUNTING
:
1510 /* Our mount point has not appeared in mountinfo. Something went wrong. */
1512 if (f
== MOUNT_SUCCESS
) {
1513 /* Either /bin/mount has an unexpected definition of success,
1514 * or someone raced us and we lost. */
1515 log_unit_warning(UNIT(m
), "Mount process finished, but there is no mount.");
1516 f
= MOUNT_FAILURE_PROTOCOL
;
1518 mount_enter_dead(m
, f
);
1521 case MOUNT_MOUNTING_DONE
:
1522 mount_enter_mounted(m
, f
);
1525 case MOUNT_REMOUNTING
:
1526 case MOUNT_REMOUNTING_SIGTERM
:
1527 case MOUNT_REMOUNTING_SIGKILL
:
1528 mount_enter_dead_or_mounted(m
, MOUNT_SUCCESS
);
1531 case MOUNT_UNMOUNTING
:
1533 if (f
== MOUNT_SUCCESS
&& m
->from_proc_self_mountinfo
) {
1535 /* Still a mount point? If so, let's try again. Most likely there were multiple mount points
1536 * stacked on top of each other. We might exceed the timeout specified by the user overall,
1537 * but we will stop as soon as any one umount times out. */
1539 if (m
->n_retry_umount
< RETRY_UMOUNT_MAX
) {
1540 log_unit_debug(u
, "Mount still present, trying again.");
1541 m
->n_retry_umount
++;
1542 mount_enter_unmounting(m
);
1544 log_unit_warning(u
, "Mount still present after %u attempts to unmount, giving up.", m
->n_retry_umount
);
1545 mount_enter_mounted(m
, f
);
1548 mount_enter_dead_or_mounted(m
, f
);
1552 case MOUNT_UNMOUNTING_SIGKILL
:
1553 case MOUNT_UNMOUNTING_SIGTERM
:
1554 mount_enter_dead_or_mounted(m
, f
);
1557 case MOUNT_CLEANING
:
1558 if (m
->clean_result
== MOUNT_SUCCESS
)
1559 m
->clean_result
= f
;
1561 mount_enter_dead(m
, MOUNT_SUCCESS
);
1565 assert_not_reached();
1568 /* Notify clients about changed exit status */
1569 unit_add_to_dbus_queue(u
);
1572 static int mount_dispatch_timer(sd_event_source
*source
, usec_t usec
, void *userdata
) {
1573 Mount
*m
= MOUNT(userdata
);
1576 assert(m
->timer_event_source
== source
);
1580 case MOUNT_MOUNTING
:
1581 case MOUNT_MOUNTING_DONE
:
1582 log_unit_warning(UNIT(m
), "Mounting timed out. Terminating.");
1583 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGTERM
, MOUNT_FAILURE_TIMEOUT
);
1586 case MOUNT_REMOUNTING
:
1587 log_unit_warning(UNIT(m
), "Remounting timed out. Terminating remount process.");
1588 mount_set_reload_result(m
, MOUNT_FAILURE_TIMEOUT
);
1589 mount_enter_signal(m
, MOUNT_REMOUNTING_SIGTERM
, MOUNT_SUCCESS
);
1592 case MOUNT_REMOUNTING_SIGTERM
:
1593 mount_set_reload_result(m
, MOUNT_FAILURE_TIMEOUT
);
1595 if (m
->kill_context
.send_sigkill
) {
1596 log_unit_warning(UNIT(m
), "Remounting timed out. Killing.");
1597 mount_enter_signal(m
, MOUNT_REMOUNTING_SIGKILL
, MOUNT_SUCCESS
);
1599 log_unit_warning(UNIT(m
), "Remounting timed out. Skipping SIGKILL. Ignoring.");
1600 mount_enter_dead_or_mounted(m
, MOUNT_SUCCESS
);
1604 case MOUNT_REMOUNTING_SIGKILL
:
1605 mount_set_reload_result(m
, MOUNT_FAILURE_TIMEOUT
);
1607 log_unit_warning(UNIT(m
), "Mount process still around after SIGKILL. Ignoring.");
1608 mount_enter_dead_or_mounted(m
, MOUNT_SUCCESS
);
1611 case MOUNT_UNMOUNTING
:
1612 log_unit_warning(UNIT(m
), "Unmounting timed out. Terminating.");
1613 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGTERM
, MOUNT_FAILURE_TIMEOUT
);
1616 case MOUNT_UNMOUNTING_SIGTERM
:
1617 if (m
->kill_context
.send_sigkill
) {
1618 log_unit_warning(UNIT(m
), "Mount process timed out. Killing.");
1619 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGKILL
, MOUNT_FAILURE_TIMEOUT
);
1621 log_unit_warning(UNIT(m
), "Mount process timed out. Skipping SIGKILL. Ignoring.");
1622 mount_enter_dead_or_mounted(m
, MOUNT_FAILURE_TIMEOUT
);
1626 case MOUNT_UNMOUNTING_SIGKILL
:
1627 log_unit_warning(UNIT(m
), "Mount process still around after SIGKILL. Ignoring.");
1628 mount_enter_dead_or_mounted(m
, MOUNT_FAILURE_TIMEOUT
);
1631 case MOUNT_CLEANING
:
1632 log_unit_warning(UNIT(m
), "Cleaning timed out. killing.");
1634 if (m
->clean_result
== MOUNT_SUCCESS
)
1635 m
->clean_result
= MOUNT_FAILURE_TIMEOUT
;
1637 mount_enter_signal(m
, MOUNT_UNMOUNTING_SIGKILL
, 0);
1641 assert_not_reached();
1647 static int mount_setup_new_unit(
1652 const char *options
,
1654 MountProcFlags
*ret_flags
,
1657 _cleanup_(unit_freep
) Unit
*u
= NULL
;
1665 r
= unit_new_for_name(m
, sizeof(Mount
), name
, &u
);
1669 r
= free_and_strdup(&u
->source_path
, "/proc/self/mountinfo");
1673 r
= free_and_strdup(&MOUNT(u
)->where
, where
);
1677 r
= update_parameters_proc_self_mountinfo(MOUNT(u
), what
, options
, fstype
);
1681 /* This unit was generated because /proc/self/mountinfo reported it. Remember this, so that by the
1682 * time we load the unit file for it (and thus add in extra deps right after) we know what source to
1683 * attributes the deps to. */
1684 MOUNT(u
)->from_proc_self_mountinfo
= true;
1686 r
= mount_add_non_exec_dependencies(MOUNT(u
));
1690 /* We have only allocated the stub now, let's enqueue this unit for loading now, so that everything
1691 * else is loaded in now. */
1692 unit_add_to_load_queue(u
);
1694 *ret_flags
= MOUNT_PROC_IS_MOUNTED
| MOUNT_PROC_JUST_MOUNTED
| MOUNT_PROC_JUST_CHANGED
;
1699 static int mount_setup_existing_unit(
1703 const char *options
,
1705 MountProcFlags
*ret_flags
) {
1712 if (!MOUNT(u
)->where
) {
1713 MOUNT(u
)->where
= strdup(where
);
1714 if (!MOUNT(u
)->where
)
1718 /* In case we have multiple mounts established on the same mount point, let's merge flags set already
1719 * for the current unit. Note that the flags field is reset on each iteration of reading
1720 * /proc/self/mountinfo, hence we know for sure anything already set here is from the current
1721 * iteration and thus worthy of taking into account. */
1722 MountProcFlags flags
=
1723 MOUNT(u
)->proc_flags
| MOUNT_PROC_IS_MOUNTED
;
1725 r
= update_parameters_proc_self_mountinfo(MOUNT(u
), what
, options
, fstype
);
1729 flags
|= MOUNT_PROC_JUST_CHANGED
;
1731 /* There are two conditions when we consider a mount point just mounted: when we haven't seen it in
1732 * /proc/self/mountinfo before or when MOUNT_MOUNTING is our current state. Why bother with the
1733 * latter? Shouldn't that be covered by the former? No, during reload it is not because we might then
1734 * encounter a new /proc/self/mountinfo in combination with an old mount unit state (since it stems
1735 * from the serialized state), and need to catch up. Since we know that the MOUNT_MOUNTING state is
1736 * reached when we wait for the mount to appear we hence can assume that if we are in it, we are
1737 * actually seeing it established for the first time. */
1738 if (!MOUNT(u
)->from_proc_self_mountinfo
|| MOUNT(u
)->state
== MOUNT_MOUNTING
)
1739 flags
|= MOUNT_PROC_JUST_MOUNTED
;
1741 MOUNT(u
)->from_proc_self_mountinfo
= true;
1743 if (IN_SET(u
->load_state
, UNIT_NOT_FOUND
, UNIT_BAD_SETTING
, UNIT_ERROR
)) {
1744 /* The unit was previously not found or otherwise not loaded. Now that the unit shows up in
1745 * /proc/self/mountinfo we should reconsider it this, hence set it to UNIT_LOADED. */
1746 u
->load_state
= UNIT_LOADED
;
1749 flags
|= MOUNT_PROC_JUST_CHANGED
;
1752 if (FLAGS_SET(flags
, MOUNT_PROC_JUST_CHANGED
)) {
1753 /* If things changed, then make sure that all deps are regenerated. Let's
1754 * first remove all automatic deps, and then add in the new ones. */
1755 r
= mount_add_non_exec_dependencies(MOUNT(u
));
1764 static int mount_setup_unit(
1768 const char *options
,
1772 _cleanup_free_
char *e
= NULL
;
1773 MountProcFlags flags
;
1783 /* Ignore API mount points. They should never be referenced in
1784 * dependencies ever. */
1785 if (mount_point_is_api(where
) || mount_point_ignore(where
))
1788 if (streq(fstype
, "autofs"))
1791 /* probably some kind of swap, ignore */
1792 if (!is_path(where
))
1795 r
= unit_name_from_path(where
, ".mount", &e
);
1797 return log_struct_errno(
1799 "MESSAGE_ID=" SD_MESSAGE_MOUNT_POINT_PATH_NOT_SUITABLE_STR
,
1800 "MOUNT_POINT=%s", where
,
1801 LOG_MESSAGE("Failed to generate valid unit name from mount point path '%s', ignoring mount point: %m",
1804 u
= manager_get_unit(m
, e
);
1806 r
= mount_setup_existing_unit(u
, what
, where
, options
, fstype
, &flags
);
1808 /* First time we see this mount point meaning that it's not been initiated by a mount unit
1809 * but rather by the sysadmin having called mount(8) directly. */
1810 r
= mount_setup_new_unit(m
, e
, what
, where
, options
, fstype
, &flags
, &u
);
1812 return log_warning_errno(r
, "Failed to set up mount unit for '%s': %m", where
);
1814 /* If the mount changed properties or state, let's notify our clients */
1815 if (flags
& (MOUNT_PROC_JUST_CHANGED
|MOUNT_PROC_JUST_MOUNTED
))
1816 unit_add_to_dbus_queue(u
);
1819 MOUNT(u
)->proc_flags
= flags
;
1824 static int mount_load_proc_self_mountinfo(Manager
*m
, bool set_flags
) {
1825 _cleanup_(mnt_free_tablep
) struct libmnt_table
*table
= NULL
;
1826 _cleanup_(mnt_free_iterp
) struct libmnt_iter
*iter
= NULL
;
1831 r
= libmount_parse(NULL
, NULL
, &table
, &iter
);
1833 return log_error_errno(r
, "Failed to parse /proc/self/mountinfo: %m");
1836 struct libmnt_fs
*fs
;
1837 const char *device
, *path
, *options
, *fstype
;
1839 r
= mnt_table_next_fs(table
, iter
, &fs
);
1843 return log_error_errno(r
, "Failed to get next entry from /proc/self/mountinfo: %m");
1845 device
= mnt_fs_get_source(fs
);
1846 path
= mnt_fs_get_target(fs
);
1847 options
= mnt_fs_get_options(fs
);
1848 fstype
= mnt_fs_get_fstype(fs
);
1850 if (!device
|| !path
)
1853 device_found_node(m
, device
, DEVICE_FOUND_MOUNT
, DEVICE_FOUND_MOUNT
);
1855 (void) mount_setup_unit(m
, device
, path
, options
, fstype
, set_flags
);
1861 static void mount_shutdown(Manager
*m
) {
1864 m
->mount_event_source
= sd_event_source_disable_unref(m
->mount_event_source
);
1866 mnt_unref_monitor(m
->mount_monitor
);
1867 m
->mount_monitor
= NULL
;
1870 static int mount_get_timeout(Unit
*u
, usec_t
*timeout
) {
1871 Mount
*m
= MOUNT(u
);
1878 if (!m
->timer_event_source
)
1881 r
= sd_event_source_get_time(m
->timer_event_source
, &t
);
1884 if (t
== USEC_INFINITY
)
1891 static void mount_enumerate_perpetual(Manager
*m
) {
1897 /* Whatever happens, we know for sure that the root directory is around, and cannot go away. Let's
1898 * unconditionally synthesize it here and mark it as perpetual. */
1900 u
= manager_get_unit(m
, SPECIAL_ROOT_MOUNT
);
1902 r
= unit_new_for_name(m
, sizeof(Mount
), SPECIAL_ROOT_MOUNT
, &u
);
1904 log_error_errno(r
, "Failed to allocate the special " SPECIAL_ROOT_MOUNT
" unit: %m");
1909 u
->perpetual
= true;
1910 MOUNT(u
)->deserialized_state
= MOUNT_MOUNTED
;
1912 unit_add_to_load_queue(u
);
1913 unit_add_to_dbus_queue(u
);
1916 static bool mount_is_mounted(Mount
*m
) {
1919 return UNIT(m
)->perpetual
|| FLAGS_SET(m
->proc_flags
, MOUNT_PROC_IS_MOUNTED
);
1922 static int mount_on_ratelimit_expire(sd_event_source
*s
, void *userdata
) {
1923 Manager
*m
= ASSERT_PTR(userdata
);
1926 /* Let's enqueue all start jobs that were previously skipped because of active ratelimit. */
1927 HASHMAP_FOREACH(j
, m
->jobs
) {
1928 if (j
->unit
->type
!= UNIT_MOUNT
)
1931 job_add_to_run_queue(j
);
1934 /* By entering ratelimited state we made all mount start jobs not runnable, now rate limit is over so
1935 * let's make sure we dispatch them in the next iteration. */
1936 manager_trigger_run_queue(m
);
1941 static void mount_enumerate(Manager
*m
) {
1948 if (!m
->mount_monitor
) {
1949 unsigned mount_rate_limit_burst
= 5;
1952 m
->mount_monitor
= mnt_new_monitor();
1953 if (!m
->mount_monitor
) {
1958 r
= mnt_monitor_enable_kernel(m
->mount_monitor
, 1);
1960 log_error_errno(r
, "Failed to enable watching of kernel mount events: %m");
1964 r
= mnt_monitor_enable_userspace(m
->mount_monitor
, 1, NULL
);
1966 log_error_errno(r
, "Failed to enable watching of userspace mount events: %m");
1970 /* mnt_unref_monitor() will close the fd */
1971 fd
= r
= mnt_monitor_get_fd(m
->mount_monitor
);
1973 log_error_errno(r
, "Failed to acquire watch file descriptor: %m");
1977 r
= sd_event_add_io(m
->event
, &m
->mount_event_source
, fd
, EPOLLIN
, mount_dispatch_io
, m
);
1979 log_error_errno(r
, "Failed to watch mount file descriptor: %m");
1983 r
= sd_event_source_set_priority(m
->mount_event_source
, SD_EVENT_PRIORITY_NORMAL
-10);
1985 log_error_errno(r
, "Failed to adjust mount watch priority: %m");
1989 /* Let users override the default (5 in 1s), as it stalls the boot sequence on busy systems. */
1990 const char *e
= secure_getenv("SYSTEMD_DEFAULT_MOUNT_RATE_LIMIT_BURST");
1992 r
= safe_atou(e
, &mount_rate_limit_burst
);
1994 log_debug("Invalid value in $SYSTEMD_DEFAULT_MOUNT_RATE_LIMIT_BURST, ignoring: %s", e
);
1997 r
= sd_event_source_set_ratelimit(m
->mount_event_source
, 1 * USEC_PER_SEC
, mount_rate_limit_burst
);
1999 log_error_errno(r
, "Failed to enable rate limit for mount events: %m");
2003 r
= sd_event_source_set_ratelimit_expire_callback(m
->mount_event_source
, mount_on_ratelimit_expire
);
2005 log_error_errno(r
, "Failed to enable rate limit for mount events: %m");
2009 (void) sd_event_source_set_description(m
->mount_event_source
, "mount-monitor-dispatch");
2012 r
= mount_load_proc_self_mountinfo(m
, false);
2022 static int drain_libmount(Manager
*m
) {
2023 bool rescan
= false;
2028 /* Drain all events and verify that the event is valid.
2030 * Note that libmount also monitors /run/mount mkdir if the directory does not exist yet. The mkdir
2031 * may generate event which is irrelevant for us.
2033 * error: r < 0; valid: r == 0, false positive: r == 1 */
2035 r
= mnt_monitor_next_change(m
->mount_monitor
, NULL
, NULL
);
2037 return log_error_errno(r
, "Failed to drain libmount events: %m");
2045 static int mount_process_proc_self_mountinfo(Manager
*m
) {
2046 _cleanup_set_free_ Set
*around
= NULL
, *gone
= NULL
;
2052 r
= drain_libmount(m
);
2056 r
= mount_load_proc_self_mountinfo(m
, true);
2058 /* Reset flags, just in case, for later calls */
2059 LIST_FOREACH(units_by_type
, u
, m
->units_by_type
[UNIT_MOUNT
])
2060 MOUNT(u
)->proc_flags
= 0;
2065 manager_dispatch_load_queue(m
);
2067 LIST_FOREACH(units_by_type
, u
, m
->units_by_type
[UNIT_MOUNT
]) {
2068 Mount
*mount
= MOUNT(u
);
2070 if (!mount_is_mounted(mount
)) {
2072 /* A mount point is not around right now. It might be gone, or might never have
2075 if (mount
->from_proc_self_mountinfo
&&
2076 mount
->parameters_proc_self_mountinfo
.what
)
2077 /* Remember that this device might just have disappeared */
2078 if (set_put_strdup_full(&gone
, &path_hash_ops_free
, mount
->parameters_proc_self_mountinfo
.what
) < 0)
2079 log_oom(); /* we don't care too much about OOM here... */
2081 mount
->from_proc_self_mountinfo
= false;
2082 assert_se(update_parameters_proc_self_mountinfo(mount
, NULL
, NULL
, NULL
) >= 0);
2084 switch (mount
->state
) {
2087 /* This has just been unmounted by somebody else, follow the state change. */
2088 mount_enter_dead(mount
, MOUNT_SUCCESS
);
2091 case MOUNT_MOUNTING_DONE
:
2092 /* The mount command may add the corresponding proc mountinfo entry and
2093 * then remove it because of an internal error. E.g., fuse.sshfs seems
2094 * to do that when the connection fails. See #17617. To handle such the
2095 * case, let's once set the state back to mounting. Then, the unit can
2096 * correctly enter the failed state later in mount_sigchld(). */
2097 mount_set_state(mount
, MOUNT_MOUNTING
);
2104 } else if (mount
->proc_flags
& (MOUNT_PROC_JUST_MOUNTED
|MOUNT_PROC_JUST_CHANGED
)) {
2106 /* A mount point was added or changed */
2108 switch (mount
->state
) {
2113 /* This has just been mounted by somebody else, follow the state change, but let's
2114 * generate a new invocation ID for this implicitly and automatically. */
2115 (void) unit_acquire_invocation_id(u
);
2116 mount_cycle_clear(mount
);
2117 mount_enter_mounted(mount
, MOUNT_SUCCESS
);
2120 case MOUNT_MOUNTING
:
2121 mount_set_state(mount
, MOUNT_MOUNTING_DONE
);
2125 /* Nothing really changed, but let's issue an notification call nonetheless,
2126 * in case somebody is waiting for this. (e.g. file system ro/rw
2128 mount_set_state(mount
, mount
->state
);
2133 if (mount_is_mounted(mount
) &&
2134 mount
->from_proc_self_mountinfo
&&
2135 mount
->parameters_proc_self_mountinfo
.what
)
2136 /* Track devices currently used */
2137 if (set_put_strdup_full(&around
, &path_hash_ops_free
, mount
->parameters_proc_self_mountinfo
.what
) < 0)
2140 /* Reset the flags for later calls */
2141 mount
->proc_flags
= 0;
2144 SET_FOREACH(what
, gone
) {
2145 if (set_contains(around
, what
))
2148 /* Let the device units know that the device is no longer mounted */
2149 device_found_node(m
, what
, DEVICE_NOT_FOUND
, DEVICE_FOUND_MOUNT
);
2155 static int mount_dispatch_io(sd_event_source
*source
, int fd
, uint32_t revents
, void *userdata
) {
2156 Manager
*m
= ASSERT_PTR(userdata
);
2158 assert(revents
& EPOLLIN
);
2160 return mount_process_proc_self_mountinfo(m
);
2163 static void mount_reset_failed(Unit
*u
) {
2164 Mount
*m
= MOUNT(u
);
2168 if (m
->state
== MOUNT_FAILED
)
2169 mount_set_state(m
, MOUNT_DEAD
);
2171 m
->result
= MOUNT_SUCCESS
;
2172 m
->reload_result
= MOUNT_SUCCESS
;
2173 m
->clean_result
= MOUNT_SUCCESS
;
2176 static int mount_kill(Unit
*u
, KillWho who
, int signo
, int code
, int value
, sd_bus_error
*error
) {
2177 Mount
*m
= MOUNT(u
);
2181 return unit_kill_common(u
, who
, signo
, code
, value
, -1, m
->control_pid
, error
);
2184 static int mount_control_pid(Unit
*u
) {
2185 Mount
*m
= MOUNT(u
);
2189 return m
->control_pid
;
2192 static int mount_clean(Unit
*u
, ExecCleanMask mask
) {
2193 _cleanup_strv_free_
char **l
= NULL
;
2194 Mount
*m
= MOUNT(u
);
2200 if (m
->state
!= MOUNT_DEAD
)
2203 r
= exec_context_get_clean_directories(&m
->exec_context
, u
->manager
->prefix
, mask
, &l
);
2207 if (strv_isempty(l
))
2210 mount_unwatch_control_pid(m
);
2211 m
->clean_result
= MOUNT_SUCCESS
;
2212 m
->control_command
= NULL
;
2213 m
->control_command_id
= _MOUNT_EXEC_COMMAND_INVALID
;
2215 r
= mount_arm_timer(m
, usec_add(now(CLOCK_MONOTONIC
), m
->exec_context
.timeout_clean_usec
));
2219 r
= unit_fork_and_watch_rm_rf(u
, l
, &m
->control_pid
);
2223 mount_set_state(m
, MOUNT_CLEANING
);
2228 log_unit_warning_errno(u
, r
, "Failed to initiate cleaning: %m");
2229 m
->clean_result
= MOUNT_FAILURE_RESOURCES
;
2230 m
->timer_event_source
= sd_event_source_disable_unref(m
->timer_event_source
);
2234 static int mount_can_clean(Unit
*u
, ExecCleanMask
*ret
) {
2235 Mount
*m
= MOUNT(u
);
2239 return exec_context_get_clean_mask(&m
->exec_context
, ret
);
2242 static int mount_can_start(Unit
*u
) {
2243 Mount
*m
= MOUNT(u
);
2248 r
= unit_test_start_limit(u
);
2250 mount_enter_dead(m
, MOUNT_FAILURE_START_LIMIT_HIT
);
2257 static int mount_subsystem_ratelimited(Manager
*m
) {
2260 if (!m
->mount_event_source
)
2263 return sd_event_source_is_ratelimited(m
->mount_event_source
);
2266 static const char* const mount_exec_command_table
[_MOUNT_EXEC_COMMAND_MAX
] = {
2267 [MOUNT_EXEC_MOUNT
] = "ExecMount",
2268 [MOUNT_EXEC_UNMOUNT
] = "ExecUnmount",
2269 [MOUNT_EXEC_REMOUNT
] = "ExecRemount",
2272 DEFINE_STRING_TABLE_LOOKUP(mount_exec_command
, MountExecCommand
);
2274 static const char* const mount_result_table
[_MOUNT_RESULT_MAX
] = {
2275 [MOUNT_SUCCESS
] = "success",
2276 [MOUNT_FAILURE_RESOURCES
] = "resources",
2277 [MOUNT_FAILURE_TIMEOUT
] = "timeout",
2278 [MOUNT_FAILURE_EXIT_CODE
] = "exit-code",
2279 [MOUNT_FAILURE_SIGNAL
] = "signal",
2280 [MOUNT_FAILURE_CORE_DUMP
] = "core-dump",
2281 [MOUNT_FAILURE_START_LIMIT_HIT
] = "start-limit-hit",
2282 [MOUNT_FAILURE_PROTOCOL
] = "protocol",
2285 DEFINE_STRING_TABLE_LOOKUP(mount_result
, MountResult
);
2287 const UnitVTable mount_vtable
= {
2288 .object_size
= sizeof(Mount
),
2289 .exec_context_offset
= offsetof(Mount
, exec_context
),
2290 .cgroup_context_offset
= offsetof(Mount
, cgroup_context
),
2291 .kill_context_offset
= offsetof(Mount
, kill_context
),
2292 .exec_runtime_offset
= offsetof(Mount
, exec_runtime
),
2298 .private_section
= "Mount",
2300 .can_transient
= true,
2302 .exclude_from_switch_root_serialization
= true,
2308 .coldplug
= mount_coldplug
,
2309 .catchup
= mount_catchup
,
2313 .start
= mount_start
,
2315 .reload
= mount_reload
,
2318 .clean
= mount_clean
,
2319 .can_clean
= mount_can_clean
,
2321 .serialize
= mount_serialize
,
2322 .deserialize_item
= mount_deserialize_item
,
2324 .active_state
= mount_active_state
,
2325 .sub_state_to_string
= mount_sub_state_to_string
,
2327 .will_restart
= unit_will_restart_default
,
2329 .may_gc
= mount_may_gc
,
2330 .is_extrinsic
= mount_is_extrinsic
,
2332 .sigchld_event
= mount_sigchld_event
,
2334 .reset_failed
= mount_reset_failed
,
2336 .control_pid
= mount_control_pid
,
2338 .bus_set_property
= bus_mount_set_property
,
2339 .bus_commit_properties
= bus_mount_commit_properties
,
2341 .get_timeout
= mount_get_timeout
,
2343 .enumerate_perpetual
= mount_enumerate_perpetual
,
2344 .enumerate
= mount_enumerate
,
2345 .shutdown
= mount_shutdown
,
2346 .subsystem_ratelimited
= mount_subsystem_ratelimited
,
2348 .status_message_formats
= {
2349 .starting_stopping
= {
2350 [0] = "Mounting %s...",
2351 [1] = "Unmounting %s...",
2353 .finished_start_job
= {
2354 [JOB_DONE
] = "Mounted %s.",
2355 [JOB_FAILED
] = "Failed to mount %s.",
2356 [JOB_TIMEOUT
] = "Timed out mounting %s.",
2358 .finished_stop_job
= {
2359 [JOB_DONE
] = "Unmounted %s.",
2360 [JOB_FAILED
] = "Failed unmounting %s.",
2361 [JOB_TIMEOUT
] = "Timed out unmounting %s.",
2365 .can_start
= mount_can_start
,
2367 .notify_plymouth
= true,