BEZEICHNUNG¶

pthread_mutexattr_getpshared, pthread_mutexattr_setpshared - Prozess-gemeinsames Mutex-Attribut erhalten/setzen

BIBLIOTHEK¶

POSIX-Threads-Bibliothek (libpthread, -lpthread)

ÜBERSICHT¶

#include <pthread.h>

int pthread_mutexattr_getpshared(
                      const pthread_mutexattr_t *restrict attr,
                      int *restrict zgemeinsam);
int pthread_mutexattr_setpshared(pthread_mutexattr_t *attr,
                      int zgemeinsam);

BESCHREIBUNG¶

Diese Funktionen erhalten und setzen das von Prozessen gemeinsam benutze Attribut in einem Mutex-Attributobjekt. Dieses Attribut muss geeignet gesetzt werden, um eine korrekte und effiziente Aktion auf einem Mutex sicherzustellen, der mittels dieses Attributobjekts erstellt wurde.

Das von Prozessen gemeinsam benutzte Attribut kann einen der folgenden Werte enthalten:

PTHREAD_PROCESS_PRIVATE

Mutexe, die mit diesem Attributobjekt erstellt werden, werden nur zwischen Threads in dem gleichen Prozess gemeinsam verwandt, der diesen Mutex initialisierte. Dies ist der Vorgabewert für das von Prozessen gemeinsam verwandte Mutex-Attribut.

PTHREAD_PROCESS_SHARED

Mutexe, die mit diesem Attributobjekt erstellt werden, können zwischen allen Threads gemeinsam verwandt werden, die Zugriff auf den Speicher haben, der das Objekt enthält. Dazu gehören auch Threads in anderen Prozessen.

pthread_mutexattr_getpshared() legt den Wert des von Threads gemeinsam verwandten Attributes des Mutex-Attributobjektes, auf das sich attr bezieht, an den Ort ab, auf den zgemeinsam zeigt.

pthread_mutexattr_setpshared() setzt den Wert des von Prozessen gemeinsam verwandten Attributs des Mutex-Attributobjektes, auf das sich attr bezieht, auf den in zgemeinsam festgelegten Wert.

Falls sich attr nicht auf ein initialisiertes Mutex-Attributobjekt bezieht, ist das Verhalten undefiniert.

RÜCKGABEWERT¶

Bei Erfolg geben diese Funktionen Null zurück. Bei einem Fehler wird eine positive Zahl zurückgegeben.

FEHLER¶

pthread_mutexattr_setpshared() kann mit den folgenden Fehlern fehlschlagen:

EINVAL

Der in zgemeinsam festgelegte Wert ist ungültig.

ENOTSUP

zgemeinsam ist PTHREAD_PROCESS_SHARED, aber die Implementierung unterstützt keine von Prozessen gemeinsam verwandten Mutexe.

STANDARDS¶

POSIX.1-2008.

GESCHICHTE¶

POSIX.1-2001.

SIEHE AUCH¶

pthread_mutexattr_init(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.