BEZEICHNUNG

sem_getvalue - ermittelt den Wert einer Semaphore

BIBLIOTHEK

POSIX-Threads-Bibliothek (libpthread, -lpthread)

ÜBERSICHT

#include <semaphore.h>

int sem_getvalue(sem_t *restrict sem, int *restrict swert);

BESCHREIBUNG

sem_getvalue() legt den aktuellen Wert der Semaphore, auf die sem zeigt, in die Ganzzahl, auf die swert zeigt.

Falls ein oder mehrere Prozess(e) oder Thread(s) durch Warten auf das Sperren der Semaphore mit sem_wait(3) blockiert ist/sind, erlaubt POSIX.1 zwei Möglichkeiten für den Rückgabewert von swert: entweder wird 0 zurückgegeben oder eine negative Zahl, deren absoluter Wert die Anzahl der Prozesse und Threads ist, die derzeit in sem_wait(3) blockiert sind. Linux implementiert ersteres Verhalten.

RÜCKGABEWERT

sem_getvalue() liefert 0 im Erfolgsfall zurück; im Fehlerfall wird -1 zurückgeliefert und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

EINVAL

sem ist keine gültige Semaphore. (Die Glibc-Implementierung prüft derzeit nicht, ob sem gültig ist.)

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

STANDARDS

POSIX.1-2008.

GESCHICHTE

POSIX.1-2001.

ANMERKUNGEN

Der Wert der Semaphore könnte bereits geändert sein, wenn sem_getvalue() zurückkehrt.

SIEHE AUCH

sem_post(3), sem_wait(3), sem_overview(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.