getnetent(3N-xs)              (X/OPEN SOCKETS)             getnetent(3N-xs)

NAME
     getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent - Funktio-
     nen der Netzdateien

SYNTAX
     cc [flag ...] file ... -lxnet [library ...]

     #include <netdb.h>

     void endnetent(void);

     struct netent *getnetbyaddr(inaddrt net, int type);

     struct netent *getnetbyname(const char *name);

     struct netent *getnetent(void);

     void setnetent(int stayopen);

BESCHREIBUNG
     Die Funktionen getnetbyaddr, getnetbyname und getnetent geben einen
     Zeiger auf eine Struktur netent zurück, deren Komponenten die Felder
     eines Eintrags in der Netzdatei enthalten.

     Die Funktion getnetent liest jeweils den nächsten Eintrag der Datei
     und stellt erforderlichenfalls eine Verbindung zur Datei her.

     Die Funktion getnetbyaddr durchsucht die Datei nach dem ersten Ein-
     trag, bei dem die über type angegebene Adreßfamilie mit der Komponente
     naddrtype und die Netznummer net mit der Komponente nnet überein-
     stimmt. (Die Suche beginnt dabei am Anfang der Datei.) Erforderlichen-
     falls stellt die Funktion eine Verbindung zur Datei her. Das Argument
     net ist die Netznummer in der Bytereihenfolge des Rechners.

     Die Funktion getnetbyname durchsucht die Datei nach dem ersten Ein-
     trag, bei dem der über name angegebene Netzname mit der Komponente
     nname übereinstimmt, und stellt erforderlichenfalls eine Verbindung
     zur Datei her. (Die Suche beginnt dabei am Anfang der Datei.)

     Die Funktion setnetent öffnet die Datei und setzt sie auf den Anfang
     zurück. Ist das Argument stayopen nicht Null, wird die Verbindung zur
     Netzdatei nicht nach jedem Aufruf von getnetent (entweder direkt oder
     indirekt über eine der anderen getnet*-Funktionen) wieder aufgehoben.

     Die Funktion endnetent schließt die Datei.

RÜCKGABEWERT
     Bei erfolgreicher Ausführung geben getnetbyaddr, getnetbyname und
     getnetent einen Zeiger auf eine Struktur netent zurück, wenn der ange-
     forderte Eintrag gefunden wurde, und einen Null-Zeiger, wenn das Ende
     der Datei erreicht oder der angeforderte Eintrag nicht gefunden wurde.
     Bei nicht erfolgreicher Ausführung wird ein Null-Zeiger zurückgegeben.



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getnetent(3N-xs)              (X/OPEN SOCKETS)             getnetent(3N-xs)

FEHLER
     Es sind keine Fehler definiert.

ANWENDUNGSZWECK
     Die Funktionen getnetbyaddr, getnetbyname und getnetent geben mögli-
     cherweise Zeiger auf statische Daten zurück, die durch nachfolgende
     Aufrufe einer dieser Funktionen überschrieben werden können.

     Diese Funktionen werden im allgemeinen mit der Internet-Adreßfamilie
     verwendet.

SIEHE AUCH
     netdb(5).









































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98