Movatterモバイル変換

pthread_mutex_consistent(3) — Linux manual page

pthread_m...onsistent(3) Library Functions Manualpthread_m...onsistent(3)

NAME        top

       pthread_mutex_consistent - make a robust mutex consistent

LIBRARY        top

       POSIX threads library (libpthread,-lpthread)

SYNOPSIS        top

#include <pthread.h>int pthread_mutex_consistent(pthread_mutex_t *mutex);   Feature Test Macro Requirements for glibc (seefeature_test_macros(7)):pthread_mutex_consistent():           _POSIX_C_SOURCE >= 200809L

DESCRIPTION        top

       This function makes a robust mutex consistent if it is in an       inconsistent 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 acquires the mutex will succeed and be notified by       a return value ofEOWNERDEADfrom a call topthread_mutex_lock().

RETURN VALUE        top

       On success,pthread_mutex_consistent() returns 0.  Otherwise, it       returns a positive error number to indicate the error.

ERRORS        top

EINVALThe mutex is either not robust or is not in an inconsistent              state.

STANDARDS        top

       POSIX.1-2008.

HISTORY        top

       glibc 2.12.  POSIX.1-2008.       Before the addition ofpthread_mutex_consistent() to POSIX, glibc       defined the following equivalent nonstandard function if_GNU_SOURCEwas 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        top

pthread_mutex_consistent() simply informs the implementation that       the state (shared data) guarded by the mutex has been restored to       a consistent state and that normal operations can now be performed       with the mutex.  It is the application's responsibility to ensure       that the shared data has been restored to a consistent state       before callingpthread_mutex_consistent().

EXAMPLES        top

       Seepthread_mutexattr_setrobust(3).

SEE ALSO        top

pthread_mutex_lock(3),pthread_mutexattr_getrobust(3),pthread_mutexattr_init(3),pthread_mutexattr_setrobust(3),pthreads(7)

COLOPHON        top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17pthread_m...onsistent(3)

Pages that refer to this page:pthread_mutexattr_setrobust(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.