Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pthread_mutex_unlock()

Unlock mutex

Synopsis:

#include <pthread.h>

int pthread_mutex_unlock( pthread_mutex_t* mutex );

Arguments:

mutex
A pointer to the pthread_mutex_t object that you want to unlock.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_mutex_unlock() function unlocks the mutex mutex. The mutex should be owned by the calling thread. If there are threads blocked on the mutex then the highest priority waiting thread is unblocked and becomes the next owner of the mutex.

If the thread's priority was raised when a higher-priority thread attempted to lock the mutex, the calling thread returns to its real priority when it unlocks the mutex. For more information, see "Mutexes: mutual exclusion locks" in the QNX Neutrino Microkernel chapter of the System Architecture guide.

If mutex has been locked more than once, it must be unlocked the same number of times before the next thread is given ownership of the mutex. This only works for recursive mutexes.

Returns:

EOK
Success.
EINVAL
Invalid mutex mutex.
EPERM
Current thread doesn't own mutex.

Classification:

POSIX 1003.1 THR

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

pthread_mutex_lock(), pthread_mutex_timedlock(), pthread_mutex_trylock(), SyncMutexUnlock()

"Mutexes: mutual exclusion locks" in the QNX Neutrino Microkernel chapter of the System Architecture guide

Processes and Threads chapter of Getting Started with QNX Neutrino