2 This file is part of systemd.
4 Copyright 2013 Lennart Poettering
6 systemd is free software; you can redistribute it and/or modify it
7 under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 systemd is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with systemd; If not, see <http://www.gnu.org/licenses/>.
30 #include "alloc-util.h"
31 #include "bus-container.h"
32 #include "bus-control.h"
33 #include "bus-internal.h"
34 #include "bus-kernel.h"
35 #include "bus-label.h"
36 #include "bus-message.h"
37 #include "bus-objects.h"
38 #include "bus-protocol.h"
40 #include "bus-socket.h"
41 #include "bus-track.h"
44 #include "cgroup-util.h"
47 #include "hexdecoct.h"
48 #include "hostname-util.h"
51 #include "parse-util.h"
52 #include "string-util.h"
56 #define log_debug_bus_message(m) \
58 sd_bus_message *_mm = (m); \
59 log_debug("Got message type=%s sender=%s destination=%s object=%s interface=%s member=%s cookie=%" PRIu64 " reply_cookie=%" PRIu64 " error=%s", \
60 bus_message_type_to_string(_mm->header->type), \
61 strna(sd_bus_message_get_sender(_mm)), \
62 strna(sd_bus_message_get_destination(_mm)), \
63 strna(sd_bus_message_get_path(_mm)), \
64 strna(sd_bus_message_get_interface(_mm)), \
65 strna(sd_bus_message_get_member(_mm)), \
66 BUS_MESSAGE_COOKIE(_mm), \
68 strna(_mm->error.message)); \
71 static int bus_poll(sd_bus
*bus
, bool need_more
, uint64_t timeout_usec
);
72 static int attach_io_events(sd_bus
*b
);
73 static void detach_io_events(sd_bus
*b
);
75 static thread_local sd_bus
*default_system_bus
= NULL
;
76 static thread_local sd_bus
*default_user_bus
= NULL
;
77 static thread_local sd_bus
*default_starter_bus
= NULL
;
79 static void bus_close_fds(sd_bus
*b
) {
84 if (b
->input_fd
!= b
->output_fd
)
85 safe_close(b
->output_fd
);
86 b
->output_fd
= b
->input_fd
= safe_close(b
->input_fd
);
89 static void bus_reset_queues(sd_bus
*b
) {
92 while (b
->rqueue_size
> 0)
93 sd_bus_message_unref(b
->rqueue
[--b
->rqueue_size
]);
95 b
->rqueue
= mfree(b
->rqueue
);
96 b
->rqueue_allocated
= 0;
98 while (b
->wqueue_size
> 0)
99 sd_bus_message_unref(b
->wqueue
[--b
->wqueue_size
]);
101 b
->wqueue
= mfree(b
->wqueue
);
102 b
->wqueue_allocated
= 0;
105 static void bus_free(sd_bus
*b
) {
109 assert(!b
->track_queue
);
112 b
->state
= BUS_CLOSED
;
114 sd_bus_detach_event(b
);
116 while ((s
= b
->slots
)) {
117 /* At this point only floating slots can still be
118 * around, because the non-floating ones keep a
119 * reference to the bus, and we thus couldn't be
120 * destructing right now... We forcibly disconnect the
121 * slots here, so that they still can be referenced by
122 * apps, but are dead. */
125 bus_slot_disconnect(s
);
126 sd_bus_slot_unref(s
);
129 if (b
->default_bus_ptr
)
130 *b
->default_bus_ptr
= NULL
;
135 munmap(b
->kdbus_buffer
, KDBUS_POOL_SIZE
);
139 free(b
->unique_name
);
140 free(b
->auth_buffer
);
145 free(b
->cgroup_root
);
146 free(b
->description
);
149 strv_free(b
->exec_argv
);
151 close_many(b
->fds
, b
->n_fds
);
156 ordered_hashmap_free_free(b
->reply_callbacks
);
157 prioq_free(b
->reply_callbacks_prioq
);
159 assert(b
->match_callbacks
.type
== BUS_MATCH_ROOT
);
160 bus_match_free(&b
->match_callbacks
);
162 hashmap_free_free(b
->vtable_methods
);
163 hashmap_free_free(b
->vtable_properties
);
165 assert(hashmap_isempty(b
->nodes
));
166 hashmap_free(b
->nodes
);
168 bus_kernel_flush_memfd(b
);
170 assert_se(pthread_mutex_destroy(&b
->memfd_cache_mutex
) == 0);
175 _public_
int sd_bus_new(sd_bus
**ret
) {
178 assert_return(ret
, -EINVAL
);
184 r
->n_ref
= REFCNT_INIT
;
185 r
->input_fd
= r
->output_fd
= -1;
186 r
->message_version
= 1;
187 r
->creds_mask
|= SD_BUS_CREDS_WELL_KNOWN_NAMES
|SD_BUS_CREDS_UNIQUE_NAME
;
188 r
->hello_flags
|= KDBUS_HELLO_ACCEPT_FD
;
189 r
->attach_flags
|= KDBUS_ATTACH_NAMES
;
190 r
->original_pid
= getpid_cached();
192 assert_se(pthread_mutex_init(&r
->memfd_cache_mutex
, NULL
) == 0);
194 /* We guarantee that wqueue always has space for at least one
196 if (!GREEDY_REALLOC(r
->wqueue
, r
->wqueue_allocated
, 1)) {
205 _public_
int sd_bus_set_address(sd_bus
*bus
, const char *address
) {
208 assert_return(bus
, -EINVAL
);
209 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
210 assert_return(address
, -EINVAL
);
211 assert_return(!bus_pid_changed(bus
), -ECHILD
);
223 _public_
int sd_bus_set_fd(sd_bus
*bus
, int input_fd
, int output_fd
) {
224 assert_return(bus
, -EINVAL
);
225 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
226 assert_return(input_fd
>= 0, -EBADF
);
227 assert_return(output_fd
>= 0, -EBADF
);
228 assert_return(!bus_pid_changed(bus
), -ECHILD
);
230 bus
->input_fd
= input_fd
;
231 bus
->output_fd
= output_fd
;
235 _public_
int sd_bus_set_exec(sd_bus
*bus
, const char *path
, char *const argv
[]) {
238 assert_return(bus
, -EINVAL
);
239 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
240 assert_return(path
, -EINVAL
);
241 assert_return(!strv_isempty(argv
), -EINVAL
);
242 assert_return(!bus_pid_changed(bus
), -ECHILD
);
254 free(bus
->exec_path
);
255 strv_free(bus
->exec_argv
);
263 _public_
int sd_bus_set_bus_client(sd_bus
*bus
, int b
) {
264 assert_return(bus
, -EINVAL
);
265 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
266 assert_return(!bus_pid_changed(bus
), -ECHILD
);
268 bus
->bus_client
= !!b
;
272 _public_
int sd_bus_set_monitor(sd_bus
*bus
, int b
) {
273 assert_return(bus
, -EINVAL
);
274 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
275 assert_return(!bus_pid_changed(bus
), -ECHILD
);
277 SET_FLAG(bus
->hello_flags
, KDBUS_HELLO_MONITOR
, b
);
281 _public_
int sd_bus_negotiate_fds(sd_bus
*bus
, int b
) {
282 assert_return(bus
, -EINVAL
);
283 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
284 assert_return(!bus_pid_changed(bus
), -ECHILD
);
286 SET_FLAG(bus
->hello_flags
, KDBUS_HELLO_ACCEPT_FD
, b
);
290 _public_
int sd_bus_negotiate_timestamp(sd_bus
*bus
, int b
) {
292 assert_return(bus
, -EINVAL
);
293 assert_return(!IN_SET(bus
->state
, BUS_CLOSING
, BUS_CLOSED
), -EPERM
);
294 assert_return(!bus_pid_changed(bus
), -ECHILD
);
296 new_flags
= bus
->attach_flags
;
297 SET_FLAG(new_flags
, KDBUS_ATTACH_TIMESTAMP
, b
);
299 if (bus
->attach_flags
== new_flags
)
302 bus
->attach_flags
= new_flags
;
303 if (bus
->state
!= BUS_UNSET
&& bus
->is_kernel
)
304 bus_kernel_realize_attach_flags(bus
);
309 _public_
int sd_bus_negotiate_creds(sd_bus
*bus
, int b
, uint64_t mask
) {
312 assert_return(bus
, -EINVAL
);
313 assert_return(mask
<= _SD_BUS_CREDS_ALL
, -EINVAL
);
314 assert_return(!IN_SET(bus
->state
, BUS_CLOSING
, BUS_CLOSED
), -EPERM
);
315 assert_return(!bus_pid_changed(bus
), -ECHILD
);
317 SET_FLAG(bus
->creds_mask
, mask
, b
);
319 /* The well knowns we need unconditionally, so that matches can work */
320 bus
->creds_mask
|= SD_BUS_CREDS_WELL_KNOWN_NAMES
|SD_BUS_CREDS_UNIQUE_NAME
;
322 /* Make sure we don't lose the timestamp flag */
323 new_flags
= (bus
->attach_flags
& KDBUS_ATTACH_TIMESTAMP
) | attach_flags_to_kdbus(bus
->creds_mask
);
324 if (bus
->attach_flags
== new_flags
)
327 bus
->attach_flags
= new_flags
;
328 if (bus
->state
!= BUS_UNSET
&& bus
->is_kernel
)
329 bus_kernel_realize_attach_flags(bus
);
334 _public_
int sd_bus_set_server(sd_bus
*bus
, int b
, sd_id128_t server_id
) {
335 assert_return(bus
, -EINVAL
);
336 assert_return(b
|| sd_id128_equal(server_id
, SD_ID128_NULL
), -EINVAL
);
337 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
338 assert_return(!bus_pid_changed(bus
), -ECHILD
);
340 bus
->is_server
= !!b
;
341 bus
->server_id
= server_id
;
345 _public_
int sd_bus_set_anonymous(sd_bus
*bus
, int b
) {
346 assert_return(bus
, -EINVAL
);
347 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
348 assert_return(!bus_pid_changed(bus
), -ECHILD
);
350 bus
->anonymous_auth
= !!b
;
354 _public_
int sd_bus_set_trusted(sd_bus
*bus
, int b
) {
355 assert_return(bus
, -EINVAL
);
356 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
357 assert_return(!bus_pid_changed(bus
), -ECHILD
);
363 _public_
int sd_bus_set_description(sd_bus
*bus
, const char *description
) {
364 assert_return(bus
, -EINVAL
);
365 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
366 assert_return(!bus_pid_changed(bus
), -ECHILD
);
368 return free_and_strdup(&bus
->description
, description
);
371 _public_
int sd_bus_set_allow_interactive_authorization(sd_bus
*bus
, int b
) {
372 assert_return(bus
, -EINVAL
);
373 assert_return(!bus_pid_changed(bus
), -ECHILD
);
375 bus
->allow_interactive_authorization
= !!b
;
379 _public_
int sd_bus_get_allow_interactive_authorization(sd_bus
*bus
) {
380 assert_return(bus
, -EINVAL
);
381 assert_return(!bus_pid_changed(bus
), -ECHILD
);
383 return bus
->allow_interactive_authorization
;
386 static int hello_callback(sd_bus_message
*reply
, void *userdata
, sd_bus_error
*error
) {
394 assert(bus
->state
== BUS_HELLO
|| bus
->state
== BUS_CLOSING
);
396 r
= sd_bus_message_get_errno(reply
);
400 r
= sd_bus_message_read(reply
, "s", &s
);
404 if (!service_name_is_valid(s
) || s
[0] != ':')
407 bus
->unique_name
= strdup(s
);
408 if (!bus
->unique_name
)
411 if (bus
->state
== BUS_HELLO
)
412 bus
->state
= BUS_RUNNING
;
417 static int bus_send_hello(sd_bus
*bus
) {
418 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
423 if (!bus
->bus_client
|| bus
->is_kernel
)
426 r
= sd_bus_message_new_method_call(
429 "org.freedesktop.DBus",
430 "/org/freedesktop/DBus",
431 "org.freedesktop.DBus",
436 return sd_bus_call_async(bus
, NULL
, m
, hello_callback
, NULL
, 0);
439 int bus_start_running(sd_bus
*bus
) {
442 if (bus
->bus_client
&& !bus
->is_kernel
) {
443 bus
->state
= BUS_HELLO
;
447 bus
->state
= BUS_RUNNING
;
451 static int parse_address_key(const char **p
, const char *key
, char **value
) {
452 size_t l
, n
= 0, allocated
= 0;
462 if (strncmp(*p
, key
, l
) != 0)
475 while (*a
!= ';' && *a
!= ',' && *a
!= 0) {
493 c
= (char) ((x
<< 4) | y
);
500 if (!GREEDY_REALLOC(r
, allocated
, n
+ 2))
524 static void skip_address_key(const char **p
) {
528 *p
+= strcspn(*p
, ",");
534 static int parse_unix_address(sd_bus
*b
, const char **p
, char **guid
) {
535 _cleanup_free_
char *path
= NULL
, *abstract
= NULL
;
544 while (**p
!= 0 && **p
!= ';') {
545 r
= parse_address_key(p
, "guid", guid
);
551 r
= parse_address_key(p
, "path", &path
);
557 r
= parse_address_key(p
, "abstract", &abstract
);
566 if (!path
&& !abstract
)
569 if (path
&& abstract
)
574 if (l
> sizeof(b
->sockaddr
.un
.sun_path
))
577 b
->sockaddr
.un
.sun_family
= AF_UNIX
;
578 strncpy(b
->sockaddr
.un
.sun_path
, path
, sizeof(b
->sockaddr
.un
.sun_path
));
579 b
->sockaddr_size
= offsetof(struct sockaddr_un
, sun_path
) + l
;
580 } else if (abstract
) {
581 l
= strlen(abstract
);
582 if (l
> sizeof(b
->sockaddr
.un
.sun_path
) - 1)
585 b
->sockaddr
.un
.sun_family
= AF_UNIX
;
586 b
->sockaddr
.un
.sun_path
[0] = 0;
587 strncpy(b
->sockaddr
.un
.sun_path
+1, abstract
, sizeof(b
->sockaddr
.un
.sun_path
)-1);
588 b
->sockaddr_size
= offsetof(struct sockaddr_un
, sun_path
) + 1 + l
;
596 static int parse_tcp_address(sd_bus
*b
, const char **p
, char **guid
) {
597 _cleanup_free_
char *host
= NULL
, *port
= NULL
, *family
= NULL
;
599 struct addrinfo
*result
, hints
= {
600 .ai_socktype
= SOCK_STREAM
,
601 .ai_flags
= AI_ADDRCONFIG
,
609 while (**p
!= 0 && **p
!= ';') {
610 r
= parse_address_key(p
, "guid", guid
);
616 r
= parse_address_key(p
, "host", &host
);
622 r
= parse_address_key(p
, "port", &port
);
628 r
= parse_address_key(p
, "family", &family
);
641 if (streq(family
, "ipv4"))
642 hints
.ai_family
= AF_INET
;
643 else if (streq(family
, "ipv6"))
644 hints
.ai_family
= AF_INET6
;
649 r
= getaddrinfo(host
, port
, &hints
, &result
);
653 return -EADDRNOTAVAIL
;
655 memcpy(&b
->sockaddr
, result
->ai_addr
, result
->ai_addrlen
);
656 b
->sockaddr_size
= result
->ai_addrlen
;
658 freeaddrinfo(result
);
665 static int parse_exec_address(sd_bus
*b
, const char **p
, char **guid
) {
667 unsigned n_argv
= 0, j
;
669 size_t allocated
= 0;
677 while (**p
!= 0 && **p
!= ';') {
678 r
= parse_address_key(p
, "guid", guid
);
684 r
= parse_address_key(p
, "path", &path
);
690 if (startswith(*p
, "argv")) {
694 ul
= strtoul(*p
+ 4, (char**) p
, 10);
695 if (errno
> 0 || **p
!= '=' || ul
> 256) {
703 if (!GREEDY_REALLOC0(argv
, allocated
, ul
+ 2)) {
711 r
= parse_address_key(p
, NULL
, argv
+ ul
);
726 /* Make sure there are no holes in the array, with the
727 * exception of argv[0] */
728 for (j
= 1; j
< n_argv
; j
++)
734 if (argv
&& argv
[0] == NULL
) {
735 argv
[0] = strdup(path
);
750 for (j
= 0; j
< n_argv
; j
++)
758 static int parse_kernel_address(sd_bus
*b
, const char **p
, char **guid
) {
759 _cleanup_free_
char *path
= NULL
;
767 while (**p
!= 0 && **p
!= ';') {
768 r
= parse_address_key(p
, "guid", guid
);
774 r
= parse_address_key(p
, "path", &path
);
795 static int parse_container_unix_address(sd_bus
*b
, const char **p
, char **guid
) {
796 _cleanup_free_
char *machine
= NULL
, *pid
= NULL
;
804 while (**p
!= 0 && **p
!= ';') {
805 r
= parse_address_key(p
, "guid", guid
);
811 r
= parse_address_key(p
, "machine", &machine
);
817 r
= parse_address_key(p
, "pid", &pid
);
826 if (!machine
== !pid
)
830 if (!machine_name_is_valid(machine
))
834 b
->machine
= machine
;
837 b
->machine
= mfree(b
->machine
);
841 r
= parse_pid(pid
, &b
->nspid
);
847 b
->sockaddr
.un
.sun_family
= AF_UNIX
;
848 strncpy(b
->sockaddr
.un
.sun_path
, "/var/run/dbus/system_bus_socket", sizeof(b
->sockaddr
.un
.sun_path
));
849 b
->sockaddr_size
= SOCKADDR_UN_LEN(b
->sockaddr
.un
);
855 static int parse_container_kernel_address(sd_bus
*b
, const char **p
, char **guid
) {
856 _cleanup_free_
char *machine
= NULL
, *pid
= NULL
;
864 while (**p
!= 0 && **p
!= ';') {
865 r
= parse_address_key(p
, "guid", guid
);
871 r
= parse_address_key(p
, "machine", &machine
);
877 r
= parse_address_key(p
, "pid", &pid
);
886 if (!machine
== !pid
)
890 if (!machine_name_is_valid(machine
))
894 b
->machine
= machine
;
897 b
->machine
= mfree(b
->machine
);
901 r
= parse_pid(pid
, &b
->nspid
);
907 r
= free_and_strdup(&b
->kernel
, "/sys/fs/kdbus/0-system/bus");
916 static void bus_reset_parsed_address(sd_bus
*b
) {
920 b
->sockaddr_size
= 0;
921 b
->exec_argv
= strv_free(b
->exec_argv
);
922 b
->exec_path
= mfree(b
->exec_path
);
923 b
->server_id
= SD_ID128_NULL
;
924 b
->kernel
= mfree(b
->kernel
);
925 b
->machine
= mfree(b
->machine
);
929 static int bus_parse_next_address(sd_bus
*b
) {
930 _cleanup_free_
char *guid
= NULL
;
938 if (b
->address
[b
->address_index
] == 0)
941 bus_reset_parsed_address(b
);
943 a
= b
->address
+ b
->address_index
;
952 if (startswith(a
, "unix:")) {
955 r
= parse_unix_address(b
, &a
, &guid
);
960 } else if (startswith(a
, "tcp:")) {
963 r
= parse_tcp_address(b
, &a
, &guid
);
969 } else if (startswith(a
, "unixexec:")) {
972 r
= parse_exec_address(b
, &a
, &guid
);
978 } else if (startswith(a
, "kernel:")) {
981 r
= parse_kernel_address(b
, &a
, &guid
);
986 } else if (startswith(a
, "x-machine-unix:")) {
989 r
= parse_container_unix_address(b
, &a
, &guid
);
994 } else if (startswith(a
, "x-machine-kernel:")) {
997 r
= parse_container_kernel_address(b
, &a
, &guid
);
1010 r
= sd_id128_from_string(guid
, &b
->server_id
);
1015 b
->address_index
= a
- b
->address
;
1019 static int bus_start_address(sd_bus
*b
) {
1020 bool container_kdbus_available
= false;
1021 bool kdbus_available
= false;
1027 bool skipped
= false;
1032 * Usually, if you provide multiple different bus-addresses, we
1033 * try all of them in order. We use the first one that
1034 * succeeds. However, if you mix kernel and unix addresses, we
1035 * never try unix-addresses if a previous kernel address was
1036 * tried and kdbus was available. This is required to prevent
1037 * clients to fallback to the bus-proxy if kdbus is available
1038 * but failed (eg., too many connections).
1042 r
= bus_socket_exec(b
);
1043 else if ((b
->nspid
> 0 || b
->machine
) && b
->kernel
) {
1044 r
= bus_container_connect_kernel(b
);
1045 if (r
< 0 && !IN_SET(r
, -ENOENT
, -ESOCKTNOSUPPORT
))
1046 container_kdbus_available
= true;
1048 } else if ((b
->nspid
> 0 || b
->machine
) && b
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
) {
1049 if (!container_kdbus_available
)
1050 r
= bus_container_connect_socket(b
);
1054 } else if (b
->kernel
) {
1055 r
= bus_kernel_connect(b
);
1056 if (r
< 0 && !IN_SET(r
, -ENOENT
, -ESOCKTNOSUPPORT
))
1057 kdbus_available
= true;
1059 } else if (b
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
) {
1060 if (!kdbus_available
)
1061 r
= bus_socket_connect(b
);
1069 r
= attach_io_events(b
);
1074 b
->last_connect_error
= -r
;
1077 r
= bus_parse_next_address(b
);
1081 return b
->last_connect_error
? -b
->last_connect_error
: -ECONNREFUSED
;
1085 int bus_next_address(sd_bus
*b
) {
1088 bus_reset_parsed_address(b
);
1089 return bus_start_address(b
);
1092 static int bus_start_fd(sd_bus
*b
) {
1097 assert(b
->input_fd
>= 0);
1098 assert(b
->output_fd
>= 0);
1100 r
= fd_nonblock(b
->input_fd
, true);
1104 r
= fd_cloexec(b
->input_fd
, true);
1108 if (b
->input_fd
!= b
->output_fd
) {
1109 r
= fd_nonblock(b
->output_fd
, true);
1113 r
= fd_cloexec(b
->output_fd
, true);
1118 if (fstat(b
->input_fd
, &st
) < 0)
1121 if (S_ISCHR(b
->input_fd
))
1122 return bus_kernel_take_fd(b
);
1124 return bus_socket_take_fd(b
);
1127 _public_
int sd_bus_start(sd_bus
*bus
) {
1130 assert_return(bus
, -EINVAL
);
1131 assert_return(bus
->state
== BUS_UNSET
, -EPERM
);
1132 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1134 bus
->state
= BUS_OPENING
;
1136 if (bus
->is_server
&& bus
->bus_client
)
1139 if (bus
->input_fd
>= 0)
1140 r
= bus_start_fd(bus
);
1141 else if (bus
->address
|| bus
->sockaddr
.sa
.sa_family
!= AF_UNSPEC
|| bus
->exec_path
|| bus
->kernel
|| bus
->machine
)
1142 r
= bus_start_address(bus
);
1151 return bus_send_hello(bus
);
1154 _public_
int sd_bus_open(sd_bus
**ret
) {
1159 assert_return(ret
, -EINVAL
);
1161 /* Let's connect to the starter bus if it is set, and
1162 * otherwise to the bus that is appropropriate for the scope
1163 * we are running in */
1165 e
= secure_getenv("DBUS_STARTER_BUS_TYPE");
1167 if (streq(e
, "system"))
1168 return sd_bus_open_system(ret
);
1169 else if (STR_IN_SET(e
, "session", "user"))
1170 return sd_bus_open_user(ret
);
1173 e
= secure_getenv("DBUS_STARTER_ADDRESS");
1175 if (cg_pid_get_owner_uid(0, NULL
) >= 0)
1176 return sd_bus_open_user(ret
);
1178 return sd_bus_open_system(ret
);
1185 r
= sd_bus_set_address(b
, e
);
1189 b
->bus_client
= true;
1191 /* We don't know whether the bus is trusted or not, so better
1192 * be safe, and authenticate everything */
1194 b
->is_local
= false;
1195 b
->attach_flags
|= KDBUS_ATTACH_CAPS
| KDBUS_ATTACH_CREDS
;
1196 b
->creds_mask
|= SD_BUS_CREDS_UID
| SD_BUS_CREDS_EUID
| SD_BUS_CREDS_EFFECTIVE_CAPS
;
1198 r
= sd_bus_start(b
);
1210 int bus_set_address_system(sd_bus
*b
) {
1214 e
= secure_getenv("DBUS_SYSTEM_BUS_ADDRESS");
1216 return sd_bus_set_address(b
, e
);
1218 return sd_bus_set_address(b
, DEFAULT_SYSTEM_BUS_ADDRESS
);
1221 _public_
int sd_bus_open_system(sd_bus
**ret
) {
1225 assert_return(ret
, -EINVAL
);
1231 r
= bus_set_address_system(b
);
1235 b
->bus_client
= true;
1236 b
->is_system
= true;
1238 /* Let's do per-method access control on the system bus. We
1239 * need the caller's UID and capability set for that. */
1241 b
->attach_flags
|= KDBUS_ATTACH_CAPS
| KDBUS_ATTACH_CREDS
;
1242 b
->creds_mask
|= SD_BUS_CREDS_UID
| SD_BUS_CREDS_EUID
| SD_BUS_CREDS_EFFECTIVE_CAPS
;
1245 r
= sd_bus_start(b
);
1257 int bus_set_address_user(sd_bus
*b
) {
1264 e
= secure_getenv("DBUS_SESSION_BUS_ADDRESS");
1266 return sd_bus_set_address(b
, e
);
1268 r
= cg_pid_get_owner_uid(0, &uid
);
1272 e
= secure_getenv("XDG_RUNTIME_DIR");
1274 _cleanup_free_
char *ee
= NULL
;
1276 ee
= bus_address_escape(e
);
1280 (void) asprintf(&b
->address
, KERNEL_USER_BUS_ADDRESS_FMT
";" UNIX_USER_BUS_ADDRESS_FMT
, uid
, ee
);
1282 (void) asprintf(&b
->address
, KERNEL_USER_BUS_ADDRESS_FMT
, uid
);
1290 _public_
int sd_bus_open_user(sd_bus
**ret
) {
1294 assert_return(ret
, -EINVAL
);
1300 r
= bus_set_address_user(b
);
1304 b
->bus_client
= true;
1307 /* We don't do any per-method access control on the user
1312 r
= sd_bus_start(b
);
1324 int bus_set_address_system_remote(sd_bus
*b
, const char *host
) {
1325 _cleanup_free_
char *e
= NULL
;
1326 char *m
= NULL
, *c
= NULL
;
1331 /* Let's see if we shall enter some container */
1332 m
= strchr(host
, ':');
1336 /* Let's make sure this is not a port of some kind,
1337 * and is a valid machine name. */
1338 if (!in_charset(m
, "0123456789") && machine_name_is_valid(m
)) {
1341 /* Cut out the host part */
1342 t
= strndupa(host
, m
- host
- 1);
1343 e
= bus_address_escape(t
);
1347 c
= strjoina(",argv4=--machine=", m
);
1352 e
= bus_address_escape(host
);
1357 b
->address
= strjoin("unixexec:path=ssh,argv1=-xT,argv2=", e
, ",argv3=systemd-stdio-bridge", c
);
1364 _public_
int sd_bus_open_system_remote(sd_bus
**ret
, const char *host
) {
1368 assert_return(host
, -EINVAL
);
1369 assert_return(ret
, -EINVAL
);
1371 r
= sd_bus_new(&bus
);
1375 r
= bus_set_address_system_remote(bus
, host
);
1379 bus
->bus_client
= true;
1380 bus
->trusted
= false;
1381 bus
->is_system
= true;
1382 bus
->is_local
= false;
1384 r
= sd_bus_start(bus
);
1396 int bus_set_address_system_machine(sd_bus
*b
, const char *machine
) {
1397 _cleanup_free_
char *e
= NULL
;
1402 e
= bus_address_escape(machine
);
1406 b
->address
= strjoin("x-machine-kernel:machine=", e
, ";x-machine-unix:machine=", e
);
1413 _public_
int sd_bus_open_system_machine(sd_bus
**ret
, const char *machine
) {
1417 assert_return(machine
, -EINVAL
);
1418 assert_return(ret
, -EINVAL
);
1419 assert_return(machine_name_is_valid(machine
), -EINVAL
);
1421 r
= sd_bus_new(&bus
);
1425 r
= bus_set_address_system_machine(bus
, machine
);
1429 bus
->bus_client
= true;
1430 bus
->trusted
= false;
1431 bus
->is_system
= true;
1432 bus
->is_local
= false;
1434 r
= sd_bus_start(bus
);
1446 _public_
void sd_bus_close(sd_bus
*bus
) {
1450 if (bus
->state
== BUS_CLOSED
)
1452 if (bus_pid_changed(bus
))
1455 bus
->state
= BUS_CLOSED
;
1457 sd_bus_detach_event(bus
);
1459 /* Drop all queued messages so that they drop references to
1460 * the bus object and the bus may be freed */
1461 bus_reset_queues(bus
);
1463 if (!bus
->is_kernel
)
1466 /* We'll leave the fd open in case this is a kernel bus, since
1467 * there might still be memblocks around that reference this
1468 * bus, and they might need to invoke the KDBUS_CMD_FREE
1469 * ioctl on the fd when they are freed. */
1472 _public_ sd_bus
* sd_bus_flush_close_unref(sd_bus
*bus
) {
1480 return sd_bus_unref(bus
);
1483 static void bus_enter_closing(sd_bus
*bus
) {
1486 if (bus
->state
!= BUS_OPENING
&&
1487 bus
->state
!= BUS_AUTHENTICATING
&&
1488 bus
->state
!= BUS_HELLO
&&
1489 bus
->state
!= BUS_RUNNING
)
1492 bus
->state
= BUS_CLOSING
;
1495 _public_ sd_bus
*sd_bus_ref(sd_bus
*bus
) {
1500 assert_se(REFCNT_INC(bus
->n_ref
) >= 2);
1505 _public_ sd_bus
*sd_bus_unref(sd_bus
*bus
) {
1511 i
= REFCNT_DEC(bus
->n_ref
);
1519 _public_
int sd_bus_is_open(sd_bus
*bus
) {
1521 assert_return(bus
, -EINVAL
);
1522 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1524 return BUS_IS_OPEN(bus
->state
);
1527 _public_
int sd_bus_can_send(sd_bus
*bus
, char type
) {
1530 assert_return(bus
, -EINVAL
);
1531 assert_return(bus
->state
!= BUS_UNSET
, -ENOTCONN
);
1532 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1534 if (bus
->hello_flags
& KDBUS_HELLO_MONITOR
)
1537 if (type
== SD_BUS_TYPE_UNIX_FD
) {
1538 if (!(bus
->hello_flags
& KDBUS_HELLO_ACCEPT_FD
))
1541 r
= bus_ensure_running(bus
);
1545 return bus
->can_fds
;
1548 return bus_type_is_valid(type
);
1551 _public_
int sd_bus_get_bus_id(sd_bus
*bus
, sd_id128_t
*id
) {
1554 assert_return(bus
, -EINVAL
);
1555 assert_return(id
, -EINVAL
);
1556 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1558 r
= bus_ensure_running(bus
);
1562 *id
= bus
->server_id
;
1566 static int bus_seal_message(sd_bus
*b
, sd_bus_message
*m
, usec_t timeout
) {
1571 /* If we copy the same message to multiple
1572 * destinations, avoid using the same cookie
1574 b
->cookie
= MAX(b
->cookie
, BUS_MESSAGE_COOKIE(m
));
1579 timeout
= BUS_DEFAULT_TIMEOUT
;
1581 return bus_message_seal(m
, ++b
->cookie
, timeout
);
1584 static int bus_remarshal_message(sd_bus
*b
, sd_bus_message
**m
) {
1585 bool remarshal
= false;
1589 /* wrong packet version */
1590 if (b
->message_version
!= 0 && b
->message_version
!= (*m
)->header
->version
)
1593 /* wrong packet endianness */
1594 if (b
->message_endian
!= 0 && b
->message_endian
!= (*m
)->header
->endian
)
1597 /* TODO: kdbus-messages received from the kernel contain data which is
1598 * not allowed to be passed to KDBUS_CMD_SEND. Therefore, we have to
1599 * force remarshaling of the message. Technically, we could just
1600 * recreate the kdbus message, but that is non-trivial as other parts of
1601 * the message refer to m->kdbus already. This should be fixed! */
1602 if ((*m
)->kdbus
&& (*m
)->release_kdbus
)
1605 return remarshal
? bus_message_remarshal(b
, m
) : 0;
1608 int bus_seal_synthetic_message(sd_bus
*b
, sd_bus_message
*m
) {
1612 /* Fake some timestamps, if they were requested, and not
1613 * already initialized */
1614 if (b
->attach_flags
& KDBUS_ATTACH_TIMESTAMP
) {
1615 if (m
->realtime
<= 0)
1616 m
->realtime
= now(CLOCK_REALTIME
);
1618 if (m
->monotonic
<= 0)
1619 m
->monotonic
= now(CLOCK_MONOTONIC
);
1622 /* The bus specification says the serial number cannot be 0,
1623 * hence let's fill something in for synthetic messages. Since
1624 * synthetic messages might have a fake sender and we don't
1625 * want to interfere with the real sender's serial numbers we
1626 * pick a fixed, artificial one. We use (uint32_t) -1 rather
1627 * than (uint64_t) -1 since dbus1 only had 32bit identifiers,
1628 * even though kdbus can do 64bit. */
1629 return bus_message_seal(m
, 0xFFFFFFFFULL
, 0);
1632 static int bus_write_message(sd_bus
*bus
, sd_bus_message
*m
, bool hint_sync_call
, size_t *idx
) {
1639 r
= bus_kernel_write_message(bus
, m
, hint_sync_call
);
1641 r
= bus_socket_write_message(bus
, m
, idx
);
1646 if (bus
->is_kernel
|| *idx
>= BUS_MESSAGE_SIZE(m
))
1647 log_debug("Sent message type=%s sender=%s destination=%s object=%s interface=%s member=%s cookie=%" PRIu64
" reply_cookie=%" PRIu64
" error=%s",
1648 bus_message_type_to_string(m
->header
->type
),
1649 strna(sd_bus_message_get_sender(m
)),
1650 strna(sd_bus_message_get_destination(m
)),
1651 strna(sd_bus_message_get_path(m
)),
1652 strna(sd_bus_message_get_interface(m
)),
1653 strna(sd_bus_message_get_member(m
)),
1654 BUS_MESSAGE_COOKIE(m
),
1656 strna(m
->error
.message
));
1661 static int dispatch_wqueue(sd_bus
*bus
) {
1665 assert(bus
->state
== BUS_RUNNING
|| bus
->state
== BUS_HELLO
);
1667 while (bus
->wqueue_size
> 0) {
1669 r
= bus_write_message(bus
, bus
->wqueue
[0], false, &bus
->windex
);
1673 /* Didn't do anything this time */
1675 else if (bus
->is_kernel
|| bus
->windex
>= BUS_MESSAGE_SIZE(bus
->wqueue
[0])) {
1676 /* Fully written. Let's drop the entry from
1679 * This isn't particularly optimized, but
1680 * well, this is supposed to be our worst-case
1681 * buffer only, and the socket buffer is
1682 * supposed to be our primary buffer, and if
1683 * it got full, then all bets are off
1687 sd_bus_message_unref(bus
->wqueue
[0]);
1688 memmove(bus
->wqueue
, bus
->wqueue
+ 1, sizeof(sd_bus_message
*) * bus
->wqueue_size
);
1698 static int bus_read_message(sd_bus
*bus
, bool hint_priority
, int64_t priority
) {
1702 return bus_kernel_read_message(bus
, hint_priority
, priority
);
1704 return bus_socket_read_message(bus
);
1707 int bus_rqueue_make_room(sd_bus
*bus
) {
1710 if (bus
->rqueue_size
>= BUS_RQUEUE_MAX
)
1713 if (!GREEDY_REALLOC(bus
->rqueue
, bus
->rqueue_allocated
, bus
->rqueue_size
+ 1))
1719 static int dispatch_rqueue(sd_bus
*bus
, bool hint_priority
, int64_t priority
, sd_bus_message
**m
) {
1724 assert(bus
->state
== BUS_RUNNING
|| bus
->state
== BUS_HELLO
);
1726 /* Note that the priority logic is only available on kdbus,
1727 * where the rqueue is unused. We check the rqueue here
1728 * anyway, because it's simple... */
1731 if (bus
->rqueue_size
> 0) {
1732 /* Dispatch a queued message */
1734 *m
= bus
->rqueue
[0];
1736 memmove(bus
->rqueue
, bus
->rqueue
+ 1, sizeof(sd_bus_message
*) * bus
->rqueue_size
);
1740 /* Try to read a new message */
1741 r
= bus_read_message(bus
, hint_priority
, priority
);
1751 static int bus_send_internal(sd_bus
*bus
, sd_bus_message
*_m
, uint64_t *cookie
, bool hint_sync_call
) {
1752 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= sd_bus_message_ref(_m
);
1755 assert_return(m
, -EINVAL
);
1760 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1761 assert_return(!bus
->is_kernel
|| !(bus
->hello_flags
& KDBUS_HELLO_MONITOR
), -EROFS
);
1763 if (!BUS_IS_OPEN(bus
->state
))
1767 r
= sd_bus_can_send(bus
, SD_BUS_TYPE_UNIX_FD
);
1774 /* If the cookie number isn't kept, then we know that no reply
1776 if (!cookie
&& !m
->sealed
)
1777 m
->header
->flags
|= BUS_MESSAGE_NO_REPLY_EXPECTED
;
1779 r
= bus_seal_message(bus
, m
, 0);
1783 /* Remarshall if we have to. This will possibly unref the
1784 * message and place a replacement in m */
1785 r
= bus_remarshal_message(bus
, &m
);
1789 /* If this is a reply and no reply was requested, then let's
1790 * suppress this, if we can */
1794 if ((bus
->state
== BUS_RUNNING
|| bus
->state
== BUS_HELLO
) && bus
->wqueue_size
<= 0) {
1797 r
= bus_write_message(bus
, m
, hint_sync_call
, &idx
);
1799 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
1800 bus_enter_closing(bus
);
1807 if (!bus
->is_kernel
&& idx
< BUS_MESSAGE_SIZE(m
)) {
1808 /* Wasn't fully written. So let's remember how
1809 * much was written. Note that the first entry
1810 * of the wqueue array is always allocated so
1811 * that we always can remember how much was
1813 bus
->wqueue
[0] = sd_bus_message_ref(m
);
1814 bus
->wqueue_size
= 1;
1819 /* Just append it to the queue. */
1821 if (bus
->wqueue_size
>= BUS_WQUEUE_MAX
)
1824 if (!GREEDY_REALLOC(bus
->wqueue
, bus
->wqueue_allocated
, bus
->wqueue_size
+ 1))
1827 bus
->wqueue
[bus
->wqueue_size
++] = sd_bus_message_ref(m
);
1832 *cookie
= BUS_MESSAGE_COOKIE(m
);
1837 _public_
int sd_bus_send(sd_bus
*bus
, sd_bus_message
*m
, uint64_t *cookie
) {
1838 return bus_send_internal(bus
, m
, cookie
, false);
1841 _public_
int sd_bus_send_to(sd_bus
*bus
, sd_bus_message
*m
, const char *destination
, uint64_t *cookie
) {
1844 assert_return(m
, -EINVAL
);
1849 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1851 if (!BUS_IS_OPEN(bus
->state
))
1854 if (!streq_ptr(m
->destination
, destination
)) {
1859 r
= sd_bus_message_set_destination(m
, destination
);
1864 return sd_bus_send(bus
, m
, cookie
);
1867 static usec_t
calc_elapse(uint64_t usec
) {
1868 if (usec
== (uint64_t) -1)
1871 return now(CLOCK_MONOTONIC
) + usec
;
1874 static int timeout_compare(const void *a
, const void *b
) {
1875 const struct reply_callback
*x
= a
, *y
= b
;
1877 if (x
->timeout
!= 0 && y
->timeout
== 0)
1880 if (x
->timeout
== 0 && y
->timeout
!= 0)
1883 if (x
->timeout
< y
->timeout
)
1886 if (x
->timeout
> y
->timeout
)
1892 _public_
int sd_bus_call_async(
1896 sd_bus_message_handler_t callback
,
1900 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= sd_bus_message_ref(_m
);
1901 _cleanup_(sd_bus_slot_unrefp
) sd_bus_slot
*s
= NULL
;
1904 assert_return(m
, -EINVAL
);
1905 assert_return(m
->header
->type
== SD_BUS_MESSAGE_METHOD_CALL
, -EINVAL
);
1906 assert_return(!(m
->header
->flags
& BUS_MESSAGE_NO_REPLY_EXPECTED
), -EINVAL
);
1907 assert_return(callback
, -EINVAL
);
1912 assert_return(!bus_pid_changed(bus
), -ECHILD
);
1913 assert_return(!bus
->is_kernel
|| !(bus
->hello_flags
& KDBUS_HELLO_MONITOR
), -EROFS
);
1915 if (!BUS_IS_OPEN(bus
->state
))
1918 r
= ordered_hashmap_ensure_allocated(&bus
->reply_callbacks
, &uint64_hash_ops
);
1922 r
= prioq_ensure_allocated(&bus
->reply_callbacks_prioq
, timeout_compare
);
1926 r
= bus_seal_message(bus
, m
, usec
);
1930 r
= bus_remarshal_message(bus
, &m
);
1934 s
= bus_slot_allocate(bus
, !slot
, BUS_REPLY_CALLBACK
, sizeof(struct reply_callback
), userdata
);
1938 s
->reply_callback
.callback
= callback
;
1940 s
->reply_callback
.cookie
= BUS_MESSAGE_COOKIE(m
);
1941 r
= ordered_hashmap_put(bus
->reply_callbacks
, &s
->reply_callback
.cookie
, &s
->reply_callback
);
1943 s
->reply_callback
.cookie
= 0;
1947 s
->reply_callback
.timeout
= calc_elapse(m
->timeout
);
1948 if (s
->reply_callback
.timeout
!= 0) {
1949 r
= prioq_put(bus
->reply_callbacks_prioq
, &s
->reply_callback
, &s
->reply_callback
.prioq_idx
);
1951 s
->reply_callback
.timeout
= 0;
1956 r
= sd_bus_send(bus
, m
, &s
->reply_callback
.cookie
);
1967 int bus_ensure_running(sd_bus
*bus
) {
1972 if (bus
->state
== BUS_UNSET
|| bus
->state
== BUS_CLOSED
|| bus
->state
== BUS_CLOSING
)
1974 if (bus
->state
== BUS_RUNNING
)
1978 r
= sd_bus_process(bus
, NULL
);
1981 if (bus
->state
== BUS_RUNNING
)
1986 r
= sd_bus_wait(bus
, (uint64_t) -1);
1992 _public_
int sd_bus_call(
1996 sd_bus_error
*error
,
1997 sd_bus_message
**reply
) {
1999 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= sd_bus_message_ref(_m
);
2005 bus_assert_return(m
, -EINVAL
, error
);
2006 bus_assert_return(m
->header
->type
== SD_BUS_MESSAGE_METHOD_CALL
, -EINVAL
, error
);
2007 bus_assert_return(!(m
->header
->flags
& BUS_MESSAGE_NO_REPLY_EXPECTED
), -EINVAL
, error
);
2008 bus_assert_return(!bus_error_is_dirty(error
), -EINVAL
, error
);
2013 bus_assert_return(!bus_pid_changed(bus
), -ECHILD
, error
);
2014 bus_assert_return(!bus
->is_kernel
|| !(bus
->hello_flags
& KDBUS_HELLO_MONITOR
), -EROFS
, error
);
2016 if (!BUS_IS_OPEN(bus
->state
)) {
2021 r
= bus_ensure_running(bus
);
2025 i
= bus
->rqueue_size
;
2027 r
= bus_seal_message(bus
, m
, usec
);
2031 r
= bus_remarshal_message(bus
, &m
);
2035 r
= bus_send_internal(bus
, m
, &cookie
, true);
2039 timeout
= calc_elapse(m
->timeout
);
2044 while (i
< bus
->rqueue_size
) {
2045 sd_bus_message
*incoming
= NULL
;
2047 incoming
= bus
->rqueue
[i
];
2049 if (incoming
->reply_cookie
== cookie
) {
2050 /* Found a match! */
2052 memmove(bus
->rqueue
+ i
, bus
->rqueue
+ i
+ 1, sizeof(sd_bus_message
*) * (bus
->rqueue_size
- i
- 1));
2054 log_debug_bus_message(incoming
);
2056 if (incoming
->header
->type
== SD_BUS_MESSAGE_METHOD_RETURN
) {
2058 if (incoming
->n_fds
<= 0 || (bus
->hello_flags
& KDBUS_HELLO_ACCEPT_FD
)) {
2062 sd_bus_message_unref(incoming
);
2067 r
= sd_bus_error_setf(error
, SD_BUS_ERROR_INCONSISTENT_MESSAGE
, "Reply message contained file descriptors which I couldn't accept. Sorry.");
2068 sd_bus_message_unref(incoming
);
2071 } else if (incoming
->header
->type
== SD_BUS_MESSAGE_METHOD_ERROR
) {
2072 r
= sd_bus_error_copy(error
, &incoming
->error
);
2073 sd_bus_message_unref(incoming
);
2080 } else if (BUS_MESSAGE_COOKIE(incoming
) == cookie
&&
2083 streq(bus
->unique_name
, incoming
->sender
)) {
2085 memmove(bus
->rqueue
+ i
, bus
->rqueue
+ i
+ 1, sizeof(sd_bus_message
*) * (bus
->rqueue_size
- i
- 1));
2088 /* Our own message? Somebody is trying
2089 * to send its own client a message,
2090 * let's not dead-lock, let's fail
2093 sd_bus_message_unref(incoming
);
2098 /* Try to read more, right-away */
2102 r
= bus_read_message(bus
, false, 0);
2104 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
2105 bus_enter_closing(bus
);
2117 n
= now(CLOCK_MONOTONIC
);
2125 left
= (uint64_t) -1;
2127 r
= bus_poll(bus
, true, left
);
2135 r
= dispatch_wqueue(bus
);
2137 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
2138 bus_enter_closing(bus
);
2147 return sd_bus_error_set_errno(error
, r
);
2150 _public_
int sd_bus_get_fd(sd_bus
*bus
) {
2152 assert_return(bus
, -EINVAL
);
2153 assert_return(bus
->input_fd
== bus
->output_fd
, -EPERM
);
2154 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2156 return bus
->input_fd
;
2159 _public_
int sd_bus_get_events(sd_bus
*bus
) {
2162 assert_return(bus
, -EINVAL
);
2163 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2165 if (!BUS_IS_OPEN(bus
->state
) && bus
->state
!= BUS_CLOSING
)
2168 if (bus
->state
== BUS_OPENING
)
2170 else if (bus
->state
== BUS_AUTHENTICATING
) {
2172 if (bus_socket_auth_needs_write(bus
))
2177 } else if (bus
->state
== BUS_RUNNING
|| bus
->state
== BUS_HELLO
) {
2178 if (bus
->rqueue_size
<= 0)
2180 if (bus
->wqueue_size
> 0)
2187 _public_
int sd_bus_get_timeout(sd_bus
*bus
, uint64_t *timeout_usec
) {
2188 struct reply_callback
*c
;
2190 assert_return(bus
, -EINVAL
);
2191 assert_return(timeout_usec
, -EINVAL
);
2192 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2194 if (!BUS_IS_OPEN(bus
->state
) && bus
->state
!= BUS_CLOSING
)
2197 if (bus
->track_queue
) {
2202 if (bus
->state
== BUS_CLOSING
) {
2207 if (bus
->state
== BUS_AUTHENTICATING
) {
2208 *timeout_usec
= bus
->auth_timeout
;
2212 if (bus
->state
!= BUS_RUNNING
&& bus
->state
!= BUS_HELLO
) {
2213 *timeout_usec
= (uint64_t) -1;
2217 if (bus
->rqueue_size
> 0) {
2222 c
= prioq_peek(bus
->reply_callbacks_prioq
);
2224 *timeout_usec
= (uint64_t) -1;
2228 if (c
->timeout
== 0) {
2229 *timeout_usec
= (uint64_t) -1;
2233 *timeout_usec
= c
->timeout
;
2237 static int process_timeout(sd_bus
*bus
) {
2238 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2239 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
* m
= NULL
;
2240 struct reply_callback
*c
;
2247 c
= prioq_peek(bus
->reply_callbacks_prioq
);
2251 n
= now(CLOCK_MONOTONIC
);
2255 r
= bus_message_new_synthetic_error(
2258 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY
, "Method call timed out"),
2263 r
= bus_seal_synthetic_message(bus
, m
);
2267 assert_se(prioq_pop(bus
->reply_callbacks_prioq
) == c
);
2270 ordered_hashmap_remove(bus
->reply_callbacks
, &c
->cookie
);
2273 slot
= container_of(c
, sd_bus_slot
, reply_callback
);
2275 bus
->iteration_counter
++;
2277 bus
->current_message
= m
;
2278 bus
->current_slot
= sd_bus_slot_ref(slot
);
2279 bus
->current_handler
= c
->callback
;
2280 bus
->current_userdata
= slot
->userdata
;
2281 r
= c
->callback(m
, slot
->userdata
, &error_buffer
);
2282 bus
->current_userdata
= NULL
;
2283 bus
->current_handler
= NULL
;
2284 bus
->current_slot
= NULL
;
2285 bus
->current_message
= NULL
;
2287 if (slot
->floating
) {
2288 bus_slot_disconnect(slot
);
2289 sd_bus_slot_unref(slot
);
2292 sd_bus_slot_unref(slot
);
2294 return bus_maybe_reply_error(m
, r
, &error_buffer
);
2297 static int process_hello(sd_bus
*bus
, sd_bus_message
*m
) {
2301 if (bus
->state
!= BUS_HELLO
)
2304 /* Let's make sure the first message on the bus is the HELLO
2305 * reply. But note that we don't actually parse the message
2306 * here (we leave that to the usual handling), we just verify
2307 * we don't let any earlier msg through. */
2309 if (m
->header
->type
!= SD_BUS_MESSAGE_METHOD_RETURN
&&
2310 m
->header
->type
!= SD_BUS_MESSAGE_METHOD_ERROR
)
2313 if (m
->reply_cookie
!= 1)
2319 static int process_reply(sd_bus
*bus
, sd_bus_message
*m
) {
2320 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*synthetic_reply
= NULL
;
2321 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2322 struct reply_callback
*c
;
2329 if (m
->header
->type
!= SD_BUS_MESSAGE_METHOD_RETURN
&&
2330 m
->header
->type
!= SD_BUS_MESSAGE_METHOD_ERROR
)
2333 if (bus
->is_kernel
&& (bus
->hello_flags
& KDBUS_HELLO_MONITOR
))
2336 if (m
->destination
&& bus
->unique_name
&& !streq_ptr(m
->destination
, bus
->unique_name
))
2339 c
= ordered_hashmap_remove(bus
->reply_callbacks
, &m
->reply_cookie
);
2345 slot
= container_of(c
, sd_bus_slot
, reply_callback
);
2347 if (m
->n_fds
> 0 && !(bus
->hello_flags
& KDBUS_HELLO_ACCEPT_FD
)) {
2349 /* If the reply contained a file descriptor which we
2350 * didn't want we pass an error instead. */
2352 r
= bus_message_new_synthetic_error(
2355 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_INCONSISTENT_MESSAGE
, "Reply message contained file descriptor"),
2360 /* Copy over original timestamp */
2361 synthetic_reply
->realtime
= m
->realtime
;
2362 synthetic_reply
->monotonic
= m
->monotonic
;
2363 synthetic_reply
->seqnum
= m
->seqnum
;
2365 r
= bus_seal_synthetic_message(bus
, synthetic_reply
);
2369 m
= synthetic_reply
;
2371 r
= sd_bus_message_rewind(m
, true);
2376 if (c
->timeout
!= 0) {
2377 prioq_remove(bus
->reply_callbacks_prioq
, c
, &c
->prioq_idx
);
2381 bus
->current_slot
= sd_bus_slot_ref(slot
);
2382 bus
->current_handler
= c
->callback
;
2383 bus
->current_userdata
= slot
->userdata
;
2384 r
= c
->callback(m
, slot
->userdata
, &error_buffer
);
2385 bus
->current_userdata
= NULL
;
2386 bus
->current_handler
= NULL
;
2387 bus
->current_slot
= NULL
;
2389 if (slot
->floating
) {
2390 bus_slot_disconnect(slot
);
2391 sd_bus_slot_unref(slot
);
2394 sd_bus_slot_unref(slot
);
2396 return bus_maybe_reply_error(m
, r
, &error_buffer
);
2399 static int process_filter(sd_bus
*bus
, sd_bus_message
*m
) {
2400 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2401 struct filter_callback
*l
;
2408 bus
->filter_callbacks_modified
= false;
2410 LIST_FOREACH(callbacks
, l
, bus
->filter_callbacks
) {
2413 if (bus
->filter_callbacks_modified
)
2416 /* Don't run this more than once per iteration */
2417 if (l
->last_iteration
== bus
->iteration_counter
)
2420 l
->last_iteration
= bus
->iteration_counter
;
2422 r
= sd_bus_message_rewind(m
, true);
2426 slot
= container_of(l
, sd_bus_slot
, filter_callback
);
2428 bus
->current_slot
= sd_bus_slot_ref(slot
);
2429 bus
->current_handler
= l
->callback
;
2430 bus
->current_userdata
= slot
->userdata
;
2431 r
= l
->callback(m
, slot
->userdata
, &error_buffer
);
2432 bus
->current_userdata
= NULL
;
2433 bus
->current_handler
= NULL
;
2434 bus
->current_slot
= sd_bus_slot_unref(slot
);
2436 r
= bus_maybe_reply_error(m
, r
, &error_buffer
);
2442 } while (bus
->filter_callbacks_modified
);
2447 static int process_match(sd_bus
*bus
, sd_bus_message
*m
) {
2454 bus
->match_callbacks_modified
= false;
2456 r
= bus_match_run(bus
, &bus
->match_callbacks
, m
);
2460 } while (bus
->match_callbacks_modified
);
2465 static int process_builtin(sd_bus
*bus
, sd_bus_message
*m
) {
2466 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*reply
= NULL
;
2472 if (bus
->hello_flags
& KDBUS_HELLO_MONITOR
)
2475 if (bus
->manual_peer_interface
)
2478 if (m
->header
->type
!= SD_BUS_MESSAGE_METHOD_CALL
)
2481 if (!streq_ptr(m
->interface
, "org.freedesktop.DBus.Peer"))
2484 if (m
->header
->flags
& BUS_MESSAGE_NO_REPLY_EXPECTED
)
2487 if (streq_ptr(m
->member
, "Ping"))
2488 r
= sd_bus_message_new_method_return(m
, &reply
);
2489 else if (streq_ptr(m
->member
, "GetMachineId")) {
2493 r
= sd_id128_get_machine(&id
);
2497 r
= sd_bus_message_new_method_return(m
, &reply
);
2501 r
= sd_bus_message_append(reply
, "s", sd_id128_to_string(id
, sid
));
2503 r
= sd_bus_message_new_method_errorf(
2505 SD_BUS_ERROR_UNKNOWN_METHOD
,
2506 "Unknown method '%s' on interface '%s'.", m
->member
, m
->interface
);
2512 r
= sd_bus_send(bus
, reply
, NULL
);
2519 static int process_fd_check(sd_bus
*bus
, sd_bus_message
*m
) {
2523 /* If we got a message with a file descriptor which we didn't
2524 * want to accept, then let's drop it. How can this even
2525 * happen? For example, when the kernel queues a message into
2526 * an activatable names's queue which allows fds, and then is
2527 * delivered to us later even though we ourselves did not
2530 if (bus
->hello_flags
& KDBUS_HELLO_MONITOR
)
2536 if (bus
->hello_flags
& KDBUS_HELLO_ACCEPT_FD
)
2539 if (m
->header
->type
!= SD_BUS_MESSAGE_METHOD_CALL
)
2540 return 1; /* just eat it up */
2542 return sd_bus_reply_method_errorf(m
, SD_BUS_ERROR_INCONSISTENT_MESSAGE
, "Message contains file descriptors, which I cannot accept. Sorry.");
2545 static int process_message(sd_bus
*bus
, sd_bus_message
*m
) {
2551 bus
->current_message
= m
;
2552 bus
->iteration_counter
++;
2554 log_debug_bus_message(m
);
2556 r
= process_hello(bus
, m
);
2560 r
= process_reply(bus
, m
);
2564 r
= process_fd_check(bus
, m
);
2568 r
= process_filter(bus
, m
);
2572 r
= process_match(bus
, m
);
2576 r
= process_builtin(bus
, m
);
2580 r
= bus_process_object(bus
, m
);
2583 bus
->current_message
= NULL
;
2587 static int dispatch_track(sd_bus
*bus
) {
2590 if (!bus
->track_queue
)
2593 bus_track_dispatch(bus
->track_queue
);
2597 static int process_running(sd_bus
*bus
, bool hint_priority
, int64_t priority
, sd_bus_message
**ret
) {
2598 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
2602 assert(bus
->state
== BUS_RUNNING
|| bus
->state
== BUS_HELLO
);
2604 r
= process_timeout(bus
);
2608 r
= dispatch_wqueue(bus
);
2612 r
= dispatch_track(bus
);
2616 r
= dispatch_rqueue(bus
, hint_priority
, priority
, &m
);
2622 r
= process_message(bus
, m
);
2627 r
= sd_bus_message_rewind(m
, true);
2636 if (m
->header
->type
== SD_BUS_MESSAGE_METHOD_CALL
) {
2638 log_debug("Unprocessed message call sender=%s object=%s interface=%s member=%s",
2639 strna(sd_bus_message_get_sender(m
)),
2640 strna(sd_bus_message_get_path(m
)),
2641 strna(sd_bus_message_get_interface(m
)),
2642 strna(sd_bus_message_get_member(m
)));
2644 r
= sd_bus_reply_method_errorf(
2646 SD_BUS_ERROR_UNKNOWN_OBJECT
,
2647 "Unknown object '%s'.", m
->path
);
2661 static int bus_exit_now(sd_bus
*bus
) {
2664 /* Exit due to close, if this is requested. If this is bus object is attached to an event source, invokes
2665 * sd_event_exit(), otherwise invokes libc exit(). */
2667 if (bus
->exited
) /* did we already exit? */
2669 if (!bus
->exit_triggered
) /* was the exit condition triggered? */
2671 if (!bus
->exit_on_disconnect
) /* Shall we actually exit on disconnection? */
2674 bus
->exited
= true; /* never exit more than once */
2676 log_debug("Bus connection disconnected, exiting.");
2679 return sd_event_exit(bus
->event
, EXIT_FAILURE
);
2683 assert_not_reached("exit() didn't exit?");
2686 static int process_closing_reply_callback(sd_bus
*bus
, struct reply_callback
*c
) {
2687 _cleanup_(sd_bus_error_free
) sd_bus_error error_buffer
= SD_BUS_ERROR_NULL
;
2688 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
2695 r
= bus_message_new_synthetic_error(
2698 &SD_BUS_ERROR_MAKE_CONST(SD_BUS_ERROR_NO_REPLY
, "Connection terminated"),
2703 r
= bus_seal_synthetic_message(bus
, m
);
2707 if (c
->timeout
!= 0) {
2708 prioq_remove(bus
->reply_callbacks_prioq
, c
, &c
->prioq_idx
);
2712 ordered_hashmap_remove(bus
->reply_callbacks
, &c
->cookie
);
2715 slot
= container_of(c
, sd_bus_slot
, reply_callback
);
2717 bus
->iteration_counter
++;
2719 bus
->current_message
= m
;
2720 bus
->current_slot
= sd_bus_slot_ref(slot
);
2721 bus
->current_handler
= c
->callback
;
2722 bus
->current_userdata
= slot
->userdata
;
2723 r
= c
->callback(m
, slot
->userdata
, &error_buffer
);
2724 bus
->current_userdata
= NULL
;
2725 bus
->current_handler
= NULL
;
2726 bus
->current_slot
= NULL
;
2727 bus
->current_message
= NULL
;
2729 if (slot
->floating
) {
2730 bus_slot_disconnect(slot
);
2731 sd_bus_slot_unref(slot
);
2734 sd_bus_slot_unref(slot
);
2736 return bus_maybe_reply_error(m
, r
, &error_buffer
);
2739 static int process_closing(sd_bus
*bus
, sd_bus_message
**ret
) {
2740 _cleanup_(sd_bus_message_unrefp
) sd_bus_message
*m
= NULL
;
2741 struct reply_callback
*c
;
2745 assert(bus
->state
== BUS_CLOSING
);
2747 /* First, fail all outstanding method calls */
2748 c
= ordered_hashmap_first(bus
->reply_callbacks
);
2750 return process_closing_reply_callback(bus
, c
);
2752 /* Then, fake-drop all remaining bus tracking references */
2754 bus_track_close(bus
->tracks
);
2758 /* Then, synthesize a Disconnected message */
2759 r
= sd_bus_message_new_signal(
2762 "/org/freedesktop/DBus/Local",
2763 "org.freedesktop.DBus.Local",
2768 bus_message_set_sender_local(bus
, m
);
2770 r
= bus_seal_synthetic_message(bus
, m
);
2776 bus
->current_message
= m
;
2777 bus
->iteration_counter
++;
2779 r
= process_filter(bus
, m
);
2783 r
= process_match(bus
, m
);
2787 /* Nothing else to do, exit now, if the condition holds */
2788 bus
->exit_triggered
= true;
2789 (void) bus_exit_now(bus
);
2799 bus
->current_message
= NULL
;
2804 static int bus_process_internal(sd_bus
*bus
, bool hint_priority
, int64_t priority
, sd_bus_message
**ret
) {
2805 BUS_DONT_DESTROY(bus
);
2808 /* Returns 0 when we didn't do anything. This should cause the
2809 * caller to invoke sd_bus_wait() before returning the next
2810 * time. Returns > 0 when we did something, which possibly
2811 * means *ret is filled in with an unprocessed message. */
2813 assert_return(bus
, -EINVAL
);
2814 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2816 /* We don't allow recursively invoking sd_bus_process(). */
2817 assert_return(!bus
->current_message
, -EBUSY
);
2818 assert(!bus
->current_slot
);
2820 switch (bus
->state
) {
2829 r
= bus_socket_process_opening(bus
);
2830 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
2831 bus_enter_closing(bus
);
2839 case BUS_AUTHENTICATING
:
2840 r
= bus_socket_process_authenticating(bus
);
2841 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
2842 bus_enter_closing(bus
);
2854 r
= process_running(bus
, hint_priority
, priority
, ret
);
2855 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
2856 bus_enter_closing(bus
);
2866 return process_closing(bus
, ret
);
2869 assert_not_reached("Unknown state");
2872 _public_
int sd_bus_process(sd_bus
*bus
, sd_bus_message
**ret
) {
2873 return bus_process_internal(bus
, false, 0, ret
);
2876 _public_
int sd_bus_process_priority(sd_bus
*bus
, int64_t priority
, sd_bus_message
**ret
) {
2877 return bus_process_internal(bus
, true, priority
, ret
);
2880 static int bus_poll(sd_bus
*bus
, bool need_more
, uint64_t timeout_usec
) {
2881 struct pollfd p
[2] = {};
2884 usec_t m
= USEC_INFINITY
;
2888 if (bus
->state
== BUS_CLOSING
)
2891 if (!BUS_IS_OPEN(bus
->state
))
2894 e
= sd_bus_get_events(bus
);
2899 /* The caller really needs some more data, he doesn't
2900 * care about what's already read, or any timeouts
2901 * except its own. */
2905 /* The caller wants to process if there's something to
2906 * process, but doesn't care otherwise */
2908 r
= sd_bus_get_timeout(bus
, &until
);
2913 nw
= now(CLOCK_MONOTONIC
);
2914 m
= until
> nw
? until
- nw
: 0;
2918 if (timeout_usec
!= (uint64_t) -1 && (m
== (uint64_t) -1 || timeout_usec
< m
))
2921 p
[0].fd
= bus
->input_fd
;
2922 if (bus
->output_fd
== bus
->input_fd
) {
2926 p
[0].events
= e
& POLLIN
;
2927 p
[1].fd
= bus
->output_fd
;
2928 p
[1].events
= e
& POLLOUT
;
2932 r
= ppoll(p
, n
, m
== (uint64_t) -1 ? NULL
: timespec_store(&ts
, m
), NULL
);
2936 return r
> 0 ? 1 : 0;
2939 _public_
int sd_bus_wait(sd_bus
*bus
, uint64_t timeout_usec
) {
2941 assert_return(bus
, -EINVAL
);
2942 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2944 if (bus
->state
== BUS_CLOSING
)
2947 if (!BUS_IS_OPEN(bus
->state
))
2950 if (bus
->rqueue_size
> 0)
2953 return bus_poll(bus
, false, timeout_usec
);
2956 _public_
int sd_bus_flush(sd_bus
*bus
) {
2959 assert_return(bus
, -EINVAL
);
2960 assert_return(!bus_pid_changed(bus
), -ECHILD
);
2962 if (bus
->state
== BUS_CLOSING
)
2965 if (!BUS_IS_OPEN(bus
->state
))
2968 r
= bus_ensure_running(bus
);
2972 if (bus
->wqueue_size
<= 0)
2976 r
= dispatch_wqueue(bus
);
2978 if (IN_SET(r
, -ENOTCONN
, -ECONNRESET
, -EPIPE
, -ESHUTDOWN
)) {
2979 bus_enter_closing(bus
);
2986 if (bus
->wqueue_size
<= 0)
2989 r
= bus_poll(bus
, false, (uint64_t) -1);
2995 _public_
int sd_bus_add_filter(
2998 sd_bus_message_handler_t callback
,
3003 assert_return(bus
, -EINVAL
);
3004 assert_return(callback
, -EINVAL
);
3005 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3007 s
= bus_slot_allocate(bus
, !slot
, BUS_FILTER_CALLBACK
, sizeof(struct filter_callback
), userdata
);
3011 s
->filter_callback
.callback
= callback
;
3013 bus
->filter_callbacks_modified
= true;
3014 LIST_PREPEND(callbacks
, bus
->filter_callbacks
, &s
->filter_callback
);
3022 _public_
int sd_bus_add_match(
3026 sd_bus_message_handler_t callback
,
3029 struct bus_match_component
*components
= NULL
;
3030 unsigned n_components
= 0;
3031 sd_bus_slot
*s
= NULL
;
3034 assert_return(bus
, -EINVAL
);
3035 assert_return(match
, -EINVAL
);
3036 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3038 r
= bus_match_parse(match
, &components
, &n_components
);
3042 s
= bus_slot_allocate(bus
, !slot
, BUS_MATCH_CALLBACK
, sizeof(struct match_callback
), userdata
);
3048 s
->match_callback
.callback
= callback
;
3049 s
->match_callback
.cookie
= ++bus
->match_cookie
;
3051 if (bus
->bus_client
) {
3052 enum bus_match_scope scope
;
3054 scope
= bus_match_get_scope(components
, n_components
);
3056 /* Do not install server-side matches for matches
3057 * against the local service, interface or bus
3059 if (scope
!= BUS_MATCH_LOCAL
) {
3061 if (!bus
->is_kernel
) {
3062 /* When this is not a kernel transport, we
3063 * store the original match string, so that we
3064 * can use it to remove the match again */
3066 s
->match_callback
.match_string
= strdup(match
);
3067 if (!s
->match_callback
.match_string
) {
3073 r
= bus_add_match_internal(bus
, s
->match_callback
.match_string
, components
, n_components
, s
->match_callback
.cookie
);
3077 s
->match_added
= true;
3081 bus
->match_callbacks_modified
= true;
3082 r
= bus_match_add(&bus
->match_callbacks
, components
, n_components
, &s
->match_callback
);
3091 bus_match_parse_free(components
, n_components
);
3092 sd_bus_slot_unref(s
);
3097 int bus_remove_match_by_string(
3100 sd_bus_message_handler_t callback
,
3103 struct bus_match_component
*components
= NULL
;
3104 unsigned n_components
= 0;
3105 struct match_callback
*c
;
3108 assert_return(bus
, -EINVAL
);
3109 assert_return(match
, -EINVAL
);
3110 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3112 r
= bus_match_parse(match
, &components
, &n_components
);
3116 r
= bus_match_find(&bus
->match_callbacks
, components
, n_components
, NULL
, NULL
, &c
);
3120 sd_bus_slot_unref(container_of(c
, sd_bus_slot
, match_callback
));
3123 bus_match_parse_free(components
, n_components
);
3128 bool bus_pid_changed(sd_bus
*bus
) {
3131 /* We don't support people creating a bus connection and
3132 * keeping it around over a fork(). Let's complain. */
3134 return bus
->original_pid
!= getpid_cached();
3137 static int io_callback(sd_event_source
*s
, int fd
, uint32_t revents
, void *userdata
) {
3138 sd_bus
*bus
= userdata
;
3143 r
= sd_bus_process(bus
, NULL
);
3150 static int time_callback(sd_event_source
*s
, uint64_t usec
, void *userdata
) {
3151 sd_bus
*bus
= userdata
;
3156 r
= sd_bus_process(bus
, NULL
);
3163 static int prepare_callback(sd_event_source
*s
, void *userdata
) {
3164 sd_bus
*bus
= userdata
;
3171 e
= sd_bus_get_events(bus
);
3175 if (bus
->output_fd
!= bus
->input_fd
) {
3177 r
= sd_event_source_set_io_events(bus
->input_io_event_source
, e
& POLLIN
);
3181 r
= sd_event_source_set_io_events(bus
->output_io_event_source
, e
& POLLOUT
);
3185 r
= sd_event_source_set_io_events(bus
->input_io_event_source
, e
);
3190 r
= sd_bus_get_timeout(bus
, &until
);
3196 j
= sd_event_source_set_time(bus
->time_event_source
, until
);
3201 r
= sd_event_source_set_enabled(bus
->time_event_source
, r
> 0);
3208 static int quit_callback(sd_event_source
*event
, void *userdata
) {
3209 sd_bus
*bus
= userdata
;
3219 static int attach_io_events(sd_bus
*bus
) {
3224 if (bus
->input_fd
< 0)
3230 if (!bus
->input_io_event_source
) {
3231 r
= sd_event_add_io(bus
->event
, &bus
->input_io_event_source
, bus
->input_fd
, 0, io_callback
, bus
);
3235 r
= sd_event_source_set_prepare(bus
->input_io_event_source
, prepare_callback
);
3239 r
= sd_event_source_set_priority(bus
->input_io_event_source
, bus
->event_priority
);
3243 r
= sd_event_source_set_description(bus
->input_io_event_source
, "bus-input");
3245 r
= sd_event_source_set_io_fd(bus
->input_io_event_source
, bus
->input_fd
);
3250 if (bus
->output_fd
!= bus
->input_fd
) {
3251 assert(bus
->output_fd
>= 0);
3253 if (!bus
->output_io_event_source
) {
3254 r
= sd_event_add_io(bus
->event
, &bus
->output_io_event_source
, bus
->output_fd
, 0, io_callback
, bus
);
3258 r
= sd_event_source_set_priority(bus
->output_io_event_source
, bus
->event_priority
);
3262 r
= sd_event_source_set_description(bus
->input_io_event_source
, "bus-output");
3264 r
= sd_event_source_set_io_fd(bus
->output_io_event_source
, bus
->output_fd
);
3273 static void detach_io_events(sd_bus
*bus
) {
3276 if (bus
->input_io_event_source
) {
3277 sd_event_source_set_enabled(bus
->input_io_event_source
, SD_EVENT_OFF
);
3278 bus
->input_io_event_source
= sd_event_source_unref(bus
->input_io_event_source
);
3281 if (bus
->output_io_event_source
) {
3282 sd_event_source_set_enabled(bus
->output_io_event_source
, SD_EVENT_OFF
);
3283 bus
->output_io_event_source
= sd_event_source_unref(bus
->output_io_event_source
);
3287 _public_
int sd_bus_attach_event(sd_bus
*bus
, sd_event
*event
, int priority
) {
3290 assert_return(bus
, -EINVAL
);
3291 assert_return(!bus
->event
, -EBUSY
);
3293 assert(!bus
->input_io_event_source
);
3294 assert(!bus
->output_io_event_source
);
3295 assert(!bus
->time_event_source
);
3298 bus
->event
= sd_event_ref(event
);
3300 r
= sd_event_default(&bus
->event
);
3305 bus
->event_priority
= priority
;
3307 r
= sd_event_add_time(bus
->event
, &bus
->time_event_source
, CLOCK_MONOTONIC
, 0, 0, time_callback
, bus
);
3311 r
= sd_event_source_set_priority(bus
->time_event_source
, priority
);
3315 r
= sd_event_source_set_description(bus
->time_event_source
, "bus-time");
3319 r
= sd_event_add_exit(bus
->event
, &bus
->quit_event_source
, quit_callback
, bus
);
3323 r
= sd_event_source_set_description(bus
->quit_event_source
, "bus-exit");
3327 r
= attach_io_events(bus
);
3334 sd_bus_detach_event(bus
);
3338 _public_
int sd_bus_detach_event(sd_bus
*bus
) {
3339 assert_return(bus
, -EINVAL
);
3344 detach_io_events(bus
);
3346 if (bus
->time_event_source
) {
3347 sd_event_source_set_enabled(bus
->time_event_source
, SD_EVENT_OFF
);
3348 bus
->time_event_source
= sd_event_source_unref(bus
->time_event_source
);
3351 if (bus
->quit_event_source
) {
3352 sd_event_source_set_enabled(bus
->quit_event_source
, SD_EVENT_OFF
);
3353 bus
->quit_event_source
= sd_event_source_unref(bus
->quit_event_source
);
3356 bus
->event
= sd_event_unref(bus
->event
);
3360 _public_ sd_event
* sd_bus_get_event(sd_bus
*bus
) {
3361 assert_return(bus
, NULL
);
3366 _public_ sd_bus_message
* sd_bus_get_current_message(sd_bus
*bus
) {
3367 assert_return(bus
, NULL
);
3369 return bus
->current_message
;
3372 _public_ sd_bus_slot
* sd_bus_get_current_slot(sd_bus
*bus
) {
3373 assert_return(bus
, NULL
);
3375 return bus
->current_slot
;
3378 _public_ sd_bus_message_handler_t
sd_bus_get_current_handler(sd_bus
*bus
) {
3379 assert_return(bus
, NULL
);
3381 return bus
->current_handler
;
3384 _public_
void* sd_bus_get_current_userdata(sd_bus
*bus
) {
3385 assert_return(bus
, NULL
);
3387 return bus
->current_userdata
;
3390 static int bus_default(int (*bus_open
)(sd_bus
**), sd_bus
**default_bus
, sd_bus
**ret
) {
3395 assert(default_bus
);
3398 return !!*default_bus
;
3401 *ret
= sd_bus_ref(*default_bus
);
3409 b
->default_bus_ptr
= default_bus
;
3417 _public_
int sd_bus_default_system(sd_bus
**ret
) {
3418 return bus_default(sd_bus_open_system
, &default_system_bus
, ret
);
3422 _public_
int sd_bus_default_user(sd_bus
**ret
) {
3423 return bus_default(sd_bus_open_user
, &default_user_bus
, ret
);
3426 _public_
int sd_bus_default(sd_bus
**ret
) {
3430 /* Let's try our best to reuse another cached connection. If
3431 * the starter bus type is set, connect via our normal
3432 * connection logic, ignoring $DBUS_STARTER_ADDRESS, so that
3433 * we can share the connection with the user/system default
3436 e
= secure_getenv("DBUS_STARTER_BUS_TYPE");
3438 if (streq(e
, "system"))
3439 return sd_bus_default_system(ret
);
3440 else if (STR_IN_SET(e
, "user", "session"))
3441 return sd_bus_default_user(ret
);
3444 /* No type is specified, so we have not other option than to
3445 * use the starter address if it is set. */
3447 e
= secure_getenv("DBUS_STARTER_ADDRESS");
3450 return bus_default(sd_bus_open
, &default_starter_bus
, ret
);
3453 /* Finally, if nothing is set use the cached connection for
3454 * the right scope */
3456 if (cg_pid_get_owner_uid(0, NULL
) >= 0)
3457 return sd_bus_default_user(ret
);
3459 return sd_bus_default_system(ret
);
3462 _public_
int sd_bus_get_tid(sd_bus
*b
, pid_t
*tid
) {
3463 assert_return(b
, -EINVAL
);
3464 assert_return(tid
, -EINVAL
);
3465 assert_return(!bus_pid_changed(b
), -ECHILD
);
3473 return sd_event_get_tid(b
->event
, tid
);
3478 _public_
int sd_bus_path_encode(const char *prefix
, const char *external_id
, char **ret_path
) {
3479 _cleanup_free_
char *e
= NULL
;
3482 assert_return(object_path_is_valid(prefix
), -EINVAL
);
3483 assert_return(external_id
, -EINVAL
);
3484 assert_return(ret_path
, -EINVAL
);
3486 e
= bus_label_escape(external_id
);
3490 ret
= strjoin(prefix
, "/", e
);
3498 _public_
int sd_bus_path_decode(const char *path
, const char *prefix
, char **external_id
) {
3502 assert_return(object_path_is_valid(path
), -EINVAL
);
3503 assert_return(object_path_is_valid(prefix
), -EINVAL
);
3504 assert_return(external_id
, -EINVAL
);
3506 e
= object_path_startswith(path
, prefix
);
3508 *external_id
= NULL
;
3512 ret
= bus_label_unescape(e
);
3520 _public_
int sd_bus_path_encode_many(char **out
, const char *path_template
, ...) {
3521 _cleanup_strv_free_
char **labels
= NULL
;
3522 char *path
, *path_pos
, **label_pos
;
3523 const char *sep
, *template_pos
;
3528 assert_return(out
, -EINVAL
);
3529 assert_return(path_template
, -EINVAL
);
3531 path_length
= strlen(path_template
);
3533 va_start(list
, path_template
);
3534 for (sep
= strchr(path_template
, '%'); sep
; sep
= strchr(sep
+ 1, '%')) {
3538 arg
= va_arg(list
, const char *);
3544 label
= bus_label_escape(arg
);
3550 r
= strv_consume(&labels
, label
);
3556 /* add label length, but account for the format character */
3557 path_length
+= strlen(label
) - 1;
3561 path
= malloc(path_length
+ 1);
3568 for (template_pos
= path_template
; *template_pos
; ) {
3569 sep
= strchrnul(template_pos
, '%');
3570 path_pos
= mempcpy(path_pos
, template_pos
, sep
- template_pos
);
3574 path_pos
= stpcpy(path_pos
, *label_pos
++);
3575 template_pos
= sep
+ 1;
3583 _public_
int sd_bus_path_decode_many(const char *path
, const char *path_template
, ...) {
3584 _cleanup_strv_free_
char **labels
= NULL
;
3585 const char *template_pos
, *path_pos
;
3591 * This decodes an object-path based on a template argument. The
3592 * template consists of a verbatim path, optionally including special
3595 * - Each occurrence of '%' in the template matches an arbitrary
3596 * substring of a label in the given path. At most one such
3597 * directive is allowed per label. For each such directive, the
3598 * caller must provide an output parameter (char **) via va_arg. If
3599 * NULL is passed, the given label is verified, but not returned.
3600 * For each matched label, the *decoded* label is stored in the
3601 * passed output argument, and the caller is responsible to free
3602 * it. Note that the output arguments are only modified if the
3603 * actualy path matched the template. Otherwise, they're left
3606 * This function returns <0 on error, 0 if the path does not match the
3607 * template, 1 if it matched.
3610 assert_return(path
, -EINVAL
);
3611 assert_return(path_template
, -EINVAL
);
3615 for (template_pos
= path_template
; *template_pos
; ) {
3620 /* verify everything until the next '%' matches verbatim */
3621 sep
= strchrnul(template_pos
, '%');
3622 length
= sep
- template_pos
;
3623 if (strncmp(path_pos
, template_pos
, length
))
3627 template_pos
+= length
;
3632 /* We found the next '%' character. Everything up until here
3633 * matched. We now skip ahead to the end of this label and make
3634 * sure it matches the tail of the label in the path. Then we
3635 * decode the string in-between and save it for later use. */
3637 ++template_pos
; /* skip over '%' */
3639 sep
= strchrnul(template_pos
, '/');
3640 length
= sep
- template_pos
; /* length of suffix to match verbatim */
3642 /* verify the suffixes match */
3643 sep
= strchrnul(path_pos
, '/');
3644 if (sep
- path_pos
< (ssize_t
)length
||
3645 strncmp(sep
- length
, template_pos
, length
))
3648 template_pos
+= length
; /* skip over matched label */
3649 length
= sep
- path_pos
- length
; /* length of sub-label to decode */
3651 /* store unescaped label for later use */
3652 label
= bus_label_unescape_n(path_pos
, length
);
3656 r
= strv_consume(&labels
, label
);
3660 path_pos
= sep
; /* skip decoded label and suffix */
3663 /* end of template must match end of path */
3667 /* copy the labels over to the caller */
3668 va_start(list
, path_template
);
3669 for (label_pos
= labels
; label_pos
&& *label_pos
; ++label_pos
) {
3672 arg
= va_arg(list
, char **);
3685 _public_
int sd_bus_try_close(sd_bus
*bus
) {
3688 assert_return(bus
, -EINVAL
);
3689 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3691 if (!bus
->is_kernel
)
3694 if (!BUS_IS_OPEN(bus
->state
))
3697 if (bus
->rqueue_size
> 0)
3700 if (bus
->wqueue_size
> 0)
3703 r
= bus_kernel_try_close(bus
);
3711 _public_
int sd_bus_get_description(sd_bus
*bus
, const char **description
) {
3712 assert_return(bus
, -EINVAL
);
3713 assert_return(description
, -EINVAL
);
3714 assert_return(bus
->description
, -ENXIO
);
3715 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3717 *description
= bus
->description
;
3721 int bus_get_root_path(sd_bus
*bus
) {
3724 if (bus
->cgroup_root
)
3727 r
= cg_get_root_path(&bus
->cgroup_root
);
3729 bus
->cgroup_root
= strdup("/");
3730 if (!bus
->cgroup_root
)
3739 _public_
int sd_bus_get_scope(sd_bus
*bus
, const char **scope
) {
3742 assert_return(bus
, -EINVAL
);
3743 assert_return(scope
, -EINVAL
);
3744 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3746 if (bus
->is_kernel
) {
3747 _cleanup_free_
char *n
= NULL
;
3750 r
= bus_kernel_get_bus_name(bus
, &n
);
3754 if (streq(n
, "0-system")) {
3759 dash
= strchr(n
, '-');
3760 if (streq_ptr(dash
, "-user")) {
3771 if (bus
->is_system
) {
3779 _public_
int sd_bus_get_address(sd_bus
*bus
, const char **address
) {
3781 assert_return(bus
, -EINVAL
);
3782 assert_return(address
, -EINVAL
);
3783 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3786 *address
= bus
->address
;
3793 _public_
int sd_bus_get_creds_mask(sd_bus
*bus
, uint64_t *mask
) {
3794 assert_return(bus
, -EINVAL
);
3795 assert_return(mask
, -EINVAL
);
3796 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3798 *mask
= bus
->creds_mask
;
3802 _public_
int sd_bus_is_bus_client(sd_bus
*bus
) {
3803 assert_return(bus
, -EINVAL
);
3804 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3806 return bus
->bus_client
;
3809 _public_
int sd_bus_is_server(sd_bus
*bus
) {
3810 assert_return(bus
, -EINVAL
);
3811 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3813 return bus
->is_server
;
3816 _public_
int sd_bus_is_anonymous(sd_bus
*bus
) {
3817 assert_return(bus
, -EINVAL
);
3818 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3820 return bus
->anonymous_auth
;
3823 _public_
int sd_bus_is_trusted(sd_bus
*bus
) {
3824 assert_return(bus
, -EINVAL
);
3825 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3827 return bus
->trusted
;
3830 _public_
int sd_bus_is_monitor(sd_bus
*bus
) {
3831 assert_return(bus
, -EINVAL
);
3832 assert_return(!bus_pid_changed(bus
), -ECHILD
);
3834 return !!(bus
->hello_flags
& KDBUS_HELLO_MONITOR
);
3837 static void flush_close(sd_bus
*bus
) {
3841 /* Flushes and closes the specified bus. We take a ref before,
3842 * to ensure the flushing does not cause the bus to be
3845 sd_bus_flush_close_unref(sd_bus_ref(bus
));
3848 _public_
void sd_bus_default_flush_close(void) {
3849 flush_close(default_starter_bus
);
3850 flush_close(default_user_bus
);
3851 flush_close(default_system_bus
);
3854 _public_
int sd_bus_set_exit_on_disconnect(sd_bus
*bus
, int b
) {
3855 assert_return(bus
, -EINVAL
);
3857 /* Turns on exit-on-disconnect, and triggers it immediately if the bus connection was already
3858 * disconnected. Note that this is triggered exclusively on disconnections triggered by the server side, never
3859 * from the client side. */
3860 bus
->exit_on_disconnect
= b
;
3862 /* If the exit condition was triggered already, exit immediately. */
3863 return bus_exit_now(bus
);
3866 _public_
int sd_bus_get_exit_on_disconnect(sd_bus
*bus
) {
3867 assert_return(bus
, -EINVAL
);
3869 return bus
->exit_on_disconnect
;