1 /* SPDX-License-Identifier: LGPL-2.1-or-later */ 2 #ifndef foosdbushfoo 3 #define foosdbushfoo 4 5 /*** 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. 10 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. 15 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/>. 18 ***/ 19 20 #include <inttypes.h> 21 #include <stdarg.h> 22 #include <stdio.h> 23 #include <sys/types.h> 24 #include <sys/uio.h> 25 26 #include "sd-event.h" 27 #include "sd-id128.h" 28 29 #include "_sd-common.h" 30 31 _SD_BEGIN_DECLARATIONS; 32 33 #define SD_BUS_DEFAULT ((sd_bus *) 1) 34 #define SD_BUS_DEFAULT_USER ((sd_bus *) 2) 35 #define SD_BUS_DEFAULT_SYSTEM ((sd_bus *) 3) 36 37 /* Types */ 38 39 typedef struct sd_bus sd_bus; 40 typedef struct sd_bus_message sd_bus_message; 41 typedef struct sd_bus_slot sd_bus_slot; 42 typedef struct sd_bus_creds sd_bus_creds; 43 typedef struct sd_bus_track sd_bus_track; 44 45 typedef struct { 46 const char *name; 47 const char *message; 48 int _need_free; 49 } sd_bus_error; 50 51 typedef struct { 52 const char *name; 53 int code; 54 } sd_bus_error_map; 55 56 /* Flags */ 57 58 enum { 59 SD_BUS_CREDS_PID = 1ULL << 0, 60 SD_BUS_CREDS_TID = 1ULL << 1, 61 SD_BUS_CREDS_PPID = 1ULL << 2, 62 SD_BUS_CREDS_UID = 1ULL << 3, 63 SD_BUS_CREDS_EUID = 1ULL << 4, 64 SD_BUS_CREDS_SUID = 1ULL << 5, 65 SD_BUS_CREDS_FSUID = 1ULL << 6, 66 SD_BUS_CREDS_GID = 1ULL << 7, 67 SD_BUS_CREDS_EGID = 1ULL << 8, 68 SD_BUS_CREDS_SGID = 1ULL << 9, 69 SD_BUS_CREDS_FSGID = 1ULL << 10, 70 SD_BUS_CREDS_SUPPLEMENTARY_GIDS = 1ULL << 11, 71 SD_BUS_CREDS_COMM = 1ULL << 12, 72 SD_BUS_CREDS_TID_COMM = 1ULL << 13, 73 SD_BUS_CREDS_EXE = 1ULL << 14, 74 SD_BUS_CREDS_CMDLINE = 1ULL << 15, 75 SD_BUS_CREDS_CGROUP = 1ULL << 16, 76 SD_BUS_CREDS_UNIT = 1ULL << 17, 77 SD_BUS_CREDS_SLICE = 1ULL << 18, 78 SD_BUS_CREDS_USER_UNIT = 1ULL << 19, 79 SD_BUS_CREDS_USER_SLICE = 1ULL << 20, 80 SD_BUS_CREDS_SESSION = 1ULL << 21, 81 SD_BUS_CREDS_OWNER_UID = 1ULL << 22, 82 SD_BUS_CREDS_EFFECTIVE_CAPS = 1ULL << 23, 83 SD_BUS_CREDS_PERMITTED_CAPS = 1ULL << 24, 84 SD_BUS_CREDS_INHERITABLE_CAPS = 1ULL << 25, 85 SD_BUS_CREDS_BOUNDING_CAPS = 1ULL << 26, 86 SD_BUS_CREDS_SELINUX_CONTEXT = 1ULL << 27, 87 SD_BUS_CREDS_AUDIT_SESSION_ID = 1ULL << 28, 88 SD_BUS_CREDS_AUDIT_LOGIN_UID = 1ULL << 29, 89 SD_BUS_CREDS_TTY = 1ULL << 30, 90 SD_BUS_CREDS_UNIQUE_NAME = 1ULL << 31, 91 SD_BUS_CREDS_WELL_KNOWN_NAMES = 1ULL << 32, 92 SD_BUS_CREDS_DESCRIPTION = 1ULL << 33, 93 SD_BUS_CREDS_AUGMENT = 1ULL << 63, /* special flag, if on sd-bus will augment creds struct, in a potentially race-full way. */ 94 _SD_BUS_CREDS_ALL = (1ULL << 34) -1 95 }; 96 97 enum { 98 SD_BUS_NAME_REPLACE_EXISTING = 1ULL << 0, 99 SD_BUS_NAME_ALLOW_REPLACEMENT = 1ULL << 1, 100 SD_BUS_NAME_QUEUE = 1ULL << 2 101 }; 102 103 enum { 104 SD_BUS_MESSAGE_DUMP_WITH_HEADER = 1ULL << 0, 105 SD_BUS_MESSAGE_DUMP_SUBTREE_ONLY = 1ULL << 1, 106 }; 107 108 /* Callbacks */ 109 110 typedef int (*sd_bus_message_handler_t)(sd_bus_message *m, void *userdata, sd_bus_error *ret_error); 111 typedef int (*sd_bus_property_get_t) (sd_bus *bus, const char *path, const char *interface, const char *property, sd_bus_message *reply, void *userdata, sd_bus_error *ret_error); 112 typedef int (*sd_bus_property_set_t) (sd_bus *bus, const char *path, const char *interface, const char *property, sd_bus_message *value, void *userdata, sd_bus_error *ret_error); 113 typedef int (*sd_bus_object_find_t) (sd_bus *bus, const char *path, const char *interface, void *userdata, void **ret_found, sd_bus_error *ret_error); 114 typedef int (*sd_bus_node_enumerator_t) (sd_bus *bus, const char *prefix, void *userdata, char ***ret_nodes, sd_bus_error *ret_error); 115 typedef int (*sd_bus_track_handler_t) (sd_bus_track *track, void *userdata); 116 typedef _sd_destroy_t sd_bus_destroy_t; 117 118 #include "sd-bus-protocol.h" 119 #include "sd-bus-vtable.h" 120 121 /* Naming */ 122 123 int sd_bus_interface_name_is_valid(const char *p); 124 int sd_bus_service_name_is_valid(const char *p); 125 int sd_bus_member_name_is_valid(const char *p); 126 int sd_bus_object_path_is_valid(const char *p); 127 128 /* Connections */ 129 130 int sd_bus_default(sd_bus **ret); 131 int sd_bus_default_user(sd_bus **ret); 132 int sd_bus_default_system(sd_bus **ret); 133 134 int sd_bus_open(sd_bus **ret); 135 int sd_bus_open_with_description(sd_bus **ret, const char *description); 136 int sd_bus_open_user(sd_bus **ret); 137 int sd_bus_open_user_with_description(sd_bus **ret, const char *description); 138 int sd_bus_open_user_machine(sd_bus **ret, const char *machine); 139 int sd_bus_open_system(sd_bus **ret); 140 int sd_bus_open_system_with_description(sd_bus **ret, const char *description); 141 int sd_bus_open_system_remote(sd_bus **ret, const char *host); 142 int sd_bus_open_system_machine(sd_bus **ret, const char *machine); 143 144 int sd_bus_new(sd_bus **ret); 145 146 int sd_bus_set_address(sd_bus *bus, const char *address); 147 int sd_bus_set_fd(sd_bus *bus, int input_fd, int output_fd); 148 int sd_bus_set_exec(sd_bus *bus, const char *path, char *const *argv); 149 int sd_bus_get_address(sd_bus *bus, const char **address); 150 int sd_bus_set_bus_client(sd_bus *bus, int b); 151 int sd_bus_is_bus_client(sd_bus *bus); 152 int sd_bus_set_server(sd_bus *bus, int b, sd_id128_t bus_id); 153 int sd_bus_is_server(sd_bus *bus); 154 int sd_bus_set_anonymous(sd_bus *bus, int b); 155 int sd_bus_is_anonymous(sd_bus *bus); 156 int sd_bus_set_trusted(sd_bus *bus, int b); 157 int sd_bus_is_trusted(sd_bus *bus); 158 int sd_bus_set_monitor(sd_bus *bus, int b); 159 int sd_bus_is_monitor(sd_bus *bus); 160 int sd_bus_set_description(sd_bus *bus, const char *description); 161 int sd_bus_get_description(sd_bus *bus, const char **description); 162 int sd_bus_negotiate_creds(sd_bus *bus, int b, uint64_t creds_mask); 163 int sd_bus_negotiate_timestamp(sd_bus *bus, int b); 164 int sd_bus_negotiate_fds(sd_bus *bus, int b); 165 int sd_bus_can_send(sd_bus *bus, char type); 166 int sd_bus_get_creds_mask(sd_bus *bus, uint64_t *creds_mask); 167 int sd_bus_set_allow_interactive_authorization(sd_bus *bus, int b); 168 int sd_bus_get_allow_interactive_authorization(sd_bus *bus); 169 int sd_bus_set_exit_on_disconnect(sd_bus *bus, int b); 170 int sd_bus_get_exit_on_disconnect(sd_bus *bus); 171 int sd_bus_set_close_on_exit(sd_bus *bus, int b); 172 int sd_bus_get_close_on_exit(sd_bus *bus); 173 int sd_bus_set_watch_bind(sd_bus *bus, int b); 174 int sd_bus_get_watch_bind(sd_bus *bus); 175 int sd_bus_set_connected_signal(sd_bus *bus, int b); 176 int sd_bus_get_connected_signal(sd_bus *bus); 177 int sd_bus_set_sender(sd_bus *bus, const char *sender); 178 int sd_bus_get_sender(sd_bus *bus, const char **ret); 179 180 int sd_bus_start(sd_bus *bus); 181 182 int sd_bus_try_close(sd_bus *bus) _sd_deprecated_; 183 void sd_bus_close(sd_bus *bus); 184 185 sd_bus* sd_bus_ref(sd_bus *bus); 186 sd_bus* sd_bus_unref(sd_bus *bus); 187 sd_bus* sd_bus_close_unref(sd_bus *bus); 188 sd_bus* sd_bus_flush_close_unref(sd_bus *bus); 189 190 void sd_bus_default_flush_close(void); 191 192 int sd_bus_is_open(sd_bus *bus); 193 int sd_bus_is_ready(sd_bus *bus); 194 195 int sd_bus_get_bus_id(sd_bus *bus, sd_id128_t *id); 196 int sd_bus_get_scope(sd_bus *bus, const char **scope); 197 int sd_bus_get_tid(sd_bus *bus, pid_t *tid); 198 int sd_bus_get_owner_creds(sd_bus *bus, uint64_t creds_mask, sd_bus_creds **ret); 199 200 int sd_bus_send(sd_bus *bus, sd_bus_message *m, uint64_t *cookie); 201 int sd_bus_send_to(sd_bus *bus, sd_bus_message *m, const char *destination, uint64_t *cookie); 202 int sd_bus_call(sd_bus *bus, sd_bus_message *m, uint64_t usec, sd_bus_error *ret_error, sd_bus_message **reply); 203 int sd_bus_call_async(sd_bus *bus, sd_bus_slot **slot, sd_bus_message *m, sd_bus_message_handler_t callback, void *userdata, uint64_t usec); 204 205 int sd_bus_get_fd(sd_bus *bus); 206 int sd_bus_get_events(sd_bus *bus); 207 int sd_bus_get_timeout(sd_bus *bus, uint64_t *timeout_usec); 208 int sd_bus_process(sd_bus *bus, sd_bus_message **r); 209 int sd_bus_process_priority(sd_bus *bus, int64_t max_priority, sd_bus_message **r) _sd_deprecated_; 210 int sd_bus_wait(sd_bus *bus, uint64_t timeout_usec); 211 int sd_bus_flush(sd_bus *bus); 212 int sd_bus_enqueue_for_read(sd_bus *bus, sd_bus_message *m); 213 214 sd_bus_slot* sd_bus_get_current_slot(sd_bus *bus); 215 sd_bus_message* sd_bus_get_current_message(sd_bus *bus); 216 sd_bus_message_handler_t sd_bus_get_current_handler(sd_bus *bus); 217 void* sd_bus_get_current_userdata(sd_bus *bus); 218 219 int sd_bus_attach_event(sd_bus *bus, sd_event *e, int priority); 220 int sd_bus_detach_event(sd_bus *bus); 221 sd_event* sd_bus_get_event(sd_bus *bus); 222 223 int sd_bus_get_n_queued_read(sd_bus *bus, uint64_t *ret); 224 int sd_bus_get_n_queued_write(sd_bus *bus, uint64_t *ret); 225 226 int sd_bus_set_method_call_timeout(sd_bus *bus, uint64_t usec); 227 int sd_bus_get_method_call_timeout(sd_bus *bus, uint64_t *ret); 228 229 int sd_bus_add_filter(sd_bus *bus, sd_bus_slot **slot, sd_bus_message_handler_t callback, void *userdata); 230 int sd_bus_add_match(sd_bus *bus, sd_bus_slot **slot, const char *match, sd_bus_message_handler_t callback, void *userdata); 231 int sd_bus_add_match_async(sd_bus *bus, sd_bus_slot **slot, const char *match, sd_bus_message_handler_t callback, sd_bus_message_handler_t install_callback, void *userdata); 232 int sd_bus_add_object(sd_bus *bus, sd_bus_slot **slot, const char *path, sd_bus_message_handler_t callback, void *userdata); 233 int sd_bus_add_fallback(sd_bus *bus, sd_bus_slot **slot, const char *prefix, sd_bus_message_handler_t callback, void *userdata); 234 int sd_bus_add_object_vtable(sd_bus *bus, sd_bus_slot **slot, const char *path, const char *interface, const sd_bus_vtable *vtable, void *userdata); 235 int sd_bus_add_fallback_vtable(sd_bus *bus, sd_bus_slot **slot, const char *prefix, const char *interface, const sd_bus_vtable *vtable, sd_bus_object_find_t find, void *userdata); 236 int sd_bus_add_node_enumerator(sd_bus *bus, sd_bus_slot **slot, const char *path, sd_bus_node_enumerator_t callback, void *userdata); 237 int sd_bus_add_object_manager(sd_bus *bus, sd_bus_slot **slot, const char *path); 238 239 /* Slot object */ 240 241 sd_bus_slot* sd_bus_slot_ref(sd_bus_slot *slot); 242 sd_bus_slot* sd_bus_slot_unref(sd_bus_slot *slot); 243 244 sd_bus* sd_bus_slot_get_bus(sd_bus_slot *slot); 245 void* sd_bus_slot_get_userdata(sd_bus_slot *slot); 246 void* sd_bus_slot_set_userdata(sd_bus_slot *slot, void *userdata); 247 int sd_bus_slot_set_description(sd_bus_slot *slot, const char *description); 248 int sd_bus_slot_get_description(sd_bus_slot *slot, const char **description); 249 int sd_bus_slot_get_floating(sd_bus_slot *slot); 250 int sd_bus_slot_set_floating(sd_bus_slot *slot, int b); 251 int sd_bus_slot_set_destroy_callback(sd_bus_slot *s, sd_bus_destroy_t callback); 252 int sd_bus_slot_get_destroy_callback(sd_bus_slot *s, sd_bus_destroy_t *callback); 253 254 sd_bus_message* sd_bus_slot_get_current_message(sd_bus_slot *slot); 255 sd_bus_message_handler_t sd_bus_slot_get_current_handler(sd_bus_slot *slot); 256 void* sd_bus_slot_get_current_userdata(sd_bus_slot *slot); 257 258 /* Message object */ 259 260 int sd_bus_message_new(sd_bus *bus, sd_bus_message **m, uint8_t type); 261 int sd_bus_message_new_signal(sd_bus *bus, sd_bus_message **m, const char *path, const char *interface, const char *member); 262 int sd_bus_message_new_method_call(sd_bus *bus, sd_bus_message **m, const char *destination, const char *path, const char *interface, const char *member); 263 int sd_bus_message_new_method_return(sd_bus_message *call, sd_bus_message **m); 264 int sd_bus_message_new_method_error(sd_bus_message *call, sd_bus_message **m, const sd_bus_error *e); 265 int sd_bus_message_new_method_errorf(sd_bus_message *call, sd_bus_message **m, const char *name, const char *format, ...) _sd_printf_(4, 5); 266 int sd_bus_message_new_method_errno(sd_bus_message *call, sd_bus_message **m, int error, const sd_bus_error *e); 267 int sd_bus_message_new_method_errnof(sd_bus_message *call, sd_bus_message **m, int error, const char *format, ...) _sd_printf_(4, 5); 268 269 sd_bus_message* sd_bus_message_ref(sd_bus_message *m); 270 sd_bus_message* sd_bus_message_unref(sd_bus_message *m); 271 272 int sd_bus_message_seal(sd_bus_message *m, uint64_t cookie, uint64_t timeout_usec); 273 274 int sd_bus_message_get_type(sd_bus_message *m, uint8_t *type); 275 int sd_bus_message_get_cookie(sd_bus_message *m, uint64_t *cookie); 276 int sd_bus_message_get_reply_cookie(sd_bus_message *m, uint64_t *cookie); 277 int sd_bus_message_get_priority(sd_bus_message *m, int64_t *priority) _sd_deprecated_; 278 279 int sd_bus_message_get_expect_reply(sd_bus_message *m); 280 int sd_bus_message_get_auto_start(sd_bus_message *m); 281 int sd_bus_message_get_allow_interactive_authorization(sd_bus_message *m); 282 283 const char* sd_bus_message_get_signature(sd_bus_message *m, int complete); 284 const char* sd_bus_message_get_path(sd_bus_message *m); 285 const char* sd_bus_message_get_interface(sd_bus_message *m); 286 const char* sd_bus_message_get_member(sd_bus_message *m); 287 const char* sd_bus_message_get_destination(sd_bus_message *m); 288 const char* sd_bus_message_get_sender(sd_bus_message *m); 289 const sd_bus_error* sd_bus_message_get_error(sd_bus_message *m); 290 int sd_bus_message_get_errno(sd_bus_message *m); 291 292 int sd_bus_message_get_monotonic_usec(sd_bus_message *m, uint64_t *usec); 293 int sd_bus_message_get_realtime_usec(sd_bus_message *m, uint64_t *usec); 294 int sd_bus_message_get_seqnum(sd_bus_message *m, uint64_t *seqnum); 295 296 sd_bus* sd_bus_message_get_bus(sd_bus_message *m); 297 sd_bus_creds* sd_bus_message_get_creds(sd_bus_message *m); /* do not unref the result */ 298 299 int sd_bus_message_is_signal(sd_bus_message *m, const char *interface, const char *member); 300 int sd_bus_message_is_method_call(sd_bus_message *m, const char *interface, const char *member); 301 int sd_bus_message_is_method_error(sd_bus_message *m, const char *name); 302 int sd_bus_message_is_empty(sd_bus_message *m); 303 int sd_bus_message_has_signature(sd_bus_message *m, const char *signature); 304 305 int sd_bus_message_set_expect_reply(sd_bus_message *m, int b); 306 int sd_bus_message_set_auto_start(sd_bus_message *m, int b); 307 int sd_bus_message_set_allow_interactive_authorization(sd_bus_message *m, int b); 308 309 int sd_bus_message_set_destination(sd_bus_message *m, const char *destination); 310 int sd_bus_message_set_sender(sd_bus_message *m, const char *sender); 311 int sd_bus_message_set_priority(sd_bus_message *m, int64_t priority) _sd_deprecated_; 312 313 int sd_bus_message_append(sd_bus_message *m, const char *types, ...); 314 int sd_bus_message_appendv(sd_bus_message *m, const char *types, va_list ap); 315 int sd_bus_message_append_basic(sd_bus_message *m, char type, const void *p); 316 int sd_bus_message_append_array(sd_bus_message *m, char type, const void *ptr, size_t size); 317 int sd_bus_message_append_array_space(sd_bus_message *m, char type, size_t size, void **ptr); 318 int sd_bus_message_append_array_iovec(sd_bus_message *m, char type, const struct iovec *iov, unsigned n); 319 int sd_bus_message_append_array_memfd(sd_bus_message *m, char type, int memfd, uint64_t offset, uint64_t size); 320 int sd_bus_message_append_string_space(sd_bus_message *m, size_t size, char **s); 321 int sd_bus_message_append_string_iovec(sd_bus_message *m, const struct iovec *iov, unsigned n); 322 int sd_bus_message_append_string_memfd(sd_bus_message *m, int memfd, uint64_t offset, uint64_t size); 323 int sd_bus_message_append_strv(sd_bus_message *m, char **l); 324 int sd_bus_message_open_container(sd_bus_message *m, char type, const char *contents); 325 int sd_bus_message_close_container(sd_bus_message *m); 326 int sd_bus_message_copy(sd_bus_message *m, sd_bus_message *source, int all); 327 328 int sd_bus_message_read(sd_bus_message *m, const char *types, ...); 329 int sd_bus_message_readv(sd_bus_message *m, const char *types, va_list ap); 330 int sd_bus_message_read_basic(sd_bus_message *m, char type, void *p); 331 int sd_bus_message_read_array(sd_bus_message *m, char type, const void **ptr, size_t *size); 332 int sd_bus_message_read_strv(sd_bus_message *m, char ***l); /* free the result! */ 333 int sd_bus_message_skip(sd_bus_message *m, const char *types); 334 int sd_bus_message_enter_container(sd_bus_message *m, char type, const char *contents); 335 int sd_bus_message_exit_container(sd_bus_message *m); 336 int sd_bus_message_peek_type(sd_bus_message *m, char *type, const char **contents); 337 int sd_bus_message_verify_type(sd_bus_message *m, char type, const char *contents); 338 int sd_bus_message_at_end(sd_bus_message *m, int complete); 339 int sd_bus_message_rewind(sd_bus_message *m, int complete); 340 int sd_bus_message_sensitive(sd_bus_message *m); 341 342 int sd_bus_message_dump(sd_bus_message *m, FILE *f, uint64_t flags); 343 344 /* Bus management */ 345 346 int sd_bus_get_unique_name(sd_bus *bus, const char **unique); 347 int sd_bus_request_name(sd_bus *bus, const char *name, uint64_t flags); 348 int sd_bus_request_name_async(sd_bus *bus, sd_bus_slot **ret_slot, const char *name, uint64_t flags, sd_bus_message_handler_t callback, void *userdata); 349 int sd_bus_release_name(sd_bus *bus, const char *name); 350 int sd_bus_release_name_async(sd_bus *bus, sd_bus_slot **ret_slot, const char *name, sd_bus_message_handler_t callback, void *userdata); 351 int sd_bus_list_names(sd_bus *bus, char ***acquired, char ***activatable); /* free the results */ 352 int sd_bus_get_name_creds(sd_bus *bus, const char *name, uint64_t mask, sd_bus_creds **creds); /* unref the result! */ 353 int sd_bus_get_name_machine_id(sd_bus *bus, const char *name, sd_id128_t *machine); 354 355 /* Convenience calls */ 356 357 int sd_bus_message_send(sd_bus_message *m); 358 int sd_bus_call_methodv(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, sd_bus_message **reply, const char *types, va_list ap); 359 int sd_bus_call_method(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, sd_bus_message **reply, const char *types, ...); 360 int sd_bus_call_method_asyncv(sd_bus *bus, sd_bus_slot **slot, const char *destination, const char *path, const char *interface, const char *member, sd_bus_message_handler_t callback, void *userdata, const char *types, va_list ap); 361 int sd_bus_call_method_async(sd_bus *bus, sd_bus_slot **slot, const char *destination, const char *path, const char *interface, const char *member, sd_bus_message_handler_t callback, void *userdata, const char *types, ...); 362 int sd_bus_get_property(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, sd_bus_message **reply, const char *type); 363 int sd_bus_get_property_trivial(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, char type, void *ret_ptr); 364 int sd_bus_get_property_string(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, char **ret); /* free the result! */ 365 int sd_bus_get_property_strv(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, char ***ret); /* free the result! */ 366 int sd_bus_set_propertyv(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, const char *type, va_list ap); 367 int sd_bus_set_property(sd_bus *bus, const char *destination, const char *path, const char *interface, const char *member, sd_bus_error *ret_error, const char *type, ...); 368 369 int sd_bus_reply_method_returnv(sd_bus_message *call, const char *types, va_list ap); 370 int sd_bus_reply_method_return(sd_bus_message *call, const char *types, ...); 371 int sd_bus_reply_method_error(sd_bus_message *call, const sd_bus_error *e); 372 int sd_bus_reply_method_errorfv(sd_bus_message *call, const char *name, const char *format, va_list ap) _sd_printf_(3, 0); 373 int sd_bus_reply_method_errorf(sd_bus_message *call, const char *name, const char *format, ...) _sd_printf_(3, 4); 374 int sd_bus_reply_method_errno(sd_bus_message *call, int error, const sd_bus_error *e); 375 int sd_bus_reply_method_errnofv(sd_bus_message *call, int error, const char *format, va_list ap) _sd_printf_(3, 0); 376 int sd_bus_reply_method_errnof(sd_bus_message *call, int error, const char *format, ...) _sd_printf_(3, 4); 377 378 int sd_bus_emit_signalv(sd_bus *bus, const char *path, const char *interface, const char *member, const char *types, va_list ap); 379 int sd_bus_emit_signal(sd_bus *bus, const char *path, const char *interface, const char *member, const char *types, ...); 380 381 int sd_bus_emit_properties_changed_strv(sd_bus *bus, const char *path, const char *interface, char **names); 382 int sd_bus_emit_properties_changed(sd_bus *bus, const char *path, const char *interface, const char *name, ...) _sd_sentinel_; 383 384 int sd_bus_emit_object_added(sd_bus *bus, const char *path); 385 int sd_bus_emit_object_removed(sd_bus *bus, const char *path); 386 int sd_bus_emit_interfaces_added_strv(sd_bus *bus, const char *path, char **interfaces); 387 int sd_bus_emit_interfaces_added(sd_bus *bus, const char *path, const char *interface, ...) _sd_sentinel_; 388 int sd_bus_emit_interfaces_removed_strv(sd_bus *bus, const char *path, char **interfaces); 389 int sd_bus_emit_interfaces_removed(sd_bus *bus, const char *path, const char *interface, ...) _sd_sentinel_; 390 391 int sd_bus_query_sender_creds(sd_bus_message *m, uint64_t mask, sd_bus_creds **creds); 392 int sd_bus_query_sender_privilege(sd_bus_message *m, int capability); 393 394 int sd_bus_match_signal(sd_bus *bus, sd_bus_slot **ret, const char *sender, const char *path, const char *interface, const char *member, sd_bus_message_handler_t callback, void *userdata); 395 int sd_bus_match_signal_async(sd_bus *bus, sd_bus_slot **ret, const char *sender, const char *path, const char *interface, const char *member, sd_bus_message_handler_t match_callback, sd_bus_message_handler_t add_callback, void *userdata); 396 397 /* Credential handling */ 398 399 int sd_bus_creds_new_from_pid(sd_bus_creds **ret, pid_t pid, uint64_t creds_mask); 400 sd_bus_creds* sd_bus_creds_ref(sd_bus_creds *c); 401 sd_bus_creds* sd_bus_creds_unref(sd_bus_creds *c); 402 uint64_t sd_bus_creds_get_mask(const sd_bus_creds *c); 403 uint64_t sd_bus_creds_get_augmented_mask(const sd_bus_creds *c); 404 405 int sd_bus_creds_get_pid(sd_bus_creds *c, pid_t *pid); 406 int sd_bus_creds_get_ppid(sd_bus_creds *c, pid_t *ppid); 407 int sd_bus_creds_get_tid(sd_bus_creds *c, pid_t *tid); 408 int sd_bus_creds_get_uid(sd_bus_creds *c, uid_t *uid); 409 int sd_bus_creds_get_euid(sd_bus_creds *c, uid_t *euid); 410 int sd_bus_creds_get_suid(sd_bus_creds *c, uid_t *suid); 411 int sd_bus_creds_get_fsuid(sd_bus_creds *c, uid_t *fsuid); 412 int sd_bus_creds_get_gid(sd_bus_creds *c, gid_t *gid); 413 int sd_bus_creds_get_egid(sd_bus_creds *c, gid_t *egid); 414 int sd_bus_creds_get_sgid(sd_bus_creds *c, gid_t *sgid); 415 int sd_bus_creds_get_fsgid(sd_bus_creds *c, gid_t *fsgid); 416 int sd_bus_creds_get_supplementary_gids(sd_bus_creds *c, const gid_t **gids); 417 int sd_bus_creds_get_comm(sd_bus_creds *c, const char **comm); 418 int sd_bus_creds_get_tid_comm(sd_bus_creds *c, const char **comm); 419 int sd_bus_creds_get_exe(sd_bus_creds *c, const char **exe); 420 int sd_bus_creds_get_cmdline(sd_bus_creds *c, char ***cmdline); 421 int sd_bus_creds_get_cgroup(sd_bus_creds *c, const char **cgroup); 422 int sd_bus_creds_get_unit(sd_bus_creds *c, const char **unit); 423 int sd_bus_creds_get_slice(sd_bus_creds *c, const char **slice); 424 int sd_bus_creds_get_user_unit(sd_bus_creds *c, const char **unit); 425 int sd_bus_creds_get_user_slice(sd_bus_creds *c, const char **slice); 426 int sd_bus_creds_get_session(sd_bus_creds *c, const char **session); 427 int sd_bus_creds_get_owner_uid(sd_bus_creds *c, uid_t *uid); 428 int sd_bus_creds_has_effective_cap(sd_bus_creds *c, int capability); 429 int sd_bus_creds_has_permitted_cap(sd_bus_creds *c, int capability); 430 int sd_bus_creds_has_inheritable_cap(sd_bus_creds *c, int capability); 431 int sd_bus_creds_has_bounding_cap(sd_bus_creds *c, int capability); 432 int sd_bus_creds_get_selinux_context(sd_bus_creds *c, const char **context); 433 int sd_bus_creds_get_audit_session_id(sd_bus_creds *c, uint32_t *sessionid); 434 int sd_bus_creds_get_audit_login_uid(sd_bus_creds *c, uid_t *loginuid); 435 int sd_bus_creds_get_tty(sd_bus_creds *c, const char **tty); 436 int sd_bus_creds_get_unique_name(sd_bus_creds *c, const char **name); 437 int sd_bus_creds_get_well_known_names(sd_bus_creds *c, char ***names); 438 int sd_bus_creds_get_description(sd_bus_creds *c, const char **name); 439 440 /* Error structures */ 441 442 #define SD_BUS_ERROR_MAKE_CONST(name, message) ((const sd_bus_error) {(name), (message), 0}) 443 #define SD_BUS_ERROR_NULL SD_BUS_ERROR_MAKE_CONST(NULL, NULL) 444 445 void sd_bus_error_free(sd_bus_error *e); 446 int sd_bus_error_set(sd_bus_error *e, const char *name, const char *message); 447 int sd_bus_error_setf(sd_bus_error *e, const char *name, const char *format, ...) _sd_printf_(3, 4); 448 int sd_bus_error_set_const(sd_bus_error *e, const char *name, const char *message); 449 int sd_bus_error_set_errno(sd_bus_error *e, int error); 450 int sd_bus_error_set_errnof(sd_bus_error *e, int error, const char *format, ...) _sd_printf_(3, 4); 451 int sd_bus_error_set_errnofv(sd_bus_error *e, int error, const char *format, va_list ap) _sd_printf_(3,0); 452 int sd_bus_error_get_errno(const sd_bus_error *e); 453 int sd_bus_error_copy(sd_bus_error *dest, const sd_bus_error *e); 454 int sd_bus_error_move(sd_bus_error *dest, sd_bus_error *e); 455 int sd_bus_error_is_set(const sd_bus_error *e); 456 int sd_bus_error_has_name(const sd_bus_error *e, const char *name); 457 int sd_bus_error_has_names_sentinel(const sd_bus_error *e, ...) _sd_sentinel_; 458 #define sd_bus_error_has_names(e, ...) sd_bus_error_has_names_sentinel(e, __VA_ARGS__, NULL) 459 460 #define SD_BUS_ERROR_MAP(_name, _code) \ 461 { \ 462 .name = _name, \ 463 .code = _code, \ 464 } 465 #define SD_BUS_ERROR_MAP_END \ 466 { \ 467 .name = NULL, \ 468 .code = - 'x', \ 469 } 470 471 int sd_bus_error_add_map(const sd_bus_error_map *map); 472 473 /* Auxiliary macros */ 474 475 #define SD_BUS_MESSAGE_APPEND_ID128(x) 16, \ 476 (x).bytes[0], (x).bytes[1], (x).bytes[2], (x).bytes[3], \ 477 (x).bytes[4], (x).bytes[5], (x).bytes[6], (x).bytes[7], \ 478 (x).bytes[8], (x).bytes[9], (x).bytes[10], (x).bytes[11], \ 479 (x).bytes[12], (x).bytes[13], (x).bytes[14], (x).bytes[15] 480 481 #define SD_BUS_MESSAGE_READ_ID128(x) 16, \ 482 &(x).bytes[0], &(x).bytes[1], &(x).bytes[2], &(x).bytes[3], \ 483 &(x).bytes[4], &(x).bytes[5], &(x).bytes[6], &(x).bytes[7], \ 484 &(x).bytes[8], &(x).bytes[9], &(x).bytes[10], &(x).bytes[11], \ 485 &(x).bytes[12], &(x).bytes[13], &(x).bytes[14], &(x).bytes[15] 486 487 /* Label escaping */ 488 489 int sd_bus_path_encode(const char *prefix, const char *external_id, char **ret_path); 490 int sd_bus_path_encode_many(char **out, const char *path_template, ...); 491 int sd_bus_path_decode(const char *path, const char *prefix, char **ret_external_id); 492 int sd_bus_path_decode_many(const char *path, const char *path_template, ...); 493 494 /* Tracking peers */ 495 496 int sd_bus_track_new(sd_bus *bus, sd_bus_track **track, sd_bus_track_handler_t handler, void *userdata); 497 sd_bus_track* sd_bus_track_ref(sd_bus_track *track); 498 sd_bus_track* sd_bus_track_unref(sd_bus_track *track); 499 500 sd_bus* sd_bus_track_get_bus(sd_bus_track *track); 501 void* sd_bus_track_get_userdata(sd_bus_track *track); 502 void* sd_bus_track_set_userdata(sd_bus_track *track, void *userdata); 503 504 int sd_bus_track_add_sender(sd_bus_track *track, sd_bus_message *m); 505 int sd_bus_track_remove_sender(sd_bus_track *track, sd_bus_message *m); 506 int sd_bus_track_add_name(sd_bus_track *track, const char *name); 507 int sd_bus_track_remove_name(sd_bus_track *track, const char *name); 508 509 int sd_bus_track_set_recursive(sd_bus_track *track, int b); 510 int sd_bus_track_get_recursive(sd_bus_track *track); 511 512 unsigned sd_bus_track_count(sd_bus_track *track); 513 int sd_bus_track_count_sender(sd_bus_track *track, sd_bus_message *m); 514 int sd_bus_track_count_name(sd_bus_track *track, const char *name); 515 516 const char* sd_bus_track_contains(sd_bus_track *track, const char *name); 517 const char* sd_bus_track_first(sd_bus_track *track); 518 const char* sd_bus_track_next(sd_bus_track *track); 519 520 int sd_bus_track_set_destroy_callback(sd_bus_track *s, sd_bus_destroy_t callback); 521 int sd_bus_track_get_destroy_callback(sd_bus_track *s, sd_bus_destroy_t *ret); 522 523 /* Define helpers so that __attribute__((cleanup(sd_bus_unrefp))) and similar may be used. */ 524 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus, sd_bus_unref); 525 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus, sd_bus_close_unref); 526 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus, sd_bus_flush_close_unref); 527 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus_slot, sd_bus_slot_unref); 528 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus_message, sd_bus_message_unref); 529 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus_creds, sd_bus_creds_unref); 530 _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_bus_track, sd_bus_track_unref); 531 532 _SD_END_DECLARATIONS; 533 534 #endif 535