Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
endprotoent(3XNETX/Open	Networking Services Library Functionendprotoent(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,	 open-
       ing 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 nec-
       essary.

       The getprotobynumber() function searches	the database from  the	begin-
       ning  and finds the first entry for which the protocol number specified
       by number matches the p_proto member, opening a connection to the data-
       base 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 indirectly
       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 get-
       protoent() functions return a pointer to	a protoent  structure  if  the
       requested  entry	 was found, and	a null pointer if the end of the data-
       base 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	   |
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       attributes(5)

SunOS 5.9			  8 May	1998		    endprotoent(3XNET)

NAME | SYNOPSIS | DESCRIPTION | USAGE | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=endprotoent&sektion=3xnet&manpath=SunOS+5.9>

home | help