From: bert hubert <bert.hubert@netherlabs.nl>
Date: Tue, 31 Mar 2015 14:21:10 +0000 (+0200)
Subject: document webserver
X-Git-Tag: dnsdist-1.0.0-alpha1~248^2~88^2~23
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b5735af68b1adb037c3c24fc8bd2827222ef9c3f;p=thirdparty%2Fpdns.git

document webserver
---

diff --git a/pdns/README-dnsdist.md b/pdns/README-dnsdist.md
index d001eefbfa..76e5e4432d 100644
--- a/pdns/README-dnsdist.md
+++ b/pdns/README-dnsdist.md
@@ -124,6 +124,16 @@ To change the QPS for a server:
 > getServer(0):setQPS(1000)
 ```
 
+Webserver
+---------
+To visually interact with dnsdist, try adding:
+```
+webserver("127.0.0.1:8083", "supersecret")
+```
+
+to the configuration, and point your browser at http://127.0.0.1:8083 and
+log in with any username, and that password. Enjoy!
+
 Server pools
 ------------
 Now for some cool stuff. Let's say we know we're getting a whole bunch of
@@ -398,6 +408,7 @@ Here are all functions:
  * Practical
    * `shutdown()`: shut down dnsdist
    * quit or ^D: exit the console
+   * `webserver(address, password)`: launch a webserver with stats on that address with that password
  * ACL related:
    * `addACL(netmask)`: add to the ACL set who can use this server
    * `setACL({netmask, netmask})`: replace the ACL set with these netmasks. Use `setACL({})` to reset the list, meaning no one can use us