D-Bus  1.9.0
Macros | Enumerations

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"
#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"

Enumeration Type Documentation

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.

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.