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

freehostent(3) OSS Library Calls Reference Manual

NAME

freehostent - Frees address information structure and storage for IPv6 socket

LIBRARY

G-series native OSS processes: /G/system/sysnn/zinetsrl

32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zinetdll |

64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yinetdll |

SYNOPSIS

#include <netdb.h>

void freehostent(

struct hostent *ptr);

PARAMETERS

ptr Speciﬁes the host entity information structure (hostent) to be freed

DESCRIPTION

The freehostent() function frees a speciﬁed host entity information structure previously created

by the getipnodebyaddr( ) or getipnodebyname( ) function. Any dynamic storage pointed to by

the structure is also freed.

NOTES

Call this function once for each structure created by calls to getipnodebyaddr( ) or getipnode-

byname( ) before closing a socket.

RETURN VALUES

Upon successful completion, this function does not return a value. The address information

structure and associated storage have been returned to the system. Otherwise, an invalid address

reference causes application failure and results in a signal.

ERRORS

This function does not set errno.

RELATED INFORMATION

Functions: freeaddrinfo(3), gai_strerror(3), getaddrinfo(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 speciﬁcation.

2−150 Hewlett-Packard Company 527187-017