debian man page for dns_ip6_qualify

dns_ip6_qualify(3)					     Library Functions Manual						dns_ip6_qualify(3)

NAME
       dns_ip6_qualify - qualify name and look up IPv6 addresses

SYNTAX
       #include <dns.h>

       int dns_ip6_qualify(stralloc* out,stralloc* fqdn,
			   const stralloc* udn);

DESCRIPTION
       dns_ip6_qualify	feeds  the  name udn through qualification and looks up 16-byte IPv6 addresses for the result. It puts the fully qualified
       domain name into fqdn, puts the concatenation of the IP addresses into out, and returns 0. If the domain does not exist in DNS, or  has	no
       IP addresses, out will be empty.

       dns_ip6_qualify	also  looks  up  4-byte  IPv4 addresses and converts them into IPv4-mapped IPv6 addresses (::ffff:1.2.3.4) to provide easy
       backwards compatibility for IPv6 applications.

       If dns_ip6_qualify has trouble with the qualification, has trouble with DNS, or runs out of memory, it returns -1, setting errno  appropri-
       ately. It may or may not change out and fqdn.

QUALIFICATION
       See http://cr.yp.to/djbdns/qualification.html

SEE ALSO
       dns_ip6(3), dns_ip6_packet(3), dns_ip4_qualify(3)

																dns_ip6_qualify(3)