sem_getvalue(3)            Library Functions Manual            sem_getvalue(3)

BEZEICHNUNG
       sem_getvalue - ermittelt den Wert einer Semaphore

BIBLIOTHEK
       POSIX-Threads-Bibliothek (libpthread, -lpthread)

UBERSICHT
       #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 Moglichkeiten fur den Ruckgabewert von swert: entweder
       wird 0 zuruckgegeben 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.

RUCKGABEWERT
       sem_getvalue() liefert 0 im Erfolgsfall zuruck; im Fehlerfall wird -1
       zuruckgeliefert und errno gesetzt, um den Fehler anzuzeigen.

FEHLER
       EINVAL sem ist keine gultige Semaphore. (Die Glibc-Implementierung
              pruft derzeit nicht, ob sem gultig ist.)

ATTRIBUTE
       Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt
       verwandten Ausdrucke.

       +--------------------------------+-------------------------+-----------+
       |Schnittstelle                   | Attribut                | Wert      |
       +--------------------------------+-------------------------+-----------+
       |sem_getvalue()                  | Multithread-Fahigkeit   | MT-Sicher |
       +--------------------------------+-------------------------+-----------+
STANDARDS
       POSIX.1-2008.

GESCHICHTE
       POSIX.1-2001.

ANMERKUNGEN
       Der Wert der Semaphore konnte bereits geandert sein, wenn
       sem_getvalue() zuruckkehrt.

SIEHE AUCH
       sem_post(3), sem_wait(3), sem_overview(7)

UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge
       Kreutzmann <debian@helgefjell.de> erstellt.

       Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General
       Public License Version 3 <https://www.gnu.org/licenses/gpl-3.0.html>
       oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG
       ubernommen.

       Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden,
       schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer
       <debian-l10n-german@lists.debian.org>.

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