getnetpath(3N)                                               getnetpath(3N)

NAME
     getnetpath, setnetpath, endnetpath - /etc/netconfig-Eintrag, der
     NETPATH entspricht, abfragen

SYNTAX
     #include <netconfig.h>

     void *setnetpath(void);

     struct netconfig *getnetpath(void *handlep);

     int endnetpath(void *handlep);

BESCHREIBUNG
     Die drei hier beschriebenen Routinen sind Teil der UNIX System V Kom-
     ponenten zur Auswahl des Transportsystems. Sie stellen Anwendungen den
     Zugriff auf den Teil der Systemdatei der Netzkonfiguration,
     /etc/netconfig, zur Verfügung, der durch die Umgebungsvariable NETPATH
     [siehe environ(5)] angegeben wird. Die Transportsystemauswahl enthält
     ebenso Routinen, die auf die Netz-Konfigurationsdatei direkt zugreifen
     [siehe getnetconfig(3N)].

     Ein Aufruf von setnetpath() übernimmt der Wert der Variablen NETPATH
     für den Prozeß oder setzt ihn zurück. setnetpath() muß vor dem ersten
     Aufruf von getnetpath aufgerufen werden. Die Routine liefert ein
     Objekt zurück, das von getnetpath verwendet wird. setnetpath() schlägt
     fehl, wenn die netconfig-Datei nicht vorhanden ist. Falls NETPATH
     nicht gesetzt ist, liefert setnetpath() die Anzahl der "visible"
     Transportsysteme in der Datei netconfig zurück. Ein Transportsystem
     ist "visible", wenn für es in der Datei /etc/netconfig ein entspre-
     chendes Flag gesetzt ist. Die Menge der "visible" Transportsysteme
     stellt damit einen Standard-NETPATH dar.

     Beim ersten Aufruf liefert getnetpath() einen Zeiger auf den
     netconfig-Eintrag zurück, der zur ersten gültigen NETPATH-Komponente
     gehört. Der netconfig-Eintrag hat das Format der Struktur netconfig.
     Bei jedem nachfolgenden Aufruf liefert getnetpath einen Zeiger auf den
     netconfig-Eintrag zurück, der zur nächsten gültigen NETPATH-Komponente
     gehört. getnetpath() kann somit dazu verwendet werden, die netconfig-
     Datei nach allen Transportsystemen, die in der Variablen NETPATH ent-
     halten sind, zu durchsuchen. Wenn NETPATH ganz durchlaufen wurde, lie-
     fert getnetpath() NULL zurück.

     getnetpath() ignoriert ungültige NETPATH-Komponenten. Eine NETPATH-
     Komponente ist ungültig, falls es keinen dazugehörenden Eintrag in der
     netconfig-Datei gibt.

     Falls die Variable NETPATH zurückgesetzt wird (unset im Aufruf von
     setnetpath()), verhält sich getnetpath(), als ob NETPATH auf die Folge
     von Standard- oder "visible" Transportsystemen in der Datei netconfig
     gesetzt worden wäre, und zwar in der Reihenfolge, in der sie aufgeli-
     stet sind.



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getnetpath(3N)                                               getnetpath(3N)

     endnetpath() kann aufgerufen werden, um nach Ende der Bearbeitung die
     Auswirkung von NETPATH auf die Systemumgebung zurückzunehmen, und um
     von setnetpath() allokierten Speicher wieder freizugeben. endnetpath()
     liefert im Erfolgsfall 0 und im Fehlerfall -1 zurück (z. B. wenn
     setnetpath() nicht aufgerufen wurde).

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














































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98