dbus-threads.h File Reference

An opaque mutex type provided by the DBusThreadFunctions implementation installed by dbus_threads_init().

An opaque condition variable type provided by the DBusThreadFunctions implementation installed by dbus_threads_init().

Deprecated, provide DBusRecursiveMutexNewFunction instead.

Deprecated, provide DBusRecursiveMutexFreeFunction instead.

Deprecated, provide DBusRecursiveMutexLockFunction instead. Return value is lock success, but gets ignored in practice.

Deprecated, provide DBusRecursiveMutexUnlockFunction instead. Return value is unlock success, but gets ignored in practice.

Creates a new recursively-lockable mutex, or returns NULL if not enough memory. Can only fail due to lack of memory. Found in DBusThreadFunctions. Do not just use PTHREAD_MUTEX_RECURSIVE for this, because it does not save/restore the recursion count when waiting on a condition. libdbus requires the Java-style behavior where the mutex is fully unlocked to wait on a condition.

Frees a recursively-lockable mutex. Found in DBusThreadFunctions.

Locks a recursively-lockable mutex. Found in DBusThreadFunctions. Can only fail due to lack of memory.

Unlocks a recursively-lockable mutex. Found in DBusThreadFunctions. Can only fail due to lack of memory.

Creates a new condition variable. Found in DBusThreadFunctions. Can only fail (returning NULL) due to lack of memory.

Frees a condition variable. Found in DBusThreadFunctions.

Waits on a condition variable. Found in DBusThreadFunctions. Must work with either a recursive or nonrecursive mutex, whichever the thread implementation provides. Note that PTHREAD_MUTEX_RECURSIVE does not work with condition variables (does not save/restore the recursion count) so don't try using simply pthread_cond_wait() and a PTHREAD_MUTEX_RECURSIVE to implement this, it won't work right.

Has no error conditions. Must succeed if it returns.

Waits on a condition variable with a timeout. Found in DBusThreadFunctions. Returns TRUE if the wait did not time out, and FALSE if it did.

Has no error conditions. Must succeed if it returns.

Wakes one waiting thread on a condition variable. Found in DBusThreadFunctions.

Has no error conditions. Must succeed if it returns.

Wakes all waiting threads on a condition variable. Found in DBusThreadFunctions.

Has no error conditions. Must succeed if it returns.