resolv_wrapper(1)
=================

NAME
----

resolv_wrapper - A wrapper for the dns resolving with our own resolv.conf.

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
implmentation in your test environment. It requires socket_wrapper to be able
to contact it.

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

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.

*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_HOSTS*::

This environment variable is used for DNS faking. It must point to a
hosts-like text file that specifies fake records for custom queries. The
format of the file is:
TYPE	RECORD_NAME RECORD_VALUE
For example:
A	www.cwrap.org	127.0.0.10

EXAMPLE
-------

  $ LD_PRELOAD=libresolv_wrapper.so RESOLV_WRAPPER_CONF="./resolv.conf" dig test.example.site