You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
27 lines
1.1 KiB
Groff
27 lines
1.1 KiB
Groff
.TH dns_ip6_qualify 3
|
|
.SH NAME
|
|
dns_ip6_qualify \- qualify name and look up IPv6 addresses
|
|
.SH SYNTAX
|
|
.B #include <dns.h>
|
|
|
|
int \fBdns_ip6_qualify\fP(stralloc* \fIout\fR,stralloc* \fIfqdn\fR,
|
|
const stralloc* \fIudn\fR);
|
|
.SH DESCRIPTION
|
|
dns_ip6_qualify feeds the name \fIudn\fR through qualification and looks up
|
|
16-byte IPv6 addresses for the result. It puts the fully qualified domain name
|
|
into \fIfqdn\fR, puts the concatenation of the IP addresses into \fIout\fR, and
|
|
returns 0. If the domain does not exist in DNS, or has no IP addresses,
|
|
\fIout\fR 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 appropriately. It may or may
|
|
not change \fIout\fR and \fIfqdn\fR.
|
|
.SH QUALIFICATION
|
|
See http://cr.yp.to/djbdns/qualification.html
|
|
.SH "SEE ALSO"
|
|
dns_ip6(3), dns_ip6_packet(3), dns_ip4_qualify(3)
|