23 #ifndef DBUS_SERVER_PROTECTED_H    24 #define DBUS_SERVER_PROTECTED_H    26 #include <dbus/dbus-internals.h>    27 #include <dbus/dbus-threads-internal.h>    28 #include <dbus/dbus-server.h>    29 #include <dbus/dbus-address.h>    30 #include <dbus/dbus-timeout.h>    31 #include <dbus/dbus-watch.h>    32 #include <dbus/dbus-resources.h>    33 #include <dbus/dbus-dataslot.h>    34 #include <dbus/dbus-string.h>    89 #ifndef DBUS_DISABLE_CHECKS   121   DBUS_SERVER_LISTEN_NOT_HANDLED, 
   122   DBUS_SERVER_LISTEN_OK,          
   123   DBUS_SERVER_LISTEN_BAD_ADDRESS, 
   124   DBUS_SERVER_LISTEN_DID_NOT_CONNECT, 
   125   DBUS_SERVER_LISTEN_ADDRESS_ALREADY_USED 
   126 } DBusServerListenResult;
   132 #ifdef DBUS_ENABLE_VERBOSE_MODE   133 void _dbus_server_trace_ref (
DBusServer *server,
   138 #define _dbus_server_trace_ref(s,o,n,w) \   146 #ifdef DBUS_DISABLE_CHECKS   147 #define TOOK_LOCK_CHECK(server)   148 #define RELEASING_LOCK_CHECK(server)   149 #define HAVE_LOCK_CHECK(server)   151 #define TOOK_LOCK_CHECK(server) do {                \   152     _dbus_assert (!(server)->have_server_lock); \   153     (server)->have_server_lock = TRUE;          \   155 #define RELEASING_LOCK_CHECK(server) do {            \   156     _dbus_assert ((server)->have_server_lock);   \   157     (server)->have_server_lock = FALSE;          \   159 #define HAVE_LOCK_CHECK(server)        _dbus_assert ((server)->have_server_lock)   163 #define TRACE_LOCKS 0   165 #define SERVER_LOCK(server)   do {                                              \   166     if (TRACE_LOCKS) { _dbus_verbose ("LOCK\n"); }   \   167     _dbus_rmutex_lock ((server)->mutex);                                        \   168     TOOK_LOCK_CHECK (server);                                                   \   171 #define SERVER_UNLOCK(server) do {                                                      \   172     if (TRACE_LOCKS) { _dbus_verbose ("UNLOCK\n");  }        \   173     RELEASING_LOCK_CHECK (server);                                                      \   174     _dbus_rmutex_unlock ((server)->mutex);                                              \ An atomic integer safe to increment or decrement from multiple threads. 
Internals of DBusTimeout. 
dbus_bool_t _dbus_server_add_watch(DBusServer *server, DBusWatch *watch)
Adds a watch for this server, chaining out to application-provided watch handlers. 
Implementation of DBusWatch. 
void(* DBusFreeFunction)(void *memory)
The type of a function which frees a block of memory. 
#define DBUS_BEGIN_DECLS
Macro used prior to declaring functions in the D-Bus header files. 
void(* disconnect)(DBusServer *server)
Disconnect this server. 
unsigned int disconnected
TRUE if we are disconnected. 
Internals of DBusServer object. 
A globally unique ID ; we have one for each DBusServer, and also one for each machine with libdbus in...
DBUS_PRIVATE_EXPORT void _dbus_server_ref_unlocked(DBusServer *server)
Like dbus_server_ref() but does not acquire the lock (must already be held) 
void(* DBusNewConnectionFunction)(DBusServer *server, DBusConnection *new_connection, void *data)
Called when a new connection to the server is available. 
DBusServerListenResult _dbus_server_listen_platform_specific(DBusAddressEntry *entry, DBusServer **server_p, DBusError *error)
Tries to interpret the address entry in a platform-specific way, creating a platform-specific server ...
DBusNewConnectionFunction new_connection_function
Callback to invoke when a new connection is created. 
char ** auth_mechanisms
Array of allowed authentication mechanisms. 
const DBusServerVTable * vtable
Virtual methods for this instance. 
void(* finalize)(DBusServer *server)
The finalize method must free the server. 
DBusRMutex * mutex
Lock on the server object. 
void _dbus_server_toggle_timeout(DBusServer *server, DBusTimeout *timeout, dbus_bool_t enabled)
Toggles a timeout and notifies app via server's DBusTimeoutToggledFunction if available. 
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE. 
DBUS_PRIVATE_EXPORT void _dbus_server_unref_unlocked(DBusServer *server)
Like dbus_server_unref() but does not acquire the lock (must already be held) 
DBusAtomic refcount
Reference count. 
DBusTimeoutList * timeouts
Our timeouts. 
Internals of DBusAddressEntry. 
void _dbus_server_remove_watch(DBusServer *server, DBusWatch *watch)
Removes a watch previously added with _dbus_server_remove_watch(). 
Object representing an exception. 
void _dbus_server_remove_timeout(DBusServer *server, DBusTimeout *timeout)
Removes a timeout previously added with _dbus_server_add_timeout(). 
void _dbus_server_finalize_base(DBusServer *server)
Finalizes the members of the DBusServer base class. 
Virtual table to be implemented by all server "subclasses". 
DBusWatchList * watches
Our watches. 
DBusDataSlotList slot_list
Data stored by allocated integer ID. 
Data structure that stores the actual user data set at a given slot. 
char * address
Address this server is listening on. 
dbus_bool_t published_address
flag which indicates that server has published its bus address. 
DBusFreeFunction new_connection_free_data_function
Callback to invoke to free new_connection_data when server is finalized or data is replaced...
DBusWatchList implementation details. 
void * new_connection_data
Data for new connection callback. 
dbus_bool_t _dbus_server_init_base(DBusServer *server, const DBusServerVTable *vtable, const DBusString *address, DBusError *error)
Initializes the members of the DBusServer base class. 
unsigned int have_server_lock
Does someone have the server mutex locked. 
DBusString guid_hex
Hex-encoded version of GUID. 
DBUS_PRIVATE_EXPORT void _dbus_server_toggle_all_watches(DBusServer *server, dbus_bool_t enabled)
Toggles all watch and notifies app via server's DBusWatchToggledFunction if available. 
dbus_bool_t _dbus_server_add_timeout(DBusServer *server, DBusTimeout *timeout)
Adds a timeout for this server, chaining out to application-provided timeout handlers. 
DBusGUID guid
Globally unique ID of server. 
int max_connections
Max number of connections allowed at once. 
DBusTimeoutList implementation details. 
#define DBUS_END_DECLS
Macro used after declaring functions in the D-Bus header files.