.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Sat Jul 24 21:48:06 1993 by Rik Faith (faith@cs.unc.edu)
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getnetent 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent \- liest einen
Netzwerkeintrag
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <netdb.h>\fP
.PP
\fBstruct netent *getnetent(void);\fP
.PP
\fBstruct netent *getnetbyname(const char *\fP\fIname\fP\fB);\fP
\fBstruct netent *getnetbyaddr(uint32_t \fP\fINetz\fP\fB, int \fP\fITyp\fP\fB);\fP
.PP
\fBvoid setnetent(int \fP\fIoffenhalten\fP\fB);\fP
\fBvoid endnetent(void);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBgetnetent\fP() liest den nächsten Eintrag der Netzwerkdatenbank
und gibt eine Struktur \fInetent\fP zurück, die die Felder der Zeile
enthält. Falls notwendig, wird eine Verbindung zur Datenbank hergestellt.
.PP
Die Funktion \fBgetnetbyname\fP() gibt eine Struktur \fInetent\fP für den
Datenbankeintrag zurück, der dem Netz \fIname\fP entspricht.
.PP
Die Funktion \fBgetnetbyaddr\fP() gibt eine Struktur \fInetent\fP für den
Datenbankeintrag zurück, der der Netznummer \fINetz\fP des Types \fITyp\fP
entspricht. Das Argument \fINetz\fP muss in der Byteordnung des Rechners
angegeben werden.
.PP
Die Funktion \fBsetnetent\fP() stellt eine Datenbankverbindung her und setzt
den Dateizeiger auf den ersten Eintrag. Falls \fIoffenhalten\fP nicht Null ist,
wird die Datenbankverbindung zwischen Aufrufen der \fBgetnet*\fP()\-Funktionen
aufrecht erhalten.
.PP
Die Funktion \fBendnetent\fP() schließt die Verbindung zur Datenbank.
.PP
Die Struktur \fInetent\fP ist in \fI<netdb.h>\fP wie folgt definiert:
.PP
.in +4n
.EX
struct netent {
    char      *n_name;     /* offizieller Netzwerkname */
    char     **n_aliases;  /* Alias\-Liste */
    int        n_addrtype; /* Netz\-Adresstyp */
    uint32_t   n_net;      /* Netzwerknummer */
}
.EE
.in
.PP
Die Elemente der Struktur \fInetent\fP sind:
.TP 
\fIn_name\fP
Der offizielle Name der Netzes.
.TP 
\fIn_aliases\fP
Eine mit Nullzeiger abgeschlossene Liste von alternativen Namen für das
Netz.
.TP 
\fIn_addrtype\fP
Der Typ der Netznummer; immer \fBAF_INET\fP.
.TP 
\fIn_net\fP
Die Netznummer in der Byte\-Ordnung des Rechners.
.SH RÜCKGABEWERT
Die Funktionen \fBgetnetent\fP(), \fBgetnetbyname\fP() und \fBgetnetbyaddr\fP() geben
einen Zeiger auf eine statisch bereitgestellte Struktur \fInetent\fP zurück
oder einen Nullzeiger, wenn ein Fehler auftritt oder das Ende der Liste
erreicht ist.
.SH DATEIEN
.TP 
\fI/etc/networks\fP
Netzwerkdatenbank
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lb lb lbx
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBgetnetent\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:netent
race:netentbuf env locale
T}
T{
.na
.nh
\fBgetnetbyname\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:netbyname
env locale
T}
T{
.na
.nh
\fBgetnetbyaddr\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:netbyaddr
locale
T}
T{
.na
.nh
\fBsetnetent\fP(),
\fBendnetent\fP()
T}	Multithread\-Fähigkeit	T{
.na
.nh
MT\-Unsicher race:netent env
locale
T}
.TE
.sp 1
In der obigen Tabelle bedeutet \fInetent\fP in \fIrace:netent\fP, dass, falls eine
der Funktionen \fBsetnetent\fP(), \fBgetnetent\fP() oder \fBendnetent\fP() in
verschiedenen Threads eines Programms parallel verwandt werden,
konkurrierende Zugriffe auf Daten (»data races«) auftreten könnten.
.SH STANDARDS
POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, 4.3BSD.
.PP
Vore Glibc 2.2 war das Argument \fINetz\fP von \fBgetnetbyaddr\fP() vom Typ
\fIlong\fP.
.SH "SIEHE AUCH"
.\" .BR networks (5)
\fBgetnetent_r\fP(3), \fBgetprotoent\fP(3), \fBgetservent\fP(3)
.br
RFC\ 1101
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
und
Dr. Tobias Quathamer <toddy@debian.org>
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 .