1 /* SPDX-License-Identifier: LGPL-2.1+ */
3 Copyright 2013 Lennart Poettering
13 //#include <sys/wait.h>
18 #include "alloc-util.h"
19 #include "bus-container.h"
20 #include "bus-control.h"
21 #include "bus-internal.h"
22 #include "bus-kernel.h"
23 #include "bus-label.h"
24 #include "bus-message.h"
25 #include "bus-objects.h"
26 #include "bus-protocol.h"
28 #include "bus-socket.h"
29 #include "bus-track.h"
32 #include "cgroup-util.h"
35 #include "hexdecoct.h"
36 #include "hostname-util.h"
39 #include "parse-util.h"
40 //#include "process-util.h"
41 #include "string-util.h"
45 /// Additional includes needed by elogind
46 #include "process-util.h"
48 #define log_debug_bus_message(m) \
50 sd_bus_message *_mm = (m); \
51 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", \
52 bus_message_type_to_string(_mm->header->type), \
53 strna(sd_bus_message_get_sender(_mm)), \
54 strna(sd_bus_message_get_destination(_mm)), \
55 strna(sd_bus_message_get_path(_mm)), \
56 strna(sd_bus_message_get_interface(_mm)), \
57 strna(sd_bus_message_get_member(_mm)), \
58 BUS_MESSAGE_COOKIE(_mm), \
60 strna(_mm->root_container.signature), \
61 strna(_mm->error.name), \
62 strna(_mm->error.message)); \
65 static int bus_poll(sd_bus *bus, bool need_more, uint64_t timeout_usec);
66 static void bus_detach_io_events(sd_bus *b);
67 static void bus_detach_inotify_event(sd_bus *b);
69 static thread_local sd_bus *default_system_bus = NULL;
70 static thread_local sd_bus *default_user_bus = NULL;
71 static thread_local sd_bus *default_starter_bus = NULL;
73 static sd_bus **bus_choose_default(int (**bus_open)(sd_bus **)) {
76 /* Let's try our best to reuse another cached connection. If
77 * the starter bus type is set, connect via our normal
78 * connection logic, ignoring $DBUS_STARTER_ADDRESS, so that
79 * we can share the connection with the user/system default
82 e = secure_getenv("DBUS_STARTER_BUS_TYPE");
84 if (streq(e, "system")) {
86 *bus_open = sd_bus_open_system;
87 return &default_system_bus;
88 } else if (STR_IN_SET(e, "user", "session")) {
90 *bus_open = sd_bus_open_user;
91 return &default_user_bus;
95 /* No type is specified, so we have not other option than to
96 * use the starter address if it is set. */
97 e = secure_getenv("DBUS_STARTER_ADDRESS");
100 *bus_open = sd_bus_open;
101 return &default_starter_bus;
104 /* Finally, if nothing is set use the cached connection for
107 if (cg_pid_get_owner_uid(0, NULL) >= 0) {
109 *bus_open = sd_bus_open_user;
110 return &default_user_bus;
113 *bus_open = sd_bus_open_system;
114 return &default_system_bus;
118 sd_bus *bus_resolve(sd_bus *bus) {
119 switch ((uintptr_t) bus) {
120 case (uintptr_t) SD_BUS_DEFAULT:
121 return *(bus_choose_default(NULL));
122 case (uintptr_t) SD_BUS_DEFAULT_USER:
123 return default_user_bus;
124 case (uintptr_t) SD_BUS_DEFAULT_SYSTEM:
125 return default_system_bus;
131 void bus_close_io_fds(sd_bus *b) {
134 bus_detach_io_events(b);
136 if (b->input_fd != b->output_fd)
137 safe_close(b->output_fd);
138 b->output_fd = b->input_fd = safe_close(b->input_fd);
141 void bus_close_inotify_fd(sd_bus *b) {
144 bus_detach_inotify_event(b);
146 b->inotify_fd = safe_close(b->inotify_fd);
147 b->inotify_watches = mfree(b->inotify_watches);
148 b->n_inotify_watches = 0;
151 static void bus_reset_queues(sd_bus *b) {
154 while (b->rqueue_size > 0)
155 sd_bus_message_unref(b->rqueue[--b->rqueue_size]);
157 b->rqueue = mfree(b->rqueue);
158 b->rqueue_allocated = 0;
160 while (b->wqueue_size > 0)
161 sd_bus_message_unref(b->wqueue[--b->wqueue_size]);
163 b->wqueue = mfree(b->wqueue);
164 b->wqueue_allocated = 0;
167 static sd_bus* bus_free(sd_bus *b) {
171 assert(!b->track_queue);
174 b->state = BUS_CLOSED;
176 sd_bus_detach_event(b);
178 while ((s = b->slots)) {
179 /* At this point only floating slots can still be
180 * around, because the non-floating ones keep a
181 * reference to the bus, and we thus couldn't be
182 * destructing right now... We forcibly disconnect the
183 * slots here, so that they still can be referenced by
184 * apps, but are dead. */
187 bus_slot_disconnect(s);
188 sd_bus_slot_unref(s);
191 if (b->default_bus_ptr)
192 *b->default_bus_ptr = NULL;
195 bus_close_inotify_fd(b);
200 free(b->unique_name);
201 free(b->auth_buffer);
204 free(b->cgroup_root);
205 free(b->description);
206 free(b->patch_sender);
209 strv_free(b->exec_argv);
211 close_many(b->fds, b->n_fds);
216 ordered_hashmap_free_free(b->reply_callbacks);
217 prioq_free(b->reply_callbacks_prioq);
219 assert(b->match_callbacks.type == BUS_MATCH_ROOT);
220 bus_match_free(&b->match_callbacks);
222 hashmap_free_free(b->vtable_methods);
223 hashmap_free_free(b->vtable_properties);
225 assert(hashmap_isempty(b->nodes));
226 hashmap_free(b->nodes);
230 assert_se(pthread_mutex_destroy(&b->memfd_cache_mutex) == 0);
235 DEFINE_TRIVIAL_CLEANUP_FUNC(sd_bus*, bus_free);
237 _public_ int sd_bus_new(sd_bus **ret) {
238 _cleanup_free_ sd_bus *b = NULL;
240 assert_return(ret, -EINVAL);
246 b->n_ref = REFCNT_INIT;
247 b->input_fd = b->output_fd = -1;
249 b->message_version = 1;
250 b->creds_mask |= SD_BUS_CREDS_WELL_KNOWN_NAMES|SD_BUS_CREDS_UNIQUE_NAME;
252 b->original_pid = getpid_cached();
253 b->n_groups = (size_t) -1;
255 assert_se(pthread_mutex_init(&b->memfd_cache_mutex, NULL) == 0);
257 /* We guarantee that wqueue always has space for at least one entry */
258 if (!GREEDY_REALLOC(b->wqueue, b->wqueue_allocated, 1))
265 _public_ int sd_bus_set_address(sd_bus *bus, const char *address) {
266 assert_return(bus, -EINVAL);
267 assert_return(bus = bus_resolve(bus), -ENOPKG);
268 assert_return(bus->state == BUS_UNSET, -EPERM);
269 assert_return(address, -EINVAL);
270 assert_return(!bus_pid_changed(bus), -ECHILD);
272 return free_and_strdup(&bus->address, address);
275 _public_ int sd_bus_set_fd(sd_bus *bus, int input_fd, int output_fd) {
276 assert_return(bus, -EINVAL);
277 assert_return(bus = bus_resolve(bus), -ENOPKG);
278 assert_return(bus->state == BUS_UNSET, -EPERM);
279 assert_return(input_fd >= 0, -EBADF);
280 assert_return(output_fd >= 0, -EBADF);
281 assert_return(!bus_pid_changed(bus), -ECHILD);
283 bus->input_fd = input_fd;
284 bus->output_fd = output_fd;
288 _public_ int sd_bus_set_exec(sd_bus *bus, const char *path, char *const argv[]) {
289 _cleanup_strv_free_ char **a = NULL;
292 assert_return(bus, -EINVAL);
293 assert_return(bus = bus_resolve(bus), -ENOPKG);
294 assert_return(bus->state == BUS_UNSET, -EPERM);
295 assert_return(path, -EINVAL);
296 assert_return(!strv_isempty(argv), -EINVAL);
297 assert_return(!bus_pid_changed(bus), -ECHILD);
303 r = free_and_strdup(&bus->exec_path, path);
307 return strv_free_and_replace(bus->exec_argv, a);
310 _public_ int sd_bus_set_bus_client(sd_bus *bus, int b) {
311 assert_return(bus, -EINVAL);
312 assert_return(bus = bus_resolve(bus), -ENOPKG);
313 assert_return(bus->state == BUS_UNSET, -EPERM);
314 assert_return(!bus->patch_sender, -EPERM);
315 assert_return(!bus_pid_changed(bus), -ECHILD);
317 bus->bus_client = !!b;
321 _public_ int sd_bus_set_monitor(sd_bus *bus, int b) {
322 assert_return(bus, -EINVAL);
323 assert_return(bus = bus_resolve(bus), -ENOPKG);
324 assert_return(bus->state == BUS_UNSET, -EPERM);
325 assert_return(!bus_pid_changed(bus), -ECHILD);
327 bus->is_monitor = !!b;
331 _public_ int sd_bus_negotiate_fds(sd_bus *bus, int b) {
332 assert_return(bus, -EINVAL);
333 assert_return(bus = bus_resolve(bus), -ENOPKG);
334 assert_return(bus->state == BUS_UNSET, -EPERM);
335 assert_return(!bus_pid_changed(bus), -ECHILD);
337 bus->accept_fd = !!b;
341 _public_ int sd_bus_negotiate_timestamp(sd_bus *bus, int b) {
342 assert_return(bus, -EINVAL);
343 assert_return(bus = bus_resolve(bus), -ENOPKG);
344 assert_return(!IN_SET(bus->state, BUS_CLOSING, BUS_CLOSED), -EPERM);
345 assert_return(!bus_pid_changed(bus), -ECHILD);
347 /* This is not actually supported by any of our transports these days, but we do honour it for synthetic
348 * replies, and maybe one day classic D-Bus learns this too */
349 bus->attach_timestamp = !!b;
354 _public_ int sd_bus_negotiate_creds(sd_bus *bus, int b, uint64_t mask) {
355 assert_return(bus, -EINVAL);
356 assert_return(bus = bus_resolve(bus), -ENOPKG);
357 assert_return(mask <= _SD_BUS_CREDS_ALL, -EINVAL);
358 assert_return(!IN_SET(bus->state, BUS_CLOSING, BUS_CLOSED), -EPERM);
359 assert_return(!bus_pid_changed(bus), -ECHILD);
361 SET_FLAG(bus->creds_mask, mask, b);
363 /* The well knowns we need unconditionally, so that matches can work */
364 bus->creds_mask |= SD_BUS_CREDS_WELL_KNOWN_NAMES|SD_BUS_CREDS_UNIQUE_NAME;
369 _public_ int sd_bus_set_server(sd_bus *bus, int b, sd_id128_t server_id) {
370 assert_return(bus, -EINVAL);
371 assert_return(bus = bus_resolve(bus), -ENOPKG);
372 assert_return(b || sd_id128_equal(server_id, SD_ID128_NULL), -EINVAL);
373 assert_return(bus->state == BUS_UNSET, -EPERM);
374 assert_return(!bus_pid_changed(bus), -ECHILD);
376 bus->is_server = !!b;
377 bus->server_id = server_id;
381 _public_ int sd_bus_set_anonymous(sd_bus *bus, int b) {
382 assert_return(bus, -EINVAL);
383 assert_return(bus = bus_resolve(bus), -ENOPKG);
384 assert_return(bus->state == BUS_UNSET, -EPERM);
385 assert_return(!bus_pid_changed(bus), -ECHILD);
387 bus->anonymous_auth = !!b;
391 _public_ int sd_bus_set_trusted(sd_bus *bus, int b) {
392 assert_return(bus, -EINVAL);
393 assert_return(bus = bus_resolve(bus), -ENOPKG);
394 assert_return(bus->state == BUS_UNSET, -EPERM);
395 assert_return(!bus_pid_changed(bus), -ECHILD);
401 _public_ int sd_bus_set_description(sd_bus *bus, const char *description) {
402 assert_return(bus, -EINVAL);
403 assert_return(bus = bus_resolve(bus), -ENOPKG);
404 assert_return(bus->state == BUS_UNSET, -EPERM);
405 assert_return(!bus_pid_changed(bus), -ECHILD);
407 return free_and_strdup(&bus->description, description);
410 _public_ int sd_bus_set_allow_interactive_authorization(sd_bus *bus, int b) {
411 assert_return(bus, -EINVAL);
412 assert_return(bus = bus_resolve(bus), -ENOPKG);
413 assert_return(!bus_pid_changed(bus), -ECHILD);
415 bus->allow_interactive_authorization = !!b;
419 _public_ int sd_bus_get_allow_interactive_authorization(sd_bus *bus) {
420 assert_return(bus, -EINVAL);
421 assert_return(bus = bus_resolve(bus), -ENOPKG);
422 assert_return(!bus_pid_changed(bus), -ECHILD);
424 return bus->allow_interactive_authorization;
427 _public_ int sd_bus_set_watch_bind(sd_bus *bus, int b) {
428 assert_return(bus, -EINVAL);
429 assert_return(bus = bus_resolve(bus), -ENOPKG);
430 assert_return(bus->state == BUS_UNSET, -EPERM);
431 assert_return(!bus_pid_changed(bus), -ECHILD);
433 bus->watch_bind = !!b;
437 _public_ int sd_bus_get_watch_bind(sd_bus *bus) {
438 assert_return(bus, -EINVAL);
439 assert_return(bus = bus_resolve(bus), -ENOPKG);
440 assert_return(!bus_pid_changed(bus), -ECHILD);
442 return bus->watch_bind;
445 _public_ int sd_bus_set_connected_signal(sd_bus *bus, int b) {
446 assert_return(bus, -EINVAL);
447 assert_return(bus = bus_resolve(bus), -ENOPKG);
448 assert_return(bus->state == BUS_UNSET, -EPERM);
449 assert_return(!bus_pid_changed(bus), -ECHILD);
451 bus->connected_signal = !!b;
455 _public_ int sd_bus_get_connected_signal(sd_bus *bus) {
456 assert_return(bus, -EINVAL);
457 assert_return(bus = bus_resolve(bus), -ENOPKG);
458 assert_return(!bus_pid_changed(bus), -ECHILD);
460 return bus->connected_signal;
463 static int synthesize_connected_signal(sd_bus *bus) {
464 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
469 /* If enabled, synthesizes a local "Connected" signal mirroring the local "Disconnected" signal. This is called
470 * whenever we fully established a connection, i.e. after the authorization phase, and after receiving the
471 * Hello() reply. Or in other words, whenver we enter BUS_RUNNING state.
473 * This is useful so that clients can start doing stuff whenver the connection is fully established in a way
474 * that works independently from whether we connected to a full bus or just a direct connection. */
476 if (!bus->connected_signal)
479 r = sd_bus_message_new_signal(
482 "/org/freedesktop/DBus/Local",
483 "org.freedesktop.DBus.Local",
488 bus_message_set_sender_local(bus, m);
490 r = bus_seal_synthetic_message(bus, m);
494 r = bus_rqueue_make_room(bus);
498 /* Insert at the very front */
499 memmove(bus->rqueue + 1, bus->rqueue, sizeof(sd_bus_message*) * bus->rqueue_size);
500 bus->rqueue[0] = TAKE_PTR(m);
506 void bus_set_state(sd_bus *bus, enum bus_state state) {
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",
520 assert(state < _BUS_STATE_MAX);
522 if (state == bus->state)
525 log_debug("Bus %s: changing state %s → %s", strna(bus->description), table[bus->state], table[state]);
529 static int hello_callback(sd_bus_message *reply, void *userdata, sd_bus_error *error) {
537 assert(IN_SET(bus->state, BUS_HELLO, BUS_CLOSING));
539 r = sd_bus_message_get_errno(reply);
543 r = sd_bus_message_read(reply, "s", &s);
547 if (!service_name_is_valid(s) || s[0] != ':')
550 r = free_and_strdup(&bus->unique_name, s);
554 if (bus->state == BUS_HELLO) {
555 bus_set_state(bus, BUS_RUNNING);
557 r = synthesize_connected_signal(bus);
565 static int bus_send_hello(sd_bus *bus) {
566 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
571 if (!bus->bus_client)
574 r = sd_bus_message_new_method_call(
577 "org.freedesktop.DBus",
578 "/org/freedesktop/DBus",
579 "org.freedesktop.DBus",
584 return sd_bus_call_async(bus, NULL, m, hello_callback, NULL, 0);
587 int bus_start_running(sd_bus *bus) {
588 struct reply_callback *c;
594 assert(bus->state < BUS_HELLO);
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. */
600 n = now(CLOCK_MONOTONIC);
601 ORDERED_HASHMAP_FOREACH(c, bus->reply_callbacks, i) {
602 if (c->timeout_usec == 0)
605 c->timeout_usec = usec_add(n, c->timeout_usec);
608 if (bus->bus_client) {
609 bus_set_state(bus, BUS_HELLO);
613 bus_set_state(bus, BUS_RUNNING);
615 r = synthesize_connected_signal(bus);
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;
633 if (strncmp(*p, key, l) != 0)
646 while (!IN_SET(*a, ';', ',', 0)) {
660 c = (char) ((x << 4) | y);
667 if (!GREEDY_REALLOC(r, allocated, n + 2))
685 free_and_replace(*value, r);
690 static void skip_address_key(const char **p) {
694 *p += strcspn(*p, ",");
700 static int parse_unix_address(sd_bus *b, const char **p, char **guid) {
701 _cleanup_free_ char *path = NULL, *abstract = NULL;
710 while (!IN_SET(**p, 0, ';')) {
711 r = parse_address_key(p, "guid", guid);
717 r = parse_address_key(p, "path", &path);
723 r = parse_address_key(p, "abstract", &abstract);
732 if (!path && !abstract)
735 if (path && abstract)
740 if (l > sizeof(b->sockaddr.un.sun_path))
743 b->sockaddr.un.sun_family = AF_UNIX;
744 strncpy(b->sockaddr.un.sun_path, path, sizeof(b->sockaddr.un.sun_path));
745 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + l;
746 } else if (abstract) {
747 l = strlen(abstract);
748 if (l > sizeof(b->sockaddr.un.sun_path) - 1)
751 b->sockaddr.un.sun_family = AF_UNIX;
752 b->sockaddr.un.sun_path[0] = 0;
753 strncpy(b->sockaddr.un.sun_path+1, abstract, sizeof(b->sockaddr.un.sun_path)-1);
754 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + 1 + l;
762 static int parse_tcp_address(sd_bus *b, const char **p, char **guid) {
763 _cleanup_free_ char *host = NULL, *port = NULL, *family = NULL;
765 struct addrinfo *result, hints = {
766 .ai_socktype = SOCK_STREAM,
767 .ai_flags = AI_ADDRCONFIG,
775 while (!IN_SET(**p, 0, ';')) {
776 r = parse_address_key(p, "guid", guid);
782 r = parse_address_key(p, "host", &host);
788 r = parse_address_key(p, "port", &port);
794 r = parse_address_key(p, "family", &family);
807 if (streq(family, "ipv4"))
808 hints.ai_family = AF_INET;
809 else if (streq(family, "ipv6"))
810 hints.ai_family = AF_INET6;
815 r = getaddrinfo(host, port, &hints, &result);
819 return -EADDRNOTAVAIL;
821 memcpy(&b->sockaddr, result->ai_addr, result->ai_addrlen);
822 b->sockaddr_size = result->ai_addrlen;
824 freeaddrinfo(result);
831 static int parse_exec_address(sd_bus *b, const char **p, char **guid) {
833 unsigned n_argv = 0, j;
835 size_t allocated = 0;
843 while (!IN_SET(**p, 0, ';')) {
844 r = parse_address_key(p, "guid", guid);
850 r = parse_address_key(p, "path", &path);
856 if (startswith(*p, "argv")) {
860 ul = strtoul(*p + 4, (char**) p, 10);
861 if (errno > 0 || **p != '=' || ul > 256) {
869 if (!GREEDY_REALLOC0(argv, allocated, ul + 2)) {
877 r = parse_address_key(p, NULL, argv + ul);
892 /* Make sure there are no holes in the array, with the
893 * exception of argv[0] */
894 for (j = 1; j < n_argv; j++)
900 if (argv && argv[0] == NULL) {
901 argv[0] = strdup(path);
916 for (j = 0; j < n_argv; j++)
924 static int parse_container_unix_address(sd_bus *b, const char **p, char **guid) {
925 _cleanup_free_ char *machine = NULL, *pid = NULL;
933 while (!IN_SET(**p, 0, ';')) {
934 r = parse_address_key(p, "guid", guid);
940 r = parse_address_key(p, "machine", &machine);
946 r = parse_address_key(p, "pid", &pid);
955 if (!machine == !pid)
959 if (!machine_name_is_valid(machine))
962 free_and_replace(b->machine, machine);
964 b->machine = mfree(b->machine);
968 r = parse_pid(pid, &b->nspid);
974 b->sockaddr.un.sun_family = AF_UNIX;
975 /* Note that we use the old /var/run prefix here, to increase compatibility with really old containers */
976 strncpy(b->sockaddr.un.sun_path, "/var/run/dbus/system_bus_socket", sizeof(b->sockaddr.un.sun_path));
977 b->sockaddr_size = SOCKADDR_UN_LEN(b->sockaddr.un);
983 static void bus_reset_parsed_address(sd_bus *b) {
987 b->sockaddr_size = 0;
988 b->exec_argv = strv_free(b->exec_argv);
989 b->exec_path = mfree(b->exec_path);
990 b->server_id = SD_ID128_NULL;
991 b->machine = mfree(b->machine);
995 static int bus_parse_next_address(sd_bus *b) {
996 _cleanup_free_ char *guid = NULL;
1004 if (b->address[b->address_index] == 0)
1007 bus_reset_parsed_address(b);
1009 a = b->address + b->address_index;
1018 if (startswith(a, "unix:")) {
1021 r = parse_unix_address(b, &a, &guid);
1026 } else if (startswith(a, "tcp:")) {
1029 r = parse_tcp_address(b, &a, &guid);
1035 } else if (startswith(a, "unixexec:")) {
1038 r = parse_exec_address(b, &a, &guid);
1044 } else if (startswith(a, "x-machine-unix:")) {
1047 r = parse_container_unix_address(b, &a, &guid);
1060 r = sd_id128_from_string(guid, &b->server_id);
1065 b->address_index = a - b->address;
1069 static void bus_kill_exec(sd_bus *bus) {
1070 if (pid_is_valid(bus->busexec_pid) > 0) {
1071 sigterm_wait(bus->busexec_pid);
1072 bus->busexec_pid = 0;
1076 static int bus_start_address(sd_bus *b) {
1082 bus_close_io_fds(b);
1083 bus_close_inotify_fd(b);
1087 /* If you provide multiple different bus-addresses, we
1088 * try all of them in order and use the first one that
1092 r = bus_socket_exec(b);
1093 else if ((b->nspid > 0 || b->machine) && b->sockaddr.sa.sa_family != AF_UNSPEC)
1094 r = bus_container_connect_socket(b);
1095 else if (b->sockaddr.sa.sa_family != AF_UNSPEC)
1096 r = bus_socket_connect(b);
1103 q = bus_attach_io_events(b);
1107 q = bus_attach_inotify_event(b);
1114 b->last_connect_error = -r;
1117 r = bus_parse_next_address(b);
1121 return b->last_connect_error > 0 ? -b->last_connect_error : -ECONNREFUSED;
1125 int bus_next_address(sd_bus *b) {
1128 bus_reset_parsed_address(b);
1129 return bus_start_address(b);
1132 static int bus_start_fd(sd_bus *b) {
1137 assert(b->input_fd >= 0);
1138 assert(b->output_fd >= 0);
1140 r = fd_nonblock(b->input_fd, true);
1144 r = fd_cloexec(b->input_fd, true);
1148 if (b->input_fd != b->output_fd) {
1149 r = fd_nonblock(b->output_fd, true);
1153 r = fd_cloexec(b->output_fd, true);
1158 if (fstat(b->input_fd, &st) < 0)
1161 return bus_socket_take_fd(b);
1164 _public_ int sd_bus_start(sd_bus *bus) {
1167 assert_return(bus, -EINVAL);
1168 assert_return(bus = bus_resolve(bus), -ENOPKG);
1169 assert_return(bus->state == BUS_UNSET, -EPERM);
1170 assert_return(!bus_pid_changed(bus), -ECHILD);
1172 bus_set_state(bus, BUS_OPENING);
1174 if (bus->is_server && bus->bus_client)
1177 if (bus->input_fd >= 0)
1178 r = bus_start_fd(bus);
1179 else if (bus->address || bus->sockaddr.sa.sa_family != AF_UNSPEC || bus->exec_path || bus->machine)
1180 r = bus_start_address(bus);
1189 return bus_send_hello(bus);
1192 _public_ int sd_bus_open_with_description(sd_bus **ret, const char *description) {
1194 _cleanup_(bus_freep) sd_bus *b = NULL;
1197 assert_return(ret, -EINVAL);
1199 /* Let's connect to the starter bus if it is set, and
1200 * otherwise to the bus that is appropropriate for the scope
1201 * we are running in */
1203 e = secure_getenv("DBUS_STARTER_BUS_TYPE");
1205 if (streq(e, "system"))
1206 return sd_bus_open_system_with_description(ret, description);
1207 #if 0 /// elogind does not support systemd user instances
1208 else if (STR_IN_SET(e, "session", "user"))
1210 return sd_bus_open_user_with_description(ret, description);
1213 e = secure_getenv("DBUS_STARTER_ADDRESS");
1215 #if 0 /// elogind does not support systemd user instances
1216 if (cg_pid_get_owner_uid(0, NULL) >= 0)
1217 return sd_bus_open_user_with_description(ret, description);
1220 return sd_bus_open_system_with_description(ret, description);
1227 r = sd_bus_set_address(b, e);
1231 b->bus_client = true;
1233 /* We don't know whether the bus is trusted or not, so better
1234 * be safe, and authenticate everything */
1236 b->is_local = false;
1237 b->creds_mask |= SD_BUS_CREDS_UID | SD_BUS_CREDS_EUID | SD_BUS_CREDS_EFFECTIVE_CAPS;
1239 r = sd_bus_start(b);
1247 _public_ int sd_bus_open(sd_bus **ret) {
1248 return sd_bus_open_with_description(ret, NULL);
1251 int bus_set_address_system(sd_bus *b) {
1255 e = secure_getenv("DBUS_SYSTEM_BUS_ADDRESS");
1257 return sd_bus_set_address(b, e);
1259 return sd_bus_set_address(b, DEFAULT_SYSTEM_BUS_ADDRESS);
1262 _public_ int sd_bus_open_system_with_description(sd_bus **ret, const char *description) {
1263 _cleanup_(bus_freep) sd_bus *b = NULL;
1266 assert_return(ret, -EINVAL);
1273 r = sd_bus_set_description(b, description);
1278 r = bus_set_address_system(b);
1282 b->bus_client = true;
1283 b->is_system = true;
1285 /* Let's do per-method access control on the system bus. We
1286 * need the caller's UID and capability set for that. */
1288 b->creds_mask |= SD_BUS_CREDS_UID | SD_BUS_CREDS_EUID | SD_BUS_CREDS_EFFECTIVE_CAPS;
1291 r = sd_bus_start(b);
1299 _public_ int sd_bus_open_system(sd_bus **ret) {
1300 return sd_bus_open_system_with_description(ret, NULL);
1303 #if 0 /// elogind can not open/use a user bus
1304 int bus_set_address_user(sd_bus *b) {
1306 _cleanup_free_ char *ee = NULL, *s = NULL;
1310 e = secure_getenv("DBUS_SESSION_BUS_ADDRESS");
1312 return sd_bus_set_address(b, e);
1314 e = secure_getenv("XDG_RUNTIME_DIR");
1318 ee = bus_address_escape(e);
1322 if (asprintf(&s, DEFAULT_USER_BUS_ADDRESS_FMT, ee) < 0)
1325 b->address = TAKE_PTR(s);
1331 _public_ int sd_bus_open_user_with_description(sd_bus **ret, const char *description) {
1332 #if 0 /// elogind does not support user buses
1333 _cleanup_(bus_freep) sd_bus *b = NULL;
1336 assert_return(ret, -EINVAL);
1343 r = sd_bus_set_description(b, description);
1348 r = bus_set_address_user(b);
1352 b->bus_client = true;
1355 /* We don't do any per-method access control on the user
1360 r = sd_bus_start(b);
1368 _public_ int sd_bus_open_user(sd_bus **ret) {
1369 return sd_bus_open_user_with_description(ret, NULL);
1371 return sd_bus_open_system(ret);
1375 int bus_set_address_system_remote(sd_bus *b, const char *host) {
1376 _cleanup_free_ char *e = NULL;
1377 char *m = NULL, *c = NULL, *a;
1382 /* Let's see if we shall enter some container */
1383 m = strchr(host, ':');
1387 /* Let's make sure this is not a port of some kind,
1388 * and is a valid machine name. */
1389 if (!in_charset(m, DIGITS) && machine_name_is_valid(m)) {
1392 /* Cut out the host part */
1393 t = strndupa(host, m - host - 1);
1394 e = bus_address_escape(t);
1398 c = strjoina(",argv5=--machine=", m);
1403 e = bus_address_escape(host);
1408 a = strjoin("unixexec:path=ssh,argv1=-xT,argv2=--,argv3=", e, ",argv4=elogind-stdio-bridge", c);
1412 return free_and_replace(b->address, a);
1415 _public_ int sd_bus_open_system_remote(sd_bus **ret, const char *host) {
1416 _cleanup_(bus_freep) sd_bus *b = NULL;
1419 assert_return(host, -EINVAL);
1420 assert_return(ret, -EINVAL);
1426 r = bus_set_address_system_remote(b, host);
1430 b->bus_client = true;
1432 b->is_system = true;
1433 b->is_local = false;
1435 r = sd_bus_start(b);
1443 int bus_set_address_system_machine(sd_bus *b, const char *machine) {
1444 _cleanup_free_ char *e = NULL;
1450 e = bus_address_escape(machine);
1454 a = strjoin("x-machine-unix:machine=", e);
1458 return free_and_replace(b->address, a);
1461 _public_ int sd_bus_open_system_machine(sd_bus **ret, const char *machine) {
1462 _cleanup_(bus_freep) sd_bus *b = NULL;
1465 assert_return(machine, -EINVAL);
1466 assert_return(ret, -EINVAL);
1467 assert_return(machine_name_is_valid(machine), -EINVAL);
1473 r = bus_set_address_system_machine(b, machine);
1477 b->bus_client = true;
1479 b->is_system = true;
1480 b->is_local = false;
1482 r = sd_bus_start(b);
1490 _public_ void sd_bus_close(sd_bus *bus) {
1493 if (bus->state == BUS_CLOSED)
1495 if (bus_pid_changed(bus))
1498 /* Don't leave ssh hanging around */
1501 bus_set_state(bus, BUS_CLOSED);
1503 sd_bus_detach_event(bus);
1505 /* Drop all queued messages so that they drop references to
1506 * the bus object and the bus may be freed */
1507 bus_reset_queues(bus);
1509 bus_close_io_fds(bus);
1510 bus_close_inotify_fd(bus);
1513 _public_ sd_bus* sd_bus_flush_close_unref(sd_bus *bus) {
1517 /* Have to do this before flush() to prevent hang */
1523 return sd_bus_unref(bus);
1526 void bus_enter_closing(sd_bus *bus) {
1529 if (!IN_SET(bus->state, BUS_WATCH_BIND, BUS_OPENING, BUS_AUTHENTICATING, BUS_HELLO, BUS_RUNNING))
1532 bus_set_state(bus, BUS_CLOSING);
1535 _public_ sd_bus *sd_bus_ref(sd_bus *bus) {
1539 assert_se(REFCNT_INC(bus->n_ref) >= 2);
1544 _public_ sd_bus *sd_bus_unref(sd_bus *bus) {
1550 i = REFCNT_DEC(bus->n_ref);
1554 return bus_free(bus);
1557 _public_ int sd_bus_is_open(sd_bus *bus) {
1558 assert_return(bus, -EINVAL);
1559 assert_return(bus = bus_resolve(bus), -ENOPKG);
1560 assert_return(!bus_pid_changed(bus), -ECHILD);
1562 return BUS_IS_OPEN(bus->state);
1565 _public_ int sd_bus_is_ready(sd_bus *bus) {
1566 assert_return(bus, -EINVAL);
1567 assert_return(bus = bus_resolve(bus), -ENOPKG);
1568 assert_return(!bus_pid_changed(bus), -ECHILD);
1570 return bus->state == BUS_RUNNING;
1573 _public_ int sd_bus_can_send(sd_bus *bus, char type) {
1576 assert_return(bus, -EINVAL);
1577 assert_return(bus = bus_resolve(bus), -ENOPKG);
1578 assert_return(bus->state != BUS_UNSET, -ENOTCONN);
1579 assert_return(!bus_pid_changed(bus), -ECHILD);
1581 if (bus->is_monitor)
1584 if (type == SD_BUS_TYPE_UNIX_FD) {
1585 if (!bus->accept_fd)
1588 r = bus_ensure_running(bus);
1592 return bus->can_fds;
1595 return bus_type_is_valid(type);
1598 _public_ int sd_bus_get_bus_id(sd_bus *bus, sd_id128_t *id) {
1601 assert_return(bus, -EINVAL);
1602 assert_return(bus = bus_resolve(bus), -ENOPKG);
1603 assert_return(id, -EINVAL);
1604 assert_return(!bus_pid_changed(bus), -ECHILD);
1606 r = bus_ensure_running(bus);
1610 *id = bus->server_id;
1614 static int bus_seal_message(sd_bus *b, sd_bus_message *m, usec_t timeout) {
1621 /* If we copy the same message to multiple
1622 * destinations, avoid using the same cookie
1624 b->cookie = MAX(b->cookie, BUS_MESSAGE_COOKIE(m));
1629 timeout = BUS_DEFAULT_TIMEOUT;
1631 if (!m->sender && b->patch_sender) {
1632 r = sd_bus_message_set_sender(m, b->patch_sender);
1637 return sd_bus_message_seal(m, ++b->cookie, timeout);
1640 static int bus_remarshal_message(sd_bus *b, sd_bus_message **m) {
1641 bool remarshal = false;
1645 /* wrong packet version */
1646 if (b->message_version != 0 && b->message_version != (*m)->header->version)
1649 /* wrong packet endianness */
1650 if (b->message_endian != 0 && b->message_endian != (*m)->header->endian)
1653 return remarshal ? bus_message_remarshal(b, m) : 0;
1656 int bus_seal_synthetic_message(sd_bus *b, sd_bus_message *m) {
1660 /* Fake some timestamps, if they were requested, and not
1661 * already initialized */
1662 if (b->attach_timestamp) {
1663 if (m->realtime <= 0)
1664 m->realtime = now(CLOCK_REALTIME);
1666 if (m->monotonic <= 0)
1667 m->monotonic = now(CLOCK_MONOTONIC);
1670 /* The bus specification says the serial number cannot be 0,
1671 * hence let's fill something in for synthetic messages. Since
1672 * synthetic messages might have a fake sender and we don't
1673 * want to interfere with the real sender's serial numbers we
1674 * pick a fixed, artificial one. We use (uint32_t) -1 rather
1675 * than (uint64_t) -1 since dbus1 only had 32bit identifiers,
1676 * even though kdbus can do 64bit. */
1677 return sd_bus_message_seal(m, 0xFFFFFFFFULL, 0);
1680 static int bus_write_message(sd_bus *bus, sd_bus_message *m, size_t *idx) {
1686 r = bus_socket_write_message(bus, m, idx);
1690 if (*idx >= BUS_MESSAGE_SIZE(m))
1691 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",
1692 bus_message_type_to_string(m->header->type),
1693 strna(sd_bus_message_get_sender(m)),
1694 strna(sd_bus_message_get_destination(m)),
1695 strna(sd_bus_message_get_path(m)),
1696 strna(sd_bus_message_get_interface(m)),
1697 strna(sd_bus_message_get_member(m)),
1698 BUS_MESSAGE_COOKIE(m),
1700 strna(m->root_container.signature),
1701 strna(m->error.name),
1702 strna(m->error.message));
1707 static int dispatch_wqueue(sd_bus *bus) {
1711 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
1713 while (bus->wqueue_size > 0) {
1715 r = bus_write_message(bus, bus->wqueue[0], &bus->windex);
1719 /* Didn't do anything this time */
1721 else if (bus->windex >= BUS_MESSAGE_SIZE(bus->wqueue[0])) {
1722 /* Fully written. Let's drop the entry from
1725 * This isn't particularly optimized, but
1726 * well, this is supposed to be our worst-case
1727 * buffer only, and the socket buffer is
1728 * supposed to be our primary buffer, and if
1729 * it got full, then all bets are off
1733 sd_bus_message_unref(bus->wqueue[0]);
1734 memmove(bus->wqueue, bus->wqueue + 1, sizeof(sd_bus_message*) * bus->wqueue_size);
1744 static int bus_read_message(sd_bus *bus, bool hint_priority, int64_t priority) {
1747 return bus_socket_read_message(bus);
1750 int bus_rqueue_make_room(sd_bus *bus) {
1753 if (bus->rqueue_size >= BUS_RQUEUE_MAX)
1756 if (!GREEDY_REALLOC(bus->rqueue, bus->rqueue_allocated, bus->rqueue_size + 1))
1762 static int dispatch_rqueue(sd_bus *bus, bool hint_priority, int64_t priority, sd_bus_message **m) {
1767 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
1769 /* Note that the priority logic is only available on kdbus,
1770 * where the rqueue is unused. We check the rqueue here
1771 * anyway, because it's simple... */
1774 if (bus->rqueue_size > 0) {
1775 /* Dispatch a queued message */
1777 *m = bus->rqueue[0];
1779 memmove(bus->rqueue, bus->rqueue + 1, sizeof(sd_bus_message*) * bus->rqueue_size);
1783 /* Try to read a new message */
1784 r = bus_read_message(bus, hint_priority, priority);
1794 _public_ int sd_bus_send(sd_bus *bus, sd_bus_message *_m, uint64_t *cookie) {
1795 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = sd_bus_message_ref(_m);
1798 assert_return(m, -EINVAL);
1803 assert_return(!bus_pid_changed(bus), -ECHILD);
1805 if (!BUS_IS_OPEN(bus->state))
1809 r = sd_bus_can_send(bus, SD_BUS_TYPE_UNIX_FD);
1816 /* If the cookie number isn't kept, then we know that no reply
1818 if (!cookie && !m->sealed)
1819 m->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
1821 r = bus_seal_message(bus, m, 0);
1825 /* Remarshall if we have to. This will possibly unref the
1826 * message and place a replacement in m */
1827 r = bus_remarshal_message(bus, &m);
1831 /* If this is a reply and no reply was requested, then let's
1832 * suppress this, if we can */
1836 if (IN_SET(bus->state, BUS_RUNNING, BUS_HELLO) && bus->wqueue_size <= 0) {
1839 r = bus_write_message(bus, m, &idx);
1841 if (IN_SET(r, -ENOTCONN, -ECONNRESET, -EPIPE, -ESHUTDOWN)) {
1842 bus_enter_closing(bus);
1849 if (idx < BUS_MESSAGE_SIZE(m)) {
1850 /* Wasn't fully written. So let's remember how
1851 * much was written. Note that the first entry
1852 * of the wqueue array is always allocated so
1853 * that we always can remember how much was
1855 bus->wqueue[0] = sd_bus_message_ref(m);
1856 bus->wqueue_size = 1;
1861 /* Just append it to the queue. */
1863 if (bus->wqueue_size >= BUS_WQUEUE_MAX)
1866 if (!GREEDY_REALLOC(bus->wqueue, bus->wqueue_allocated, bus->wqueue_size + 1))
1869 bus->wqueue[bus->wqueue_size++] = sd_bus_message_ref(m);
1874 *cookie = BUS_MESSAGE_COOKIE(m);
1879 _public_ int sd_bus_send_to(sd_bus *bus, sd_bus_message *m, const char *destination, uint64_t *cookie) {
1882 assert_return(m, -EINVAL);
1887 assert_return(!bus_pid_changed(bus), -ECHILD);
1889 if (!BUS_IS_OPEN(bus->state))
1892 if (!streq_ptr(m->destination, destination)) {
1897 r = sd_bus_message_set_destination(m, destination);
1902 return sd_bus_send(bus, m, cookie);
1905 static usec_t calc_elapse(sd_bus *bus, uint64_t usec) {
1908 if (usec == (uint64_t) -1)
1911 /* We start all timeouts the instant we enter BUS_HELLO/BUS_RUNNING state, so that the don't run in parallel
1912 * with any connection setup states. Hence, if a method callback is started earlier than that we just store the
1913 * relative timestamp, and afterwards the absolute one. */
1915 if (IN_SET(bus->state, BUS_WATCH_BIND, BUS_OPENING, BUS_AUTHENTICATING))
1918 return now(CLOCK_MONOTONIC) + usec;
1921 static int timeout_compare(const void *a, const void *b) {
1922 const struct reply_callback *x = a, *y = b;
1924 if (x->timeout_usec != 0 && y->timeout_usec == 0)
1927 if (x->timeout_usec == 0 && y->timeout_usec != 0)
1930 if (x->timeout_usec < y->timeout_usec)
1933 if (x->timeout_usec > y->timeout_usec)
1939 _public_ int sd_bus_call_async(
1943 sd_bus_message_handler_t callback,
1947 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = sd_bus_message_ref(_m);
1948 _cleanup_(sd_bus_slot_unrefp) sd_bus_slot *s = NULL;
1951 assert_return(m, -EINVAL);
1952 assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL);
1953 assert_return(!m->sealed || (!!callback == !(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED)), -EINVAL);
1958 assert_return(!bus_pid_changed(bus), -ECHILD);
1960 if (!BUS_IS_OPEN(bus->state))
1963 /* If no callback is specified and there's no interest in a slot, then there's no reason to ask for a reply */
1964 if (!callback && !slot && !m->sealed)
1965 m->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
1967 r = ordered_hashmap_ensure_allocated(&bus->reply_callbacks, &uint64_hash_ops);
1971 r = prioq_ensure_allocated(&bus->reply_callbacks_prioq, timeout_compare);
1975 r = bus_seal_message(bus, m, usec);
1979 r = bus_remarshal_message(bus, &m);
1983 if (slot || callback) {
1984 s = bus_slot_allocate(bus, !slot, BUS_REPLY_CALLBACK, sizeof(struct reply_callback), userdata);
1988 s->reply_callback.callback = callback;
1990 s->reply_callback.cookie = BUS_MESSAGE_COOKIE(m);
1991 r = ordered_hashmap_put(bus->reply_callbacks, &s->reply_callback.cookie, &s->reply_callback);
1993 s->reply_callback.cookie = 0;
1997 s->reply_callback.timeout_usec = calc_elapse(bus, m->timeout);
1998 if (s->reply_callback.timeout_usec != 0) {
1999 r = prioq_put(bus->reply_callbacks_prioq, &s->reply_callback, &s->reply_callback.prioq_idx);
2001 s->reply_callback.timeout_usec = 0;
2007 r = sd_bus_send(bus, m, s ? &s->reply_callback.cookie : NULL);
2018 int bus_ensure_running(sd_bus *bus) {
2023 if (IN_SET(bus->state, BUS_UNSET, BUS_CLOSED, BUS_CLOSING))
2025 if (bus->state == BUS_RUNNING)
2029 r = sd_bus_process(bus, NULL);
2032 if (bus->state == BUS_RUNNING)
2037 r = sd_bus_wait(bus, (uint64_t) -1);
2043 _public_ int sd_bus_call(
2047 sd_bus_error *error,
2048 sd_bus_message **reply) {
2050 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = sd_bus_message_ref(_m);
2056 bus_assert_return(m, -EINVAL, error);
2057 bus_assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL, error);
2058 bus_assert_return(!(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED), -EINVAL, error);
2059 bus_assert_return(!bus_error_is_dirty(error), -EINVAL, error);
2064 bus_assert_return(!bus_pid_changed(bus), -ECHILD, error);
2066 if (!BUS_IS_OPEN(bus->state)) {
2071 r = bus_ensure_running(bus);
2075 i = bus->rqueue_size;
2077 r = bus_seal_message(bus, m, usec);
2081 r = bus_remarshal_message(bus, &m);
2085 r = sd_bus_send(bus, m, &cookie);
2089 timeout = calc_elapse(bus, m->timeout);
2094 while (i < bus->rqueue_size) {
2095 sd_bus_message *incoming = NULL;
2097 incoming = bus->rqueue[i];
2099 if (incoming->reply_cookie == cookie) {
2100 /* Found a match! */
2102 memmove(bus->rqueue + i, bus->rqueue + i + 1, sizeof(sd_bus_message*) * (bus->rqueue_size - i - 1));
2104 log_debug_bus_message(incoming);
2106 if (incoming->header->type == SD_BUS_MESSAGE_METHOD_RETURN) {
2108 if (incoming->n_fds <= 0 || bus->accept_fd) {
2112 sd_bus_message_unref(incoming);
2117 r = sd_bus_error_setf(error, SD_BUS_ERROR_INCONSISTENT_MESSAGE, "Reply message contained file descriptors which I couldn't accept. Sorry.");
2118 sd_bus_message_unref(incoming);
2121 } else if (incoming->header->type == SD_BUS_MESSAGE_METHOD_ERROR) {
2122 r = sd_bus_error_copy(error, &incoming->error);
2123 sd_bus_message_unref(incoming);
2130 } else if (BUS_MESSAGE_COOKIE(incoming) == cookie &&
2133 streq(bus->unique_name, incoming->sender)) {
2135 memmove(bus->rqueue + i, bus->rqueue + i + 1, sizeof(sd_bus_message*) * (bus->rqueue_size - i - 1));
2138 /* Our own message? Somebody is trying
2139 * to send its own client a message,
2140 * let's not dead-lock, let's fail
2143 sd_bus_message_unref(incoming);
2148 /* Try to read more, right-away */
2152 r = bus_read_message(bus, false, 0);
2154 if (IN_SET(r, -ENOTCONN, -ECONNRESET, -EPIPE, -ESHUTDOWN)) {
2155 bus_enter_closing(bus);
2167 n = now(CLOCK_MONOTONIC);
2175 left = (uint64_t) -1;
2177 r = bus_poll(bus, true, left);
2185 r = dispatch_wqueue(bus);
2187 if (IN_SET(r, -ENOTCONN, -ECONNRESET, -EPIPE, -ESHUTDOWN)) {
2188 bus_enter_closing(bus);
2197 return sd_bus_error_set_errno(error, r);
2200 _public_ int sd_bus_get_fd(sd_bus *bus) {
2202 assert_return(bus, -EINVAL);
2203 assert_return(bus = bus_resolve(bus), -ENOPKG);
2204 assert_return(bus->input_fd == bus->output_fd, -EPERM);
2205 assert_return(!bus_pid_changed(bus), -ECHILD);
2207 if (bus->state == BUS_CLOSED)
2210 if (bus->inotify_fd >= 0)
2211 return bus->inotify_fd;
2213 if (bus->input_fd >= 0)
2214 return bus->input_fd;
2219 _public_ int sd_bus_get_events(sd_bus *bus) {
2222 assert_return(bus, -EINVAL);
2223 assert_return(bus = bus_resolve(bus), -ENOPKG);
2224 assert_return(!bus_pid_changed(bus), -ECHILD);
2226 switch (bus->state) {
2232 case BUS_WATCH_BIND:
2240 case BUS_AUTHENTICATING:
2241 if (bus_socket_auth_needs_write(bus))
2249 if (bus->rqueue_size <= 0)
2251 if (bus->wqueue_size > 0)
2259 assert_not_reached("Unknown state");
2265 _public_ int sd_bus_get_timeout(sd_bus *bus, uint64_t *timeout_usec) {
2266 struct reply_callback *c;
2268 assert_return(bus, -EINVAL);
2269 assert_return(bus = bus_resolve(bus), -ENOPKG);
2270 assert_return(timeout_usec, -EINVAL);
2271 assert_return(!bus_pid_changed(bus), -ECHILD);
2273 if (!BUS_IS_OPEN(bus->state) && bus->state != BUS_CLOSING)
2276 if (bus->track_queue) {
2281 switch (bus->state) {
2283 case BUS_AUTHENTICATING:
2284 *timeout_usec = bus->auth_timeout;
2289 if (bus->rqueue_size > 0) {
2294 c = prioq_peek(bus->reply_callbacks_prioq);
2296 *timeout_usec = (uint64_t) -1;
2300 if (c->timeout_usec == 0) {
2301 *timeout_usec = (uint64_t) -1;
2305 *timeout_usec = c->timeout_usec;
2312 case BUS_WATCH_BIND:
2314 *timeout_usec = (uint64_t) -1;
2318 assert_not_reached("Unknown or unexpected stat");
2322 static int process_timeout(sd_bus *bus) {
2323 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2324 _cleanup_(sd_bus_message_unrefp) sd_bus_message* m = NULL;
2325 struct reply_callback *c;
2332 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
2334 c = prioq_peek(bus->reply_callbacks_prioq);
2338 n = now(CLOCK_MONOTONIC);
2339 if (c->timeout_usec > n)
2342 r = bus_message_new_synthetic_error(
2345 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY, "Method call timed out"),
2350 r = bus_seal_synthetic_message(bus, m);
2354 assert_se(prioq_pop(bus->reply_callbacks_prioq) == c);
2355 c->timeout_usec = 0;
2357 ordered_hashmap_remove(bus->reply_callbacks, &c->cookie);
2360 slot = container_of(c, sd_bus_slot, reply_callback);
2362 bus->iteration_counter++;
2364 is_hello = bus->state == BUS_HELLO && c->callback == hello_callback;
2366 bus->current_message = m;
2367 bus->current_slot = sd_bus_slot_ref(slot);
2368 bus->current_handler = c->callback;
2369 bus->current_userdata = slot->userdata;
2370 r = c->callback(m, slot->userdata, &error_buffer);
2371 bus->current_userdata = NULL;
2372 bus->current_handler = NULL;
2373 bus->current_slot = NULL;
2374 bus->current_message = NULL;
2376 if (slot->floating) {
2377 bus_slot_disconnect(slot);
2378 sd_bus_slot_unref(slot);
2381 sd_bus_slot_unref(slot);
2383 /* When this is the hello message and it timed out, then make sure to propagate the error up, don't just log
2384 * and ignore the callback handler's return value. */
2388 return bus_maybe_reply_error(m, r, &error_buffer);
2391 static int process_hello(sd_bus *bus, sd_bus_message *m) {
2395 if (bus->state != BUS_HELLO)
2398 /* Let's make sure the first message on the bus is the HELLO
2399 * reply. But note that we don't actually parse the message
2400 * here (we leave that to the usual handling), we just verify
2401 * we don't let any earlier msg through. */
2403 if (!IN_SET(m->header->type, SD_BUS_MESSAGE_METHOD_RETURN, SD_BUS_MESSAGE_METHOD_ERROR))
2406 if (m->reply_cookie != 1)
2412 static int process_reply(sd_bus *bus, sd_bus_message *m) {
2413 _cleanup_(sd_bus_message_unrefp) sd_bus_message *synthetic_reply = NULL;
2414 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2415 struct reply_callback *c;
2423 if (!IN_SET(m->header->type, SD_BUS_MESSAGE_METHOD_RETURN, SD_BUS_MESSAGE_METHOD_ERROR))
2426 if (m->destination && bus->unique_name && !streq_ptr(m->destination, bus->unique_name))
2429 c = ordered_hashmap_remove(bus->reply_callbacks, &m->reply_cookie);
2435 slot = container_of(c, sd_bus_slot, reply_callback);
2437 if (m->n_fds > 0 && !bus->accept_fd) {
2439 /* If the reply contained a file descriptor which we
2440 * didn't want we pass an error instead. */
2442 r = bus_message_new_synthetic_error(
2445 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_INCONSISTENT_MESSAGE, "Reply message contained file descriptor"),
2450 /* Copy over original timestamp */
2451 synthetic_reply->realtime = m->realtime;
2452 synthetic_reply->monotonic = m->monotonic;
2453 synthetic_reply->seqnum = m->seqnum;
2455 r = bus_seal_synthetic_message(bus, synthetic_reply);
2459 m = synthetic_reply;
2461 r = sd_bus_message_rewind(m, true);
2466 if (c->timeout_usec != 0) {
2467 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
2468 c->timeout_usec = 0;
2471 is_hello = bus->state == BUS_HELLO && c->callback == hello_callback;
2473 bus->current_slot = sd_bus_slot_ref(slot);
2474 bus->current_handler = c->callback;
2475 bus->current_userdata = slot->userdata;
2476 r = c->callback(m, slot->userdata, &error_buffer);
2477 bus->current_userdata = NULL;
2478 bus->current_handler = NULL;
2479 bus->current_slot = NULL;
2481 if (slot->floating) {
2482 bus_slot_disconnect(slot);
2483 sd_bus_slot_unref(slot);
2486 sd_bus_slot_unref(slot);
2488 /* When this is the hello message and it failed, then make sure to propagate the error up, don't just log and
2489 * ignore the callback handler's return value. */
2493 return bus_maybe_reply_error(m, r, &error_buffer);
2496 static int process_filter(sd_bus *bus, sd_bus_message *m) {
2497 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2498 struct filter_callback *l;
2505 bus->filter_callbacks_modified = false;
2507 LIST_FOREACH(callbacks, l, bus->filter_callbacks) {
2510 if (bus->filter_callbacks_modified)
2513 /* Don't run this more than once per iteration */
2514 if (l->last_iteration == bus->iteration_counter)
2517 l->last_iteration = bus->iteration_counter;
2519 r = sd_bus_message_rewind(m, true);
2523 slot = container_of(l, sd_bus_slot, filter_callback);
2525 bus->current_slot = sd_bus_slot_ref(slot);
2526 bus->current_handler = l->callback;
2527 bus->current_userdata = slot->userdata;
2528 r = l->callback(m, slot->userdata, &error_buffer);
2529 bus->current_userdata = NULL;
2530 bus->current_handler = NULL;
2531 bus->current_slot = sd_bus_slot_unref(slot);
2533 r = bus_maybe_reply_error(m, r, &error_buffer);
2539 } while (bus->filter_callbacks_modified);
2544 static int process_match(sd_bus *bus, sd_bus_message *m) {
2551 bus->match_callbacks_modified = false;
2553 r = bus_match_run(bus, &bus->match_callbacks, m);
2557 } while (bus->match_callbacks_modified);
2562 static int process_builtin(sd_bus *bus, sd_bus_message *m) {
2563 _cleanup_(sd_bus_message_unrefp) sd_bus_message *reply = NULL;
2569 if (bus->is_monitor)
2572 if (bus->manual_peer_interface)
2575 if (m->header->type != SD_BUS_MESSAGE_METHOD_CALL)
2578 if (!streq_ptr(m->interface, "org.freedesktop.DBus.Peer"))
2581 if (m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED)
2584 if (streq_ptr(m->member, "Ping"))
2585 r = sd_bus_message_new_method_return(m, &reply);
2586 else if (streq_ptr(m->member, "GetMachineId")) {
2590 r = sd_id128_get_machine(&id);
2594 r = sd_bus_message_new_method_return(m, &reply);
2598 r = sd_bus_message_append(reply, "s", sd_id128_to_string(id, sid));
2600 r = sd_bus_message_new_method_errorf(
2602 SD_BUS_ERROR_UNKNOWN_METHOD,
2603 "Unknown method '%s' on interface '%s'.", m->member, m->interface);
2609 r = sd_bus_send(bus, reply, NULL);
2616 static int process_fd_check(sd_bus *bus, sd_bus_message *m) {
2620 /* If we got a message with a file descriptor which we didn't
2621 * want to accept, then let's drop it. How can this even
2622 * happen? For example, when the kernel queues a message into
2623 * an activatable names's queue which allows fds, and then is
2624 * delivered to us later even though we ourselves did not
2627 if (bus->is_monitor)
2636 if (m->header->type != SD_BUS_MESSAGE_METHOD_CALL)
2637 return 1; /* just eat it up */
2639 return sd_bus_reply_method_errorf(m, SD_BUS_ERROR_INCONSISTENT_MESSAGE, "Message contains file descriptors, which I cannot accept. Sorry.");
2642 static int process_message(sd_bus *bus, sd_bus_message *m) {
2648 bus->current_message = m;
2649 bus->iteration_counter++;
2651 log_debug_bus_message(m);
2653 r = process_hello(bus, m);
2657 r = process_reply(bus, m);
2661 r = process_fd_check(bus, m);
2665 r = process_filter(bus, m);
2669 r = process_match(bus, m);
2673 r = process_builtin(bus, m);
2677 r = bus_process_object(bus, m);
2680 bus->current_message = NULL;
2684 static int dispatch_track(sd_bus *bus) {
2687 if (!bus->track_queue)
2690 bus_track_dispatch(bus->track_queue);
2694 static int process_running(sd_bus *bus, bool hint_priority, int64_t priority, sd_bus_message **ret) {
2695 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
2699 assert(IN_SET(bus->state, BUS_RUNNING, BUS_HELLO));
2701 r = process_timeout(bus);
2705 r = dispatch_wqueue(bus);
2709 r = dispatch_track(bus);
2713 r = dispatch_rqueue(bus, hint_priority, priority, &m);
2719 r = process_message(bus, m);
2724 r = sd_bus_message_rewind(m, true);
2733 if (m->header->type == SD_BUS_MESSAGE_METHOD_CALL) {
2735 log_debug("Unprocessed message call sender=%s object=%s interface=%s member=%s",
2736 strna(sd_bus_message_get_sender(m)),
2737 strna(sd_bus_message_get_path(m)),
2738 strna(sd_bus_message_get_interface(m)),
2739 strna(sd_bus_message_get_member(m)));
2741 r = sd_bus_reply_method_errorf(
2743 SD_BUS_ERROR_UNKNOWN_OBJECT,
2744 "Unknown object '%s'.", m->path);
2758 static int bus_exit_now(sd_bus *bus) {
2761 /* Exit due to close, if this is requested. If this is bus object is attached to an event source, invokes
2762 * sd_event_exit(), otherwise invokes libc exit(). */
2764 if (bus->exited) /* did we already exit? */
2766 if (!bus->exit_triggered) /* was the exit condition triggered? */
2768 if (!bus->exit_on_disconnect) /* Shall we actually exit on disconnection? */
2771 bus->exited = true; /* never exit more than once */
2773 log_debug("Bus connection disconnected, exiting.");
2776 return sd_event_exit(bus->event, EXIT_FAILURE);
2780 assert_not_reached("exit() didn't exit?");
2783 static int process_closing_reply_callback(sd_bus *bus, struct reply_callback *c) {
2784 _cleanup_(sd_bus_error_free) sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2785 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
2792 r = bus_message_new_synthetic_error(
2795 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY, "Connection terminated"),
2800 r = bus_seal_synthetic_message(bus, m);
2804 if (c->timeout_usec != 0) {
2805 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
2806 c->timeout_usec = 0;
2809 ordered_hashmap_remove(bus->reply_callbacks, &c->cookie);
2812 slot = container_of(c, sd_bus_slot, reply_callback);
2814 bus->iteration_counter++;
2816 bus->current_message = m;
2817 bus->current_slot = sd_bus_slot_ref(slot);
2818 bus->current_handler = c->callback;
2819 bus->current_userdata = slot->userdata;
2820 r = c->callback(m, slot->userdata, &error_buffer);
2821 bus->current_userdata = NULL;
2822 bus->current_handler = NULL;
2823 bus->current_slot = NULL;
2824 bus->current_message = NULL;
2826 if (slot->floating) {
2827 bus_slot_disconnect(slot);
2828 sd_bus_slot_unref(slot);
2831 sd_bus_slot_unref(slot);
2833 return bus_maybe_reply_error(m, r, &error_buffer);
2836 static int process_closing(sd_bus *bus, sd_bus_message **ret) {
2837 _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
2838 struct reply_callback *c;
2842 assert(bus->state == BUS_CLOSING);
2844 /* First, fail all outstanding method calls */
2845 c = ordered_hashmap_first(bus->reply_callbacks);
2847 return process_closing_reply_callback(bus, c);
2849 /* Then, fake-drop all remaining bus tracking references */
2851 bus_track_close(bus->tracks);
2855 /* Then, synthesize a Disconnected message */
2856 r = sd_bus_message_new_signal(
2859 "/org/freedesktop/DBus/Local",
2860 "org.freedesktop.DBus.Local",
2865 bus_message_set_sender_local(bus, m);
2867 r = bus_seal_synthetic_message(bus, m);
2873 bus->current_message = m;
2874 bus->iteration_counter++;
2876 r = process_filter(bus, m);
2880 r = process_match(bus, m);
2884 /* Nothing else to do, exit now, if the condition holds */
2885 bus->exit_triggered = true;
2886 (void) bus_exit_now(bus);
2894 bus->current_message = NULL;
2899 static int bus_process_internal(sd_bus *bus, bool hint_priority, int64_t priority, sd_bus_message **ret) {
2900 BUS_DONT_DESTROY(bus);
2903 /* Returns 0 when we didn't do anything. This should cause the
2904 * caller to invoke sd_bus_wait() before returning the next
2905 * time. Returns > 0 when we did something, which possibly
2906 * means *ret is filled in with an unprocessed message. */
2908 assert_return(bus, -EINVAL);
2909 assert_return(bus = bus_resolve(bus), -ENOPKG);
2910 assert_return(!bus_pid_changed(bus), -ECHILD);
2912 /* We don't allow recursively invoking sd_bus_process(). */
2913 assert_return(!bus->current_message, -EBUSY);
2914 assert(!bus->current_slot);
2916 switch (bus->state) {
2924 case BUS_WATCH_BIND:
2925 r = bus_socket_process_watch_bind(bus);
2929 r = bus_socket_process_opening(bus);
2932 case BUS_AUTHENTICATING:
2933 r = bus_socket_process_authenticating(bus);
2938 r = process_running(bus, hint_priority, priority, ret);
2942 /* This branch initializes *ret, hence we don't use the generic error checking below */
2946 return process_closing(bus, ret);
2949 assert_not_reached("Unknown state");
2952 if (IN_SET(r, -ENOTCONN, -ECONNRESET, -EPIPE, -ESHUTDOWN)) {
2953 bus_enter_closing(bus);
2964 _public_ int sd_bus_process(sd_bus *bus, sd_bus_message **ret) {
2965 return bus_process_internal(bus, false, 0, ret);
2968 _public_ int sd_bus_process_priority(sd_bus *bus, int64_t priority, sd_bus_message **ret) {
2969 return bus_process_internal(bus, true, priority, ret);
2972 static int bus_poll(sd_bus *bus, bool need_more, uint64_t timeout_usec) {
2973 struct pollfd p[2] = {};
2976 usec_t m = USEC_INFINITY;
2980 if (bus->state == BUS_CLOSING)
2983 if (!BUS_IS_OPEN(bus->state))
2986 if (bus->state == BUS_WATCH_BIND) {
2987 assert(bus->inotify_fd >= 0);
2989 p[0].events = POLLIN;
2990 p[0].fd = bus->inotify_fd;
2995 e = sd_bus_get_events(bus);
3000 /* The caller really needs some more data, he doesn't
3001 * care about what's already read, or any timeouts
3002 * except its own. */
3006 /* The caller wants to process if there's something to
3007 * process, but doesn't care otherwise */
3009 r = sd_bus_get_timeout(bus, &until);
3013 m = usec_sub_unsigned(until, now(CLOCK_MONOTONIC));
3016 p[0].fd = bus->input_fd;
3017 if (bus->output_fd == bus->input_fd) {
3021 p[0].events = e & POLLIN;
3022 p[1].fd = bus->output_fd;
3023 p[1].events = e & POLLOUT;
3028 if (timeout_usec != (uint64_t) -1 && (m == USEC_INFINITY || timeout_usec < m))
3031 r = ppoll(p, n, m == USEC_INFINITY ? NULL : timespec_store(&ts, m), NULL);
3035 return r > 0 ? 1 : 0;
3038 _public_ int sd_bus_wait(sd_bus *bus, uint64_t timeout_usec) {
3040 assert_return(bus, -EINVAL);
3041 assert_return(bus = bus_resolve(bus), -ENOPKG);
3042 assert_return(!bus_pid_changed(bus), -ECHILD);
3044 if (bus->state == BUS_CLOSING)
3047 if (!BUS_IS_OPEN(bus->state))
3050 if (bus->rqueue_size > 0)
3053 return bus_poll(bus, false, timeout_usec);
3056 _public_ int sd_bus_flush(sd_bus *bus) {
3059 assert_return(bus, -EINVAL);
3060 assert_return(bus = bus_resolve(bus), -ENOPKG);
3061 assert_return(!bus_pid_changed(bus), -ECHILD);
3063 if (bus->state == BUS_CLOSING)
3066 if (!BUS_IS_OPEN(bus->state))
3069 /* We never were connected? Don't hang in inotify for good, as there's no timeout set for it */
3070 if (bus->state == BUS_WATCH_BIND)
3073 r = bus_ensure_running(bus);
3077 if (bus->wqueue_size <= 0)
3081 r = dispatch_wqueue(bus);
3083 if (IN_SET(r, -ENOTCONN, -ECONNRESET, -EPIPE, -ESHUTDOWN)) {
3084 bus_enter_closing(bus);
3091 if (bus->wqueue_size <= 0)
3094 r = bus_poll(bus, false, (uint64_t) -1);
3100 _public_ int sd_bus_add_filter(
3103 sd_bus_message_handler_t callback,
3108 assert_return(bus, -EINVAL);
3109 assert_return(bus = bus_resolve(bus), -ENOPKG);
3110 assert_return(callback, -EINVAL);
3111 assert_return(!bus_pid_changed(bus), -ECHILD);
3113 s = bus_slot_allocate(bus, !slot, BUS_FILTER_CALLBACK, sizeof(struct filter_callback), userdata);
3117 s->filter_callback.callback = callback;
3119 bus->filter_callbacks_modified = true;
3120 LIST_PREPEND(callbacks, bus->filter_callbacks, &s->filter_callback);
3128 static int add_match_callback(
3131 sd_bus_error *ret_error) {
3133 sd_bus_slot *match_slot = userdata;
3134 bool failed = false;
3140 sd_bus_slot_ref(match_slot);
3142 if (sd_bus_message_is_method_error(m, NULL)) {
3143 log_debug_errno(sd_bus_message_get_errno(m),
3144 "Unable to add match %s, failing connection: %s",
3145 match_slot->match_callback.match_string,
3146 sd_bus_message_get_error(m)->message);
3150 log_debug("Match %s successfully installed.", match_slot->match_callback.match_string);
3152 if (match_slot->match_callback.install_callback) {
3155 bus = sd_bus_message_get_bus(m);
3157 /* This function has been called as slot handler, and we want to call another slot handler. Let's
3158 * update the slot callback metadata temporarily with our own data, and then revert back to the old
3161 assert(bus->current_slot == match_slot->match_callback.install_slot);
3162 assert(bus->current_handler == add_match_callback);
3163 assert(bus->current_userdata == userdata);
3165 bus->current_slot = match_slot;
3166 bus->current_handler = match_slot->match_callback.install_callback;
3167 bus->current_userdata = match_slot->userdata;
3169 r = match_slot->match_callback.install_callback(m, match_slot->userdata, ret_error);
3171 bus->current_slot = match_slot->match_callback.install_slot;
3172 bus->current_handler = add_match_callback;
3173 bus->current_userdata = userdata;
3175 match_slot->match_callback.install_slot = sd_bus_slot_unref(match_slot->match_callback.install_slot);
3177 if (failed) /* Generic failure handling: destroy the connection */
3178 bus_enter_closing(sd_bus_message_get_bus(m));
3183 if (failed && match_slot->floating) {
3184 bus_slot_disconnect(match_slot);
3185 sd_bus_slot_unref(match_slot);
3188 sd_bus_slot_unref(match_slot);
3193 static int bus_add_match_full(
3198 sd_bus_message_handler_t callback,
3199 sd_bus_message_handler_t install_callback,
3202 struct bus_match_component *components = NULL;
3203 unsigned n_components = 0;
3204 sd_bus_slot *s = NULL;
3207 assert_return(bus, -EINVAL);
3208 assert_return(bus = bus_resolve(bus), -ENOPKG);
3209 assert_return(match, -EINVAL);
3210 assert_return(!bus_pid_changed(bus), -ECHILD);
3212 r = bus_match_parse(match, &components, &n_components);
3216 s = bus_slot_allocate(bus, !slot, BUS_MATCH_CALLBACK, sizeof(struct match_callback), userdata);
3222 s->match_callback.callback = callback;
3223 s->match_callback.install_callback = install_callback;
3225 if (bus->bus_client) {
3226 enum bus_match_scope scope;
3228 scope = bus_match_get_scope(components, n_components);
3230 /* Do not install server-side matches for matches against the local service, interface or bus path. */
3231 if (scope != BUS_MATCH_LOCAL) {
3233 /* We store the original match string, so that we can use it to remove the match again. */
3235 s->match_callback.match_string = strdup(match);
3236 if (!s->match_callback.match_string) {
3242 r = bus_add_match_internal_async(bus,
3243 &s->match_callback.install_slot,
3244 s->match_callback.match_string,
3251 /* Make the slot of the match call floating now. We need the reference, but we don't
3252 * want that this match pins the bus object, hence we first create it non-floating, but
3253 * then make it floating. */
3254 r = sd_bus_slot_set_floating(s->match_callback.install_slot, true);
3256 r = bus_add_match_internal(bus, s->match_callback.match_string);
3260 s->match_added = true;
3264 bus->match_callbacks_modified = true;
3265 r = bus_match_add(&bus->match_callbacks, components, n_components, &s->match_callback);
3274 bus_match_parse_free(components, n_components);
3275 sd_bus_slot_unref(s);
3280 #if 0 /// UNNEEDED by elogind
3282 _public_ int sd_bus_add_match(
3286 sd_bus_message_handler_t callback,
3289 return bus_add_match_full(bus, slot, false, match, callback, NULL, userdata);
3292 _public_ int sd_bus_add_match_async(
3296 sd_bus_message_handler_t callback,
3297 sd_bus_message_handler_t install_callback,
3300 return bus_add_match_full(bus, slot, true, match, callback, install_callback, userdata);
3303 bool bus_pid_changed(sd_bus *bus) {
3306 /* We don't support people creating a bus connection and
3307 * keeping it around over a fork(). Let's complain. */
3309 return bus->original_pid != getpid_cached();
3312 static int io_callback(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
3313 sd_bus *bus = userdata;
3318 /* Note that this is called both on input_fd, output_fd as well as inotify_fd events */
3320 r = sd_bus_process(bus, NULL);
3322 log_debug_errno(r, "Processing of bus failed, closing down: %m");
3323 bus_enter_closing(bus);
3329 static int time_callback(sd_event_source *s, uint64_t usec, void *userdata) {
3330 sd_bus *bus = userdata;
3335 r = sd_bus_process(bus, NULL);
3337 log_debug_errno(r, "Processing of bus failed, closing down: %m");
3338 bus_enter_closing(bus);
3344 static int prepare_callback(sd_event_source *s, void *userdata) {
3345 sd_bus *bus = userdata;
3352 e = sd_bus_get_events(bus);
3358 if (bus->output_fd != bus->input_fd) {
3360 r = sd_event_source_set_io_events(bus->input_io_event_source, e & POLLIN);
3364 r = sd_event_source_set_io_events(bus->output_io_event_source, e & POLLOUT);
3366 r = sd_event_source_set_io_events(bus->input_io_event_source, e);
3370 r = sd_bus_get_timeout(bus, &until);
3376 j = sd_event_source_set_time(bus->time_event_source, until);
3383 r = sd_event_source_set_enabled(bus->time_event_source, r > 0);
3390 log_debug_errno(r, "Preparing of bus events failed, closing down: %m");
3391 bus_enter_closing(bus);
3396 static int quit_callback(sd_event_source *event, void *userdata) {
3397 sd_bus *bus = userdata;
3407 int bus_attach_io_events(sd_bus *bus) {
3412 if (bus->input_fd < 0)
3418 if (!bus->input_io_event_source) {
3419 r = sd_event_add_io(bus->event, &bus->input_io_event_source, bus->input_fd, 0, io_callback, bus);
3423 r = sd_event_source_set_prepare(bus->input_io_event_source, prepare_callback);
3427 r = sd_event_source_set_priority(bus->input_io_event_source, bus->event_priority);
3431 r = sd_event_source_set_description(bus->input_io_event_source, "bus-input");
3433 r = sd_event_source_set_io_fd(bus->input_io_event_source, bus->input_fd);
3438 if (bus->output_fd != bus->input_fd) {
3439 assert(bus->output_fd >= 0);
3441 if (!bus->output_io_event_source) {
3442 r = sd_event_add_io(bus->event, &bus->output_io_event_source, bus->output_fd, 0, io_callback, bus);
3446 r = sd_event_source_set_priority(bus->output_io_event_source, bus->event_priority);
3450 r = sd_event_source_set_description(bus->input_io_event_source, "bus-output");
3452 r = sd_event_source_set_io_fd(bus->output_io_event_source, bus->output_fd);
3461 static void bus_detach_io_events(sd_bus *bus) {
3464 if (bus->input_io_event_source) {
3465 sd_event_source_set_enabled(bus->input_io_event_source, SD_EVENT_OFF);
3466 bus->input_io_event_source = sd_event_source_unref(bus->input_io_event_source);
3469 if (bus->output_io_event_source) {
3470 sd_event_source_set_enabled(bus->output_io_event_source, SD_EVENT_OFF);
3471 bus->output_io_event_source = sd_event_source_unref(bus->output_io_event_source);
3475 int bus_attach_inotify_event(sd_bus *bus) {
3480 if (bus->inotify_fd < 0)
3486 if (!bus->inotify_event_source) {
3487 r = sd_event_add_io(bus->event, &bus->inotify_event_source, bus->inotify_fd, EPOLLIN, io_callback, bus);
3491 r = sd_event_source_set_priority(bus->inotify_event_source, bus->event_priority);
3495 r = sd_event_source_set_description(bus->inotify_event_source, "bus-inotify");
3497 r = sd_event_source_set_io_fd(bus->inotify_event_source, bus->inotify_fd);
3504 static void bus_detach_inotify_event(sd_bus *bus) {
3507 if (bus->inotify_event_source) {
3508 sd_event_source_set_enabled(bus->inotify_event_source, SD_EVENT_OFF);
3509 bus->inotify_event_source = sd_event_source_unref(bus->inotify_event_source);
3513 _public_ int sd_bus_attach_event(sd_bus *bus, sd_event *event, int priority) {
3516 assert_return(bus, -EINVAL);
3517 assert_return(bus = bus_resolve(bus), -ENOPKG);
3518 assert_return(!bus->event, -EBUSY);
3520 assert(!bus->input_io_event_source);
3521 assert(!bus->output_io_event_source);
3522 assert(!bus->time_event_source);
3525 bus->event = sd_event_ref(event);
3527 r = sd_event_default(&bus->event);
3532 bus->event_priority = priority;
3534 r = sd_event_add_time(bus->event, &bus->time_event_source, CLOCK_MONOTONIC, 0, 0, time_callback, bus);
3538 r = sd_event_source_set_priority(bus->time_event_source, priority);
3542 r = sd_event_source_set_description(bus->time_event_source, "bus-time");
3546 r = sd_event_add_exit(bus->event, &bus->quit_event_source, quit_callback, bus);
3550 r = sd_event_source_set_description(bus->quit_event_source, "bus-exit");
3554 r = bus_attach_io_events(bus);
3558 r = bus_attach_inotify_event(bus);
3565 sd_bus_detach_event(bus);
3569 _public_ int sd_bus_detach_event(sd_bus *bus) {
3570 assert_return(bus, -EINVAL);
3571 assert_return(bus = bus_resolve(bus), -ENOPKG);
3576 bus_detach_io_events(bus);
3577 bus_detach_inotify_event(bus);
3579 if (bus->time_event_source) {
3580 sd_event_source_set_enabled(bus->time_event_source, SD_EVENT_OFF);
3581 bus->time_event_source = sd_event_source_unref(bus->time_event_source);
3584 if (bus->quit_event_source) {
3585 sd_event_source_set_enabled(bus->quit_event_source, SD_EVENT_OFF);
3586 bus->quit_event_source = sd_event_source_unref(bus->quit_event_source);
3589 bus->event = sd_event_unref(bus->event);
3593 _public_ sd_event* sd_bus_get_event(sd_bus *bus) {
3594 assert_return(bus, NULL);
3599 _public_ sd_bus_message* sd_bus_get_current_message(sd_bus *bus) {
3600 assert_return(bus, NULL);
3602 return bus->current_message;
3605 _public_ sd_bus_slot* sd_bus_get_current_slot(sd_bus *bus) {
3606 assert_return(bus, NULL);
3608 return bus->current_slot;
3611 _public_ sd_bus_message_handler_t sd_bus_get_current_handler(sd_bus *bus) {
3612 assert_return(bus, NULL);
3614 return bus->current_handler;
3617 _public_ void* sd_bus_get_current_userdata(sd_bus *bus) {
3618 assert_return(bus, NULL);
3620 return bus->current_userdata;
3623 static int bus_default(int (*bus_open)(sd_bus **), sd_bus **default_bus, sd_bus **ret) {
3628 assert(default_bus);
3631 return !!*default_bus;
3634 *ret = sd_bus_ref(*default_bus);
3642 b->default_bus_ptr = default_bus;
3650 _public_ int sd_bus_default_system(sd_bus **ret) {
3651 return bus_default(sd_bus_open_system, &default_system_bus, ret);
3654 _public_ int sd_bus_default_user(sd_bus **ret) {
3655 #if 0 /// elogind does not support user buses
3656 return bus_default(sd_bus_open_user, &default_user_bus, ret);
3658 return sd_bus_default_system(ret);
3662 _public_ int sd_bus_default(sd_bus **ret) {
3663 int (*bus_open)(sd_bus **) = NULL;
3666 busp = bus_choose_default(&bus_open);
3667 return bus_default(bus_open, busp, ret);
3670 _public_ int sd_bus_get_tid(sd_bus *b, pid_t *tid) {
3671 assert_return(b, -EINVAL);
3672 assert_return(tid, -EINVAL);
3673 assert_return(!bus_pid_changed(b), -ECHILD);
3681 return sd_event_get_tid(b->event, tid);
3686 _public_ int sd_bus_path_encode(const char *prefix, const char *external_id, char **ret_path) {
3687 _cleanup_free_ char *e = NULL;
3690 assert_return(object_path_is_valid(prefix), -EINVAL);
3691 assert_return(external_id, -EINVAL);
3692 assert_return(ret_path, -EINVAL);
3694 e = bus_label_escape(external_id);
3698 ret = strjoin(prefix, "/", e);
3706 _public_ int sd_bus_path_decode(const char *path, const char *prefix, char **external_id) {
3710 assert_return(object_path_is_valid(path), -EINVAL);
3711 assert_return(object_path_is_valid(prefix), -EINVAL);
3712 assert_return(external_id, -EINVAL);
3714 e = object_path_startswith(path, prefix);
3716 *external_id = NULL;
3720 ret = bus_label_unescape(e);
3728 _public_ int sd_bus_path_encode_many(char **out, const char *path_template, ...) {
3729 _cleanup_strv_free_ char **labels = NULL;
3730 char *path, *path_pos, **label_pos;
3731 const char *sep, *template_pos;
3736 assert_return(out, -EINVAL);
3737 assert_return(path_template, -EINVAL);
3739 path_length = strlen(path_template);
3741 va_start(list, path_template);
3742 for (sep = strchr(path_template, '%'); sep; sep = strchr(sep + 1, '%')) {
3746 arg = va_arg(list, const char *);
3752 label = bus_label_escape(arg);
3758 r = strv_consume(&labels, label);
3764 /* add label length, but account for the format character */
3765 path_length += strlen(label) - 1;
3769 path = malloc(path_length + 1);
3776 for (template_pos = path_template; *template_pos; ) {
3777 sep = strchrnul(template_pos, '%');
3778 path_pos = mempcpy(path_pos, template_pos, sep - template_pos);
3782 path_pos = stpcpy(path_pos, *label_pos++);
3783 template_pos = sep + 1;
3791 _public_ int sd_bus_path_decode_many(const char *path, const char *path_template, ...) {
3792 _cleanup_strv_free_ char **labels = NULL;
3793 const char *template_pos, *path_pos;
3799 * This decodes an object-path based on a template argument. The
3800 * template consists of a verbatim path, optionally including special
3803 * - Each occurrence of '%' in the template matches an arbitrary
3804 * substring of a label in the given path. At most one such
3805 * directive is allowed per label. For each such directive, the
3806 * caller must provide an output parameter (char **) via va_arg. If
3807 * NULL is passed, the given label is verified, but not returned.
3808 * For each matched label, the *decoded* label is stored in the
3809 * passed output argument, and the caller is responsible to free
3810 * it. Note that the output arguments are only modified if the
3811 * actualy path matched the template. Otherwise, they're left
3814 * This function returns <0 on error, 0 if the path does not match the
3815 * template, 1 if it matched.
3818 assert_return(path, -EINVAL);
3819 assert_return(path_template, -EINVAL);
3823 for (template_pos = path_template; *template_pos; ) {
3828 /* verify everything until the next '%' matches verbatim */
3829 sep = strchrnul(template_pos, '%');
3830 length = sep - template_pos;
3831 if (strncmp(path_pos, template_pos, length))
3835 template_pos += length;
3840 /* We found the next '%' character. Everything up until here
3841 * matched. We now skip ahead to the end of this label and make
3842 * sure it matches the tail of the label in the path. Then we
3843 * decode the string in-between and save it for later use. */
3845 ++template_pos; /* skip over '%' */
3847 sep = strchrnul(template_pos, '/');
3848 length = sep - template_pos; /* length of suffix to match verbatim */
3850 /* verify the suffixes match */
3851 sep = strchrnul(path_pos, '/');
3852 if (sep - path_pos < (ssize_t)length ||
3853 strncmp(sep - length, template_pos, length))
3856 template_pos += length; /* skip over matched label */
3857 length = sep - path_pos - length; /* length of sub-label to decode */
3859 /* store unescaped label for later use */
3860 label = bus_label_unescape_n(path_pos, length);
3864 r = strv_consume(&labels, label);
3868 path_pos = sep; /* skip decoded label and suffix */
3871 /* end of template must match end of path */
3875 /* copy the labels over to the caller */
3876 va_start(list, path_template);
3877 for (label_pos = labels; label_pos && *label_pos; ++label_pos) {
3880 arg = va_arg(list, char **);
3888 labels = mfree(labels);
3892 _public_ int sd_bus_try_close(sd_bus *bus) {
3893 assert_return(bus, -EINVAL);
3894 assert_return(bus = bus_resolve(bus), -ENOPKG);
3895 assert_return(!bus_pid_changed(bus), -ECHILD);
3900 _public_ int sd_bus_get_description(sd_bus *bus, const char **description) {
3901 assert_return(bus, -EINVAL);
3902 assert_return(bus = bus_resolve(bus), -ENOPKG);
3903 assert_return(description, -EINVAL);
3904 assert_return(bus->description, -ENXIO);
3905 assert_return(!bus_pid_changed(bus), -ECHILD);
3907 if (bus->description)
3908 *description = bus->description;
3909 else if (bus->is_system)
3910 *description = "system";
3911 else if (bus->is_user)
3912 *description = "user";
3914 *description = NULL;
3919 int bus_get_root_path(sd_bus *bus) {
3922 if (bus->cgroup_root)
3925 r = cg_get_root_path(&bus->cgroup_root);
3927 bus->cgroup_root = strdup("/");
3928 if (!bus->cgroup_root)
3937 _public_ int sd_bus_get_scope(sd_bus *bus, const char **scope) {
3938 assert_return(bus, -EINVAL);
3939 assert_return(bus = bus_resolve(bus), -ENOPKG);
3940 assert_return(scope, -EINVAL);
3941 assert_return(!bus_pid_changed(bus), -ECHILD);
3948 if (bus->is_system) {
3956 _public_ int sd_bus_get_address(sd_bus *bus, const char **address) {
3958 assert_return(bus, -EINVAL);
3959 assert_return(bus = bus_resolve(bus), -ENOPKG);
3960 assert_return(address, -EINVAL);
3961 assert_return(!bus_pid_changed(bus), -ECHILD);
3964 *address = bus->address;
3971 _public_ int sd_bus_get_creds_mask(sd_bus *bus, uint64_t *mask) {
3972 assert_return(bus, -EINVAL);
3973 assert_return(bus = bus_resolve(bus), -ENOPKG);
3974 assert_return(mask, -EINVAL);
3975 assert_return(!bus_pid_changed(bus), -ECHILD);
3977 *mask = bus->creds_mask;
3981 _public_ int sd_bus_is_bus_client(sd_bus *bus) {
3982 assert_return(bus, -EINVAL);
3983 assert_return(bus = bus_resolve(bus), -ENOPKG);
3984 assert_return(!bus_pid_changed(bus), -ECHILD);
3986 return bus->bus_client;
3989 _public_ int sd_bus_is_server(sd_bus *bus) {
3990 assert_return(bus, -EINVAL);
3991 assert_return(bus = bus_resolve(bus), -ENOPKG);
3992 assert_return(!bus_pid_changed(bus), -ECHILD);
3994 return bus->is_server;
3997 _public_ int sd_bus_is_anonymous(sd_bus *bus) {
3998 assert_return(bus, -EINVAL);
3999 assert_return(bus = bus_resolve(bus), -ENOPKG);
4000 assert_return(!bus_pid_changed(bus), -ECHILD);
4002 return bus->anonymous_auth;
4005 _public_ int sd_bus_is_trusted(sd_bus *bus) {
4006 assert_return(bus, -EINVAL);
4007 assert_return(bus = bus_resolve(bus), -ENOPKG);
4008 assert_return(!bus_pid_changed(bus), -ECHILD);
4010 return bus->trusted;
4013 _public_ int sd_bus_is_monitor(sd_bus *bus) {
4014 assert_return(bus, -EINVAL);
4015 assert_return(bus = bus_resolve(bus), -ENOPKG);
4016 assert_return(!bus_pid_changed(bus), -ECHILD);
4018 return bus->is_monitor;
4021 static void flush_close(sd_bus *bus) {
4025 /* Flushes and closes the specified bus. We take a ref before,
4026 * to ensure the flushing does not cause the bus to be
4029 sd_bus_flush_close_unref(sd_bus_ref(bus));
4032 _public_ void sd_bus_default_flush_close(void) {
4033 flush_close(default_starter_bus);
4034 #if 0 /// elogind does not support user buses
4035 flush_close(default_user_bus);
4037 flush_close(default_system_bus);
4040 _public_ int sd_bus_set_exit_on_disconnect(sd_bus *bus, int b) {
4041 assert_return(bus, -EINVAL);
4042 assert_return(bus = bus_resolve(bus), -ENOPKG);
4044 /* Turns on exit-on-disconnect, and triggers it immediately if the bus connection was already
4045 * disconnected. Note that this is triggered exclusively on disconnections triggered by the server side, never
4046 * from the client side. */
4047 bus->exit_on_disconnect = b;
4049 /* If the exit condition was triggered already, exit immediately. */
4050 return bus_exit_now(bus);
4053 _public_ int sd_bus_get_exit_on_disconnect(sd_bus *bus) {
4054 assert_return(bus, -EINVAL);
4055 assert_return(bus = bus_resolve(bus), -ENOPKG);
4057 return bus->exit_on_disconnect;
4060 _public_ int sd_bus_set_sender(sd_bus *bus, const char *sender) {
4061 assert_return(bus, -EINVAL);
4062 assert_return(bus = bus_resolve(bus), -ENOPKG);
4063 assert_return(!bus->bus_client, -EPERM);
4064 assert_return(!sender || service_name_is_valid(sender), -EINVAL);
4066 return free_and_strdup(&bus->patch_sender, sender);
4069 _public_ int sd_bus_get_sender(sd_bus *bus, const char **ret) {
4070 assert_return(bus, -EINVAL);
4071 assert_return(bus = bus_resolve(bus), -ENOPKG);
4072 assert_return(ret, -EINVAL);
4074 if (!bus->patch_sender)
4077 *ret = bus->patch_sender;
4081 _public_ int sd_bus_get_n_queued_read(sd_bus *bus, uint64_t *ret) {
4082 assert_return(bus, -EINVAL);
4083 assert_return(bus = bus_resolve(bus), -ENOPKG);
4084 assert_return(!bus_pid_changed(bus), -ECHILD);
4085 assert_return(ret, -EINVAL);
4087 *ret = bus->rqueue_size;
4091 _public_ int sd_bus_get_n_queued_write(sd_bus *bus, uint64_t *ret) {
4092 assert_return(bus, -EINVAL);
4093 assert_return(bus = bus_resolve(bus), -ENOPKG);
4094 assert_return(!bus_pid_changed(bus), -ECHILD);
4095 assert_return(ret, -EINVAL);
4097 *ret = bus->wqueue_size;