1 /* SPDX-License-Identifier: LGPL-2.1+ */
3 This file is part of systemd.
5 Copyright 2013 Lennart Poettering
20 #include "alloc-util.h"
21 #include "bus-container.h"
22 #include "bus-control.h"
23 #include "bus-internal.h"
24 #include "bus-kernel.h"
25 #include "bus-label.h"
26 #include "bus-message.h"
27 #include "bus-objects.h"
28 #include "bus-protocol.h"
30 #include "bus-socket.h"
31 #include "bus-track.h"
34 #include "cgroup-util.h"
37 #include "hexdecoct.h"
38 #include "hostname-util.h"
41 #include "parse-util.h"
42 #include "process-util.h"
43 #include "string-util.h"
47 #define log_debug_bus_message(m) \
49 sd_bus_message *_mm = (m); \
50 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", \
51 bus_message_type_to_string(_mm->header->type), \
52 strna(sd_bus_message_get_sender(_mm)), \
53 strna(sd_bus_message_get_destination(_mm)), \
54 strna(sd_bus_message_get_path(_mm)), \
55 strna(sd_bus_message_get_interface(_mm)), \
56 strna(sd_bus_message_get_member(_mm)), \
57 BUS_MESSAGE_COOKIE(_mm), \
59 strna(_mm->root_container.signature), \
60 strna(_mm->error.name), \
61 strna(_mm->error.message)); \
64 static int bus_poll(sd_bus
*bus
, bool need_more
, uint64_t timeout_usec
);
65 static void bus_detach_io_events(sd_bus
*b
);
66 static void bus_detach_inotify_event(sd_bus
*b
);
68 static thread_local sd_bus
*default_system_bus
= NULL
;
69 static thread_local sd_bus
*default_user_bus
= NULL
;
70 static thread_local sd_bus
*default_starter_bus
= NULL
;
72 static sd_bus
**bus_choose_default(int (**bus_open
)(sd_bus
**)) {
75 /* Let's try our best to reuse another cached connection. If
76 * the starter bus type is set, connect via our normal
77 * connection logic, ignoring $DBUS_STARTER_ADDRESS, so that
78 * we can share the connection with the user/system default
81 e
= secure_getenv("DBUS_STARTER_BUS_TYPE");
83 if (streq(e
, "system")) {
85 *bus_open
= sd_bus_open_system
;
86 return &default_system_bus
;
87 } else if (STR_IN_SET(e
, "user", "session")) {
89 *bus_open
= sd_bus_open_user
;
90 return &default_user_bus
;
94 /* No type is specified, so we have not other option than to
95 * use the starter address if it is set. */
96 e
= secure_getenv("DBUS_STARTER_ADDRESS");
99 *bus_open
= sd_bus_open
;
100 return &default_starter_bus
;
103 /* Finally, if nothing is set use the cached connection for
106 if (cg_pid_get_owner_uid(0, NULL
) >= 0) {
108 *bus_open
= sd_bus_open_user
;
109 return &default_user_bus
;
112 *bus_open
= sd_bus_open_system
;
113 return &default_system_bus
;
117 sd_bus
*bus_resolve(sd_bus
*bus
) {
118 switch ((uintptr_t) bus
) {
119 case (uintptr_t) SD_BUS_DEFAULT
:
120 return *(bus_choose_default(NULL
));
121 case (uintptr_t) SD_BUS_DEFAULT_USER
:
122 return default_user_bus
;
123 case (uintptr_t) SD_BUS_DEFAULT_SYSTEM
:
124 return default_system_bus
;
130 void bus_close_io_fds(sd_bus
*b
) {
133 bus_detach_io_events(b
);
135 if (b
->input_fd
!= b
->output_fd
)
136 safe_close(b
->output_fd
);
137 b
->output_fd
= b
->input_fd
= safe_close(b
->input_fd
);
140 void bus_close_inotify_fd(sd_bus
*b
) {
143 bus_detach_inotify_event(b
);
145 b
->inotify_fd
= safe_close(b
->inotify_fd
);
146 b
->inotify_watches
= mfree(b
->inotify_watches
);
147 b
->n_inotify_watches
= 0;
150 static void bus_reset_queues(sd_bus
*b
) {
153 while (b
->rqueue_size
> 0)
154 sd_bus_message_unref(b
->rqueue
[--b
->rqueue_size
]);
156 b
->rqueue
= mfree(b
->rqueue
);
157 b
->rqueue_allocated
= 0;
159 while (b
->wqueue_size
> 0)
160 sd_bus_message_unref(b
->wqueue
[--b
->wqueue_size
]);
162 b
->wqueue
= mfree(b
->wqueue
);
163 b
->wqueue_allocated
= 0;
166 static sd_bus
* bus_free(sd_bus
*b
) {
170 assert(!b
->track_queue
);
173 b
->state
= BUS_CLOSED
;
175 sd_bus_detach_event(b
);
177 while ((s
= b
->slots
)) {
178 /* At this point only floating slots can still be
179 * around, because the non-floating ones keep a
180 * reference to the bus, and we thus couldn't be
181 * destructing right now... We forcibly disconnect the
182 * slots here, so that they still can be referenced by
183 * apps, but are dead. */
186 bus_slot_disconnect(s
);
187 sd_bus_slot_unref(s
);
190 if (b
->default_bus_ptr
)
191 *b
->default_bus_ptr
= NULL
;
194 bus_close_inotify_fd(b
);
199 free(b
->unique_name
);
200 free(b
->auth_buffer
);
203 free(b
->cgroup_root
);
204 free(b
->description
);
205 free(b
->patch_sender
);
208 strv_free(b
->exec_argv
);
210 close_many(b
->fds
, b
->n_fds
);
215 ordered_hashmap_free_free(b
->reply_callbacks
);
216 prioq_free(b
->reply_callbacks_prioq
);
218 assert(b
->match_callbacks
.type
== BUS_MATCH_ROOT
);
219 bus_match_free(&b
->match_callbacks
);
221 hashmap_free_free(b
->vtable_methods
);
222 hashmap_free_free(b
->vtable_properties
);
224 assert(hashmap_isempty(b
->nodes
));
225 hashmap_free(b
->nodes
);
229 assert_se(pthread_mutex_destroy(&b
->memfd_cache_mutex
) == 0);
234 DEFINE_TRIVIAL_CLEANUP_FUNC(sd_bus
*, bus_free
);
236 _public_
int sd_bus_new(sd_bus
**ret
) {
237 _cleanup_free_ sd_bus
*b
= NULL
;
239 assert_return(ret
, -EINVAL
);
245 b
->n_ref
= REFCNT_INIT
;
246 b
->input_fd
= b
->output_fd
= -1;
248 b
->message_version
= 1;
249 b
->creds_mask
|= SD_BUS_CREDS_WELL_KNOWN_NAMES
|SD_BUS_CREDS_UNIQUE_NAME
;
251 b
->original_pid
= getpid_cached();
252 b
->n_groups
= (size_t) -1;
254 assert_se(pthread_mutex_init(&b
->memfd_cache_mutex
, NULL
) == 0);
256 /* We guarantee that wqueue always has space for at least one entry */
257 if (!GREEDY_REALLOC(b
->wqueue
, b
->wqueue_allocated
, 1))
264 _public_
int sd_bus_set_address(sd_bus
*bus
, const char *address
) {
267 assert_return(bus
, -EINVAL
);
268 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
269 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
270 assert_return(address
, -EINVAL
);
271 assert_return(!bus_pid_changed(bus
), -ECHILD
);
277 return free_and_replace(bus
->address
, a
);
280 _public_
int sd_bus_set_fd(sd_bus
*bus
, int input_fd
, int output_fd
) {
281 assert_return(bus
, -EINVAL
);
282 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
283 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
284 assert_return(input_fd
>= 0, -EBADF
);
285 assert_return(output_fd
>= 0, -EBADF
);
286 assert_return(!bus_pid_changed(bus
), -ECHILD
);
288 bus
->input_fd
= input_fd
;
289 bus
->output_fd
= output_fd
;
293 _public_
int sd_bus_set_exec(sd_bus
*bus
, const char *path
, char *const argv
[]) {
294 _cleanup_free_
char *p
= NULL
;
297 assert_return(bus
, -EINVAL
);
298 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
299 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
300 assert_return(path
, -EINVAL
);
301 assert_return(!strv_isempty(argv
), -EINVAL
);
302 assert_return(!bus_pid_changed(bus
), -ECHILD
);
312 free_and_replace(bus
->exec_path
, p
);
313 strv_free_and_replace(bus
->exec_argv
, a
);
317 _public_
int sd_bus_set_bus_client(sd_bus
*bus
, int b
) {
318 assert_return(bus
, -EINVAL
);
319 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
320 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
321 assert_return(!bus
->patch_sender
, -EPERM
);
322 assert_return(!bus_pid_changed(bus
), -ECHILD
);
324 bus
->bus_client
= !!b
;
328 _public_
int sd_bus_set_monitor(sd_bus
*bus
, int b
) {
329 assert_return(bus
, -EINVAL
);
330 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
331 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
332 assert_return(!bus_pid_changed(bus
), -ECHILD
);
334 bus
->is_monitor
= !!b
;
338 _public_
int sd_bus_negotiate_fds(sd_bus
*bus
, int b
) {
339 assert_return(bus
, -EINVAL
);
340 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
341 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
342 assert_return(!bus_pid_changed(bus
), -ECHILD
);
344 bus
->accept_fd
= !!b
;
348 _public_
int sd_bus_negotiate_timestamp(sd_bus
*bus
, int b
) {
349 assert_return(bus
, -EINVAL
);
350 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
351 assert_return(!IN_SET(bus
->state
, BUS_CLOSING
, BUS_CLOSED
), -EPERM
);
352 assert_return(!bus_pid_changed(bus
), -ECHILD
);
354 /* This is not actually supported by any of our transports these days, but we do honour it for synthetic
355 * replies, and maybe one day classic D-Bus learns this too */
356 bus
->attach_timestamp
= !!b
;
361 _public_
int sd_bus_negotiate_creds(sd_bus
*bus
, int b
, uint64_t mask
) {
362 assert_return(bus
, -EINVAL
);
363 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
364 assert_return(mask
<= _SD_BUS_CREDS_ALL
, -EINVAL
);
365 assert_return(!IN_SET(bus
->state
, BUS_CLOSING
, BUS_CLOSED
), -EPERM
);
366 assert_return(!bus_pid_changed(bus
), -ECHILD
);
368 SET_FLAG(bus
->creds_mask
, mask
, b
);
370 /* The well knowns we need unconditionally, so that matches can work */
371 bus
->creds_mask
|= SD_BUS_CREDS_WELL_KNOWN_NAMES
|SD_BUS_CREDS_UNIQUE_NAME
;
376 _public_
int sd_bus_set_server(sd_bus
*bus
, int b
, sd_id128_t server_id
) {
377 assert_return(bus
, -EINVAL
);
378 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
379 assert_return(b
|| sd_id128_equal(server_id
, SD_ID128_NULL
), -EINVAL
);
380 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
381 assert_return(!bus_pid_changed(bus
), -ECHILD
);
383 bus
->is_server
= !!b
;
384 bus
->server_id
= server_id
;
388 _public_
int sd_bus_set_anonymous(sd_bus
*bus
, int b
) {
389 assert_return(bus
, -EINVAL
);
390 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
391 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
392 assert_return(!bus_pid_changed(bus
), -ECHILD
);
394 bus
->anonymous_auth
= !!b
;
398 _public_
int sd_bus_set_trusted(sd_bus
*bus
, int b
) {
399 assert_return(bus
, -EINVAL
);
400 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
401 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
402 assert_return(!bus_pid_changed(bus
), -ECHILD
);
408 _public_
int sd_bus_set_description(sd_bus
*bus
, const char *description
) {
409 assert_return(bus
, -EINVAL
);
410 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
411 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
412 assert_return(!bus_pid_changed(bus
), -ECHILD
);
414 return free_and_strdup(&bus
->description
, description
);
417 _public_
int sd_bus_set_allow_interactive_authorization(sd_bus
*bus
, int b
) {
418 assert_return(bus
, -EINVAL
);
419 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
420 assert_return(!bus_pid_changed(bus
), -ECHILD
);
422 bus
->allow_interactive_authorization
= !!b
;
426 _public_
int sd_bus_get_allow_interactive_authorization(sd_bus
*bus
) {
427 assert_return(bus
, -EINVAL
);
428 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
429 assert_return(!bus_pid_changed(bus
), -ECHILD
);
431 return bus
->allow_interactive_authorization
;
434 _public_
int sd_bus_set_watch_bind(sd_bus
*bus
, int b
) {
435 assert_return(bus
, -EINVAL
);
436 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
437 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
438 assert_return(!bus_pid_changed(bus
), -ECHILD
);
440 bus
->watch_bind
= !!b
;
444 _public_
int sd_bus_get_watch_bind(sd_bus
*bus
) {
445 assert_return(bus
, -EINVAL
);
446 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
447 assert_return(!bus_pid_changed(bus
), -ECHILD
);
449 return bus
->watch_bind
;
452 _public_
int sd_bus_set_connected_signal(sd_bus
*bus
, int b
) {
453 assert_return(bus
, -EINVAL
);
454 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
455 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
456 assert_return(!bus_pid_changed(bus
), -ECHILD
);
458 bus
->connected_signal
= !!b
;
462 _public_
int sd_bus_get_connected_signal(sd_bus
*bus
) {
463 assert_return(bus
, -EINVAL
);
464 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
465 assert_return(!bus_pid_changed(bus
), -ECHILD
);
467 return bus
->connected_signal
;
470 static int synthesize_connected_signal(sd_bus
*bus
) {
471 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
476 /* If enabled, synthesizes a local "Connected" signal mirroring the local "Disconnected" signal. This is called
477 * whenever we fully established a connection, i.e. after the authorization phase, and after receiving the
478 * Hello() reply. Or in other words, whenver we enter BUS_RUNNING state.
480 * This is useful so that clients can start doing stuff whenver the connection is fully established in a way
481 * that works independently from whether we connected to a full bus or just a direct connection. */
483 if (!bus
->connected_signal
)
486 r
= sd_bus_message_new_signal(
489 "/org/freedesktop/DBus/Local",
490 "org.freedesktop.DBus.Local",
495 bus_message_set_sender_local(bus
, m
);
497 r
= bus_seal_synthetic_message(bus
, m
);
501 r
= bus_rqueue_make_room(bus
);
505 /* Insert at the very front */
506 memmove(bus
->rqueue
+ 1, bus
->rqueue
, sizeof(sd_bus_message
*) * bus
->rqueue_size
);
507 bus
->rqueue
[0] = TAKE_PTR(m
);
513 void bus_set_state(sd_bus
*bus
, enum bus_state state
) {
515 static const char * const table
[_BUS_STATE_MAX
] = {
516 [BUS_UNSET
] = "UNSET",
517 [BUS_WATCH_BIND
] = "WATCH_BIND",
518 [BUS_OPENING
] = "OPENING",
519 [BUS_AUTHENTICATING
] = "AUTHENTICATING",
520 [BUS_HELLO
] = "HELLO",
521 [BUS_RUNNING
] = "RUNNING",
522 [BUS_CLOSING
] = "CLOSING",
523 [BUS_CLOSED
] = "CLOSED",
527 assert(state
< _BUS_STATE_MAX
);
529 if (state
== bus
->state
)
532 log_debug("Bus %s: changing state %s → %s", strna(bus
->description
), table
[bus
->state
], table
[state
]);
536 static int hello_callback(sd_bus_message
*reply
, void *userdata
, sd_bus_error
*error
) {
545 assert(IN_SET(bus
->state
, BUS_HELLO
, BUS_CLOSING
));
547 r
= sd_bus_message_get_errno(reply
);
551 r
= sd_bus_message_read(reply
, "s", &s
);
555 if (!service_name_is_valid(s
) || s
[0] != ':')
562 free_and_replace(bus
->unique_name
, t
);
564 if (bus
->state
== BUS_HELLO
) {
565 bus_set_state(bus
, BUS_RUNNING
);
567 r
= synthesize_connected_signal(bus
);
575 static int bus_send_hello(sd_bus
*bus
) {
576 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
581 if (!bus
->bus_client
)
584 r
= sd_bus_message_new_method_call(
587 "org.freedesktop.DBus",
588 "/org/freedesktop/DBus",
589 "org.freedesktop.DBus",
594 return sd_bus_call_async(bus
, NULL
, m
, hello_callback
, NULL
, 0);
597 int bus_start_running(sd_bus
*bus
) {
598 struct reply_callback
*c
;
604 assert(bus
->state
< BUS_HELLO
);
606 /* We start all method call timeouts when we enter BUS_HELLO or BUS_RUNNING mode. At this point let's convert
607 * all relative to absolute timestamps. Note that we do not reshuffle the reply callback priority queue since
608 * adding a fixed value to all entries should not alter the internal order. */
610 n
= now(CLOCK_MONOTONIC
);
611 ORDERED_HASHMAP_FOREACH(c
, bus
->reply_callbacks
, i
) {
612 if (c
->timeout_usec
== 0)
615 c
->timeout_usec
= usec_add(n
, c
->timeout_usec
);
618 if (bus
->bus_client
) {
619 bus_set_state(bus
, BUS_HELLO
);
623 bus_set_state(bus
, BUS_RUNNING
);
625 r
= synthesize_connected_signal(bus
);
632 static int parse_address_key(const char **p
, const char *key
, char **value
) {
633 size_t l
, n
= 0, allocated
= 0;
634 _cleanup_free_
char *r
= NULL
;
643 if (strncmp(*p
, key
, l
) != 0)
656 while (!IN_SET(*a
, ';', ',', 0)) {
670 c
= (char) ((x
<< 4) | y
);
677 if (!GREEDY_REALLOC(r
, allocated
, n
+ 2))
695 free_and_replace(*value
, r
);
700 static void skip_address_key(const char **p
) {
704 *p
+= strcspn(*p
, ",");
710 static int parse_unix_address(sd_bus
*b
, const char **p
, char **guid
) {
711 _cleanup_free_
char *path
= NULL
, *abstract
= NULL
;
720 while (!IN_SET(**p
, 0, ';')) {
721 r
= parse_address_key(p
, "guid", guid
);
727 r
= parse_address_key(p
, "path", &path
);
733 r
= parse_address_key(p
, "abstract", &abstract
);
742 if (!path
&& !abstract
)
745 if (path
&& abstract
)
750 if (l
> sizeof(b
->sockaddr
.un
.sun_path
))
753 b
->sockaddr
.un
.sun_family
= AF_UNIX
;
754 strncpy(b
->sockaddr
.un
.sun_path
, path
, sizeof(b
->sockaddr
.un
.sun_path
));
755 b
->sockaddr_size
= offsetof(struct sockaddr_un
, sun_path
) + l
;
756 } else if (abstract
) {
757 l
= strlen(abstract
);
758 if (l
> sizeof(b
->sockaddr
.un
.sun_path
) - 1)
761 b
->sockaddr
.un
.sun_family
= AF_UNIX
;
762 b
->sockaddr
.un
.sun_path
[0] = 0;
763 strncpy(b
->sockaddr
.un
.sun_path
+1, abstract
, sizeof(b
->sockaddr
.un
.sun_path
)-1);
764 b
->sockaddr_size
= offsetof(struct sockaddr_un
, sun_path
) + 1 + l
;
772 static int parse_tcp_address(sd_bus
*b
, const char **p
, char **guid
) {
773 _cleanup_free_
char *host
= NULL
, *port
= NULL
, *family
= NULL
;
775 struct addrinfo
*result
, hints
= {
776 .ai_socktype
= SOCK_STREAM
,
777 .ai_flags
= AI_ADDRCONFIG
,
785 while (!IN_SET(**p
, 0, ';')) {
786 r
= parse_address_key(p
, "guid", guid
);
792 r
= parse_address_key(p
, "host", &host
);
798 r
= parse_address_key(p
, "port", &port
);
804 r
= parse_address_key(p
, "family", &family
);
817 if (streq(family
, "ipv4"))
818 hints
.ai_family
= AF_INET
;
819 else if (streq(family
, "ipv6"))
820 hints
.ai_family
= AF_INET6
;
825 r
= getaddrinfo(host
, port
, &hints
, &result
);
829 return -EADDRNOTAVAIL
;
831 memcpy(&b
->sockaddr
, result
->ai_addr
, result
->ai_addrlen
);
832 b
->sockaddr_size
= result
->ai_addrlen
;
834 freeaddrinfo(result
);
841 static int parse_exec_address(sd_bus
*b
, const char **p
, char **guid
) {
843 unsigned n_argv
= 0, j
;
845 size_t allocated
= 0;
853 while (!IN_SET(**p
, 0, ';')) {
854 r
= parse_address_key(p
, "guid", guid
);
860 r
= parse_address_key(p
, "path", &path
);
866 if (startswith(*p
, "argv")) {
870 ul
= strtoul(*p
+ 4, (char**) p
, 10);
871 if (errno
> 0 || **p
!= '=' || ul
> 256) {
879 if (!GREEDY_REALLOC0(argv
, allocated
, ul
+ 2)) {
887 r
= parse_address_key(p
, NULL
, argv
+ ul
);
902 /* Make sure there are no holes in the array, with the
903 * exception of argv[0] */
904 for (j
= 1; j
< n_argv
; j
++)
910 if (argv
&& argv
[0] == NULL
) {
911 argv
[0] = strdup(path
);
926 for (j
= 0; j
< n_argv
; j
++)
934 static int parse_container_unix_address(sd_bus
*b
, const char **p
, char **guid
) {
935 _cleanup_free_
char *machine
= NULL
, *pid
= NULL
;
943 while (!IN_SET(**p
, 0, ';')) {
944 r
= parse_address_key(p
, "guid", guid
);
950 r
= parse_address_key(p
, "machine", &machine
);
956 r
= parse_address_key(p
, "pid", &pid
);
965 if (!machine
== !pid
)
969 if (!machine_name_is_valid(machine
))
972 free_and_replace(b
->machine
, machine
);
974 b
->machine
= mfree(b
->machine
);
978 r
= parse_pid(pid
, &b
->nspid
);
984 b
->sockaddr
.un
.sun_family
= AF_UNIX
;
985 /* Note that we use the old /var/run prefix here, to increase compatibility with really old containers */
986 strncpy(b
->sockaddr
.un
.sun_path
, "/var/run/dbus/system_bus_socket", sizeof(b
->sockaddr
.un
.sun_path
));
987 b
->sockaddr_size
= SOCKADDR_UN_LEN(b
->sockaddr
.un
);
993 static void bus_reset_parsed_address(sd_bus
*b
) {
997 b
->sockaddr_size
= 0;
998 b
->exec_argv
= strv_free(b
->exec_argv
);
999 b
->exec_path
= mfree(b
->exec_path
);
1000 b
->server_id
= SD_ID128_NULL
;
1001 b
->machine
= mfree(b
->machine
);
1005 static int bus_parse_next_address(sd_bus
*b
) {
1006 _cleanup_free_
char *guid
= NULL
;
1014 if (b
->address
[b
->address_index
] == 0)
1017 bus_reset_parsed_address(b
);
1019 a
= b
->address
+ b
->address_index
;
1028 if (startswith(a
, "unix:")) {
1031 r
= parse_unix_address(b
, &a
, &guid
);
1036 } else if (startswith(a
, "tcp:")) {
1039 r
= parse_tcp_address(b
, &a
, &guid
);
1045 } else if (startswith(a
, "unixexec:")) {
1048 r
= parse_exec_address(b
, &a
, &guid
);
1054 } else if (startswith(a
, "x-machine-unix:")) {
1057 r
= parse_container_unix_address(b
, &a
, &guid
);
1070 r
= sd_id128_from_string(guid
, &b
->server_id
);
1075 b
->address_index
= a
- b
->address
;
1079 static void bus_kill_exec(sd_bus
*bus
) {
1080 if (pid_is_valid(bus
->busexec_pid
) > 0) {
1081 sigterm_wait(bus
->busexec_pid
);
1082 bus
->busexec_pid
= 0;
1086 static int bus_start_address(sd_bus
*b
) {
1092 bus_close_io_fds(b
);
1093 bus_close_inotify_fd(b
);
1097 /* If you provide multiple different bus-addresses, we
1098 * try all of them in order and use the first one that
1102 r
= bus_socket_exec(b
);
1103 else if ((b
->nspid
> 0 || b
->machine
) && b
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
)
1104 r
= bus_container_connect_socket(b
);
1105 else if (b
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
)
1106 r
= bus_socket_connect(b
);
1113 q
= bus_attach_io_events(b
);
1117 q
= bus_attach_inotify_event(b
);
1124 b
->last_connect_error
= -r
;
1127 r
= bus_parse_next_address(b
);
1131 return b
->last_connect_error
> 0 ? -b
->last_connect_error
: -ECONNREFUSED
;
1135 int bus_next_address(sd_bus
*b
) {
1138 bus_reset_parsed_address(b
);
1139 return bus_start_address(b
);
1142 static int bus_start_fd(sd_bus
*b
) {
1147 assert(b
->input_fd
>= 0);
1148 assert(b
->output_fd
>= 0);
1150 r
= fd_nonblock(b
->input_fd
, true);
1154 r
= fd_cloexec(b
->input_fd
, true);
1158 if (b
->input_fd
!= b
->output_fd
) {
1159 r
= fd_nonblock(b
->output_fd
, true);
1163 r
= fd_cloexec(b
->output_fd
, true);
1168 if (fstat(b
->input_fd
, &st
) < 0)
1171 return bus_socket_take_fd(b
);
1174 _public_
int sd_bus_start(sd_bus
*bus
) {
1177 assert_return(bus
, -EINVAL
);
1178 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
1179 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
1180 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1182 bus_set_state(bus
, BUS_OPENING
);
1184 if (bus
->is_server
&& bus
->bus_client
)
1187 if (bus
->input_fd
>= 0)
1188 r
= bus_start_fd(bus
);
1189 else if (bus
->address
|| bus
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
|| bus
->exec_path
|| bus
->machine
)
1190 r
= bus_start_address(bus
);
1199 return bus_send_hello(bus
);
1202 _public_
int sd_bus_open_with_description(sd_bus
**ret
, const char *description
) {
1204 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1207 assert_return(ret
, -EINVAL
);
1209 /* Let's connect to the starter bus if it is set, and
1210 * otherwise to the bus that is appropropriate for the scope
1211 * we are running in */
1213 e
= secure_getenv("DBUS_STARTER_BUS_TYPE");
1215 if (streq(e
, "system"))
1216 return sd_bus_open_system_with_description(ret
, description
);
1217 else if (STR_IN_SET(e
, "session", "user"))
1218 return sd_bus_open_user_with_description(ret
, description
);
1221 e
= secure_getenv("DBUS_STARTER_ADDRESS");
1223 if (cg_pid_get_owner_uid(0, NULL
) >= 0)
1224 return sd_bus_open_user_with_description(ret
, description
);
1226 return sd_bus_open_system_with_description(ret
, description
);
1233 r
= sd_bus_set_address(b
, e
);
1237 b
->bus_client
= true;
1239 /* We don't know whether the bus is trusted or not, so better
1240 * be safe, and authenticate everything */
1242 b
->is_local
= false;
1243 b
->creds_mask
|= SD_BUS_CREDS_UID
| SD_BUS_CREDS_EUID
| SD_BUS_CREDS_EFFECTIVE_CAPS
;
1245 r
= sd_bus_start(b
);
1253 _public_
int sd_bus_open(sd_bus
**ret
) {
1254 return sd_bus_open_with_description(ret
, NULL
);
1257 int bus_set_address_system(sd_bus
*b
) {
1261 e
= secure_getenv("DBUS_SYSTEM_BUS_ADDRESS");
1263 return sd_bus_set_address(b
, e
);
1265 return sd_bus_set_address(b
, DEFAULT_SYSTEM_BUS_ADDRESS
);
1268 _public_
int sd_bus_open_system_with_description(sd_bus
**ret
, const char *description
) {
1269 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1272 assert_return(ret
, -EINVAL
);
1279 r
= sd_bus_set_description(b
, description
);
1284 r
= bus_set_address_system(b
);
1288 b
->bus_client
= true;
1289 b
->is_system
= true;
1291 /* Let's do per-method access control on the system bus. We
1292 * need the caller's UID and capability set for that. */
1294 b
->creds_mask
|= SD_BUS_CREDS_UID
| SD_BUS_CREDS_EUID
| SD_BUS_CREDS_EFFECTIVE_CAPS
;
1297 r
= sd_bus_start(b
);
1305 _public_
int sd_bus_open_system(sd_bus
**ret
) {
1306 return sd_bus_open_system_with_description(ret
, NULL
);
1309 int bus_set_address_user(sd_bus
*b
) {
1311 _cleanup_free_
char *ee
= NULL
, *s
= NULL
;
1315 e
= secure_getenv("DBUS_SESSION_BUS_ADDRESS");
1317 return sd_bus_set_address(b
, e
);
1319 e
= secure_getenv("XDG_RUNTIME_DIR");
1323 ee
= bus_address_escape(e
);
1327 if (asprintf(&s
, DEFAULT_USER_BUS_ADDRESS_FMT
, ee
) < 0)
1330 b
->address
= TAKE_PTR(s
);
1335 _public_
int sd_bus_open_user_with_description(sd_bus
**ret
, const char *description
) {
1336 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1339 assert_return(ret
, -EINVAL
);
1346 r
= sd_bus_set_description(b
, description
);
1351 r
= bus_set_address_user(b
);
1355 b
->bus_client
= true;
1358 /* We don't do any per-method access control on the user
1363 r
= sd_bus_start(b
);
1371 _public_
int sd_bus_open_user(sd_bus
**ret
) {
1372 return sd_bus_open_user_with_description(ret
, NULL
);
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=systemd-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
,
3248 r
= bus_add_match_internal(bus
, s
->match_callback
.match_string
);
3252 s
->match_added
= true;
3256 bus
->match_callbacks_modified
= true;
3257 r
= bus_match_add(&bus
->match_callbacks
, components
, n_components
, &s
->match_callback
);
3266 bus_match_parse_free(components
, n_components
);
3267 sd_bus_slot_unref(s
);
3272 _public_
int sd_bus_add_match(
3276 sd_bus_message_handler_t callback
,
3279 return bus_add_match_full(bus
, slot
, false, match
, callback
, NULL
, userdata
);
3282 _public_
int sd_bus_add_match_async(
3286 sd_bus_message_handler_t callback
,
3287 sd_bus_message_handler_t install_callback
,
3290 return bus_add_match_full(bus
, slot
, true, match
, callback
, install_callback
, userdata
);
3293 bool bus_pid_changed(sd_bus
*bus
) {
3296 /* We don't support people creating a bus connection and
3297 * keeping it around over a fork(). Let's complain. */
3299 return bus
->original_pid
!= getpid_cached();
3302 static int io_callback(sd_event_source
*s
, int fd
, uint32_t revents
, void *userdata
) {
3303 sd_bus
*bus
= userdata
;
3308 /* Note that this is called both on input_fd, output_fd as well as inotify_fd events */
3310 r
= sd_bus_process(bus
, NULL
);
3312 log_debug_errno(r
, "Processing of bus failed, closing down: %m");
3313 bus_enter_closing(bus
);
3319 static int time_callback(sd_event_source
*s
, uint64_t usec
, void *userdata
) {
3320 sd_bus
*bus
= userdata
;
3325 r
= sd_bus_process(bus
, NULL
);
3327 log_debug_errno(r
, "Processing of bus failed, closing down: %m");
3328 bus_enter_closing(bus
);
3334 static int prepare_callback(sd_event_source
*s
, void *userdata
) {
3335 sd_bus
*bus
= userdata
;
3342 e
= sd_bus_get_events(bus
);
3348 if (bus
->output_fd
!= bus
->input_fd
) {
3350 r
= sd_event_source_set_io_events(bus
->input_io_event_source
, e
& POLLIN
);
3354 r
= sd_event_source_set_io_events(bus
->output_io_event_source
, e
& POLLOUT
);
3356 r
= sd_event_source_set_io_events(bus
->input_io_event_source
, e
);
3360 r
= sd_bus_get_timeout(bus
, &until
);
3366 j
= sd_event_source_set_time(bus
->time_event_source
, until
);
3373 r
= sd_event_source_set_enabled(bus
->time_event_source
, r
> 0);
3380 log_debug_errno(r
, "Preparing of bus events failed, closing down: %m");
3381 bus_enter_closing(bus
);
3386 static int quit_callback(sd_event_source
*event
, void *userdata
) {
3387 sd_bus
*bus
= userdata
;
3397 int bus_attach_io_events(sd_bus
*bus
) {
3402 if (bus
->input_fd
< 0)
3408 if (!bus
->input_io_event_source
) {
3409 r
= sd_event_add_io(bus
->event
, &bus
->input_io_event_source
, bus
->input_fd
, 0, io_callback
, bus
);
3413 r
= sd_event_source_set_prepare(bus
->input_io_event_source
, prepare_callback
);
3417 r
= sd_event_source_set_priority(bus
->input_io_event_source
, bus
->event_priority
);
3421 r
= sd_event_source_set_description(bus
->input_io_event_source
, "bus-input");
3423 r
= sd_event_source_set_io_fd(bus
->input_io_event_source
, bus
->input_fd
);
3428 if (bus
->output_fd
!= bus
->input_fd
) {
3429 assert(bus
->output_fd
>= 0);
3431 if (!bus
->output_io_event_source
) {
3432 r
= sd_event_add_io(bus
->event
, &bus
->output_io_event_source
, bus
->output_fd
, 0, io_callback
, bus
);
3436 r
= sd_event_source_set_priority(bus
->output_io_event_source
, bus
->event_priority
);
3440 r
= sd_event_source_set_description(bus
->input_io_event_source
, "bus-output");
3442 r
= sd_event_source_set_io_fd(bus
->output_io_event_source
, bus
->output_fd
);
3451 static void bus_detach_io_events(sd_bus
*bus
) {
3454 if (bus
->input_io_event_source
) {
3455 sd_event_source_set_enabled(bus
->input_io_event_source
, SD_EVENT_OFF
);
3456 bus
->input_io_event_source
= sd_event_source_unref(bus
->input_io_event_source
);
3459 if (bus
->output_io_event_source
) {
3460 sd_event_source_set_enabled(bus
->output_io_event_source
, SD_EVENT_OFF
);
3461 bus
->output_io_event_source
= sd_event_source_unref(bus
->output_io_event_source
);
3465 int bus_attach_inotify_event(sd_bus
*bus
) {
3470 if (bus
->inotify_fd
< 0)
3476 if (!bus
->inotify_event_source
) {
3477 r
= sd_event_add_io(bus
->event
, &bus
->inotify_event_source
, bus
->inotify_fd
, EPOLLIN
, io_callback
, bus
);
3481 r
= sd_event_source_set_priority(bus
->inotify_event_source
, bus
->event_priority
);
3485 r
= sd_event_source_set_description(bus
->inotify_event_source
, "bus-inotify");
3487 r
= sd_event_source_set_io_fd(bus
->inotify_event_source
, bus
->inotify_fd
);
3494 static void bus_detach_inotify_event(sd_bus
*bus
) {
3497 if (bus
->inotify_event_source
) {
3498 sd_event_source_set_enabled(bus
->inotify_event_source
, SD_EVENT_OFF
);
3499 bus
->inotify_event_source
= sd_event_source_unref(bus
->inotify_event_source
);
3503 _public_
int sd_bus_attach_event(sd_bus
*bus
, sd_event
*event
, int priority
) {
3506 assert_return(bus
, -EINVAL
);
3507 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3508 assert_return(!bus
->event
, -EBUSY
);
3510 assert(!bus
->input_io_event_source
);
3511 assert(!bus
->output_io_event_source
);
3512 assert(!bus
->time_event_source
);
3515 bus
->event
= sd_event_ref(event
);
3517 r
= sd_event_default(&bus
->event
);
3522 bus
->event_priority
= priority
;
3524 r
= sd_event_add_time(bus
->event
, &bus
->time_event_source
, CLOCK_MONOTONIC
, 0, 0, time_callback
, bus
);
3528 r
= sd_event_source_set_priority(bus
->time_event_source
, priority
);
3532 r
= sd_event_source_set_description(bus
->time_event_source
, "bus-time");
3536 r
= sd_event_add_exit(bus
->event
, &bus
->quit_event_source
, quit_callback
, bus
);
3540 r
= sd_event_source_set_description(bus
->quit_event_source
, "bus-exit");
3544 r
= bus_attach_io_events(bus
);
3548 r
= bus_attach_inotify_event(bus
);
3555 sd_bus_detach_event(bus
);
3559 _public_
int sd_bus_detach_event(sd_bus
*bus
) {
3560 assert_return(bus
, -EINVAL
);
3561 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3566 bus_detach_io_events(bus
);
3567 bus_detach_inotify_event(bus
);
3569 if (bus
->time_event_source
) {
3570 sd_event_source_set_enabled(bus
->time_event_source
, SD_EVENT_OFF
);
3571 bus
->time_event_source
= sd_event_source_unref(bus
->time_event_source
);
3574 if (bus
->quit_event_source
) {
3575 sd_event_source_set_enabled(bus
->quit_event_source
, SD_EVENT_OFF
);
3576 bus
->quit_event_source
= sd_event_source_unref(bus
->quit_event_source
);
3579 bus
->event
= sd_event_unref(bus
->event
);
3583 _public_ sd_event
* sd_bus_get_event(sd_bus
*bus
) {
3584 assert_return(bus
, NULL
);
3589 _public_ sd_bus_message
* sd_bus_get_current_message(sd_bus
*bus
) {
3590 assert_return(bus
, NULL
);
3592 return bus
->current_message
;
3595 _public_ sd_bus_slot
* sd_bus_get_current_slot(sd_bus
*bus
) {
3596 assert_return(bus
, NULL
);
3598 return bus
->current_slot
;
3601 _public_ sd_bus_message_handler_t
sd_bus_get_current_handler(sd_bus
*bus
) {
3602 assert_return(bus
, NULL
);
3604 return bus
->current_handler
;
3607 _public_
void* sd_bus_get_current_userdata(sd_bus
*bus
) {
3608 assert_return(bus
, NULL
);
3610 return bus
->current_userdata
;
3613 static int bus_default(int (*bus_open
)(sd_bus
**), sd_bus
**default_bus
, sd_bus
**ret
) {
3618 assert(default_bus
);
3621 return !!*default_bus
;
3624 *ret
= sd_bus_ref(*default_bus
);
3632 b
->default_bus_ptr
= default_bus
;
3640 _public_
int sd_bus_default_system(sd_bus
**ret
) {
3641 return bus_default(sd_bus_open_system
, &default_system_bus
, ret
);
3644 _public_
int sd_bus_default_user(sd_bus
**ret
) {
3645 return bus_default(sd_bus_open_user
, &default_user_bus
, ret
);
3648 _public_
int sd_bus_default(sd_bus
**ret
) {
3649 int (*bus_open
)(sd_bus
**) = NULL
;
3652 busp
= bus_choose_default(&bus_open
);
3653 return bus_default(bus_open
, busp
, ret
);
3656 _public_
int sd_bus_get_tid(sd_bus
*b
, pid_t
*tid
) {
3657 assert_return(b
, -EINVAL
);
3658 assert_return(tid
, -EINVAL
);
3659 assert_return(!bus_pid_changed(b
), -ECHILD
);
3667 return sd_event_get_tid(b
->event
, tid
);
3672 _public_
int sd_bus_path_encode(const char *prefix
, const char *external_id
, char **ret_path
) {
3673 _cleanup_free_
char *e
= NULL
;
3676 assert_return(object_path_is_valid(prefix
), -EINVAL
);
3677 assert_return(external_id
, -EINVAL
);
3678 assert_return(ret_path
, -EINVAL
);
3680 e
= bus_label_escape(external_id
);
3684 ret
= strjoin(prefix
, "/", e
);
3692 _public_
int sd_bus_path_decode(const char *path
, const char *prefix
, char **external_id
) {
3696 assert_return(object_path_is_valid(path
), -EINVAL
);
3697 assert_return(object_path_is_valid(prefix
), -EINVAL
);
3698 assert_return(external_id
, -EINVAL
);
3700 e
= object_path_startswith(path
, prefix
);
3702 *external_id
= NULL
;
3706 ret
= bus_label_unescape(e
);
3714 _public_
int sd_bus_path_encode_many(char **out
, const char *path_template
, ...) {
3715 _cleanup_strv_free_
char **labels
= NULL
;
3716 char *path
, *path_pos
, **label_pos
;
3717 const char *sep
, *template_pos
;
3722 assert_return(out
, -EINVAL
);
3723 assert_return(path_template
, -EINVAL
);
3725 path_length
= strlen(path_template
);
3727 va_start(list
, path_template
);
3728 for (sep
= strchr(path_template
, '%'); sep
; sep
= strchr(sep
+ 1, '%')) {
3732 arg
= va_arg(list
, const char *);
3738 label
= bus_label_escape(arg
);
3744 r
= strv_consume(&labels
, label
);
3750 /* add label length, but account for the format character */
3751 path_length
+= strlen(label
) - 1;
3755 path
= malloc(path_length
+ 1);
3762 for (template_pos
= path_template
; *template_pos
; ) {
3763 sep
= strchrnul(template_pos
, '%');
3764 path_pos
= mempcpy(path_pos
, template_pos
, sep
- template_pos
);
3768 path_pos
= stpcpy(path_pos
, *label_pos
++);
3769 template_pos
= sep
+ 1;
3777 _public_
int sd_bus_path_decode_many(const char *path
, const char *path_template
, ...) {
3778 _cleanup_strv_free_
char **labels
= NULL
;
3779 const char *template_pos
, *path_pos
;
3785 * This decodes an object-path based on a template argument. The
3786 * template consists of a verbatim path, optionally including special
3789 * - Each occurrence of '%' in the template matches an arbitrary
3790 * substring of a label in the given path. At most one such
3791 * directive is allowed per label. For each such directive, the
3792 * caller must provide an output parameter (char **) via va_arg. If
3793 * NULL is passed, the given label is verified, but not returned.
3794 * For each matched label, the *decoded* label is stored in the
3795 * passed output argument, and the caller is responsible to free
3796 * it. Note that the output arguments are only modified if the
3797 * actualy path matched the template. Otherwise, they're left
3800 * This function returns <0 on error, 0 if the path does not match the
3801 * template, 1 if it matched.
3804 assert_return(path
, -EINVAL
);
3805 assert_return(path_template
, -EINVAL
);
3809 for (template_pos
= path_template
; *template_pos
; ) {
3814 /* verify everything until the next '%' matches verbatim */
3815 sep
= strchrnul(template_pos
, '%');
3816 length
= sep
- template_pos
;
3817 if (strncmp(path_pos
, template_pos
, length
))
3821 template_pos
+= length
;
3826 /* We found the next '%' character. Everything up until here
3827 * matched. We now skip ahead to the end of this label and make
3828 * sure it matches the tail of the label in the path. Then we
3829 * decode the string in-between and save it for later use. */
3831 ++template_pos
; /* skip over '%' */
3833 sep
= strchrnul(template_pos
, '/');
3834 length
= sep
- template_pos
; /* length of suffix to match verbatim */
3836 /* verify the suffixes match */
3837 sep
= strchrnul(path_pos
, '/');
3838 if (sep
- path_pos
< (ssize_t
)length
||
3839 strncmp(sep
- length
, template_pos
, length
))
3842 template_pos
+= length
; /* skip over matched label */
3843 length
= sep
- path_pos
- length
; /* length of sub-label to decode */
3845 /* store unescaped label for later use */
3846 label
= bus_label_unescape_n(path_pos
, length
);
3850 r
= strv_consume(&labels
, label
);
3854 path_pos
= sep
; /* skip decoded label and suffix */
3857 /* end of template must match end of path */
3861 /* copy the labels over to the caller */
3862 va_start(list
, path_template
);
3863 for (label_pos
= labels
; label_pos
&& *label_pos
; ++label_pos
) {
3866 arg
= va_arg(list
, char **);
3874 labels
= mfree(labels
);
3878 _public_
int sd_bus_try_close(sd_bus
*bus
) {
3879 assert_return(bus
, -EINVAL
);
3880 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3881 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3886 _public_
int sd_bus_get_description(sd_bus
*bus
, const char **description
) {
3887 assert_return(bus
, -EINVAL
);
3888 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3889 assert_return(description
, -EINVAL
);
3890 assert_return(bus
->description
, -ENXIO
);
3891 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3893 if (bus
->description
)
3894 *description
= bus
->description
;
3895 else if (bus
->is_system
)
3896 *description
= "system";
3897 else if (bus
->is_user
)
3898 *description
= "user";
3900 *description
= NULL
;
3905 int bus_get_root_path(sd_bus
*bus
) {
3908 if (bus
->cgroup_root
)
3911 r
= cg_get_root_path(&bus
->cgroup_root
);
3913 bus
->cgroup_root
= strdup("/");
3914 if (!bus
->cgroup_root
)
3923 _public_
int sd_bus_get_scope(sd_bus
*bus
, const char **scope
) {
3924 assert_return(bus
, -EINVAL
);
3925 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3926 assert_return(scope
, -EINVAL
);
3927 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3934 if (bus
->is_system
) {
3942 _public_
int sd_bus_get_address(sd_bus
*bus
, const char **address
) {
3944 assert_return(bus
, -EINVAL
);
3945 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3946 assert_return(address
, -EINVAL
);
3947 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3950 *address
= bus
->address
;
3957 _public_
int sd_bus_get_creds_mask(sd_bus
*bus
, uint64_t *mask
) {
3958 assert_return(bus
, -EINVAL
);
3959 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3960 assert_return(mask
, -EINVAL
);
3961 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3963 *mask
= bus
->creds_mask
;
3967 _public_
int sd_bus_is_bus_client(sd_bus
*bus
) {
3968 assert_return(bus
, -EINVAL
);
3969 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3970 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3972 return bus
->bus_client
;
3975 _public_
int sd_bus_is_server(sd_bus
*bus
) {
3976 assert_return(bus
, -EINVAL
);
3977 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3978 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3980 return bus
->is_server
;
3983 _public_
int sd_bus_is_anonymous(sd_bus
*bus
) {
3984 assert_return(bus
, -EINVAL
);
3985 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3986 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3988 return bus
->anonymous_auth
;
3991 _public_
int sd_bus_is_trusted(sd_bus
*bus
) {
3992 assert_return(bus
, -EINVAL
);
3993 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3994 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3996 return bus
->trusted
;
3999 _public_
int sd_bus_is_monitor(sd_bus
*bus
) {
4000 assert_return(bus
, -EINVAL
);
4001 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4002 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4004 return bus
->is_monitor
;
4007 static void flush_close(sd_bus
*bus
) {
4011 /* Flushes and closes the specified bus. We take a ref before,
4012 * to ensure the flushing does not cause the bus to be
4015 sd_bus_flush_close_unref(sd_bus_ref(bus
));
4018 _public_
void sd_bus_default_flush_close(void) {
4019 flush_close(default_starter_bus
);
4020 flush_close(default_user_bus
);
4021 flush_close(default_system_bus
);
4024 _public_
int sd_bus_set_exit_on_disconnect(sd_bus
*bus
, int b
) {
4025 assert_return(bus
, -EINVAL
);
4026 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4028 /* Turns on exit-on-disconnect, and triggers it immediately if the bus connection was already
4029 * disconnected. Note that this is triggered exclusively on disconnections triggered by the server side, never
4030 * from the client side. */
4031 bus
->exit_on_disconnect
= b
;
4033 /* If the exit condition was triggered already, exit immediately. */
4034 return bus_exit_now(bus
);
4037 _public_
int sd_bus_get_exit_on_disconnect(sd_bus
*bus
) {
4038 assert_return(bus
, -EINVAL
);
4039 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4041 return bus
->exit_on_disconnect
;
4044 _public_
int sd_bus_set_sender(sd_bus
*bus
, const char *sender
) {
4045 assert_return(bus
, -EINVAL
);
4046 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4047 assert_return(!bus
->bus_client
, -EPERM
);
4048 assert_return(!sender
|| service_name_is_valid(sender
), -EINVAL
);
4050 return free_and_strdup(&bus
->patch_sender
, sender
);
4053 _public_
int sd_bus_get_sender(sd_bus
*bus
, const char **ret
) {
4054 assert_return(bus
, -EINVAL
);
4055 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4056 assert_return(ret
, -EINVAL
);
4058 if (!bus
->patch_sender
)
4061 *ret
= bus
->patch_sender
;
4065 _public_
int sd_bus_get_n_queued_read(sd_bus
*bus
, uint64_t *ret
) {
4066 assert_return(bus
, -EINVAL
);
4067 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4068 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4069 assert_return(ret
, -EINVAL
);
4071 *ret
= bus
->rqueue_size
;
4075 _public_
int sd_bus_get_n_queued_write(sd_bus
*bus
, uint64_t *ret
) {
4076 assert_return(bus
, -EINVAL
);
4077 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4078 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4079 assert_return(ret
, -EINVAL
);
4081 *ret
= bus
->wqueue_size
;