doc: Update the manpage for resolv.conf.

[resolv_wrapper.git] / doc / resolv_wrapper.1

diff --git a/doc/resolv_wrapper.1 b/doc/resolv_wrapper.1
index e4bd9458d306bd2f9c005059e6f77794538a2a30..911f4b46824d88620d7da115db6e7d328be98aeb 100644 (file)
--- a/doc/resolv_wrapper.1
+++ b/doc/resolv_wrapper.1
@@ -2,12 +2,12 @@
 .\"     Title: resolv_wrapper
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\"      Date: 08/28/2014
+.\"      Date: 10/12/2014
 .\"    Manual: \ \&
 .\"    Source: \ \&
 .\"  Language: English
 .\"
-.TH "RESOLV_WRAPPER" "1" "08/28/2014" "\ \&" "\ \&"
+.TH "RESOLV_WRAPPER" "1" "10/12/2014" "\ \&" "\ \&"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -28,18 +28,32 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
-resolv_wrapper \- A wrapper for the dns resolving\&.
+resolv_wrapper \- A wrapper for the dns resolving with our own resolv\&.conf\&.
 .SH "SYNOPSIS"
 .sp
-LD_PRELOAD=libresolv_wrapper\&.so RESOLV_WRAPPER_NAMESERVER="127\&.0\&.0\&.21" \fB\&./myapplication\fR
+LD_PRELOAD=libresolv_wrapper\&.so RESOLV_WRAPPER_CONF="/path/to/resolv\&.conf" \fB\&./myapplication\fR
 .SH "DESCRIPTION"
 .sp
-TODO
+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\&.
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Redirects name queries to the nameservers specified in your resolv\&.conf
+.RE
 .SH "ENVIRONMENT VARIABLES"
 .PP
-\fBRESOLV_WRAPPER_NAMESERVER\fR
+\fBRESOLV_WRAPPER_CONF\fR
 .RS 4
-Specify the nameserver to use\&.
+This is used to specify the resolv\&.conf to use\&. The format of the resolv\&.conf file is defined in the manpage
+\fIresolv\&.conf(5)\fR\&. Currently only the
+\fBnamserver\fR
+directive is supported\&.
 .RE
 .PP
 \fBRESOLV_WRAPPER_DEBUGLEVEL\fR
@@ -96,7 +110,7 @@ If you need to see what is going on in resolv_wrapper itself or try to find a bu
 .RS 4
 .\}
 .nf
-$ LD_PRELOAD=libresolv_wrapper\&.so RESOLV_WRAPPER_NAMESERVER="127\&.0\&.0\&.21" dig test\&.example\&.site
+$ LD_PRELOAD=libresolv_wrapper\&.so RESOLV_WRAPPER_CONF="\&./resolv\&.conf" dig test\&.example\&.site
 .fi
 .if n \{\
 .RE