aboutsummaryrefslogtreecommitdiffstats
path: root/include/swaybar/tray/dbus.h
blob: 125ce96f80b3f74d5f6ad2a027860f28259db1b4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
#ifndef _SWAYBAR_DBUS_H
#define _SWAYBAR_DBUS_H

#include <stdbool.h>
#include <dbus/dbus.h>
extern DBusConnection *conn;

/**
 * Checks the signature of the given iter against `sig`. Prefer to
 * `dbus_message_iter_get_signature` as this one frees the intermediate string.
 */
bool dbus_message_iter_check_signature(DBusMessageIter *iter, const char *sig);

/**
 * Fetches the property and calls `callback` with a message iter pointing it.
 * Performs error handling and signature checking.
 *
 * Returns: true if message is successfully sent (will not necessarily arrive)
 * and false otherwise
 *
 * NOTE: `expected_signature` must remain valid until the message reply is
 * received, please only use 'static signatures.
 */
bool dbus_get_prop_async(const char *destination,
		const char *path,
		const char *iface,
		const char *prop,
		const char *expected_signature,
		void(*callback)(DBusMessageIter *iter, void *data),
		void *data);
/**
 * Should be called in main loop to dispatch events
 */
void dispatch_dbus();

/**
 * Initializes async dbus communication
 */
int dbus_init();

#endif /* _SWAYBAR_DBUS_H */