NAME

pthread_mutex_unlock —

unlock a mutex

LIBRARY

POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS

#include <pthread.h>

int
pthread_mutex_unlock(pthread_mutex_t *mutex);

DESCRIPTION

If the current thread holds the lock on mutex, then the pthread_mutex_unlock() function unlocks mutex.

If the argument pointed by the mutex is a robust mutex in the inconsistent state, and the call to pthread_mutex_consistent() function was not done prior to unlocking, further locking attempts on the mutex mutex are denied and locking functions return ENOTRECOVERABLE error.

RETURN VALUES

If successful, pthread_mutex_unlock() will return zero, otherwise an error number will be returned to indicate the error.

ERRORS

The pthread_mutex_unlock() function will fail if:

[EINVAL]: The value specified by mutex is invalid.
[EPERM]: The current thread does not hold a lock on mutex.

STANDARDS

The pthread_mutex_unlock() function conforms to ISO/IEC 9945-1:1996 (“POSIX.1”).