Scroll to navigation

getnetent(3) Library Functions Manual getnetent(3)

BEZEICHNUNG

getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - liest einen Netzwerkeintrag

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

Ü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:

Der offizielle Name der Netzes.
Eine mit Nullbyte abgeschlossene Liste von alternativen Namen für das Netz.
Der Typ der Netznummer; immer AF_INET.
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 Nullzeiger, 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(), endnetent() Multithread-Fähigkeit MT-Unsafe race:netent env 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.

STANDARDS

POSIX.1-2001, POSIX.1-2008, 4.3BSD.

ANMERKUNGEN

Vore Glibc 2.2 war das Argument Netz von getnetbyaddr() vom Typ long.

SIEHE AUCH

getnetent_r(3), getprotoent(3), getservent(3)
RFC 1101

Ü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.

15. Dezember 2022 Linux man-pages 6.03