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

NAME
     getservent, getservbyport, getservbyname, setservent, endservent -
     Funktionen der Datei für Netzdienste

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

     #include <netdb.h>

     void endservent(void);

     struct servent *getservbyname(const char *name, const char *proto);

     struct servent *getservbyport(int port, const char *proto);

     struct servent *getservent(void);

     void setservent(int stayopen);

BESCHREIBUNG
     Die Funktionen getservbyname, getservbyport und getservent geben einen
     Zeiger auf eine Struktur servent zurück, deren Komponenten die Felder
     eines Eintrags in der Datei für Netzdienste enthalten.

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

     Die Funktion getservbyname durchsucht die Datei nach dem ersten Ein-
     trag, bei dem der über name angegebene Name des Netzdienstes mit der
     Komponente sname und der über proto angegebene Protokollname mit der
     Komponente sproto übereinstimmt. Erforderlichenfalls wird eine Ver-
     bindung zur Datei hergestellt. (Die Suche beginnt dabei am Anfang der
     Datei.) Ist proto ein Null-Zeiger, kann die Komponente sproto einen
     beliebigen Wert haben.

     Die Funktion getservbyport durchsucht die Datei nach dem ersten Ein-
     trag, bei dem der über port angegebene Port mit der Komponente sport
     und der über proto angegebene Protokollname mit der Komponente sproto
     übereinstimmt. (Die Suche beginnt dabei am Anfang der Datei.) Erfor-
     derlichenfalls wird eine Verbindung zur Datei hergestellt. Ist proto
     ein Null-Zeiger, kann die Komponente sproto einen beliebigen Wert
     haben. Das Argument port muß in der Netzbytereihenfolge vorliegen.

     Die Funktion setservent 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 Netzdatei nicht nach jedem Aufruf
     von getservent (entweder direkt oder indirekt über eine der anderen
     getserv*-Funktionen) wieder aufgehoben.

     Die Funktion endservent schließt die Datei.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

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

RÜCKGABEWERT
     Bei erfolgreicher Ausführung geben getservbyname, getservbyport und
     getservent einen Zeiger auf die Struktur servent 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.

FEHLER
     Es sind keine Fehler definiert.

ANWENDUNGSZWECK
     Das Argument port der Funktion getservbyport muß nicht mit den Port-
     Werten aller Adreßfamilien kompatibel sein.

     Die Funktionen getservent, getservbyname und getservbyport geben mög-
     licherweise Zeiger auf statische Daten zurück, die durch nachfolgende
     Aufrufe einer dieser Funktionen überschrieben werden können.

     Diese Funktionen werden im allgemeinen mit der Internet-Adreßfamilie
     verwendet.

SIEHE AUCH
     byteorder(3N-xs), gethostent(3N-xs), getprotoent(3N-xs), inet(3N-xs),
     netdb(5).





























Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98