Functions | |
DBusConnection * | dbus_bus_get (DBusBusType type, DBusError *error) |
Connects to a bus daemon and registers the client with it. | |
dbus_bool_t | dbus_bus_register (DBusConnection *connection, DBusError *error) |
Registers a connection with the bus. | |
dbus_bool_t | dbus_bus_set_base_service (DBusConnection *connection, const char *base_service) |
Sets the base service name of the connection. | |
const char * | dbus_bus_get_base_service (DBusConnection *connection) |
Gets the base service name of the connection. | |
int | dbus_bus_acquire_service (DBusConnection *connection, const char *service_name, unsigned int flags, DBusError *error) |
Asks the bus to try to acquire a certain service. | |
dbus_bool_t | dbus_bus_service_exists (DBusConnection *connection, const char *service_name, DBusError *error) |
Checks whether a certain service exists. | |
dbus_bool_t | dbus_bus_activate_service (DBusConnection *connection, const char *service_name, dbus_uint32_t flags, dbus_uint32_t *result, DBusError *error) |
Activates a given service. | |
void | dbus_bus_add_match (DBusConnection *connection, const char *rule, DBusError *error) |
Adds a match rule to match messages going through the message bus. | |
void | dbus_bus_remove_match (DBusConnection *connection, const char *rule, DBusError *error) |
Removes a previously-added match rule "by value" (the most recently-added identical rule gets removed). |
|
Asks the bus to try to acquire a certain service.
Definition at line 564 of file dbus-bus.c. References dbus_connection_send_with_reply_and_block(), dbus_message_append_args(), dbus_message_get_args(), dbus_message_new_method_call(), dbus_message_unref(), dbus_set_error_from_message(), dbus_uint32_t, and NULL. |
|
Activates a given service.
Definition at line 706 of file dbus-bus.c. References dbus_connection_send_with_reply_and_block(), dbus_message_append_args(), dbus_message_get_args(), dbus_message_new_method_call(), dbus_message_unref(), dbus_set_error_from_message(), dbus_uint32_t, FALSE, NULL, and TRUE. |
|
Adds a match rule to match messages going through the message bus. The "rule" argument is the string form of a match rule. If you pass NULL for the error, this function will not block; the match thus won't be added until you flush the connection, and if there's an error adding the match (only possible error is lack of resources in the bus), you won't find out about it. If you pass non-NULL for the error this function will block until it gets a reply. Normal API conventions would have the function return a boolean value indicating whether the error was set, but that would require blocking always to determine the return value.
Definition at line 817 of file dbus-bus.c. References dbus_message_append_args(), dbus_message_new_method_call(), and dbus_message_unref(). |
|
Connects to a bus daemon and registers the client with it. If a connection to the bus already exists, then that connection is returned.
Definition at line 325 of file dbus-bus.c. References _dbus_assert, _DBUS_LOCK, _DBUS_UNLOCK, dbus_bus_register(), dbus_connection_disconnect(), dbus_connection_open(), dbus_connection_ref(), dbus_connection_set_exit_on_disconnect(), dbus_connection_unref(), dbus_set_error(), BusData::is_well_known, N_BUS_TYPES, NULL, and TRUE. Referenced by dbus_bus_get_with_g_main(). |
|
Gets the base service name of the connection. Only possible after the connection has been registered with the message bus.
Definition at line 535 of file dbus-bus.c. References BusData::base_service, and NULL. |
|
Registers a connection with the bus. This must be the first thing an application does when connecting to the message bus. If registration succeeds, the base service name will be set, and can be obtained using dbus_bus_get_base_service().
Definition at line 428 of file dbus-bus.c. References _dbus_warn(), BusData::base_service, dbus_bool_t, dbus_connection_send_with_reply_and_block(), dbus_message_get_args(), dbus_message_new_method_call(), dbus_message_unref(), dbus_set_error_from_message(), FALSE, NULL, and TRUE. Referenced by dbus_bus_get(). |
|
Removes a previously-added match rule "by value" (the most recently-added identical rule gets removed). The "rule" argument is the string form of a match rule. If you pass NULL for the error, this function will not block; otherwise it will. See detailed explanation in docs for dbus_bus_add_match().
Definition at line 855 of file dbus-bus.c. References dbus_message_append_args(), dbus_message_new_method_call(), and dbus_message_unref(). |
|
Checks whether a certain service exists.
Definition at line 640 of file dbus-bus.c. References dbus_connection_send_with_reply_and_block(), dbus_message_append_args(), dbus_message_get_args(), dbus_message_new_method_call(), dbus_message_unref(), FALSE, and NULL. |
|
Sets the base service name of the connection. Can only be used if you registered with the bus manually (i.e. if you did not call dbus_bus_register()). Can only be called once per connection.
Definition at line 508 of file dbus-bus.c. References _dbus_assert, _dbus_strdup(), BusData::base_service, FALSE, and NULL. |