]> git.ipfire.org Git - thirdparty/systemd.git/blame - src/udev/udev-manager.c
fd-uitl: rename PIPE_EBADF → EBADF_PAIR, and add EBADF_TRIPLET
[thirdparty/systemd.git] / src / udev / udev-manager.c
CommitLineData
81c32b1d
YW
1/* SPDX-License-Identifier: GPL-2.0-or-later */
2
3#include "blockdev-util.h"
4#include "cgroup-util.h"
5#include "common-signal.h"
ce5ddbc4 6#include "cpu-set-util.h"
81c32b1d
YW
7#include "daemon-util.h"
8#include "device-monitor-private.h"
9#include "device-private.h"
10#include "device-util.h"
11#include "errno-list.h"
12#include "event-util.h"
13#include "fd-util.h"
14#include "fs-util.h"
15#include "hashmap.h"
16#include "inotify-util.h"
bd1ae178 17#include "iovec-util.h"
ce5ddbc4 18#include "limits-util.h"
81c32b1d
YW
19#include "list.h"
20#include "mkdir.h"
21#include "process-util.h"
22#include "selinux-util.h"
23#include "signal-util.h"
24#include "socket-util.h"
25#include "string-util.h"
26#include "syslog-util.h"
27#include "udev-builtin.h"
28#include "udev-ctrl.h"
29#include "udev-event.h"
30#include "udev-manager.h"
31#include "udev-node.h"
32#include "udev-spawn.h"
33#include "udev-trace.h"
34#include "udev-util.h"
35#include "udev-watch.h"
36#include "udev-worker.h"
37
ce5ddbc4
YW
38#define WORKER_NUM_MAX UINT64_C(2048)
39
81c32b1d
YW
40#define EVENT_RETRY_INTERVAL_USEC (200 * USEC_PER_MSEC)
41#define EVENT_RETRY_TIMEOUT_USEC (3 * USEC_PER_MINUTE)
42
43typedef enum EventState {
44 EVENT_UNDEF,
45 EVENT_QUEUED,
46 EVENT_RUNNING,
47} EventState;
48
49typedef struct Event {
50 Manager *manager;
51 Worker *worker;
52 EventState state;
53
54 sd_device *dev;
55
56 sd_device_action_t action;
57 uint64_t seqnum;
58 uint64_t blocker_seqnum;
59 const char *id;
60 const char *devpath;
61 const char *devpath_old;
62 const char *devnode;
63
64 /* Used when the device is locked by another program. */
65 usec_t retry_again_next_usec;
66 usec_t retry_again_timeout_usec;
67 sd_event_source *retry_event_source;
68
69 sd_event_source *timeout_warning_event;
70 sd_event_source *timeout_event;
71
72 LIST_FIELDS(Event, event);
73} Event;
74
75typedef enum WorkerState {
76 WORKER_UNDEF,
77 WORKER_RUNNING,
78 WORKER_IDLE,
79 WORKER_KILLED,
80 WORKER_KILLING,
81} WorkerState;
82
83typedef struct Worker {
84 Manager *manager;
85 pid_t pid;
86 sd_event_source *child_event_source;
87 sd_device_monitor *monitor;
88 WorkerState state;
89 Event *event;
90} Worker;
91
92static Event *event_free(Event *event) {
93 if (!event)
94 return NULL;
95
96 assert(event->manager);
97
98 LIST_REMOVE(event, event->manager->events, event);
99 sd_device_unref(event->dev);
100
101 sd_event_source_unref(event->retry_event_source);
102 sd_event_source_unref(event->timeout_warning_event);
103 sd_event_source_unref(event->timeout_event);
104
105 if (event->worker)
106 event->worker->event = NULL;
107
108 return mfree(event);
109}
110
111static void event_queue_cleanup(Manager *manager, EventState match_state) {
112 LIST_FOREACH(event, event, manager->events) {
113 if (match_state != EVENT_UNDEF && match_state != event->state)
114 continue;
115
116 event_free(event);
117 }
118}
119
120static Worker *worker_free(Worker *worker) {
121 if (!worker)
122 return NULL;
123
124 if (worker->manager)
125 hashmap_remove(worker->manager->workers, PID_TO_PTR(worker->pid));
126
127 sd_event_source_unref(worker->child_event_source);
128 sd_device_monitor_unref(worker->monitor);
129 event_free(worker->event);
130
131 return mfree(worker);
132}
133
134DEFINE_TRIVIAL_CLEANUP_FUNC(Worker*, worker_free);
135DEFINE_PRIVATE_HASH_OPS_WITH_VALUE_DESTRUCTOR(worker_hash_op, void, trivial_hash_func, trivial_compare_func, Worker, worker_free);
136
137Manager* manager_free(Manager *manager) {
138 if (!manager)
139 return NULL;
140
141 udev_builtin_exit();
142
143 hashmap_free_free_free(manager->properties);
144 udev_rules_free(manager->rules);
145
146 hashmap_free(manager->workers);
147 event_queue_cleanup(manager, EVENT_UNDEF);
148
149 safe_close(manager->inotify_fd);
150 safe_close_pair(manager->worker_watch);
151
152 sd_device_monitor_unref(manager->monitor);
153 udev_ctrl_unref(manager->ctrl);
154
155 sd_event_source_unref(manager->inotify_event);
156 sd_event_source_unref(manager->kill_workers_event);
157 sd_event_source_unref(manager->memory_pressure_event_source);
158 sd_event_source_unref(manager->sigrtmin18_event_source);
159 sd_event_unref(manager->event);
160
161 free(manager->cgroup);
162 return mfree(manager);
163}
164
165static int on_sigchld(sd_event_source *s, const siginfo_t *si, void *userdata);
166
167static int worker_new(Worker **ret, Manager *manager, sd_device_monitor *worker_monitor, pid_t pid) {
168 _cleanup_(worker_freep) Worker *worker = NULL;
169 int r;
170
171 assert(ret);
172 assert(manager);
173 assert(worker_monitor);
174 assert(pid > 1);
175
176 /* close monitor, but keep address around */
177 device_monitor_disconnect(worker_monitor);
178
179 worker = new(Worker, 1);
180 if (!worker)
181 return -ENOMEM;
182
183 *worker = (Worker) {
184 .monitor = sd_device_monitor_ref(worker_monitor),
185 .pid = pid,
186 };
187
188 r = sd_event_add_child(manager->event, &worker->child_event_source, pid, WEXITED, on_sigchld, worker);
189 if (r < 0)
190 return r;
191
192 r = hashmap_ensure_put(&manager->workers, &worker_hash_op, PID_TO_PTR(pid), worker);
193 if (r < 0)
194 return r;
195
196 worker->manager = manager;
197
198 *ret = TAKE_PTR(worker);
199 return 0;
200}
201
202static void manager_kill_workers(Manager *manager, bool force) {
203 Worker *worker;
204
205 assert(manager);
206
207 HASHMAP_FOREACH(worker, manager->workers) {
208 if (worker->state == WORKER_KILLED)
209 continue;
210
211 if (worker->state == WORKER_RUNNING && !force) {
212 worker->state = WORKER_KILLING;
213 continue;
214 }
215
216 worker->state = WORKER_KILLED;
217 (void) kill(worker->pid, SIGTERM);
218 }
219}
220
221static void manager_exit(Manager *manager) {
222 assert(manager);
223
224 manager->exit = true;
225
226 (void) sd_notify(/* unset= */ false, NOTIFY_STOPPING);
227
228 /* close sources of new events and discard buffered events */
229 manager->ctrl = udev_ctrl_unref(manager->ctrl);
230
231 manager->inotify_event = sd_event_source_disable_unref(manager->inotify_event);
232 manager->inotify_fd = safe_close(manager->inotify_fd);
233
234 manager->monitor = sd_device_monitor_unref(manager->monitor);
235
236 /* discard queued events and kill workers */
237 event_queue_cleanup(manager, EVENT_QUEUED);
238 manager_kill_workers(manager, true);
239}
240
241static void notify_ready(Manager *manager) {
242 int r;
243
244 assert(manager);
245
246 r = sd_notifyf(/* unset= */ false,
247 "READY=1\n"
248 "STATUS=Processing with %u children at max", manager->children_max);
249 if (r < 0)
250 log_warning_errno(r, "Failed to send readiness notification, ignoring: %m");
251}
252
253/* reload requested, HUP signal received, rules changed, builtin changed */
254static void manager_reload(Manager *manager, bool force) {
255 _cleanup_(udev_rules_freep) UdevRules *rules = NULL;
256 usec_t now_usec;
257 int r;
258
259 assert(manager);
260
261 assert_se(sd_event_now(manager->event, CLOCK_MONOTONIC, &now_usec) >= 0);
262 if (!force && now_usec < usec_add(manager->last_usec, 3 * USEC_PER_SEC))
263 /* check for changed config, every 3 seconds at most */
264 return;
265 manager->last_usec = now_usec;
266
267 /* Reload SELinux label database, to make the child inherit the up-to-date database. */
268 mac_selinux_maybe_reload();
269
270 /* Nothing changed. It is not necessary to reload. */
271 if (!udev_rules_should_reload(manager->rules) && !udev_builtin_should_reload()) {
272
273 if (!force)
274 return;
275
276 /* If we eat this up, then tell our service manager to just continue */
277 (void) sd_notifyf(/* unset= */ false,
278 "RELOADING=1\n"
279 "STATUS=Skipping configuration reloading, nothing changed.\n"
280 "MONOTONIC_USEC=" USEC_FMT, now(CLOCK_MONOTONIC));
281 } else {
282 (void) sd_notifyf(/* unset= */ false,
283 "RELOADING=1\n"
284 "STATUS=Flushing configuration...\n"
285 "MONOTONIC_USEC=" USEC_FMT, now(CLOCK_MONOTONIC));
286
287 manager_kill_workers(manager, false);
288
289 udev_builtin_exit();
290 udev_builtin_init();
291
292 r = udev_rules_load(&rules, manager->resolve_name_timing);
293 if (r < 0)
294 log_warning_errno(r, "Failed to read udev rules, using the previously loaded rules, ignoring: %m");
295 else
296 udev_rules_free_and_replace(manager->rules, rules);
297 }
298
299 notify_ready(manager);
300}
301
302static int on_kill_workers_event(sd_event_source *s, uint64_t usec, void *userdata) {
303 Manager *manager = ASSERT_PTR(userdata);
304
305 log_debug("Cleanup idle workers");
306 manager_kill_workers(manager, false);
307
308 return 1;
309}
310
311static int on_event_timeout(sd_event_source *s, uint64_t usec, void *userdata) {
312 Event *event = ASSERT_PTR(userdata);
313
314 assert(event->manager);
315 assert(event->worker);
316
317 kill_and_sigcont(event->worker->pid, event->manager->timeout_signal);
318 event->worker->state = WORKER_KILLED;
319
320 log_device_error(event->dev, "Worker ["PID_FMT"] processing SEQNUM=%"PRIu64" killed", event->worker->pid, event->seqnum);
321
322 return 1;
323}
324
325static int on_event_timeout_warning(sd_event_source *s, uint64_t usec, void *userdata) {
326 Event *event = ASSERT_PTR(userdata);
327
328 assert(event->worker);
329
330 log_device_warning(event->dev, "Worker ["PID_FMT"] processing SEQNUM=%"PRIu64" is taking a long time", event->worker->pid, event->seqnum);
331
332 return 1;
333}
334
335static void worker_attach_event(Worker *worker, Event *event) {
336 Manager *manager;
337 sd_event *e;
338
339 assert(worker);
340 assert(worker->manager);
341 assert(event);
342 assert(!event->worker);
343 assert(!worker->event);
344
345 worker->state = WORKER_RUNNING;
346 worker->event = event;
347 event->state = EVENT_RUNNING;
348 event->worker = worker;
349
350 manager = worker->manager;
351 e = manager->event;
352
353 (void) sd_event_add_time_relative(e, &event->timeout_warning_event, CLOCK_MONOTONIC,
354 udev_warn_timeout(manager->timeout_usec), USEC_PER_SEC,
355 on_event_timeout_warning, event);
356
357 (void) sd_event_add_time_relative(e, &event->timeout_event, CLOCK_MONOTONIC,
358 manager->timeout_usec, USEC_PER_SEC,
359 on_event_timeout, event);
360}
361
362static int worker_spawn(Manager *manager, Event *event) {
363 _cleanup_(sd_device_monitor_unrefp) sd_device_monitor *worker_monitor = NULL;
364 Worker *worker;
365 pid_t pid;
366 int r;
367
368 /* listen for new events */
369 r = device_monitor_new_full(&worker_monitor, MONITOR_GROUP_NONE, -1);
370 if (r < 0)
371 return r;
372
373 (void) sd_device_monitor_set_description(worker_monitor, "worker");
374
375 /* allow the main daemon netlink address to send devices to the worker */
376 r = device_monitor_allow_unicast_sender(worker_monitor, manager->monitor);
377 if (r < 0)
378 return log_error_errno(r, "Worker: Failed to set unicast sender: %m");
379
380 r = device_monitor_enable_receiving(worker_monitor);
381 if (r < 0)
382 return log_error_errno(r, "Worker: Failed to enable receiving of device: %m");
383
384 r = safe_fork("(udev-worker)", FORK_DEATHSIG, &pid);
385 if (r < 0) {
386 event->state = EVENT_QUEUED;
387 return log_error_errno(r, "Failed to fork() worker: %m");
388 }
389 if (r == 0) {
390 _cleanup_(udev_worker_done) UdevWorker w = {
391 .monitor = TAKE_PTR(worker_monitor),
392 .properties = TAKE_PTR(manager->properties),
393 .rules = TAKE_PTR(manager->rules),
394 .pipe_fd = TAKE_FD(manager->worker_watch[WRITE_END]),
395 .inotify_fd = TAKE_FD(manager->inotify_fd),
396 .exec_delay_usec = manager->exec_delay_usec,
397 .timeout_usec = manager->timeout_usec,
398 .timeout_signal = manager->timeout_signal,
399 .log_level = manager->log_level,
400 .blockdev_read_only = manager->blockdev_read_only,
401 };
402
403 /* Worker process */
404 r = udev_worker_main(&w, event->dev);
405 log_close();
406 _exit(r < 0 ? EXIT_FAILURE : EXIT_SUCCESS);
407 }
408
409 r = worker_new(&worker, manager, worker_monitor, pid);
410 if (r < 0)
411 return log_error_errno(r, "Failed to create worker object: %m");
412
413 worker_attach_event(worker, event);
414
415 log_device_debug(event->dev, "Worker ["PID_FMT"] is forked for processing SEQNUM=%"PRIu64".", pid, event->seqnum);
416 return 0;
417}
418
419static int event_run(Event *event) {
420 static bool log_children_max_reached = true;
421 Manager *manager;
422 Worker *worker;
423 int r;
424
425 assert(event);
426 assert(event->manager);
427
428 log_device_uevent(event->dev, "Device ready for processing");
429
430 (void) event_source_disable(event->retry_event_source);
431
432 manager = event->manager;
433 HASHMAP_FOREACH(worker, manager->workers) {
434 if (worker->state != WORKER_IDLE)
435 continue;
436
437 r = device_monitor_send_device(manager->monitor, worker->monitor, event->dev);
438 if (r < 0) {
439 log_device_error_errno(event->dev, r, "Worker ["PID_FMT"] did not accept message, killing the worker: %m",
440 worker->pid);
441 (void) kill(worker->pid, SIGKILL);
442 worker->state = WORKER_KILLED;
443 continue;
444 }
445 worker_attach_event(worker, event);
446 return 1; /* event is now processing. */
447 }
448
449 if (hashmap_size(manager->workers) >= manager->children_max) {
450 /* Avoid spamming the debug logs if the limit is already reached and
451 * many events still need to be processed */
452 if (log_children_max_reached && manager->children_max > 1) {
453 log_debug("Maximum number (%u) of children reached.", hashmap_size(manager->workers));
454 log_children_max_reached = false;
455 }
456 return 0; /* no free worker */
457 }
458
459 /* Re-enable the debug message for the next batch of events */
460 log_children_max_reached = true;
461
462 /* start new worker and pass initial device */
463 r = worker_spawn(manager, event);
464 if (r < 0)
465 return r;
466
467 return 1; /* event is now processing. */
468}
469
470bool devpath_conflict(const char *a, const char *b) {
471 /* This returns true when two paths are equivalent, or one is a child of another. */
472
473 if (!a || !b)
474 return false;
475
476 for (; *a != '\0' && *b != '\0'; a++, b++)
477 if (*a != *b)
478 return false;
479
480 return *a == '/' || *b == '/' || *a == *b;
481}
482
483static int event_is_blocked(Event *event) {
484 Event *loop_event = NULL;
485 int r;
486
487 /* lookup event for identical, parent, child device */
488
489 assert(event);
490 assert(event->manager);
491 assert(event->blocker_seqnum <= event->seqnum);
492
493 if (event->retry_again_next_usec > 0) {
494 usec_t now_usec;
495
496 r = sd_event_now(event->manager->event, CLOCK_BOOTTIME, &now_usec);
497 if (r < 0)
498 return r;
499
500 if (event->retry_again_next_usec > now_usec)
501 return true;
502 }
503
504 if (event->blocker_seqnum == event->seqnum)
505 /* we have checked previously and no blocker found */
506 return false;
507
508 LIST_FOREACH(event, e, event->manager->events) {
509 loop_event = e;
510
511 /* we already found a later event, earlier cannot block us, no need to check again */
512 if (loop_event->seqnum < event->blocker_seqnum)
513 continue;
514
515 /* event we checked earlier still exists, no need to check again */
516 if (loop_event->seqnum == event->blocker_seqnum)
517 return true;
518
519 /* found ourself, no later event can block us */
520 if (loop_event->seqnum >= event->seqnum)
521 goto no_blocker;
522
523 /* found event we have not checked */
524 break;
525 }
526
527 assert(loop_event);
528 assert(loop_event->seqnum > event->blocker_seqnum &&
529 loop_event->seqnum < event->seqnum);
530
531 /* check if queue contains events we depend on */
532 LIST_FOREACH(event, e, loop_event) {
533 loop_event = e;
534
535 /* found ourself, no later event can block us */
536 if (loop_event->seqnum >= event->seqnum)
537 goto no_blocker;
538
539 if (streq_ptr(loop_event->id, event->id))
540 break;
541
542 if (devpath_conflict(event->devpath, loop_event->devpath) ||
543 devpath_conflict(event->devpath, loop_event->devpath_old) ||
544 devpath_conflict(event->devpath_old, loop_event->devpath))
545 break;
546
547 if (event->devnode && streq_ptr(event->devnode, loop_event->devnode))
548 break;
549 }
550
551 assert(loop_event);
552
553 log_device_debug(event->dev, "SEQNUM=%" PRIu64 " blocked by SEQNUM=%" PRIu64,
554 event->seqnum, loop_event->seqnum);
555
556 event->blocker_seqnum = loop_event->seqnum;
557 return true;
558
559no_blocker:
560 event->blocker_seqnum = event->seqnum;
561 return false;
562}
563
564static int event_queue_start(Manager *manager) {
565 int r;
566
567 assert(manager);
568
569 if (!manager->events || manager->exit || manager->stop_exec_queue)
570 return 0;
571
572 /* To make the stack directory /run/udev/links cleaned up later. */
573 manager->udev_node_needs_cleanup = true;
574
575 r = event_source_disable(manager->kill_workers_event);
576 if (r < 0)
577 log_warning_errno(r, "Failed to disable event source for cleaning up idle workers, ignoring: %m");
578
579 manager_reload(manager, /* force = */ false);
580
581 LIST_FOREACH(event, event, manager->events) {
582 if (event->state != EVENT_QUEUED)
583 continue;
584
585 /* do not start event if parent or child event is still running or queued */
586 r = event_is_blocked(event);
587 if (r > 0)
588 continue;
589 if (r < 0)
590 log_device_warning_errno(event->dev, r,
591 "Failed to check dependencies for event (SEQNUM=%"PRIu64", ACTION=%s), "
592 "assuming there is no blocking event, ignoring: %m",
593 event->seqnum,
594 strna(device_action_to_string(event->action)));
595
596 r = event_run(event);
597 if (r <= 0) /* 0 means there are no idle workers. Let's escape from the loop. */
598 return r;
599 }
600
601 return 0;
602}
603
604static int on_event_retry(sd_event_source *s, uint64_t usec, void *userdata) {
605 /* This does nothing. The on_post() callback will start the event if there exists an idle worker. */
606 return 1;
607}
608
609static int event_requeue(Event *event) {
610 usec_t now_usec;
611 int r;
612
613 assert(event);
614 assert(event->manager);
615 assert(event->manager->event);
616
617 event->timeout_warning_event = sd_event_source_disable_unref(event->timeout_warning_event);
618 event->timeout_event = sd_event_source_disable_unref(event->timeout_event);
619
620 /* add a short delay to suppress busy loop */
621 r = sd_event_now(event->manager->event, CLOCK_BOOTTIME, &now_usec);
622 if (r < 0)
623 return log_device_warning_errno(event->dev, r,
624 "Failed to get current time, "
625 "skipping event (SEQNUM=%"PRIu64", ACTION=%s): %m",
626 event->seqnum, strna(device_action_to_string(event->action)));
627
628 if (event->retry_again_timeout_usec > 0 && event->retry_again_timeout_usec <= now_usec)
629 return log_device_warning_errno(event->dev, SYNTHETIC_ERRNO(ETIMEDOUT),
630 "The underlying block device is locked by a process more than %s, "
631 "skipping event (SEQNUM=%"PRIu64", ACTION=%s).",
632 FORMAT_TIMESPAN(EVENT_RETRY_TIMEOUT_USEC, USEC_PER_MINUTE),
633 event->seqnum, strna(device_action_to_string(event->action)));
634
635 event->retry_again_next_usec = usec_add(now_usec, EVENT_RETRY_INTERVAL_USEC);
636 if (event->retry_again_timeout_usec == 0)
637 event->retry_again_timeout_usec = usec_add(now_usec, EVENT_RETRY_TIMEOUT_USEC);
638
639 r = event_reset_time_relative(event->manager->event, &event->retry_event_source,
640 CLOCK_MONOTONIC, EVENT_RETRY_INTERVAL_USEC, 0,
641 on_event_retry, NULL,
642 0, "retry-event", true);
643 if (r < 0)
644 return log_device_warning_errno(event->dev, r, "Failed to reset timer event source for retrying event, "
645 "skipping event (SEQNUM=%"PRIu64", ACTION=%s): %m",
646 event->seqnum, strna(device_action_to_string(event->action)));
647
648 if (event->worker && event->worker->event == event)
649 event->worker->event = NULL;
650 event->worker = NULL;
651
652 event->state = EVENT_QUEUED;
653 return 0;
654}
655
656static int event_queue_assume_block_device_unlocked(Manager *manager, sd_device *dev) {
657 const char *devname;
658 int r;
659
660 /* When a new event for a block device is queued or we get an inotify event, assume that the
661 * device is not locked anymore. The assumption may not be true, but that should not cause any
662 * issues, as in that case events will be requeued soon. */
663
664 r = udev_get_whole_disk(dev, NULL, &devname);
665 if (r <= 0)
666 return r;
667
668 LIST_FOREACH(event, event, manager->events) {
669 const char *event_devname;
670
671 if (event->state != EVENT_QUEUED)
672 continue;
673
674 if (event->retry_again_next_usec == 0)
675 continue;
676
677 if (udev_get_whole_disk(event->dev, NULL, &event_devname) <= 0)
678 continue;
679
680 if (!streq(devname, event_devname))
681 continue;
682
683 event->retry_again_next_usec = 0;
684 }
685
686 return 0;
687}
688
689static int event_queue_insert(Manager *manager, sd_device *dev) {
690 const char *devpath, *devpath_old = NULL, *id = NULL, *devnode = NULL;
691 sd_device_action_t action;
692 uint64_t seqnum;
693 Event *event;
694 int r;
695
696 assert(manager);
697 assert(dev);
698
699 /* We only accepts devices received by device monitor. */
700 r = sd_device_get_seqnum(dev, &seqnum);
701 if (r < 0)
702 return r;
703
704 r = sd_device_get_action(dev, &action);
705 if (r < 0)
706 return r;
707
708 r = sd_device_get_devpath(dev, &devpath);
709 if (r < 0)
710 return r;
711
712 r = sd_device_get_property_value(dev, "DEVPATH_OLD", &devpath_old);
713 if (r < 0 && r != -ENOENT)
714 return r;
715
716 r = device_get_device_id(dev, &id);
717 if (r < 0 && r != -ENOENT)
718 return r;
719
720 r = sd_device_get_devname(dev, &devnode);
721 if (r < 0 && r != -ENOENT)
722 return r;
723
724 event = new(Event, 1);
725 if (!event)
726 return -ENOMEM;
727
728 *event = (Event) {
729 .manager = manager,
730 .dev = sd_device_ref(dev),
731 .seqnum = seqnum,
732 .action = action,
733 .id = id,
734 .devpath = devpath,
735 .devpath_old = devpath_old,
736 .devnode = devnode,
737 .state = EVENT_QUEUED,
738 };
739
740 if (!manager->events) {
741 r = touch("/run/udev/queue");
742 if (r < 0)
743 log_warning_errno(r, "Failed to touch /run/udev/queue, ignoring: %m");
744 }
745
746 LIST_APPEND(event, manager->events, event);
747
748 log_device_uevent(dev, "Device is queued");
749
750 return 0;
751}
752
753static int on_uevent(sd_device_monitor *monitor, sd_device *dev, void *userdata) {
754 Manager *manager = ASSERT_PTR(userdata);
755 int r;
756
757 DEVICE_TRACE_POINT(kernel_uevent_received, dev);
758
759 device_ensure_usec_initialized(dev, NULL);
760
761 r = event_queue_insert(manager, dev);
762 if (r < 0) {
763 log_device_error_errno(dev, r, "Failed to insert device into event queue: %m");
764 return 1;
765 }
766
767 (void) event_queue_assume_block_device_unlocked(manager, dev);
768
769 return 1;
770}
771
772static int on_worker(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
773 Manager *manager = ASSERT_PTR(userdata);
774
775 for (;;) {
776 EventResult result;
777 struct iovec iovec = IOVEC_MAKE(&result, sizeof(result));
778 CMSG_BUFFER_TYPE(CMSG_SPACE(sizeof(struct ucred))) control;
779 struct msghdr msghdr = {
780 .msg_iov = &iovec,
781 .msg_iovlen = 1,
782 .msg_control = &control,
783 .msg_controllen = sizeof(control),
784 };
785 ssize_t size;
786 struct ucred *ucred;
787 Worker *worker;
788
789 size = recvmsg_safe(fd, &msghdr, MSG_DONTWAIT);
790 if (size == -EINTR)
791 continue;
792 if (size == -EAGAIN)
793 /* nothing more to read */
794 break;
795 if (size < 0)
796 return log_error_errno(size, "Failed to receive message: %m");
797
798 cmsg_close_all(&msghdr);
799
800 if (size != sizeof(result)) {
801 log_warning("Ignoring worker message with invalid size %zi bytes", size);
802 continue;
803 }
804
805 ucred = CMSG_FIND_DATA(&msghdr, SOL_SOCKET, SCM_CREDENTIALS, struct ucred);
806 if (!ucred || ucred->pid <= 0) {
807 log_warning("Ignoring worker message without valid PID");
808 continue;
809 }
810
811 /* lookup worker who sent the signal */
812 worker = hashmap_get(manager->workers, PID_TO_PTR(ucred->pid));
813 if (!worker) {
814 log_debug("Worker ["PID_FMT"] returned, but is no longer tracked", ucred->pid);
815 continue;
816 }
817
818 if (worker->state == WORKER_KILLING) {
819 worker->state = WORKER_KILLED;
820 (void) kill(worker->pid, SIGTERM);
821 } else if (worker->state != WORKER_KILLED)
822 worker->state = WORKER_IDLE;
823
824 /* worker returned */
825 if (result == EVENT_RESULT_TRY_AGAIN &&
826 event_requeue(worker->event) < 0)
827 udev_broadcast_result(manager->monitor, worker->event->dev, -ETIMEDOUT);
828
829 /* When event_requeue() succeeds, worker->event is NULL, and event_free() handles NULL gracefully. */
830 event_free(worker->event);
831 }
832
833 return 1;
834}
835
ce5ddbc4
YW
836static void manager_set_default_children_max(Manager *manager) {
837 uint64_t cpu_limit, mem_limit, cpu_count = 1;
838 int r;
839
840 assert(manager);
841
842 if (manager->children_max != 0)
843 return;
844
845 r = cpus_in_affinity_mask();
846 if (r < 0)
847 log_warning_errno(r, "Failed to determine number of local CPUs, ignoring: %m");
848 else
849 cpu_count = r;
850
851 cpu_limit = cpu_count * 2 + 16;
852 mem_limit = MAX(physical_memory() / (128*1024*1024), UINT64_C(10));
853
854 manager->children_max = MIN3(cpu_limit, mem_limit, WORKER_NUM_MAX);
855 log_debug("Set children_max to %u", manager->children_max);
856}
857
81c32b1d
YW
858/* receive the udevd message from userspace */
859static int on_ctrl_msg(UdevCtrl *uctrl, UdevCtrlMessageType type, const UdevCtrlMessageValue *value, void *userdata) {
860 Manager *manager = ASSERT_PTR(userdata);
861 int r;
862
863 assert(value);
864
865 switch (type) {
866 case UDEV_CTRL_SET_LOG_LEVEL:
867 if ((value->intval & LOG_PRIMASK) != value->intval) {
868 log_debug("Received invalid udev control message (SET_LOG_LEVEL, %i), ignoring.", value->intval);
869 break;
870 }
871
872 log_debug("Received udev control message (SET_LOG_LEVEL), setting log_level=%i", value->intval);
873
874 r = log_get_max_level();
875 if (r == value->intval)
876 break;
877
878 log_set_max_level(value->intval);
879 manager->log_level = value->intval;
880 manager_kill_workers(manager, false);
881 break;
882 case UDEV_CTRL_STOP_EXEC_QUEUE:
883 log_debug("Received udev control message (STOP_EXEC_QUEUE)");
884 manager->stop_exec_queue = true;
885 break;
886 case UDEV_CTRL_START_EXEC_QUEUE:
887 log_debug("Received udev control message (START_EXEC_QUEUE)");
888 manager->stop_exec_queue = false;
889 /* It is not necessary to call event_queue_start() here, as it will be called in on_post() if necessary. */
890 break;
891 case UDEV_CTRL_RELOAD:
892 log_debug("Received udev control message (RELOAD)");
893 manager_reload(manager, /* force = */ true);
894 break;
895 case UDEV_CTRL_SET_ENV: {
896 _unused_ _cleanup_free_ char *old_val = NULL;
897 _cleanup_free_ char *key = NULL, *val = NULL, *old_key = NULL;
898 const char *eq;
899
900 eq = strchr(value->buf, '=');
901 if (!eq) {
902 log_error("Invalid key format '%s'", value->buf);
903 return 1;
904 }
905
906 key = strndup(value->buf, eq - value->buf);
907 if (!key) {
908 log_oom();
909 return 1;
910 }
911
912 old_val = hashmap_remove2(manager->properties, key, (void **) &old_key);
913
914 r = hashmap_ensure_allocated(&manager->properties, &string_hash_ops);
915 if (r < 0) {
916 log_oom();
917 return 1;
918 }
919
920 eq++;
921 if (isempty(eq)) {
922 log_debug("Received udev control message (ENV), unsetting '%s'", key);
923
924 r = hashmap_put(manager->properties, key, NULL);
925 if (r < 0) {
926 log_oom();
927 return 1;
928 }
929 } else {
930 val = strdup(eq);
931 if (!val) {
932 log_oom();
933 return 1;
934 }
935
936 log_debug("Received udev control message (ENV), setting '%s=%s'", key, val);
937
938 r = hashmap_put(manager->properties, key, val);
939 if (r < 0) {
940 log_oom();
941 return 1;
942 }
943 }
944
945 key = val = NULL;
946 manager_kill_workers(manager, false);
947 break;
948 }
949 case UDEV_CTRL_SET_CHILDREN_MAX:
2cba1d37 950 if (value->intval < 0) {
81c32b1d
YW
951 log_debug("Received invalid udev control message (SET_MAX_CHILDREN, %i), ignoring.", value->intval);
952 return 0;
953 }
954
955 log_debug("Received udev control message (SET_MAX_CHILDREN), setting children_max=%i", value->intval);
956 manager->children_max = value->intval;
957
2cba1d37
YW
958 /* When 0 is specified, determine the maximum based on the system resources. */
959 manager_set_default_children_max(manager);
960
81c32b1d
YW
961 notify_ready(manager);
962 break;
963 case UDEV_CTRL_PING:
964 log_debug("Received udev control message (PING)");
965 break;
966 case UDEV_CTRL_EXIT:
967 log_debug("Received udev control message (EXIT)");
968 manager_exit(manager);
969 break;
970 default:
971 log_debug("Received unknown udev control message, ignoring");
972 }
973
974 return 1;
975}
976
977static int synthesize_change_one(sd_device *dev, sd_device *target) {
978 int r;
979
980 if (DEBUG_LOGGING) {
981 const char *syspath = NULL;
982 (void) sd_device_get_syspath(target, &syspath);
983 log_device_debug(dev, "device is closed, synthesising 'change' on %s", strna(syspath));
984 }
985
986 r = sd_device_trigger(target, SD_DEVICE_CHANGE);
987 if (r < 0)
988 return log_device_debug_errno(target, r, "Failed to trigger 'change' uevent: %m");
989
990 DEVICE_TRACE_POINT(synthetic_change_event, dev);
991
992 return 0;
993}
994
995static int synthesize_change(sd_device *dev) {
996 _cleanup_(sd_device_enumerator_unrefp) sd_device_enumerator *e = NULL;
997 bool part_table_read;
998 const char *sysname;
999 int r, k;
1000
1001 r = sd_device_get_sysname(dev, &sysname);
1002 if (r < 0)
1003 return r;
1004
1005 if (startswith(sysname, "dm-") || block_device_is_whole_disk(dev) <= 0)
1006 return synthesize_change_one(dev, dev);
1007
1008 r = blockdev_reread_partition_table(dev);
1009 if (r < 0)
1010 log_device_debug_errno(dev, r, "Failed to re-read partition table, ignoring: %m");
1011 part_table_read = r >= 0;
1012
1013 /* search for partitions */
1014 r = partition_enumerator_new(dev, &e);
1015 if (r < 0)
1016 return r;
1017
1018 /* We have partitions and re-read the table, the kernel already sent out a "change"
1019 * event for the disk, and "remove/add" for all partitions. */
1020 if (part_table_read && sd_device_enumerator_get_device_first(e))
1021 return 0;
1022
1023 /* We have partitions but re-reading the partition table did not work, synthesize
1024 * "change" for the disk and all partitions. */
1025 r = synthesize_change_one(dev, dev);
1026 FOREACH_DEVICE(e, d) {
1027 k = synthesize_change_one(dev, d);
1028 if (k < 0 && r >= 0)
1029 r = k;
1030 }
1031
1032 return r;
1033}
1034
1035static int on_inotify(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
1036 Manager *manager = ASSERT_PTR(userdata);
1037 union inotify_event_buffer buffer;
1038 ssize_t l;
1039 int r;
1040
1041 l = read(fd, &buffer, sizeof(buffer));
1042 if (l < 0) {
1043 if (ERRNO_IS_TRANSIENT(errno))
1044 return 0;
1045
1046 return log_error_errno(errno, "Failed to read inotify fd: %m");
1047 }
1048
1049 FOREACH_INOTIFY_EVENT_WARN(e, buffer, l) {
1050 _cleanup_(sd_device_unrefp) sd_device *dev = NULL;
1051 const char *devnode;
1052
1053 /* Do not handle IN_IGNORED here. Especially, do not try to call udev_watch_end() from the
1054 * main process. Otherwise, the pair of the symlinks may become inconsistent, and several
1055 * garbage may remain. The old symlinks are removed by a worker that processes the
1056 * corresponding 'remove' uevent;
1057 * udev_event_execute_rules() -> event_execute_rules_on_remove() -> udev_watch_end(). */
1058
1059 if (!FLAGS_SET(e->mask, IN_CLOSE_WRITE))
1060 continue;
1061
1062 r = device_new_from_watch_handle(&dev, e->wd);
1063 if (r < 0) {
1064 /* Device may be removed just after closed. */
1065 log_debug_errno(r, "Failed to create sd_device object from watch handle, ignoring: %m");
1066 continue;
1067 }
1068
1069 r = sd_device_get_devname(dev, &devnode);
1070 if (r < 0) {
1071 /* Also here, device may be already removed. */
1072 log_device_debug_errno(dev, r, "Failed to get device node, ignoring: %m");
1073 continue;
1074 }
1075
1076 log_device_debug(dev, "Received inotify event for %s.", devnode);
1077
1078 (void) event_queue_assume_block_device_unlocked(manager, dev);
1079 (void) synthesize_change(dev);
1080 }
1081
1082 return 0;
1083}
1084
1085static int on_sigterm(sd_event_source *s, const struct signalfd_siginfo *si, void *userdata) {
1086 Manager *manager = ASSERT_PTR(userdata);
1087
1088 manager_exit(manager);
1089
1090 return 1;
1091}
1092
1093static int on_sighup(sd_event_source *s, const struct signalfd_siginfo *si, void *userdata) {
1094 Manager *manager = ASSERT_PTR(userdata);
1095
1096 manager_reload(manager, /* force = */ true);
1097
1098 return 1;
1099}
1100
1101static int on_sigchld(sd_event_source *s, const siginfo_t *si, void *userdata) {
1102 Worker *worker = ASSERT_PTR(userdata);
1103 Manager *manager = ASSERT_PTR(worker->manager);
1104 sd_device *dev = worker->event ? ASSERT_PTR(worker->event->dev) : NULL;
1105 EventResult result;
1106
1107 assert(si);
1108
1109 switch (si->si_code) {
1110 case CLD_EXITED:
1111 if (si->si_status == 0)
1112 log_device_debug(dev, "Worker ["PID_FMT"] exited.", si->si_pid);
1113 else
1114 log_device_warning(dev, "Worker ["PID_FMT"] exited with return code %i.",
1115 si->si_pid, si->si_status);
1116 result = EVENT_RESULT_EXIT_STATUS_BASE + si->si_status;
1117 break;
1118
1119 case CLD_KILLED:
1120 case CLD_DUMPED:
1121 log_device_warning(dev, "Worker ["PID_FMT"] terminated by signal %i (%s).",
1122 si->si_pid, si->si_status, signal_to_string(si->si_status));
1123 result = EVENT_RESULT_SIGNAL_BASE + si->si_status;
1124 break;
1125
1126 default:
1127 assert_not_reached();
1128 }
1129
1130 if (result != EVENT_RESULT_SUCCESS && dev) {
1131 /* delete state from disk */
1132 device_delete_db(dev);
1133 device_tag_index(dev, NULL, false);
1134
1135 /* Forward kernel event to libudev listeners */
1136 udev_broadcast_result(manager->monitor, dev, result);
1137 }
1138
1139 worker_free(worker);
1140
1141 return 1;
1142}
1143
1144static int on_post(sd_event_source *s, void *userdata) {
1145 Manager *manager = ASSERT_PTR(userdata);
1146
1147 if (manager->events) {
1148 /* Try to process pending events if idle workers exist. Why is this necessary?
1149 * When a worker finished an event and became idle, even if there was a pending event,
1150 * the corresponding device might have been locked and the processing of the event
1151 * delayed for a while, preventing the worker from processing the event immediately.
1152 * Now, the device may be unlocked. Let's try again! */
1153 event_queue_start(manager);
1154 return 1;
1155 }
1156
1157 /* There are no queued events. Let's remove /run/udev/queue and clean up the idle processes. */
1158
1159 if (unlink("/run/udev/queue") < 0) {
1160 if (errno != ENOENT)
1161 log_warning_errno(errno, "Failed to unlink /run/udev/queue, ignoring: %m");
1162 } else
1163 log_debug("No events are queued, removing /run/udev/queue.");
1164
1165 if (!hashmap_isempty(manager->workers)) {
1166 /* There are idle workers */
1167 (void) event_reset_time_relative(manager->event, &manager->kill_workers_event,
1168 CLOCK_MONOTONIC, 3 * USEC_PER_SEC, USEC_PER_SEC,
1169 on_kill_workers_event, manager,
1170 0, "kill-workers-event", false);
1171 return 1;
1172 }
1173
1174 /* There are no idle workers. */
1175
1176 if (manager->udev_node_needs_cleanup) {
1177 (void) udev_node_cleanup();
1178 manager->udev_node_needs_cleanup = false;
1179 }
1180
1181 if (manager->exit)
1182 return sd_event_exit(manager->event, 0);
1183
1184 if (manager->cgroup)
1185 /* cleanup possible left-over processes in our cgroup */
bd1791b5 1186 (void) cg_kill(manager->cgroup, SIGKILL, CGROUP_IGNORE_SELF, /* set=*/ NULL, /* kill_log= */ NULL, /* userdata= */ NULL);
81c32b1d
YW
1187
1188 return 1;
1189}
1190
1191Manager* manager_new(void) {
1192 Manager *manager;
1193
1194 manager = new(Manager, 1);
1195 if (!manager)
1196 return NULL;
1197
1198 *manager = (Manager) {
1199 .inotify_fd = -EBADF,
71136404 1200 .worker_watch = EBADF_PAIR,
81c32b1d
YW
1201 .log_level = LOG_INFO,
1202 .resolve_name_timing = RESOLVE_NAME_EARLY,
1203 .timeout_usec = 180 * USEC_PER_SEC,
1204 .timeout_signal = SIGKILL,
1205 };
1206
1207 return manager;
1208}
1209
1210int manager_init(Manager *manager, int fd_ctrl, int fd_uevent) {
1211 _cleanup_free_ char *cgroup = NULL;
1212 int r;
1213
1214 assert(manager);
1215
1216 r = udev_ctrl_new_from_fd(&manager->ctrl, fd_ctrl);
1217 if (r < 0)
1218 return log_error_errno(r, "Failed to initialize udev control socket: %m");
1219
1220 r = udev_ctrl_enable_receiving(manager->ctrl);
1221 if (r < 0)
1222 return log_error_errno(r, "Failed to bind udev control socket: %m");
1223
1224 r = device_monitor_new_full(&manager->monitor, MONITOR_GROUP_KERNEL, fd_uevent);
1225 if (r < 0)
1226 return log_error_errno(r, "Failed to initialize device monitor: %m");
1227
1228 /* Bump receiver buffer, but only if we are not called via socket activation, as in that
1229 * case systemd sets the receive buffer size for us, and the value in the .socket unit
1230 * should take full effect. */
1231 if (fd_uevent < 0) {
1232 r = sd_device_monitor_set_receive_buffer_size(manager->monitor, 128 * 1024 * 1024);
1233 if (r < 0)
1234 log_warning_errno(r, "Failed to set receive buffer size for device monitor, ignoring: %m");
1235 }
1236
1237 (void) sd_device_monitor_set_description(manager->monitor, "manager");
1238
1239 r = device_monitor_enable_receiving(manager->monitor);
1240 if (r < 0)
1241 return log_error_errno(r, "Failed to bind netlink socket: %m");
1242
1243 manager->log_level = log_get_max_level();
1244
1245 r = cg_pid_get_path(SYSTEMD_CGROUP_CONTROLLER, 0, &cgroup);
1246 if (r < 0)
1247 log_debug_errno(r, "Failed to get cgroup, ignoring: %m");
1248 else if (endswith(cgroup, "/udev")) { /* If we are in a subcgroup /udev/ we assume it was delegated to us */
1249 log_debug("Running in delegated subcgroup '%s'.", cgroup);
1250 manager->cgroup = TAKE_PTR(cgroup);
1251 }
1252
1253 return 0;
1254}
1255
1256int manager_main(Manager *manager) {
1257 int fd_worker, r;
1258
ce5ddbc4
YW
1259 manager_set_default_children_max(manager);
1260
81c32b1d
YW
1261 /* unnamed socket from workers to the main daemon */
1262 r = socketpair(AF_UNIX, SOCK_DGRAM|SOCK_CLOEXEC, 0, manager->worker_watch);
1263 if (r < 0)
1264 return log_error_errno(errno, "Failed to create socketpair for communicating with workers: %m");
1265
1266 fd_worker = manager->worker_watch[READ_END];
1267
1268 r = setsockopt_int(fd_worker, SOL_SOCKET, SO_PASSCRED, true);
1269 if (r < 0)
1270 return log_error_errno(r, "Failed to enable SO_PASSCRED: %m");
1271
1272 manager->inotify_fd = inotify_init1(IN_CLOEXEC);
1273 if (manager->inotify_fd < 0)
1274 return log_error_errno(errno, "Failed to create inotify descriptor: %m");
1275
1276 udev_watch_restore(manager->inotify_fd);
1277
1278 /* block and listen to all signals on signalfd */
1279 assert_se(sigprocmask_many(SIG_BLOCK, NULL, SIGTERM, SIGINT, SIGHUP, SIGCHLD, SIGRTMIN+18, -1) >= 0);
1280
1281 r = sd_event_default(&manager->event);
1282 if (r < 0)
1283 return log_error_errno(r, "Failed to allocate event loop: %m");
1284
1285 r = sd_event_add_signal(manager->event, NULL, SIGINT, on_sigterm, manager);
1286 if (r < 0)
1287 return log_error_errno(r, "Failed to create SIGINT event source: %m");
1288
1289 r = sd_event_add_signal(manager->event, NULL, SIGTERM, on_sigterm, manager);
1290 if (r < 0)
1291 return log_error_errno(r, "Failed to create SIGTERM event source: %m");
1292
1293 r = sd_event_add_signal(manager->event, NULL, SIGHUP, on_sighup, manager);
1294 if (r < 0)
1295 return log_error_errno(r, "Failed to create SIGHUP event source: %m");
1296
1297 r = sd_event_set_watchdog(manager->event, true);
1298 if (r < 0)
1299 return log_error_errno(r, "Failed to create watchdog event source: %m");
1300
1301 r = udev_ctrl_attach_event(manager->ctrl, manager->event);
1302 if (r < 0)
1303 return log_error_errno(r, "Failed to attach event to udev control: %m");
1304
1305 r = udev_ctrl_start(manager->ctrl, on_ctrl_msg, manager);
1306 if (r < 0)
1307 return log_error_errno(r, "Failed to start device monitor: %m");
1308
1309 /* This needs to be after the inotify and uevent handling, to make sure
1310 * that the ping is send back after fully processing the pending uevents
1311 * (including the synthetic ones we may create due to inotify events).
1312 */
1313 r = sd_event_source_set_priority(udev_ctrl_get_event_source(manager->ctrl), SD_EVENT_PRIORITY_IDLE);
1314 if (r < 0)
1315 return log_error_errno(r, "Failed to set IDLE event priority for udev control event source: %m");
1316
1317 r = sd_event_add_io(manager->event, &manager->inotify_event, manager->inotify_fd, EPOLLIN, on_inotify, manager);
1318 if (r < 0)
1319 return log_error_errno(r, "Failed to create inotify event source: %m");
1320
1321 r = sd_device_monitor_attach_event(manager->monitor, manager->event);
1322 if (r < 0)
1323 return log_error_errno(r, "Failed to attach event to device monitor: %m");
1324
1325 r = sd_device_monitor_start(manager->monitor, on_uevent, manager);
1326 if (r < 0)
1327 return log_error_errno(r, "Failed to start device monitor: %m");
1328
1329 r = sd_event_add_io(manager->event, NULL, fd_worker, EPOLLIN, on_worker, manager);
1330 if (r < 0)
1331 return log_error_errno(r, "Failed to create worker event source: %m");
1332
1333 r = sd_event_add_post(manager->event, NULL, on_post, manager);
1334 if (r < 0)
1335 return log_error_errno(r, "Failed to create post event source: %m");
1336
1337 /* Eventually, we probably want to do more here on memory pressure, for example, kill idle workers immediately */
1338 r = sd_event_add_memory_pressure(manager->event, &manager->memory_pressure_event_source, NULL, NULL);
1339 if (r < 0)
1340 log_full_errno(ERRNO_IS_NOT_SUPPORTED(r) || ERRNO_IS_PRIVILEGE(r) || (r == -EHOSTDOWN) ? LOG_DEBUG : LOG_WARNING, r,
1341 "Failed to allocate memory pressure watch, ignoring: %m");
1342
1343 r = sd_event_add_signal(manager->event, &manager->memory_pressure_event_source, SIGRTMIN+18, sigrtmin18_handler, NULL);
1344 if (r < 0)
1345 return log_error_errno(r, "Failed to allocate SIGRTMIN+18 event source, ignoring: %m");
1346
1347 manager->last_usec = now(CLOCK_MONOTONIC);
1348
1349 udev_builtin_init();
1350
1351 r = udev_rules_load(&manager->rules, manager->resolve_name_timing);
1352 if (r < 0)
1353 return log_error_errno(r, "Failed to read udev rules: %m");
1354
1355 r = udev_rules_apply_static_dev_perms(manager->rules);
1356 if (r < 0)
1357 log_warning_errno(r, "Failed to apply permissions on static device nodes, ignoring: %m");
1358
1359 notify_ready(manager);
1360
1361 r = sd_event_loop(manager->event);
1362 if (r < 0)
1363 log_error_errno(r, "Event loop failed: %m");
1364
1365 (void) sd_notify(/* unset= */ false, NOTIFY_STOPPING);
1366 return r;
1367}