dbus_g_bus_get ()

DBusGConnection *
dbus_g_bus_get (DBusBusType type,
                GError **error);

Returns a connection to the given bus. The connection is a global variable shared with other callers of this function.

(Internally, calls dbus_bus_get() then calls dbus_connection_setup_with_g_main() on the result.)

dbus_g_bus_get_private ()

DBusGConnection *
dbus_g_bus_get_private (DBusBusType type,
                        GMainContext *context,
                        GError **error);

Returns a connection to the given bus. The connection will be a private non-shared connection and should be closed when usage is complete.

Internally this function calls dbus_bus_get_private() then calls dbus_connection_setup_with_g_main() on the result; see the documentation of the former function for more information on private connections.

dbus_g_thread_init ()

void
dbus_g_thread_init (void);

Initializes the D-BUS thread system. This function may only be called once and must be called prior to calling any other function in the D-BUS API.

Equivalent to dbus_threads_init_default(), which does nothing. dbus-glib requires dbus >= 1.8, which is thread-safe by default.

Note that dbus-glib's GObject mapping is explicitly *not* thread-safe.

dbus_g_connection_open ()

DBusGConnection *
dbus_g_connection_open (const gchar *address,
                        GError **error);

Returns a connection to the given address.

(Internally, calls dbus_connection_open() then calls dbus_connection_setup_with_g_main() on the result.)

dbus_g_connection_ref ()

DBusGConnection *
dbus_g_connection_ref (DBusGConnection *connection);

Increment refcount on a DBusGConnection

dbus_g_connection_unref ()

void
dbus_g_connection_unref (DBusGConnection *connection);

Decrement refcount on a DBusGConnection

dbus_g_connection_flush ()

void
dbus_g_connection_flush (DBusGConnection *connection);

Blocks until outgoing calls and signal emissions have been sent.

dbus_g_connection_get_connection ()

DBusConnection *
dbus_g_connection_get_connection (DBusGConnection *gconnection);

Get the DBusConnection corresponding to this DBusGConnection. The return value does not have its refcount incremented.

dbus_g_connection_register_g_object ()

void
dbus_g_connection_register_g_object (DBusGConnection *connection,
                                     const char *at_path,
                                     GObject *object);

Registers a GObject at the given path. Properties, methods, and signals of the object can then be accessed remotely. Methods are only available if method introspection data has been added to the object's class with dbus_g_object_type_install_info().

The registration will be cancelled if either the DBusConnection or the GObject gets finalized, or if dbus_g_connection_unregister_g_object() is used.

Note: If an object is registered multiple times, the first registration takes priority for cases such as turning an object into an object path.

dbus_g_connection_unregister_g_object ()

void
dbus_g_connection_unregister_g_object (DBusGConnection *connection,
                                       GObject *object);

Removes object from any object paths at which it is exported on connection . Properties, methods, and signals of the object can no longer be accessed remotely.

dbus_g_connection_lookup_g_object ()

GObject *
dbus_g_connection_lookup_g_object (DBusGConnection *connection,
                                   const char *at_path);

FIXME

DBusGConnection

typedef struct _DBusGConnection DBusGConnection;

A DBusGConnection is a boxed type abstracting a DBusConnection from libdbus.

DBUS_TYPE_G_CONNECTION

#define DBUS_TYPE_G_CONNECTION   (dbus_g_connection_get_g_type ())

Expands to a function call returning the boxed GType of a DBusGConnection.