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

NAME
     getprotoent, getprotobynumber, getprotobyname, setprotoent,
     endprotoent - Funktionen der Netzprotokolldatei

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

     #include <netdb.h>

     void endprotoent(void);

     struct protoent *getprotobyname(const char *name);

     struct protoent *getprotobynumber(int proto);

     struct protoent *getprotoent(void);

     void setprotoent(int stayopen);

BESCHREIBUNG
     Die Funktionen getprotobyname, getprotobynumber und getprotoent geben
     einen Zeiger auf eine Struktur protoent zurück, deren Komponenten die
     Felder eines Eintrags in der Netzprotokolldatei enthalten.

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

     Die Funktion getprotobyname durchsucht die Datei nach dem ersten Ein-
     trag, bei dem der über name angegebene Protokollname mit der Kompo-
     nente pname übereinstimmt und stellt erforderlichenfalls eine Verbin-
     dung zur Datei her. (Die Suche beginnt dabei am Anfang der Datei.)

     Die Funktion getprotobynumber durchsucht die Datei nach dem ersten Ein-
     trag, bei dem die über number angegebene Protokollnummer mit der Kompo-
     nente pproto übereinstimmt und stellt erforderlichenfalls eine Verbin-
     dung zur Datei her. (Die Suche beginnt dabei am Anfang der Datei.)

     Die Funktion setprotoent stellt eine Verbindung zur Datei her und
     setzt den nächsten Eintrag auf den ersten Eintrag. Ist das Argument
     stayopen nicht Null, wird die Verbindung zur Netzprotokolldatei nicht
     nach jedem Aufruf von getprotoent (entweder direkt oder indirekt über
     eine der anderen getproto*-Funktionen) wieder aufgehoben.

     Die Funktion endprotoent beendet die Verbindung zur Datei.

RÜCKGABEWERT
     Bei erfolgreicher Ausführung geben getprotbyname, getprotobynumber und
     getprotoent einen Zeiger auf eine Struktur protoent zurück, wenn der
     angeforderte 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ück-
     gegeben.



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

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

FEHLER
     Es sind keine Fehler definiert.

ANWENDUNGSZWECK
     Die Funktionen getprotobyname, getprotobynumber und getprotoent geben
     möglicherweise Zeiger auf statische Daten zurück, die durch nachfol-
     gende 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