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.