getprotoent(3N)                                             getprotoent(3N)

NAME
     getprotoent, getprotobynumber, getprotobyname, setprotoent, endproto-
     ent - Eintrag in Protokoll-Datei ermitteln

SYNTAX
     #include <netdb.h>

     struct protoent *getprotoent(void);

     struct protoent *getprotobyname(const char *name);

     struct protoent *getprotobynumber(int proto);

     int setprotoent(int stayopen);

     int endprotoent(void);

BESCHREIBUNG
     getprotoent(), getprotobyname() und getprotobynumber() liefern alle
     einen Zeiger auf ein Objekt der unten beschriebenen Struktur zurück.
     Die Struktur enthält die Felder einer Zeile in der Netz-Protokolldatei
     /etc/inet/protocols.

     struct    protoent {
          char    *pname;        /* offizieller Name des Protokolls */
          char    **paliases;    /* Alias-liste */
          int     pproto;        /* Protokollnummer */

     Die Felder der Struktur sind:

     pname        offizieller Name des Protokolls

     paliases     mit Null endende Liste alternativer Namen für das Proto-
                   koll

     pproto       Protokollnummer

     getprotoent() liest die nächste Zeile der Datei. Falls erforderlich
     wird die Datei zuvor noch geöffnet.

     setprotoent() öffnet die Datei und positioniert den Lesezeiger auf den
     Anfang. Falls die Option stayopen nicht Null ist, wird die Datei nicht
     nach jedem Aufruf von getprotoent() wieder geschlossen (weder direkt
     noch indirekt durch einen der anderen "getproto"-Aufrufe).

     endprotoent() schließt die Datei.

     getprotobyname() und getprotobynumber() suchen sequentiell vom Anfang
     der Datei an, bis ein passender Protokollname oder eine passende Pro-
     tokollnummer gefunden wurde, oder bis zum Erreichen eines EOF.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getprotoent(3N)                                             getprotoent(3N)

DIAGNOSE
     Bei Auftritt eines Fehlers oder bei Erreichen von EOF wird NULL
     zurückgeliefert.

     Alle Information wird in statischen Bereichen gehalten und muß somit
     kopiert werden, wenn sie gesichert werden soll. Nur die Internet-
     Protokolle sind im Augenblick gültig.

DATEIEN
     /etc/inet/protocols

SIEHE AUCH
     protocols(4).









































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98