]> git.ipfire.org Git - thirdparty/systemd.git/blob - src/libsystemd/sd-bus/sd-bus.c
projects / thirdparty / systemd.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
tree-wide: drop missing.h
[thirdparty/systemd.git] / src / libsystemd / sd-bus / sd-bus.c
1 /* SPDX-License-Identifier: LGPL-2.1+ */
2
3 #include <endian.h>
4 #include <netdb.h>
5 #include <poll.h>
6 #include <pthread.h>
7 #include <signal.h>
8 #include <stdlib.h>
9 #include <sys/mman.h>
10 #include <sys/stat.h>
11 #include <sys/wait.h>
12 #include <unistd.h>
13
14 #include "sd-bus.h"
15
16 #include "alloc-util.h"
17 #include "bus-container.h"
18 #include "bus-control.h"
19 #include "bus-internal.h"
20 #include "bus-kernel.h"
21 #include "bus-label.h"
22 #include "bus-message.h"
23 #include "bus-objects.h"
24 #include "bus-protocol.h"
25 #include "bus-slot.h"
26 #include "bus-socket.h"
27 #include "bus-track.h"
28 #include "bus-type.h"
29 #include "bus-util.h"
30 #include "cgroup-util.h"
31 #include "def.h"
32 #include "errno-util.h"
33 #include "fd-util.h"
34 #include "hexdecoct.h"
35 #include "hostname-util.h"
36 #include "macro.h"
37 #include "memory-util.h"
38 #include "missing_syscall.h"
39 #include "parse-util.h"
40 #include "path-util.h"
41 #include "process-util.h"
42 #include "string-util.h"
43 #include "strv.h"
44
45 #define log_debug_bus_message(m) \
46 do { \
47 sd_bus_message *_mm = (m); \
48 log_debug("Got message type=%s sender=%s destination=%s path=%s interface=%s member=%s cookie=%" PRIu64 " reply_cookie=%" PRIu64 " signature=%s error-name=%s error-message=%s", \
49 bus_message_type_to_string(_mm->header->type), \
50 strna(sd_bus_message_get_sender(_mm)), \
51 strna(sd_bus_message_get_destination(_mm)), \
52 strna(sd_bus_message_get_path(_mm)), \
53 strna(sd_bus_message_get_interface(_mm)), \
54 strna(sd_bus_message_get_member(_mm)), \
55 BUS_MESSAGE_COOKIE(_mm), \
56 _mm->reply_cookie, \
57 strna(_mm->root_container.signature), \
58 strna(_mm->error.name), \
59 strna(_mm->error.message)); \
60 } while (false)
61
62 static int bus_poll(sd_bus *bus, bool need_more, uint64_t timeout_usec);
63 static void bus_detach_io_events(sd_bus *b);
64 static void bus_detach_inotify_event(sd_bus *b);
65
66 static thread_local sd_bus *default_system_bus = NULL;
67 static thread_local sd_bus *default_user_bus = NULL;
68 static thread_local sd_bus *default_starter_bus = NULL;
69
70 static sd_bus **bus_choose_default(int (**bus_open)(sd_bus **)) {
71 const char *e;
72
73 /* Let's try our best to reuse another cached connection. If
74 * the starter bus type is set, connect via our normal
75 * connection logic, ignoring $DBUS_STARTER_ADDRESS, so that
76 * we can share the connection with the user/system default
77 * bus. */
78
79 e = secure_getenv("DBUS_STARTER_BUS_TYPE");
80 if (e) {
81 if (streq(e, "system")) {
82 if (bus_open)
83 *bus_open = sd_bus_open_system;
84 return &default_system_bus;
85 } else if (STR_IN_SET(e, "user", "session")) {
86 if (bus_open)
87 *bus_open = sd_bus_open_user;
88 return &default_user_bus;
89 }
90 }
91
92 /* No type is specified, so we have not other option than to
93 * use the starter address if it is set. */
94 e = secure_getenv("DBUS_STARTER_ADDRESS");
95 if (e) {
96 if (bus_open)
97 *bus_open = sd_bus_open;
98 return &default_starter_bus;
99 }
100
101 /* Finally, if nothing is set use the cached connection for
102 * the right scope */
103
104 if (cg_pid_get_owner_uid(0, NULL) >= 0) {
105 if (bus_open)
106 *bus_open = sd_bus_open_user;
107 return &default_user_bus;
108 } else {
109 if (bus_open)
110 *bus_open = sd_bus_open_system;
111 return &default_system_bus;
112 }
113 }
114
115 sd_bus *bus_resolve(sd_bus *bus) {
116 switch ((uintptr_t) bus) {
117 case (uintptr_t) SD_BUS_DEFAULT:
118 return *(bus_choose_default(NULL));
119 case (uintptr_t) SD_BUS_DEFAULT_USER:
120 return default_user_bus;
121 case (uintptr_t) SD_BUS_DEFAULT_SYSTEM:
122 return default_system_bus;
123 default:
124 return bus;
125 }
126 }
127
128 void bus_close_io_fds(sd_bus *b) {
129 assert(b);
130
131 bus_detach_io_events(b);
132
133 if (b->input_fd != b->output_fd)
134 safe_close(b->output_fd);
135 b->output_fd = b->input_fd = safe_close(b->input_fd);
136 }
137
138 void bus_close_inotify_fd(sd_bus *b) {
139 assert(b);
140
141 bus_detach_inotify_event(b);
142
143 b->inotify_fd = safe_close(b->inotify_fd);
144 b->inotify_watches = mfree(b->inotify_watches);
145 b->n_inotify_watches = 0;
146 }
147
148 static void bus_reset_queues(sd_bus *b) {
149 assert(b);
150
151 while (b->rqueue_size > 0)
152 bus_message_unref_queued(b->rqueue[--b->rqueue_size], b);
153
154 b->rqueue = mfree(b->rqueue);
155 b->rqueue_allocated = 0;
156
157 while (b->wqueue_size > 0)
158 bus_message_unref_queued(b->wqueue[--b->wqueue_size], b);
159
160 b->wqueue = mfree(b->wqueue);
161 b->wqueue_allocated = 0;
162 }
163
164 static sd_bus* bus_free(sd_bus *b) {
165 sd_bus_slot *s;
166
167 assert(b);
168 assert(!b->track_queue);
169 assert(!b->tracks);
170
171 b->state = BUS_CLOSED;
172
173 sd_bus_detach_event(b);
174
175 while ((s = b->slots)) {
176 /* At this point only floating slots can still be
177 * around, because the non-floating ones keep a
178 * reference to the bus, and we thus couldn't be
179 * destructing right now... We forcibly disconnect the
180 * slots here, so that they still can be referenced by
181 * apps, but are dead. */
182
183 assert(s->floating);
184 bus_slot_disconnect(s, true);
185 }
186
187 if (b->default_bus_ptr)
188 *b->default_bus_ptr = NULL;
189
190 bus_close_io_fds(b);
191 bus_close_inotify_fd(b);
192
193 free(b->label);
194 free(b->groups);
195 free(b->rbuffer);
196 free(b->unique_name);
197 free(b->auth_buffer);
198 free(b->address);
199 free(b->machine);
200 free(b->description);
201 free(b->patch_sender);
202
203 free(b->exec_path);
204 strv_free(b->exec_argv);
205
206 close_many(b->fds, b->n_fds);
207 free(b->fds);
208
209 bus_reset_queues(b);
210
211 ordered_hashmap_free_free(b->reply_callbacks);
212 prioq_free(b->reply_callbacks_prioq);
213
214 assert(b->match_callbacks.type == BUS_MATCH_ROOT);
215 bus_match_free(&b->match_callbacks);
216
217 hashmap_free_free(b->vtable_methods);
218 hashmap_free_free(b->vtable_properties);
219
220 assert(hashmap_isempty(b->nodes));
221 hashmap_free(b->nodes);
222
223 bus_flush_memfd(b);
224
225 assert_se(pthread_mutex_destroy(&b->memfd_cache_mutex) == 0);
226
227 return mfree(b);
228 }
229
230 DEFINE_TRIVIAL_CLEANUP_FUNC(sd_bus*, bus_free);
231
232 _public_ int sd_bus_new(sd_bus **ret) {
233 _cleanup_free_ sd_bus *b = NULL;
234
235 assert_return(ret, -EINVAL);
236
237 b = new(sd_bus, 1);
238 if (!b)
239 return -ENOMEM;
240
241 *b = (sd_bus) {
242 .n_ref = 1,
243 .input_fd = -1,
244 .output_fd = -1,
245 .inotify_fd = -1,
246 .message_version = 1,
247 .creds_mask = SD_BUS_CREDS_WELL_KNOWN_NAMES|SD_BUS_CREDS_UNIQUE_NAME,
248 .accept_fd = true,
249 .original_pid = getpid_cached(),
250 .n_groups = (size_t) -1,
251 .close_on_exit = true,
252 };
253
254 /* We guarantee that wqueue always has space for at least one entry */
255 if (!GREEDY_REALLOC(b->wqueue, b->wqueue_allocated, 1))
256 return -ENOMEM;
257
258 assert_se(pthread_mutex_init(&b->memfd_cache_mutex, NULL) == 0);
259
260 *ret = TAKE_PTR(b);
261 return 0;
262 }
263
264 _public_ int sd_bus_set_address(sd_bus *bus, const char *address) {
265 assert_return(bus, -EINVAL);
266 assert_return(bus = bus_resolve(bus), -ENOPKG);
267 assert_return(bus->state == BUS_UNSET, -EPERM);
268 assert_return(address, -EINVAL);
269 assert_return(!bus_pid_changed(bus), -ECHILD);
270
271 return free_and_strdup(&bus->address, address);
272 }
273
274 _public_ int sd_bus_set_fd(sd_bus *bus, int input_fd, int output_fd) {
275 assert_return(bus, -EINVAL);
276 assert_return(bus = bus_resolve(bus), -ENOPKG);
277 assert_return(bus->state == BUS_UNSET, -EPERM);
278 assert_return(input_fd >= 0, -EBADF);
279 assert_return(output_fd >= 0, -EBADF);
280 assert_return(!bus_pid_changed(bus), -ECHILD);
281
282 bus->input_fd = input_fd;
283 bus->output_fd = output_fd;
284 return 0;
285 }
286
287 _public_ int sd_bus_set_exec(sd_bus *bus, const char *path, char *const argv[]) {
288 _cleanup_strv_free_ char **a = NULL;
289 int r;
290
291 assert_return(bus, -EINVAL);
292 assert_return(bus = bus_resolve(bus), -ENOPKG);
293 assert_return(bus->state == BUS_UNSET, -EPERM);
294 assert_return(path, -EINVAL);
295 assert_return(!strv_isempty(argv), -EINVAL);
296 assert_return(!bus_pid_changed(bus), -ECHILD);
297
298 a = strv_copy(argv);
299 if (!a)
300 return -ENOMEM;
301
302 r = free_and_strdup(&bus->exec_path, path);
303 if (r < 0)
304 return r;
305
306 return strv_free_and_replace(bus->exec_argv, a);
307 }
308
309 _public_ int sd_bus_set_bus_client(sd_bus *bus, int b) {
310 assert_return(bus, -EINVAL);
311 assert_return(bus = bus_resolve(bus), -ENOPKG);
312 assert_return(bus->state == BUS_UNSET, -EPERM);
313 assert_return(!bus->patch_sender, -EPERM);
314 assert_return(!bus_pid_changed(bus), -ECHILD);
315
316 bus->bus_client = !!b;
317 return 0;
318 }
319
320 _public_ int sd_bus_set_monitor(sd_bus *bus, int b) {
321 assert_return(bus, -EINVAL);
322 assert_return(bus = bus_resolve(bus), -ENOPKG);
323 assert_return(bus->state == BUS_UNSET, -EPERM);
324 assert_return(!bus_pid_changed(bus), -ECHILD);
325
326 bus->is_monitor = !!b;
327 return 0;
328 }
329
330 _public_ int sd_bus_negotiate_fds(sd_bus *bus, int b) {
331 assert_return(bus, -EINVAL);
332 assert_return(bus = bus_resolve(bus), -ENOPKG);
333 assert_return(bus->state == BUS_UNSET, -EPERM);
334 assert_return(!bus_pid_changed(bus), -ECHILD);
335
336 bus->accept_fd = !!b;
337 return 0;
338 }
339
340 _public_ int sd_bus_negotiate_timestamp(sd_bus *bus, int b) {
341 assert_return(bus, -EINVAL);
342 assert_return(bus = bus_resolve(bus), -ENOPKG);
343 assert_return(!IN_SET(bus->state, BUS_CLOSING, BUS_CLOSED), -EPERM);
344 assert_return(!bus_pid_changed(bus), -ECHILD);
345
346 /* This is not actually supported by any of our transports these days, but we do honour it for synthetic
347 * replies, and maybe one day classic D-Bus learns this too */
348 bus->attach_timestamp = !!b;
349
350 return 0;
351 }
352
353 _public_ int sd_bus_negotiate_creds(sd_bus *bus, int b, uint64_t mask) {
354 assert_return(bus, -EINVAL);
355 assert_return(bus = bus_resolve(bus), -ENOPKG);
356 assert_return(mask <= _SD_BUS_CREDS_ALL, -EINVAL);
357 assert_return(!IN_SET(bus->state, BUS_CLOSING, BUS_CLOSED), -EPERM);
358 assert_return(!bus_pid_changed(bus), -ECHILD);
359
360 SET_FLAG(bus->creds_mask, mask, b);
361
362 /* The well knowns we need unconditionally, so that matches can work */
363 bus->creds_mask |= SD_BUS_CREDS_WELL_KNOWN_NAMES|SD_BUS_CREDS_UNIQUE_NAME;
364
365 return 0;
366 }
367
368 _public_ int sd_bus_set_server(sd_bus *bus, int b, sd_id128_t server_id) {
369 assert_return(bus, -EINVAL);
370 assert_return(bus = bus_resolve(bus), -ENOPKG);
371 assert_return(b || sd_id128_equal(server_id, SD_ID128_NULL), -EINVAL);
372 assert_return(bus->state == BUS_UNSET, -EPERM);
373 assert_return(!bus_pid_changed(bus), -ECHILD);
374
375 bus->is_server = !!b;
376 bus->server_id = server_id;
377 return 0;
378 }
379
380 _public_ int sd_bus_set_anonymous(sd_bus *bus, int b) {
381 assert_return(bus, -EINVAL);
382 assert_return(bus = bus_resolve(bus), -ENOPKG);
383 assert_return(bus->state == BUS_UNSET, -EPERM);
384 assert_return(!bus_pid_changed(bus), -ECHILD);
385
386 bus->anonymous_auth = !!b;
387 return 0;
388 }
389
390 _public_ int sd_bus_set_trusted(sd_bus *bus, int b) {
391 assert_return(bus, -EINVAL);
392 assert_return(bus = bus_resolve(bus), -ENOPKG);
393 assert_return(bus->state == BUS_UNSET, -EPERM);
394 assert_return(!bus_pid_changed(bus), -ECHILD);
395
396 bus->trusted = !!b;
397 return 0;
398 }
399
400 _public_ int sd_bus_set_description(sd_bus *bus, const char *description) {
401 assert_return(bus, -EINVAL);
402 assert_return(bus = bus_resolve(bus), -ENOPKG);
403 assert_return(bus->state == BUS_UNSET, -EPERM);
404 assert_return(!bus_pid_changed(bus), -ECHILD);
405
406 return free_and_strdup(&bus->description, description);
407 }
408
409 _public_ int sd_bus_set_allow_interactive_authorization(sd_bus *bus, int b) {
410 assert_return(bus, -EINVAL);
411 assert_return(bus = bus_resolve(bus), -ENOPKG);
412 assert_return(!bus_pid_changed(bus), -ECHILD);
413
414 bus->allow_interactive_authorization = !!b;
415 return 0;
416 }
417
418 _public_ int sd_bus_get_allow_interactive_authorization(sd_bus *bus) {
419 assert_return(bus, -EINVAL);
420 assert_return(bus = bus_resolve(bus), -ENOPKG);
421 assert_return(!bus_pid_changed(bus), -ECHILD);
422
423 return bus->allow_interactive_authorization;
424 }
425
426 _public_ int sd_bus_set_watch_bind(sd_bus *bus, int b) {
427 assert_return(bus, -EINVAL);
428 assert_return(bus = bus_resolve(bus), -ENOPKG);
429 assert_return(bus->state == BUS_UNSET, -EPERM);
430 assert_return(!bus_pid_changed(bus), -ECHILD);
431
432 bus->watch_bind = !!b;
433 return 0;
434 }
435
436 _public_ int sd_bus_get_watch_bind(sd_bus *bus) {
437 assert_return(bus, -EINVAL);
438 assert_return(bus = bus_resolve(bus), -ENOPKG);
439 assert_return(!bus_pid_changed(bus), -ECHILD);
440
441 return bus->watch_bind;
442 }
443
444 _public_ int sd_bus_set_connected_signal(sd_bus *bus, int b) {
445 assert_return(bus, -EINVAL);
446 assert_return(bus = bus_resolve(bus), -ENOPKG);
447 assert_return(bus->state == BUS_UNSET, -EPERM);
448 assert_return(!bus_pid_changed(bus), -ECHILD);
449
450 bus->connected_signal = !!b;
451 return 0;
452 }
453
454 _public_ int sd_bus_get_connected_signal(sd_bus *bus) {
455 assert_return(bus, -EINVAL);
456 assert_return(bus = bus_resolve(bus), -ENOPKG);
457 assert_return(!bus_pid_changed(bus), -ECHILD);
458
459 return bus->connected_signal;
460 }
461
462 static int synthesize_connected_signal(sd_bus *bus) {
463 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
464 int r;
465
466 assert(bus);
467
468 /* If enabled, synthesizes a local "Connected" signal mirroring the local "Disconnected" signal. This is called
469 * whenever we fully established a connection, i.e. after the authorization phase, and after receiving the
470 * Hello() reply. Or in other words, whenever we enter BUS_RUNNING state.
471 *
472 * This is useful so that clients can start doing stuff whenever the connection is fully established in a way
473 * that works independently from whether we connected to a full bus or just a direct connection. */
474
475 if (!bus->connected_signal)
476 return 0;
477
478 r = sd_bus_message_new_signal(
479 bus,
480 &m,
481 "/org/freedesktop/DBus/Local",
482 "org.freedesktop.DBus.Local",
483 "Connected");
484 if (r < 0)
485 return r;
486
487 bus_message_set_sender_local(bus, m);
488 m->read_counter = ++bus->read_counter;
489
490 r = bus_seal_synthetic_message(bus, m);
491 if (r < 0)
492 return r;
493
494 r = bus_rqueue_make_room(bus);
495 if (r < 0)
496 return r;
497
498 /* Insert at the very front */
499 memmove(bus->rqueue + 1, bus->rqueue, sizeof(sd_bus_message*) * bus->rqueue_size);
500 bus->rqueue[0] = bus_message_ref_queued(m, bus);
501 bus->rqueue_size++;
502
503 return 0;
504 }
505
506 void bus_set_state(sd_bus *bus, enum bus_state state) {
507
508 static const char * const table[_BUS_STATE_MAX] = {
509 [BUS_UNSET] = "UNSET",
510 [BUS_WATCH_BIND] = "WATCH_BIND",
511 [BUS_OPENING] = "OPENING",
512 [BUS_AUTHENTICATING] = "AUTHENTICATING",
513 [BUS_HELLO] = "HELLO",
514 [BUS_RUNNING] = "RUNNING",
515 [BUS_CLOSING] = "CLOSING",
516 [BUS_CLOSED] = "CLOSED",
517 };
518
519 assert(bus);
520 assert(state < _BUS_STATE_MAX);
521
522 if (state == bus->state)
523 return;
524
525 log_debug("Bus %s: changing state %s → %s", strna(bus->description), table[bus->state], table[state]);
526 bus->state = state;
527 }
528
529 static int hello_callback(sd_bus_message *reply, void *userdata, sd_bus_error *error) {
530 const char *s;
531 sd_bus *bus;
532 int r;
533
534 assert(reply);
535 bus = reply->bus;
536 assert(bus);
537 assert(IN_SET(bus->state, BUS_HELLO, BUS_CLOSING));
538
539 r = sd_bus_message_get_errno(reply);
540 if (r > 0)
541 return -r;
542
543 r = sd_bus_message_read(reply, "s", &s);
544 if (r < 0)
545 return r;
546
547 if (!service_name_is_valid(s) || s[0] != ':')
548 return -EBADMSG;
549
550 r = free_and_strdup(&bus->unique_name, s);
551 if (r < 0)
552 return r;
553
554 if (bus->state == BUS_HELLO) {
555 bus_set_state(bus, BUS_RUNNING);
556
557 r = synthesize_connected_signal(bus);
558 if (r < 0)
559 return r;
560 }
561
562 return 1;
563 }
564
565 static int bus_send_hello(sd_bus *bus) {
566 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
567 int r;
568
569 assert(bus);
570
571 if (!bus->bus_client)
572 return 0;
573
574 r = sd_bus_message_new_method_call(
575 bus,
576 &m,
577 "org.freedesktop.DBus",
578 "/org/freedesktop/DBus",
579 "org.freedesktop.DBus",
580 "Hello");
581 if (r < 0)
582 return r;
583
584 return sd_bus_call_async(bus, NULL, m, hello_callback, NULL, 0);
585 }
586
587 int bus_start_running(sd_bus *bus) {
588 struct reply_callback *c;
589 Iterator i;
590 usec_t n;
591 int r;
592
593 assert(bus);
594 assert(bus->state < BUS_HELLO);
595
596 /* We start all method call timeouts when we enter BUS_HELLO or BUS_RUNNING mode. At this point let's convert
597 * all relative to absolute timestamps. Note that we do not reshuffle the reply callback priority queue since
598 * adding a fixed value to all entries should not alter the internal order. */
599
600 n = now(CLOCK_MONOTONIC);
601 ORDERED_HASHMAP_FOREACH(c, bus->reply_callbacks, i) {
602 if (c->timeout_usec == 0)
603 continue;
604
605 c->timeout_usec = usec_add(n, c->timeout_usec);
606 }
607
608 if (bus->bus_client) {
609 bus_set_state(bus, BUS_HELLO);
610 return 1;
611 }
612
613 bus_set_state(bus, BUS_RUNNING);
614
615 r = synthesize_connected_signal(bus);
616 if (r < 0)
617 return r;
618
619 return 1;
620 }
621
622 static int parse_address_key(const char **p, const char *key, char **value) {
623 size_t l, n = 0, allocated = 0;
624 _cleanup_free_ char *r = NULL;
625 const char *a;
626
627 assert(p);
628 assert(*p);
629 assert(value);
630
631 if (key) {
632 l = strlen(key);
633 if (strncmp(*p, key, l) != 0)
634 return 0;
635
636 if ((*p)[l] != '=')
637 return 0;
638
639 if (*value)
640 return -EINVAL;
641
642 a = *p + l + 1;
643 } else
644 a = *p;
645
646 while (!IN_SET(*a, ';', ',', 0)) {
647 char c;
648
649 if (*a == '%') {
650 int x, y;
651
652 x = unhexchar(a[1]);
653 if (x < 0)
654 return x;
655
656 y = unhexchar(a[2]);
657 if (y < 0)
658 return y;
659
660 c = (char) ((x << 4) | y);
661 a += 3;
662 } else {
663 c = *a;
664 a++;
665 }
666
667 if (!GREEDY_REALLOC(r, allocated, n + 2))
668 return -ENOMEM;
669
670 r[n++] = c;
671 }
672
673 if (!r) {
674 r = strdup("");
675 if (!r)
676 return -ENOMEM;
677 } else
678 r[n] = 0;
679
680 if (*a == ',')
681 a++;
682
683 *p = a;
684
685 free_and_replace(*value, r);
686
687 return 1;
688 }
689
690 static void skip_address_key(const char **p) {
691 assert(p);
692 assert(*p);
693
694 *p += strcspn(*p, ",");
695
696 if (**p == ',')
697 (*p)++;
698 }
699
700 static int parse_unix_address(sd_bus *b, const char **p, char **guid) {
701 _cleanup_free_ char *path = NULL, *abstract = NULL;
702 size_t l;
703 int r;
704
705 assert(b);
706 assert(p);
707 assert(*p);
708 assert(guid);
709
710 while (!IN_SET(**p, 0, ';')) {
711 r = parse_address_key(p, "guid", guid);
712 if (r < 0)
713 return r;
714 else if (r > 0)
715 continue;
716
717 r = parse_address_key(p, "path", &path);
718 if (r < 0)
719 return r;
720 else if (r > 0)
721 continue;
722
723 r = parse_address_key(p, "abstract", &abstract);
724 if (r < 0)
725 return r;
726 else if (r > 0)
727 continue;
728
729 skip_address_key(p);
730 }
731
732 if (!path && !abstract)
733 return -EINVAL;
734
735 if (path && abstract)
736 return -EINVAL;
737
738 if (path) {
739 l = strlen(path);
740 if (l >= sizeof(b->sockaddr.un.sun_path)) /* We insist on NUL termination */
741 return -E2BIG;
742
743 b->sockaddr.un = (struct sockaddr_un) {
744 .sun_family = AF_UNIX,
745 };
746
747 memcpy(b->sockaddr.un.sun_path, path, l);
748 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + l + 1;
749
750 } else {
751 assert(abstract);
752
753 l = strlen(abstract);
754 if (l >= sizeof(b->sockaddr.un.sun_path) - 1) /* We insist on NUL termination */
755 return -E2BIG;
756
757 b->sockaddr.un = (struct sockaddr_un) {
758 .sun_family = AF_UNIX,
759 };
760
761 memcpy(b->sockaddr.un.sun_path+1, abstract, l);
762 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + 1 + l;
763 }
764
765 b->is_local = true;
766
767 return 0;
768 }
769
770 static int parse_tcp_address(sd_bus *b, const char **p, char **guid) {
771 _cleanup_free_ char *host = NULL, *port = NULL, *family = NULL;
772 int r;
773 struct addrinfo *result, hints = {
774 .ai_socktype = SOCK_STREAM,
775 .ai_flags = AI_ADDRCONFIG,
776 };
777
778 assert(b);
779 assert(p);
780 assert(*p);
781 assert(guid);
782
783 while (!IN_SET(**p, 0, ';')) {
784 r = parse_address_key(p, "guid", guid);
785 if (r < 0)
786 return r;
787 else if (r > 0)
788 continue;
789
790 r = parse_address_key(p, "host", &host);
791 if (r < 0)
792 return r;
793 else if (r > 0)
794 continue;
795
796 r = parse_address_key(p, "port", &port);
797 if (r < 0)
798 return r;
799 else if (r > 0)
800 continue;
801
802 r = parse_address_key(p, "family", &family);
803 if (r < 0)
804 return r;
805 else if (r > 0)
806 continue;
807
808 skip_address_key(p);
809 }
810
811 if (!host || !port)
812 return -EINVAL;
813
814 if (family) {
815 if (streq(family, "ipv4"))
816 hints.ai_family = AF_INET;
817 else if (streq(family, "ipv6"))
818 hints.ai_family = AF_INET6;
819 else
820 return -EINVAL;
821 }
822
823 r = getaddrinfo(host, port, &hints, &result);
824 if (r == EAI_SYSTEM)
825 return -errno;
826 else if (r != 0)
827 return -EADDRNOTAVAIL;
828
829 memcpy(&b->sockaddr, result->ai_addr, result->ai_addrlen);
830 b->sockaddr_size = result->ai_addrlen;
831
832 freeaddrinfo(result);
833
834 b->is_local = false;
835
836 return 0;
837 }
838
839 static int parse_exec_address(sd_bus *b, const char **p, char **guid) {
840 char *path = NULL;
841 unsigned n_argv = 0, j;
842 char **argv = NULL;
843 size_t allocated = 0;
844 int r;
845
846 assert(b);
847 assert(p);
848 assert(*p);
849 assert(guid);
850
851 while (!IN_SET(**p, 0, ';')) {
852 r = parse_address_key(p, "guid", guid);
853 if (r < 0)
854 goto fail;
855 else if (r > 0)
856 continue;
857
858 r = parse_address_key(p, "path", &path);
859 if (r < 0)
860 goto fail;
861 else if (r > 0)
862 continue;
863
864 if (startswith(*p, "argv")) {
865 unsigned ul;
866
867 errno = 0;
868 ul = strtoul(*p + 4, (char**) p, 10);
869 if (errno > 0 || **p != '=' || ul > 256) {
870 r = -EINVAL;
871 goto fail;
872 }
873
874 (*p)++;
875
876 if (ul >= n_argv) {
877 if (!GREEDY_REALLOC0(argv, allocated, ul + 2)) {
878 r = -ENOMEM;
879 goto fail;
880 }
881
882 n_argv = ul + 1;
883 }
884
885 r = parse_address_key(p, NULL, argv + ul);
886 if (r < 0)
887 goto fail;
888
889 continue;
890 }
891
892 skip_address_key(p);
893 }
894
895 if (!path) {
896 r = -EINVAL;
897 goto fail;
898 }
899
900 /* Make sure there are no holes in the array, with the
901 * exception of argv[0] */
902 for (j = 1; j < n_argv; j++)
903 if (!argv[j]) {
904 r = -EINVAL;
905 goto fail;
906 }
907
908 if (argv && argv[0] == NULL) {
909 argv[0] = strdup(path);
910 if (!argv[0]) {
911 r = -ENOMEM;
912 goto fail;
913 }
914 }
915
916 b->exec_path = path;
917 b->exec_argv = argv;
918
919 b->is_local = false;
920
921 return 0;
922
923 fail:
924 for (j = 0; j < n_argv; j++)
925 free(argv[j]);
926
927 free(argv);
928 free(path);
929 return r;
930 }
931
932 static int parse_container_unix_address(sd_bus *b, const char **p, char **guid) {
933 _cleanup_free_ char *machine = NULL, *pid = NULL;
934 int r;
935
936 assert(b);
937 assert(p);
938 assert(*p);
939 assert(guid);
940
941 while (!IN_SET(**p, 0, ';')) {
942 r = parse_address_key(p, "guid", guid);
943 if (r < 0)
944 return r;
945 else if (r > 0)
946 continue;
947
948 r = parse_address_key(p, "machine", &machine);
949 if (r < 0)
950 return r;
951 else if (r > 0)
952 continue;
953
954 r = parse_address_key(p, "pid", &pid);
955 if (r < 0)
956 return r;
957 else if (r > 0)
958 continue;
959
960 skip_address_key(p);
961 }
962
963 if (!machine == !pid)
964 return -EINVAL;
965
966 if (machine) {
967 if (!streq(machine, ".host") && !machine_name_is_valid(machine))
968 return -EINVAL;
969
970 free_and_replace(b->machine, machine);
971 } else {
972 b->machine = mfree(b->machine);
973 }
974
975 if (pid) {
976 r = parse_pid(pid, &b->nspid);
977 if (r < 0)
978 return r;
979 } else
980 b->nspid = 0;
981
982 b->sockaddr.un = (struct sockaddr_un) {
983 .sun_family = AF_UNIX,
984 /* Note that we use the old /var/run prefix here, to increase compatibility with really old containers */
985 .sun_path = "/var/run/dbus/system_bus_socket",
986 };
987 b->sockaddr_size = SOCKADDR_UN_LEN(b->sockaddr.un);
988 b->is_local = false;
989
990 return 0;
991 }
992
993 static void bus_reset_parsed_address(sd_bus *b) {
994 assert(b);
995
996 zero(b->sockaddr);
997 b->sockaddr_size = 0;
998 b->exec_argv = strv_free(b->exec_argv);
999 b->exec_path = mfree(b->exec_path);
1000 b->server_id = SD_ID128_NULL;
1001 b->machine = mfree(b->machine);
1002 b->nspid = 0;
1003 }
1004
1005 static int bus_parse_next_address(sd_bus *b) {
1006 _cleanup_free_ char *guid = NULL;
1007 const char *a;
1008 int r;
1009
1010 assert(b);
1011
1012 if (!b->address)
1013 return 0;
1014 if (b->address[b->address_index] == 0)
1015 return 0;
1016
1017 bus_reset_parsed_address(b);
1018
1019 a = b->address + b->address_index;
1020
1021 while (*a != 0) {
1022
1023 if (*a == ';') {
1024 a++;
1025 continue;
1026 }
1027
1028 if (startswith(a, "unix:")) {
1029 a += 5;
1030
1031 r = parse_unix_address(b, &a, &guid);
1032 if (r < 0)
1033 return r;
1034 break;
1035
1036 } else if (startswith(a, "tcp:")) {
1037
1038 a += 4;
1039 r = parse_tcp_address(b, &a, &guid);
1040 if (r < 0)
1041 return r;
1042
1043 break;
1044
1045 } else if (startswith(a, "unixexec:")) {
1046
1047 a += 9;
1048 r = parse_exec_address(b, &a, &guid);
1049 if (r < 0)
1050 return r;
1051
1052 break;
1053
1054 } else if (startswith(a, "x-machine-unix:")) {
1055
1056 a += 15;
1057 r = parse_container_unix_address(b, &a, &guid);
1058 if (r < 0)
1059 return r;
1060
1061 break;
1062 }
1063
1064 a = strchr(a, ';');
1065 if (!a)
1066 return 0;
1067 }
1068
1069 if (guid) {
1070 r = sd_id128_from_string(guid, &b->server_id);
1071 if (r < 0)
1072 return r;
1073 }
1074
1075 b->address_index = a - b->address;
1076 return 1;
1077 }
1078
1079 static void bus_kill_exec(sd_bus *bus) {
1080 if (pid_is_valid(bus->busexec_pid) > 0) {
1081 sigterm_wait(bus->busexec_pid);
1082 bus->busexec_pid = 0;
1083 }
1084 }
1085
1086 static int bus_start_address(sd_bus *b) {
1087 int r;
1088
1089 assert(b);
1090
1091 for (;;) {
1092 bus_close_io_fds(b);
1093 bus_close_inotify_fd(b);
1094
1095 bus_kill_exec(b);
1096
1097 /* If you provide multiple different bus-addresses, we
1098 * try all of them in order and use the first one that
1099 * succeeds. */
1100
1101 if (b->exec_path)
1102 r = bus_socket_exec(b);
1103 else if ((b->nspid > 0 || b->machine) && b->sockaddr.sa.sa_family != AF_UNSPEC)
1104 r = bus_container_connect_socket(b);
1105 else if (b->sockaddr.sa.sa_family != AF_UNSPEC)
1106 r = bus_socket_connect(b);
1107 else
1108 goto next;
1109
1110 if (r >= 0) {
1111 int q;
1112
1113 q = bus_attach_io_events(b);
1114 if (q < 0)
1115 return q;
1116
1117 q = bus_attach_inotify_event(b);
1118 if (q < 0)
1119 return q;
1120
1121 return r;
1122 }
1123
1124 b->last_connect_error = -r;
1125
1126 next:
1127 r = bus_parse_next_address(b);
1128 if (r < 0)
1129 return r;
1130 if (r == 0)
1131 return b->last_connect_error > 0 ? -b->last_connect_error : -ECONNREFUSED;
1132 }
1133 }
1134
1135 int bus_next_address(sd_bus *b) {
1136 assert(b);
1137
1138 bus_reset_parsed_address(b);
1139 return bus_start_address(b);
1140 }
1141
1142 static int bus_start_fd(sd_bus *b) {
1143 struct stat st;
1144 int r;
1145
1146 assert(b);
1147 assert(b->input_fd >= 0);
1148 assert(b->output_fd >= 0);
1149
1150 r = fd_nonblock(b->input_fd, true);
1151 if (r < 0)
1152 return r;
1153
1154 r = fd_cloexec(b->input_fd, true);
1155 if (r < 0)
1156 return r;
1157
1158 if (b->input_fd != b->output_fd) {
1159 r = fd_nonblock(b->output_fd, true);
1160 if (r < 0)
1161 return r;
1162
1163 r = fd_cloexec(b->output_fd, true);
1164 if (r < 0)
1165 return r;
1166 }
1167
1168 if (fstat(b->input_fd, &st) < 0)
1169 return -errno;
1170
1171 return bus_socket_take_fd(b);
1172 }
1173
1174 _public_ int sd_bus_start(sd_bus *bus) {
1175 int r;
1176
1177 assert_return(bus, -EINVAL);
1178 assert_return(bus = bus_resolve(bus), -ENOPKG);
1179 assert_return(bus->state == BUS_UNSET, -EPERM);
1180 assert_return(!bus_pid_changed(bus), -ECHILD);
1181
1182 bus_set_state(bus, BUS_OPENING);
1183
1184 if (bus->is_server && bus->bus_client)
1185 return -EINVAL;
1186
1187 if (bus->input_fd >= 0)
1188 r = bus_start_fd(bus);
1189 else if (bus->address || bus->sockaddr.sa.sa_family != AF_UNSPEC || bus->exec_path || bus->machine)
1190 r = bus_start_address(bus);
1191 else
1192 return -EINVAL;
1193
1194 if (r < 0) {
1195 sd_bus_close(bus);
1196 return r;
1197 }
1198
1199 return bus_send_hello(bus);
1200 }
1201
1202 _public_ int sd_bus_open_with_description(sd_bus **ret, const char *description) {
1203 const char *e;
1204 _cleanup_(bus_freep) sd_bus *b = NULL;
1205 int r;
1206
1207 assert_return(ret, -EINVAL);
1208
1209 /* Let's connect to the starter bus if it is set, and
1210 * otherwise to the bus that is appropriate for the scope
1211 * we are running in */
1212
1213 e = secure_getenv("DBUS_STARTER_BUS_TYPE");
1214 if (e) {
1215 if (streq(e, "system"))
1216 return sd_bus_open_system_with_description(ret, description);
1217 else if (STR_IN_SET(e, "session", "user"))
1218 return sd_bus_open_user_with_description(ret, description);
1219 }
1220
1221 e = secure_getenv("DBUS_STARTER_ADDRESS");
1222 if (!e) {
1223 if (cg_pid_get_owner_uid(0, NULL) >= 0)
1224 return sd_bus_open_user_with_description(ret, description);
1225 else
1226 return sd_bus_open_system_with_description(ret, description);
1227 }
1228
1229 r = sd_bus_new(&b);
1230 if (r < 0)
1231 return r;
1232
1233 r = sd_bus_set_address(b, e);
1234 if (r < 0)
1235 return r;
1236
1237 b->bus_client = true;
1238
1239 /* We don't know whether the bus is trusted or not, so better
1240 * be safe, and authenticate everything */
1241 b->trusted = false;
1242 b->is_local = false;
1243 b->creds_mask |= SD_BUS_CREDS_UID | SD_BUS_CREDS_EUID | SD_BUS_CREDS_EFFECTIVE_CAPS;
1244
1245 r = sd_bus_start(b);
1246 if (r < 0)
1247 return r;
1248
1249 *ret = TAKE_PTR(b);
1250 return 0;
1251 }
1252
1253 _public_ int sd_bus_open(sd_bus **ret) {
1254 return sd_bus_open_with_description(ret, NULL);
1255 }
1256
1257 int bus_set_address_system(sd_bus *b) {
1258 const char *e;
1259 assert(b);
1260
1261 e = secure_getenv("DBUS_SYSTEM_BUS_ADDRESS");
1262 if (e)
1263 return sd_bus_set_address(b, e);
1264
1265 return sd_bus_set_address(b, DEFAULT_SYSTEM_BUS_ADDRESS);
1266 }
1267
1268 _public_ int sd_bus_open_system_with_description(sd_bus **ret, const char *description) {
1269 _cleanup_(bus_freep) sd_bus *b = NULL;
1270 int r;
1271
1272 assert_return(ret, -EINVAL);
1273
1274 r = sd_bus_new(&b);
1275 if (r < 0)
1276 return r;
1277
1278 if (description) {
1279 r = sd_bus_set_description(b, description);
1280 if (r < 0)
1281 return r;
1282 }
1283
1284 r = bus_set_address_system(b);
1285 if (r < 0)
1286 return r;
1287
1288 b->bus_client = true;
1289 b->is_system = true;
1290
1291 /* Let's do per-method access control on the system bus. We
1292 * need the caller's UID and capability set for that. */
1293 b->trusted = false;
1294 b->creds_mask |= SD_BUS_CREDS_UID | SD_BUS_CREDS_EUID | SD_BUS_CREDS_EFFECTIVE_CAPS;
1295 b->is_local = true;
1296
1297 r = sd_bus_start(b);
1298 if (r < 0)
1299 return r;
1300
1301 *ret = TAKE_PTR(b);
1302 return 0;
1303 }
1304
1305 _public_ int sd_bus_open_system(sd_bus **ret) {
1306 return sd_bus_open_system_with_description(ret, NULL);
1307 }
1308
1309 int bus_set_address_user(sd_bus *b) {
1310 const char *e;
1311 _cleanup_free_ char *ee = NULL, *s = NULL;
1312
1313 assert(b);
1314
1315 e = secure_getenv("DBUS_SESSION_BUS_ADDRESS");
1316 if (e)
1317 return sd_bus_set_address(b, e);
1318
1319 e = secure_getenv("XDG_RUNTIME_DIR");
1320 if (!e)
1321 return -ENOENT;
1322
1323 ee = bus_address_escape(e);
1324 if (!ee)
1325 return -ENOMEM;
1326
1327 if (asprintf(&s, DEFAULT_USER_BUS_ADDRESS_FMT, ee) < 0)
1328 return -ENOMEM;
1329
1330 b->address = TAKE_PTR(s);
1331
1332 return 0;
1333 }
1334
1335 _public_ int sd_bus_open_user_with_description(sd_bus **ret, const char *description) {
1336 _cleanup_(bus_freep) sd_bus *b = NULL;
1337 int r;
1338
1339 assert_return(ret, -EINVAL);
1340
1341 r = sd_bus_new(&b);
1342 if (r < 0)
1343 return r;
1344
1345 if (description) {
1346 r = sd_bus_set_description(b, description);
1347 if (r < 0)
1348 return r;
1349 }
1350
1351 r = bus_set_address_user(b);
1352 if (r < 0)
1353 return r;
1354
1355 b->bus_client = true;
1356 b->is_user = true;
1357
1358 /* We don't do any per-method access control on the user bus. */
1359 b->trusted = true;
1360 b->is_local = true;
1361
1362 r = sd_bus_start(b);
1363 if (r < 0)
1364 return r;
1365
1366 *ret = TAKE_PTR(b);
1367 return 0;
1368 }
1369
1370 _public_ int sd_bus_open_user(sd_bus **ret) {
1371 return sd_bus_open_user_with_description(ret, NULL);
1372 }
1373
1374 int bus_set_address_system_remote(sd_bus *b, const char *host) {
1375 _cleanup_free_ char *e = NULL;
1376 char *m = NULL, *c = NULL, *a, *rbracket = NULL, *p = NULL;
1377
1378 assert(b);
1379 assert(host);
1380
1381 /* Skip ":"s in ipv6 addresses */
1382 if (*host == '[') {
1383 char *t;
1384
1385 rbracket = strchr(host, ']');
1386 if (!rbracket)
1387 return -EINVAL;
1388 t = strndupa(host + 1, rbracket - host - 1);
1389 e = bus_address_escape(t);
1390 if (!e)
1391 return -ENOMEM;
1392 } else if ((a = strchr(host, '@'))) {
1393 if (*(a + 1) == '[') {
1394 _cleanup_free_ char *t = NULL;
1395
1396 rbracket = strchr(a + 1, ']');
1397 if (!rbracket)
1398 return -EINVAL;
1399 t = new0(char, strlen(host));
1400 if (!t)
1401 return -ENOMEM;
1402 strncat(t, host, a - host + 1);
1403 strncat(t, a + 2, rbracket - a - 2);
1404 e = bus_address_escape(t);
1405 if (!e)
1406 return -ENOMEM;
1407 } else if (*(a + 1) == '\0' || strchr(a + 1, '@'))
1408 return -EINVAL;
1409 }
1410
1411 /* Let's see if a port was given */
1412 m = strchr(rbracket ? rbracket + 1 : host, ':');
1413 if (m) {
1414 char *t;
1415 bool got_forward_slash = false;
1416
1417 p = m + 1;
1418
1419 t = strchr(p, '/');
1420 if (t) {
1421 p = strndupa(p, t - p);
1422 got_forward_slash = true;
1423 }
1424
1425 if (!in_charset(p, "0123456789") || *p == '\0') {
1426 if (!machine_name_is_valid(p) || got_forward_slash)
1427 return -EINVAL;
1428
1429 m = TAKE_PTR(p);
1430 goto interpret_port_as_machine_old_syntax;
1431 }
1432 }
1433
1434 /* Let's see if a machine was given */
1435 m = strchr(rbracket ? rbracket + 1 : host, '/');
1436 if (m) {
1437 m++;
1438 interpret_port_as_machine_old_syntax:
1439 /* Let's make sure this is not a port of some kind,
1440 * and is a valid machine name. */
1441 if (!in_charset(m, "0123456789") && machine_name_is_valid(m))
1442 c = strjoina(",argv", p ? "7" : "5", "=--machine=", m);
1443 }
1444
1445 if (!e) {
1446 char *t;
1447
1448 t = strndupa(host, strcspn(host, ":/"));
1449
1450 e = bus_address_escape(t);
1451 if (!e)
1452 return -ENOMEM;
1453 }
1454
1455 a = strjoin("unixexec:path=ssh,argv1=-xT", p ? ",argv2=-p,argv3=" : "", strempty(p),
1456 ",argv", p ? "4" : "2", "=--,argv", p ? "5" : "3", "=", e,
1457 ",argv", p ? "6" : "4", "=systemd-stdio-bridge", c);
1458 if (!a)
1459 return -ENOMEM;
1460
1461 return free_and_replace(b->address, a);
1462 }
1463
1464 _public_ int sd_bus_open_system_remote(sd_bus **ret, const char *host) {
1465 _cleanup_(bus_freep) sd_bus *b = NULL;
1466 int r;
1467
1468 assert_return(host, -EINVAL);
1469 assert_return(ret, -EINVAL);
1470
1471 r = sd_bus_new(&b);
1472 if (r < 0)
1473 return r;
1474
1475 r = bus_set_address_system_remote(b, host);
1476 if (r < 0)
1477 return r;
1478
1479 b->bus_client = true;
1480 b->trusted = false;
1481 b->is_system = true;
1482 b->is_local = false;
1483
1484 r = sd_bus_start(b);
1485 if (r < 0)
1486 return r;
1487
1488 *ret = TAKE_PTR(b);
1489 return 0;
1490 }
1491
1492 int bus_set_address_system_machine(sd_bus *b, const char *machine) {
1493 _cleanup_free_ char *e = NULL;
1494 char *a;
1495
1496 assert(b);
1497 assert(machine);
1498
1499 e = bus_address_escape(machine);
1500 if (!e)
1501 return -ENOMEM;
1502
1503 a = strjoin("x-machine-unix:machine=", e);
1504 if (!a)
1505 return -ENOMEM;
1506
1507 return free_and_replace(b->address, a);
1508 }
1509
1510 _public_ int sd_bus_open_system_machine(sd_bus **ret, const char *machine) {
1511 _cleanup_(bus_freep) sd_bus *b = NULL;
1512 int r;
1513
1514 assert_return(machine, -EINVAL);
1515 assert_return(ret, -EINVAL);
1516 assert_return(streq(machine, ".host") || machine_name_is_valid(machine), -EINVAL);
1517
1518 r = sd_bus_new(&b);
1519 if (r < 0)
1520 return r;
1521
1522 r = bus_set_address_system_machine(b, machine);
1523 if (r < 0)
1524 return r;
1525
1526 b->bus_client = true;
1527 b->trusted = false;
1528 b->is_system = true;
1529 b->is_local = false;
1530
1531 r = sd_bus_start(b);
1532 if (r < 0)
1533 return r;
1534
1535 *ret = TAKE_PTR(b);
1536 return 0;
1537 }
1538
1539 _public_ void sd_bus_close(sd_bus *bus) {
1540 if (!bus)
1541 return;
1542 if (bus->state == BUS_CLOSED)
1543 return;
1544 if (bus_pid_changed(bus))
1545 return;
1546
1547 /* Don't leave ssh hanging around */
1548 bus_kill_exec(bus);
1549
1550 bus_set_state(bus, BUS_CLOSED);
1551
1552 sd_bus_detach_event(bus);
1553
1554 /* Drop all queued messages so that they drop references to
1555 * the bus object and the bus may be freed */
1556 bus_reset_queues(bus);
1557
1558 bus_close_io_fds(bus);
1559 bus_close_inotify_fd(bus);
1560 }
1561
1562 _public_ sd_bus *sd_bus_close_unref(sd_bus *bus) {
1563 if (!bus)
1564 return NULL;
1565
1566 sd_bus_close(bus);
1567
1568 return sd_bus_unref(bus);
1569 }
1570
1571 _public_ sd_bus* sd_bus_flush_close_unref(sd_bus *bus) {
1572 if (!bus)
1573 return NULL;
1574
1575 /* Have to do this before flush() to prevent hang */
1576 bus_kill_exec(bus);
1577 sd_bus_flush(bus);
1578
1579 return sd_bus_close_unref(bus);
1580 }
1581
1582 void bus_enter_closing(sd_bus *bus) {
1583 assert(bus);
1584
1585 if (!IN_SET(bus->state, BUS_WATCH_BIND, BUS_OPENING, BUS_AUTHENTICATING, BUS_HELLO, BUS_RUNNING))
1586 return;
1587
1588 bus_set_state(bus, BUS_CLOSING);
1589 }
1590
1591 DEFINE_PUBLIC_TRIVIAL_REF_UNREF_FUNC(sd_bus, sd_bus, bus_free);
1592
1593 _public_ int sd_bus_is_open(sd_bus *bus) {
1594 assert_return(bus, -EINVAL);
1595 assert_return(bus = bus_resolve(bus), -ENOPKG);
1596 assert_return(!bus_pid_changed(bus), -ECHILD);
1597
1598 return BUS_IS_OPEN(bus->state);
1599 }
1600
1601 _public_ int sd_bus_is_ready(sd_bus *bus) {
1602 assert_return(bus, -EINVAL);
1603 assert_return(bus = bus_resolve(bus), -ENOPKG);
1604 assert_return(!bus_pid_changed(bus), -ECHILD);
1605
1606 return bus->state == BUS_RUNNING;
1607 }
1608
1609 _public_ int sd_bus_can_send(sd_bus *bus, char type) {
1610 int r;
1611
1612 assert_return(bus, -EINVAL);
1613 assert_return(bus = bus_resolve(bus), -ENOPKG);
1614 assert_return(bus->state != BUS_UNSET, -ENOTCONN);
1615 assert_return(!bus_pid_changed(bus), -ECHILD);
1616
1617 if (bus->is_monitor)
1618 return 0;
1619
1620 if (type == SD_BUS_TYPE_UNIX_FD) {
1621 if (!bus->accept_fd)
1622 return 0;
1623
1624 r = bus_ensure_running(bus);
1625 if (r < 0)
1626 return r;
1627
1628 return bus->can_fds;
1629 }
1630
1631 return bus_type_is_valid(type);
1632 }
1633
1634 _public_ int sd_bus_get_bus_id(sd_bus *bus, sd_id128_t *id) {
1635 int r;
1636
1637 assert_return(bus, -EINVAL);
1638 assert_return(bus = bus_resolve(bus), -ENOPKG);
1639 assert_return(id, -EINVAL);
1640 assert_return(!bus_pid_changed(bus), -ECHILD);
1641
1642 r = bus_ensure_running(bus);
1643 if (r < 0)
1644 return r;
1645
1646 *id = bus->server_id;
1647 return 0;
1648 }
1649
1650 #define COOKIE_CYCLED (UINT32_C(1) << 31)
1651
1652 static uint64_t cookie_inc(uint64_t cookie) {
1653
1654 /* Stay within the 32bit range, since classic D-Bus can't deal with more */
1655 if (cookie >= UINT32_MAX)
1656 return COOKIE_CYCLED; /* Don't go back to zero, but use the highest bit for checking
1657 * whether we are looping. */
1658
1659 return cookie + 1;
1660 }
1661
1662 static int next_cookie(sd_bus *b) {
1663 uint64_t new_cookie;
1664
1665 assert(b);
1666
1667 new_cookie = cookie_inc(b->cookie);
1668
1669 /* Small optimization: don't bother with checking for cookie reuse until we overran cookiespace at
1670 * least once, but then do it thorougly. */
1671 if (FLAGS_SET(new_cookie, COOKIE_CYCLED)) {
1672 uint32_t i;
1673
1674 /* Check if the cookie is currently in use. If so, pick the next one */
1675 for (i = 0; i < COOKIE_CYCLED; i++) {
1676 if (!ordered_hashmap_contains(b->reply_callbacks, &new_cookie))
1677 goto good;
1678
1679 new_cookie = cookie_inc(new_cookie);
1680 }
1681
1682 /* Can't fulfill request */
1683 return -EBUSY;
1684 }
1685
1686 good:
1687 b->cookie = new_cookie;
1688 return 0;
1689 }
1690
1691 static int bus_seal_message(sd_bus *b, sd_bus_message *m, usec_t timeout) {
1692 int r;
1693
1694 assert(b);
1695 assert(m);
1696
1697 if (m->sealed) {
1698 /* If we copy the same message to multiple
1699 * destinations, avoid using the same cookie
1700 * numbers. */
1701 b->cookie = MAX(b->cookie, BUS_MESSAGE_COOKIE(m));
1702 return 0;
1703 }
1704
1705 if (timeout == 0) {
1706 r = sd_bus_get_method_call_timeout(b, &timeout);
1707 if (r < 0)
1708 return r;
1709 }
1710
1711 if (!m->sender && b->patch_sender) {
1712 r = sd_bus_message_set_sender(m, b->patch_sender);
1713 if (r < 0)
1714 return r;
1715 }
1716
1717 r = next_cookie(b);
1718 if (r < 0)
1719 return r;
1720
1721 return sd_bus_message_seal(m, b->cookie, timeout);
1722 }
1723
1724 static int bus_remarshal_message(sd_bus *b, sd_bus_message **m) {
1725 bool remarshal = false;
1726
1727 assert(b);
1728
1729 /* wrong packet version */
1730 if (b->message_version != 0 && b->message_version != (*m)->header->version)
1731 remarshal = true;
1732
1733 /* wrong packet endianness */
1734 if (b->message_endian != 0 && b->message_endian != (*m)->header->endian)
1735 remarshal = true;
1736
1737 return remarshal ? bus_message_remarshal(b, m) : 0;
1738 }
1739
1740 int bus_seal_synthetic_message(sd_bus *b, sd_bus_message *m) {
1741 assert(b);
1742 assert(m);
1743
1744 /* Fake some timestamps, if they were requested, and not
1745 * already initialized */
1746 if (b->attach_timestamp) {
1747 if (m->realtime <= 0)
1748 m->realtime = now(CLOCK_REALTIME);
1749
1750 if (m->monotonic <= 0)
1751 m->monotonic = now(CLOCK_MONOTONIC);
1752 }
1753
1754 /* The bus specification says the serial number cannot be 0,
1755 * hence let's fill something in for synthetic messages. Since
1756 * synthetic messages might have a fake sender and we don't
1757 * want to interfere with the real sender's serial numbers we
1758 * pick a fixed, artificial one. We use (uint32_t) -1 rather
1759 * than (uint64_t) -1 since dbus1 only had 32bit identifiers,
1760 * even though kdbus can do 64bit. */
1761 return sd_bus_message_seal(m, 0xFFFFFFFFULL, 0);
1762 }
1763
1764 static int bus_write_message(sd_bus *bus, sd_bus_message *m, size_t *idx) {
1765 int r;
1766
1767 assert(bus);
1768 assert(m);
1769
1770 r = bus_socket_write_message(bus, m, idx);
1771 if (r <= 0)
1772 return r;
1773
1774 if (*idx >= BUS_MESSAGE_SIZE(m))
1775 log_debug("Sent message type=%s sender=%s destination=%s path=%s interface=%s member=%s cookie=%" PRIu64 " reply_cookie=%" PRIu64 " signature=%s error-name=%s error-message=%s",
1776 bus_message_type_to_string(m->header->type),
1777 strna(sd_bus_message_get_sender(m)),
1778 strna(sd_bus_message_get_destination(m)),
1779 strna(sd_bus_message_get_path(m)),
1780 strna(sd_bus_message_get_interface(m)),
1781 strna(sd_bus_message_get_member(m)),
1782 BUS_MESSAGE_COOKIE(m),
1783 m->reply_cookie,
1784 strna(m->root_container.signature),
1785 strna(m->error.name),
1786 strna(m->error.message));
1787
1788 return r;
1789 }
1790
1791 static int dispatch_wqueue(sd_bus *bus) {
1792 int r, ret = 0;
1793
1794 assert(bus);
1795 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
1796
1797 while (bus->wqueue_size > 0) {
1798
1799 r = bus_write_message(bus, bus->wqueue[0], &bus->windex);
1800 if (r < 0)
1801 return r;
1802 else if (r == 0)
1803 /* Didn't do anything this time */
1804 return ret;
1805 else if (bus->windex >= BUS_MESSAGE_SIZE(bus->wqueue[0])) {
1806 /* Fully written. Let's drop the entry from
1807 * the queue.
1808 *
1809 * This isn't particularly optimized, but
1810 * well, this is supposed to be our worst-case
1811 * buffer only, and the socket buffer is
1812 * supposed to be our primary buffer, and if
1813 * it got full, then all bets are off
1814 * anyway. */
1815
1816 bus->wqueue_size--;
1817 bus_message_unref_queued(bus->wqueue[0], bus);
1818 memmove(bus->wqueue, bus->wqueue + 1, sizeof(sd_bus_message*) * bus->wqueue_size);
1819 bus->windex = 0;
1820
1821 ret = 1;
1822 }
1823 }
1824
1825 return ret;
1826 }
1827
1828 static int bus_read_message(sd_bus *bus, bool hint_priority, int64_t priority) {
1829 assert(bus);
1830
1831 return bus_socket_read_message(bus);
1832 }
1833
1834 int bus_rqueue_make_room(sd_bus *bus) {
1835 assert(bus);
1836
1837 if (bus->rqueue_size >= BUS_RQUEUE_MAX)
1838 return -ENOBUFS;
1839
1840 if (!GREEDY_REALLOC(bus->rqueue, bus->rqueue_allocated, bus->rqueue_size + 1))
1841 return -ENOMEM;
1842
1843 return 0;
1844 }
1845
1846 static void rqueue_drop_one(sd_bus *bus, size_t i) {
1847 assert(bus);
1848 assert(i < bus->rqueue_size);
1849
1850 bus_message_unref_queued(bus->rqueue[i], bus);
1851 memmove(bus->rqueue + i, bus->rqueue + i + 1, sizeof(sd_bus_message*) * (bus->rqueue_size - i - 1));
1852 bus->rqueue_size--;
1853 }
1854
1855 static int dispatch_rqueue(sd_bus *bus, bool hint_priority, int64_t priority, sd_bus_message **m) {
1856 int r, ret = 0;
1857
1858 assert(bus);
1859 assert(m);
1860 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
1861
1862 /* Note that the priority logic is only available on kdbus,
1863 * where the rqueue is unused. We check the rqueue here
1864 * anyway, because it's simple... */
1865
1866 for (;;) {
1867 if (bus->rqueue_size > 0) {
1868 /* Dispatch a queued message */
1869 *m = sd_bus_message_ref(bus->rqueue[0]);
1870 rqueue_drop_one(bus, 0);
1871 return 1;
1872 }
1873
1874 /* Try to read a new message */
1875 r = bus_read_message(bus, hint_priority, priority);
1876 if (r < 0)
1877 return r;
1878 if (r == 0) {
1879 *m = NULL;
1880 return ret;
1881 }
1882
1883 ret = 1;
1884 }
1885 }
1886
1887 _public_ int sd_bus_send(sd_bus *bus, sd_bus_message *_m, uint64_t *cookie) {
1888 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = sd_bus_message_ref(_m);
1889 int r;
1890
1891 assert_return(m, -EINVAL);
1892
1893 if (!bus)
1894 bus = m->bus;
1895
1896 assert_return(!bus_pid_changed(bus), -ECHILD);
1897
1898 if (!BUS_IS_OPEN(bus->state))
1899 return -ENOTCONN;
1900
1901 if (m->n_fds > 0) {
1902 r = sd_bus_can_send(bus, SD_BUS_TYPE_UNIX_FD);
1903 if (r < 0)
1904 return r;
1905 if (r == 0)
1906 return -EOPNOTSUPP;
1907 }
1908
1909 /* If the cookie number isn't kept, then we know that no reply
1910 * is expected */
1911 if (!cookie && !m->sealed)
1912 m->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
1913
1914 r = bus_seal_message(bus, m, 0);
1915 if (r < 0)
1916 return r;
1917
1918 /* Remarshall if we have to. This will possibly unref the
1919 * message and place a replacement in m */
1920 r = bus_remarshal_message(bus, &m);
1921 if (r < 0)
1922 return r;
1923
1924 /* If this is a reply and no reply was requested, then let's
1925 * suppress this, if we can */
1926 if (m->dont_send)
1927 goto finish;
1928
1929 if (IN_SET(bus->state, BUS_RUNNING, BUS_HELLO) && bus->wqueue_size <= 0) {
1930 size_t idx = 0;
1931
1932 r = bus_write_message(bus, m, &idx);
1933 if (r < 0) {
1934 if (ERRNO_IS_DISCONNECT(r)) {
1935 bus_enter_closing(bus);
1936 return -ECONNRESET;
1937 }
1938
1939 return r;
1940 }
1941
1942 if (idx < BUS_MESSAGE_SIZE(m)) {
1943 /* Wasn't fully written. So let's remember how
1944 * much was written. Note that the first entry
1945 * of the wqueue array is always allocated so
1946 * that we always can remember how much was
1947 * written. */
1948 bus->wqueue[0] = bus_message_ref_queued(m, bus);
1949 bus->wqueue_size = 1;
1950 bus->windex = idx;
1951 }
1952
1953 } else {
1954 /* Just append it to the queue. */
1955
1956 if (bus->wqueue_size >= BUS_WQUEUE_MAX)
1957 return -ENOBUFS;
1958
1959 if (!GREEDY_REALLOC(bus->wqueue, bus->wqueue_allocated, bus->wqueue_size + 1))
1960 return -ENOMEM;
1961
1962 bus->wqueue[bus->wqueue_size++] = bus_message_ref_queued(m, bus);
1963 }
1964
1965 finish:
1966 if (cookie)
1967 *cookie = BUS_MESSAGE_COOKIE(m);
1968
1969 return 1;
1970 }
1971
1972 _public_ int sd_bus_send_to(sd_bus *bus, sd_bus_message *m, const char *destination, uint64_t *cookie) {
1973 int r;
1974
1975 assert_return(m, -EINVAL);
1976
1977 if (!bus)
1978 bus = m->bus;
1979
1980 assert_return(!bus_pid_changed(bus), -ECHILD);
1981
1982 if (!BUS_IS_OPEN(bus->state))
1983 return -ENOTCONN;
1984
1985 if (!streq_ptr(m->destination, destination)) {
1986
1987 if (!destination)
1988 return -EEXIST;
1989
1990 r = sd_bus_message_set_destination(m, destination);
1991 if (r < 0)
1992 return r;
1993 }
1994
1995 return sd_bus_send(bus, m, cookie);
1996 }
1997
1998 static usec_t calc_elapse(sd_bus *bus, uint64_t usec) {
1999 assert(bus);
2000
2001 if (usec == (uint64_t) -1)
2002 return 0;
2003
2004 /* We start all timeouts the instant we enter BUS_HELLO/BUS_RUNNING state, so that the don't run in parallel
2005 * with any connection setup states. Hence, if a method callback is started earlier than that we just store the
2006 * relative timestamp, and afterwards the absolute one. */
2007
2008 if (IN_SET(bus->state, BUS_WATCH_BIND, BUS_OPENING, BUS_AUTHENTICATING))
2009 return usec;
2010 else
2011 return now(CLOCK_MONOTONIC) + usec;
2012 }
2013
2014 static int timeout_compare(const void *a, const void *b) {
2015 const struct reply_callback *x = a, *y = b;
2016
2017 if (x->timeout_usec != 0 && y->timeout_usec == 0)
2018 return -1;
2019
2020 if (x->timeout_usec == 0 && y->timeout_usec != 0)
2021 return 1;
2022
2023 return CMP(x->timeout_usec, y->timeout_usec);
2024 }
2025
2026 _public_ int sd_bus_call_async(
2027 sd_bus *bus,
2028 sd_bus_slot **slot,
2029 sd_bus_message *_m,
2030 sd_bus_message_handler_t callback,
2031 void *userdata,
2032 uint64_t usec) {
2033
2034 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = sd_bus_message_ref(_m);
2035 _cleanup_(sd_bus_slot_unrefp) sd_bus_slot *s = NULL;
2036 int r;
2037
2038 assert_return(m, -EINVAL);
2039 assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL);
2040 assert_return(!m->sealed || (!!callback == !(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED)), -EINVAL);
2041
2042 if (!bus)
2043 bus = m->bus;
2044
2045 assert_return(!bus_pid_changed(bus), -ECHILD);
2046
2047 if (!BUS_IS_OPEN(bus->state))
2048 return -ENOTCONN;
2049
2050 /* If no callback is specified and there's no interest in a slot, then there's no reason to ask for a reply */
2051 if (!callback && !slot && !m->sealed)
2052 m->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
2053
2054 r = ordered_hashmap_ensure_allocated(&bus->reply_callbacks, &uint64_hash_ops);
2055 if (r < 0)
2056 return r;
2057
2058 r = prioq_ensure_allocated(&bus->reply_callbacks_prioq, timeout_compare);
2059 if (r < 0)
2060 return r;
2061
2062 r = bus_seal_message(bus, m, usec);
2063 if (r < 0)
2064 return r;
2065
2066 r = bus_remarshal_message(bus, &m);
2067 if (r < 0)
2068 return r;
2069
2070 if (slot || callback) {
2071 s = bus_slot_allocate(bus, !slot, BUS_REPLY_CALLBACK, sizeof(struct reply_callback), userdata);
2072 if (!s)
2073 return -ENOMEM;
2074
2075 s->reply_callback.callback = callback;
2076
2077 s->reply_callback.cookie = BUS_MESSAGE_COOKIE(m);
2078 r = ordered_hashmap_put(bus->reply_callbacks, &s->reply_callback.cookie, &s->reply_callback);
2079 if (r < 0) {
2080 s->reply_callback.cookie = 0;
2081 return r;
2082 }
2083
2084 s->reply_callback.timeout_usec = calc_elapse(bus, m->timeout);
2085 if (s->reply_callback.timeout_usec != 0) {
2086 r = prioq_put(bus->reply_callbacks_prioq, &s->reply_callback, &s->reply_callback.prioq_idx);
2087 if (r < 0) {
2088 s->reply_callback.timeout_usec = 0;
2089 return r;
2090 }
2091 }
2092 }
2093
2094 r = sd_bus_send(bus, m, s ? &s->reply_callback.cookie : NULL);
2095 if (r < 0)
2096 return r;
2097
2098 if (slot)
2099 *slot = s;
2100 s = NULL;
2101
2102 return r;
2103 }
2104
2105 int bus_ensure_running(sd_bus *bus) {
2106 int r;
2107
2108 assert(bus);
2109
2110 if (IN_SET(bus->state, BUS_UNSET, BUS_CLOSED, BUS_CLOSING))
2111 return -ENOTCONN;
2112 if (bus->state == BUS_RUNNING)
2113 return 1;
2114
2115 for (;;) {
2116 r = sd_bus_process(bus, NULL);
2117 if (r < 0)
2118 return r;
2119 if (bus->state == BUS_RUNNING)
2120 return 1;
2121 if (r > 0)
2122 continue;
2123
2124 r = sd_bus_wait(bus, (uint64_t) -1);
2125 if (r < 0)
2126 return r;
2127 }
2128 }
2129
2130 _public_ int sd_bus_call(
2131 sd_bus *bus,
2132 sd_bus_message *_m,
2133 uint64_t usec,
2134 sd_bus_error *error,
2135 sd_bus_message **reply) {
2136
2137 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = sd_bus_message_ref(_m);
2138 usec_t timeout;
2139 uint64_t cookie;
2140 size_t i;
2141 int r;
2142
2143 bus_assert_return(m, -EINVAL, error);
2144 bus_assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL, error);
2145 bus_assert_return(!(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED), -EINVAL, error);
2146 bus_assert_return(!bus_error_is_dirty(error), -EINVAL, error);
2147
2148 if (!bus)
2149 bus = m->bus;
2150
2151 bus_assert_return(!bus_pid_changed(bus), -ECHILD, error);
2152
2153 if (!BUS_IS_OPEN(bus->state)) {
2154 r = -ENOTCONN;
2155 goto fail;
2156 }
2157
2158 r = bus_ensure_running(bus);
2159 if (r < 0)
2160 goto fail;
2161
2162 i = bus->rqueue_size;
2163
2164 r = bus_seal_message(bus, m, usec);
2165 if (r < 0)
2166 goto fail;
2167
2168 r = bus_remarshal_message(bus, &m);
2169 if (r < 0)
2170 goto fail;
2171
2172 r = sd_bus_send(bus, m, &cookie);
2173 if (r < 0)
2174 goto fail;
2175
2176 timeout = calc_elapse(bus, m->timeout);
2177
2178 for (;;) {
2179 usec_t left;
2180
2181 while (i < bus->rqueue_size) {
2182 _cleanup_(sd_bus_message_unrefp) sd_bus_message *incoming = NULL;
2183
2184 incoming = sd_bus_message_ref(bus->rqueue[i]);
2185
2186 if (incoming->reply_cookie == cookie) {
2187 /* Found a match! */
2188
2189 rqueue_drop_one(bus, i);
2190 log_debug_bus_message(incoming);
2191
2192 if (incoming->header->type == SD_BUS_MESSAGE_METHOD_RETURN) {
2193
2194 if (incoming->n_fds <= 0 || bus->accept_fd) {
2195 if (reply)
2196 *reply = TAKE_PTR(incoming);
2197
2198 return 1;
2199 }
2200
2201 return sd_bus_error_setf(error, SD_BUS_ERROR_INCONSISTENT_MESSAGE, "Reply message contained file descriptors which I couldn't accept. Sorry.");
2202
2203 } else if (incoming->header->type == SD_BUS_MESSAGE_METHOD_ERROR)
2204 return sd_bus_error_copy(error, &incoming->error);
2205 else {
2206 r = -EIO;
2207 goto fail;
2208 }
2209
2210 } else if (BUS_MESSAGE_COOKIE(incoming) == cookie &&
2211 bus->unique_name &&
2212 incoming->sender &&
2213 streq(bus->unique_name, incoming->sender)) {
2214
2215 rqueue_drop_one(bus, i);
2216
2217 /* Our own message? Somebody is trying to send its own client a message,
2218 * let's not dead-lock, let's fail immediately. */
2219
2220 r = -ELOOP;
2221 goto fail;
2222 }
2223
2224 /* Try to read more, right-away */
2225 i++;
2226 }
2227
2228 r = bus_read_message(bus, false, 0);
2229 if (r < 0) {
2230 if (ERRNO_IS_DISCONNECT(r)) {
2231 bus_enter_closing(bus);
2232 r = -ECONNRESET;
2233 }
2234
2235 goto fail;
2236 }
2237 if (r > 0)
2238 continue;
2239
2240 if (timeout > 0) {
2241 usec_t n;
2242
2243 n = now(CLOCK_MONOTONIC);
2244 if (n >= timeout) {
2245 r = -ETIMEDOUT;
2246 goto fail;
2247 }
2248
2249 left = timeout - n;
2250 } else
2251 left = (uint64_t) -1;
2252
2253 r = bus_poll(bus, true, left);
2254 if (r < 0)
2255 goto fail;
2256 if (r == 0) {
2257 r = -ETIMEDOUT;
2258 goto fail;
2259 }
2260
2261 r = dispatch_wqueue(bus);
2262 if (r < 0) {
2263 if (ERRNO_IS_DISCONNECT(r)) {
2264 bus_enter_closing(bus);
2265 r = -ECONNRESET;
2266 }
2267
2268 goto fail;
2269 }
2270 }
2271
2272 fail:
2273 return sd_bus_error_set_errno(error, r);
2274 }
2275
2276 _public_ int sd_bus_get_fd(sd_bus *bus) {
2277
2278 assert_return(bus, -EINVAL);
2279 assert_return(bus = bus_resolve(bus), -ENOPKG);
2280 assert_return(bus->input_fd == bus->output_fd, -EPERM);
2281 assert_return(!bus_pid_changed(bus), -ECHILD);
2282
2283 if (bus->state == BUS_CLOSED)
2284 return -ENOTCONN;
2285
2286 if (bus->inotify_fd >= 0)
2287 return bus->inotify_fd;
2288
2289 if (bus->input_fd >= 0)
2290 return bus->input_fd;
2291
2292 return -ENOTCONN;
2293 }
2294
2295 _public_ int sd_bus_get_events(sd_bus *bus) {
2296 int flags = 0;
2297
2298 assert_return(bus, -EINVAL);
2299 assert_return(bus = bus_resolve(bus), -ENOPKG);
2300 assert_return(!bus_pid_changed(bus), -ECHILD);
2301
2302 switch (bus->state) {
2303
2304 case BUS_UNSET:
2305 case BUS_CLOSED:
2306 return -ENOTCONN;
2307
2308 case BUS_WATCH_BIND:
2309 flags |= POLLIN;
2310 break;
2311
2312 case BUS_OPENING:
2313 flags |= POLLOUT;
2314 break;
2315
2316 case BUS_AUTHENTICATING:
2317 if (bus_socket_auth_needs_write(bus))
2318 flags |= POLLOUT;
2319
2320 flags |= POLLIN;
2321 break;
2322
2323 case BUS_RUNNING:
2324 case BUS_HELLO:
2325 if (bus->rqueue_size <= 0)
2326 flags |= POLLIN;
2327 if (bus->wqueue_size > 0)
2328 flags |= POLLOUT;
2329 break;
2330
2331 case BUS_CLOSING:
2332 break;
2333
2334 default:
2335 assert_not_reached("Unknown state");
2336 }
2337
2338 return flags;
2339 }
2340
2341 _public_ int sd_bus_get_timeout(sd_bus *bus, uint64_t *timeout_usec) {
2342 struct reply_callback *c;
2343
2344 assert_return(bus, -EINVAL);
2345 assert_return(bus = bus_resolve(bus), -ENOPKG);
2346 assert_return(timeout_usec, -EINVAL);
2347 assert_return(!bus_pid_changed(bus), -ECHILD);
2348
2349 if (!BUS_IS_OPEN(bus->state) && bus->state != BUS_CLOSING)
2350 return -ENOTCONN;
2351
2352 if (bus->track_queue) {
2353 *timeout_usec = 0;
2354 return 1;
2355 }
2356
2357 switch (bus->state) {
2358
2359 case BUS_AUTHENTICATING:
2360 *timeout_usec = bus->auth_timeout;
2361 return 1;
2362
2363 case BUS_RUNNING:
2364 case BUS_HELLO:
2365 if (bus->rqueue_size > 0) {
2366 *timeout_usec = 0;
2367 return 1;
2368 }
2369
2370 c = prioq_peek(bus->reply_callbacks_prioq);
2371 if (!c) {
2372 *timeout_usec = (uint64_t) -1;
2373 return 0;
2374 }
2375
2376 if (c->timeout_usec == 0) {
2377 *timeout_usec = (uint64_t) -1;
2378 return 0;
2379 }
2380
2381 *timeout_usec = c->timeout_usec;
2382 return 1;
2383
2384 case BUS_CLOSING:
2385 *timeout_usec = 0;
2386 return 1;
2387
2388 case BUS_WATCH_BIND:
2389 case BUS_OPENING:
2390 *timeout_usec = (uint64_t) -1;
2391 return 0;
2392
2393 default:
2394 assert_not_reached("Unknown or unexpected stat");
2395 }
2396 }
2397
2398 static int process_timeout(sd_bus *bus) {
2399 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2400 _cleanup_(sd_bus_message_unrefp) sd_bus_message* m = NULL;
2401 struct reply_callback *c;
2402 sd_bus_slot *slot;
2403 bool is_hello;
2404 usec_t n;
2405 int r;
2406
2407 assert(bus);
2408 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
2409
2410 c = prioq_peek(bus->reply_callbacks_prioq);
2411 if (!c)
2412 return 0;
2413
2414 n = now(CLOCK_MONOTONIC);
2415 if (c->timeout_usec > n)
2416 return 0;
2417
2418 r = bus_message_new_synthetic_error(
2419 bus,
2420 c->cookie,
2421 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY, "Method call timed out"),
2422 &m);
2423 if (r < 0)
2424 return r;
2425
2426 m->read_counter = ++bus->read_counter;
2427
2428 r = bus_seal_synthetic_message(bus, m);
2429 if (r < 0)
2430 return r;
2431
2432 assert_se(prioq_pop(bus->reply_callbacks_prioq) == c);
2433 c->timeout_usec = 0;
2434
2435 ordered_hashmap_remove(bus->reply_callbacks, &c->cookie);
2436 c->cookie = 0;
2437
2438 slot = container_of(c, sd_bus_slot, reply_callback);
2439
2440 bus->iteration_counter++;
2441
2442 is_hello = bus->state == BUS_HELLO && c->callback == hello_callback;
2443
2444 bus->current_message = m;
2445 bus->current_slot = sd_bus_slot_ref(slot);
2446 bus->current_handler = c->callback;
2447 bus->current_userdata = slot->userdata;
2448 r = c->callback(m, slot->userdata, &error_buffer);
2449 bus->current_userdata = NULL;
2450 bus->current_handler = NULL;
2451 bus->current_slot = NULL;
2452 bus->current_message = NULL;
2453
2454 if (slot->floating)
2455 bus_slot_disconnect(slot, true);
2456
2457 sd_bus_slot_unref(slot);
2458
2459 /* When this is the hello message and it timed out, then make sure to propagate the error up, don't just log
2460 * and ignore the callback handler's return value. */
2461 if (is_hello)
2462 return r;
2463
2464 return bus_maybe_reply_error(m, r, &error_buffer);
2465 }
2466
2467 static int process_hello(sd_bus *bus, sd_bus_message *m) {
2468 assert(bus);
2469 assert(m);
2470
2471 if (bus->state != BUS_HELLO)
2472 return 0;
2473
2474 /* Let's make sure the first message on the bus is the HELLO
2475 * reply. But note that we don't actually parse the message
2476 * here (we leave that to the usual handling), we just verify
2477 * we don't let any earlier msg through. */
2478
2479 if (!IN_SET(m->header->type, SD_BUS_MESSAGE_METHOD_RETURN, SD_BUS_MESSAGE_METHOD_ERROR))
2480 return -EIO;
2481
2482 if (m->reply_cookie != 1)
2483 return -EIO;
2484
2485 return 0;
2486 }
2487
2488 static int process_reply(sd_bus *bus, sd_bus_message *m) {
2489 _cleanup_(sd_bus_message_unrefp) sd_bus_message *synthetic_reply = NULL;
2490 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2491 struct reply_callback *c;
2492 sd_bus_slot *slot;
2493 bool is_hello;
2494 int r;
2495
2496 assert(bus);
2497 assert(m);
2498
2499 if (!IN_SET(m->header->type, SD_BUS_MESSAGE_METHOD_RETURN, SD_BUS_MESSAGE_METHOD_ERROR))
2500 return 0;
2501
2502 if (m->destination && bus->unique_name && !streq_ptr(m->destination, bus->unique_name))
2503 return 0;
2504
2505 c = ordered_hashmap_remove(bus->reply_callbacks, &m->reply_cookie);
2506 if (!c)
2507 return 0;
2508
2509 c->cookie = 0;
2510
2511 slot = container_of(c, sd_bus_slot, reply_callback);
2512
2513 if (m->n_fds > 0 && !bus->accept_fd) {
2514
2515 /* If the reply contained a file descriptor which we
2516 * didn't want we pass an error instead. */
2517
2518 r = bus_message_new_synthetic_error(
2519 bus,
2520 m->reply_cookie,
2521 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_INCONSISTENT_MESSAGE, "Reply message contained file descriptor"),
2522 &synthetic_reply);
2523 if (r < 0)
2524 return r;
2525
2526 /* Copy over original timestamp */
2527 synthetic_reply->realtime = m->realtime;
2528 synthetic_reply->monotonic = m->monotonic;
2529 synthetic_reply->seqnum = m->seqnum;
2530 synthetic_reply->read_counter = m->read_counter;
2531
2532 r = bus_seal_synthetic_message(bus, synthetic_reply);
2533 if (r < 0)
2534 return r;
2535
2536 m = synthetic_reply;
2537 } else {
2538 r = sd_bus_message_rewind(m, true);
2539 if (r < 0)
2540 return r;
2541 }
2542
2543 if (c->timeout_usec != 0) {
2544 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
2545 c->timeout_usec = 0;
2546 }
2547
2548 is_hello = bus->state == BUS_HELLO && c->callback == hello_callback;
2549
2550 bus->current_slot = sd_bus_slot_ref(slot);
2551 bus->current_handler = c->callback;
2552 bus->current_userdata = slot->userdata;
2553 r = c->callback(m, slot->userdata, &error_buffer);
2554 bus->current_userdata = NULL;
2555 bus->current_handler = NULL;
2556 bus->current_slot = NULL;
2557
2558 if (slot->floating)
2559 bus_slot_disconnect(slot, true);
2560
2561 sd_bus_slot_unref(slot);
2562
2563 /* When this is the hello message and it failed, then make sure to propagate the error up, don't just log and
2564 * ignore the callback handler's return value. */
2565 if (is_hello)
2566 return r;
2567
2568 return bus_maybe_reply_error(m, r, &error_buffer);
2569 }
2570
2571 static int process_filter(sd_bus *bus, sd_bus_message *m) {
2572 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2573 struct filter_callback *l;
2574 int r;
2575
2576 assert(bus);
2577 assert(m);
2578
2579 do {
2580 bus->filter_callbacks_modified = false;
2581
2582 LIST_FOREACH(callbacks, l, bus->filter_callbacks) {
2583 sd_bus_slot *slot;
2584
2585 if (bus->filter_callbacks_modified)
2586 break;
2587
2588 /* Don't run this more than once per iteration */
2589 if (l->last_iteration == bus->iteration_counter)
2590 continue;
2591
2592 l->last_iteration = bus->iteration_counter;
2593
2594 r = sd_bus_message_rewind(m, true);
2595 if (r < 0)
2596 return r;
2597
2598 slot = container_of(l, sd_bus_slot, filter_callback);
2599
2600 bus->current_slot = sd_bus_slot_ref(slot);
2601 bus->current_handler = l->callback;
2602 bus->current_userdata = slot->userdata;
2603 r = l->callback(m, slot->userdata, &error_buffer);
2604 bus->current_userdata = NULL;
2605 bus->current_handler = NULL;
2606 bus->current_slot = sd_bus_slot_unref(slot);
2607
2608 r = bus_maybe_reply_error(m, r, &error_buffer);
2609 if (r != 0)
2610 return r;
2611
2612 }
2613
2614 } while (bus->filter_callbacks_modified);
2615
2616 return 0;
2617 }
2618
2619 static int process_match(sd_bus *bus, sd_bus_message *m) {
2620 int r;
2621
2622 assert(bus);
2623 assert(m);
2624
2625 do {
2626 bus->match_callbacks_modified = false;
2627
2628 r = bus_match_run(bus, &bus->match_callbacks, m);
2629 if (r != 0)
2630 return r;
2631
2632 } while (bus->match_callbacks_modified);
2633
2634 return 0;
2635 }
2636
2637 static int process_builtin(sd_bus *bus, sd_bus_message *m) {
2638 _cleanup_(sd_bus_message_unrefp) sd_bus_message *reply = NULL;
2639 int r;
2640
2641 assert(bus);
2642 assert(m);
2643
2644 if (bus->is_monitor)
2645 return 0;
2646
2647 if (bus->manual_peer_interface)
2648 return 0;
2649
2650 if (m->header->type != SD_BUS_MESSAGE_METHOD_CALL)
2651 return 0;
2652
2653 if (!streq_ptr(m->interface, "org.freedesktop.DBus.Peer"))
2654 return 0;
2655
2656 if (m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED)
2657 return 1;
2658
2659 if (streq_ptr(m->member, "Ping"))
2660 r = sd_bus_message_new_method_return(m, &reply);
2661 else if (streq_ptr(m->member, "GetMachineId")) {
2662 sd_id128_t id;
2663 char sid[33];
2664
2665 r = sd_id128_get_machine(&id);
2666 if (r < 0)
2667 return r;
2668
2669 r = sd_bus_message_new_method_return(m, &reply);
2670 if (r < 0)
2671 return r;
2672
2673 r = sd_bus_message_append(reply, "s", sd_id128_to_string(id, sid));
2674 } else {
2675 r = sd_bus_message_new_method_errorf(
2676 m, &reply,
2677 SD_BUS_ERROR_UNKNOWN_METHOD,
2678 "Unknown method '%s' on interface '%s'.", m->member, m->interface);
2679 }
2680 if (r < 0)
2681 return r;
2682
2683 r = sd_bus_send(bus, reply, NULL);
2684 if (r < 0)
2685 return r;
2686
2687 return 1;
2688 }
2689
2690 static int process_fd_check(sd_bus *bus, sd_bus_message *m) {
2691 assert(bus);
2692 assert(m);
2693
2694 /* If we got a message with a file descriptor which we didn't
2695 * want to accept, then let's drop it. How can this even
2696 * happen? For example, when the kernel queues a message into
2697 * an activatable names's queue which allows fds, and then is
2698 * delivered to us later even though we ourselves did not
2699 * negotiate it. */
2700
2701 if (bus->is_monitor)
2702 return 0;
2703
2704 if (m->n_fds <= 0)
2705 return 0;
2706
2707 if (bus->accept_fd)
2708 return 0;
2709
2710 if (m->header->type != SD_BUS_MESSAGE_METHOD_CALL)
2711 return 1; /* just eat it up */
2712
2713 return sd_bus_reply_method_errorf(m, SD_BUS_ERROR_INCONSISTENT_MESSAGE, "Message contains file descriptors, which I cannot accept. Sorry.");
2714 }
2715
2716 static int process_message(sd_bus *bus, sd_bus_message *m) {
2717 int r;
2718
2719 assert(bus);
2720 assert(m);
2721
2722 bus->current_message = m;
2723 bus->iteration_counter++;
2724
2725 log_debug_bus_message(m);
2726
2727 r = process_hello(bus, m);
2728 if (r != 0)
2729 goto finish;
2730
2731 r = process_reply(bus, m);
2732 if (r != 0)
2733 goto finish;
2734
2735 r = process_fd_check(bus, m);
2736 if (r != 0)
2737 goto finish;
2738
2739 r = process_filter(bus, m);
2740 if (r != 0)
2741 goto finish;
2742
2743 r = process_match(bus, m);
2744 if (r != 0)
2745 goto finish;
2746
2747 r = process_builtin(bus, m);
2748 if (r != 0)
2749 goto finish;
2750
2751 r = bus_process_object(bus, m);
2752
2753 finish:
2754 bus->current_message = NULL;
2755 return r;
2756 }
2757
2758 static int dispatch_track(sd_bus *bus) {
2759 assert(bus);
2760
2761 if (!bus->track_queue)
2762 return 0;
2763
2764 bus_track_dispatch(bus->track_queue);
2765 return 1;
2766 }
2767
2768 static int process_running(sd_bus *bus, bool hint_priority, int64_t priority, sd_bus_message **ret) {
2769 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
2770 int r;
2771
2772 assert(bus);
2773 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
2774
2775 r = process_timeout(bus);
2776 if (r != 0)
2777 goto null_message;
2778
2779 r = dispatch_wqueue(bus);
2780 if (r != 0)
2781 goto null_message;
2782
2783 r = dispatch_track(bus);
2784 if (r != 0)
2785 goto null_message;
2786
2787 r = dispatch_rqueue(bus, hint_priority, priority, &m);
2788 if (r < 0)
2789 return r;
2790 if (!m)
2791 goto null_message;
2792
2793 r = process_message(bus, m);
2794 if (r != 0)
2795 goto null_message;
2796
2797 if (ret) {
2798 r = sd_bus_message_rewind(m, true);
2799 if (r < 0)
2800 return r;
2801
2802 *ret = TAKE_PTR(m);
2803 return 1;
2804 }
2805
2806 if (m->header->type == SD_BUS_MESSAGE_METHOD_CALL) {
2807
2808 log_debug("Unprocessed message call sender=%s object=%s interface=%s member=%s",
2809 strna(sd_bus_message_get_sender(m)),
2810 strna(sd_bus_message_get_path(m)),
2811 strna(sd_bus_message_get_interface(m)),
2812 strna(sd_bus_message_get_member(m)));
2813
2814 r = sd_bus_reply_method_errorf(
2815 m,
2816 SD_BUS_ERROR_UNKNOWN_OBJECT,
2817 "Unknown object '%s'.", m->path);
2818 if (r < 0)
2819 return r;
2820 }
2821
2822 return 1;
2823
2824 null_message:
2825 if (r >= 0 && ret)
2826 *ret = NULL;
2827
2828 return r;
2829 }
2830
2831 static int bus_exit_now(sd_bus *bus) {
2832 assert(bus);
2833
2834 /* Exit due to close, if this is requested. If this is bus object is attached to an event source, invokes
2835 * sd_event_exit(), otherwise invokes libc exit(). */
2836
2837 if (bus->exited) /* did we already exit? */
2838 return 0;
2839 if (!bus->exit_triggered) /* was the exit condition triggered? */
2840 return 0;
2841 if (!bus->exit_on_disconnect) /* Shall we actually exit on disconnection? */
2842 return 0;
2843
2844 bus->exited = true; /* never exit more than once */
2845
2846 log_debug("Bus connection disconnected, exiting.");
2847
2848 if (bus->event)
2849 return sd_event_exit(bus->event, EXIT_FAILURE);
2850 else
2851 exit(EXIT_FAILURE);
2852
2853 assert_not_reached("exit() didn't exit?");
2854 }
2855
2856 static int process_closing_reply_callback(sd_bus *bus, struct reply_callback *c) {
2857 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2858 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
2859 sd_bus_slot *slot;
2860 int r;
2861
2862 assert(bus);
2863 assert(c);
2864
2865 r = bus_message_new_synthetic_error(
2866 bus,
2867 c->cookie,
2868 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY, "Connection terminated"),
2869 &m);
2870 if (r < 0)
2871 return r;
2872
2873 m->read_counter = ++bus->read_counter;
2874
2875 r = bus_seal_synthetic_message(bus, m);
2876 if (r < 0)
2877 return r;
2878
2879 if (c->timeout_usec != 0) {
2880 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
2881 c->timeout_usec = 0;
2882 }
2883
2884 ordered_hashmap_remove(bus->reply_callbacks, &c->cookie);
2885 c->cookie = 0;
2886
2887 slot = container_of(c, sd_bus_slot, reply_callback);
2888
2889 bus->iteration_counter++;
2890
2891 bus->current_message = m;
2892 bus->current_slot = sd_bus_slot_ref(slot);
2893 bus->current_handler = c->callback;
2894 bus->current_userdata = slot->userdata;
2895 r = c->callback(m, slot->userdata, &error_buffer);
2896 bus->current_userdata = NULL;
2897 bus->current_handler = NULL;
2898 bus->current_slot = NULL;
2899 bus->current_message = NULL;
2900
2901 if (slot->floating)
2902 bus_slot_disconnect(slot, true);
2903
2904 sd_bus_slot_unref(slot);
2905
2906 return bus_maybe_reply_error(m, r, &error_buffer);
2907 }
2908
2909 static int process_closing(sd_bus *bus, sd_bus_message **ret) {
2910 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
2911 struct reply_callback *c;
2912 int r;
2913
2914 assert(bus);
2915 assert(bus->state == BUS_CLOSING);
2916
2917 /* First, fail all outstanding method calls */
2918 c = ordered_hashmap_first(bus->reply_callbacks);
2919 if (c)
2920 return process_closing_reply_callback(bus, c);
2921
2922 /* Then, fake-drop all remaining bus tracking references */
2923 if (bus->tracks) {
2924 bus_track_close(bus->tracks);
2925 return 1;
2926 }
2927
2928 /* Then, synthesize a Disconnected message */
2929 r = sd_bus_message_new_signal(
2930 bus,
2931 &m,
2932 "/org/freedesktop/DBus/Local",
2933 "org.freedesktop.DBus.Local",
2934 "Disconnected");
2935 if (r < 0)
2936 return r;
2937
2938 bus_message_set_sender_local(bus, m);
2939 m->read_counter = ++bus->read_counter;
2940
2941 r = bus_seal_synthetic_message(bus, m);
2942 if (r < 0)
2943 return r;
2944
2945 sd_bus_close(bus);
2946
2947 bus->current_message = m;
2948 bus->iteration_counter++;
2949
2950 r = process_filter(bus, m);
2951 if (r != 0)
2952 goto finish;
2953
2954 r = process_match(bus, m);
2955 if (r != 0)
2956 goto finish;
2957
2958 /* Nothing else to do, exit now, if the condition holds */
2959 bus->exit_triggered = true;
2960 (void) bus_exit_now(bus);
2961
2962 if (ret)
2963 *ret = TAKE_PTR(m);
2964
2965 r = 1;
2966
2967 finish:
2968 bus->current_message = NULL;
2969
2970 return r;
2971 }
2972
2973 static int bus_process_internal(sd_bus *bus, bool hint_priority, int64_t priority, sd_bus_message **ret) {
2974 int r;
2975
2976 /* Returns 0 when we didn't do anything. This should cause the
2977 * caller to invoke sd_bus_wait() before returning the next
2978 * time. Returns > 0 when we did something, which possibly
2979 * means *ret is filled in with an unprocessed message. */
2980
2981 assert_return(bus, -EINVAL);
2982 assert_return(bus = bus_resolve(bus), -ENOPKG);
2983 assert_return(!bus_pid_changed(bus), -ECHILD);
2984
2985 /* We don't allow recursively invoking sd_bus_process(). */
2986 assert_return(!bus->current_message, -EBUSY);
2987 assert(!bus->current_slot); /* This should be NULL whenever bus->current_message is */
2988
2989 BUS_DONT_DESTROY(bus);
2990
2991 switch (bus->state) {
2992
2993 case BUS_UNSET:
2994 return -ENOTCONN;
2995
2996 case BUS_CLOSED:
2997 return -ECONNRESET;
2998
2999 case BUS_WATCH_BIND:
3000 r = bus_socket_process_watch_bind(bus);
3001 break;
3002
3003 case BUS_OPENING:
3004 r = bus_socket_process_opening(bus);
3005 break;
3006
3007 case BUS_AUTHENTICATING:
3008 r = bus_socket_process_authenticating(bus);
3009 break;
3010
3011 case BUS_RUNNING:
3012 case BUS_HELLO:
3013 r = process_running(bus, hint_priority, priority, ret);
3014 if (r >= 0)
3015 return r;
3016
3017 /* This branch initializes *ret, hence we don't use the generic error checking below */
3018 break;
3019
3020 case BUS_CLOSING:
3021 return process_closing(bus, ret);
3022
3023 default:
3024 assert_not_reached("Unknown state");
3025 }
3026
3027 if (ERRNO_IS_DISCONNECT(r)) {
3028 bus_enter_closing(bus);
3029 r = 1;
3030 } else if (r < 0)
3031 return r;
3032
3033 if (ret)
3034 *ret = NULL;
3035
3036 return r;
3037 }
3038
3039 _public_ int sd_bus_process(sd_bus *bus, sd_bus_message **ret) {
3040 return bus_process_internal(bus, false, 0, ret);
3041 }
3042
3043 _public_ int sd_bus_process_priority(sd_bus *bus, int64_t priority, sd_bus_message **ret) {
3044 return bus_process_internal(bus, true, priority, ret);
3045 }
3046
3047 static int bus_poll(sd_bus *bus, bool need_more, uint64_t timeout_usec) {
3048 struct pollfd p[2] = {};
3049 int r, n;
3050 struct timespec ts;
3051 usec_t m = USEC_INFINITY;
3052
3053 assert(bus);
3054
3055 if (bus->state == BUS_CLOSING)
3056 return 1;
3057
3058 if (!BUS_IS_OPEN(bus->state))
3059 return -ENOTCONN;
3060
3061 if (bus->state == BUS_WATCH_BIND) {
3062 assert(bus->inotify_fd >= 0);
3063
3064 p[0].events = POLLIN;
3065 p[0].fd = bus->inotify_fd;
3066 n = 1;
3067 } else {
3068 int e;
3069
3070 e = sd_bus_get_events(bus);
3071 if (e < 0)
3072 return e;
3073
3074 if (need_more)
3075 /* The caller really needs some more data, he doesn't
3076 * care about what's already read, or any timeouts
3077 * except its own. */
3078 e |= POLLIN;
3079 else {
3080 usec_t until;
3081 /* The caller wants to process if there's something to
3082 * process, but doesn't care otherwise */
3083
3084 r = sd_bus_get_timeout(bus, &until);
3085 if (r < 0)
3086 return r;
3087 if (r > 0)
3088 m = usec_sub_unsigned(until, now(CLOCK_MONOTONIC));
3089 }
3090
3091 p[0].fd = bus->input_fd;
3092 if (bus->output_fd == bus->input_fd) {
3093 p[0].events = e;
3094 n = 1;
3095 } else {
3096 p[0].events = e & POLLIN;
3097 p[1].fd = bus->output_fd;
3098 p[1].events = e & POLLOUT;
3099 n = 2;
3100 }
3101 }
3102
3103 if (timeout_usec != (uint64_t) -1 && (m == USEC_INFINITY || timeout_usec < m))
3104 m = timeout_usec;
3105
3106 r = ppoll(p, n, m == USEC_INFINITY ? NULL : timespec_store(&ts, m), NULL);
3107 if (r < 0)
3108 return -errno;
3109
3110 return r > 0 ? 1 : 0;
3111 }
3112
3113 _public_ int sd_bus_wait(sd_bus *bus, uint64_t timeout_usec) {
3114
3115 assert_return(bus, -EINVAL);
3116 assert_return(bus = bus_resolve(bus), -ENOPKG);
3117 assert_return(!bus_pid_changed(bus), -ECHILD);
3118
3119 if (bus->state == BUS_CLOSING)
3120 return 0;
3121
3122 if (!BUS_IS_OPEN(bus->state))
3123 return -ENOTCONN;
3124
3125 if (bus->rqueue_size > 0)
3126 return 0;
3127
3128 return bus_poll(bus, false, timeout_usec);
3129 }
3130
3131 _public_ int sd_bus_flush(sd_bus *bus) {
3132 int r;
3133
3134 assert_return(bus, -EINVAL);
3135 assert_return(bus = bus_resolve(bus), -ENOPKG);
3136 assert_return(!bus_pid_changed(bus), -ECHILD);
3137
3138 if (bus->state == BUS_CLOSING)
3139 return 0;
3140
3141 if (!BUS_IS_OPEN(bus->state))
3142 return -ENOTCONN;
3143
3144 /* We never were connected? Don't hang in inotify for good, as there's no timeout set for it */
3145 if (bus->state == BUS_WATCH_BIND)
3146 return -EUNATCH;
3147
3148 r = bus_ensure_running(bus);
3149 if (r < 0)
3150 return r;
3151
3152 if (bus->wqueue_size <= 0)
3153 return 0;
3154
3155 for (;;) {
3156 r = dispatch_wqueue(bus);
3157 if (r < 0) {
3158 if (ERRNO_IS_DISCONNECT(r)) {
3159 bus_enter_closing(bus);
3160 return -ECONNRESET;
3161 }
3162
3163 return r;
3164 }
3165
3166 if (bus->wqueue_size <= 0)
3167 return 0;
3168
3169 r = bus_poll(bus, false, (uint64_t) -1);
3170 if (r < 0)
3171 return r;
3172 }
3173 }
3174
3175 _public_ int sd_bus_add_filter(
3176 sd_bus *bus,
3177 sd_bus_slot **slot,
3178 sd_bus_message_handler_t callback,
3179 void *userdata) {
3180
3181 sd_bus_slot *s;
3182
3183 assert_return(bus, -EINVAL);
3184 assert_return(bus = bus_resolve(bus), -ENOPKG);
3185 assert_return(callback, -EINVAL);
3186 assert_return(!bus_pid_changed(bus), -ECHILD);
3187
3188 s = bus_slot_allocate(bus, !slot, BUS_FILTER_CALLBACK, sizeof(struct filter_callback), userdata);
3189 if (!s)
3190 return -ENOMEM;
3191
3192 s->filter_callback.callback = callback;
3193
3194 bus->filter_callbacks_modified = true;
3195 LIST_PREPEND(callbacks, bus->filter_callbacks, &s->filter_callback);
3196
3197 if (slot)
3198 *slot = s;
3199
3200 return 0;
3201 }
3202
3203 static int add_match_callback(
3204 sd_bus_message *m,
3205 void *userdata,
3206 sd_bus_error *ret_error) {
3207
3208 sd_bus_slot *match_slot = userdata;
3209 bool failed = false;
3210 int r;
3211
3212 assert(m);
3213 assert(match_slot);
3214
3215 sd_bus_slot_ref(match_slot);
3216
3217 if (sd_bus_message_is_method_error(m, NULL)) {
3218 log_debug_errno(sd_bus_message_get_errno(m),
3219 "Unable to add match %s, failing connection: %s",
3220 match_slot->match_callback.match_string,
3221 sd_bus_message_get_error(m)->message);
3222
3223 failed = true;
3224 } else
3225 log_debug("Match %s successfully installed.", match_slot->match_callback.match_string);
3226
3227 if (match_slot->match_callback.install_callback) {
3228 sd_bus *bus;
3229
3230 bus = sd_bus_message_get_bus(m);
3231
3232 /* This function has been called as slot handler, and we want to call another slot handler. Let's
3233 * update the slot callback metadata temporarily with our own data, and then revert back to the old
3234 * values. */
3235
3236 assert(bus->current_slot == match_slot->match_callback.install_slot);
3237 assert(bus->current_handler == add_match_callback);
3238 assert(bus->current_userdata == userdata);
3239
3240 bus->current_slot = match_slot;
3241 bus->current_handler = match_slot->match_callback.install_callback;
3242 bus->current_userdata = match_slot->userdata;
3243
3244 r = match_slot->match_callback.install_callback(m, match_slot->userdata, ret_error);
3245
3246 bus->current_slot = match_slot->match_callback.install_slot;
3247 bus->current_handler = add_match_callback;
3248 bus->current_userdata = userdata;
3249 } else {
3250 if (failed) /* Generic failure handling: destroy the connection */
3251 bus_enter_closing(sd_bus_message_get_bus(m));
3252
3253 r = 1;
3254 }
3255
3256 /* We don't need the install method reply slot anymore, let's free it */
3257 match_slot->match_callback.install_slot = sd_bus_slot_unref(match_slot->match_callback.install_slot);
3258
3259 if (failed && match_slot->floating)
3260 bus_slot_disconnect(match_slot, true);
3261
3262 sd_bus_slot_unref(match_slot);
3263
3264 return r;
3265 }
3266
3267 static int bus_add_match_full(
3268 sd_bus *bus,
3269 sd_bus_slot **slot,
3270 bool asynchronous,
3271 const char *match,
3272 sd_bus_message_handler_t callback,
3273 sd_bus_message_handler_t install_callback,
3274 void *userdata) {
3275
3276 struct bus_match_component *components = NULL;
3277 unsigned n_components = 0;
3278 sd_bus_slot *s = NULL;
3279 int r = 0;
3280
3281 assert_return(bus, -EINVAL);
3282 assert_return(bus = bus_resolve(bus), -ENOPKG);
3283 assert_return(match, -EINVAL);
3284 assert_return(!bus_pid_changed(bus), -ECHILD);
3285
3286 r = bus_match_parse(match, &components, &n_components);
3287 if (r < 0)
3288 goto finish;
3289
3290 s = bus_slot_allocate(bus, !slot, BUS_MATCH_CALLBACK, sizeof(struct match_callback), userdata);
3291 if (!s) {
3292 r = -ENOMEM;
3293 goto finish;
3294 }
3295
3296 s->match_callback.callback = callback;
3297 s->match_callback.install_callback = install_callback;
3298
3299 if (bus->bus_client) {
3300 enum bus_match_scope scope;
3301
3302 scope = bus_match_get_scope(components, n_components);
3303
3304 /* Do not install server-side matches for matches against the local service, interface or bus path. */
3305 if (scope != BUS_MATCH_LOCAL) {
3306
3307 /* We store the original match string, so that we can use it to remove the match again. */
3308
3309 s->match_callback.match_string = strdup(match);
3310 if (!s->match_callback.match_string) {
3311 r = -ENOMEM;
3312 goto finish;
3313 }
3314
3315 if (asynchronous) {
3316 r = bus_add_match_internal_async(bus,
3317 &s->match_callback.install_slot,
3318 s->match_callback.match_string,
3319 add_match_callback,
3320 s);
3321
3322 if (r < 0)
3323 return r;
3324
3325 /* Make the slot of the match call floating now. We need the reference, but we don't
3326 * want that this match pins the bus object, hence we first create it non-floating, but
3327 * then make it floating. */
3328 r = sd_bus_slot_set_floating(s->match_callback.install_slot, true);
3329 } else
3330 r = bus_add_match_internal(bus, s->match_callback.match_string, &s->match_callback.after);
3331 if (r < 0)
3332 goto finish;
3333
3334 s->match_added = true;
3335 }
3336 }
3337
3338 bus->match_callbacks_modified = true;
3339 r = bus_match_add(&bus->match_callbacks, components, n_components, &s->match_callback);
3340 if (r < 0)
3341 goto finish;
3342
3343 if (slot)
3344 *slot = s;
3345 s = NULL;
3346
3347 finish:
3348 bus_match_parse_free(components, n_components);
3349 sd_bus_slot_unref(s);
3350
3351 return r;
3352 }
3353
3354 _public_ int sd_bus_add_match(
3355 sd_bus *bus,
3356 sd_bus_slot **slot,
3357 const char *match,
3358 sd_bus_message_handler_t callback,
3359 void *userdata) {
3360
3361 return bus_add_match_full(bus, slot, false, match, callback, NULL, userdata);
3362 }
3363
3364 _public_ int sd_bus_add_match_async(
3365 sd_bus *bus,
3366 sd_bus_slot **slot,
3367 const char *match,
3368 sd_bus_message_handler_t callback,
3369 sd_bus_message_handler_t install_callback,
3370 void *userdata) {
3371
3372 return bus_add_match_full(bus, slot, true, match, callback, install_callback, userdata);
3373 }
3374
3375 bool bus_pid_changed(sd_bus *bus) {
3376 assert(bus);
3377
3378 /* We don't support people creating a bus connection and
3379 * keeping it around over a fork(). Let's complain. */
3380
3381 return bus->original_pid != getpid_cached();
3382 }
3383
3384 static int io_callback(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
3385 sd_bus *bus = userdata;
3386 int r;
3387
3388 assert(bus);
3389
3390 /* Note that this is called both on input_fd, output_fd as well as inotify_fd events */
3391
3392 r = sd_bus_process(bus, NULL);
3393 if (r < 0) {
3394 log_debug_errno(r, "Processing of bus failed, closing down: %m");
3395 bus_enter_closing(bus);
3396 }
3397
3398 return 1;
3399 }
3400
3401 static int time_callback(sd_event_source *s, uint64_t usec, void *userdata) {
3402 sd_bus *bus = userdata;
3403 int r;
3404
3405 assert(bus);
3406
3407 r = sd_bus_process(bus, NULL);
3408 if (r < 0) {
3409 log_debug_errno(r, "Processing of bus failed, closing down: %m");
3410 bus_enter_closing(bus);
3411 }
3412
3413 return 1;
3414 }
3415
3416 static int prepare_callback(sd_event_source *s, void *userdata) {
3417 sd_bus *bus = userdata;
3418 int r, e;
3419 usec_t until;
3420
3421 assert(s);
3422 assert(bus);
3423
3424 e = sd_bus_get_events(bus);
3425 if (e < 0) {
3426 r = e;
3427 goto fail;
3428 }
3429
3430 if (bus->output_fd != bus->input_fd) {
3431
3432 r = sd_event_source_set_io_events(bus->input_io_event_source, e & POLLIN);
3433 if (r < 0)
3434 goto fail;
3435
3436 r = sd_event_source_set_io_events(bus->output_io_event_source, e & POLLOUT);
3437 } else
3438 r = sd_event_source_set_io_events(bus->input_io_event_source, e);
3439 if (r < 0)
3440 goto fail;
3441
3442 r = sd_bus_get_timeout(bus, &until);
3443 if (r < 0)
3444 goto fail;
3445 if (r > 0) {
3446 int j;
3447
3448 j = sd_event_source_set_time(bus->time_event_source, until);
3449 if (j < 0) {
3450 r = j;
3451 goto fail;
3452 }
3453 }
3454
3455 r = sd_event_source_set_enabled(bus->time_event_source, r > 0);
3456 if (r < 0)
3457 goto fail;
3458
3459 return 1;
3460
3461 fail:
3462 log_debug_errno(r, "Preparing of bus events failed, closing down: %m");
3463 bus_enter_closing(bus);
3464
3465 return 1;
3466 }
3467
3468 static int quit_callback(sd_event_source *event, void *userdata) {
3469 sd_bus *bus = userdata;
3470
3471 assert(event);
3472
3473 if (bus->close_on_exit) {
3474 sd_bus_flush(bus);
3475 sd_bus_close(bus);
3476 }
3477
3478 return 1;
3479 }
3480
3481 int bus_attach_io_events(sd_bus *bus) {
3482 int r;
3483
3484 assert(bus);
3485
3486 if (bus->input_fd < 0)
3487 return 0;
3488
3489 if (!bus->event)
3490 return 0;
3491
3492 if (!bus->input_io_event_source) {
3493 r = sd_event_add_io(bus->event, &bus->input_io_event_source, bus->input_fd, 0, io_callback, bus);
3494 if (r < 0)
3495 return r;
3496
3497 r = sd_event_source_set_prepare(bus->input_io_event_source, prepare_callback);
3498 if (r < 0)
3499 return r;
3500
3501 r = sd_event_source_set_priority(bus->input_io_event_source, bus->event_priority);
3502 if (r < 0)
3503 return r;
3504
3505 r = sd_event_source_set_description(bus->input_io_event_source, "bus-input");
3506 } else
3507 r = sd_event_source_set_io_fd(bus->input_io_event_source, bus->input_fd);
3508
3509 if (r < 0)
3510 return r;
3511
3512 if (bus->output_fd != bus->input_fd) {
3513 assert(bus->output_fd >= 0);
3514
3515 if (!bus->output_io_event_source) {
3516 r = sd_event_add_io(bus->event, &bus->output_io_event_source, bus->output_fd, 0, io_callback, bus);
3517 if (r < 0)
3518 return r;
3519
3520 r = sd_event_source_set_priority(bus->output_io_event_source, bus->event_priority);
3521 if (r < 0)
3522 return r;
3523
3524 r = sd_event_source_set_description(bus->input_io_event_source, "bus-output");
3525 } else
3526 r = sd_event_source_set_io_fd(bus->output_io_event_source, bus->output_fd);
3527
3528 if (r < 0)
3529 return r;
3530 }
3531
3532 return 0;
3533 }
3534
3535 static void bus_detach_io_events(sd_bus *bus) {
3536 assert(bus);
3537
3538 if (bus->input_io_event_source) {
3539 sd_event_source_set_enabled(bus->input_io_event_source, SD_EVENT_OFF);
3540 bus->input_io_event_source = sd_event_source_unref(bus->input_io_event_source);
3541 }
3542
3543 if (bus->output_io_event_source) {
3544 sd_event_source_set_enabled(bus->output_io_event_source, SD_EVENT_OFF);
3545 bus->output_io_event_source = sd_event_source_unref(bus->output_io_event_source);
3546 }
3547 }
3548
3549 int bus_attach_inotify_event(sd_bus *bus) {
3550 int r;
3551
3552 assert(bus);
3553
3554 if (bus->inotify_fd < 0)
3555 return 0;
3556
3557 if (!bus->event)
3558 return 0;
3559
3560 if (!bus->inotify_event_source) {
3561 r = sd_event_add_io(bus->event, &bus->inotify_event_source, bus->inotify_fd, EPOLLIN, io_callback, bus);
3562 if (r < 0)
3563 return r;
3564
3565 r = sd_event_source_set_priority(bus->inotify_event_source, bus->event_priority);
3566 if (r < 0)
3567 return r;
3568
3569 r = sd_event_source_set_description(bus->inotify_event_source, "bus-inotify");
3570 } else
3571 r = sd_event_source_set_io_fd(bus->inotify_event_source, bus->inotify_fd);
3572 if (r < 0)
3573 return r;
3574
3575 return 0;
3576 }
3577
3578 static void bus_detach_inotify_event(sd_bus *bus) {
3579 assert(bus);
3580
3581 if (bus->inotify_event_source) {
3582 sd_event_source_set_enabled(bus->inotify_event_source, SD_EVENT_OFF);
3583 bus->inotify_event_source = sd_event_source_unref(bus->inotify_event_source);
3584 }
3585 }
3586
3587 _public_ int sd_bus_attach_event(sd_bus *bus, sd_event *event, int priority) {
3588 int r;
3589
3590 assert_return(bus, -EINVAL);
3591 assert_return(bus = bus_resolve(bus), -ENOPKG);
3592 assert_return(!bus->event, -EBUSY);
3593
3594 assert(!bus->input_io_event_source);
3595 assert(!bus->output_io_event_source);
3596 assert(!bus->time_event_source);
3597
3598 if (event)
3599 bus->event = sd_event_ref(event);
3600 else {
3601 r = sd_event_default(&bus->event);
3602 if (r < 0)
3603 return r;
3604 }
3605
3606 bus->event_priority = priority;
3607
3608 r = sd_event_add_time(bus->event, &bus->time_event_source, CLOCK_MONOTONIC, 0, 0, time_callback, bus);
3609 if (r < 0)
3610 goto fail;
3611
3612 r = sd_event_source_set_priority(bus->time_event_source, priority);
3613 if (r < 0)
3614 goto fail;
3615
3616 r = sd_event_source_set_description(bus->time_event_source, "bus-time");
3617 if (r < 0)
3618 goto fail;
3619
3620 r = sd_event_add_exit(bus->event, &bus->quit_event_source, quit_callback, bus);
3621 if (r < 0)
3622 goto fail;
3623
3624 r = sd_event_source_set_description(bus->quit_event_source, "bus-exit");
3625 if (r < 0)
3626 goto fail;
3627
3628 r = bus_attach_io_events(bus);
3629 if (r < 0)
3630 goto fail;
3631
3632 r = bus_attach_inotify_event(bus);
3633 if (r < 0)
3634 goto fail;
3635
3636 return 0;
3637
3638 fail:
3639 sd_bus_detach_event(bus);
3640 return r;
3641 }
3642
3643 _public_ int sd_bus_detach_event(sd_bus *bus) {
3644 assert_return(bus, -EINVAL);
3645 assert_return(bus = bus_resolve(bus), -ENOPKG);
3646
3647 if (!bus->event)
3648 return 0;
3649
3650 bus_detach_io_events(bus);
3651 bus_detach_inotify_event(bus);
3652
3653 if (bus->time_event_source) {
3654 sd_event_source_set_enabled(bus->time_event_source, SD_EVENT_OFF);
3655 bus->time_event_source = sd_event_source_unref(bus->time_event_source);
3656 }
3657
3658 if (bus->quit_event_source) {
3659 sd_event_source_set_enabled(bus->quit_event_source, SD_EVENT_OFF);
3660 bus->quit_event_source = sd_event_source_unref(bus->quit_event_source);
3661 }
3662
3663 bus->event = sd_event_unref(bus->event);
3664 return 1;
3665 }
3666
3667 _public_ sd_event* sd_bus_get_event(sd_bus *bus) {
3668 assert_return(bus, NULL);
3669
3670 return bus->event;
3671 }
3672
3673 _public_ sd_bus_message* sd_bus_get_current_message(sd_bus *bus) {
3674 assert_return(bus, NULL);
3675
3676 return bus->current_message;
3677 }
3678
3679 _public_ sd_bus_slot* sd_bus_get_current_slot(sd_bus *bus) {
3680 assert_return(bus, NULL);
3681
3682 return bus->current_slot;
3683 }
3684
3685 _public_ sd_bus_message_handler_t sd_bus_get_current_handler(sd_bus *bus) {
3686 assert_return(bus, NULL);
3687
3688 return bus->current_handler;
3689 }
3690
3691 _public_ void* sd_bus_get_current_userdata(sd_bus *bus) {
3692 assert_return(bus, NULL);
3693
3694 return bus->current_userdata;
3695 }
3696
3697 static int bus_default(int (*bus_open)(sd_bus **), sd_bus **default_bus, sd_bus **ret) {
3698 sd_bus *b = NULL;
3699 int r;
3700
3701 assert(bus_open);
3702 assert(default_bus);
3703
3704 if (!ret)
3705 return !!*default_bus;
3706
3707 if (*default_bus) {
3708 *ret = sd_bus_ref(*default_bus);
3709 return 0;
3710 }
3711
3712 r = bus_open(&b);
3713 if (r < 0)
3714 return r;
3715
3716 b->default_bus_ptr = default_bus;
3717 b->tid = gettid();
3718 *default_bus = b;
3719
3720 *ret = b;
3721 return 1;
3722 }
3723
3724 _public_ int sd_bus_default_system(sd_bus **ret) {
3725 return bus_default(sd_bus_open_system, &default_system_bus, ret);
3726 }
3727
3728 _public_ int sd_bus_default_user(sd_bus **ret) {
3729 return bus_default(sd_bus_open_user, &default_user_bus, ret);
3730 }
3731
3732 _public_ int sd_bus_default(sd_bus **ret) {
3733 int (*bus_open)(sd_bus **) = NULL;
3734 sd_bus **busp;
3735
3736 busp = bus_choose_default(&bus_open);
3737 return bus_default(bus_open, busp, ret);
3738 }
3739
3740 _public_ int sd_bus_get_tid(sd_bus *b, pid_t *tid) {
3741 assert_return(b, -EINVAL);
3742 assert_return(tid, -EINVAL);
3743 assert_return(!bus_pid_changed(b), -ECHILD);
3744
3745 if (b->tid != 0) {
3746 *tid = b->tid;
3747 return 0;
3748 }
3749
3750 if (b->event)
3751 return sd_event_get_tid(b->event, tid);
3752
3753 return -ENXIO;
3754 }
3755
3756 _public_ int sd_bus_path_encode(const char *prefix, const char *external_id, char **ret_path) {
3757 _cleanup_free_ char *e = NULL;
3758 char *ret;
3759
3760 assert_return(object_path_is_valid(prefix), -EINVAL);
3761 assert_return(external_id, -EINVAL);
3762 assert_return(ret_path, -EINVAL);
3763
3764 e = bus_label_escape(external_id);
3765 if (!e)
3766 return -ENOMEM;
3767
3768 ret = path_join(prefix, e);
3769 if (!ret)
3770 return -ENOMEM;
3771
3772 *ret_path = ret;
3773 return 0;
3774 }
3775
3776 _public_ int sd_bus_path_decode(const char *path, const char *prefix, char **external_id) {
3777 const char *e;
3778 char *ret;
3779
3780 assert_return(object_path_is_valid(path), -EINVAL);
3781 assert_return(object_path_is_valid(prefix), -EINVAL);
3782 assert_return(external_id, -EINVAL);
3783
3784 e = object_path_startswith(path, prefix);
3785 if (!e) {
3786 *external_id = NULL;
3787 return 0;
3788 }
3789
3790 ret = bus_label_unescape(e);
3791 if (!ret)
3792 return -ENOMEM;
3793
3794 *external_id = ret;
3795 return 1;
3796 }
3797
3798 _public_ int sd_bus_path_encode_many(char **out, const char *path_template, ...) {
3799 _cleanup_strv_free_ char **labels = NULL;
3800 char *path, *path_pos, **label_pos;
3801 const char *sep, *template_pos;
3802 size_t path_length;
3803 va_list list;
3804 int r;
3805
3806 assert_return(out, -EINVAL);
3807 assert_return(path_template, -EINVAL);
3808
3809 path_length = strlen(path_template);
3810
3811 va_start(list, path_template);
3812 for (sep = strchr(path_template, '%'); sep; sep = strchr(sep + 1, '%')) {
3813 const char *arg;
3814 char *label;
3815
3816 arg = va_arg(list, const char *);
3817 if (!arg) {
3818 va_end(list);
3819 return -EINVAL;
3820 }
3821
3822 label = bus_label_escape(arg);
3823 if (!label) {
3824 va_end(list);
3825 return -ENOMEM;
3826 }
3827
3828 r = strv_consume(&labels, label);
3829 if (r < 0) {
3830 va_end(list);
3831 return r;
3832 }
3833
3834 /* add label length, but account for the format character */
3835 path_length += strlen(label) - 1;
3836 }
3837 va_end(list);
3838
3839 path = malloc(path_length + 1);
3840 if (!path)
3841 return -ENOMEM;
3842
3843 path_pos = path;
3844 label_pos = labels;
3845
3846 for (template_pos = path_template; *template_pos; ) {
3847 sep = strchrnul(template_pos, '%');
3848 path_pos = mempcpy(path_pos, template_pos, sep - template_pos);
3849 if (!*sep)
3850 break;
3851
3852 path_pos = stpcpy(path_pos, *label_pos++);
3853 template_pos = sep + 1;
3854 }
3855
3856 *path_pos = 0;
3857 *out = path;
3858 return 0;
3859 }
3860
3861 _public_ int sd_bus_path_decode_many(const char *path, const char *path_template, ...) {
3862 _cleanup_strv_free_ char **labels = NULL;
3863 const char *template_pos, *path_pos;
3864 char **label_pos;
3865 va_list list;
3866 int r;
3867
3868 /*
3869 * This decodes an object-path based on a template argument. The
3870 * template consists of a verbatim path, optionally including special
3871 * directives:
3872 *
3873 * - Each occurrence of '%' in the template matches an arbitrary
3874 * substring of a label in the given path. At most one such
3875 * directive is allowed per label. For each such directive, the
3876 * caller must provide an output parameter (char **) via va_arg. If
3877 * NULL is passed, the given label is verified, but not returned.
3878 * For each matched label, the *decoded* label is stored in the
3879 * passed output argument, and the caller is responsible to free
3880 * it. Note that the output arguments are only modified if the
3881 * actually path matched the template. Otherwise, they're left
3882 * untouched.
3883 *
3884 * This function returns <0 on error, 0 if the path does not match the
3885 * template, 1 if it matched.
3886 */
3887
3888 assert_return(path, -EINVAL);
3889 assert_return(path_template, -EINVAL);
3890
3891 path_pos = path;
3892
3893 for (template_pos = path_template; *template_pos; ) {
3894 const char *sep;
3895 size_t length;
3896 char *label;
3897
3898 /* verify everything until the next '%' matches verbatim */
3899 sep = strchrnul(template_pos, '%');
3900 length = sep - template_pos;
3901 if (strncmp(path_pos, template_pos, length))
3902 return 0;
3903
3904 path_pos += length;
3905 template_pos += length;
3906
3907 if (!*template_pos)
3908 break;
3909
3910 /* We found the next '%' character. Everything up until here
3911 * matched. We now skip ahead to the end of this label and make
3912 * sure it matches the tail of the label in the path. Then we
3913 * decode the string in-between and save it for later use. */
3914
3915 ++template_pos; /* skip over '%' */
3916
3917 sep = strchrnul(template_pos, '/');
3918 length = sep - template_pos; /* length of suffix to match verbatim */
3919
3920 /* verify the suffixes match */
3921 sep = strchrnul(path_pos, '/');
3922 if (sep - path_pos < (ssize_t)length ||
3923 strncmp(sep - length, template_pos, length))
3924 return 0;
3925
3926 template_pos += length; /* skip over matched label */
3927 length = sep - path_pos - length; /* length of sub-label to decode */
3928
3929 /* store unescaped label for later use */
3930 label = bus_label_unescape_n(path_pos, length);
3931 if (!label)
3932 return -ENOMEM;
3933
3934 r = strv_consume(&labels, label);
3935 if (r < 0)
3936 return r;
3937
3938 path_pos = sep; /* skip decoded label and suffix */
3939 }
3940
3941 /* end of template must match end of path */
3942 if (*path_pos)
3943 return 0;
3944
3945 /* copy the labels over to the caller */
3946 va_start(list, path_template);
3947 for (label_pos = labels; label_pos && *label_pos; ++label_pos) {
3948 char **arg;
3949
3950 arg = va_arg(list, char **);
3951 if (arg)
3952 *arg = *label_pos;
3953 else
3954 free(*label_pos);
3955 }
3956 va_end(list);
3957
3958 labels = mfree(labels);
3959 return 1;
3960 }
3961
3962 _public_ int sd_bus_try_close(sd_bus *bus) {
3963 assert_return(bus, -EINVAL);
3964 assert_return(bus = bus_resolve(bus), -ENOPKG);
3965 assert_return(!bus_pid_changed(bus), -ECHILD);
3966
3967 return -EOPNOTSUPP;
3968 }
3969
3970 _public_ int sd_bus_get_description(sd_bus *bus, const char **description) {
3971 assert_return(bus, -EINVAL);
3972 assert_return(bus = bus_resolve(bus), -ENOPKG);
3973 assert_return(description, -EINVAL);
3974 assert_return(bus->description, -ENXIO);
3975 assert_return(!bus_pid_changed(bus), -ECHILD);
3976
3977 if (bus->description)
3978 *description = bus->description;
3979 else if (bus->is_system)
3980 *description = "system";
3981 else if (bus->is_user)
3982 *description = "user";
3983 else
3984 *description = NULL;
3985
3986 return 0;
3987 }
3988
3989 _public_ int sd_bus_get_scope(sd_bus *bus, const char **scope) {
3990 assert_return(bus, -EINVAL);
3991 assert_return(bus = bus_resolve(bus), -ENOPKG);
3992 assert_return(scope, -EINVAL);
3993 assert_return(!bus_pid_changed(bus), -ECHILD);
3994
3995 if (bus->is_user) {
3996 *scope = "user";
3997 return 0;
3998 }
3999
4000 if (bus->is_system) {
4001 *scope = "system";
4002 return 0;
4003 }
4004
4005 return -ENODATA;
4006 }
4007
4008 _public_ int sd_bus_get_address(sd_bus *bus, const char **address) {
4009
4010 assert_return(bus, -EINVAL);
4011 assert_return(bus = bus_resolve(bus), -ENOPKG);
4012 assert_return(address, -EINVAL);
4013 assert_return(!bus_pid_changed(bus), -ECHILD);
4014
4015 if (bus->address) {
4016 *address = bus->address;
4017 return 0;
4018 }
4019
4020 return -ENODATA;
4021 }
4022
4023 _public_ int sd_bus_get_creds_mask(sd_bus *bus, uint64_t *mask) {
4024 assert_return(bus, -EINVAL);
4025 assert_return(bus = bus_resolve(bus), -ENOPKG);
4026 assert_return(mask, -EINVAL);
4027 assert_return(!bus_pid_changed(bus), -ECHILD);
4028
4029 *mask = bus->creds_mask;
4030 return 0;
4031 }
4032
4033 _public_ int sd_bus_is_bus_client(sd_bus *bus) {
4034 assert_return(bus, -EINVAL);
4035 assert_return(bus = bus_resolve(bus), -ENOPKG);
4036 assert_return(!bus_pid_changed(bus), -ECHILD);
4037
4038 return bus->bus_client;
4039 }
4040
4041 _public_ int sd_bus_is_server(sd_bus *bus) {
4042 assert_return(bus, -EINVAL);
4043 assert_return(bus = bus_resolve(bus), -ENOPKG);
4044 assert_return(!bus_pid_changed(bus), -ECHILD);
4045
4046 return bus->is_server;
4047 }
4048
4049 _public_ int sd_bus_is_anonymous(sd_bus *bus) {
4050 assert_return(bus, -EINVAL);
4051 assert_return(bus = bus_resolve(bus), -ENOPKG);
4052 assert_return(!bus_pid_changed(bus), -ECHILD);
4053
4054 return bus->anonymous_auth;
4055 }
4056
4057 _public_ int sd_bus_is_trusted(sd_bus *bus) {
4058 assert_return(bus, -EINVAL);
4059 assert_return(bus = bus_resolve(bus), -ENOPKG);
4060 assert_return(!bus_pid_changed(bus), -ECHILD);
4061
4062 return bus->trusted;
4063 }
4064
4065 _public_ int sd_bus_is_monitor(sd_bus *bus) {
4066 assert_return(bus, -EINVAL);
4067 assert_return(bus = bus_resolve(bus), -ENOPKG);
4068 assert_return(!bus_pid_changed(bus), -ECHILD);
4069
4070 return bus->is_monitor;
4071 }
4072
4073 static void flush_close(sd_bus *bus) {
4074 if (!bus)
4075 return;
4076
4077 /* Flushes and closes the specified bus. We take a ref before,
4078 * to ensure the flushing does not cause the bus to be
4079 * unreferenced. */
4080
4081 sd_bus_flush_close_unref(sd_bus_ref(bus));
4082 }
4083
4084 _public_ void sd_bus_default_flush_close(void) {
4085 flush_close(default_starter_bus);
4086 flush_close(default_user_bus);
4087 flush_close(default_system_bus);
4088 }
4089
4090 _public_ int sd_bus_set_exit_on_disconnect(sd_bus *bus, int b) {
4091 assert_return(bus, -EINVAL);
4092 assert_return(bus = bus_resolve(bus), -ENOPKG);
4093
4094 /* Turns on exit-on-disconnect, and triggers it immediately if the bus connection was already
4095 * disconnected. Note that this is triggered exclusively on disconnections triggered by the server side, never
4096 * from the client side. */
4097 bus->exit_on_disconnect = b;
4098
4099 /* If the exit condition was triggered already, exit immediately. */
4100 return bus_exit_now(bus);
4101 }
4102
4103 _public_ int sd_bus_get_exit_on_disconnect(sd_bus *bus) {
4104 assert_return(bus, -EINVAL);
4105 assert_return(bus = bus_resolve(bus), -ENOPKG);
4106
4107 return bus->exit_on_disconnect;
4108 }
4109
4110 _public_ int sd_bus_set_sender(sd_bus *bus, const char *sender) {
4111 assert_return(bus, -EINVAL);
4112 assert_return(bus = bus_resolve(bus), -ENOPKG);
4113 assert_return(!bus->bus_client, -EPERM);
4114 assert_return(!sender || service_name_is_valid(sender), -EINVAL);
4115
4116 return free_and_strdup(&bus->patch_sender, sender);
4117 }
4118
4119 _public_ int sd_bus_get_sender(sd_bus *bus, const char **ret) {
4120 assert_return(bus, -EINVAL);
4121 assert_return(bus = bus_resolve(bus), -ENOPKG);
4122 assert_return(ret, -EINVAL);
4123
4124 if (!bus->patch_sender)
4125 return -ENODATA;
4126
4127 *ret = bus->patch_sender;
4128 return 0;
4129 }
4130
4131 _public_ int sd_bus_get_n_queued_read(sd_bus *bus, uint64_t *ret) {
4132 assert_return(bus, -EINVAL);
4133 assert_return(bus = bus_resolve(bus), -ENOPKG);
4134 assert_return(!bus_pid_changed(bus), -ECHILD);
4135 assert_return(ret, -EINVAL);
4136
4137 *ret = bus->rqueue_size;
4138 return 0;
4139 }
4140
4141 _public_ int sd_bus_get_n_queued_write(sd_bus *bus, uint64_t *ret) {
4142 assert_return(bus, -EINVAL);
4143 assert_return(bus = bus_resolve(bus), -ENOPKG);
4144 assert_return(!bus_pid_changed(bus), -ECHILD);
4145 assert_return(ret, -EINVAL);
4146
4147 *ret = bus->wqueue_size;
4148 return 0;
4149 }
4150
4151 _public_ int sd_bus_set_method_call_timeout(sd_bus *bus, uint64_t usec) {
4152 assert_return(bus, -EINVAL);
4153 assert_return(bus = bus_resolve(bus), -ENOPKG);
4154
4155 bus->method_call_timeout = usec;
4156 return 0;
4157 }
4158
4159 _public_ int sd_bus_get_method_call_timeout(sd_bus *bus, uint64_t *ret) {
4160 const char *e;
4161 usec_t usec;
4162
4163 assert_return(bus, -EINVAL);
4164 assert_return(bus = bus_resolve(bus), -ENOPKG);
4165 assert_return(ret, -EINVAL);
4166
4167 if (bus->method_call_timeout != 0) {
4168 *ret = bus->method_call_timeout;
4169 return 0;
4170 }
4171
4172 e = secure_getenv("SYSTEMD_BUS_TIMEOUT");
4173 if (e && parse_sec(e, &usec) >= 0 && usec != 0) {
4174 /* Save the parsed value to avoid multiple parsing. To change the timeout value,
4175 * use sd_bus_set_method_call_timeout() instead of setenv(). */
4176 *ret = bus->method_call_timeout = usec;
4177 return 0;
4178 }
4179
4180 *ret = bus->method_call_timeout = BUS_DEFAULT_TIMEOUT;
4181 return 0;
4182 }
4183
4184 _public_ int sd_bus_set_close_on_exit(sd_bus *bus, int b) {
4185 assert_return(bus, -EINVAL);
4186 assert_return(bus = bus_resolve(bus), -ENOPKG);
4187
4188 bus->close_on_exit = b;
4189 return 0;
4190 }
4191
4192 _public_ int sd_bus_get_close_on_exit(sd_bus *bus) {
4193 assert_return(bus, -EINVAL);
4194 assert_return(bus = bus_resolve(bus), -ENOPKG);
4195
4196 return bus->close_on_exit;
4197 }
Unnamed repository; edit this file 'description' to name the repository.