GETNETENT(3)

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 net, int type);

void setnetent(int stayopen);

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 net des Types type entspricht. Das Argument net muss in der Byteordnung des Rechners angegeben werden.

Die Funktion setnetent() stellt eine Datenbankverbindung her und setzt den Dateizeiger auf den ersten Eintrag. Falls stayopen 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

KONFORM ZU
4.3BSD, POSIX.1-2001.

ANMERKUNGEN
In Glibc-Versionen vor 2.2 war das Argument net von getnetbyaddr() vom Typ long.

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

KOLOPHON
This page is part of release 3.80 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer <Martin.E.Schauer@gmx.de> 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 <debian-l10n-german@lists.debian.org>.