]> granicus.if.org Git - pdns/commitdiff
Add a bunch of new options to the dnsdist manpage
authorPieter Lexis <pieter.lexis@powerdns.com>
Wed, 25 Nov 2015 17:31:28 +0000 (18:31 +0100)
committerPieter Lexis <pieter.lexis@powerdns.com>
Thu, 26 Nov 2015 08:55:54 +0000 (09:55 +0100)
docs/manpages/dnsdist.1.md

index 5c0e12d2125991562308c136cce4ab69624af4cd..f24cd4dc5cee09ba5d068eaa8d17101b055dd61c 100644 (file)
@@ -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