opensolaris man page for getprotoent

endprotoent(3XNET)				   X/Open Networking Services Library Functions 				endprotoent(3XNET)

NAME
       endprotoent, getprotobynumber, getprotobyname, getprotoent, setprotoent - network protocol database functions

SYNOPSIS
       cc [ flag ... ] file ... -lxnet [ library ... ]
       #include <netdb.h>

       void endprotoent(void)

       struct protoent *getprotobyname(const char *name);

       struct protoent *getprotobynumber(int proto);

       struct protoent *getprotoent(void)

       void setprotoent(int stayopen);

DESCRIPTION
       The  getprotobyname(),  getprotobynumber() and getprotoent(), functions each return a pointer to a protoent structure, the members of which
       contain the fields of an entry in the network protocol database.

       The getprotoent() function reads the next entry of the database, opening a connection to the database if necessary.

       The getprotobyname() function searches the database from the beginning and finds the first entry for which the protocol name  specified	by
       name matches the p_name member, opening a connection to the database if necessary.

       The  getprotobynumber() function searches the database from the beginning and finds the first entry for which the protocol number specified
       by number matches the p_proto member, opening a connection to the database if necessary.

       The setprotoent() function opens a connection to the database, and sets the next entry to the first entry.  If  the  stayopen  argument	is
       non-zero,  the  connection  to the network protocol database will not be closed after each call to getprotoent() (either directly, or indi-
       rectly through one of the other getproto*() functions).

       The endprotoent() function closes the connection to the database.

USAGE
       The getprotobyname(), getprotobynumber() and getprotoent() functions may return pointers to static data, which may be overwritten by subse-
       quent calls to any of these functions.

       These functions are generally used with the Internet address family.

RETURN VALUES
       On  successful completion, getprotobyname(), getprotobynumber() and getprotoent() functions return a pointer to a protoent structure if the
       requested entry was found, and a null pointer if the end of the database was reached or the requested entry was not  found.   Otherwise,  a
       null pointer is returned.

ERRORS
       No errors are defined.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       attributes(5), standards(5)

SunOS 5.11							    10 Jun 2002 						endprotoent(3XNET)