getnetent

Autres langues

Langue: de

Version: 1. November 1996 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

BEZEICHNUNG

getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - hole Netzwerkeintrag

ÜBERSICHT


#include <netdb.h>



struct netent *getnetent(void);



struct netent *getnetbyname(const char *name);



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



void setnetent(int stayopen);



void endnetent(void);

DESCRIPTION

Die Funktion getnetent() liest die nächste Zeile der Datei /etc/networks und gibt eine Struktur netent zurück, die die Felder der Zeile enthält. Die Datei /etc/networks wird geöffnet, falls nötig.

Die Funktion getnetbyname() gibt eine Struktur netent zurück für die Zeile aus /etc/networks, die dem Netz name entspricht.

Die Funktion getnetbyaddr() gibt eine Struktur netent zurück für die Zeile, die der Netznummer net des Types type entspricht.

Die Funktion setnetent() öffnet die Datei /etc/networks und setzt den Dateizeiger auf den Anfang. Wenn stayopen wahr ist (1), dann wird die Datei nicht geschlossen zwischen Aufrufen von getnetbyname() und getnetbyaddr().

Die Funktion endservent() schließt /etc/networks.

Die Struktur netent ist definiert in <netdb.h> wie folgt:




struct netent {

        char    *n_name;          /* offizieller Netzname */

        char    **n_aliases;      /* Aliasliste */

        int     n_addrtype;       /* Netzadressentyp */

        unsigned long int n_net;  /* Netznummer */

}



Die Einträge 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 Host-Byte-Ordnung.

RÜCKGABEWERT

Die Funktionen getnetent(), getnetbyname() und getnetbyaddr() geben die Struktur netent zurück, oder einen NULL-Zeiger wenn ein Fehler auftritt oder das Ende der Liste erreicht ist.

DATEIEN

/etc/networks
Netzwerkdatenbankdatei

KONFORM ZU

BSD 4.3

SIEHE AUCH

getprotoent(3), getservent(3), networks(5).