.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getnetent_r 3 "28. Juni 2025" "Linux man\-pages 6.15" 
.SH BEZEICHNUNG
getnetent_r, getnetbyname_r, getnetbyaddr_r \- Netzwerkeintrag erhalten
(reentrant)
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <netdb.h>\fP
.P
\fBint getnetent_r(size_t \fP\fIGröße\fP\fB;\fP
\fB                struct netent *restrict \fP\fIErgebnispuffer\fP\fB,\fP
\fB                char \fP\fIPuf\fP\fB[restrict \fP\fIGröße\fP\fB], size_t \fP\fIGröße\fP\fB,\fP
\fB                struct netent **restrict \fP\fIErgebnis\fP\fB,\fP
\fB                int *restrict \fP\fIh_Fehlernumz\fP\fB);\fP
\fBint getnetbyname_r(size_t \fP\fIGröße\fP\fB;\fP
\fB                const char *restrict \fP\fIName\fP\fB,\fP
\fB                struct netent *restrict \fP\fIErgebnispuffer\fP\fB,\fP
\fB                char \fP\fIPuf\fP\fB[restrict \fP\fIGröße\fP\fB], size_t \fP\fIGröße\fP\fB,\fP
\fB                struct netent **restrict \fP\fIErgebnis\fP\fB,\fP
\fB                int *restrict \fP\fIh_Fehlernumz\fP\fB);\fP
\fBint getnetbyaddr_r(size_t \fP\fIGröße\fP\fB;\fP
\fB                uint32_t \fP\fInet\fP\fB, int \fP\fITyp\fP\fB,\fP
\fB                struct netent *restrict \fP\fIErgebnispuffer\fP\fB,\fP
\fB                char \fP\fIPuf\fP\fB[restrict \fP\fIGröße\fP\fB], size_t \fP\fIGröße\fP\fB,\fP
\fB                struct netent **restrict \fP\fIErgebnis\fP\fB,\fP
\fB                int *restrict \fP\fIh_Fehlernumz\fP\fB);\fP
.P
.fi
.RS -4
Mit Glibc erforderliche Feature\-Test\-Makros (siehe
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetnetent_r\fP(), \fBgetnetbyname_r\fP(), \fBgetnetbyaddr_r\fP():
.nf
    Seit Glibc 2.19:
        _DEFAULT_SOURCE
    Glibc 2.19 und älter:
        _BSD_SOURCE || _SVID_SOURCE
.fi
.SH BESCHREIBUNG
Die Funktionen \fBgetnetent_r\fP(), \fBgetnetbyname_r\fP() und \fBgetnetbyaddr_r\fP()
sind die reentranten Äquivalente von \fBgetnetent\fP(3), \fBgetnetbyname\fP(3)
bzw. \fBgetnetbynumber\fP(3). Sie unterscheiden sich in der Art, wie die
Struktur \fInetent\fP zurückgeliefert wird und in der Funktionsaufrufsignatur
und dem \-Rückgabewert. Diese Handbuchseite beschreibt nur die Unterschiede
zu den nicht reentranten Funktionen.
.P
Anstatt einen Zeiger auf eine statisch reservierte Struktur \fInetent\fP als
Funktionsergebnis zurückzuliefern, kopieren diese Funktionen die Struktur an
einen Ort, auf den \fIErgebnispuffer\fP zeigt.
.P
.\" I can find no information on the required/recommended buffer size;
.\" the nonreentrant functions use a 1024 byte buffer -- mtk.
Das Feld \fIPuf\fP wird zum Speichern der Zeichenkettenfelder verwandt, auf die
die zurückgelieferte Struktur \fInetent\fP zeigt. (Die nicht reentranten
Funktionen reservieren diese Zeichenketten in statischem Speicher.) Die
Größe dieses Feldes wird in \fIGröße\fP angegeben. Falls \fIPuf\fP zu klein ist,
schlägt der Aufruf mit dem Fehler \fBERANGE\fP fehl und der Aufrufende muss es
mit einem größeren Puffer erneut versuchen. (Ein Puffer der Größe 1024 byte
sollte für die meisten Anwendungen ausreichend sein.)
.P
Falls der Funktionsaufruf erfolgreich einen Netzwerkdatensatz erhält, dann
wird \fI*Ergebnis\fP so gesetzt, dass es auf \fIErgebnispuffer\fP zeigt;
andernfalls wird \fI*Ergebnis\fP auf NULL gesetzt.
.P
.\" getnetent.3 doesn't document any use of h_errno, but nevertheless
.\" the nonreentrant functions no seem to set h_errno.
Der Puffer, auf den \fIh_Fehlernumz\fP zeigt, wird dazu verwandt, den Wert
zurückzuliefern, der in der globalen Variable \fIh_errno\fP durch die nicht
reentranten Versionen dieser Funktionen gespeichert würde.
.SH RÜCKGABEWERT
Bei Erfolg geben diese Funktionen Null zurück. Bei einem Fehler wird eine in
FEHLER aufgeführte positive Zahl zurückgegeben.
.P
Im Fehlerfall, »Datensatz nicht gefunden« (\fBgetnetbyname_r\fP(),
\fBgetnetbyaddr_r\fP()) oder »Ende der Eingabe« (\fBgetnetent_r\fP()), wird
\fIErgebnis\fP auf NULL gesetzt.
.SH FEHLER
.TP 
\fBENOENT\fP
(\fBgetnetent_r\fP()) Keine weiteren Datensätze in der Datenbank.
.TP 
\fBERANGE\fP
\fIPuf\fP ist zu klein. Versuchen Sie es mit einem größeren Puffer erneut (und
vergrößern Sie \fIGröße\fP).
.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
\fBgetnetent_r\fP(),
\fBgetnetbyname_r\fP(),
\fBgetnetbyaddr_r\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher locale
.TE
.SH VERSIONEN
Funktionen mit ähnlichem Namen existieren auf einigen anderen Systemen,
allerdings typischerweise mit anderen Aufrufsignaturen.
.SH STANDARDS
GNU.
.SH "SIEHE AUCH"
\fBgetnetent\fP(3), \fBnetworks\fP(5)
.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 Mailingliste der Übersetzer:
.MT debian-l10n-german@lists.debian.org
.ME .