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.

SEE ALSO

pthread_mutex_destroy(3), pthread_mutex_init(3), pthread_mutex_lock(3), pthread_mutex_trylock(3)

STANDARDS

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