From: Pieter Lexis <pieter.lexis@powerdns.com>
Date: Wed, 25 Nov 2015 17:31:28 +0000 (+0100)
Subject: Add a bunch of new options to the dnsdist manpage
X-Git-Tag: dnsdist-1.0.0-alpha1~193^2~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a8bb677f35115bdb764a31996f0564af609b2509;p=thirdparty%2Fpdns.git

Add a bunch of new options to the dnsdist manpage
---

diff --git a/docs/manpages/dnsdist.1.md b/docs/manpages/dnsdist.1.md
index 5c0e12d212..f24cd4dc5c 100644
--- a/docs/manpages/dnsdist.1.md
+++ b/docs/manpages/dnsdist.1.md
@@ -26,6 +26,9 @@ traffic.
 IPv4 and IPv6 operation can be mixed and matched, in other words, queries
 coming in over IPv6 could be forwarded to IPv4 and vice versa.
 
+**dnsdist** is scriptable in Lua, see the dnsdist documentation for more
+information on this.
+
 # SCOPE
 dnsdist does not 'think' about DNS, and does not perform any kind of
 caching, nor is it aware of the quality of the answers it is relaying.
@@ -38,25 +41,53 @@ required, dedicated hardware or software is recommended. Linux Virtual
 Server for example is often mentioned.
 
 # OPTIONS
---help
-:    Show a brief summary of the options.
+-a,--acl *NETMASK*
+:    Add *NETMASK* to the ACL.
+
+-C,--config *FILE*
+:    Load configuration from *FILE*.
+
+-c,--client
+:    Operate as a client, connect to dnsdist.
+
+-d,--daemon
+:    Operate as a daemon.
+
+-e,--execute *CMD*
+:    Connect to dnsdist and execute *CMD*.
 
---verbose
-:    Be wordy on what the program is doing
+-h,--help
+:    Display a helpful message and exit.
 
---local *ADDRESS*
-:    Bind to ADDRESS, Supply as many addresses (using multiple **--local**
+-l,--local *ADDRESS*
+:    Bind to *ADDRESS*, Supply as many addresses (using multiple **--local**
      statements) to listen on as required. Specify IPv4 as 0.0.0.0:53 and IPv6
      as [::]:53.
 
---daemon
-:    Daemonize and run in the background
+--supervised
+:    Run in foreground, but do not spawn a console. Use this switch to run
+     dnsdist inside a supervisor (use with e.g. systemd and daemontools).
+
+-p,--pidfile *FILE*
+:    Write a pidfile to *FILE*, works only with **--daemon**.
+
+-u,--uid *UID*
+:    Change the process user to *UID* after binding sockets. *UID* can be a name
+     or number.
+
+-g,--gid *GID*
+:    Change the process group to *GID* after binding sockets. *GID* Can be a
+     name or number.
+
+-V,--version
+:    Show the dnsdist version and exit.
 
-Finally, supply as many downstream addresses as required. Remote port defaults
-to 53.
+ADDRESS
+:    Any number of downstream DNS servers, in the same syntax as used with
+     **--local**. If the port is not specified, 53 is used.
 
 # BUGS
 Right now, the TCP support has some rather arbitrary limits.
 
 # RESOURCES
-Website: http://www.powerdns.com
+Website: http://dnsdist.org