From: Petr Špaček <petr.spacek@nic.cz>
Date: Tue, 11 Dec 2018 17:10:54 +0000 (+0100)
Subject: bogus_log: document new function frequent()
X-Git-Tag: v3.2.0~11^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ecc8c94862819d3eac7ac311683a9f883434444a;p=thirdparty%2Fknot-resolver.git

bogus_log: document new function frequent()
---

diff --git a/modules/bogus_log/README.rst b/modules/bogus_log/README.rst
index dc42ba01a..0b93e82b4 100644
--- a/modules/bogus_log/README.rst
+++ b/modules/bogus_log/README.rst
@@ -21,5 +21,21 @@ Example of error message logged by this module:
 
 .. _DNSViz: http://dnsviz.net/
 
+List of most frequent queries which fail as DNSSEC bogus can be obtained at run-time:
+
+.. code-block:: lua
+
+      > bogus_log.frequent()
+      [1] => {
+          [type] => DNSKEY
+          [count] => 1
+          [name] => dnssec-failed.org.
+      }
+      [2] => {
+          [type] => DNSKEY
+          [count] => 13
+          [name] => rhybar.cz.
+      }
+
 Please note that in future this module might be replaced
 with some other way to log this information.