sem_getvalue(3)

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.
Schnittstelle | Attribut | Wert
sem_getvalue() | Multithread-Fähigkeit | MT-Safe

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