Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

getipnodebyaddr(3) OSS Library Calls Reference Manual
2. If addr_family is AF_INET, the function looks up the name for the given IPv4 address.
3. If addr_family is AF_INET6, the function looks up the name for the given IPv6 address.
Information returned by getipnodebyaddr( ) 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 getipnodebyaddr( ) function must be used in a thread-safe environment.
RETURN VALUES
Upon successful completion, this function returns a pointer to the hostent structure that contains
the host name. The structure returned also contains the values used for src and addr_family, pos-
sibly modified as described in the NOTES subsection of this reference page.
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 address is not valid. This is not a soft error; another type of name
server request might be successful.
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-
byname(3), getnameinfo(3), if_freenameindex(3), if_indextoname(3), if_nameindex(3),
if_nametoindex(3), inet_pton(3), inet_ntop(3).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 specification.
3−72 Hewlett-Packard Company 527187-017