NAME

       resolv_wrapper - A wrapper for dns name resolving or dns faking.

SYNOPSIS

       LD_PRELOAD=libresolv_wrapper.so RESOLV_WRAPPER_CONF="/path/to/resolv.conf" ./myapplication

DESCRIPTION

       resolv_wrapper makes it possible on most UNIX platforms to contact your own DNS implementation in your
       test environment. It requires socket_wrapper to be able to contact it. If it doesn’t work on a special
       platform the wrapper is able to fake DNS queries and return valid responses to your application.

       •   Redirects name queries to the nameservers specified in your resolv.conf

       •   Can fake DNS queries using a simple formatted DNS hosts file.

ENVIRONMENT VARIABLES

       RESOLV_WRAPPER_CONF
           This is used to specify the resolv.conf to use. The format of the resolv.conf file is defined in the
           manpage resolv.conf(5). Currently only the namserver directive is supported.

       In order that this works with socket_wrapper. The res_* symbols need to be in a separate libresolv
       library. If they are part of libc this wont work. This is the case with glibc >= 2.34.

       RESOLV_WRAPPER_HOSTS
           This environment variable is used for faking DNS queries. It must point to a hosts-like text file
           that specifies fake records for custom queries. The format of the file looks like this:

               TYPE    RECORD_NAME RECORD_VALUE

       For example:

           A       dc.cwrap.org 127.0.0.10
           AAAA    dc.cwrap.org fd00::5357:5f0a
           CNAME   kerberos.cwrap.org dc.cwrap.org
           SRV     _kerberos._tcp.cwrap.org kerberos.cwrap.org 88
           URI     _vpn.cwrap.org https://vpn.cwrap.org/VPN
           TXT     cwrap.org v=spf1 mx

       RESOLV_WRAPPER_DEBUGLEVEL
           If you need to see what is going on in resolv_wrapper itself or try to find a bug, you can enable
           logging support in resolv_wrapper if you built it with debug symbols.

           •   0 = ERROR

           •   1 = WARNING

           •   2 = DEBUG

           •   3 = TRACE

       RESOLV_WRAPPER_DISABLE_DEEPBIND
           This allows you to disable deep binding in resolv_wrapper. This is useful for running valgrind tools
           or sanitizers like (address, undefined, thread).

EXAMPLE

       The following command would trick kinit(1) into using DNS servers from "./resolv.conf" for Kerberos
       service resolution:

           $ LD_PRELOAD=libresolv_wrapper.so RESOLV_WRAPPER_CONF="./resolv.conf" kinit user@EXAMPLE.COM

AUTHOR

       The Samba Team

                                                   2024-09-25                                  RESOLV_WRAPPER(1)