1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
4 This file is part of systemd.
6 Copyright 2013 Lennart Poettering
8 systemd is free software; you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as published by
10 the Free Software Foundation; either version 2.1 of the License, or
11 (at your option) any later version.
13 systemd is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with systemd; If not, see <http://www.gnu.org/licenses/>.
40 #include "bus-internal.h"
41 #include "bus-message.h"
43 #include "bus-socket.h"
44 #include "bus-kernel.h"
45 #include "bus-control.h"
46 #include "bus-introspect.h"
47 #include "bus-signature.h"
48 #include "bus-objects.h"
50 #include "bus-container.h"
51 #include "bus-protocol.h"
53 static int bus_poll(sd_bus *bus, bool need_more, uint64_t timeout_usec);
54 static int attach_io_events(sd_bus *b);
55 static void detach_io_events(sd_bus *b);
57 static void bus_close_fds(sd_bus *b) {
63 close_nointr_nofail(b->input_fd);
65 if (b->output_fd >= 0 && b->output_fd != b->input_fd)
66 close_nointr_nofail(b->output_fd);
68 b->input_fd = b->output_fd = -1;
71 static void bus_node_destroy(sd_bus *b, struct node *n) {
72 struct node_callback *c;
73 struct node_vtable *v;
74 struct node_enumerator *e;
82 bus_node_destroy(b, n->child);
84 while ((c = n->callbacks)) {
85 LIST_REMOVE(callbacks, n->callbacks, c);
89 while ((v = n->vtables)) {
90 LIST_REMOVE(vtables, n->vtables, v);
95 while ((e = n->enumerators)) {
96 LIST_REMOVE(enumerators, n->enumerators, e);
101 LIST_REMOVE(siblings, n->parent->child, n);
103 assert_se(hashmap_remove(b->nodes, n->path) == n);
108 static void bus_reset_queues(sd_bus *b) {
113 for (i = 0; i < b->rqueue_size; i++)
114 sd_bus_message_unref(b->rqueue[i]);
117 for (i = 0; i < b->wqueue_size; i++)
118 sd_bus_message_unref(b->wqueue[i]);
121 b->rqueue = b->wqueue = NULL;
122 b->rqueue_allocated = b->wqueue_allocated = 0;
123 b->rqueue_size = b->wqueue_size = 0;
126 static void bus_free(sd_bus *b) {
127 struct filter_callback *f;
132 sd_bus_detach_event(b);
137 munmap(b->kdbus_buffer, KDBUS_POOL_SIZE);
140 free(b->unique_name);
141 free(b->auth_buffer);
146 free(b->cgroup_root);
149 strv_free(b->exec_argv);
151 close_many(b->fds, b->n_fds);
156 hashmap_free_free(b->reply_callbacks);
157 prioq_free(b->reply_callbacks_prioq);
159 while ((f = b->filter_callbacks)) {
160 LIST_REMOVE(callbacks, b->filter_callbacks, f);
164 bus_match_free(&b->match_callbacks);
166 hashmap_free_free(b->vtable_methods);
167 hashmap_free_free(b->vtable_properties);
169 while ((n = hashmap_first(b->nodes)))
170 bus_node_destroy(b, n);
172 hashmap_free(b->nodes);
174 bus_kernel_flush_memfd(b);
176 assert_se(pthread_mutex_destroy(&b->memfd_cache_mutex) == 0);
181 _public_ int sd_bus_new(sd_bus **ret) {
184 assert_return(ret, -EINVAL);
190 r->n_ref = REFCNT_INIT;
191 r->input_fd = r->output_fd = -1;
192 r->message_version = 1;
193 r->creds_mask |= SD_BUS_CREDS_WELL_KNOWN_NAMES|SD_BUS_CREDS_UNIQUE_NAME;
194 r->hello_flags |= KDBUS_HELLO_ACCEPT_FD;
195 r->attach_flags |= KDBUS_ATTACH_NAMES;
196 r->original_pid = getpid();
198 assert_se(pthread_mutex_init(&r->memfd_cache_mutex, NULL) == 0);
200 /* We guarantee that wqueue always has space for at least one
202 if (!GREEDY_REALLOC(r->wqueue, r->wqueue_allocated, 1)) {
211 _public_ int sd_bus_set_address(sd_bus *bus, const char *address) {
214 assert_return(bus, -EINVAL);
215 assert_return(bus->state == BUS_UNSET, -EPERM);
216 assert_return(address, -EINVAL);
217 assert_return(!bus_pid_changed(bus), -ECHILD);
229 _public_ int sd_bus_set_fd(sd_bus *bus, int input_fd, int output_fd) {
230 assert_return(bus, -EINVAL);
231 assert_return(bus->state == BUS_UNSET, -EPERM);
232 assert_return(input_fd >= 0, -EINVAL);
233 assert_return(output_fd >= 0, -EINVAL);
234 assert_return(!bus_pid_changed(bus), -ECHILD);
236 bus->input_fd = input_fd;
237 bus->output_fd = output_fd;
241 _public_ int sd_bus_set_exec(sd_bus *bus, const char *path, char *const argv[]) {
244 assert_return(bus, -EINVAL);
245 assert_return(bus->state == BUS_UNSET, -EPERM);
246 assert_return(path, -EINVAL);
247 assert_return(!strv_isempty(argv), -EINVAL);
248 assert_return(!bus_pid_changed(bus), -ECHILD);
260 free(bus->exec_path);
261 strv_free(bus->exec_argv);
269 _public_ int sd_bus_set_bus_client(sd_bus *bus, int b) {
270 assert_return(bus, -EINVAL);
271 assert_return(bus->state == BUS_UNSET, -EPERM);
272 assert_return(!bus_pid_changed(bus), -ECHILD);
274 bus->bus_client = !!b;
278 _public_ int sd_bus_negotiate_fds(sd_bus *bus, int b) {
279 assert_return(bus, -EINVAL);
280 assert_return(bus->state == BUS_UNSET, -EPERM);
281 assert_return(!bus_pid_changed(bus), -ECHILD);
283 SET_FLAG(bus->hello_flags, KDBUS_HELLO_ACCEPT_FD, b);
287 _public_ int sd_bus_negotiate_attach_timestamp(sd_bus *bus, int b) {
288 assert_return(bus, -EINVAL);
289 assert_return(bus->state == BUS_UNSET, -EPERM);
290 assert_return(!bus_pid_changed(bus), -ECHILD);
292 SET_FLAG(bus->attach_flags, KDBUS_ATTACH_TIMESTAMP, b);
296 _public_ int sd_bus_negotiate_attach_creds(sd_bus *bus, uint64_t mask) {
297 assert_return(bus, -EINVAL);
298 assert_return(mask <= _SD_BUS_CREDS_ALL, -EINVAL);
299 assert_return(bus->state == BUS_UNSET, -EPERM);
300 assert_return(!bus_pid_changed(bus), -ECHILD);
302 /* The well knowns we need unconditionally, so that matches can work */
303 bus->creds_mask = mask | SD_BUS_CREDS_WELL_KNOWN_NAMES|SD_BUS_CREDS_UNIQUE_NAME;
305 return kdbus_translate_attach_flags(bus->creds_mask, &bus->creds_mask);
308 _public_ int sd_bus_set_server(sd_bus *bus, int b, sd_id128_t server_id) {
309 assert_return(bus, -EINVAL);
310 assert_return(b || sd_id128_equal(server_id, SD_ID128_NULL), -EINVAL);
311 assert_return(bus->state == BUS_UNSET, -EPERM);
312 assert_return(!bus_pid_changed(bus), -ECHILD);
314 bus->is_server = !!b;
315 bus->server_id = server_id;
319 _public_ int sd_bus_set_anonymous(sd_bus *bus, int b) {
320 assert_return(bus, -EINVAL);
321 assert_return(bus->state == BUS_UNSET, -EPERM);
322 assert_return(!bus_pid_changed(bus), -ECHILD);
324 bus->anonymous_auth = !!b;
328 _public_ int sd_bus_set_trusted(sd_bus *bus, int b) {
329 assert_return(bus, -EINVAL);
330 assert_return(bus->state == BUS_UNSET, -EPERM);
331 assert_return(!bus_pid_changed(bus), -ECHILD);
337 static int hello_callback(sd_bus *bus, sd_bus_message *reply, void *userdata, sd_bus_error *error) {
342 assert(bus->state == BUS_HELLO || bus->state == BUS_CLOSING);
345 r = sd_bus_message_get_errno(reply);
351 r = sd_bus_message_read(reply, "s", &s);
355 if (!service_name_is_valid(s) || s[0] != ':')
358 bus->unique_name = strdup(s);
359 if (!bus->unique_name)
362 if (bus->state == BUS_HELLO)
363 bus->state = BUS_RUNNING;
368 static int bus_send_hello(sd_bus *bus) {
369 _cleanup_bus_message_unref_ sd_bus_message *m = NULL;
374 if (!bus->bus_client || bus->is_kernel)
377 r = sd_bus_message_new_method_call(
379 "org.freedesktop.DBus",
380 "/org/freedesktop/DBus",
381 "org.freedesktop.DBus",
387 return sd_bus_call_async(bus, m, hello_callback, NULL, 0, &bus->hello_cookie);
390 int bus_start_running(sd_bus *bus) {
393 if (bus->bus_client && !bus->is_kernel) {
394 bus->state = BUS_HELLO;
398 bus->state = BUS_RUNNING;
402 static int parse_address_key(const char **p, const char *key, char **value) {
403 size_t l, n = 0, allocated = 0;
413 if (strncmp(*p, key, l) != 0)
426 while (*a != ';' && *a != ',' && *a != 0) {
444 c = (char) ((x << 4) | y);
451 if (!GREEDY_REALLOC(r, allocated, n + 2))
475 static void skip_address_key(const char **p) {
479 *p += strcspn(*p, ",");
485 static int parse_unix_address(sd_bus *b, const char **p, char **guid) {
486 _cleanup_free_ char *path = NULL, *abstract = NULL;
495 while (**p != 0 && **p != ';') {
496 r = parse_address_key(p, "guid", guid);
502 r = parse_address_key(p, "path", &path);
508 r = parse_address_key(p, "abstract", &abstract);
517 if (!path && !abstract)
520 if (path && abstract)
525 if (l > sizeof(b->sockaddr.un.sun_path))
528 b->sockaddr.un.sun_family = AF_UNIX;
529 strncpy(b->sockaddr.un.sun_path, path, sizeof(b->sockaddr.un.sun_path));
530 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + l;
531 } else if (abstract) {
532 l = strlen(abstract);
533 if (l > sizeof(b->sockaddr.un.sun_path) - 1)
536 b->sockaddr.un.sun_family = AF_UNIX;
537 b->sockaddr.un.sun_path[0] = 0;
538 strncpy(b->sockaddr.un.sun_path+1, abstract, sizeof(b->sockaddr.un.sun_path)-1);
539 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + 1 + l;
545 static int parse_tcp_address(sd_bus *b, const char **p, char **guid) {
546 _cleanup_free_ char *host = NULL, *port = NULL, *family = NULL;
548 struct addrinfo *result, hints = {
549 .ai_socktype = SOCK_STREAM,
550 .ai_flags = AI_ADDRCONFIG,
558 while (**p != 0 && **p != ';') {
559 r = parse_address_key(p, "guid", guid);
565 r = parse_address_key(p, "host", &host);
571 r = parse_address_key(p, "port", &port);
577 r = parse_address_key(p, "family", &family);
590 if (streq(family, "ipv4"))
591 hints.ai_family = AF_INET;
592 else if (streq(family, "ipv6"))
593 hints.ai_family = AF_INET6;
598 r = getaddrinfo(host, port, &hints, &result);
602 return -EADDRNOTAVAIL;
604 memcpy(&b->sockaddr, result->ai_addr, result->ai_addrlen);
605 b->sockaddr_size = result->ai_addrlen;
607 freeaddrinfo(result);
612 static int parse_exec_address(sd_bus *b, const char **p, char **guid) {
614 unsigned n_argv = 0, j;
616 size_t allocated = 0;
624 while (**p != 0 && **p != ';') {
625 r = parse_address_key(p, "guid", guid);
631 r = parse_address_key(p, "path", &path);
637 if (startswith(*p, "argv")) {
641 ul = strtoul(*p + 4, (char**) p, 10);
642 if (errno > 0 || **p != '=' || ul > 256) {
650 if (!GREEDY_REALLOC0(argv, allocated, ul + 2)) {
658 r = parse_address_key(p, NULL, argv + ul);
673 /* Make sure there are no holes in the array, with the
674 * exception of argv[0] */
675 for (j = 1; j < n_argv; j++)
681 if (argv && argv[0] == NULL) {
682 argv[0] = strdup(path);
694 for (j = 0; j < n_argv; j++)
702 static int parse_kernel_address(sd_bus *b, const char **p, char **guid) {
703 _cleanup_free_ char *path = NULL;
711 while (**p != 0 && **p != ';') {
712 r = parse_address_key(p, "guid", guid);
718 r = parse_address_key(p, "path", &path);
737 static int parse_container_unix_address(sd_bus *b, const char **p, char **guid) {
738 _cleanup_free_ char *machine = NULL;
746 while (**p != 0 && **p != ';') {
747 r = parse_address_key(p, "guid", guid);
753 r = parse_address_key(p, "machine", &machine);
765 if (!filename_is_safe(machine))
769 b->machine = machine;
772 b->sockaddr.un.sun_family = AF_UNIX;
773 strncpy(b->sockaddr.un.sun_path, "/var/run/dbus/system_bus_socket", sizeof(b->sockaddr.un.sun_path));
774 b->sockaddr_size = offsetof(struct sockaddr_un, sun_path) + sizeof("/var/run/dbus/system_bus_socket") - 1;
779 static int parse_container_kernel_address(sd_bus *b, const char **p, char **guid) {
780 _cleanup_free_ char *machine = NULL;
788 while (**p != 0 && **p != ';') {
789 r = parse_address_key(p, "guid", guid);
795 r = parse_address_key(p, "machine", &machine);
807 if (!filename_is_safe(machine))
811 b->machine = machine;
815 b->kernel = strdup("/dev/kdbus/0-system/bus");
822 static void bus_reset_parsed_address(sd_bus *b) {
826 b->sockaddr_size = 0;
827 strv_free(b->exec_argv);
831 b->server_id = SD_ID128_NULL;
838 static int bus_parse_next_address(sd_bus *b) {
839 _cleanup_free_ char *guid = NULL;
847 if (b->address[b->address_index] == 0)
850 bus_reset_parsed_address(b);
852 a = b->address + b->address_index;
861 if (startswith(a, "unix:")) {
864 r = parse_unix_address(b, &a, &guid);
869 } else if (startswith(a, "tcp:")) {
872 r = parse_tcp_address(b, &a, &guid);
878 } else if (startswith(a, "unixexec:")) {
881 r = parse_exec_address(b, &a, &guid);
887 } else if (startswith(a, "kernel:")) {
890 r = parse_kernel_address(b, &a, &guid);
895 } else if (startswith(a, "x-container-unix:")) {
898 r = parse_container_unix_address(b, &a, &guid);
903 } else if (startswith(a, "x-container-kernel:")) {
906 r = parse_container_kernel_address(b, &a, &guid);
919 r = sd_id128_from_string(guid, &b->server_id);
924 b->address_index = a - b->address;
928 static int bus_start_address(sd_bus *b) {
934 bool skipped = false;
939 r = bus_socket_exec(b);
940 else if (b->machine && b->kernel)
941 r = bus_container_connect_kernel(b);
942 else if (b->machine && b->sockaddr.sa.sa_family != AF_UNSPEC)
943 r = bus_container_connect_socket(b);
945 r = bus_kernel_connect(b);
946 else if (b->sockaddr.sa.sa_family != AF_UNSPEC)
947 r = bus_socket_connect(b);
953 r = attach_io_events(b);
958 b->last_connect_error = -r;
961 r = bus_parse_next_address(b);
965 return b->last_connect_error ? -b->last_connect_error : -ECONNREFUSED;
969 int bus_next_address(sd_bus *b) {
972 bus_reset_parsed_address(b);
973 return bus_start_address(b);
976 static int bus_start_fd(sd_bus *b) {
981 assert(b->input_fd >= 0);
982 assert(b->output_fd >= 0);
984 r = fd_nonblock(b->input_fd, true);
988 r = fd_cloexec(b->input_fd, true);
992 if (b->input_fd != b->output_fd) {
993 r = fd_nonblock(b->output_fd, true);
997 r = fd_cloexec(b->output_fd, true);
1002 if (fstat(b->input_fd, &st) < 0)
1005 if (S_ISCHR(b->input_fd))
1006 return bus_kernel_take_fd(b);
1008 return bus_socket_take_fd(b);
1011 _public_ int sd_bus_start(sd_bus *bus) {
1014 assert_return(bus, -EINVAL);
1015 assert_return(bus->state == BUS_UNSET, -EPERM);
1016 assert_return(!bus_pid_changed(bus), -ECHILD);
1018 bus->state = BUS_OPENING;
1020 if (bus->is_server && bus->bus_client)
1023 if (bus->input_fd >= 0)
1024 r = bus_start_fd(bus);
1025 else if (bus->address || bus->sockaddr.sa.sa_family != AF_UNSPEC || bus->exec_path || bus->kernel || bus->machine)
1026 r = bus_start_address(bus);
1033 return bus_send_hello(bus);
1036 _public_ int sd_bus_open_system(sd_bus **ret) {
1041 assert_return(ret, -EINVAL);
1047 e = secure_getenv("DBUS_SYSTEM_BUS_ADDRESS");
1049 r = sd_bus_set_address(b, e);
1051 r = sd_bus_set_address(b, DEFAULT_SYSTEM_BUS_PATH);
1055 b->bus_client = true;
1057 /* Let's do per-method access control on the system bus. We
1058 * need the caller's UID and capability set for that. */
1060 b->attach_flags |= KDBUS_ATTACH_CAPS | KDBUS_ATTACH_CREDS;
1062 r = sd_bus_start(b);
1074 _public_ int sd_bus_open_user(sd_bus **ret) {
1079 assert_return(ret, -EINVAL);
1085 e = secure_getenv("DBUS_SESSION_BUS_ADDRESS");
1087 r = sd_bus_set_address(b, e);
1091 e = secure_getenv("XDG_RUNTIME_DIR");
1093 _cleanup_free_ char *ee = NULL;
1095 ee = bus_address_escape(e);
1102 asprintf(&b->address, KERNEL_USER_BUS_FMT ";" UNIX_USER_BUS_FMT, (unsigned long) getuid(), ee);
1104 asprintf(&b->address, UNIX_USER_BUS_FMT, ee);
1108 asprintf(&b->address, KERNEL_USER_BUS_FMT, (unsigned long) getuid());
1110 return -ECONNREFUSED;
1120 b->bus_client = true;
1122 /* We don't do any per-method access control on the user
1126 r = sd_bus_start(b);
1138 _public_ int sd_bus_open_system_remote(const char *host, sd_bus **ret) {
1139 _cleanup_free_ char *e = NULL;
1144 assert_return(host, -EINVAL);
1145 assert_return(ret, -EINVAL);
1147 e = bus_address_escape(host);
1151 p = strjoin("unixexec:path=ssh,argv1=-xT,argv2=", e, ",argv3=systemd-stdio-bridge", NULL);
1155 r = sd_bus_new(&bus);
1162 bus->bus_client = true;
1164 r = sd_bus_start(bus);
1174 _public_ int sd_bus_open_system_container(const char *machine, sd_bus **ret) {
1175 _cleanup_free_ char *e = NULL;
1180 assert_return(machine, -EINVAL);
1181 assert_return(ret, -EINVAL);
1182 assert_return(filename_is_safe(machine), -EINVAL);
1184 e = bus_address_escape(machine);
1189 p = strjoin("x-container-kernel:machine=", e, ";x-container-unix:machine=", e, NULL);
1191 p = strjoin("x-container-unix:machine=", e, NULL);
1196 r = sd_bus_new(&bus);
1203 bus->bus_client = true;
1205 r = sd_bus_start(bus);
1215 _public_ void sd_bus_close(sd_bus *bus) {
1219 if (bus->state == BUS_CLOSED)
1221 if (bus_pid_changed(bus))
1224 bus->state = BUS_CLOSED;
1226 sd_bus_detach_event(bus);
1228 /* Drop all queued messages so that they drop references to
1229 * the bus object and the bus may be freed */
1230 bus_reset_queues(bus);
1232 if (!bus->is_kernel)
1235 /* We'll leave the fd open in case this is a kernel bus, since
1236 * there might still be memblocks around that reference this
1237 * bus, and they might need to invoke the KDBUS_CMD_FREE
1238 * ioctl on the fd when they are freed. */
1241 static void bus_enter_closing(sd_bus *bus) {
1244 if (bus->state != BUS_OPENING &&
1245 bus->state != BUS_AUTHENTICATING &&
1246 bus->state != BUS_HELLO &&
1247 bus->state != BUS_RUNNING)
1250 bus->state = BUS_CLOSING;
1253 _public_ sd_bus *sd_bus_ref(sd_bus *bus) {
1254 assert_return(bus, NULL);
1256 assert_se(REFCNT_INC(bus->n_ref) >= 2);
1261 _public_ sd_bus *sd_bus_unref(sd_bus *bus) {
1266 if (REFCNT_DEC(bus->n_ref) <= 0)
1272 _public_ int sd_bus_is_open(sd_bus *bus) {
1274 assert_return(bus, -EINVAL);
1275 assert_return(!bus_pid_changed(bus), -ECHILD);
1277 return BUS_IS_OPEN(bus->state);
1280 _public_ int sd_bus_can_send(sd_bus *bus, char type) {
1283 assert_return(bus, -EINVAL);
1284 assert_return(bus->state != BUS_UNSET, -ENOTCONN);
1285 assert_return(!bus_pid_changed(bus), -ECHILD);
1287 if (type == SD_BUS_TYPE_UNIX_FD) {
1288 if (!(bus->hello_flags & KDBUS_HELLO_ACCEPT_FD))
1291 r = bus_ensure_running(bus);
1295 return bus->can_fds;
1298 return bus_type_is_valid(type);
1301 _public_ int sd_bus_get_server_id(sd_bus *bus, sd_id128_t *server_id) {
1304 assert_return(bus, -EINVAL);
1305 assert_return(server_id, -EINVAL);
1306 assert_return(!bus_pid_changed(bus), -ECHILD);
1308 r = bus_ensure_running(bus);
1312 *server_id = bus->server_id;
1316 static int bus_seal_message(sd_bus *b, sd_bus_message *m, usec_t timeout) {
1321 /* If we copy the same message to multiple
1322 * destinations, avoid using the same cookie
1324 b->cookie = MAX(b->cookie, BUS_MESSAGE_COOKIE(m));
1329 timeout = BUS_DEFAULT_TIMEOUT;
1331 return bus_message_seal(m, ++b->cookie, timeout);
1334 static int bus_remarshal_message(sd_bus *b, sd_bus_message **m) {
1337 /* Do packet version and endianess already match? */
1338 if ((b->message_version == 0 || b->message_version == (*m)->header->version) &&
1339 (b->message_endian == 0 || b->message_endian == (*m)->header->endian))
1342 /* No? Then remarshal! */
1343 return bus_message_remarshal(b, m);
1346 int bus_seal_synthetic_message(sd_bus *b, sd_bus_message *m) {
1350 /* The bus specification says the serial number cannot be 0,
1351 * hence let's fill something in for synthetic messages. Since
1352 * synthetic messages might have a fake sender and we don't
1353 * want to interfere with the real sender's serial numbers we
1354 * pick a fixed, artifical one. We use (uint32_t) -1 rather
1355 * than (uint64_t) -1 since dbus1 only had 32bit identifiers,
1356 * even though kdbus can do 64bit. */
1358 return bus_message_seal(m, 0xFFFFFFFFULL, 0);
1361 static int bus_write_message(sd_bus *bus, sd_bus_message *m, size_t *idx) {
1368 r = bus_kernel_write_message(bus, m);
1370 r = bus_socket_write_message(bus, m, idx);
1375 if (bus->is_kernel || *idx >= BUS_MESSAGE_SIZE(m))
1376 log_debug("Sent message type=%s sender=%s destination=%s object=%s interface=%s member=%s cookie=%lu reply_cookie=%lu error=%s",
1377 bus_message_type_to_string(m->header->type),
1378 strna(sd_bus_message_get_sender(m)),
1379 strna(sd_bus_message_get_destination(m)),
1380 strna(sd_bus_message_get_path(m)),
1381 strna(sd_bus_message_get_interface(m)),
1382 strna(sd_bus_message_get_member(m)),
1383 (unsigned long) BUS_MESSAGE_COOKIE(m),
1384 (unsigned long) m->reply_cookie,
1385 strna(m->error.message));
1390 static int dispatch_wqueue(sd_bus *bus) {
1394 assert(bus->state == BUS_RUNNING || bus->state == BUS_HELLO);
1396 while (bus->wqueue_size > 0) {
1398 r = bus_write_message(bus, bus->wqueue[0], &bus->windex);
1402 /* Didn't do anything this time */
1404 else if (bus->is_kernel || bus->windex >= BUS_MESSAGE_SIZE(bus->wqueue[0])) {
1405 /* Fully written. Let's drop the entry from
1408 * This isn't particularly optimized, but
1409 * well, this is supposed to be our worst-case
1410 * buffer only, and the socket buffer is
1411 * supposed to be our primary buffer, and if
1412 * it got full, then all bets are off
1415 sd_bus_message_unref(bus->wqueue[0]);
1416 bus->wqueue_size --;
1417 memmove(bus->wqueue, bus->wqueue + 1, sizeof(sd_bus_message*) * bus->wqueue_size);
1427 static int bus_read_message(sd_bus *bus) {
1431 return bus_kernel_read_message(bus);
1433 return bus_socket_read_message(bus);
1436 int bus_rqueue_make_room(sd_bus *bus) {
1439 if (bus->rqueue_size >= BUS_RQUEUE_MAX)
1442 if (!GREEDY_REALLOC(bus->rqueue, bus->rqueue_allocated, bus->rqueue_size + 1))
1448 static int dispatch_rqueue(sd_bus *bus, sd_bus_message **m) {
1453 assert(bus->state == BUS_RUNNING || bus->state == BUS_HELLO);
1456 if (bus->rqueue_size > 0) {
1457 /* Dispatch a queued message */
1459 *m = bus->rqueue[0];
1460 bus->rqueue_size --;
1461 memmove(bus->rqueue, bus->rqueue + 1, sizeof(sd_bus_message*) * bus->rqueue_size);
1465 /* Try to read a new message */
1466 r = bus_read_message(bus);
1476 _public_ int sd_bus_send(sd_bus *bus, sd_bus_message *_m, uint64_t *cookie) {
1477 _cleanup_bus_message_unref_ sd_bus_message *m = sd_bus_message_ref(_m);
1480 assert_return(bus, -EINVAL);
1481 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
1482 assert_return(m, -EINVAL);
1483 assert_return(!bus_pid_changed(bus), -ECHILD);
1486 r = sd_bus_can_send(bus, SD_BUS_TYPE_UNIX_FD);
1493 /* If the cookie number isn't kept, then we know that no reply
1495 if (!cookie && !m->sealed)
1496 m->header->flags |= BUS_MESSAGE_NO_REPLY_EXPECTED;
1498 r = bus_seal_message(bus, m, 0);
1502 /* Remarshall if we have to. This will possible unref the
1503 * message and place a replacement in m */
1504 r = bus_remarshal_message(bus, &m);
1508 /* If this is a reply and no reply was requested, then let's
1509 * suppress this, if we can */
1510 if (m->dont_send && !cookie)
1513 if ((bus->state == BUS_RUNNING || bus->state == BUS_HELLO) && bus->wqueue_size <= 0) {
1516 r = bus_write_message(bus, m, &idx);
1518 if (r == -EPIPE || r == -ENOTCONN || r == -ESHUTDOWN)
1519 bus_enter_closing(bus);
1522 } else if (!bus->is_kernel && idx < BUS_MESSAGE_SIZE(m)) {
1523 /* Wasn't fully written. So let's remember how
1524 * much was written. Note that the first entry
1525 * of the wqueue array is always allocated so
1526 * that we always can remember how much was
1528 bus->wqueue[0] = sd_bus_message_ref(m);
1529 bus->wqueue_size = 1;
1533 /* Just append it to the queue. */
1535 if (bus->wqueue_size >= BUS_WQUEUE_MAX)
1538 if (!GREEDY_REALLOC(bus->wqueue, bus->wqueue_allocated, bus->wqueue_size + 1))
1541 bus->wqueue[bus->wqueue_size ++] = sd_bus_message_ref(m);
1545 *cookie = BUS_MESSAGE_COOKIE(m);
1550 _public_ int sd_bus_send_to(sd_bus *bus, sd_bus_message *m, const char *destination, uint64_t *cookie) {
1553 assert_return(bus, -EINVAL);
1554 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
1555 assert_return(m, -EINVAL);
1556 assert_return(!bus_pid_changed(bus), -ECHILD);
1558 if (!streq_ptr(m->destination, destination)) {
1563 r = sd_bus_message_set_destination(m, destination);
1568 return sd_bus_send(bus, m, cookie);
1571 static usec_t calc_elapse(uint64_t usec) {
1572 if (usec == (uint64_t) -1)
1575 return now(CLOCK_MONOTONIC) + usec;
1578 static int timeout_compare(const void *a, const void *b) {
1579 const struct reply_callback *x = a, *y = b;
1581 if (x->timeout != 0 && y->timeout == 0)
1584 if (x->timeout == 0 && y->timeout != 0)
1587 if (x->timeout < y->timeout)
1590 if (x->timeout > y->timeout)
1596 _public_ int sd_bus_call_async(
1599 sd_bus_message_handler_t callback,
1604 _cleanup_bus_message_unref_ sd_bus_message *m = sd_bus_message_ref(_m);
1605 struct reply_callback *c;
1608 assert_return(bus, -EINVAL);
1609 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
1610 assert_return(m, -EINVAL);
1611 assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL);
1612 assert_return(!(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED), -EINVAL);
1613 assert_return(callback, -EINVAL);
1614 assert_return(!bus_pid_changed(bus), -ECHILD);
1616 r = hashmap_ensure_allocated(&bus->reply_callbacks, uint64_hash_func, uint64_compare_func);
1620 r = prioq_ensure_allocated(&bus->reply_callbacks_prioq, timeout_compare);
1624 r = bus_seal_message(bus, m, usec);
1628 r = bus_remarshal_message(bus, &m);
1632 c = new0(struct reply_callback, 1);
1636 c->callback = callback;
1637 c->userdata = userdata;
1638 c->cookie = BUS_MESSAGE_COOKIE(m);
1639 c->timeout = calc_elapse(m->timeout);
1641 r = hashmap_put(bus->reply_callbacks, &c->cookie, c);
1647 if (c->timeout != 0) {
1648 r = prioq_put(bus->reply_callbacks_prioq, c, &c->prioq_idx);
1651 sd_bus_call_async_cancel(bus, c->cookie);
1656 r = sd_bus_send(bus, m, cookie);
1658 sd_bus_call_async_cancel(bus, c->cookie);
1665 _public_ int sd_bus_call_async_cancel(sd_bus *bus, uint64_t cookie) {
1666 struct reply_callback *c;
1668 assert_return(bus, -EINVAL);
1669 assert_return(cookie != 0, -EINVAL);
1670 assert_return(!bus_pid_changed(bus), -ECHILD);
1672 c = hashmap_remove(bus->reply_callbacks, &cookie);
1676 if (c->timeout != 0)
1677 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
1683 int bus_ensure_running(sd_bus *bus) {
1688 if (bus->state == BUS_UNSET || bus->state == BUS_CLOSED || bus->state == BUS_CLOSING)
1690 if (bus->state == BUS_RUNNING)
1694 r = sd_bus_process(bus, NULL);
1697 if (bus->state == BUS_RUNNING)
1702 r = sd_bus_wait(bus, (uint64_t) -1);
1708 _public_ int sd_bus_call(
1712 sd_bus_error *error,
1713 sd_bus_message **reply) {
1715 _cleanup_bus_message_unref_ sd_bus_message *m = sd_bus_message_ref(_m);
1721 assert_return(bus, -EINVAL);
1722 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
1723 assert_return(m, -EINVAL);
1724 assert_return(m->header->type == SD_BUS_MESSAGE_METHOD_CALL, -EINVAL);
1725 assert_return(!(m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED), -EINVAL);
1726 assert_return(!bus_error_is_dirty(error), -EINVAL);
1727 assert_return(!bus_pid_changed(bus), -ECHILD);
1729 r = bus_ensure_running(bus);
1733 i = bus->rqueue_size;
1735 r = bus_seal_message(bus, m, usec);
1739 r = bus_remarshal_message(bus, &m);
1743 r = sd_bus_send(bus, m, &cookie);
1747 timeout = calc_elapse(m->timeout);
1752 while (i < bus->rqueue_size) {
1753 sd_bus_message *incoming = NULL;
1755 incoming = bus->rqueue[i];
1757 if (incoming->reply_cookie == cookie) {
1758 /* Found a match! */
1760 memmove(bus->rqueue + i, bus->rqueue + i + 1, sizeof(sd_bus_message*) * (bus->rqueue_size - i - 1));
1763 if (incoming->header->type == SD_BUS_MESSAGE_METHOD_RETURN) {
1768 sd_bus_message_unref(incoming);
1771 } else if (incoming->header->type == SD_BUS_MESSAGE_METHOD_ERROR)
1772 r = sd_bus_error_copy(error, &incoming->error);
1776 sd_bus_message_unref(incoming);
1779 } else if (BUS_MESSAGE_COOKIE(incoming) == cookie &&
1782 streq(bus->unique_name, incoming->sender)) {
1784 memmove(bus->rqueue + i, bus->rqueue + i + 1, sizeof(sd_bus_message*) * (bus->rqueue_size - i - 1));
1787 /* Our own message? Somebody is trying
1788 * to send its own client a message,
1789 * let's not dead-lock, let's fail
1792 sd_bus_message_unref(incoming);
1796 /* Try to read more, right-away */
1800 r = bus_read_message(bus);
1802 if (r == -EPIPE || r == -ENOTCONN || r == -ESHUTDOWN)
1803 bus_enter_closing(bus);
1813 n = now(CLOCK_MONOTONIC);
1819 left = (uint64_t) -1;
1821 r = bus_poll(bus, true, left);
1827 r = dispatch_wqueue(bus);
1829 if (r == -EPIPE || r == -ENOTCONN || r == -ESHUTDOWN)
1830 bus_enter_closing(bus);
1837 _public_ int sd_bus_get_fd(sd_bus *bus) {
1839 assert_return(bus, -EINVAL);
1840 assert_return(bus->input_fd == bus->output_fd, -EPERM);
1841 assert_return(!bus_pid_changed(bus), -ECHILD);
1843 return bus->input_fd;
1846 _public_ int sd_bus_get_events(sd_bus *bus) {
1849 assert_return(bus, -EINVAL);
1850 assert_return(BUS_IS_OPEN(bus->state) || bus->state == BUS_CLOSING, -ENOTCONN);
1851 assert_return(!bus_pid_changed(bus), -ECHILD);
1853 if (bus->state == BUS_OPENING)
1855 else if (bus->state == BUS_AUTHENTICATING) {
1857 if (bus_socket_auth_needs_write(bus))
1862 } else if (bus->state == BUS_RUNNING || bus->state == BUS_HELLO) {
1863 if (bus->rqueue_size <= 0)
1865 if (bus->wqueue_size > 0)
1872 _public_ int sd_bus_get_timeout(sd_bus *bus, uint64_t *timeout_usec) {
1873 struct reply_callback *c;
1875 assert_return(bus, -EINVAL);
1876 assert_return(timeout_usec, -EINVAL);
1877 assert_return(BUS_IS_OPEN(bus->state) || bus->state == BUS_CLOSING, -ENOTCONN);
1878 assert_return(!bus_pid_changed(bus), -ECHILD);
1880 if (bus->state == BUS_CLOSING) {
1885 if (bus->state == BUS_AUTHENTICATING) {
1886 *timeout_usec = bus->auth_timeout;
1890 if (bus->state != BUS_RUNNING && bus->state != BUS_HELLO) {
1891 *timeout_usec = (uint64_t) -1;
1895 if (bus->rqueue_size > 0) {
1900 c = prioq_peek(bus->reply_callbacks_prioq);
1902 *timeout_usec = (uint64_t) -1;
1906 *timeout_usec = c->timeout;
1910 static int process_timeout(sd_bus *bus) {
1911 _cleanup_bus_error_free_ sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
1912 _cleanup_bus_message_unref_ sd_bus_message* m = NULL;
1913 struct reply_callback *c;
1919 c = prioq_peek(bus->reply_callbacks_prioq);
1923 n = now(CLOCK_MONOTONIC);
1927 r = bus_message_new_synthetic_error(
1930 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY, "Method call timed out"),
1935 m->sender = "org.freedesktop.DBus";
1937 r = bus_seal_synthetic_message(bus, m);
1941 assert_se(prioq_pop(bus->reply_callbacks_prioq) == c);
1942 hashmap_remove(bus->reply_callbacks, &c->cookie);
1945 bus->iteration_counter ++;
1947 r = c->callback(bus, m, c->userdata, &error_buffer);
1948 r = bus_maybe_reply_error(m, r, &error_buffer);
1951 bus->current = NULL;
1956 static int process_hello(sd_bus *bus, sd_bus_message *m) {
1960 if (bus->state != BUS_HELLO)
1963 /* Let's make sure the first message on the bus is the HELLO
1964 * reply. But note that we don't actually parse the message
1965 * here (we leave that to the usual handling), we just verify
1966 * we don't let any earlier msg through. */
1968 if (m->header->type != SD_BUS_MESSAGE_METHOD_RETURN &&
1969 m->header->type != SD_BUS_MESSAGE_METHOD_ERROR)
1972 if (m->reply_cookie != bus->hello_cookie)
1978 static int process_reply(sd_bus *bus, sd_bus_message *m) {
1979 _cleanup_bus_error_free_ sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
1980 struct reply_callback *c;
1986 if (m->header->type != SD_BUS_MESSAGE_METHOD_RETURN &&
1987 m->header->type != SD_BUS_MESSAGE_METHOD_ERROR)
1990 c = hashmap_remove(bus->reply_callbacks, &m->reply_cookie);
1994 if (c->timeout != 0)
1995 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
1997 r = sd_bus_message_rewind(m, true);
2001 r = c->callback(bus, m, c->userdata, &error_buffer);
2002 r = bus_maybe_reply_error(m, r, &error_buffer);
2008 static int process_filter(sd_bus *bus, sd_bus_message *m) {
2009 _cleanup_bus_error_free_ sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2010 struct filter_callback *l;
2017 bus->filter_callbacks_modified = false;
2019 LIST_FOREACH(callbacks, l, bus->filter_callbacks) {
2021 if (bus->filter_callbacks_modified)
2024 /* Don't run this more than once per iteration */
2025 if (l->last_iteration == bus->iteration_counter)
2028 l->last_iteration = bus->iteration_counter;
2030 r = sd_bus_message_rewind(m, true);
2034 r = l->callback(bus, m, l->userdata, &error_buffer);
2035 r = bus_maybe_reply_error(m, r, &error_buffer);
2041 } while (bus->filter_callbacks_modified);
2046 static int process_match(sd_bus *bus, sd_bus_message *m) {
2053 bus->match_callbacks_modified = false;
2055 r = bus_match_run(bus, &bus->match_callbacks, m);
2059 } while (bus->match_callbacks_modified);
2064 static int process_builtin(sd_bus *bus, sd_bus_message *m) {
2065 _cleanup_bus_message_unref_ sd_bus_message *reply = NULL;
2071 if (bus->manual_peer_interface)
2074 if (m->header->type != SD_BUS_MESSAGE_METHOD_CALL)
2077 if (!streq_ptr(m->interface, "org.freedesktop.DBus.Peer"))
2080 if (m->header->flags & BUS_MESSAGE_NO_REPLY_EXPECTED)
2083 if (streq_ptr(m->member, "Ping"))
2084 r = sd_bus_message_new_method_return(m, &reply);
2085 else if (streq_ptr(m->member, "GetMachineId")) {
2089 r = sd_id128_get_machine(&id);
2093 r = sd_bus_message_new_method_return(m, &reply);
2097 r = sd_bus_message_append(reply, "s", sd_id128_to_string(id, sid));
2099 r = sd_bus_message_new_method_errorf(
2101 SD_BUS_ERROR_UNKNOWN_METHOD,
2102 "Unknown method '%s' on interface '%s'.", m->member, m->interface);
2108 r = sd_bus_send(bus, reply, NULL);
2115 static int process_message(sd_bus *bus, sd_bus_message *m) {
2122 bus->iteration_counter++;
2124 log_debug("Got message type=%s sender=%s destination=%s object=%s interface=%s member=%s cookie=%lu reply_cookie=%lu error=%s",
2125 bus_message_type_to_string(m->header->type),
2126 strna(sd_bus_message_get_sender(m)),
2127 strna(sd_bus_message_get_destination(m)),
2128 strna(sd_bus_message_get_path(m)),
2129 strna(sd_bus_message_get_interface(m)),
2130 strna(sd_bus_message_get_member(m)),
2131 (unsigned long) BUS_MESSAGE_COOKIE(m),
2132 (unsigned long) m->reply_cookie,
2133 strna(m->error.message));
2135 r = process_hello(bus, m);
2139 r = process_reply(bus, m);
2143 r = process_filter(bus, m);
2147 r = process_match(bus, m);
2151 r = process_builtin(bus, m);
2155 r = bus_process_object(bus, m);
2158 bus->current = NULL;
2162 static int process_running(sd_bus *bus, sd_bus_message **ret) {
2163 _cleanup_bus_message_unref_ sd_bus_message *m = NULL;
2167 assert(bus->state == BUS_RUNNING || bus->state == BUS_HELLO);
2169 r = process_timeout(bus);
2173 r = dispatch_wqueue(bus);
2177 r = dispatch_rqueue(bus, &m);
2183 r = process_message(bus, m);
2188 r = sd_bus_message_rewind(m, true);
2197 if (m->header->type == SD_BUS_MESSAGE_METHOD_CALL) {
2199 log_debug("Unprocessed message call sender=%s object=%s interface=%s member=%s",
2200 strna(sd_bus_message_get_sender(m)),
2201 strna(sd_bus_message_get_path(m)),
2202 strna(sd_bus_message_get_interface(m)),
2203 strna(sd_bus_message_get_member(m)));
2205 r = sd_bus_reply_method_errorf(
2207 SD_BUS_ERROR_UNKNOWN_OBJECT,
2208 "Unknown object '%s'.", m->path);
2222 static int process_closing(sd_bus *bus, sd_bus_message **ret) {
2223 _cleanup_bus_message_unref_ sd_bus_message *m = NULL;
2224 struct reply_callback *c;
2228 assert(bus->state == BUS_CLOSING);
2230 c = hashmap_first(bus->reply_callbacks);
2232 _cleanup_bus_error_free_ sd_bus_error error_buffer = SD_BUS_ERROR_NULL;
2234 /* First, fail all outstanding method calls */
2235 r = bus_message_new_synthetic_error(
2238 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY, "Connection terminated"),
2243 r = bus_seal_synthetic_message(bus, m);
2247 if (c->timeout != 0)
2248 prioq_remove(bus->reply_callbacks_prioq, c, &c->prioq_idx);
2250 hashmap_remove(bus->reply_callbacks, &c->cookie);
2253 bus->iteration_counter++;
2255 r = c->callback(bus, m, c->userdata, &error_buffer);
2256 r = bus_maybe_reply_error(m, r, &error_buffer);
2262 /* Then, synthesize a Disconnected message */
2263 r = sd_bus_message_new_signal(
2265 "/org/freedesktop/DBus/Local",
2266 "org.freedesktop.DBus.Local",
2272 m->sender = "org.freedesktop.DBus.Local";
2274 r = bus_seal_synthetic_message(bus, m);
2281 bus->iteration_counter++;
2283 r = process_filter(bus, m);
2287 r = process_match(bus, m);
2299 bus->current = NULL;
2303 _public_ int sd_bus_process(sd_bus *bus, sd_bus_message **ret) {
2304 BUS_DONT_DESTROY(bus);
2307 /* Returns 0 when we didn't do anything. This should cause the
2308 * caller to invoke sd_bus_wait() before returning the next
2309 * time. Returns > 0 when we did something, which possibly
2310 * means *ret is filled in with an unprocessed message. */
2312 assert_return(bus, -EINVAL);
2313 assert_return(!bus_pid_changed(bus), -ECHILD);
2315 /* We don't allow recursively invoking sd_bus_process(). */
2316 assert_return(!bus->current, -EBUSY);
2318 switch (bus->state) {
2327 r = bus_socket_process_opening(bus);
2328 if (r == -ECONNRESET || r == -EPIPE || r == -ESHUTDOWN) {
2329 bus_enter_closing(bus);
2337 case BUS_AUTHENTICATING:
2338 r = bus_socket_process_authenticating(bus);
2339 if (r == -ECONNRESET || r == -EPIPE || r == -ESHUTDOWN) {
2340 bus_enter_closing(bus);
2352 r = process_running(bus, ret);
2353 if (r == -ECONNRESET || r == -EPIPE || r == -ESHUTDOWN) {
2354 bus_enter_closing(bus);
2364 return process_closing(bus, ret);
2367 assert_not_reached("Unknown state");
2370 static int bus_poll(sd_bus *bus, bool need_more, uint64_t timeout_usec) {
2371 struct pollfd p[2] = {};
2374 usec_t m = (usec_t) -1;
2378 if (bus->state == BUS_CLOSING)
2381 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
2383 e = sd_bus_get_events(bus);
2388 /* The caller really needs some more data, he doesn't
2389 * care about what's already read, or any timeouts
2394 /* The caller wants to process if there's something to
2395 * process, but doesn't care otherwise */
2397 r = sd_bus_get_timeout(bus, &until);
2402 nw = now(CLOCK_MONOTONIC);
2403 m = until > nw ? until - nw : 0;
2407 if (timeout_usec != (uint64_t) -1 && (m == (uint64_t) -1 || timeout_usec < m))
2410 p[0].fd = bus->input_fd;
2411 if (bus->output_fd == bus->input_fd) {
2415 p[0].events = e & POLLIN;
2416 p[1].fd = bus->output_fd;
2417 p[1].events = e & POLLOUT;
2421 r = ppoll(p, n, m == (uint64_t) -1 ? NULL : timespec_store(&ts, m), NULL);
2425 return r > 0 ? 1 : 0;
2428 _public_ int sd_bus_wait(sd_bus *bus, uint64_t timeout_usec) {
2430 assert_return(bus, -EINVAL);
2431 assert_return(!bus_pid_changed(bus), -ECHILD);
2433 if (bus->state == BUS_CLOSING)
2436 assert_return(BUS_IS_OPEN(bus->state) , -ENOTCONN);
2438 if (bus->rqueue_size > 0)
2441 return bus_poll(bus, false, timeout_usec);
2444 _public_ int sd_bus_flush(sd_bus *bus) {
2447 assert_return(bus, -EINVAL);
2448 assert_return(!bus_pid_changed(bus), -ECHILD);
2450 if (bus->state == BUS_CLOSING)
2453 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
2455 r = bus_ensure_running(bus);
2459 if (bus->wqueue_size <= 0)
2463 r = dispatch_wqueue(bus);
2465 if (r == -EPIPE || r == -ENOTCONN || r == -ESHUTDOWN)
2466 bus_enter_closing(bus);
2471 if (bus->wqueue_size <= 0)
2474 r = bus_poll(bus, false, (uint64_t) -1);
2480 _public_ int sd_bus_add_filter(sd_bus *bus,
2481 sd_bus_message_handler_t callback,
2484 struct filter_callback *f;
2486 assert_return(bus, -EINVAL);
2487 assert_return(callback, -EINVAL);
2488 assert_return(!bus_pid_changed(bus), -ECHILD);
2490 f = new0(struct filter_callback, 1);
2493 f->callback = callback;
2494 f->userdata = userdata;
2496 bus->filter_callbacks_modified = true;
2497 LIST_PREPEND(callbacks, bus->filter_callbacks, f);
2501 _public_ int sd_bus_remove_filter(sd_bus *bus,
2502 sd_bus_message_handler_t callback,
2505 struct filter_callback *f;
2507 assert_return(bus, -EINVAL);
2508 assert_return(callback, -EINVAL);
2509 assert_return(!bus_pid_changed(bus), -ECHILD);
2511 LIST_FOREACH(callbacks, f, bus->filter_callbacks) {
2512 if (f->callback == callback && f->userdata == userdata) {
2513 bus->filter_callbacks_modified = true;
2514 LIST_REMOVE(callbacks, bus->filter_callbacks, f);
2523 _public_ int sd_bus_add_match(sd_bus *bus,
2525 sd_bus_message_handler_t callback,
2528 struct bus_match_component *components = NULL;
2529 unsigned n_components = 0;
2530 uint64_t cookie = 0;
2533 assert_return(bus, -EINVAL);
2534 assert_return(match, -EINVAL);
2535 assert_return(!bus_pid_changed(bus), -ECHILD);
2537 r = bus_match_parse(match, &components, &n_components);
2541 if (bus->bus_client) {
2542 cookie = ++bus->match_cookie;
2544 r = bus_add_match_internal(bus, match, components, n_components, cookie);
2549 bus->match_callbacks_modified = true;
2550 r = bus_match_add(&bus->match_callbacks, components, n_components, callback, userdata, cookie, NULL);
2552 if (bus->bus_client)
2553 bus_remove_match_internal(bus, match, cookie);
2557 bus_match_parse_free(components, n_components);
2561 _public_ int sd_bus_remove_match(sd_bus *bus,
2563 sd_bus_message_handler_t callback,
2566 struct bus_match_component *components = NULL;
2567 unsigned n_components = 0;
2569 uint64_t cookie = 0;
2571 assert_return(bus, -EINVAL);
2572 assert_return(match, -EINVAL);
2573 assert_return(!bus_pid_changed(bus), -ECHILD);
2575 r = bus_match_parse(match, &components, &n_components);
2579 bus->match_callbacks_modified = true;
2580 r = bus_match_remove(&bus->match_callbacks, components, n_components, callback, userdata, &cookie);
2582 if (bus->bus_client)
2583 q = bus_remove_match_internal(bus, match, cookie);
2585 bus_match_parse_free(components, n_components);
2587 return r < 0 ? r : q;
2590 bool bus_pid_changed(sd_bus *bus) {
2593 /* We don't support people creating a bus connection and
2594 * keeping it around over a fork(). Let's complain. */
2596 return bus->original_pid != getpid();
2599 static int io_callback(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
2600 sd_bus *bus = userdata;
2605 r = sd_bus_process(bus, NULL);
2612 static int time_callback(sd_event_source *s, uint64_t usec, void *userdata) {
2613 sd_bus *bus = userdata;
2618 r = sd_bus_process(bus, NULL);
2625 static int prepare_callback(sd_event_source *s, void *userdata) {
2626 sd_bus *bus = userdata;
2633 e = sd_bus_get_events(bus);
2637 if (bus->output_fd != bus->input_fd) {
2639 r = sd_event_source_set_io_events(bus->input_io_event_source, e & POLLIN);
2643 r = sd_event_source_set_io_events(bus->output_io_event_source, e & POLLOUT);
2647 r = sd_event_source_set_io_events(bus->input_io_event_source, e);
2652 r = sd_bus_get_timeout(bus, &until);
2658 j = sd_event_source_set_time(bus->time_event_source, until);
2663 r = sd_event_source_set_enabled(bus->time_event_source, r > 0);
2670 static int quit_callback(sd_event_source *event, void *userdata) {
2671 sd_bus *bus = userdata;
2680 static int attach_io_events(sd_bus *bus) {
2685 if (bus->input_fd < 0)
2691 if (!bus->input_io_event_source) {
2692 r = sd_event_add_io(bus->event, bus->input_fd, 0, io_callback, bus, &bus->input_io_event_source);
2696 r = sd_event_source_set_prepare(bus->input_io_event_source, prepare_callback);
2700 r = sd_event_source_set_priority(bus->input_io_event_source, bus->event_priority);
2702 r = sd_event_source_set_io_fd(bus->input_io_event_source, bus->input_fd);
2707 if (bus->output_fd != bus->input_fd) {
2708 assert(bus->output_fd >= 0);
2710 if (!bus->output_io_event_source) {
2711 r = sd_event_add_io(bus->event, bus->output_fd, 0, io_callback, bus, &bus->output_io_event_source);
2715 r = sd_event_source_set_priority(bus->output_io_event_source, bus->event_priority);
2717 r = sd_event_source_set_io_fd(bus->output_io_event_source, bus->output_fd);
2726 static void detach_io_events(sd_bus *bus) {
2729 if (bus->input_io_event_source) {
2730 sd_event_source_set_enabled(bus->input_io_event_source, SD_EVENT_OFF);
2731 bus->input_io_event_source = sd_event_source_unref(bus->input_io_event_source);
2734 if (bus->output_io_event_source) {
2735 sd_event_source_set_enabled(bus->output_io_event_source, SD_EVENT_OFF);
2736 bus->output_io_event_source = sd_event_source_unref(bus->output_io_event_source);
2740 _public_ int sd_bus_attach_event(sd_bus *bus, sd_event *event, int priority) {
2743 assert_return(bus, -EINVAL);
2744 assert_return(!bus->event, -EBUSY);
2746 assert(!bus->input_io_event_source);
2747 assert(!bus->output_io_event_source);
2748 assert(!bus->time_event_source);
2751 bus->event = sd_event_ref(event);
2753 r = sd_event_default(&bus->event);
2758 bus->event_priority = priority;
2760 r = sd_event_add_monotonic(bus->event, 0, 0, time_callback, bus, &bus->time_event_source);
2764 r = sd_event_source_set_priority(bus->time_event_source, priority);
2768 r = sd_event_add_exit(bus->event, quit_callback, bus, &bus->quit_event_source);
2772 r = attach_io_events(bus);
2779 sd_bus_detach_event(bus);
2783 _public_ int sd_bus_detach_event(sd_bus *bus) {
2784 assert_return(bus, -EINVAL);
2789 detach_io_events(bus);
2791 if (bus->time_event_source) {
2792 sd_event_source_set_enabled(bus->time_event_source, SD_EVENT_OFF);
2793 bus->time_event_source = sd_event_source_unref(bus->time_event_source);
2796 if (bus->quit_event_source) {
2797 sd_event_source_set_enabled(bus->quit_event_source, SD_EVENT_OFF);
2798 bus->quit_event_source = sd_event_source_unref(bus->quit_event_source);
2802 bus->event = sd_event_unref(bus->event);
2807 _public_ sd_event* sd_bus_get_event(sd_bus *bus) {
2808 assert_return(bus, NULL);
2813 _public_ sd_bus_message* sd_bus_get_current(sd_bus *bus) {
2814 assert_return(bus, NULL);
2816 return bus->current;
2819 static int bus_default(int (*bus_open)(sd_bus **), sd_bus **default_bus, sd_bus **ret) {
2824 assert(default_bus);
2827 return !!*default_bus;
2830 *ret = sd_bus_ref(*default_bus);
2838 b->default_bus_ptr = default_bus;
2846 _public_ int sd_bus_default_system(sd_bus **ret) {
2847 static thread_local sd_bus *default_system_bus = NULL;
2849 return bus_default(sd_bus_open_system, &default_system_bus, ret);
2852 _public_ int sd_bus_default_user(sd_bus **ret) {
2853 static thread_local sd_bus *default_user_bus = NULL;
2855 return bus_default(sd_bus_open_user, &default_user_bus, ret);
2858 _public_ int sd_bus_get_tid(sd_bus *b, pid_t *tid) {
2859 assert_return(b, -EINVAL);
2860 assert_return(tid, -EINVAL);
2861 assert_return(!bus_pid_changed(b), -ECHILD);
2869 return sd_event_get_tid(b->event, tid);
2874 _public_ char *sd_bus_label_escape(const char *s) {
2878 assert_return(s, NULL);
2880 /* Escapes all chars that D-Bus' object path cannot deal
2881 * with. Can be reversed with bus_path_unescape(). We special
2882 * case the empty string. */
2887 r = new(char, strlen(s)*3 + 1);
2891 for (f = s, t = r; *f; f++) {
2893 /* Escape everything that is not a-zA-Z0-9. We also
2894 * escape 0-9 if it's the first character */
2896 if (!(*f >= 'A' && *f <= 'Z') &&
2897 !(*f >= 'a' && *f <= 'z') &&
2898 !(f > s && *f >= '0' && *f <= '9')) {
2900 *(t++) = hexchar(*f >> 4);
2901 *(t++) = hexchar(*f);
2911 _public_ char *sd_bus_label_unescape(const char *f) {
2914 assert_return(f, NULL);
2916 /* Special case for the empty string */
2920 r = new(char, strlen(f) + 1);
2924 for (t = r; *f; f++) {
2929 if ((a = unhexchar(f[1])) < 0 ||
2930 (b = unhexchar(f[2])) < 0) {
2931 /* Invalid escape code, let's take it literal then */
2934 *(t++) = (char) ((a << 4) | b);
2946 _public_ int sd_bus_get_peer_creds(sd_bus *bus, uint64_t mask, sd_bus_creds **ret) {
2951 assert_return(bus, -EINVAL);
2952 assert_return(mask <= _SD_BUS_CREDS_ALL, -ENOTSUP);
2953 assert_return(ret, -EINVAL);
2954 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
2955 assert_return(!bus_pid_changed(bus), -ECHILD);
2956 assert_return(!bus->is_kernel, -ENOTSUP);
2958 if (!bus->ucred_valid && !isempty(bus->label))
2961 c = bus_creds_new();
2965 if (bus->ucred_valid) {
2966 pid = c->pid = bus->ucred.pid;
2967 c->uid = bus->ucred.uid;
2968 c->gid = bus->ucred.gid;
2970 c->mask |= (SD_BUS_CREDS_UID | SD_BUS_CREDS_PID | SD_BUS_CREDS_GID) & mask;
2973 if (!isempty(bus->label) && (mask & SD_BUS_CREDS_SELINUX_CONTEXT)) {
2974 c->label = strdup(bus->label);
2976 sd_bus_creds_unref(c);
2980 c->mask |= SD_BUS_CREDS_SELINUX_CONTEXT;
2983 r = bus_creds_add_more(c, mask, pid, 0);
2991 _public_ int sd_bus_try_close(sd_bus *bus) {
2994 assert_return(bus, -EINVAL);
2995 assert_return(BUS_IS_OPEN(bus->state), -ENOTCONN);
2996 assert_return(!bus_pid_changed(bus), -ECHILD);
2997 assert_return(bus->is_kernel, -ENOTSUP);
2999 if (bus->rqueue_size > 0)
3002 if (bus->wqueue_size > 0)
3005 r = bus_kernel_try_close(bus);