endhostent(3) — Subroutines
NAME
endhostent, endhostent_r − End retrieval of network host entries
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 system. void endhostent_r(
struct hostent_data ∗host_data );
LIBRARY
Standard C Library (libc)
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
endhostent(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information about industry standards and associated tags.
PARAMETERS
host_data
[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 structures.
ERRORS
Current industry standards do not define error values for the endhostent() function.
FILES
/etc/hosts
Contains the local hostname database.
SEE ALSO
Networks: bind_intro(7), nis_intro(7)
Functions: gethostbyaddr(3), gethostbyname(3), gethostent(3), sethostent(3)
Standards: standards(5)
Network Programmer’s Guide