Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

getipnodebyname(3) OSS Library Calls Reference Manual
AI_V4MAPPED
Requests the return of all IPv4-mapped IPv6 addresses when the
address family is AF_INET6 and there are no matching IPv6
addresses. This flag is ignored if the address family is
AF_INET.
error_num Returns an error code if the call fails.
DESCRIPTION
The getipnodebyname() function searches host entries sequentially until a match with the name
parameter occurs.
The getipnodebyname() function returns a pointer to a structure of type hostent whose members
specify data obtained from a name server specified in the /etc/resolv.conf file or from fields of a
record line in the network hostname database file. When the name server is not running and
/etc/resolv.conf cannot be searched, this function searches the network hostname database file.
The netdb.h header file defines the hostent structure.
NOTES
This function provides the same information as the gethostbyname() function but is protocol-
independent.
Information returned by getipnodebyname() is dynamically allocated; the hostent structure and
the data areas pointed to by the members of the hostent structure are all dynamically allocated.
Use the freehostent() function to return memory to the system.
The getipnodebyname() function must be used in a thread-safe environment.
RETURN VALUES
Upon successful completion, this function returns a pointer to the hostent structure containing an
IP address. The returned address is in network order and can be used directly in a sockaddr_in
or sockaddr_in6 structure.
If the call fails, a NULL pointer is returned and one of the following nonzero values is returned
for the error_num parameter:
HOST_NOT_FOUND
The specified name is not a valid hostname or alias. This is not a soft error;
another type of name server request might be successful.
NO_ADDRESS
The server recognized the request and the name specified but no address is avail-
able. This is not a soft error; another type of name server request might be suc-
cessful.
NO_RECOVERY
A server failure occurred. This is a nonrecoverable error.
TRY_AGAIN An error occurred that might have been caused by a transient condition. A later
retry might succeed.
ERRORS
This function does not set errno.
RELATED INFORMATION
Functions: freeaddrinfo(3), freehostent(3), gai_strerror(3), getaddrinfo(3), getipnode-
byaddr(3), getnameinfo(3), if_freenameindex(3), if_indextoname(3), if_nameindex(3),
if_nametoindex(3), inet_pton(3), inet_ntop(3).
3−44 Hewlett-Packard Company 527187-007