pthread_mutex_consistent(3) Library Functions Manualpthread_mutex_consistent(3)
NAME
pthread_mutex_consistent - make a robust mutex consistent
LIBRARY
POSIX threads library (libpthread, -lpthread)
SYNOPSIS
#include <pthread.h>
int pthread_mutex_consistent(pthread_mutex_t *mutex);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
pthread_mutex_consistent():
_POSIX_C_SOURCE >= 200809L
DESCRIPTION
This function makes a robust mutex consistent if it is in an inconsis-
tent state. A mutex can be left in an inconsistent state if its owner
terminates while holding the mutex, in which case the next owner who ac-
quires the mutex will succeed and be notified by a return value of EOWN-
ERDEAD from a call to pthread_mutex_lock().
RETURN VALUE
On success, pthread_mutex_consistent() returns 0. Otherwise, it returns
a positive error number to indicate the error.
ERRORS
EINVAL The mutex is either not robust or is not in an inconsistent
state.
STANDARDS
POSIX.1-2008.
HISTORY
glibc 2.12. POSIX.1-2008.
Before the addition of pthread_mutex_consistent() to POSIX, glibc de-
fined the following equivalent nonstandard function if _GNU_SOURCE was
defined:
[[deprecated]]
int pthread_mutex_consistent_np(const pthread_mutex_t *mutex);
This GNU-specific API, which first appeared in glibc 2.4, is nowadays
obsolete and should not be used in new programs; since glibc 2.34 it has
been marked as deprecated.
NOTES
pthread_mutex_consistent() simply informs the implementation that the
state (shared data) guarded by the mutex has been restored to a consis-
tent state and that normal operations can now be performed with the mu-
tex. It is the application's responsibility to ensure that the shared
data has been restored to a consistent state before calling pthread_mu-
tex_consistent().
EXAMPLES
See pthread_mutexattr_setrobust(3).
SEE ALSO
pthread_mutex_lock(3), pthread_mutexattr_getrobust(3),
pthread_mutexattr_init(3), pthread_mutexattr_setrobust(3), pthreads(7)
Linux man-pages 6.9.1 2024-05-02 pthread_mutex_consistent(3)
Generated by dwww version 1.16 on Tue Dec 16 05:09:16 CET 2025.