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-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

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: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                   sem_getvalue(3)