27#include "dbus-internals.h"
28#include "dbus-connection-internal.h"
29#include "dbus-message-internal.h"
30#include "dbus-pending-call-internal.h"
31#include "dbus-pending-call.h"
33#include "dbus-threads.h"
55#define CONNECTION_LOCK(connection) _dbus_connection_lock(connection)
59#define CONNECTION_UNLOCK(connection) _dbus_connection_unlock(connection)
98#ifdef DBUS_ENABLE_VERBOSE_MODE
99 static int enabled = -1;
101 _dbus_trace_ref (
"DBusPendingCall", pending_call, old_refcount,
102 new_refcount, why,
"DBUS_PENDING_CALL_TRACE", &enabled);
107static dbus_int32_t notify_user_data_slot = -1;
121 int timeout_milliseconds,
127 _dbus_assert (timeout_milliseconds >= 0 || timeout_milliseconds == -1);
129 if (timeout_milliseconds == -1)
130 timeout_milliseconds = _DBUS_DEFAULT_TIMEOUT_VALUE;
169 _dbus_pending_call_trace_ref (pending, 0, 1,
"new_unlocked");
194 _dbus_verbose (
" handing message %p (%s) to pending call serial %u\n",
199 "error" :
"other type",
204 pending->
reply = message;
243 notify_user_data_slot);
245 (* pending->
function) (pending, user_data);
293 dbus_bool_t is_added)
337 dbus_uint32_t serial)
385 dbus_uint32_t serial)
391 "Did not receive a reply. Possible causes include: "
392 "the remote application did not send a reply, "
393 "the message bus security policy blocked the reply, "
394 "the reply timeout expired, or "
395 "the network connection was broken.");
400 if (reply_link ==
NULL)
425 dbus_int32_t old_refcount;
428 _dbus_pending_call_trace_ref (pending, old_refcount, old_refcount + 1,
488 dbus_int32_t old_refcount;
492 _dbus_pending_call_trace_ref (pending, old_refcount,
493 old_refcount - 1,
"unref_and_unlock");
497 if (old_refcount == 1)
498 _dbus_pending_call_last_unref (pending);
542 slot, data, free_data_func,
543 &old_free_func, &old_data);
551 (* old_free_func) (old_data);
608 dbus_int32_t old_refcount;
610 _dbus_return_val_if_fail (pending !=
NULL,
NULL);
613 _dbus_pending_call_trace_ref (pending, old_refcount, old_refcount + 1,
628 dbus_int32_t old_refcount;
630 _dbus_return_if_fail (pending !=
NULL);
633 _dbus_pending_call_trace_ref (pending, old_refcount, old_refcount - 1,
636 if (old_refcount == 1)
637 _dbus_pending_call_last_unref(pending);
656 dbus_bool_t ret =
FALSE;
658 _dbus_return_val_if_fail (pending !=
NULL,
FALSE);
664 user_data, free_user_data))
694 _dbus_return_if_fail (pending !=
NULL);
710 dbus_bool_t completed;
712 _dbus_return_val_if_fail (pending !=
NULL,
FALSE);
735 _dbus_return_val_if_fail (pending !=
NULL,
NULL);
741 message = pending->
reply;
746 _dbus_message_trace_ref (message, -1, -1,
"dbus_pending_call_steal_reply");
768 _dbus_return_if_fail (pending !=
NULL);
790 _dbus_return_val_if_fail (slot_p !=
NULL,
FALSE);
810 _dbus_return_if_fail (slot_p !=
NULL);
811 _dbus_return_if_fail (*slot_p >= 0);
837 _dbus_return_val_if_fail (pending !=
NULL,
FALSE);
838 _dbus_return_val_if_fail (slot >= 0,
FALSE);
861 _dbus_return_val_if_fail (pending !=
NULL,
NULL);
void _dbus_connection_remove_pending_call(DBusConnection *connection, DBusPendingCall *pending)
Removes a pending call from the connection, such that the pending reply will be ignored.
void _dbus_connection_block_pending_call(DBusPendingCall *pending)
Blocks until a pending call times out or gets a reply.
void _dbus_connection_queue_synthesized_message_link(DBusConnection *connection, DBusList *link)
Adds a link + message to the incoming message queue.
DBUS_PRIVATE_EXPORT DBusConnection * _dbus_connection_ref_unlocked(DBusConnection *connection)
Increments the reference count of a DBusConnection.
void dbus_connection_unref(DBusConnection *connection)
Decrements the reference count of a DBusConnection, and finalizes it if the count reaches zero.
void(* DBusPendingCallNotifyFunction)(DBusPendingCall *pending, void *user_data)
Called when a pending call now has a reply available.
void _dbus_data_slot_allocator_free(DBusDataSlotAllocator *allocator, dbus_int32_t *slot_id_p)
Deallocates an ID previously allocated with _dbus_data_slot_allocator_alloc().
void _dbus_data_slot_list_init(DBusDataSlotList *list)
Initializes a slot list.
void _dbus_data_slot_list_free(DBusDataSlotList *list)
Frees the data slot list and all data slots contained in it, calling application-provided free functi...
void * _dbus_data_slot_list_get(DBusDataSlotAllocator *allocator, DBusDataSlotList *list, int slot)
Retrieves data previously set with _dbus_data_slot_list_set_data().
dbus_bool_t _dbus_data_slot_list_set(DBusDataSlotAllocator *allocator, DBusDataSlotList *list, int slot, void *data, DBusFreeFunction free_data_func, DBusFreeFunction *old_free_func, void **old_data)
Stores a pointer in the data slot list, along with an optional function to be used for freeing the da...
dbus_bool_t _dbus_data_slot_allocator_alloc(DBusDataSlotAllocator *allocator, dbus_int32_t *slot_id_p)
Allocates an integer ID to be used for storing data in a DBusDataSlotList.
#define _dbus_assert(condition)
Aborts with an error message if the condition is false.
#define _DBUS_LOCK_NAME(name)
Expands to name of a global lock variable.
void _dbus_list_free_link(DBusList *link)
Frees a linked list node allocated with _dbus_list_alloc_link.
void _dbus_list_clear(DBusList **list)
Frees all links in the list and sets the list head to NULL.
DBusList * _dbus_list_alloc_link(void *data)
Allocates a linked list node.
#define NULL
A null pointer, defined appropriately for C or C++.
#define TRUE
Expands to "1".
#define FALSE
Expands to "0".
void(* DBusFreeFunction)(void *memory)
The type of a function which frees a block of memory.
void dbus_free(void *memory)
Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().
#define dbus_new0(type, count)
Safe macro for using dbus_malloc0().
DBusMessage * dbus_message_new_error(DBusMessage *reply_to, const char *error_name, const char *error_message)
Creates a new message that is an error reply to another message.
int dbus_message_get_type(DBusMessage *message)
Gets the type of a message.
DBusMessage * dbus_message_ref(DBusMessage *message)
Increments the reference count of a DBusMessage.
dbus_uint32_t dbus_message_get_reply_serial(DBusMessage *message)
Returns the serial that the message is a reply to or 0 if none.
void dbus_message_unref(DBusMessage *message)
Decrements the reference count of a DBusMessage, freeing the message if the count reaches 0.
void _dbus_pending_call_finish_completion(DBusPendingCall *pending)
Call the notifier function for the pending call.
DBusConnection * _dbus_pending_call_get_connection_and_lock(DBusPendingCall *pending)
Gets the connection associated with this pending call.
DBusPendingCall * _dbus_pending_call_ref_unlocked(DBusPendingCall *pending)
Increments the reference count on a pending call, while the lock on its connection is already held.
void _dbus_pending_call_queue_timeout_error_unlocked(DBusPendingCall *pending, DBusConnection *connection)
If the pending call hasn't been timed out, add its timeout error reply to the connection's incoming m...
void _dbus_pending_call_unref_and_unlock(DBusPendingCall *pending)
Decrements the reference count on a pending call, freeing it if the count reaches 0.
dbus_bool_t _dbus_pending_call_get_completed_unlocked(DBusPendingCall *pending)
Checks whether the pending call has received a reply yet, or not.
void _dbus_pending_call_set_reply_unlocked(DBusPendingCall *pending, DBusMessage *message)
Sets the reply of a pending call with the given message, or if the message is NULL,...
void _dbus_pending_call_set_reply_serial_unlocked(DBusPendingCall *pending, dbus_uint32_t serial)
Sets the reply's serial number.
dbus_bool_t _dbus_pending_call_set_data_unlocked(DBusPendingCall *pending, dbus_int32_t slot, void *data, DBusFreeFunction free_data_func)
Stores a pointer on a DBusPendingCall, along with an optional function to be used for freeing the dat...
DBusPendingCall * _dbus_pending_call_new_unlocked(DBusConnection *connection, int timeout_milliseconds, DBusTimeoutHandler timeout_handler)
Creates a new pending reply object.
dbus_bool_t _dbus_pending_call_set_timeout_error_unlocked(DBusPendingCall *pending, DBusMessage *message, dbus_uint32_t serial)
Sets the reply message associated with the pending call to a timeout error.
#define CONNECTION_LOCK(connection)
Internals of DBusPendingCall.
#define CONNECTION_UNLOCK(connection)
shorter and more visible way to write _dbus_connection_unlock()
void _dbus_pending_call_start_completion_unlocked(DBusPendingCall *pending)
Sets the pending call to completed.
dbus_bool_t _dbus_pending_call_is_timeout_added_unlocked(DBusPendingCall *pending)
Checks to see if a timeout has been added.
dbus_uint32_t _dbus_pending_call_get_reply_serial_unlocked(DBusPendingCall *pending)
Gets the reply's serial number.
DBusConnection * _dbus_pending_call_get_connection_unlocked(DBusPendingCall *pending)
Gets the connection associated with this pending call.
DBusTimeout * _dbus_pending_call_get_timeout_unlocked(DBusPendingCall *pending)
Retrives the timeout.
void _dbus_pending_call_set_timeout_added_unlocked(DBusPendingCall *pending, dbus_bool_t is_added)
Sets wether the timeout has been added.
dbus_bool_t dbus_pending_call_set_notify(DBusPendingCall *pending, DBusPendingCallNotifyFunction function, void *user_data, DBusFreeFunction free_user_data)
Sets a notification function to be called when the reply is received or the pending call times out.
void dbus_pending_call_free_data_slot(dbus_int32_t *slot_p)
Deallocates a global ID for DBusPendingCall data slots.
#define DBUS_TIMEOUT_INFINITE
An integer constant representing an infinite timeout.
DBusPendingCall * dbus_pending_call_ref(DBusPendingCall *pending)
Increments the reference count on a pending call.
void * dbus_pending_call_get_data(DBusPendingCall *pending, dbus_int32_t slot)
Retrieves data previously set with dbus_pending_call_set_data().
DBusMessage * dbus_pending_call_steal_reply(DBusPendingCall *pending)
Gets the reply, or returns NULL if none has been received yet.
void dbus_pending_call_cancel(DBusPendingCall *pending)
Cancels the pending call, such that any reply or error received will just be ignored.
void dbus_pending_call_block(DBusPendingCall *pending)
Block until the pending call is completed.
dbus_bool_t dbus_pending_call_set_data(DBusPendingCall *pending, dbus_int32_t slot, void *data, DBusFreeFunction free_data_func)
Stores a pointer on a DBusPendingCall, along with an optional function to be used for freeing the dat...
dbus_bool_t dbus_pending_call_allocate_data_slot(dbus_int32_t *slot_p)
Allocates an integer ID to be used for storing application-specific data on any DBusPendingCall.
dbus_bool_t dbus_pending_call_get_completed(DBusPendingCall *pending)
Checks whether the pending call has received a reply yet, or not.
void dbus_pending_call_unref(DBusPendingCall *pending)
Decrements the reference count on a pending call, freeing it if the count reaches 0.
#define DBUS_MESSAGE_TYPE_ERROR
Message type of an error reply message, see dbus_message_get_type()
#define DBUS_MESSAGE_TYPE_METHOD_RETURN
Message type of a method return message, see dbus_message_get_type()
#define DBUS_ERROR_NO_REPLY
No reply to a message expecting one, usually means a timeout occurred.
dbus_int32_t _dbus_atomic_dec(DBusAtomic *atomic)
Atomically decrement an integer.
dbus_int32_t _dbus_atomic_inc(DBusAtomic *atomic)
Atomically increments an integer.
void _dbus_timeout_unref(DBusTimeout *timeout)
Decrements the reference count of a DBusTimeout object and finalizes the object if the count reaches ...
DBusTimeout * _dbus_timeout_new(int interval, DBusTimeoutHandler handler, void *data, DBusFreeFunction free_data_function)
Creates a new DBusTimeout, enabled by default.
dbus_bool_t(* DBusTimeoutHandler)(void *data)
function to run when the timeout is handled
An atomic integer safe to increment or decrement from multiple threads.
Implementation details of DBusConnection.
An allocator that tracks a set of slot IDs.
Data structure that stores the actual user data set at a given slot.
void * data
Data stored at this element.
Internals of DBusMessage.
Implementation details of DBusPendingCall - all fields are private.
DBusPendingCallNotifyFunction function
Notifier when reply arrives.
DBusMessage * reply
Reply (after we've received it)
DBusList * timeout_link
Preallocated timeout response.
DBusAtomic refcount
reference count
unsigned int timeout_added
TRUE if we have added the timeout.
dbus_uint32_t reply_serial
Expected serial of reply.
unsigned int completed
TRUE if some thread has taken responsibility for completing this pending call: either the pending cal...
DBusDataSlotList slot_list
Data stored by allocated integer ID.
DBusConnection * connection
Connections we're associated with.
DBusTimeout * timeout
Timeout.
Internals of DBusTimeout.