getnetent(3N) getnetent(3N)
NAME
getnetent, getnetbyaddr, getnetbyname, setnetent, endnetent - Netzein-
trag ermitteln
SYNTAX
#include <netdb.h>
struct netent *getnetent(void);
struct netent *getnetbyname(const char *name);
struct netent *getnetbyaddr(inaddrt net, int type);
void setnetent(int stayopen);
void endnetent(void);
BESCHREIBUNG
getnetent(), getnetbyname() und getnetbyaddr() liefern alle einen Zei-
ger auf ein Objekt der unten beschriebenen Struktur zurück. Die Struk-
tur enthält die Felder einer Zeile der Netz-Datei /etc/inet/networks.
struct netent {
char *nname; /* offizieller Name des Netzes */
char **naliases; /* Alias-Liste */
int naddrtype; /* Typ der Netznummer */
inaddrt nnet; /* Netznummer */
};
Die Elemente dieser Struktur sind:
nname offizieller Name des Netzes
naliases mit Null endende Liste alternativer Namen für das Netz
naddrtype Typ der Netznummer; im Augenblick nur AFINET
nnet Netznummer; wird in der rechnerspezifischen Byte-Anord-
nung zurückgeliefert
getnetent() liest die nächste Zeile in der Datei und öffnet die Datei
gegebenenfalls zuvor.
setnetent() öffnet die Datei und positioniert sie auf den Anfang.
Falls die Option stayopen nicht Null ist, dann wird die Datei nicht
nach jedem Aufruf von getnetent() geschlossen (weder direkt noch indi-
rekt durch einen der anderen "getnet"-Aufrufe).
endnetent() schließt die Datei.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
getnetent(3N) getnetent(3N)
getnetbyname() und getnetbyaddr() durchsuchen die Datei sequentiell
von Anfang an, bis ein passender Netzname oder eine passendes Paar von
Netznummer und Typ gefunden wurde, oder bis EOF erreicht wurde. Netz-
nummern werden in rechnerspezifischer Byte-Anordnung geliefert.
DIAGNOSE
Bei Auftreten eines Fehler oder bei Erreichen von EOF wird ein NULL-
Zeiger zurückgegeben.
HINWEISE
Jede Information befindet sich in statischen Bereichen und muß kopiert
werden, wenn sie gesichert werden soll.
Im Augenblick sind nur Internet-Netzwerknummern gültig.
DATEIEN
/etc/inet/networks
SIEHE AUCH
networks(4).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98