From: Daniel Salzman <daniel.salzman@nic.cz>
Date: Fri, 14 Aug 2020 08:05:25 +0000 (+0200)
Subject: kxdpgun: add example how to generate queries file
X-Git-Tag: v3.0.0~41
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b4f9053d75d41d4cc0ad19829a94cf7d174986cc;p=thirdparty%2Fknot-dns.git

kxdpgun: add example how to generate queries file
---

diff --git a/doc/man/kxdpgun.8in b/doc/man/kxdpgun.8in
index 1de837b1dd..99d15c6727 100644
--- a/doc/man/kxdpgun.8in
+++ b/doc/man/kxdpgun.8in
@@ -105,7 +105,7 @@ Exit status of 0 means successful operation. Any other exit status indicates
 an error.
 .SH EXAMPLES
 .sp
-Queries file:
+Manually created queries file:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -122,6 +122,18 @@ abcd.example.com. DS D
 .UNINDENT
 .UNINDENT
 .sp
+Queries file generated from a zone file (Knot DNS format):
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+cat ZONE_FILE | awk "{print \e$1,\e$3}" | grep \-E "(NS|DS|A|AAAA|PTR|MX|SOA)$" | sort \-u \-R > queries.txt
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
 Program usage:
 .INDENT 0.0
 .INDENT 3.5
diff --git a/doc/man_kxdpgun.rst b/doc/man_kxdpgun.rst
index 5b5c91171a..cb0ad761ff 100644
--- a/doc/man_kxdpgun.rst
+++ b/doc/man_kxdpgun.rst
@@ -89,7 +89,7 @@ an error.
 Examples
 --------
 
-Queries file::
+Manually created queries file::
 
   abc6.example.com. AAAA
   nxdomain.example.com. A
@@ -98,6 +98,10 @@ Queries file::
   ab.example.com. A D
   abcd.example.com. DS D
 
+Queries file generated from a zone file (Knot DNS format)::
+
+  cat ZONE_FILE | awk "{print \$1,\$3}" | grep -E "(NS|DS|A|AAAA|PTR|MX|SOA)$" | sort -u -R > queries.txt
+
 Program usage::
 
   # kxdpgun -i ~/queries.txt 2001:1489:fffe:10::16