pthread_mutexattr_getpshared(3)

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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).