]>
Commit | Line | Data |
---|---|---|
53e1b683 | 1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
de1c301e LP |
2 | #pragma once |
3 | ||
45fbe937 | 4 | #include <pthread.h> |
07630cea | 5 | #include <sys/socket.h> |
de1c301e LP |
6 | |
7 | #include "sd-bus.h" | |
07630cea | 8 | |
de1c301e | 9 | #include "bus-error.h" |
bc7fd8cd | 10 | #include "bus-kernel.h" |
07630cea | 11 | #include "bus-match.h" |
036d61b3 | 12 | #include "def.h" |
07630cea | 13 | #include "hashmap.h" |
07630cea LP |
14 | #include "list.h" |
15 | #include "prioq.h" | |
16 | #include "refcnt.h" | |
17 | #include "socket-util.h" | |
18 | #include "util.h" | |
de1c301e LP |
19 | |
20 | struct reply_callback { | |
52f3ba91 | 21 | sd_bus_message_handler_t callback; |
ac8029fc | 22 | usec_t timeout_usec; /* this is a relative timeout until we reach the BUS_HELLO state, and an absolute one right after */ |
693eb9a2 | 23 | uint64_t cookie; |
e3017af9 | 24 | unsigned prioq_idx; |
de1c301e LP |
25 | }; |
26 | ||
27 | struct filter_callback { | |
52f3ba91 | 28 | sd_bus_message_handler_t callback; |
de1c301e | 29 | |
7286037f LP |
30 | unsigned last_iteration; |
31 | ||
de1c301e LP |
32 | LIST_FIELDS(struct filter_callback, callbacks); |
33 | }; | |
34 | ||
19befb2d LP |
35 | struct match_callback { |
36 | sd_bus_message_handler_t callback; | |
7593c7a4 LP |
37 | sd_bus_message_handler_t install_callback; |
38 | ||
39 | sd_bus_slot *install_slot; /* The AddMatch() call */ | |
19befb2d | 40 | |
19befb2d LP |
41 | unsigned last_iteration; |
42 | ||
43 | char *match_string; | |
44 | ||
45 | struct bus_match_node *match_node; | |
46 | }; | |
47 | ||
29ddb38f LP |
48 | struct node { |
49 | char *path; | |
50 | struct node *parent; | |
51 | LIST_HEAD(struct node, child); | |
52 | LIST_FIELDS(struct node, siblings); | |
53 | ||
54 | LIST_HEAD(struct node_callback, callbacks); | |
55 | LIST_HEAD(struct node_vtable, vtables); | |
56 | LIST_HEAD(struct node_enumerator, enumerators); | |
19befb2d | 57 | LIST_HEAD(struct node_object_manager, object_managers); |
29ddb38f LP |
58 | }; |
59 | ||
60 | struct node_callback { | |
61 | struct node *node; | |
62 | ||
63 | bool is_fallback; | |
52f3ba91 | 64 | sd_bus_message_handler_t callback; |
a652755d | 65 | |
29ddb38f LP |
66 | unsigned last_iteration; |
67 | ||
68 | LIST_FIELDS(struct node_callback, callbacks); | |
69 | }; | |
70 | ||
71 | struct node_enumerator { | |
72 | struct node *node; | |
73 | ||
74 | sd_bus_node_enumerator_t callback; | |
29ddb38f LP |
75 | |
76 | unsigned last_iteration; | |
77 | ||
78 | LIST_FIELDS(struct node_enumerator, enumerators); | |
79 | }; | |
80 | ||
19befb2d LP |
81 | struct node_object_manager { |
82 | struct node *node; | |
83 | ||
84 | LIST_FIELDS(struct node_object_manager, object_managers); | |
85 | }; | |
86 | ||
29ddb38f LP |
87 | struct node_vtable { |
88 | struct node *node; | |
89 | ||
90 | char *interface; | |
a652755d | 91 | bool is_fallback; |
29ddb38f | 92 | const sd_bus_vtable *vtable; |
29ddb38f | 93 | sd_bus_object_find_t find; |
7286037f LP |
94 | |
95 | unsigned last_iteration; | |
29ddb38f LP |
96 | |
97 | LIST_FIELDS(struct node_vtable, vtables); | |
98 | }; | |
99 | ||
100 | struct vtable_member { | |
101 | const char *path; | |
102 | const char *interface; | |
103 | const char *member; | |
104 | struct node_vtable *parent; | |
105 | unsigned last_iteration; | |
106 | const sd_bus_vtable *vtable; | |
a652755d LP |
107 | }; |
108 | ||
19befb2d | 109 | typedef enum BusSlotType { |
19befb2d LP |
110 | BUS_REPLY_CALLBACK, |
111 | BUS_FILTER_CALLBACK, | |
112 | BUS_MATCH_CALLBACK, | |
113 | BUS_NODE_CALLBACK, | |
114 | BUS_NODE_ENUMERATOR, | |
115 | BUS_NODE_VTABLE, | |
116 | BUS_NODE_OBJECT_MANAGER, | |
a71fe8b8 | 117 | _BUS_SLOT_INVALID = -1, |
19befb2d LP |
118 | } BusSlotType; |
119 | ||
120 | struct sd_bus_slot { | |
121 | unsigned n_ref; | |
122 | sd_bus *bus; | |
123 | void *userdata; | |
fa17b4e8 | 124 | sd_bus_destroy_t destroy_callback; |
a71fe8b8 | 125 | BusSlotType type:5; |
303acb7f LP |
126 | |
127 | /* Slots can be "floating" or not. If they are not floating (the usual case) then they reference the bus object | |
128 | * they are associated with. This means the bus object stays allocated at least as long as there is a slot | |
129 | * around associated with it. If it is floating, then the slot's lifecycle is bound to the lifecycle of the | |
130 | * bus: it will be disconnected from the bus when the bus is destroyed, and it keeping the slot reffed hence | |
131 | * won't mean the bus stays reffed too. Internally this means the reference direction is reversed: floating | |
132 | * slots objects are referenced by the bus object, and not vice versa. */ | |
a71fe8b8 | 133 | bool floating:1; |
303acb7f | 134 | |
cc65fe5e | 135 | bool match_added:1; |
9cbfc66c | 136 | char *description; |
19befb2d LP |
137 | |
138 | LIST_FIELDS(sd_bus_slot, slots); | |
139 | ||
140 | union { | |
141 | struct reply_callback reply_callback; | |
142 | struct filter_callback filter_callback; | |
143 | struct match_callback match_callback; | |
144 | struct node_callback node_callback; | |
145 | struct node_enumerator node_enumerator; | |
146 | struct node_object_manager node_object_manager; | |
147 | struct node_vtable node_vtable; | |
148 | }; | |
149 | }; | |
150 | ||
de1c301e | 151 | enum bus_state { |
021a1e78 | 152 | BUS_UNSET, |
ac8029fc LP |
153 | BUS_WATCH_BIND, /* waiting for the socket to appear via inotify */ |
154 | BUS_OPENING, /* the kernel's connect() is still not ready */ | |
155 | BUS_AUTHENTICATING, /* we are currently in the "SASL" authorization phase of dbus */ | |
156 | BUS_HELLO, /* we are waiting for the Hello() response */ | |
f54514f3 | 157 | BUS_RUNNING, |
718db961 | 158 | BUS_CLOSING, |
3e0e196e LP |
159 | BUS_CLOSED, |
160 | _BUS_STATE_MAX, | |
de1c301e LP |
161 | }; |
162 | ||
f54514f3 | 163 | static inline bool BUS_IS_OPEN(enum bus_state state) { |
718db961 | 164 | return state > BUS_UNSET && state < BUS_CLOSING; |
f54514f3 LP |
165 | } |
166 | ||
2181a7f5 LP |
167 | enum bus_auth { |
168 | _BUS_AUTH_INVALID, | |
169 | BUS_AUTH_EXTERNAL, | |
170 | BUS_AUTH_ANONYMOUS | |
171 | }; | |
172 | ||
de1c301e | 173 | struct sd_bus { |
e4ee6e5c LP |
174 | /* We use atomic ref counting here since sd_bus_message |
175 | objects retain references to their originating sd_bus but | |
176 | we want to allow them to be processed in a different | |
177 | thread. We won't provide full thread safety, but only the | |
178 | bare minimum that makes it possible to use sd_bus and | |
179 | sd_bus_message objects independently and on different | |
180 | threads as long as each object is used only once at the | |
181 | same time. */ | |
182 | RefCount n_ref; | |
183 | ||
de1c301e | 184 | enum bus_state state; |
e82c9509 | 185 | int input_fd, output_fd; |
8a5cd31e | 186 | int inotify_fd; |
de1c301e | 187 | int message_version; |
0f437184 | 188 | int message_endian; |
021a1e78 | 189 | |
de1c301e | 190 | bool can_fds:1; |
94bbf1ba | 191 | bool bus_client:1; |
2571ead1 | 192 | bool ucred_valid:1; |
2181a7f5 LP |
193 | bool is_server:1; |
194 | bool anonymous_auth:1; | |
15d5af81 LP |
195 | bool prefer_readv:1; |
196 | bool prefer_writev:1; | |
7286037f LP |
197 | bool match_callbacks_modified:1; |
198 | bool filter_callbacks_modified:1; | |
29ddb38f | 199 | bool nodes_modified:1; |
adacb957 | 200 | bool trusted:1; |
758bf0c7 | 201 | bool manual_peer_interface:1; |
5972fe95 LP |
202 | bool is_system:1; |
203 | bool is_user:1; | |
c0765ddb | 204 | bool allow_interactive_authorization:1; |
fbb4603d LP |
205 | bool exit_on_disconnect:1; |
206 | bool exited:1; | |
207 | bool exit_triggered:1; | |
694859b5 | 208 | bool is_local:1; |
8a5cd31e | 209 | bool watch_bind:1; |
c7db1984 LP |
210 | bool is_monitor:1; |
211 | bool accept_fd:1; | |
212 | bool attach_timestamp:1; | |
b38cc8d5 | 213 | bool connected_signal:1; |
c4e48030 | 214 | bool close_on_exit:1; |
de1c301e | 215 | |
8f155917 LP |
216 | int use_memfd; |
217 | ||
de1c301e LP |
218 | void *rbuffer; |
219 | size_t rbuffer_size; | |
220 | ||
221 | sd_bus_message **rqueue; | |
821e0756 LP |
222 | unsigned rqueue_size; |
223 | size_t rqueue_allocated; | |
de1c301e LP |
224 | |
225 | sd_bus_message **wqueue; | |
226 | unsigned wqueue_size; | |
227 | size_t windex; | |
821e0756 | 228 | size_t wqueue_allocated; |
de1c301e | 229 | |
693eb9a2 | 230 | uint64_t cookie; |
de1c301e LP |
231 | |
232 | char *unique_name; | |
219728b3 | 233 | uint64_t unique_id; |
de1c301e | 234 | |
392d5b37 | 235 | struct bus_match_node match_callbacks; |
e3017af9 | 236 | Prioq *reply_callbacks_prioq; |
c9fe4af7 | 237 | OrderedHashmap *reply_callbacks; |
de1c301e | 238 | LIST_HEAD(struct filter_callback, filter_callbacks); |
29ddb38f LP |
239 | |
240 | Hashmap *nodes; | |
29ddb38f LP |
241 | Hashmap *vtable_methods; |
242 | Hashmap *vtable_properties; | |
de1c301e | 243 | |
3cb46740 | 244 | union sockaddr_union sockaddr; |
de1c301e LP |
245 | socklen_t sockaddr_size; |
246 | ||
a7893c6b | 247 | char *machine; |
ee502e0c | 248 | pid_t nspid; |
6629161f | 249 | |
98178d39 | 250 | sd_id128_t server_id; |
de1c301e LP |
251 | |
252 | char *address; | |
253 | unsigned address_index; | |
254 | ||
255 | int last_connect_error; | |
256 | ||
2181a7f5 LP |
257 | enum bus_auth auth; |
258 | size_t auth_rbegin; | |
de1c301e LP |
259 | struct iovec auth_iovec[3]; |
260 | unsigned auth_index; | |
2181a7f5 | 261 | char *auth_buffer; |
e3017af9 | 262 | usec_t auth_timeout; |
2571ead1 LP |
263 | |
264 | struct ucred ucred; | |
c4e6556c | 265 | char *label; |
18ac4643 LP |
266 | gid_t *groups; |
267 | size_t n_groups; | |
2c93b4ef | 268 | |
5b12334d LP |
269 | uint64_t creds_mask; |
270 | ||
2c93b4ef | 271 | int *fds; |
da6053d0 | 272 | size_t n_fds; |
2fd9ae2e LP |
273 | |
274 | char *exec_path; | |
275 | char **exec_argv; | |
9d373862 | 276 | |
7286037f | 277 | unsigned iteration_counter; |
fd8d62d9 | 278 | |
45fbe937 LP |
279 | /* We do locking around the memfd cache, since we want to |
280 | * allow people to process a sd_bus_message in a different | |
281 | * thread then it was generated on and free it there. Since | |
282 | * adding something to the memfd cache might happen when a | |
283 | * message is released, we hence need to protect this bit with | |
284 | * a mutex. */ | |
285 | pthread_mutex_t memfd_cache_mutex; | |
bc7fd8cd LP |
286 | struct memfd_cache memfd_cache[MEMFD_CACHE_MAX]; |
287 | unsigned n_memfd_cache; | |
d5a2b9a6 LP |
288 | |
289 | pid_t original_pid; | |
392cf1d0 | 290 | pid_t busexec_pid; |
264ad849 | 291 | |
40ca29a1 LP |
292 | sd_event_source *input_io_event_source; |
293 | sd_event_source *output_io_event_source; | |
294 | sd_event_source *time_event_source; | |
abc5fe72 | 295 | sd_event_source *quit_event_source; |
8a5cd31e | 296 | sd_event_source *inotify_event_source; |
40ca29a1 | 297 | sd_event *event; |
1e05d493 | 298 | int event_priority; |
affff0b6 | 299 | |
19befb2d LP |
300 | sd_bus_message *current_message; |
301 | sd_bus_slot *current_slot; | |
caa82984 LP |
302 | sd_bus_message_handler_t current_handler; |
303 | void *current_userdata; | |
76b54375 LP |
304 | |
305 | sd_bus **default_bus_ptr; | |
306 | pid_t tid; | |
8a0e0ed9 | 307 | |
751bc6ac | 308 | char *cgroup_root; |
5972fe95 | 309 | |
455971c1 | 310 | char *description; |
48ef41a3 | 311 | char *patch_sender; |
b28ff39f | 312 | |
8f8f05a9 | 313 | sd_bus_track *track_queue; |
19befb2d LP |
314 | |
315 | LIST_HEAD(sd_bus_slot, slots); | |
232f3677 | 316 | LIST_HEAD(sd_bus_track, tracks); |
8a5cd31e LP |
317 | |
318 | int *inotify_watches; | |
319 | size_t n_inotify_watches; | |
385b2eb2 YW |
320 | |
321 | /* zero means use value specified by $SYSTEMD_BUS_TIMEOUT= environment variable or built-in default */ | |
322 | usec_t method_call_timeout; | |
40ca29a1 | 323 | }; |
e3017af9 | 324 | |
036d61b3 | 325 | /* For method calls we time-out at 25s, like in the D-Bus reference implementation */ |
e3017af9 | 326 | #define BUS_DEFAULT_TIMEOUT ((usec_t) (25 * USEC_PER_SEC)) |
25220239 | 327 | |
036d61b3 LP |
328 | /* For the authentication phase we grant 90s, to provide extra room during boot, when RNGs and such are not filled up |
329 | * with enough entropy yet and might delay the boot */ | |
330 | #define BUS_AUTH_TIMEOUT ((usec_t) DEFAULT_TIMEOUT_USEC) | |
331 | ||
5ddda46f LP |
332 | #define BUS_WQUEUE_MAX (192*1024) |
333 | #define BUS_RQUEUE_MAX (192*1024) | |
25220239 | 334 | |
33d8fe60 | 335 | #define BUS_MESSAGE_SIZE_MAX (128*1024*1024) |
25220239 | 336 | #define BUS_AUTH_SIZE_MAX (64*1024) |
ac89bf1d | 337 | |
ed205a6b LP |
338 | #define BUS_CONTAINER_DEPTH 128 |
339 | ||
385b2eb2 | 340 | /* Defined by the specification as maximum size of an array in bytes */ |
ac89bf1d LP |
341 | #define BUS_ARRAY_MAX_SIZE 67108864 |
342 | ||
2c93b4ef LP |
343 | #define BUS_FDS_MAX 1024 |
344 | ||
2fd9ae2e LP |
345 | #define BUS_EXEC_ARGV_MAX 256 |
346 | ||
0ce036ce LP |
347 | bool interface_name_is_valid(const char *p) _pure_; |
348 | bool service_name_is_valid(const char *p) _pure_; | |
f5d8989c | 349 | char* service_name_startswith(const char *a, const char *b); |
0ce036ce LP |
350 | bool member_name_is_valid(const char *p) _pure_; |
351 | bool object_path_is_valid(const char *p) _pure_; | |
352 | char *object_path_startswith(const char *a, const char *b) _pure_; | |
6693860f | 353 | |
0ce036ce LP |
354 | bool namespace_complex_pattern(const char *pattern, const char *value) _pure_; |
355 | bool path_complex_pattern(const char *pattern, const char *value) _pure_; | |
392d5b37 | 356 | |
0ce036ce LP |
357 | bool namespace_simple_pattern(const char *pattern, const char *value) _pure_; |
358 | bool path_simple_pattern(const char *pattern, const char *value) _pure_; | |
392d5b37 | 359 | |
0ce036ce LP |
360 | int bus_message_type_from_string(const char *s, uint8_t *u) _pure_; |
361 | const char *bus_message_type_to_string(uint8_t u) _pure_; | |
392d5b37 | 362 | |
6693860f | 363 | #define error_name_is_valid interface_name_is_valid |
20902f3e | 364 | |
45b1f410 NM |
365 | sd_bus *bus_resolve(sd_bus *bus); |
366 | ||
20902f3e | 367 | int bus_ensure_running(sd_bus *bus); |
a7e3212d LP |
368 | int bus_start_running(sd_bus *bus); |
369 | int bus_next_address(sd_bus *bus); | |
d5a2b9a6 | 370 | |
7adc46fc | 371 | int bus_seal_synthetic_message(sd_bus *b, sd_bus_message *m); |
777d7a61 | 372 | |
7adc46fc | 373 | int bus_rqueue_make_room(sd_bus *bus); |
7d22c717 | 374 | |
d5a2b9a6 | 375 | bool bus_pid_changed(sd_bus *bus); |
92e189e5 | 376 | |
0f8bd8de LP |
377 | char *bus_address_escape(const char *v); |
378 | ||
8a5cd31e LP |
379 | int bus_attach_io_events(sd_bus *b); |
380 | int bus_attach_inotify_event(sd_bus *b); | |
381 | ||
382 | void bus_close_inotify_fd(sd_bus *b); | |
383 | void bus_close_io_fds(sd_bus *b); | |
384 | ||
92e189e5 LP |
385 | #define OBJECT_PATH_FOREACH_PREFIX(prefix, path) \ |
386 | for (char *_slash = ({ strcpy((prefix), (path)); streq((prefix), "/") ? NULL : strrchr((prefix), '/'); }) ; \ | |
283c2653 | 387 | _slash && ((_slash[(_slash) == (prefix)] = 0), true); \ |
92e189e5 | 388 | _slash = streq((prefix), "/") ? NULL : strrchr((prefix), '/')) |
8ce2afd6 LP |
389 | |
390 | /* If we are invoking callbacks of a bus object, ensure unreffing the | |
385b2eb2 | 391 | * bus from the callback doesn't destroy the object we are working on */ |
8ce2afd6 | 392 | #define BUS_DONT_DESTROY(bus) \ |
4afd3348 | 393 | _cleanup_(sd_bus_unrefp) _unused_ sd_bus *_dont_destroy_##bus = sd_bus_ref(bus) |
09365592 LP |
394 | |
395 | int bus_set_address_system(sd_bus *bus); | |
396 | int bus_set_address_user(sd_bus *bus); | |
397 | int bus_set_address_system_remote(sd_bus *b, const char *host); | |
de33fc62 | 398 | int bus_set_address_system_machine(sd_bus *b, const char *machine); |
19befb2d | 399 | |
fe3f22d1 | 400 | int bus_get_root_path(sd_bus *bus); |
a095315b KS |
401 | |
402 | int bus_maybe_reply_error(sd_bus_message *m, int r, sd_bus_error *error); | |
d4d00020 | 403 | |
759e02e7 LP |
404 | #define bus_assert_return(expr, r, error) \ |
405 | do { \ | |
34c38d2a | 406 | if (!assert_log(expr, #expr)) \ |
759e02e7 LP |
407 | return sd_bus_error_set_errno(error, r); \ |
408 | } while (false) | |
98c5bbc8 LP |
409 | |
410 | void bus_enter_closing(sd_bus *bus); | |
3e0e196e LP |
411 | |
412 | void bus_set_state(sd_bus *bus, enum bus_state state); |