3 :author: The Samba Team
9 resolv_wrapper - A wrapper for dns name resolving or dns faking.
14 LD_PRELOAD=libresolv_wrapper.so RESOLV_WRAPPER_CONF="/path/to/resolv.conf" *./myapplication*
19 resolv_wrapper makes it possible on most UNIX platforms to contact your own DNS
20 implementation in your test environment. It requires socket_wrapper to be able
22 If it doesn't work on a special platform the wrapper is able to fake DNS queries
23 and return valid responses to your application.
25 - Redirects name queries to the nameservers specified in your resolv.conf
26 - Can fake DNS queries using a simple formatted DNS hosts file.
31 *RESOLV_WRAPPER_CONF*::
33 This is used to specify the resolv.conf to use. The format of the resolv.conf
34 file is defined in the manpage 'resolv.conf(5)'. Currently only the *namserver*
35 directive is supported.
37 *RESOLV_WRAPPER_HOSTS*::
39 This environment variable is used for faking DNS queries. It must point to a
40 hosts-like text file that specifies fake records for custom queries. The
41 format of the file looks like this:
43 TYPE RECORD_NAME RECORD_VALUE
47 A dc.cwrap.org 127.0.0.10
48 AAAA dc.cwrap.org fd00::5357:5f0a
49 CNAME kerberos.cwrap.org dc.cwrap.org
50 SRV _kerberos._tcp.cwrap.org kerberos.cwrap.org 88
51 URI _vpn.cwrap.org https://vpn.cwrap.org/VPN
52 TXT cwrap.org v=spf1 mx
54 *RESOLV_WRAPPER_DEBUGLEVEL*::
56 If you need to see what is going on in resolv_wrapper itself or try to find a
57 bug, you can enable logging support in resolv_wrapper if you built it with
65 *RESOLV_WRAPPER_DISABLE_DEEPBIND*::
67 This allows you to disable deep binding in resolv_wrapper. This is useful for
68 running valgrind tools or sanitizers like (address, undefined, thread).
73 The following command would trick 'kinit(1)' into using DNS servers from "./resolv.conf"
74 for Kerberos service resolution:
76 $ LD_PRELOAD=libresolv_wrapper.so RESOLV_WRAPPER_CONF="./resolv.conf" kinit user@EXAMPLE.COM