# 2.11BSD#431 - /usr/man/cat3/getprotoent.0

    GETPROTOENT(3N)     UNIX Programmer's Manual	  GETPROTOENT(3N)

    NAME
         getprotoent, getprotobynumber, getprotobyname, setprotoent,
         endprotoent - get protocol entry

    SYNOPSIS
         #include <netdb.h>

         struct protoent *getprotoent()

         struct protoent *getprotobyname(name)
         char *name;

         struct protoent *getprotobynumber(proto)
         int proto;

         setprotoent(stayopen)
         int stayopen

         endprotoent()

    DESCRIPTION
         Getprotoent, getprotobyname, and getprotobynumber each
         return a pointer to an object with the following structure
         containing the broken-out fields of a line in the network
         protocol data base, /etc/protocols.

    	  struct    protoent {
    	       char *p_name;  /* official name of protocol */
    	       char **p_aliases;   /* alias list */
    	       int  p_proto;  /* protocol number */
    	  };

         The members of this structure are:

         p_name	The official name of the protocol.

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

         p_proto	The protocol number.

         Getprotoent reads the next line of  the  file,  opening  the
         file if necessary.

         Setprotoent opens and rewinds the	file.	If  the  stayopen
         flag is non-zero, the net data base will not be closed after
         each call to getprotobyname or getprotobynumber.

         Endprotoent closes the file.

         Getprotobyname and getprotobynumber sequentially search from
         the  beginning of the file until a matching protocol name or

    Printed 11/26/99	  May 19, 1986				1

    GETPROTOENT(3N)     UNIX Programmer's Manual	  GETPROTOENT(3N)

         protocol number is found, or until EOF is encountered.

    FILES
         /etc/protocols

    SEE ALSO
         protocols(5)

    DIAGNOSTICS
         Null pointer (0) returned on EOF or error.

    BUGS
         All information is contained in a static area so it must  be
         copied  if  it  is to be saved.  Only the Internet protocols
         are currently understood.

    Printed 11/26/99	  May 19, 1986				2

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 333 |