xref: /freebsd/contrib/unbound/doc/README.DNS64 (revision 0b3105a37d7adcadcb720112fed4dc4e8040be99)
1The DNS64 code was written by Viagenie, 2009, by Simon Perrault as part
2of the Ecdysis project.  The code is copyright by them, and has the BSD
3license (see the dns64/dns64.c file).
4
5To enable DNS64 functionality in Unbound, two directives in unbound.conf must
6be edited:
7
81. The "module-config" directive must start with "dns64". For example:
9
10    module-config: "dns64 validator iterator"
11
12If you're not using DNSSEC then you may remove "validator".
13
142. The "dns64-prefix" directive indicates your DNS64 prefix. For example:
15
16    dns64-prefix: 64:FF9B::/96
17
18The prefix must be a /96 or shorter.
19
20To test that things are working right, perform a query against Unbound for a
21domain name for which no AAAA record exists. You should see a AAAA record in
22the answer section. The corresponding IPv6 address will be inside the DNS64
23prefix. For example:
24
25    $ unbound -c unbound.conf
26    $ dig @localhost jazz-v4.viagenie.ca aaaa
27    [...]
28    ;; ANSWER SECTION:
29    jazz-v4.viagenie.ca.        86400   IN      AAAA    64:ff9b::ce7b:1f02
30
31