GDBusDestroyFunction ()

void                (*GDBusDestroyFunction)             (void *user_data);

Destroy function

GDBusWatchFunction ()

void                (*GDBusWatchFunction)               (void *user_data);

Watch function

GDBusSignalFunction ()

gboolean            (*GDBusSignalFunction)              (DBusConnection *connection,
                                                         DBusMessage *message,
                                                         void *user_data);

Signal function

GDBusMethodFunction ()

DBusMessage *       (*GDBusMethodFunction)              (DBusConnection *connection,
                                                         DBusMessage *message,
                                                         void *user_data);

Method function

GDBusPropertyGetFunction ()

dbus_bool_t         (*GDBusPropertyGetFunction)         (DBusConnection *connection,
                                                         DBusMessageIter *iter,
                                                         void *user_data);

Property get function

GDBusPropertySetFunction ()

dbus_bool_t         (*GDBusPropertySetFunction)         (DBusConnection *connection,
                                                         DBusMessageIter *iter,
                                                         void *user_data);

Property set function

enum GDBusMethodFlags

typedef enum {
	G_DBUS_METHOD_FLAG_DEPRECATED = (1 << 0),
	G_DBUS_METHOD_FLAG_NOREPLY    = (1 << 1),
	G_DBUS_METHOD_FLAG_ASYNC      = (1 << 2),
} GDBusMethodFlags;

Method flags

enum GDBusSignalFlags

typedef enum {
	G_DBUS_SIGNAL_FLAG_DEPRECATED = (1 << 0),
} GDBusSignalFlags;

Signal flags

enum GDBusPropertyFlags

typedef enum {
	G_DBUS_PROPERTY_FLAG_DEPRECATED = (1 << 0),
} GDBusPropertyFlags;

Property flags

GDBusMethodTable

typedef struct {
	const char *name;
	const char *signature;
	const char *reply;
	GDBusMethodFunction function;
	GDBusMethodFlags flags;
} GDBusMethodTable;

Method table

GDBusSignalTable

typedef struct {
	const char *name;
	const char *signature;
	GDBusSignalFlags flags;
} GDBusSignalTable;

Signal table

GDBusPropertyTable

typedef struct {
	const char *name;
	const char *type;
	GDBusPropertyGetFunction get;
	GDBusPropertyGetFunction set;
	GDBusPropertyFlags flags;
} GDBusPropertyTable;

Property table

g_dbus_setup_connection ()

void                g_dbus_setup_connection             (DBusConnection *connection,
                                                         GMainContext *context);

Setup connection with main context

Sets the watch and timeout functions of a DBusConnection to integrate the connection with the GLib main loop. Pass in NULL for the GMainContext unless you're doing something specialized.

g_dbus_cleanup_connection ()

void                g_dbus_cleanup_connection           (DBusConnection *connection);

Cleanup the setup of DBusConnection and free the allocated memory.

g_dbus_setup_bus ()

DBusConnection *    g_dbus_setup_bus                    (DBusBusType type,
                                                         const char *name,
                                                         DBusError *error);

Connect to bus and setup connection

Returns a connection to the given bus and requests a well known name for it. Sets the watch and timeout functions for it.

g_dbus_setup_address ()

DBusConnection *    g_dbus_setup_address                (const char *address,
                                                         DBusError *error);

Connect to bus and setup connection

Returns a connection to the bus specified via the given address and sets the watch and timeout functions for it.

g_dbus_request_name ()

gboolean            g_dbus_request_name                 (DBusConnection *connection,
                                                         const char *name,
                                                         DBusError *error);

Requests a well known name for connection.

g_dbus_set_disconnect_function ()

gboolean            g_dbus_set_disconnect_function      (DBusConnection *connection,
                                                         GDBusWatchFunction function,
                                                         void *user_data,
                                                         GDBusDestroyFunction destroy);

Set a callback function that will be called when the D-Bus message bus exits.

g_dbus_register_interface ()

gboolean            g_dbus_register_interface           (DBusConnection *connection,
                                                         const char *path,
                                                         const char *name,
                                                         GDBusMethodTable *methods,
                                                         GDBusSignalTable *signals,
                                                         GDBusPropertyTable *properties,
                                                         void *user_data,
                                                         GDBusDestroyFunction destroy);

Registers an interface for the given path in the object hierarchy with the given methods, signals and/or properties.

g_dbus_unregister_interface ()

gboolean            g_dbus_unregister_interface         (DBusConnection *connection,
                                                         const char *path,
                                                         const char *name);

Unregister the given interface for the given path in the object hierarchy.

g_dbus_create_error ()

DBusMessage *       g_dbus_create_error                 (DBusMessage *message,
                                                         const char *name,
                                                         const char *format,
                                                         ...);

Create error reply for the given message.

g_dbus_create_error_valist ()

DBusMessage *       g_dbus_create_error_valist          (DBusMessage *message,
                                                         const char *name,
                                                         const char *format,
                                                         va_list args);

Create error reply for the given message.

g_dbus_create_reply ()

DBusMessage *       g_dbus_create_reply                 (DBusMessage *message,
                                                         int type,
                                                         ...);

Create reply for the given message.

g_dbus_create_reply_valist ()

DBusMessage *       g_dbus_create_reply_valist          (DBusMessage *message,
                                                         int type,
                                                         va_list args);

Create reply for the given message.

g_dbus_send_message ()

gboolean            g_dbus_send_message                 (DBusConnection *connection,
                                                         DBusMessage *message);

Send message via the given D-Bus connection.

The reference count for the message will be decremented by this function.

g_dbus_send_error ()

gboolean            g_dbus_send_error                   (DBusConnection *connection,
                                                         DBusMessage *message,
                                                         const char *name,
                                                         const char *format,
                                                         ...);

Send error reply for the given message and via the given D-Bus connection.

g_dbus_send_reply ()

gboolean            g_dbus_send_reply                   (DBusConnection *connection,
                                                         DBusMessage *message,
                                                         int type,
                                                         ...);

Send reply for the given message and via the given D-Bus connection.

g_dbus_send_reply_valist ()

gboolean            g_dbus_send_reply_valist            (DBusConnection *connection,
                                                         DBusMessage *message,
                                                         int type,
                                                         va_list args);

Send reply for the given message and via the given D-Bus connection.

g_dbus_emit_signal ()

gboolean            g_dbus_emit_signal                  (DBusConnection *connection,
                                                         const char *path,
                                                         const char *interface,
                                                         const char *name,
                                                         int type,
                                                         ...);

Emit a signal for the given path and interface with the given signal name.

The signal signature will be check against the registered signal table.

g_dbus_emit_signal_valist ()

gboolean            g_dbus_emit_signal_valist           (DBusConnection *connection,
                                                         const char *path,
                                                         const char *interface,
                                                         const char *name,
                                                         int type,
                                                         va_list args);

Emit a signal for the given path and interface with the given signal name.

The signal signature will be check against the registered signal table.

g_dbus_add_service_watch ()

guint               g_dbus_add_service_watch            (DBusConnection *connection,
                                                         const char *name,
                                                         GDBusWatchFunction connect,
                                                         GDBusWatchFunction disconnect,
                                                         void *user_data,
                                                         GDBusDestroyFunction destroy);

Add new watch to listen for connects and/or disconnects of a client for the given connection.

g_dbus_add_disconnect_watch ()

guint               g_dbus_add_disconnect_watch         (DBusConnection *connection,
                                                         const char *name,
                                                         GDBusWatchFunction function,
                                                         void *user_data,
                                                         GDBusDestroyFunction destroy);

Add new watch to listen for disconnect of a client for the given connection.

After the callback has been called, this watch will be automatically removed.

g_dbus_add_signal_watch ()

guint               g_dbus_add_signal_watch             (DBusConnection *connection,
                                                         const char *rule,
                                                         GDBusSignalFunction function,
                                                         void *user_data,
                                                         GDBusDestroyFunction destroy);

Add new watch to listen for specific signals of a client for the given connection.

If the callback returns FALSE this watch will be automatically removed.

g_dbus_remove_watch ()

gboolean            g_dbus_remove_watch                 (DBusConnection *connection,
                                                         guint tag);

Removes the watch for the given identifier.

g_dbus_remove_all_watches ()

void                g_dbus_remove_all_watches           (DBusConnection *connection);

Removes all registered watches.