.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH sem_getvalue 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
sem_getvalue \- ermittelt den Wert einer Semaphore
.SH BIBLIOTHEK
POSIX\-Threads\-Bibliothek (\fIlibpthread\fP, \fI\-lpthread\fP)
.SH ÜBERSICHT
.nf
\fB#include <semaphore.h>\fP
.PP
\fBint sem_getvalue(sem_t *restrict \fP\fIsem\fP\fB, int *restrict \fP\fIswert\fP\fB);\fP
.fi
.SH BESCHREIBUNG
\fBsem_getvalue\fP() legt den aktuellen Wert der Semaphore, auf die \fIsem\fP
zeigt, in die Ganzzahl, auf die \fIswert\fP zeigt.
.PP
Falls ein oder mehrere Prozess(e) oder Thread(s) durch Warten auf das
Sperren der Semaphore mit \fBsem_wait\fP(3) blockiert ist/sind, erlaubt POSIX.1
zwei Möglichkeiten für den Rückgabewert von \fIswert\fP: entweder wird 0
zurückgegeben oder eine negative Zahl, deren absoluter Wert die Anzahl der
Prozesse und Threads ist, die derzeit in \fBsem_wait\fP(3) blockiert
sind. Linux implementiert ersteres Verhalten.
.SH RÜCKGABEWERT
\fBsem_getvalue\fP() liefert 0 im Erfolgsfall zurück; im Fehlerfall wird \-1
zurückgeliefert und \fIerrno\fP gesetzt, um den Fehler anzuzeigen.
.SH FEHLER
.TP 
\fBEINVAL\fP
\fIsem\fP ist keine gültige Semaphore. (Die Glibc\-Implementierung prüft derzeit
nicht, ob \fIsem\fP gültig ist.)
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBsem_getvalue\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.sp 1
.SH STANDARDS
POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001.
.SH ANMERKUNGEN
Der Wert der Semaphore könnte bereits geändert sein, wenn \fBsem_getvalue\fP()
zurückkehrt.
.SH "SIEHE AUCH"
\fBsem_post\fP(3), \fBsem_wait\fP(3), \fBsem_overview\fP(7)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .