Differences between version 5 and predecessor to the previous major change of inet_pton(3).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 5 | Last edited on Thursday, August 21, 2003 12:30:33 pm | by JohnMcPherson | Revert |
Older page: | version 3 | Last edited on Monday, June 3, 2002 6:54:12 pm | by perry | Revert |
@@ -1,80 +1,42 @@
-inet_pton
-!!!inet_pton
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-SEE ALSO
-BUGS
-----
!!NAME
inet_pton - Create a network address structure
!!SYNOPSIS
-__
#include
-__ ''af''__, const char *__''src''__, void *__''dst''__);
-__
-!!DESCRIPTION
+
#include <sys/types.h>
+ #include <sys/socket.h>
+ #include <arpa/inet.h>
+ int inet_pton(int af, const char *src, void *dst);
-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''.
+!!DESCRIPTION
-__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:
+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''
.
-__AF_INET
__
+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.
-''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.
-__AF_INET6__
+Certain legacy hex and octal formats of __AF_INET__ addresses are not supported by ''inet_pton'', which rejects them.
-''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.
-__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
+inet_ntop(3)
+!!BUGS
-__AF_INET6__ does not recognize IPv4 addresses. An
-
explicit IPv6-mapped IPv4 address must be supplied in
-
''src'' instead.
+__AF_INET6__ does not recognize IPv4 addresses. An explicit IPv6-mapped IPv4 address must be supplied in ''src'' instead.
----