BEZEICHNUNG¶

sem_getvalue - ermittelt den Wert einer Semaphore

ÜBERSICHT¶

#include <semaphore.h>

int sem_getvalue(sem_t *sem, int *sval);

Linken Sie mit der Option -pthread.

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.

KONFORM ZU¶

POSIX.1-2001, POSIX.1-2008.

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)

KOLOPHON¶

Diese Seite ist Teil der Veröffentlichung 5.10 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können, sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

Ü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.