Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
scan_ip6(3)		    Library Functions Manual		     scan_ip6(3)

NAME
     scan_ip6 - parse an IPv6 number in ASCII representation

SYNTAX
     #include <libowfat/ip6.h>

     int scan_ip6(const char *src,char ip[16]);

DESCRIPTION
     scan_ip6 parses an IPv6 number in RFC1884 ASCII representation from src and
     writes  the result into ip. It returns the number of bytes read from src or
     0 if the parsing failed.

     scan_ip6 accepts upper and lower case hex letters, it understands "::" com-
     pression and partial IPv4 addresses as in "::FFFF:129.144.52.38".

     To allow transparent usage of IPv4 in IPv6 applications, scan_ip6 also  un-
     derstands	IPv4  addresses  in  dotted-decimal  notation and will return an
     IPv4-mapped  IPv6	 address   (i.e.   "127.0.0.1"	 will	be   parsed   as
     "::FFFF:127.0.0.1".

     Unlike  many  other  IP parsing routines, scan_ip6 does not recognize octal
     (like 0177.0.0.1) or hexadecimal numbers  (like  0x7f000001)  in  the  IPv4
     part.

EXAMPLE
     #include <libowfat/str.h>
     #include <libowfat/ip6.h>

       char buf[]="::1";
       char ip[16];
       if (scan_ip6(buf,ip) != str_len(buf))
	 parse_error();

SEE ALSO
     scan_ip6if(3), fmt_ip6(3), scan_ip4(3), inet_pton(3)

								     scan_ip6(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libowfat_scan_ip6&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help