1 /* SPDX-License-Identifier: LGPL-2.1+ */
15 #include "alloc-util.h"
16 #include "bus-container.h"
17 #include "bus-control.h"
18 #include "bus-internal.h"
19 #include "bus-kernel.h"
20 #include "bus-label.h"
21 #include "bus-message.h"
22 #include "bus-objects.h"
23 #include "bus-protocol.h"
25 #include "bus-socket.h"
26 #include "bus-track.h"
29 #include "cgroup-util.h"
31 #include "errno-util.h"
33 #include "hexdecoct.h"
34 #include "hostname-util.h"
36 #include "memory-util.h"
38 #include "parse-util.h"
39 #include "path-util.h"
40 #include "process-util.h"
41 #include "string-util.h"
44 #define log_debug_bus_message(m) \
46 sd_bus_message *_mm = (m); \
47 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", \
48 bus_message_type_to_string(_mm->header->type), \
49 strna(sd_bus_message_get_sender(_mm)), \
50 strna(sd_bus_message_get_destination(_mm)), \
51 strna(sd_bus_message_get_path(_mm)), \
52 strna(sd_bus_message_get_interface(_mm)), \
53 strna(sd_bus_message_get_member(_mm)), \
54 BUS_MESSAGE_COOKIE(_mm), \
56 strna(_mm->root_container.signature), \
57 strna(_mm->error.name), \
58 strna(_mm->error.message)); \
61 static int bus_poll(sd_bus
*bus
, bool need_more
, uint64_t timeout_usec
);
62 static void bus_detach_io_events(sd_bus
*b
);
63 static void bus_detach_inotify_event(sd_bus
*b
);
65 static thread_local sd_bus
*default_system_bus
= NULL
;
66 static thread_local sd_bus
*default_user_bus
= NULL
;
67 static thread_local sd_bus
*default_starter_bus
= NULL
;
69 static sd_bus
**bus_choose_default(int (**bus_open
)(sd_bus
**)) {
72 /* Let's try our best to reuse another cached connection. If
73 * the starter bus type is set, connect via our normal
74 * connection logic, ignoring $DBUS_STARTER_ADDRESS, so that
75 * we can share the connection with the user/system default
78 e
= secure_getenv("DBUS_STARTER_BUS_TYPE");
80 if (streq(e
, "system")) {
82 *bus_open
= sd_bus_open_system
;
83 return &default_system_bus
;
84 } else if (STR_IN_SET(e
, "user", "session")) {
86 *bus_open
= sd_bus_open_user
;
87 return &default_user_bus
;
91 /* No type is specified, so we have not other option than to
92 * use the starter address if it is set. */
93 e
= secure_getenv("DBUS_STARTER_ADDRESS");
96 *bus_open
= sd_bus_open
;
97 return &default_starter_bus
;
100 /* Finally, if nothing is set use the cached connection for
103 if (cg_pid_get_owner_uid(0, NULL
) >= 0) {
105 *bus_open
= sd_bus_open_user
;
106 return &default_user_bus
;
109 *bus_open
= sd_bus_open_system
;
110 return &default_system_bus
;
114 sd_bus
*bus_resolve(sd_bus
*bus
) {
115 switch ((uintptr_t) bus
) {
116 case (uintptr_t) SD_BUS_DEFAULT
:
117 return *(bus_choose_default(NULL
));
118 case (uintptr_t) SD_BUS_DEFAULT_USER
:
119 return default_user_bus
;
120 case (uintptr_t) SD_BUS_DEFAULT_SYSTEM
:
121 return default_system_bus
;
127 void bus_close_io_fds(sd_bus
*b
) {
130 bus_detach_io_events(b
);
132 if (b
->input_fd
!= b
->output_fd
)
133 safe_close(b
->output_fd
);
134 b
->output_fd
= b
->input_fd
= safe_close(b
->input_fd
);
137 void bus_close_inotify_fd(sd_bus
*b
) {
140 bus_detach_inotify_event(b
);
142 b
->inotify_fd
= safe_close(b
->inotify_fd
);
143 b
->inotify_watches
= mfree(b
->inotify_watches
);
144 b
->n_inotify_watches
= 0;
147 static void bus_reset_queues(sd_bus
*b
) {
150 while (b
->rqueue_size
> 0)
151 bus_message_unref_queued(b
->rqueue
[--b
->rqueue_size
], b
);
153 b
->rqueue
= mfree(b
->rqueue
);
154 b
->rqueue_allocated
= 0;
156 while (b
->wqueue_size
> 0)
157 bus_message_unref_queued(b
->wqueue
[--b
->wqueue_size
], b
);
159 b
->wqueue
= mfree(b
->wqueue
);
160 b
->wqueue_allocated
= 0;
163 static sd_bus
* bus_free(sd_bus
*b
) {
167 assert(!b
->track_queue
);
170 b
->state
= BUS_CLOSED
;
172 sd_bus_detach_event(b
);
174 while ((s
= b
->slots
)) {
175 /* At this point only floating slots can still be
176 * around, because the non-floating ones keep a
177 * reference to the bus, and we thus couldn't be
178 * destructing right now... We forcibly disconnect the
179 * slots here, so that they still can be referenced by
180 * apps, but are dead. */
183 bus_slot_disconnect(s
, true);
186 if (b
->default_bus_ptr
)
187 *b
->default_bus_ptr
= NULL
;
190 bus_close_inotify_fd(b
);
195 free(b
->unique_name
);
196 free(b
->auth_buffer
);
199 free(b
->description
);
200 free(b
->patch_sender
);
203 strv_free(b
->exec_argv
);
205 close_many(b
->fds
, b
->n_fds
);
210 ordered_hashmap_free_free(b
->reply_callbacks
);
211 prioq_free(b
->reply_callbacks_prioq
);
213 assert(b
->match_callbacks
.type
== BUS_MATCH_ROOT
);
214 bus_match_free(&b
->match_callbacks
);
216 hashmap_free_free(b
->vtable_methods
);
217 hashmap_free_free(b
->vtable_properties
);
219 assert(hashmap_isempty(b
->nodes
));
220 hashmap_free(b
->nodes
);
224 assert_se(pthread_mutex_destroy(&b
->memfd_cache_mutex
) == 0);
229 DEFINE_TRIVIAL_CLEANUP_FUNC(sd_bus
*, bus_free
);
231 _public_
int sd_bus_new(sd_bus
**ret
) {
232 _cleanup_free_ sd_bus
*b
= NULL
;
234 assert_return(ret
, -EINVAL
);
245 .message_version
= 1,
246 .creds_mask
= SD_BUS_CREDS_WELL_KNOWN_NAMES
|SD_BUS_CREDS_UNIQUE_NAME
,
248 .original_pid
= getpid_cached(),
249 .n_groups
= (size_t) -1,
250 .close_on_exit
= true,
253 /* We guarantee that wqueue always has space for at least one entry */
254 if (!GREEDY_REALLOC(b
->wqueue
, b
->wqueue_allocated
, 1))
257 assert_se(pthread_mutex_init(&b
->memfd_cache_mutex
, NULL
) == 0);
263 _public_
int sd_bus_set_address(sd_bus
*bus
, const char *address
) {
264 assert_return(bus
, -EINVAL
);
265 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
266 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
267 assert_return(address
, -EINVAL
);
268 assert_return(!bus_pid_changed(bus
), -ECHILD
);
270 return free_and_strdup(&bus
->address
, address
);
273 _public_
int sd_bus_set_fd(sd_bus
*bus
, int input_fd
, int output_fd
) {
274 assert_return(bus
, -EINVAL
);
275 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
276 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
277 assert_return(input_fd
>= 0, -EBADF
);
278 assert_return(output_fd
>= 0, -EBADF
);
279 assert_return(!bus_pid_changed(bus
), -ECHILD
);
281 bus
->input_fd
= input_fd
;
282 bus
->output_fd
= output_fd
;
286 _public_
int sd_bus_set_exec(sd_bus
*bus
, const char *path
, char *const argv
[]) {
287 _cleanup_strv_free_
char **a
= NULL
;
290 assert_return(bus
, -EINVAL
);
291 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
292 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
293 assert_return(path
, -EINVAL
);
294 assert_return(!strv_isempty(argv
), -EINVAL
);
295 assert_return(!bus_pid_changed(bus
), -ECHILD
);
301 r
= free_and_strdup(&bus
->exec_path
, path
);
305 return strv_free_and_replace(bus
->exec_argv
, a
);
308 _public_
int sd_bus_set_bus_client(sd_bus
*bus
, int b
) {
309 assert_return(bus
, -EINVAL
);
310 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
311 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
312 assert_return(!bus
->patch_sender
, -EPERM
);
313 assert_return(!bus_pid_changed(bus
), -ECHILD
);
315 bus
->bus_client
= !!b
;
319 _public_
int sd_bus_set_monitor(sd_bus
*bus
, int b
) {
320 assert_return(bus
, -EINVAL
);
321 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
322 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
323 assert_return(!bus_pid_changed(bus
), -ECHILD
);
325 bus
->is_monitor
= !!b
;
329 _public_
int sd_bus_negotiate_fds(sd_bus
*bus
, int b
) {
330 assert_return(bus
, -EINVAL
);
331 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
332 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
333 assert_return(!bus_pid_changed(bus
), -ECHILD
);
335 bus
->accept_fd
= !!b
;
339 _public_
int sd_bus_negotiate_timestamp(sd_bus
*bus
, int b
) {
340 assert_return(bus
, -EINVAL
);
341 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
342 assert_return(!IN_SET(bus
->state
, BUS_CLOSING
, BUS_CLOSED
), -EPERM
);
343 assert_return(!bus_pid_changed(bus
), -ECHILD
);
345 /* This is not actually supported by any of our transports these days, but we do honour it for synthetic
346 * replies, and maybe one day classic D-Bus learns this too */
347 bus
->attach_timestamp
= !!b
;
352 _public_
int sd_bus_negotiate_creds(sd_bus
*bus
, int b
, uint64_t mask
) {
353 assert_return(bus
, -EINVAL
);
354 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
355 assert_return(mask
<= _SD_BUS_CREDS_ALL
, -EINVAL
);
356 assert_return(!IN_SET(bus
->state
, BUS_CLOSING
, BUS_CLOSED
), -EPERM
);
357 assert_return(!bus_pid_changed(bus
), -ECHILD
);
359 SET_FLAG(bus
->creds_mask
, mask
, b
);
361 /* The well knowns we need unconditionally, so that matches can work */
362 bus
->creds_mask
|= SD_BUS_CREDS_WELL_KNOWN_NAMES
|SD_BUS_CREDS_UNIQUE_NAME
;
367 _public_
int sd_bus_set_server(sd_bus
*bus
, int b
, sd_id128_t server_id
) {
368 assert_return(bus
, -EINVAL
);
369 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
370 assert_return(b
|| sd_id128_equal(server_id
, SD_ID128_NULL
), -EINVAL
);
371 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
372 assert_return(!bus_pid_changed(bus
), -ECHILD
);
374 bus
->is_server
= !!b
;
375 bus
->server_id
= server_id
;
379 _public_
int sd_bus_set_anonymous(sd_bus
*bus
, int b
) {
380 assert_return(bus
, -EINVAL
);
381 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
382 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
383 assert_return(!bus_pid_changed(bus
), -ECHILD
);
385 bus
->anonymous_auth
= !!b
;
389 _public_
int sd_bus_set_trusted(sd_bus
*bus
, int b
) {
390 assert_return(bus
, -EINVAL
);
391 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
392 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
393 assert_return(!bus_pid_changed(bus
), -ECHILD
);
399 _public_
int sd_bus_set_description(sd_bus
*bus
, const char *description
) {
400 assert_return(bus
, -EINVAL
);
401 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
402 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
403 assert_return(!bus_pid_changed(bus
), -ECHILD
);
405 return free_and_strdup(&bus
->description
, description
);
408 _public_
int sd_bus_set_allow_interactive_authorization(sd_bus
*bus
, int b
) {
409 assert_return(bus
, -EINVAL
);
410 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
411 assert_return(!bus_pid_changed(bus
), -ECHILD
);
413 bus
->allow_interactive_authorization
= !!b
;
417 _public_
int sd_bus_get_allow_interactive_authorization(sd_bus
*bus
) {
418 assert_return(bus
, -EINVAL
);
419 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
420 assert_return(!bus_pid_changed(bus
), -ECHILD
);
422 return bus
->allow_interactive_authorization
;
425 _public_
int sd_bus_set_watch_bind(sd_bus
*bus
, int b
) {
426 assert_return(bus
, -EINVAL
);
427 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
428 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
429 assert_return(!bus_pid_changed(bus
), -ECHILD
);
431 bus
->watch_bind
= !!b
;
435 _public_
int sd_bus_get_watch_bind(sd_bus
*bus
) {
436 assert_return(bus
, -EINVAL
);
437 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
438 assert_return(!bus_pid_changed(bus
), -ECHILD
);
440 return bus
->watch_bind
;
443 _public_
int sd_bus_set_connected_signal(sd_bus
*bus
, int b
) {
444 assert_return(bus
, -EINVAL
);
445 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
446 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
447 assert_return(!bus_pid_changed(bus
), -ECHILD
);
449 bus
->connected_signal
= !!b
;
453 _public_
int sd_bus_get_connected_signal(sd_bus
*bus
) {
454 assert_return(bus
, -EINVAL
);
455 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
456 assert_return(!bus_pid_changed(bus
), -ECHILD
);
458 return bus
->connected_signal
;
461 static int synthesize_connected_signal(sd_bus
*bus
) {
462 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
467 /* If enabled, synthesizes a local "Connected" signal mirroring the local "Disconnected" signal. This is called
468 * whenever we fully established a connection, i.e. after the authorization phase, and after receiving the
469 * Hello() reply. Or in other words, whenever we enter BUS_RUNNING state.
471 * This is useful so that clients can start doing stuff whenever the connection is fully established in a way
472 * that works independently from whether we connected to a full bus or just a direct connection. */
474 if (!bus
->connected_signal
)
477 r
= sd_bus_message_new_signal(
480 "/org/freedesktop/DBus/Local",
481 "org.freedesktop.DBus.Local",
486 bus_message_set_sender_local(bus
, m
);
487 m
->read_counter
= ++bus
->read_counter
;
489 r
= bus_seal_synthetic_message(bus
, m
);
493 r
= bus_rqueue_make_room(bus
);
497 /* Insert at the very front */
498 memmove(bus
->rqueue
+ 1, bus
->rqueue
, sizeof(sd_bus_message
*) * bus
->rqueue_size
);
499 bus
->rqueue
[0] = bus_message_ref_queued(m
, bus
);
505 void bus_set_state(sd_bus
*bus
, enum bus_state state
) {
507 static const char * const table
[_BUS_STATE_MAX
] = {
508 [BUS_UNSET
] = "UNSET",
509 [BUS_WATCH_BIND
] = "WATCH_BIND",
510 [BUS_OPENING
] = "OPENING",
511 [BUS_AUTHENTICATING
] = "AUTHENTICATING",
512 [BUS_HELLO
] = "HELLO",
513 [BUS_RUNNING
] = "RUNNING",
514 [BUS_CLOSING
] = "CLOSING",
515 [BUS_CLOSED
] = "CLOSED",
519 assert(state
< _BUS_STATE_MAX
);
521 if (state
== bus
->state
)
524 log_debug("Bus %s: changing state %s → %s", strna(bus
->description
), table
[bus
->state
], table
[state
]);
528 static int hello_callback(sd_bus_message
*reply
, void *userdata
, sd_bus_error
*error
) {
536 assert(IN_SET(bus
->state
, BUS_HELLO
, BUS_CLOSING
));
538 r
= sd_bus_message_get_errno(reply
);
542 r
= sd_bus_message_read(reply
, "s", &s
);
546 if (!service_name_is_valid(s
) || s
[0] != ':')
549 r
= free_and_strdup(&bus
->unique_name
, s
);
553 if (bus
->state
== BUS_HELLO
) {
554 bus_set_state(bus
, BUS_RUNNING
);
556 r
= synthesize_connected_signal(bus
);
564 static int bus_send_hello(sd_bus
*bus
) {
565 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
570 if (!bus
->bus_client
)
573 r
= sd_bus_message_new_method_call(
576 "org.freedesktop.DBus",
577 "/org/freedesktop/DBus",
578 "org.freedesktop.DBus",
583 return sd_bus_call_async(bus
, NULL
, m
, hello_callback
, NULL
, 0);
586 int bus_start_running(sd_bus
*bus
) {
587 struct reply_callback
*c
;
593 assert(bus
->state
< BUS_HELLO
);
595 /* We start all method call timeouts when we enter BUS_HELLO or BUS_RUNNING mode. At this point let's convert
596 * all relative to absolute timestamps. Note that we do not reshuffle the reply callback priority queue since
597 * adding a fixed value to all entries should not alter the internal order. */
599 n
= now(CLOCK_MONOTONIC
);
600 ORDERED_HASHMAP_FOREACH(c
, bus
->reply_callbacks
, i
) {
601 if (c
->timeout_usec
== 0)
604 c
->timeout_usec
= usec_add(n
, c
->timeout_usec
);
607 if (bus
->bus_client
) {
608 bus_set_state(bus
, BUS_HELLO
);
612 bus_set_state(bus
, BUS_RUNNING
);
614 r
= synthesize_connected_signal(bus
);
621 static int parse_address_key(const char **p
, const char *key
, char **value
) {
622 size_t l
, n
= 0, allocated
= 0;
623 _cleanup_free_
char *r
= NULL
;
632 if (strncmp(*p
, key
, l
) != 0)
645 while (!IN_SET(*a
, ';', ',', 0)) {
659 c
= (char) ((x
<< 4) | y
);
666 if (!GREEDY_REALLOC(r
, allocated
, n
+ 2))
684 free_and_replace(*value
, r
);
689 static void skip_address_key(const char **p
) {
693 *p
+= strcspn(*p
, ",");
699 static int parse_unix_address(sd_bus
*b
, const char **p
, char **guid
) {
700 _cleanup_free_
char *path
= NULL
, *abstract
= NULL
;
709 while (!IN_SET(**p
, 0, ';')) {
710 r
= parse_address_key(p
, "guid", guid
);
716 r
= parse_address_key(p
, "path", &path
);
722 r
= parse_address_key(p
, "abstract", &abstract
);
731 if (!path
&& !abstract
)
734 if (path
&& abstract
)
739 if (l
>= sizeof(b
->sockaddr
.un
.sun_path
)) /* We insist on NUL termination */
742 b
->sockaddr
.un
= (struct sockaddr_un
) {
743 .sun_family
= AF_UNIX
,
746 memcpy(b
->sockaddr
.un
.sun_path
, path
, l
);
747 b
->sockaddr_size
= offsetof(struct sockaddr_un
, sun_path
) + l
+ 1;
752 l
= strlen(abstract
);
753 if (l
>= sizeof(b
->sockaddr
.un
.sun_path
) - 1) /* We insist on NUL termination */
756 b
->sockaddr
.un
= (struct sockaddr_un
) {
757 .sun_family
= AF_UNIX
,
760 memcpy(b
->sockaddr
.un
.sun_path
+1, abstract
, l
);
761 b
->sockaddr_size
= offsetof(struct sockaddr_un
, sun_path
) + 1 + l
;
769 static int parse_tcp_address(sd_bus
*b
, const char **p
, char **guid
) {
770 _cleanup_free_
char *host
= NULL
, *port
= NULL
, *family
= NULL
;
772 struct addrinfo
*result
, hints
= {
773 .ai_socktype
= SOCK_STREAM
,
774 .ai_flags
= AI_ADDRCONFIG
,
782 while (!IN_SET(**p
, 0, ';')) {
783 r
= parse_address_key(p
, "guid", guid
);
789 r
= parse_address_key(p
, "host", &host
);
795 r
= parse_address_key(p
, "port", &port
);
801 r
= parse_address_key(p
, "family", &family
);
814 if (streq(family
, "ipv4"))
815 hints
.ai_family
= AF_INET
;
816 else if (streq(family
, "ipv6"))
817 hints
.ai_family
= AF_INET6
;
822 r
= getaddrinfo(host
, port
, &hints
, &result
);
826 return -EADDRNOTAVAIL
;
828 memcpy(&b
->sockaddr
, result
->ai_addr
, result
->ai_addrlen
);
829 b
->sockaddr_size
= result
->ai_addrlen
;
831 freeaddrinfo(result
);
838 static int parse_exec_address(sd_bus
*b
, const char **p
, char **guid
) {
840 unsigned n_argv
= 0, j
;
842 size_t allocated
= 0;
850 while (!IN_SET(**p
, 0, ';')) {
851 r
= parse_address_key(p
, "guid", guid
);
857 r
= parse_address_key(p
, "path", &path
);
863 if (startswith(*p
, "argv")) {
867 ul
= strtoul(*p
+ 4, (char**) p
, 10);
868 if (errno
> 0 || **p
!= '=' || ul
> 256) {
876 if (!GREEDY_REALLOC0(argv
, allocated
, ul
+ 2)) {
884 r
= parse_address_key(p
, NULL
, argv
+ ul
);
899 /* Make sure there are no holes in the array, with the
900 * exception of argv[0] */
901 for (j
= 1; j
< n_argv
; j
++)
907 if (argv
&& argv
[0] == NULL
) {
908 argv
[0] = strdup(path
);
923 for (j
= 0; j
< n_argv
; j
++)
931 static int parse_container_unix_address(sd_bus
*b
, const char **p
, char **guid
) {
932 _cleanup_free_
char *machine
= NULL
, *pid
= NULL
;
940 while (!IN_SET(**p
, 0, ';')) {
941 r
= parse_address_key(p
, "guid", guid
);
947 r
= parse_address_key(p
, "machine", &machine
);
953 r
= parse_address_key(p
, "pid", &pid
);
962 if (!machine
== !pid
)
966 if (!streq(machine
, ".host") && !machine_name_is_valid(machine
))
969 free_and_replace(b
->machine
, machine
);
971 b
->machine
= mfree(b
->machine
);
975 r
= parse_pid(pid
, &b
->nspid
);
981 b
->sockaddr
.un
= (struct sockaddr_un
) {
982 .sun_family
= AF_UNIX
,
983 /* Note that we use the old /var/run prefix here, to increase compatibility with really old containers */
984 .sun_path
= "/var/run/dbus/system_bus_socket",
986 b
->sockaddr_size
= SOCKADDR_UN_LEN(b
->sockaddr
.un
);
992 static void bus_reset_parsed_address(sd_bus
*b
) {
996 b
->sockaddr_size
= 0;
997 b
->exec_argv
= strv_free(b
->exec_argv
);
998 b
->exec_path
= mfree(b
->exec_path
);
999 b
->server_id
= SD_ID128_NULL
;
1000 b
->machine
= mfree(b
->machine
);
1004 static int bus_parse_next_address(sd_bus
*b
) {
1005 _cleanup_free_
char *guid
= NULL
;
1013 if (b
->address
[b
->address_index
] == 0)
1016 bus_reset_parsed_address(b
);
1018 a
= b
->address
+ b
->address_index
;
1027 if (startswith(a
, "unix:")) {
1030 r
= parse_unix_address(b
, &a
, &guid
);
1035 } else if (startswith(a
, "tcp:")) {
1038 r
= parse_tcp_address(b
, &a
, &guid
);
1044 } else if (startswith(a
, "unixexec:")) {
1047 r
= parse_exec_address(b
, &a
, &guid
);
1053 } else if (startswith(a
, "x-machine-unix:")) {
1056 r
= parse_container_unix_address(b
, &a
, &guid
);
1069 r
= sd_id128_from_string(guid
, &b
->server_id
);
1074 b
->address_index
= a
- b
->address
;
1078 static void bus_kill_exec(sd_bus
*bus
) {
1079 if (pid_is_valid(bus
->busexec_pid
) > 0) {
1080 sigterm_wait(bus
->busexec_pid
);
1081 bus
->busexec_pid
= 0;
1085 static int bus_start_address(sd_bus
*b
) {
1091 bus_close_io_fds(b
);
1092 bus_close_inotify_fd(b
);
1096 /* If you provide multiple different bus-addresses, we
1097 * try all of them in order and use the first one that
1101 r
= bus_socket_exec(b
);
1102 else if ((b
->nspid
> 0 || b
->machine
) && b
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
)
1103 r
= bus_container_connect_socket(b
);
1104 else if (b
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
)
1105 r
= bus_socket_connect(b
);
1112 q
= bus_attach_io_events(b
);
1116 q
= bus_attach_inotify_event(b
);
1123 b
->last_connect_error
= -r
;
1126 r
= bus_parse_next_address(b
);
1130 return b
->last_connect_error
> 0 ? -b
->last_connect_error
: -ECONNREFUSED
;
1134 int bus_next_address(sd_bus
*b
) {
1137 bus_reset_parsed_address(b
);
1138 return bus_start_address(b
);
1141 static int bus_start_fd(sd_bus
*b
) {
1146 assert(b
->input_fd
>= 0);
1147 assert(b
->output_fd
>= 0);
1149 r
= fd_nonblock(b
->input_fd
, true);
1153 r
= fd_cloexec(b
->input_fd
, true);
1157 if (b
->input_fd
!= b
->output_fd
) {
1158 r
= fd_nonblock(b
->output_fd
, true);
1162 r
= fd_cloexec(b
->output_fd
, true);
1167 if (fstat(b
->input_fd
, &st
) < 0)
1170 return bus_socket_take_fd(b
);
1173 _public_
int sd_bus_start(sd_bus
*bus
) {
1176 assert_return(bus
, -EINVAL
);
1177 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
1178 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
1179 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1181 bus_set_state(bus
, BUS_OPENING
);
1183 if (bus
->is_server
&& bus
->bus_client
)
1186 if (bus
->input_fd
>= 0)
1187 r
= bus_start_fd(bus
);
1188 else if (bus
->address
|| bus
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
|| bus
->exec_path
|| bus
->machine
)
1189 r
= bus_start_address(bus
);
1198 return bus_send_hello(bus
);
1201 _public_
int sd_bus_open_with_description(sd_bus
**ret
, const char *description
) {
1203 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1206 assert_return(ret
, -EINVAL
);
1208 /* Let's connect to the starter bus if it is set, and
1209 * otherwise to the bus that is appropriate for the scope
1210 * we are running in */
1212 e
= secure_getenv("DBUS_STARTER_BUS_TYPE");
1214 if (streq(e
, "system"))
1215 return sd_bus_open_system_with_description(ret
, description
);
1216 else if (STR_IN_SET(e
, "session", "user"))
1217 return sd_bus_open_user_with_description(ret
, description
);
1220 e
= secure_getenv("DBUS_STARTER_ADDRESS");
1222 if (cg_pid_get_owner_uid(0, NULL
) >= 0)
1223 return sd_bus_open_user_with_description(ret
, description
);
1225 return sd_bus_open_system_with_description(ret
, description
);
1232 r
= sd_bus_set_address(b
, e
);
1236 b
->bus_client
= true;
1238 /* We don't know whether the bus is trusted or not, so better
1239 * be safe, and authenticate everything */
1241 b
->is_local
= false;
1242 b
->creds_mask
|= SD_BUS_CREDS_UID
| SD_BUS_CREDS_EUID
| SD_BUS_CREDS_EFFECTIVE_CAPS
;
1244 r
= sd_bus_start(b
);
1252 _public_
int sd_bus_open(sd_bus
**ret
) {
1253 return sd_bus_open_with_description(ret
, NULL
);
1256 int bus_set_address_system(sd_bus
*b
) {
1260 e
= secure_getenv("DBUS_SYSTEM_BUS_ADDRESS");
1262 return sd_bus_set_address(b
, e
);
1264 return sd_bus_set_address(b
, DEFAULT_SYSTEM_BUS_ADDRESS
);
1267 _public_
int sd_bus_open_system_with_description(sd_bus
**ret
, const char *description
) {
1268 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1271 assert_return(ret
, -EINVAL
);
1278 r
= sd_bus_set_description(b
, description
);
1283 r
= bus_set_address_system(b
);
1287 b
->bus_client
= true;
1288 b
->is_system
= true;
1290 /* Let's do per-method access control on the system bus. We
1291 * need the caller's UID and capability set for that. */
1293 b
->creds_mask
|= SD_BUS_CREDS_UID
| SD_BUS_CREDS_EUID
| SD_BUS_CREDS_EFFECTIVE_CAPS
;
1296 r
= sd_bus_start(b
);
1304 _public_
int sd_bus_open_system(sd_bus
**ret
) {
1305 return sd_bus_open_system_with_description(ret
, NULL
);
1308 int bus_set_address_user(sd_bus
*b
) {
1310 _cleanup_free_
char *ee
= NULL
, *s
= NULL
;
1314 e
= secure_getenv("DBUS_SESSION_BUS_ADDRESS");
1316 return sd_bus_set_address(b
, e
);
1318 e
= secure_getenv("XDG_RUNTIME_DIR");
1322 ee
= bus_address_escape(e
);
1326 if (asprintf(&s
, DEFAULT_USER_BUS_ADDRESS_FMT
, ee
) < 0)
1329 b
->address
= TAKE_PTR(s
);
1334 _public_
int sd_bus_open_user_with_description(sd_bus
**ret
, const char *description
) {
1335 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1338 assert_return(ret
, -EINVAL
);
1345 r
= sd_bus_set_description(b
, description
);
1350 r
= bus_set_address_user(b
);
1354 b
->bus_client
= true;
1357 /* We don't do any per-method access control on the user bus. */
1361 r
= sd_bus_start(b
);
1369 _public_
int sd_bus_open_user(sd_bus
**ret
) {
1370 return sd_bus_open_user_with_description(ret
, NULL
);
1373 int bus_set_address_system_remote(sd_bus
*b
, const char *host
) {
1374 _cleanup_free_
char *e
= NULL
;
1375 char *m
= NULL
, *c
= NULL
, *a
, *rbracket
= NULL
, *p
= NULL
;
1380 /* Skip ":"s in ipv6 addresses */
1384 rbracket
= strchr(host
, ']');
1387 t
= strndupa(host
+ 1, rbracket
- host
- 1);
1388 e
= bus_address_escape(t
);
1391 } else if ((a
= strchr(host
, '@'))) {
1392 if (*(a
+ 1) == '[') {
1393 _cleanup_free_
char *t
= NULL
;
1395 rbracket
= strchr(a
+ 1, ']');
1398 t
= new0(char, strlen(host
));
1401 strncat(t
, host
, a
- host
+ 1);
1402 strncat(t
, a
+ 2, rbracket
- a
- 2);
1403 e
= bus_address_escape(t
);
1406 } else if (*(a
+ 1) == '\0' || strchr(a
+ 1, '@'))
1410 /* Let's see if a port was given */
1411 m
= strchr(rbracket
? rbracket
+ 1 : host
, ':');
1414 bool got_forward_slash
= false;
1420 p
= strndupa(p
, t
- p
);
1421 got_forward_slash
= true;
1424 if (!in_charset(p
, "0123456789") || *p
== '\0') {
1425 if (!machine_name_is_valid(p
) || got_forward_slash
)
1429 goto interpret_port_as_machine_old_syntax
;
1433 /* Let's see if a machine was given */
1434 m
= strchr(rbracket
? rbracket
+ 1 : host
, '/');
1437 interpret_port_as_machine_old_syntax
:
1438 /* Let's make sure this is not a port of some kind,
1439 * and is a valid machine name. */
1440 if (!in_charset(m
, "0123456789") && machine_name_is_valid(m
))
1441 c
= strjoina(",argv", p
? "7" : "5", "=--machine=", m
);
1447 t
= strndupa(host
, strcspn(host
, ":/"));
1449 e
= bus_address_escape(t
);
1454 a
= strjoin("unixexec:path=ssh,argv1=-xT", p
? ",argv2=-p,argv3=" : "", strempty(p
),
1455 ",argv", p
? "4" : "2", "=--,argv", p
? "5" : "3", "=", e
,
1456 ",argv", p
? "6" : "4", "=systemd-stdio-bridge", c
);
1460 return free_and_replace(b
->address
, a
);
1463 _public_
int sd_bus_open_system_remote(sd_bus
**ret
, const char *host
) {
1464 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1467 assert_return(host
, -EINVAL
);
1468 assert_return(ret
, -EINVAL
);
1474 r
= bus_set_address_system_remote(b
, host
);
1478 b
->bus_client
= true;
1480 b
->is_system
= true;
1481 b
->is_local
= false;
1483 r
= sd_bus_start(b
);
1491 int bus_set_address_system_machine(sd_bus
*b
, const char *machine
) {
1492 _cleanup_free_
char *e
= NULL
;
1498 e
= bus_address_escape(machine
);
1502 a
= strjoin("x-machine-unix:machine=", e
);
1506 return free_and_replace(b
->address
, a
);
1509 _public_
int sd_bus_open_system_machine(sd_bus
**ret
, const char *machine
) {
1510 _cleanup_(bus_freep
) sd_bus
*b
= NULL
;
1513 assert_return(machine
, -EINVAL
);
1514 assert_return(ret
, -EINVAL
);
1515 assert_return(streq(machine
, ".host") || machine_name_is_valid(machine
), -EINVAL
);
1521 r
= bus_set_address_system_machine(b
, machine
);
1525 b
->bus_client
= true;
1527 b
->is_system
= true;
1528 b
->is_local
= false;
1530 r
= sd_bus_start(b
);
1538 _public_
void sd_bus_close(sd_bus
*bus
) {
1541 if (bus
->state
== BUS_CLOSED
)
1543 if (bus_pid_changed(bus
))
1546 /* Don't leave ssh hanging around */
1549 bus_set_state(bus
, BUS_CLOSED
);
1551 sd_bus_detach_event(bus
);
1553 /* Drop all queued messages so that they drop references to
1554 * the bus object and the bus may be freed */
1555 bus_reset_queues(bus
);
1557 bus_close_io_fds(bus
);
1558 bus_close_inotify_fd(bus
);
1561 _public_ sd_bus
*sd_bus_close_unref(sd_bus
*bus
) {
1567 return sd_bus_unref(bus
);
1570 _public_ sd_bus
* sd_bus_flush_close_unref(sd_bus
*bus
) {
1574 /* Have to do this before flush() to prevent hang */
1578 return sd_bus_close_unref(bus
);
1581 void bus_enter_closing(sd_bus
*bus
) {
1584 if (!IN_SET(bus
->state
, BUS_WATCH_BIND
, BUS_OPENING
, BUS_AUTHENTICATING
, BUS_HELLO
, BUS_RUNNING
))
1587 bus_set_state(bus
, BUS_CLOSING
);
1590 DEFINE_PUBLIC_TRIVIAL_REF_UNREF_FUNC(sd_bus
, sd_bus
, bus_free
);
1592 _public_
int sd_bus_is_open(sd_bus
*bus
) {
1593 assert_return(bus
, -EINVAL
);
1594 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
1595 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1597 return BUS_IS_OPEN(bus
->state
);
1600 _public_
int sd_bus_is_ready(sd_bus
*bus
) {
1601 assert_return(bus
, -EINVAL
);
1602 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
1603 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1605 return bus
->state
== BUS_RUNNING
;
1608 _public_
int sd_bus_can_send(sd_bus
*bus
, char type
) {
1611 assert_return(bus
, -EINVAL
);
1612 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
1613 assert_return(bus
->state
!= BUS_UNSET
, -ENOTCONN
);
1614 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1616 if (bus
->is_monitor
)
1619 if (type
== SD_BUS_TYPE_UNIX_FD
) {
1620 if (!bus
->accept_fd
)
1623 r
= bus_ensure_running(bus
);
1627 return bus
->can_fds
;
1630 return bus_type_is_valid(type
);
1633 _public_
int sd_bus_get_bus_id(sd_bus
*bus
, sd_id128_t
*id
) {
1636 assert_return(bus
, -EINVAL
);
1637 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
1638 assert_return(id
, -EINVAL
);
1639 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1641 r
= bus_ensure_running(bus
);
1645 *id
= bus
->server_id
;
1649 #define COOKIE_CYCLED (UINT32_C(1) << 31)
1651 static uint64_t cookie_inc(uint64_t cookie
) {
1653 /* Stay within the 32bit range, since classic D-Bus can't deal with more */
1654 if (cookie
>= UINT32_MAX
)
1655 return COOKIE_CYCLED
; /* Don't go back to zero, but use the highest bit for checking
1656 * whether we are looping. */
1661 static int next_cookie(sd_bus
*b
) {
1662 uint64_t new_cookie
;
1666 new_cookie
= cookie_inc(b
->cookie
);
1668 /* Small optimization: don't bother with checking for cookie reuse until we overran cookiespace at
1669 * least once, but then do it thorougly. */
1670 if (FLAGS_SET(new_cookie
, COOKIE_CYCLED
)) {
1673 /* Check if the cookie is currently in use. If so, pick the next one */
1674 for (i
= 0; i
< COOKIE_CYCLED
; i
++) {
1675 if (!ordered_hashmap_contains(b
->reply_callbacks
, &new_cookie
))
1678 new_cookie
= cookie_inc(new_cookie
);
1681 /* Can't fulfill request */
1686 b
->cookie
= new_cookie
;
1690 static int bus_seal_message(sd_bus
*b
, sd_bus_message
*m
, usec_t timeout
) {
1697 /* If we copy the same message to multiple
1698 * destinations, avoid using the same cookie
1700 b
->cookie
= MAX(b
->cookie
, BUS_MESSAGE_COOKIE(m
));
1705 r
= sd_bus_get_method_call_timeout(b
, &timeout
);
1710 if (!m
->sender
&& b
->patch_sender
) {
1711 r
= sd_bus_message_set_sender(m
, b
->patch_sender
);
1720 return sd_bus_message_seal(m
, b
->cookie
, timeout
);
1723 static int bus_remarshal_message(sd_bus
*b
, sd_bus_message
**m
) {
1724 bool remarshal
= false;
1728 /* wrong packet version */
1729 if (b
->message_version
!= 0 && b
->message_version
!= (*m
)->header
->version
)
1732 /* wrong packet endianness */
1733 if (b
->message_endian
!= 0 && b
->message_endian
!= (*m
)->header
->endian
)
1736 return remarshal
? bus_message_remarshal(b
, m
) : 0;
1739 int bus_seal_synthetic_message(sd_bus
*b
, sd_bus_message
*m
) {
1743 /* Fake some timestamps, if they were requested, and not
1744 * already initialized */
1745 if (b
->attach_timestamp
) {
1746 if (m
->realtime
<= 0)
1747 m
->realtime
= now(CLOCK_REALTIME
);
1749 if (m
->monotonic
<= 0)
1750 m
->monotonic
= now(CLOCK_MONOTONIC
);
1753 /* The bus specification says the serial number cannot be 0,
1754 * hence let's fill something in for synthetic messages. Since
1755 * synthetic messages might have a fake sender and we don't
1756 * want to interfere with the real sender's serial numbers we
1757 * pick a fixed, artificial one. We use (uint32_t) -1 rather
1758 * than (uint64_t) -1 since dbus1 only had 32bit identifiers,
1759 * even though kdbus can do 64bit. */
1760 return sd_bus_message_seal(m
, 0xFFFFFFFFULL
, 0);
1763 static int bus_write_message(sd_bus
*bus
, sd_bus_message
*m
, size_t *idx
) {
1769 r
= bus_socket_write_message(bus
, m
, idx
);
1773 if (*idx
>= BUS_MESSAGE_SIZE(m
))
1774 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",
1775 bus_message_type_to_string(m
->header
->type
),
1776 strna(sd_bus_message_get_sender(m
)),
1777 strna(sd_bus_message_get_destination(m
)),
1778 strna(sd_bus_message_get_path(m
)),
1779 strna(sd_bus_message_get_interface(m
)),
1780 strna(sd_bus_message_get_member(m
)),
1781 BUS_MESSAGE_COOKIE(m
),
1783 strna(m
->root_container
.signature
),
1784 strna(m
->error
.name
),
1785 strna(m
->error
.message
));
1790 static int dispatch_wqueue(sd_bus
*bus
) {
1794 assert(IN_SET(bus
->state
, BUS_RUNNING
, BUS_HELLO
));
1796 while (bus
->wqueue_size
> 0) {
1798 r
= bus_write_message(bus
, bus
->wqueue
[0], &bus
->windex
);
1802 /* Didn't do anything this time */
1804 else if (bus
->windex
>= BUS_MESSAGE_SIZE(bus
->wqueue
[0])) {
1805 /* Fully written. Let's drop the entry from
1808 * This isn't particularly optimized, but
1809 * well, this is supposed to be our worst-case
1810 * buffer only, and the socket buffer is
1811 * supposed to be our primary buffer, and if
1812 * it got full, then all bets are off
1816 bus_message_unref_queued(bus
->wqueue
[0], bus
);
1817 memmove(bus
->wqueue
, bus
->wqueue
+ 1, sizeof(sd_bus_message
*) * bus
->wqueue_size
);
1827 static int bus_read_message(sd_bus
*bus
, bool hint_priority
, int64_t priority
) {
1830 return bus_socket_read_message(bus
);
1833 int bus_rqueue_make_room(sd_bus
*bus
) {
1836 if (bus
->rqueue_size
>= BUS_RQUEUE_MAX
)
1839 if (!GREEDY_REALLOC(bus
->rqueue
, bus
->rqueue_allocated
, bus
->rqueue_size
+ 1))
1845 static void rqueue_drop_one(sd_bus
*bus
, size_t i
) {
1847 assert(i
< bus
->rqueue_size
);
1849 bus_message_unref_queued(bus
->rqueue
[i
], bus
);
1850 memmove(bus
->rqueue
+ i
, bus
->rqueue
+ i
+ 1, sizeof(sd_bus_message
*) * (bus
->rqueue_size
- i
- 1));
1854 static int dispatch_rqueue(sd_bus
*bus
, bool hint_priority
, int64_t priority
, sd_bus_message
**m
) {
1859 assert(IN_SET(bus
->state
, BUS_RUNNING
, BUS_HELLO
));
1861 /* Note that the priority logic is only available on kdbus,
1862 * where the rqueue is unused. We check the rqueue here
1863 * anyway, because it's simple... */
1866 if (bus
->rqueue_size
> 0) {
1867 /* Dispatch a queued message */
1868 *m
= sd_bus_message_ref(bus
->rqueue
[0]);
1869 rqueue_drop_one(bus
, 0);
1873 /* Try to read a new message */
1874 r
= bus_read_message(bus
, hint_priority
, priority
);
1886 _public_
int sd_bus_send(sd_bus
*bus
, sd_bus_message
*_m
, uint64_t *cookie
) {
1887 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= sd_bus_message_ref(_m
);
1890 assert_return(m
, -EINVAL
);
1895 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1897 if (!BUS_IS_OPEN(bus
->state
))
1901 r
= sd_bus_can_send(bus
, SD_BUS_TYPE_UNIX_FD
);
1908 /* If the cookie number isn't kept, then we know that no reply
1910 if (!cookie
&& !m
->sealed
)
1911 m
->header
->flags
|= BUS_MESSAGE_NO_REPLY_EXPECTED
;
1913 r
= bus_seal_message(bus
, m
, 0);
1917 /* Remarshall if we have to. This will possibly unref the
1918 * message and place a replacement in m */
1919 r
= bus_remarshal_message(bus
, &m
);
1923 /* If this is a reply and no reply was requested, then let's
1924 * suppress this, if we can */
1928 if (IN_SET(bus
->state
, BUS_RUNNING
, BUS_HELLO
) && bus
->wqueue_size
<= 0) {
1931 r
= bus_write_message(bus
, m
, &idx
);
1933 if (ERRNO_IS_DISCONNECT(r
)) {
1934 bus_enter_closing(bus
);
1941 if (idx
< BUS_MESSAGE_SIZE(m
)) {
1942 /* Wasn't fully written. So let's remember how
1943 * much was written. Note that the first entry
1944 * of the wqueue array is always allocated so
1945 * that we always can remember how much was
1947 bus
->wqueue
[0] = bus_message_ref_queued(m
, bus
);
1948 bus
->wqueue_size
= 1;
1953 /* Just append it to the queue. */
1955 if (bus
->wqueue_size
>= BUS_WQUEUE_MAX
)
1958 if (!GREEDY_REALLOC(bus
->wqueue
, bus
->wqueue_allocated
, bus
->wqueue_size
+ 1))
1961 bus
->wqueue
[bus
->wqueue_size
++] = bus_message_ref_queued(m
, bus
);
1966 *cookie
= BUS_MESSAGE_COOKIE(m
);
1971 _public_
int sd_bus_send_to(sd_bus
*bus
, sd_bus_message
*m
, const char *destination
, uint64_t *cookie
) {
1974 assert_return(m
, -EINVAL
);
1979 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1981 if (!BUS_IS_OPEN(bus
->state
))
1984 if (!streq_ptr(m
->destination
, destination
)) {
1989 r
= sd_bus_message_set_destination(m
, destination
);
1994 return sd_bus_send(bus
, m
, cookie
);
1997 static usec_t
calc_elapse(sd_bus
*bus
, uint64_t usec
) {
2000 if (usec
== (uint64_t) -1)
2003 /* We start all timeouts the instant we enter BUS_HELLO/BUS_RUNNING state, so that the don't run in parallel
2004 * with any connection setup states. Hence, if a method callback is started earlier than that we just store the
2005 * relative timestamp, and afterwards the absolute one. */
2007 if (IN_SET(bus
->state
, BUS_WATCH_BIND
, BUS_OPENING
, BUS_AUTHENTICATING
))
2010 return now(CLOCK_MONOTONIC
) + usec
;
2013 static int timeout_compare(const void *a
, const void *b
) {
2014 const struct reply_callback
*x
= a
, *y
= b
;
2016 if (x
->timeout_usec
!= 0 && y
->timeout_usec
== 0)
2019 if (x
->timeout_usec
== 0 && y
->timeout_usec
!= 0)
2022 return CMP(x
->timeout_usec
, y
->timeout_usec
);
2025 _public_
int sd_bus_call_async(
2029 sd_bus_message_handler_t callback
,
2033 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= sd_bus_message_ref(_m
);
2034 _cleanup_(sd_bus_slot_unrefp
) sd_bus_slot
*s
= NULL
;
2037 assert_return(m
, -EINVAL
);
2038 assert_return(m
->header
->type
== SD_BUS_MESSAGE_METHOD_CALL
, -EINVAL
);
2039 assert_return(!m
->sealed
|| (!!callback
== !(m
->header
->flags
& BUS_MESSAGE_NO_REPLY_EXPECTED
)), -EINVAL
);
2044 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2046 if (!BUS_IS_OPEN(bus
->state
))
2049 /* If no callback is specified and there's no interest in a slot, then there's no reason to ask for a reply */
2050 if (!callback
&& !slot
&& !m
->sealed
)
2051 m
->header
->flags
|= BUS_MESSAGE_NO_REPLY_EXPECTED
;
2053 r
= ordered_hashmap_ensure_allocated(&bus
->reply_callbacks
, &uint64_hash_ops
);
2057 r
= prioq_ensure_allocated(&bus
->reply_callbacks_prioq
, timeout_compare
);
2061 r
= bus_seal_message(bus
, m
, usec
);
2065 r
= bus_remarshal_message(bus
, &m
);
2069 if (slot
|| callback
) {
2070 s
= bus_slot_allocate(bus
, !slot
, BUS_REPLY_CALLBACK
, sizeof(struct reply_callback
), userdata
);
2074 s
->reply_callback
.callback
= callback
;
2076 s
->reply_callback
.cookie
= BUS_MESSAGE_COOKIE(m
);
2077 r
= ordered_hashmap_put(bus
->reply_callbacks
, &s
->reply_callback
.cookie
, &s
->reply_callback
);
2079 s
->reply_callback
.cookie
= 0;
2083 s
->reply_callback
.timeout_usec
= calc_elapse(bus
, m
->timeout
);
2084 if (s
->reply_callback
.timeout_usec
!= 0) {
2085 r
= prioq_put(bus
->reply_callbacks_prioq
, &s
->reply_callback
, &s
->reply_callback
.prioq_idx
);
2087 s
->reply_callback
.timeout_usec
= 0;
2093 r
= sd_bus_send(bus
, m
, s
? &s
->reply_callback
.cookie
: NULL
);
2104 int bus_ensure_running(sd_bus
*bus
) {
2109 if (IN_SET(bus
->state
, BUS_UNSET
, BUS_CLOSED
, BUS_CLOSING
))
2111 if (bus
->state
== BUS_RUNNING
)
2115 r
= sd_bus_process(bus
, NULL
);
2118 if (bus
->state
== BUS_RUNNING
)
2123 r
= sd_bus_wait(bus
, (uint64_t) -1);
2129 _public_
int sd_bus_call(
2133 sd_bus_error
*error
,
2134 sd_bus_message
**reply
) {
2136 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= sd_bus_message_ref(_m
);
2142 bus_assert_return(m
, -EINVAL
, error
);
2143 bus_assert_return(m
->header
->type
== SD_BUS_MESSAGE_METHOD_CALL
, -EINVAL
, error
);
2144 bus_assert_return(!(m
->header
->flags
& BUS_MESSAGE_NO_REPLY_EXPECTED
), -EINVAL
, error
);
2145 bus_assert_return(!bus_error_is_dirty(error
), -EINVAL
, error
);
2150 bus_assert_return(!bus_pid_changed(bus
), -ECHILD
, error
);
2152 if (!BUS_IS_OPEN(bus
->state
)) {
2157 r
= bus_ensure_running(bus
);
2161 i
= bus
->rqueue_size
;
2163 r
= bus_seal_message(bus
, m
, usec
);
2167 r
= bus_remarshal_message(bus
, &m
);
2171 r
= sd_bus_send(bus
, m
, &cookie
);
2175 timeout
= calc_elapse(bus
, m
->timeout
);
2180 while (i
< bus
->rqueue_size
) {
2181 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*incoming
= NULL
;
2183 incoming
= sd_bus_message_ref(bus
->rqueue
[i
]);
2185 if (incoming
->reply_cookie
== cookie
) {
2186 /* Found a match! */
2188 rqueue_drop_one(bus
, i
);
2189 log_debug_bus_message(incoming
);
2191 if (incoming
->header
->type
== SD_BUS_MESSAGE_METHOD_RETURN
) {
2193 if (incoming
->n_fds
<= 0 || bus
->accept_fd
) {
2195 *reply
= TAKE_PTR(incoming
);
2200 return sd_bus_error_setf(error
, SD_BUS_ERROR_INCONSISTENT_MESSAGE
, "Reply message contained file descriptors which I couldn't accept. Sorry.");
2202 } else if (incoming
->header
->type
== SD_BUS_MESSAGE_METHOD_ERROR
)
2203 return sd_bus_error_copy(error
, &incoming
->error
);
2209 } else if (BUS_MESSAGE_COOKIE(incoming
) == cookie
&&
2212 streq(bus
->unique_name
, incoming
->sender
)) {
2214 rqueue_drop_one(bus
, i
);
2216 /* Our own message? Somebody is trying to send its own client a message,
2217 * let's not dead-lock, let's fail immediately. */
2223 /* Try to read more, right-away */
2227 r
= bus_read_message(bus
, false, 0);
2229 if (ERRNO_IS_DISCONNECT(r
)) {
2230 bus_enter_closing(bus
);
2242 n
= now(CLOCK_MONOTONIC
);
2250 left
= (uint64_t) -1;
2252 r
= bus_poll(bus
, true, left
);
2260 r
= dispatch_wqueue(bus
);
2262 if (ERRNO_IS_DISCONNECT(r
)) {
2263 bus_enter_closing(bus
);
2272 return sd_bus_error_set_errno(error
, r
);
2275 _public_
int sd_bus_get_fd(sd_bus
*bus
) {
2277 assert_return(bus
, -EINVAL
);
2278 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
2279 assert_return(bus
->input_fd
== bus
->output_fd
, -EPERM
);
2280 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2282 if (bus
->state
== BUS_CLOSED
)
2285 if (bus
->inotify_fd
>= 0)
2286 return bus
->inotify_fd
;
2288 if (bus
->input_fd
>= 0)
2289 return bus
->input_fd
;
2294 _public_
int sd_bus_get_events(sd_bus
*bus
) {
2297 assert_return(bus
, -EINVAL
);
2298 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
2299 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2301 switch (bus
->state
) {
2307 case BUS_WATCH_BIND
:
2315 case BUS_AUTHENTICATING
:
2316 if (bus_socket_auth_needs_write(bus
))
2324 if (bus
->rqueue_size
<= 0)
2326 if (bus
->wqueue_size
> 0)
2334 assert_not_reached("Unknown state");
2340 _public_
int sd_bus_get_timeout(sd_bus
*bus
, uint64_t *timeout_usec
) {
2341 struct reply_callback
*c
;
2343 assert_return(bus
, -EINVAL
);
2344 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
2345 assert_return(timeout_usec
, -EINVAL
);
2346 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2348 if (!BUS_IS_OPEN(bus
->state
) && bus
->state
!= BUS_CLOSING
)
2351 if (bus
->track_queue
) {
2356 switch (bus
->state
) {
2358 case BUS_AUTHENTICATING
:
2359 *timeout_usec
= bus
->auth_timeout
;
2364 if (bus
->rqueue_size
> 0) {
2369 c
= prioq_peek(bus
->reply_callbacks_prioq
);
2371 *timeout_usec
= (uint64_t) -1;
2375 if (c
->timeout_usec
== 0) {
2376 *timeout_usec
= (uint64_t) -1;
2380 *timeout_usec
= c
->timeout_usec
;
2387 case BUS_WATCH_BIND
:
2389 *timeout_usec
= (uint64_t) -1;
2393 assert_not_reached("Unknown or unexpected stat");
2397 static int process_timeout(sd_bus
*bus
) {
2398 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2399 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
* m
= NULL
;
2400 struct reply_callback
*c
;
2407 assert(IN_SET(bus
->state
, BUS_RUNNING
, BUS_HELLO
));
2409 c
= prioq_peek(bus
->reply_callbacks_prioq
);
2413 n
= now(CLOCK_MONOTONIC
);
2414 if (c
->timeout_usec
> n
)
2417 r
= bus_message_new_synthetic_error(
2420 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY
, "Method call timed out"),
2425 m
->read_counter
= ++bus
->read_counter
;
2427 r
= bus_seal_synthetic_message(bus
, m
);
2431 assert_se(prioq_pop(bus
->reply_callbacks_prioq
) == c
);
2432 c
->timeout_usec
= 0;
2434 ordered_hashmap_remove(bus
->reply_callbacks
, &c
->cookie
);
2437 slot
= container_of(c
, sd_bus_slot
, reply_callback
);
2439 bus
->iteration_counter
++;
2441 is_hello
= bus
->state
== BUS_HELLO
&& c
->callback
== hello_callback
;
2443 bus
->current_message
= m
;
2444 bus
->current_slot
= sd_bus_slot_ref(slot
);
2445 bus
->current_handler
= c
->callback
;
2446 bus
->current_userdata
= slot
->userdata
;
2447 r
= c
->callback(m
, slot
->userdata
, &error_buffer
);
2448 bus
->current_userdata
= NULL
;
2449 bus
->current_handler
= NULL
;
2450 bus
->current_slot
= NULL
;
2451 bus
->current_message
= NULL
;
2454 bus_slot_disconnect(slot
, true);
2456 sd_bus_slot_unref(slot
);
2458 /* When this is the hello message and it timed out, then make sure to propagate the error up, don't just log
2459 * and ignore the callback handler's return value. */
2463 return bus_maybe_reply_error(m
, r
, &error_buffer
);
2466 static int process_hello(sd_bus
*bus
, sd_bus_message
*m
) {
2470 if (bus
->state
!= BUS_HELLO
)
2473 /* Let's make sure the first message on the bus is the HELLO
2474 * reply. But note that we don't actually parse the message
2475 * here (we leave that to the usual handling), we just verify
2476 * we don't let any earlier msg through. */
2478 if (!IN_SET(m
->header
->type
, SD_BUS_MESSAGE_METHOD_RETURN
, SD_BUS_MESSAGE_METHOD_ERROR
))
2481 if (m
->reply_cookie
!= 1)
2487 static int process_reply(sd_bus
*bus
, sd_bus_message
*m
) {
2488 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*synthetic_reply
= NULL
;
2489 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2490 struct reply_callback
*c
;
2498 if (!IN_SET(m
->header
->type
, SD_BUS_MESSAGE_METHOD_RETURN
, SD_BUS_MESSAGE_METHOD_ERROR
))
2501 if (m
->destination
&& bus
->unique_name
&& !streq_ptr(m
->destination
, bus
->unique_name
))
2504 c
= ordered_hashmap_remove(bus
->reply_callbacks
, &m
->reply_cookie
);
2510 slot
= container_of(c
, sd_bus_slot
, reply_callback
);
2512 if (m
->n_fds
> 0 && !bus
->accept_fd
) {
2514 /* If the reply contained a file descriptor which we
2515 * didn't want we pass an error instead. */
2517 r
= bus_message_new_synthetic_error(
2520 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_INCONSISTENT_MESSAGE
, "Reply message contained file descriptor"),
2525 /* Copy over original timestamp */
2526 synthetic_reply
->realtime
= m
->realtime
;
2527 synthetic_reply
->monotonic
= m
->monotonic
;
2528 synthetic_reply
->seqnum
= m
->seqnum
;
2529 synthetic_reply
->read_counter
= m
->read_counter
;
2531 r
= bus_seal_synthetic_message(bus
, synthetic_reply
);
2535 m
= synthetic_reply
;
2537 r
= sd_bus_message_rewind(m
, true);
2542 if (c
->timeout_usec
!= 0) {
2543 prioq_remove(bus
->reply_callbacks_prioq
, c
, &c
->prioq_idx
);
2544 c
->timeout_usec
= 0;
2547 is_hello
= bus
->state
== BUS_HELLO
&& c
->callback
== hello_callback
;
2549 bus
->current_slot
= sd_bus_slot_ref(slot
);
2550 bus
->current_handler
= c
->callback
;
2551 bus
->current_userdata
= slot
->userdata
;
2552 r
= c
->callback(m
, slot
->userdata
, &error_buffer
);
2553 bus
->current_userdata
= NULL
;
2554 bus
->current_handler
= NULL
;
2555 bus
->current_slot
= NULL
;
2558 bus_slot_disconnect(slot
, true);
2560 sd_bus_slot_unref(slot
);
2562 /* When this is the hello message and it failed, then make sure to propagate the error up, don't just log and
2563 * ignore the callback handler's return value. */
2567 return bus_maybe_reply_error(m
, r
, &error_buffer
);
2570 static int process_filter(sd_bus
*bus
, sd_bus_message
*m
) {
2571 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2572 struct filter_callback
*l
;
2579 bus
->filter_callbacks_modified
= false;
2581 LIST_FOREACH(callbacks
, l
, bus
->filter_callbacks
) {
2584 if (bus
->filter_callbacks_modified
)
2587 /* Don't run this more than once per iteration */
2588 if (l
->last_iteration
== bus
->iteration_counter
)
2591 l
->last_iteration
= bus
->iteration_counter
;
2593 r
= sd_bus_message_rewind(m
, true);
2597 slot
= container_of(l
, sd_bus_slot
, filter_callback
);
2599 bus
->current_slot
= sd_bus_slot_ref(slot
);
2600 bus
->current_handler
= l
->callback
;
2601 bus
->current_userdata
= slot
->userdata
;
2602 r
= l
->callback(m
, slot
->userdata
, &error_buffer
);
2603 bus
->current_userdata
= NULL
;
2604 bus
->current_handler
= NULL
;
2605 bus
->current_slot
= sd_bus_slot_unref(slot
);
2607 r
= bus_maybe_reply_error(m
, r
, &error_buffer
);
2613 } while (bus
->filter_callbacks_modified
);
2618 static int process_match(sd_bus
*bus
, sd_bus_message
*m
) {
2625 bus
->match_callbacks_modified
= false;
2627 r
= bus_match_run(bus
, &bus
->match_callbacks
, m
);
2631 } while (bus
->match_callbacks_modified
);
2636 static int process_builtin(sd_bus
*bus
, sd_bus_message
*m
) {
2637 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*reply
= NULL
;
2643 if (bus
->is_monitor
)
2646 if (bus
->manual_peer_interface
)
2649 if (m
->header
->type
!= SD_BUS_MESSAGE_METHOD_CALL
)
2652 if (!streq_ptr(m
->interface
, "org.freedesktop.DBus.Peer"))
2655 if (m
->header
->flags
& BUS_MESSAGE_NO_REPLY_EXPECTED
)
2658 if (streq_ptr(m
->member
, "Ping"))
2659 r
= sd_bus_message_new_method_return(m
, &reply
);
2660 else if (streq_ptr(m
->member
, "GetMachineId")) {
2664 r
= sd_id128_get_machine(&id
);
2668 r
= sd_bus_message_new_method_return(m
, &reply
);
2672 r
= sd_bus_message_append(reply
, "s", sd_id128_to_string(id
, sid
));
2674 r
= sd_bus_message_new_method_errorf(
2676 SD_BUS_ERROR_UNKNOWN_METHOD
,
2677 "Unknown method '%s' on interface '%s'.", m
->member
, m
->interface
);
2682 r
= sd_bus_send(bus
, reply
, NULL
);
2689 static int process_fd_check(sd_bus
*bus
, sd_bus_message
*m
) {
2693 /* If we got a message with a file descriptor which we didn't
2694 * want to accept, then let's drop it. How can this even
2695 * happen? For example, when the kernel queues a message into
2696 * an activatable names's queue which allows fds, and then is
2697 * delivered to us later even though we ourselves did not
2700 if (bus
->is_monitor
)
2709 if (m
->header
->type
!= SD_BUS_MESSAGE_METHOD_CALL
)
2710 return 1; /* just eat it up */
2712 return sd_bus_reply_method_errorf(m
, SD_BUS_ERROR_INCONSISTENT_MESSAGE
, "Message contains file descriptors, which I cannot accept. Sorry.");
2715 static int process_message(sd_bus
*bus
, sd_bus_message
*m
) {
2721 bus
->current_message
= m
;
2722 bus
->iteration_counter
++;
2724 log_debug_bus_message(m
);
2726 r
= process_hello(bus
, m
);
2730 r
= process_reply(bus
, m
);
2734 r
= process_fd_check(bus
, m
);
2738 r
= process_filter(bus
, m
);
2742 r
= process_match(bus
, m
);
2746 r
= process_builtin(bus
, m
);
2750 r
= bus_process_object(bus
, m
);
2753 bus
->current_message
= NULL
;
2757 static int dispatch_track(sd_bus
*bus
) {
2760 if (!bus
->track_queue
)
2763 bus_track_dispatch(bus
->track_queue
);
2767 static int process_running(sd_bus
*bus
, bool hint_priority
, int64_t priority
, sd_bus_message
**ret
) {
2768 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
2772 assert(IN_SET(bus
->state
, BUS_RUNNING
, BUS_HELLO
));
2774 r
= process_timeout(bus
);
2778 r
= dispatch_wqueue(bus
);
2782 r
= dispatch_track(bus
);
2786 r
= dispatch_rqueue(bus
, hint_priority
, priority
, &m
);
2792 r
= process_message(bus
, m
);
2797 r
= sd_bus_message_rewind(m
, true);
2805 if (m
->header
->type
== SD_BUS_MESSAGE_METHOD_CALL
) {
2807 log_debug("Unprocessed message call sender=%s object=%s interface=%s member=%s",
2808 strna(sd_bus_message_get_sender(m
)),
2809 strna(sd_bus_message_get_path(m
)),
2810 strna(sd_bus_message_get_interface(m
)),
2811 strna(sd_bus_message_get_member(m
)));
2813 r
= sd_bus_reply_method_errorf(
2815 SD_BUS_ERROR_UNKNOWN_OBJECT
,
2816 "Unknown object '%s'.", m
->path
);
2830 static int bus_exit_now(sd_bus
*bus
) {
2833 /* Exit due to close, if this is requested. If this is bus object is attached to an event source, invokes
2834 * sd_event_exit(), otherwise invokes libc exit(). */
2836 if (bus
->exited
) /* did we already exit? */
2838 if (!bus
->exit_triggered
) /* was the exit condition triggered? */
2840 if (!bus
->exit_on_disconnect
) /* Shall we actually exit on disconnection? */
2843 bus
->exited
= true; /* never exit more than once */
2845 log_debug("Bus connection disconnected, exiting.");
2848 return sd_event_exit(bus
->event
, EXIT_FAILURE
);
2852 assert_not_reached("exit() didn't exit?");
2855 static int process_closing_reply_callback(sd_bus
*bus
, struct reply_callback
*c
) {
2856 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2857 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
2864 r
= bus_message_new_synthetic_error(
2867 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY
, "Connection terminated"),
2872 m
->read_counter
= ++bus
->read_counter
;
2874 r
= bus_seal_synthetic_message(bus
, m
);
2878 if (c
->timeout_usec
!= 0) {
2879 prioq_remove(bus
->reply_callbacks_prioq
, c
, &c
->prioq_idx
);
2880 c
->timeout_usec
= 0;
2883 ordered_hashmap_remove(bus
->reply_callbacks
, &c
->cookie
);
2886 slot
= container_of(c
, sd_bus_slot
, reply_callback
);
2888 bus
->iteration_counter
++;
2890 bus
->current_message
= m
;
2891 bus
->current_slot
= sd_bus_slot_ref(slot
);
2892 bus
->current_handler
= c
->callback
;
2893 bus
->current_userdata
= slot
->userdata
;
2894 r
= c
->callback(m
, slot
->userdata
, &error_buffer
);
2895 bus
->current_userdata
= NULL
;
2896 bus
->current_handler
= NULL
;
2897 bus
->current_slot
= NULL
;
2898 bus
->current_message
= NULL
;
2901 bus_slot_disconnect(slot
, true);
2903 sd_bus_slot_unref(slot
);
2905 return bus_maybe_reply_error(m
, r
, &error_buffer
);
2908 static int process_closing(sd_bus
*bus
, sd_bus_message
**ret
) {
2909 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
2910 struct reply_callback
*c
;
2914 assert(bus
->state
== BUS_CLOSING
);
2916 /* First, fail all outstanding method calls */
2917 c
= ordered_hashmap_first(bus
->reply_callbacks
);
2919 return process_closing_reply_callback(bus
, c
);
2921 /* Then, fake-drop all remaining bus tracking references */
2923 bus_track_close(bus
->tracks
);
2927 /* Then, synthesize a Disconnected message */
2928 r
= sd_bus_message_new_signal(
2931 "/org/freedesktop/DBus/Local",
2932 "org.freedesktop.DBus.Local",
2937 bus_message_set_sender_local(bus
, m
);
2938 m
->read_counter
= ++bus
->read_counter
;
2940 r
= bus_seal_synthetic_message(bus
, m
);
2946 bus
->current_message
= m
;
2947 bus
->iteration_counter
++;
2949 r
= process_filter(bus
, m
);
2953 r
= process_match(bus
, m
);
2957 /* Nothing else to do, exit now, if the condition holds */
2958 bus
->exit_triggered
= true;
2959 (void) bus_exit_now(bus
);
2967 bus
->current_message
= NULL
;
2972 static int bus_process_internal(sd_bus
*bus
, bool hint_priority
, int64_t priority
, sd_bus_message
**ret
) {
2975 /* Returns 0 when we didn't do anything. This should cause the
2976 * caller to invoke sd_bus_wait() before returning the next
2977 * time. Returns > 0 when we did something, which possibly
2978 * means *ret is filled in with an unprocessed message. */
2980 assert_return(bus
, -EINVAL
);
2981 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
2982 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2984 /* We don't allow recursively invoking sd_bus_process(). */
2985 assert_return(!bus
->current_message
, -EBUSY
);
2986 assert(!bus
->current_slot
); /* This should be NULL whenever bus->current_message is */
2988 BUS_DONT_DESTROY(bus
);
2990 switch (bus
->state
) {
2998 case BUS_WATCH_BIND
:
2999 r
= bus_socket_process_watch_bind(bus
);
3003 r
= bus_socket_process_opening(bus
);
3006 case BUS_AUTHENTICATING
:
3007 r
= bus_socket_process_authenticating(bus
);
3012 r
= process_running(bus
, hint_priority
, priority
, ret
);
3016 /* This branch initializes *ret, hence we don't use the generic error checking below */
3020 return process_closing(bus
, ret
);
3023 assert_not_reached("Unknown state");
3026 if (ERRNO_IS_DISCONNECT(r
)) {
3027 bus_enter_closing(bus
);
3038 _public_
int sd_bus_process(sd_bus
*bus
, sd_bus_message
**ret
) {
3039 return bus_process_internal(bus
, false, 0, ret
);
3042 _public_
int sd_bus_process_priority(sd_bus
*bus
, int64_t priority
, sd_bus_message
**ret
) {
3043 return bus_process_internal(bus
, true, priority
, ret
);
3046 static int bus_poll(sd_bus
*bus
, bool need_more
, uint64_t timeout_usec
) {
3047 struct pollfd p
[2] = {};
3050 usec_t m
= USEC_INFINITY
;
3054 if (bus
->state
== BUS_CLOSING
)
3057 if (!BUS_IS_OPEN(bus
->state
))
3060 if (bus
->state
== BUS_WATCH_BIND
) {
3061 assert(bus
->inotify_fd
>= 0);
3063 p
[0].events
= POLLIN
;
3064 p
[0].fd
= bus
->inotify_fd
;
3069 e
= sd_bus_get_events(bus
);
3074 /* The caller really needs some more data, he doesn't
3075 * care about what's already read, or any timeouts
3076 * except its own. */
3080 /* The caller wants to process if there's something to
3081 * process, but doesn't care otherwise */
3083 r
= sd_bus_get_timeout(bus
, &until
);
3087 m
= usec_sub_unsigned(until
, now(CLOCK_MONOTONIC
));
3090 p
[0].fd
= bus
->input_fd
;
3091 if (bus
->output_fd
== bus
->input_fd
) {
3095 p
[0].events
= e
& POLLIN
;
3096 p
[1].fd
= bus
->output_fd
;
3097 p
[1].events
= e
& POLLOUT
;
3102 if (timeout_usec
!= (uint64_t) -1 && (m
== USEC_INFINITY
|| timeout_usec
< m
))
3105 r
= ppoll(p
, n
, m
== USEC_INFINITY
? NULL
: timespec_store(&ts
, m
), NULL
);
3109 return r
> 0 ? 1 : 0;
3112 _public_
int sd_bus_wait(sd_bus
*bus
, uint64_t timeout_usec
) {
3114 assert_return(bus
, -EINVAL
);
3115 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3116 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3118 if (bus
->state
== BUS_CLOSING
)
3121 if (!BUS_IS_OPEN(bus
->state
))
3124 if (bus
->rqueue_size
> 0)
3127 return bus_poll(bus
, false, timeout_usec
);
3130 _public_
int sd_bus_flush(sd_bus
*bus
) {
3133 assert_return(bus
, -EINVAL
);
3134 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3135 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3137 if (bus
->state
== BUS_CLOSING
)
3140 if (!BUS_IS_OPEN(bus
->state
))
3143 /* We never were connected? Don't hang in inotify for good, as there's no timeout set for it */
3144 if (bus
->state
== BUS_WATCH_BIND
)
3147 r
= bus_ensure_running(bus
);
3151 if (bus
->wqueue_size
<= 0)
3155 r
= dispatch_wqueue(bus
);
3157 if (ERRNO_IS_DISCONNECT(r
)) {
3158 bus_enter_closing(bus
);
3165 if (bus
->wqueue_size
<= 0)
3168 r
= bus_poll(bus
, false, (uint64_t) -1);
3174 _public_
int sd_bus_add_filter(
3177 sd_bus_message_handler_t callback
,
3182 assert_return(bus
, -EINVAL
);
3183 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3184 assert_return(callback
, -EINVAL
);
3185 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3187 s
= bus_slot_allocate(bus
, !slot
, BUS_FILTER_CALLBACK
, sizeof(struct filter_callback
), userdata
);
3191 s
->filter_callback
.callback
= callback
;
3193 bus
->filter_callbacks_modified
= true;
3194 LIST_PREPEND(callbacks
, bus
->filter_callbacks
, &s
->filter_callback
);
3202 static int add_match_callback(
3205 sd_bus_error
*ret_error
) {
3207 sd_bus_slot
*match_slot
= userdata
;
3208 bool failed
= false;
3214 sd_bus_slot_ref(match_slot
);
3216 if (sd_bus_message_is_method_error(m
, NULL
)) {
3217 log_debug_errno(sd_bus_message_get_errno(m
),
3218 "Unable to add match %s, failing connection: %s",
3219 match_slot
->match_callback
.match_string
,
3220 sd_bus_message_get_error(m
)->message
);
3224 log_debug("Match %s successfully installed.", match_slot
->match_callback
.match_string
);
3226 if (match_slot
->match_callback
.install_callback
) {
3229 bus
= sd_bus_message_get_bus(m
);
3231 /* This function has been called as slot handler, and we want to call another slot handler. Let's
3232 * update the slot callback metadata temporarily with our own data, and then revert back to the old
3235 assert(bus
->current_slot
== match_slot
->match_callback
.install_slot
);
3236 assert(bus
->current_handler
== add_match_callback
);
3237 assert(bus
->current_userdata
== userdata
);
3239 bus
->current_slot
= match_slot
;
3240 bus
->current_handler
= match_slot
->match_callback
.install_callback
;
3241 bus
->current_userdata
= match_slot
->userdata
;
3243 r
= match_slot
->match_callback
.install_callback(m
, match_slot
->userdata
, ret_error
);
3245 bus
->current_slot
= match_slot
->match_callback
.install_slot
;
3246 bus
->current_handler
= add_match_callback
;
3247 bus
->current_userdata
= userdata
;
3249 if (failed
) /* Generic failure handling: destroy the connection */
3250 bus_enter_closing(sd_bus_message_get_bus(m
));
3255 /* We don't need the install method reply slot anymore, let's free it */
3256 match_slot
->match_callback
.install_slot
= sd_bus_slot_unref(match_slot
->match_callback
.install_slot
);
3258 if (failed
&& match_slot
->floating
)
3259 bus_slot_disconnect(match_slot
, true);
3261 sd_bus_slot_unref(match_slot
);
3266 static int bus_add_match_full(
3271 sd_bus_message_handler_t callback
,
3272 sd_bus_message_handler_t install_callback
,
3275 struct bus_match_component
*components
= NULL
;
3276 unsigned n_components
= 0;
3277 sd_bus_slot
*s
= NULL
;
3280 assert_return(bus
, -EINVAL
);
3281 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3282 assert_return(match
, -EINVAL
);
3283 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3285 r
= bus_match_parse(match
, &components
, &n_components
);
3289 s
= bus_slot_allocate(bus
, !slot
, BUS_MATCH_CALLBACK
, sizeof(struct match_callback
), userdata
);
3295 s
->match_callback
.callback
= callback
;
3296 s
->match_callback
.install_callback
= install_callback
;
3298 if (bus
->bus_client
) {
3299 enum bus_match_scope scope
;
3301 scope
= bus_match_get_scope(components
, n_components
);
3303 /* Do not install server-side matches for matches against the local service, interface or bus path. */
3304 if (scope
!= BUS_MATCH_LOCAL
) {
3306 /* We store the original match string, so that we can use it to remove the match again. */
3308 s
->match_callback
.match_string
= strdup(match
);
3309 if (!s
->match_callback
.match_string
) {
3315 r
= bus_add_match_internal_async(bus
,
3316 &s
->match_callback
.install_slot
,
3317 s
->match_callback
.match_string
,
3324 /* Make the slot of the match call floating now. We need the reference, but we don't
3325 * want that this match pins the bus object, hence we first create it non-floating, but
3326 * then make it floating. */
3327 r
= sd_bus_slot_set_floating(s
->match_callback
.install_slot
, true);
3329 r
= bus_add_match_internal(bus
, s
->match_callback
.match_string
, &s
->match_callback
.after
);
3333 s
->match_added
= true;
3337 bus
->match_callbacks_modified
= true;
3338 r
= bus_match_add(&bus
->match_callbacks
, components
, n_components
, &s
->match_callback
);
3347 bus_match_parse_free(components
, n_components
);
3348 sd_bus_slot_unref(s
);
3353 _public_
int sd_bus_add_match(
3357 sd_bus_message_handler_t callback
,
3360 return bus_add_match_full(bus
, slot
, false, match
, callback
, NULL
, userdata
);
3363 _public_
int sd_bus_add_match_async(
3367 sd_bus_message_handler_t callback
,
3368 sd_bus_message_handler_t install_callback
,
3371 return bus_add_match_full(bus
, slot
, true, match
, callback
, install_callback
, userdata
);
3374 bool bus_pid_changed(sd_bus
*bus
) {
3377 /* We don't support people creating a bus connection and
3378 * keeping it around over a fork(). Let's complain. */
3380 return bus
->original_pid
!= getpid_cached();
3383 static int io_callback(sd_event_source
*s
, int fd
, uint32_t revents
, void *userdata
) {
3384 sd_bus
*bus
= userdata
;
3389 /* Note that this is called both on input_fd, output_fd as well as inotify_fd events */
3391 r
= sd_bus_process(bus
, NULL
);
3393 log_debug_errno(r
, "Processing of bus failed, closing down: %m");
3394 bus_enter_closing(bus
);
3400 static int time_callback(sd_event_source
*s
, uint64_t usec
, void *userdata
) {
3401 sd_bus
*bus
= userdata
;
3406 r
= sd_bus_process(bus
, NULL
);
3408 log_debug_errno(r
, "Processing of bus failed, closing down: %m");
3409 bus_enter_closing(bus
);
3415 static int prepare_callback(sd_event_source
*s
, void *userdata
) {
3416 sd_bus
*bus
= userdata
;
3423 e
= sd_bus_get_events(bus
);
3429 if (bus
->output_fd
!= bus
->input_fd
) {
3431 r
= sd_event_source_set_io_events(bus
->input_io_event_source
, e
& POLLIN
);
3435 r
= sd_event_source_set_io_events(bus
->output_io_event_source
, e
& POLLOUT
);
3437 r
= sd_event_source_set_io_events(bus
->input_io_event_source
, e
);
3441 r
= sd_bus_get_timeout(bus
, &until
);
3447 j
= sd_event_source_set_time(bus
->time_event_source
, until
);
3454 r
= sd_event_source_set_enabled(bus
->time_event_source
, r
> 0);
3461 log_debug_errno(r
, "Preparing of bus events failed, closing down: %m");
3462 bus_enter_closing(bus
);
3467 static int quit_callback(sd_event_source
*event
, void *userdata
) {
3468 sd_bus
*bus
= userdata
;
3472 if (bus
->close_on_exit
) {
3480 int bus_attach_io_events(sd_bus
*bus
) {
3485 if (bus
->input_fd
< 0)
3491 if (!bus
->input_io_event_source
) {
3492 r
= sd_event_add_io(bus
->event
, &bus
->input_io_event_source
, bus
->input_fd
, 0, io_callback
, bus
);
3496 r
= sd_event_source_set_prepare(bus
->input_io_event_source
, prepare_callback
);
3500 r
= sd_event_source_set_priority(bus
->input_io_event_source
, bus
->event_priority
);
3504 r
= sd_event_source_set_description(bus
->input_io_event_source
, "bus-input");
3506 r
= sd_event_source_set_io_fd(bus
->input_io_event_source
, bus
->input_fd
);
3511 if (bus
->output_fd
!= bus
->input_fd
) {
3512 assert(bus
->output_fd
>= 0);
3514 if (!bus
->output_io_event_source
) {
3515 r
= sd_event_add_io(bus
->event
, &bus
->output_io_event_source
, bus
->output_fd
, 0, io_callback
, bus
);
3519 r
= sd_event_source_set_priority(bus
->output_io_event_source
, bus
->event_priority
);
3523 r
= sd_event_source_set_description(bus
->input_io_event_source
, "bus-output");
3525 r
= sd_event_source_set_io_fd(bus
->output_io_event_source
, bus
->output_fd
);
3534 static void bus_detach_io_events(sd_bus
*bus
) {
3537 if (bus
->input_io_event_source
) {
3538 sd_event_source_set_enabled(bus
->input_io_event_source
, SD_EVENT_OFF
);
3539 bus
->input_io_event_source
= sd_event_source_unref(bus
->input_io_event_source
);
3542 if (bus
->output_io_event_source
) {
3543 sd_event_source_set_enabled(bus
->output_io_event_source
, SD_EVENT_OFF
);
3544 bus
->output_io_event_source
= sd_event_source_unref(bus
->output_io_event_source
);
3548 int bus_attach_inotify_event(sd_bus
*bus
) {
3553 if (bus
->inotify_fd
< 0)
3559 if (!bus
->inotify_event_source
) {
3560 r
= sd_event_add_io(bus
->event
, &bus
->inotify_event_source
, bus
->inotify_fd
, EPOLLIN
, io_callback
, bus
);
3564 r
= sd_event_source_set_priority(bus
->inotify_event_source
, bus
->event_priority
);
3568 r
= sd_event_source_set_description(bus
->inotify_event_source
, "bus-inotify");
3570 r
= sd_event_source_set_io_fd(bus
->inotify_event_source
, bus
->inotify_fd
);
3577 static void bus_detach_inotify_event(sd_bus
*bus
) {
3580 if (bus
->inotify_event_source
) {
3581 sd_event_source_set_enabled(bus
->inotify_event_source
, SD_EVENT_OFF
);
3582 bus
->inotify_event_source
= sd_event_source_unref(bus
->inotify_event_source
);
3586 _public_
int sd_bus_attach_event(sd_bus
*bus
, sd_event
*event
, int priority
) {
3589 assert_return(bus
, -EINVAL
);
3590 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3591 assert_return(!bus
->event
, -EBUSY
);
3593 assert(!bus
->input_io_event_source
);
3594 assert(!bus
->output_io_event_source
);
3595 assert(!bus
->time_event_source
);
3598 bus
->event
= sd_event_ref(event
);
3600 r
= sd_event_default(&bus
->event
);
3605 bus
->event_priority
= priority
;
3607 r
= sd_event_add_time(bus
->event
, &bus
->time_event_source
, CLOCK_MONOTONIC
, 0, 0, time_callback
, bus
);
3611 r
= sd_event_source_set_priority(bus
->time_event_source
, priority
);
3615 r
= sd_event_source_set_description(bus
->time_event_source
, "bus-time");
3619 r
= sd_event_add_exit(bus
->event
, &bus
->quit_event_source
, quit_callback
, bus
);
3623 r
= sd_event_source_set_description(bus
->quit_event_source
, "bus-exit");
3627 r
= bus_attach_io_events(bus
);
3631 r
= bus_attach_inotify_event(bus
);
3638 sd_bus_detach_event(bus
);
3642 _public_
int sd_bus_detach_event(sd_bus
*bus
) {
3643 assert_return(bus
, -EINVAL
);
3644 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3649 bus_detach_io_events(bus
);
3650 bus_detach_inotify_event(bus
);
3652 if (bus
->time_event_source
) {
3653 sd_event_source_set_enabled(bus
->time_event_source
, SD_EVENT_OFF
);
3654 bus
->time_event_source
= sd_event_source_unref(bus
->time_event_source
);
3657 if (bus
->quit_event_source
) {
3658 sd_event_source_set_enabled(bus
->quit_event_source
, SD_EVENT_OFF
);
3659 bus
->quit_event_source
= sd_event_source_unref(bus
->quit_event_source
);
3662 bus
->event
= sd_event_unref(bus
->event
);
3666 _public_ sd_event
* sd_bus_get_event(sd_bus
*bus
) {
3667 assert_return(bus
, NULL
);
3672 _public_ sd_bus_message
* sd_bus_get_current_message(sd_bus
*bus
) {
3673 assert_return(bus
, NULL
);
3675 return bus
->current_message
;
3678 _public_ sd_bus_slot
* sd_bus_get_current_slot(sd_bus
*bus
) {
3679 assert_return(bus
, NULL
);
3681 return bus
->current_slot
;
3684 _public_ sd_bus_message_handler_t
sd_bus_get_current_handler(sd_bus
*bus
) {
3685 assert_return(bus
, NULL
);
3687 return bus
->current_handler
;
3690 _public_
void* sd_bus_get_current_userdata(sd_bus
*bus
) {
3691 assert_return(bus
, NULL
);
3693 return bus
->current_userdata
;
3696 static int bus_default(int (*bus_open
)(sd_bus
**), sd_bus
**default_bus
, sd_bus
**ret
) {
3701 assert(default_bus
);
3704 return !!*default_bus
;
3707 *ret
= sd_bus_ref(*default_bus
);
3715 b
->default_bus_ptr
= default_bus
;
3723 _public_
int sd_bus_default_system(sd_bus
**ret
) {
3724 return bus_default(sd_bus_open_system
, &default_system_bus
, ret
);
3727 _public_
int sd_bus_default_user(sd_bus
**ret
) {
3728 return bus_default(sd_bus_open_user
, &default_user_bus
, ret
);
3731 _public_
int sd_bus_default(sd_bus
**ret
) {
3732 int (*bus_open
)(sd_bus
**) = NULL
;
3735 busp
= bus_choose_default(&bus_open
);
3736 return bus_default(bus_open
, busp
, ret
);
3739 _public_
int sd_bus_get_tid(sd_bus
*b
, pid_t
*tid
) {
3740 assert_return(b
, -EINVAL
);
3741 assert_return(tid
, -EINVAL
);
3742 assert_return(!bus_pid_changed(b
), -ECHILD
);
3750 return sd_event_get_tid(b
->event
, tid
);
3755 _public_
int sd_bus_path_encode(const char *prefix
, const char *external_id
, char **ret_path
) {
3756 _cleanup_free_
char *e
= NULL
;
3759 assert_return(object_path_is_valid(prefix
), -EINVAL
);
3760 assert_return(external_id
, -EINVAL
);
3761 assert_return(ret_path
, -EINVAL
);
3763 e
= bus_label_escape(external_id
);
3767 ret
= path_join(prefix
, e
);
3775 _public_
int sd_bus_path_decode(const char *path
, const char *prefix
, char **external_id
) {
3779 assert_return(object_path_is_valid(path
), -EINVAL
);
3780 assert_return(object_path_is_valid(prefix
), -EINVAL
);
3781 assert_return(external_id
, -EINVAL
);
3783 e
= object_path_startswith(path
, prefix
);
3785 *external_id
= NULL
;
3789 ret
= bus_label_unescape(e
);
3797 _public_
int sd_bus_path_encode_many(char **out
, const char *path_template
, ...) {
3798 _cleanup_strv_free_
char **labels
= NULL
;
3799 char *path
, *path_pos
, **label_pos
;
3800 const char *sep
, *template_pos
;
3805 assert_return(out
, -EINVAL
);
3806 assert_return(path_template
, -EINVAL
);
3808 path_length
= strlen(path_template
);
3810 va_start(list
, path_template
);
3811 for (sep
= strchr(path_template
, '%'); sep
; sep
= strchr(sep
+ 1, '%')) {
3815 arg
= va_arg(list
, const char *);
3821 label
= bus_label_escape(arg
);
3827 r
= strv_consume(&labels
, label
);
3833 /* add label length, but account for the format character */
3834 path_length
+= strlen(label
) - 1;
3838 path
= malloc(path_length
+ 1);
3845 for (template_pos
= path_template
; *template_pos
; ) {
3846 sep
= strchrnul(template_pos
, '%');
3847 path_pos
= mempcpy(path_pos
, template_pos
, sep
- template_pos
);
3851 path_pos
= stpcpy(path_pos
, *label_pos
++);
3852 template_pos
= sep
+ 1;
3860 _public_
int sd_bus_path_decode_many(const char *path
, const char *path_template
, ...) {
3861 _cleanup_strv_free_
char **labels
= NULL
;
3862 const char *template_pos
, *path_pos
;
3868 * This decodes an object-path based on a template argument. The
3869 * template consists of a verbatim path, optionally including special
3872 * - Each occurrence of '%' in the template matches an arbitrary
3873 * substring of a label in the given path. At most one such
3874 * directive is allowed per label. For each such directive, the
3875 * caller must provide an output parameter (char **) via va_arg. If
3876 * NULL is passed, the given label is verified, but not returned.
3877 * For each matched label, the *decoded* label is stored in the
3878 * passed output argument, and the caller is responsible to free
3879 * it. Note that the output arguments are only modified if the
3880 * actually path matched the template. Otherwise, they're left
3883 * This function returns <0 on error, 0 if the path does not match the
3884 * template, 1 if it matched.
3887 assert_return(path
, -EINVAL
);
3888 assert_return(path_template
, -EINVAL
);
3892 for (template_pos
= path_template
; *template_pos
; ) {
3897 /* verify everything until the next '%' matches verbatim */
3898 sep
= strchrnul(template_pos
, '%');
3899 length
= sep
- template_pos
;
3900 if (strncmp(path_pos
, template_pos
, length
))
3904 template_pos
+= length
;
3909 /* We found the next '%' character. Everything up until here
3910 * matched. We now skip ahead to the end of this label and make
3911 * sure it matches the tail of the label in the path. Then we
3912 * decode the string in-between and save it for later use. */
3914 ++template_pos
; /* skip over '%' */
3916 sep
= strchrnul(template_pos
, '/');
3917 length
= sep
- template_pos
; /* length of suffix to match verbatim */
3919 /* verify the suffixes match */
3920 sep
= strchrnul(path_pos
, '/');
3921 if (sep
- path_pos
< (ssize_t
)length
||
3922 strncmp(sep
- length
, template_pos
, length
))
3925 template_pos
+= length
; /* skip over matched label */
3926 length
= sep
- path_pos
- length
; /* length of sub-label to decode */
3928 /* store unescaped label for later use */
3929 label
= bus_label_unescape_n(path_pos
, length
);
3933 r
= strv_consume(&labels
, label
);
3937 path_pos
= sep
; /* skip decoded label and suffix */
3940 /* end of template must match end of path */
3944 /* copy the labels over to the caller */
3945 va_start(list
, path_template
);
3946 for (label_pos
= labels
; label_pos
&& *label_pos
; ++label_pos
) {
3949 arg
= va_arg(list
, char **);
3957 labels
= mfree(labels
);
3961 _public_
int sd_bus_try_close(sd_bus
*bus
) {
3962 assert_return(bus
, -EINVAL
);
3963 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3964 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3969 _public_
int sd_bus_get_description(sd_bus
*bus
, const char **description
) {
3970 assert_return(bus
, -EINVAL
);
3971 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3972 assert_return(description
, -EINVAL
);
3973 assert_return(bus
->description
, -ENXIO
);
3974 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3976 if (bus
->description
)
3977 *description
= bus
->description
;
3978 else if (bus
->is_system
)
3979 *description
= "system";
3980 else if (bus
->is_user
)
3981 *description
= "user";
3983 *description
= NULL
;
3988 _public_
int sd_bus_get_scope(sd_bus
*bus
, const char **scope
) {
3989 assert_return(bus
, -EINVAL
);
3990 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
3991 assert_return(scope
, -EINVAL
);
3992 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3999 if (bus
->is_system
) {
4007 _public_
int sd_bus_get_address(sd_bus
*bus
, const char **address
) {
4009 assert_return(bus
, -EINVAL
);
4010 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4011 assert_return(address
, -EINVAL
);
4012 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4015 *address
= bus
->address
;
4022 _public_
int sd_bus_get_creds_mask(sd_bus
*bus
, uint64_t *mask
) {
4023 assert_return(bus
, -EINVAL
);
4024 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4025 assert_return(mask
, -EINVAL
);
4026 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4028 *mask
= bus
->creds_mask
;
4032 _public_
int sd_bus_is_bus_client(sd_bus
*bus
) {
4033 assert_return(bus
, -EINVAL
);
4034 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4035 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4037 return bus
->bus_client
;
4040 _public_
int sd_bus_is_server(sd_bus
*bus
) {
4041 assert_return(bus
, -EINVAL
);
4042 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4043 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4045 return bus
->is_server
;
4048 _public_
int sd_bus_is_anonymous(sd_bus
*bus
) {
4049 assert_return(bus
, -EINVAL
);
4050 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4051 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4053 return bus
->anonymous_auth
;
4056 _public_
int sd_bus_is_trusted(sd_bus
*bus
) {
4057 assert_return(bus
, -EINVAL
);
4058 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4059 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4061 return bus
->trusted
;
4064 _public_
int sd_bus_is_monitor(sd_bus
*bus
) {
4065 assert_return(bus
, -EINVAL
);
4066 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4067 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4069 return bus
->is_monitor
;
4072 static void flush_close(sd_bus
*bus
) {
4076 /* Flushes and closes the specified bus. We take a ref before,
4077 * to ensure the flushing does not cause the bus to be
4080 sd_bus_flush_close_unref(sd_bus_ref(bus
));
4083 _public_
void sd_bus_default_flush_close(void) {
4084 flush_close(default_starter_bus
);
4085 flush_close(default_user_bus
);
4086 flush_close(default_system_bus
);
4089 _public_
int sd_bus_set_exit_on_disconnect(sd_bus
*bus
, int b
) {
4090 assert_return(bus
, -EINVAL
);
4091 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4093 /* Turns on exit-on-disconnect, and triggers it immediately if the bus connection was already
4094 * disconnected. Note that this is triggered exclusively on disconnections triggered by the server side, never
4095 * from the client side. */
4096 bus
->exit_on_disconnect
= b
;
4098 /* If the exit condition was triggered already, exit immediately. */
4099 return bus_exit_now(bus
);
4102 _public_
int sd_bus_get_exit_on_disconnect(sd_bus
*bus
) {
4103 assert_return(bus
, -EINVAL
);
4104 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4106 return bus
->exit_on_disconnect
;
4109 _public_
int sd_bus_set_sender(sd_bus
*bus
, const char *sender
) {
4110 assert_return(bus
, -EINVAL
);
4111 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4112 assert_return(!bus
->bus_client
, -EPERM
);
4113 assert_return(!sender
|| service_name_is_valid(sender
), -EINVAL
);
4115 return free_and_strdup(&bus
->patch_sender
, sender
);
4118 _public_
int sd_bus_get_sender(sd_bus
*bus
, const char **ret
) {
4119 assert_return(bus
, -EINVAL
);
4120 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4121 assert_return(ret
, -EINVAL
);
4123 if (!bus
->patch_sender
)
4126 *ret
= bus
->patch_sender
;
4130 _public_
int sd_bus_get_n_queued_read(sd_bus
*bus
, uint64_t *ret
) {
4131 assert_return(bus
, -EINVAL
);
4132 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4133 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4134 assert_return(ret
, -EINVAL
);
4136 *ret
= bus
->rqueue_size
;
4140 _public_
int sd_bus_get_n_queued_write(sd_bus
*bus
, uint64_t *ret
) {
4141 assert_return(bus
, -EINVAL
);
4142 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4143 assert_return(!bus_pid_changed(bus
), -ECHILD
);
4144 assert_return(ret
, -EINVAL
);
4146 *ret
= bus
->wqueue_size
;
4150 _public_
int sd_bus_set_method_call_timeout(sd_bus
*bus
, uint64_t usec
) {
4151 assert_return(bus
, -EINVAL
);
4152 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4154 bus
->method_call_timeout
= usec
;
4158 _public_
int sd_bus_get_method_call_timeout(sd_bus
*bus
, uint64_t *ret
) {
4162 assert_return(bus
, -EINVAL
);
4163 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4164 assert_return(ret
, -EINVAL
);
4166 if (bus
->method_call_timeout
!= 0) {
4167 *ret
= bus
->method_call_timeout
;
4171 e
= secure_getenv("SYSTEMD_BUS_TIMEOUT");
4172 if (e
&& parse_sec(e
, &usec
) >= 0 && usec
!= 0) {
4173 /* Save the parsed value to avoid multiple parsing. To change the timeout value,
4174 * use sd_bus_set_method_call_timeout() instead of setenv(). */
4175 *ret
= bus
->method_call_timeout
= usec
;
4179 *ret
= bus
->method_call_timeout
= BUS_DEFAULT_TIMEOUT
;
4183 _public_
int sd_bus_set_close_on_exit(sd_bus
*bus
, int b
) {
4184 assert_return(bus
, -EINVAL
);
4185 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4187 bus
->close_on_exit
= b
;
4191 _public_
int sd_bus_get_close_on_exit(sd_bus
*bus
) {
4192 assert_return(bus
, -EINVAL
);
4193 assert_return(bus
= bus_resolve(bus
), -ENOPKG
);
4195 return bus
->close_on_exit
;