Penguin

Differences between current version and revision by previous author of inet_pton(3).

Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History

Newer page: version 5 Last edited on Thursday, August 21, 2003 12:30:33 pm by JohnMcPherson
Older page: version 4 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  
  
+!!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. 
 ---- 
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.