endhostent(3)						     Library Functions Manual						     endhostent(3)

NAME

       endhostent, endhostent_r - Ends retrieval of network host entries

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <netdb.h>

       void endhostent ( void );

       [Tru64  UNIX]  The following function is supported in order to maintain backward compatibility with previous versions of the operating sys-
       tem.  void endhostent_r (
	       struct hostent_data *host_data);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       endhostent():  XNS4.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       [Tru64 UNIX]  For endhostent_r() only, this is data for the hosts database.

DESCRIPTION

       The endhostent() function closes the network hosts database (either the local /etc/hosts file or one of the files distributed  by  BIND	or
       NIS), previously opened with the gethostbyaddr() or gethostbyname() function.

       If  the most recent sethostent() function has been performed with a nonzero parameter, the endhostent() function will not close the network
       hosts database. In this instance, the database is not closed until a call to the exit() function.  A second sethostent() function  must	be
       issued with a parameter equal to 0 (zero) in order to ensure that a following endhostent() function will succeed.

NOTES

       [Tru64  UNIX]  The  endhostent_r()  function  is  the reentrant version of the endhostent() function.  It is supported in order to maintain
       backward compatibility with previous versions of the operating system.  The netdb.h header file defines the hostent and hostent_data struc-
       tures.

ERRORS

       Current industry standards do not define error values for the endhostent() function.

FILES

       Contains the local hostname database.

RELATED INFORMATION

       Networks: bind_intro(7), nis_intro(7)

       Functions: gethostbyaddr(3), gethostbyname(3), gethostent(3), sethostent(3)

       Standards: standards(5) delim off

																     endhostent(3)