Retrieves a network host entry.
Standard C Library (libc.a)
(libbind)
(libnis)
(liblocal)#include <netdb.h>
int gethostent_r (htent, ht_data)
struct hostent *htent;
struct hostent_data *ht_data;When using DNS/BIND name service resolution, the gethostent_r subroutine is not defined.
When using NIS name service resolution or searching the local /etc/hosts file, the gethostent_r subroutine reads the next line of the /etc/hosts file, and opens the file if necessary.
The gethostent_r subroutine internally calls the gethostent subroutine, and stores the values in the htent and ht_data structures.
The gethostent subroutine overwrites the static data returned in subsequent calls. The gethostent_r subroutine does not.
| Item | Description |
|---|---|
| htent | Points to the hostent structure |
| ht_data | Points to the hostent_data structure |
This subroutine returns a 0 if successful, and a -1 if unsuccessful.
| Item | Description |
|---|---|
| /etc/hosts | Contains the host name database. |
| /etc/netsvc.conf | Contains the name services ordering. |
| /usr/include/netdb.h | Contains the network database structure. |