Shared constants
D-Bus low-level public API

Shared header included by both libdbus and C/C++ bindings such as the GLib bindings. More...

## Macros

#define | DBUS_SERVICE_DBUS "org.freedesktop.DBus"
| The bus name used to talk to the bus itself. More...
#define | DBUS_PATH_DBUS "/org/freedesktop/DBus"
| The object path used to talk to the bus itself. More...
#define | DBUS_PATH_LOCAL "/org/freedesktop/DBus/Local"
| The object path used in local/in-process-generated messages. More...
#define | DBUS_INTERFACE_DBUS "org.freedesktop.DBus"
| The interface exported by the object with DBUS_SERVICE_DBUS and DBUS_PATH_DBUS.
#define | DBUS_INTERFACE_INTROSPECTABLE "org.freedesktop.DBus.Introspectable"
| The interface supported by introspectable objects.
#define | DBUS_INTERFACE_PROPERTIES "org.freedesktop.DBus.Properties"
| The interface supported by objects with properties.
#define | DBUS_INTERFACE_PEER "org.freedesktop.DBus.Peer"
| The interface supported by most dbus peers.
#define | DBUS_INTERFACE_LOCAL "org.freedesktop.DBus.Local"
| This is a special interface whose methods can only be invoked by the local implementation (messages from remote apps aren't allowed to specify this interface).
#define | DBUS_NAME_FLAG_ALLOW_REPLACEMENT 0x1
| Allow another service to become the primary owner if requested.
#define | DBUS_NAME_FLAG_REPLACE_EXISTING 0x2
| Request to replace the current primary owner.
#define | DBUS_NAME_FLAG_DO_NOT_QUEUE 0x4
| If we can not become the primary owner do not place us in the queue.
#define | DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER 1
| Service has become the primary owner of the requested name.
#define | DBUS_REQUEST_NAME_REPLY_IN_QUEUE 2
| Service could not become the primary owner and has been placed in the queue.
#define | DBUS_REQUEST_NAME_REPLY_EXISTS 3
| Service is already in the queue.
#define | DBUS_REQUEST_NAME_REPLY_ALREADY_OWNER 4
| Service is already the primary owner.
#define | DBUS_RELEASE_NAME_REPLY_RELEASED 1
| Service was released from the given name.
#define | DBUS_RELEASE_NAME_REPLY_NON_EXISTENT 2
| The given name does not exist on the bus.
#define | DBUS_RELEASE_NAME_REPLY_NOT_OWNER 3
| Service is not an owner of the given name.
#define | DBUS_START_REPLY_SUCCESS 1
| Service was auto started.
#define | DBUS_START_REPLY_ALREADY_RUNNING 2
| Service was already running.

## Enumerations

enum | DBusBusType { DBUS_BUS_SESSION, DBUS_BUS_SYSTEM, DBUS_BUS_STARTER }
| Well-known bus types. More...
enum | DBusHandlerResult { DBUS_HANDLER_RESULT_HANDLED, DBUS_HANDLER_RESULT_NOT_YET_HANDLED, DBUS_HANDLER_RESULT_NEED_MEMORY }
| Results that a message handler can return. More...

## Detailed Description

Shared header included by both libdbus and C/C++ bindings such as the GLib bindings.

Usually a C/C++ binding such as the GLib or Qt binding won't want to include dbus.h in its public headers. However, a few constants and macros may be useful to include; those are found here and in dbus-protocol.h

## Macro Definition Documentation

#define DBUS_PATH_DBUS "/org/freedesktop/DBus"

The object path used to talk to the bus itself.

Definition at line 80 of file dbus-shared.h.

Referenced by dbus_bus_add_match(), dbus_bus_get_id(), dbus_bus_get_unix_user(), dbus_bus_name_has_owner(), dbus_bus_register(), dbus_bus_release_name(), dbus_bus_remove_match(), dbus_bus_request_name(), and dbus_bus_start_service_by_name().

#define DBUS_PATH_LOCAL "/org/freedesktop/DBus/Local"

The object path used in local/in-process-generated messages.

Definition at line 82 of file dbus-shared.h.

Referenced by _dbus_connection_new_for_transport().

#define DBUS_SERVICE_DBUS "org.freedesktop.DBus"

The bus name used to talk to the bus itself.

Definition at line 76 of file dbus-shared.h.

Referenced by dbus_bus_add_match(), dbus_bus_get_id(), dbus_bus_get_unix_user(), dbus_bus_name_has_owner(), dbus_bus_register(), dbus_bus_release_name(), dbus_bus_remove_match(), dbus_bus_request_name(), and dbus_bus_start_service_by_name().

## Enumeration Type Documentation

enum DBusBusType

Well-known bus types.

See dbus_bus_get().

Enumerator
DBUS_BUS_SESSION | The login session bus.
DBUS_BUS_SYSTEM | The systemwide bus.
DBUS_BUS_STARTER | The bus that started us, if any.

Definition at line 56 of file dbus-shared.h.

enum DBusHandlerResult

Results that a message handler can return.

Enumerator
DBUS_HANDLER_RESULT_HANDLED | Message has had its effect - no need to run more handlers.
DBUS_HANDLER_RESULT_NOT_YET_HANDLED | Message has not had any effect - see if other handlers want it.
DBUS_HANDLER_RESULT_NEED_MEMORY | Need more memory in order to return DBUS_HANDLER_RESULT_HANDLED or DBUS_HANDLER_RESULT_NOT_YET_HANDLED. Please try again later with more memory.

Definition at line 66 of file dbus-shared.h.