getnetconfig(3N)                                           getnetconfig(3N)

NAME
     getnetconfig, setnetconfig, endnetconfig, freenetconfigent,
     getnetconfigent - Netzkonfiguration ermitteln

SYNTAX
     #include <netconfig.h>

     void *setnetconfig(void);

     struct netconfig *getnetconfig(void *handlep);

     int endnetconfig(void *handlep);

     struct netconfig *getnetconfigent(char *netid);

     int freenetconfigent(struct netconfig *netconfigp);

BESCHREIBUNG
     Die fünf Bibliotheksroutinen, die hier beschrieben sind, sind Teil der
     UNIX System V Komponente für die Auswahl des Transportdienstes. Sie
     stellen Anwendungen den Zugriff auf die System-Datei für die Netzkon-
     figuration, /etc/netconfig, zur Verfügung. Zusätzlich zur Datei
     netconfig(4) und zu den entsprechenden Zugriffsroutinen steht die
     Umgebungsvariable NETPATH zur Verfügung [siehe environ(5)] und die
     NETPATH-Zugriffsroutinen, die in getnetpath(3N) beschrieben werden.

     Der Aufruf von setnetconfig() öffnet die Datei netconfig und setzt sie
     zurück. Vor dem ersten Aufruf von getnetconfig() muß setnetconfig()
     aufgerufen werden, um die Datei zu öffnen. setnetconfig() liefert ein
     einziges Objekt zurück, das von getnetconfig() verwendet wird.

     Beim ersten Aufruf liefert getnetconfig() einen Zeiger auf den aktuel-
     len Eintrag in der netconfig-Datenbank zurück, der das Format struct
     netconfig hat. getnetconfig() kann somit für das Durchsuchen der gan-
     zen netconfig-Datei verwendet werden. getnetconfig() liefert NULL
     zurück, wenn das Dateiende erreicht wurde.

     Wenn die Bearbeitung beendet ist, sollte endnetconfig() aufgerufen
     werden, um den von getnetconfig() intern allokierten Speicher für
     netconfig-Strukturen freizugeben. endnetconfig() darf nicht vor
     setnetconfig() aufgerufen werden. endnetconfig() liefert im Erfolgs-
     fall 0 und im Fehlerfall -1 zurück (wenn z. B. setnetconfig() zuvor
     nicht aufgerufen wurde).

     getnetconfigent(netid) liefert einen Zeiger auf die Struktur struct
     netconfig zurück, die zu netid gehört. Sie liefert NULL zurück, wenn
     netid ungültig ist (d. h., es paßt zu keinem Eintrag in der Datei
     netconfig). Sie liefert NULL zurück und setzt errno, falls ein Fehler
     aufgetreten ist (wenn z. B. setnetconfig() zuvor nicht aufgerufen
     wurde).





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getnetconfig(3N)                                           getnetconfig(3N)

     freenetconfigent(netconfigp) gibt die netconfig-Struktur frei, auf die
     netconfigp verweist (wurde zuvor von getnetconfigent() zurückgelie-
     fert).

SIEHE AUCH
     getnetpath(3N), netconfig(4), environ(5).
















































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98