Provided by: manpages-de-dev_4.13-4_all 
BEZEICHNUNG
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - liest einen Netzwerkeintrag
ÜBERSICHT
#include <netdb.h>
struct netent *getnetent(void);
struct netent *getnetbyname(const char *name);
struct netent *getnetbyaddr(uint32_t Netz, int Typ);
void setnetent(int offenhalten);
void endnetent(void);
BESCHREIBUNG
Die Funktion getnetent() liest den nächsten Eintrag der Netzwerkdatenbank und gibt eine Struktur netent
zurück, die die Felder der Zeile enthält. Falls notwendig, wird eine Verbindung zur Datenbank
hergestellt.
Die Funktion getnetbyname() gibt eine Struktur netent für den Datenbankeintrag zurück, der dem Netz name
entspricht.
Die Funktion getnetbyaddr() gibt eine Struktur netent für den Datenbankeintrag zurück, der der Netznummer
Netz des Types Typ entspricht. Das Argument Netz muss in der Byteordnung des Rechners angegeben werden.
Die Funktion setnetent() stellt eine Datenbankverbindung her und setzt den Dateizeiger auf den ersten
Eintrag. Falls offenhalten nicht Null ist, wird die Datenbankverbindung zwischen Aufrufen der
getnet*()-Funktionen aufrecht erhalten.
Die Funktion endnetent() schließt die Verbindung zur Datenbank.
Die Struktur netent ist in <netdb.h> wie folgt definiert:
struct netent {
char *n_name; /* offizieller Netzwerkname */
char **n_aliases; /* Alias-Liste */
int n_addrtype; /* Netz-Adresstyp */
uint32_t n_net; /* Netzwerknummer */
}
Die Elemente der Struktur netent sind:
n_name Der offizielle Name der Netzes.
n_aliases
Eine mit NULL beendete Liste von alternativen Namen für das Netz.
n_addrtype
Der Typ der Netznummer; immer AF_INET.
n_net Die Netznummer in der Byte-Ordnung des Rechners.
RÜCKGABEWERT
Die Funktionen getnetent(), getnetbyname() und getnetbyaddr() geben einen Zeiger auf eine statisch
bereitgestellte Struktur netent zurück oder einen Null-Zeiger, wenn ein Fehler auftritt oder das Ende der
Liste erreicht ist.
DATEIEN
/etc/networks
Netzwerkdatenbank
ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
┌────────────────┬───────────────────────┬───────────────────────────┐
│ Schnittstelle │ Attribut │ Wert │
├────────────────┼───────────────────────┼───────────────────────────┤
│ getnetent() │ Multithread-Fähigkeit │ MT-Unsafe race:netent │
│ │ │ race:netentbuf env locale │
├────────────────┼───────────────────────┼───────────────────────────┤
│ getnetbyname() │ Multithread-Fähigkeit │ MT-Unsafe race:netbyname │
│ │ │ env locale │
├────────────────┼───────────────────────┼───────────────────────────┤
│ getnetbyaddr() │ Multithread-Fähigkeit │ MT-Unsafe race:netbyaddr │
│ │ │ locale │
├────────────────┼───────────────────────┼───────────────────────────┤
│ setnetent(), │ Multithread-Fähigkeit │ MT-Unsafe race:netent env │
│ endnetent() │ │ locale │
└────────────────┴───────────────────────┴───────────────────────────┘
In der obigen Tabelle bedeutet netent in race:netent, dass, falls eine der Funktionen setnetent(),
getnetent() oder endnetent() in verschiedenen Threads eines Programms parallel verwandt werden,
konkurrierende Zugriffe auf Daten (»data races«) auftreten könnten.
KONFORM ZU
POSIX.1-2001, POSIX.1-2008, 4.3BSD.
ANMERKUNGEN
In Glibc-Versionen vor 2.2 war das Argument Netz von getnetbyaddr() vom Typ long.
SIEHE AUCH
getnetent_r(3), getprotoent(3), getservent(3)
RFC 1101
KOLOPHON
Diese Seite ist Teil der Veröffentlichung 5.10 des Projekts Linux-man-pages. Eine Beschreibung des
Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
sich unter https://www.kernel.org/doc/man-pages/.
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
und Dr. Tobias Quathamer <toddy@debian.org> 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.
GNU 21. Dezember 2020 GETNETENT(3)