BEZEICHNUNG

       pthread_mutex_consistent - Einen robusten Mutex konsistent machen

BIBLIOTHEK

       POSIX-Threads-Bibliothek (libpthread, -lpthread)

ÜBERSICHT

       #include <pthread.h>

       int pthread_mutex_consistent(pthread_mutex_t *mutex);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       pthread_mutex_consistent():
           _POSIX_C_SOURCE >= 200809L

BESCHREIBUNG

       Diese  Funktion  macht einen robusten Mutex konsistent, falls er in einem inkonsistenten Zustand ist. Ein
       Mutex kann in einem inkonsistenten Zustand verbleiben, wenn sich sein Eigentümer beendet, während er  den
       Mutex hält. In diesem Fall wird der nächste Eigentümer, der den Mutex erlangt, erfolgreich sein und durch
       einen Rückgabewert von EOWNERDEAD bei einem Aufruf von pthread_mutex_lock() benachrichtigt werden.

RÜCKGABEWERT

       Im  Erfolgsfall  liefert  pthread_mutex_consistent()  0  zurück.  Andernfalls  liefert  sie eine positive
       Fehlernummer zurück, um den Fehler anzuzeigen.

FEHLER

       EINVAL Der Mutex ist entweder nicht robust oder nicht in einem inkonsistenten Zustand.

STANDARDS

       POSIX.1-2008.

GESCHICHTE

       Glibc 2.12. POSIX.1-2008.

       Bevor pthread_mutex_consistent() zu  POSIX  hinzugefügt  wurde,  definierte  Glibc  die  folgende,  nicht
       standardisierte äquivalente Funktion, falls _GNU_SOURCE definiert war:

       [[veraltet]]
       int pthread_mutex_consistent_np(const pthread_mutex_t *mutex);

       Diese  GNU-spezifische  API,  die  erstmals  in Glibc 2.4 erschien, ist heutzutage veraltet und sollte in
       neuen Programmen nicht mehr verwandt werden; seit Glibc 2.34 ist sie als veraltet markiert.

ANMERKUNGEN

       pthread_mutex_consistent() informiert die Implementierung einfach, dass der vom Mutex gesicherte  Zustand
       (gemeinsam  verwandte Daten) in einem konsistenten Zustand wiederhergestellt wurde und dass jetzt normale
       Aktionen mit dem  Mutex  durchgeführt  werden  können.  Es  liegt  in  der  Verantwortung  der  Anwendung
       sicherzustellen, dass die gemeinsamen Daten in einen konsistenten Zustand wiederhergestellt wurden, bevor
       sie pthread_mutex_consistent() aufruft.

BEISPIELE

       Siehe pthread_mutexattr_setrobust(3).

SIEHE AUCH

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

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

       Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die
       Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                       pthread_mutex_consistent(3)