kxdpgun: add example how to generate queries file

diff --git a/doc/man/kxdpgun.8in b/doc/man/kxdpgun.8in
index 1de837b1dd1ed9eae5d143a0cb619c77c748453f..99d15c67279be3b10cde2656f9a8793658a7dc4b 100644 (file)
--- 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 5b5c91171a84cfa56d8115e790c2211661eae2fd..cb0ad761ff8b3c836064febba4249ed3529ca2a2 100644 (file)
--- 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