5 * Copyright (C) 2004-2011 Marcel Holtmann <marcel@holtmann.org>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
31 #include <dbus/dbus.h>
34 typedef void (* GDBusWatchFunction) (DBusConnection *connection,
37 typedef gboolean (* GDBusSignalFunction) (DBusConnection *connection,
38 DBusMessage *message, void *user_data);
40 DBusConnection *g_dbus_setup_bus(DBusBusType type, const char *name,
43 DBusConnection *g_dbus_setup_private(DBusBusType type, const char *name,
46 gboolean g_dbus_request_name(DBusConnection *connection, const char *name,
49 gboolean g_dbus_set_disconnect_function(DBusConnection *connection,
50 GDBusWatchFunction function,
51 void *user_data, DBusFreeFunction destroy);
53 typedef void (* GDBusDestroyFunction) (void *user_data);
55 typedef DBusMessage * (* GDBusMethodFunction) (DBusConnection *connection,
56 DBusMessage *message, void *user_data);
58 typedef guint32 GDBusPendingReply;
60 typedef void (* GDBusSecurityFunction) (DBusConnection *connection,
63 GDBusPendingReply pending);
66 G_DBUS_METHOD_FLAG_DEPRECATED = (1 << 0),
67 G_DBUS_METHOD_FLAG_NOREPLY = (1 << 1),
68 G_DBUS_METHOD_FLAG_ASYNC = (1 << 2),
72 G_DBUS_SIGNAL_FLAG_DEPRECATED = (1 << 0),
76 G_DBUS_PROPERTY_FLAG_DEPRECATED = (1 << 0),
80 G_DBUS_SECURITY_FLAG_DEPRECATED = (1 << 0),
81 G_DBUS_SECURITY_FLAG_BUILTIN = (1 << 1),
82 G_DBUS_SECURITY_FLAG_ALLOW_INTERACTION = (1 << 2),
87 const char *signature;
92 GDBusMethodFunction function;
93 GDBusMethodFlags flags;
94 unsigned int privilege;
95 const GDBusArgInfo *in_args;
96 const GDBusArgInfo *out_args;
101 GDBusSignalFlags flags;
102 const GDBusArgInfo *args;
108 GDBusPropertyFlags flags;
109 } GDBusPropertyTable;
112 unsigned int privilege;
114 GDBusSecurityFlags flags;
115 GDBusSecurityFunction function;
116 } GDBusSecurityTable;
118 #define GDBUS_ARGS(args...) (const GDBusArgInfo[]) { args, { } }
120 #define GDBUS_METHOD(_name, _in_args, _out_args, _function) \
122 .in_args = _in_args, \
123 .out_args = _out_args, \
124 .function = _function
126 #define GDBUS_ASYNC_METHOD(_name, _in_args, _out_args, _function) \
128 .in_args = _in_args, \
129 .out_args = _out_args, \
130 .function = _function, \
131 .flags = G_DBUS_METHOD_FLAG_ASYNC
133 #define GDBUS_DEPRECATED_METHOD(_name, _in_args, _out_args, _function) \
135 .in_args = _in_args, \
136 .out_args = _out_args, \
137 .function = _function, \
138 .flags = G_DBUS_METHOD_FLAG_DEPRECATED
140 #define GDBUS_DEPRECATED_ASYNC_METHOD(_name, _in_args, _out_args, _function) \
142 .in_args = _in_args, \
143 .out_args = _out_args, \
144 .function = _function, \
145 .flags = G_DBUS_METHOD_FLAG_ASYNC | G_DBUS_METHOD_FLAG_DEPRECATED
147 #define GDBUS_SIGNAL(_name, _args) \
151 #define GDBUS_DEPRECATED_SIGNAL(_name, _args) \
154 .flags = G_DBUS_SIGNAL_FLAG_DEPRECATED
156 gboolean g_dbus_register_interface(DBusConnection *connection,
157 const char *path, const char *name,
158 const GDBusMethodTable *methods,
159 const GDBusSignalTable *signals,
160 const GDBusPropertyTable *properties,
162 GDBusDestroyFunction destroy);
163 gboolean g_dbus_unregister_interface(DBusConnection *connection,
164 const char *path, const char *name);
166 gboolean g_dbus_register_security(const GDBusSecurityTable *security);
167 gboolean g_dbus_unregister_security(const GDBusSecurityTable *security);
169 void g_dbus_pending_success(DBusConnection *connection,
170 GDBusPendingReply pending);
171 void g_dbus_pending_error(DBusConnection *connection,
172 GDBusPendingReply pending,
173 const char *name, const char *format, ...)
174 __attribute__((format(printf, 4, 5)));
175 void g_dbus_pending_error_valist(DBusConnection *connection,
176 GDBusPendingReply pending, const char *name,
177 const char *format, va_list args);
179 DBusMessage *g_dbus_create_error(DBusMessage *message, const char *name,
180 const char *format, ...)
181 __attribute__((format(printf, 3, 4)));
182 DBusMessage *g_dbus_create_error_valist(DBusMessage *message, const char *name,
183 const char *format, va_list args);
184 DBusMessage *g_dbus_create_reply(DBusMessage *message, int type, ...);
185 DBusMessage *g_dbus_create_reply_valist(DBusMessage *message,
186 int type, va_list args);
188 gboolean g_dbus_send_message(DBusConnection *connection, DBusMessage *message);
189 gboolean g_dbus_send_reply(DBusConnection *connection,
190 DBusMessage *message, int type, ...);
191 gboolean g_dbus_send_reply_valist(DBusConnection *connection,
192 DBusMessage *message, int type, va_list args);
194 gboolean g_dbus_emit_signal(DBusConnection *connection,
195 const char *path, const char *interface,
196 const char *name, int type, ...);
197 gboolean g_dbus_emit_signal_valist(DBusConnection *connection,
198 const char *path, const char *interface,
199 const char *name, int type, va_list args);
201 guint g_dbus_add_service_watch(DBusConnection *connection, const char *name,
202 GDBusWatchFunction connect,
203 GDBusWatchFunction disconnect,
204 void *user_data, GDBusDestroyFunction destroy);
205 guint g_dbus_add_disconnect_watch(DBusConnection *connection, const char *name,
206 GDBusWatchFunction function,
207 void *user_data, GDBusDestroyFunction destroy);
208 guint g_dbus_add_signal_watch(DBusConnection *connection,
209 const char *sender, const char *path,
210 const char *interface, const char *member,
211 GDBusSignalFunction function, void *user_data,
212 GDBusDestroyFunction destroy);
213 gboolean g_dbus_remove_watch(DBusConnection *connection, guint tag);
214 void g_dbus_remove_all_watches(DBusConnection *connection);
220 #endif /* __GDBUS_H */