This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

gethostent()

Read the next line of the host database file

Synopsis:

#include <netdb.h>

struct hostent * gethostent( void );

Library:

libsocket

Use the -l socket option to qcc to link against this library.

Description:

The gethostent() routine reads the next line in the host database file.

Returns:

A pointer to a valid hostent structure, or NULL if an error occurs.

Files:

/etc/hosts

Host database file.

/etc/resolv.conf

Resolver configuration file.

Classification:

POSIX 1003.1

Caveats:

This function uses static data storage; if you need the data for future use, copy it before any subsequent calls overwrite it.

Currently, this function understands only the Internet address format.

See also:

endhostent(), gethostbyaddr(), gethostbyname(), gethostent_r(), hostent, sethostent()

/etc/hosts, /etc/resolv.conf in the Utilities Reference