View Source: inet_pton(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

!!NAME


inet_pton - Create a network address structure
!!SYNOPSIS


 #include <sys/types.h>
 #include <sys/socket.h>
 #include <arpa/inet.h>

 int inet_pton(int af, const char *src, void *dst);

!!DESCRIPTION


This function converts the character string ''src'' into a network address structure in the ''af'' address family, then copies the network address structure to ''dst''.


inet_pton(3) extends the inet_addr(3) function to support multiple address families, inet_addr(3) is now considered to be deprecated in favor of inet_pton(3). The following address families are currently supported:

;__AF_INET__: ''src'' points to a character string containing an [IPv4] network address in the dotted-quad format, ''ddd.ddd.ddd.ddd'' ''struct in_addr'' and copied to ''dst,'' which must be ''sizeof(struct in_addr)'' bytes long.


;__AF_INET6__: ''src'' points to a character string containing an [IPv6] network address in any allowed IPv6 address format. The address is converted to a ''struct in6_addr'' and copied to ''dst,'' which must be ''sizeof(struct in6_addr)'' bytes long.


Certain legacy hex and octal formats of __AF_INET__ addresses are not supported by ''inet_pton'', which rejects them.

!!RETURN VALUE

__inet_pton__ returns a negative value and sets ''errno'' to [EAFNOSUPPORT] if ''af'' does not contain a valid address family. 0 is returned if ''src'' does not contain a character string representing a valid network address in the specified address family. A positive value is returned if the network address was successfully converted.

!!SEE ALSO


inet_ntop(3)

!!BUGS

__AF_INET6__ does not recognize IPv4 addresses. An explicit IPv6-mapped IPv4 address must be supplied in ''src'' instead.
----

7 pages link to inet_pton(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Thursday, August 21, 2003 12:30:33 pm by JohnMcPherson

Edit PageHistory Diff Info LikePages