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

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