GETPROTOENT(3) BSD Library Functions Manual GETPROTOENT(3)

NAME
     ggeettpprroottooeenntt, ggeettpprroottoobbyynnuummbbeerr, ggeettpprroottoobbyynnaammee, sseettpprroottooeenntt, eennddpprroottooeenntt
     - get protocol entry

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     struct protoent *
     ggeettpprroottooeenntt(void);

     struct protoent *
     ggeettpprroottoobbyynnaammee(const char *name);

     struct protoent *
     ggeettpprroottoobbyynnuummbbeerr(int proto);

     void
     sseettpprroottooeenntt(int stayopen);

     void
     eennddpprroottooeenntt(void);

DESCRIPTION
     The ggeettpprroottooeenntt(), ggeettpprroottoobbyynnaammee(), and ggeettpprroottoobbyynnuummbbeerr() functions
     each return a pointer to an object with the following structure contain-
     ing the broken-out fields of a line in the network protocol data base,
     /etc/protocols.


           struct  protoent {
                   char    *pname;        /* official name of protocol */
                   char    **paliases;    /* alias list */
                   int     pproto;        /* protocol number */
           };

     The members of this structure are:

     pname     The official name of the protocol.

     paliases  A zero terminated list of alternate names for the protocol.

     pproto    The protocol number.

     The ggeettpprroottooeenntt() function reads the next line of the file, opening the
     file if necessary.

     The sseettpprroottooeenntt() function opens and rewinds the file.  If the stayopen
     flag is non-zero, the net data base will not be closed after each call to
     ggeettpprroottoobbyynnaammee() or ggeettpprroottoobbyynnuummbbeerr().

     The eennddpprroottooeenntt() function closes the file.

     The ggeettpprroottoobbyynnaammee() function and ggeettpprroottoobbyynnuummbbeerr() sequentially search
     from the beginning of the file until a matching protocol name or protocol
     number is found, or until EOF is encountered.

RETURN VALUES
     Null pointer (0) returned on EOF or error.

FILES     /etc/protocols

SEE ALSO
     protocols(5)

HISTORY     The ggeettpprroottooeenntt(), ggeettpprroottoobbyynnuummbbeerr(), ggeettpprroottoobbyynnaammee(), sseettpprroottooeenntt(),
     and eennddpprroottooeenntt() functions appeared in 4.2BSD.

BUGS
     These functions use a static data space; if the data is needed for future
     use, it should be copied before any subsequent calls overwrite it.  Only
     the Internet protocols are currently understood.

BSD                              June 4, 1993                              BSD