getprotoent(3)                      CLIX                      getprotoent(3)



  NAME

    getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent -
    Gets a protocol entry

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    #include <netdb.h>

    struct protoent *getprotoent(
      void );

    struct protoent *getprotobyname(
      char *name );

    struct protoent *getprotobynumber(
      int proto );

    void setprotoent(
      int stayopen );

    void endprotoent(
      void );

  DESCRIPTION

    The getprotoent(), getprotobyname(), and getprotobynumber() functions
    return a pointer to an object with the following structure containing the
    broken-down fields of a line in the network protocol database,
    /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 as follows:

    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.

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



  2/94 - Intergraph Corporation                                              1

  getprotoent(3)                      CLIX                      getprotoent(3)



    The setprotoent() function opens and rewinds the file.  If the stayopen
    flag is nonzero, the network database will not be closed after each call
    to getprotobyname() or getprotobynumber().

    The endprotoent() function closes the file.

    The getprotobyname() and getprotobynumber() functions sequentially search
    from the beginning of the file until a matching protocol name or number is
    found or until EOF is encountered.

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

  FILES

    /etc/protocols

  RETURN VALUES

    A null pointer (0) is returned at EOF or when an error occurs.

  RELATED INFORMATION

    Files:  protocols(4)






























  2                                              Intergraph Corporation - 2/94