 |
Index for Section 3 |
|
 |
Alphabetical listing for E |
|
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 );
[Digital] 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);
STANDARDS
Interfaces documented on this reference page conform to industry standards
as follows:
endhostent(): XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
host_data [Digital] 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
[Digital] 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.
RELATED INFORMATION
Networks: bind_intro(7), nis_intro(7)
Functions: gethostbyaddr(3), gethostbyname(3), gethostent(3), sethostent(3)
Standards: standards(5)