The gethostent(), gethostbyaddr(),
and gethostbyname() functions each return a pointer to
a hostent structure, the members of which contain the
fields of an entry in the network host database.
The gethostent() function reads the next entry
of the database, opening a connection to the database if necessary.
The gethostbyaddr() function searches the database
and finds an entry which matches the address family specified by the type argument and which matches the address pointed to by the addr argument, opening a connection to the database if necessary.
The addr argument is a pointer to the binary-format
(that is, not null-terminated) address in network byte order, whose length
is specified by the len argument. The datatype
of the address depends on the address family. For an address of type AF_INET, this is an in_addr structure,
defined in <netinet/in.h>. For an
address of type AF_INET6, there is an in6_addr structure defined in <netinet/in.h>.
The gethostbyname() function searches the database
and finds an entry which matches the host name specified by the name argument, opening a connection to the database if necessary.
If name is an alias for a valid host name,
the function returns information about the host name to which the alias
refers, and name is included in the list of
aliases returned.
The sethostent() function opens a connection to
the network host database, and sets the position of the next entry to the
first entry. If the stayopen argument is non-zero,
the connection to the host database will not be closed after each call to gethostent() (either directly, or indirectly through one of the
other gethost*() functions).
The endhostent() function closes the connection
to the database.
|