Merge pull request #5 from pieterlexis/dnspcap2calidns2

dnspcap2calidns: Add manpage and packaging
rgacogne · May 3, 2018 · b2ee183 · b2ee183
2 parents 52ebf44 + 22f4ca2
commit b2ee183
Show file tree

Hide file tree

Showing 5 changed files with 32 additions and 0 deletions.
diff --git a/build-scripts/build-auth-rpm b/build-scripts/build-auth-rpm
@@ -451,6 +451,7 @@ fi
 %files tools
 %{_bindir}/calidns
 %{_bindir}/dnsgram
+%{_bindir}/dnspcap2calidns
 %{_bindir}/dnsreplay
 %{_bindir}/dnsscan
 %{_bindir}/dnsscope
@@ -465,6 +466,7 @@ fi
 %{_bindir}/sdig
 %{_mandir}/man1/calidns.1.gz
 %{_mandir}/man1/dnsgram.1.gz
+%{_mandir}/man1/dnspcap2calidns.1.gz
 %{_mandir}/man1/dnsreplay.1.gz
 %{_mandir}/man1/dnsscan.1.gz
 %{_mandir}/man1/dnsscope.1.gz
@@ -774,6 +776,7 @@ exit 0
 %{_bindir}/calidns
 %{_bindir}/dnsbulktest
 %{_bindir}/dnsgram
+%{_bindir}/dnspcap2calidns
 %{_bindir}/dnspcap2protobuf
 %{_bindir}/dnsreplay
 %{_bindir}/dnsscan
@@ -791,6 +794,7 @@ exit 0
 %{_mandir}/man1/calidns.1.gz
 %{_mandir}/man1/dnsbulktest.1.gz
 %{_mandir}/man1/dnsgram.1.gz
+%{_mandir}/man1/dnspcap2calidns.1.gz
 %{_mandir}/man1/dnspcap2protobuf.1.gz
 %{_mandir}/man1/dnsreplay.1.gz
 %{_mandir}/man1/dnsscan.1.gz
@@ -1055,6 +1059,7 @@ exit 0
 %{_bindir}/calidns
 %{_bindir}/dnsbulktest
 %{_bindir}/dnsgram
+%{_bindir}/dnspcap2calidns
 %{_bindir}/dnsreplay
 %{_bindir}/dnsscan
 %{_bindir}/dnsscope
@@ -1071,6 +1076,7 @@ exit 0
 %{_mandir}/man1/calidns.1.gz
 %{_mandir}/man1/dnsbulktest.1.gz
 %{_mandir}/man1/dnsgram.1.gz
+%{_mandir}/man1/dnspcap2calidns.1.gz
 %{_mandir}/man1/dnsreplay.1.gz
 %{_mandir}/man1/dnsscan.1.gz
 %{_mandir}/man1/dnsscope.1.gz

diff --git a/build-scripts/debian-authoritative/pdns-tools.install b/build-scripts/debian-authoritative/pdns-tools.install
@@ -1,6 +1,7 @@
 usr/bin/calidns
 usr/bin/dnsbulktest
 usr/bin/dnsgram
+usr/bin/dnspcap2calidns
 usr/bin/dnspcap2protobuf
 usr/bin/dnsreplay
 usr/bin/dnsscan

diff --git a/build-scripts/debian-authoritative/pdns-tools.manpages b/build-scripts/debian-authoritative/pdns-tools.manpages
@@ -1,6 +1,7 @@
 debian/tmp/usr/share/man/man1/calidns.1
 debian/tmp/usr/share/man/man1/dnsbulktest.1
 debian/tmp/usr/share/man/man1/dnsgram.1
+debian/tmp/usr/share/man/man1/dnspcap2calidns.1
 debian/tmp/usr/share/man/man1/dnspcap2protobuf.1
 debian/tmp/usr/share/man/man1/dnsreplay.1
 debian/tmp/usr/share/man/man1/dnsscan.1

diff --git a/docs/conf.py b/docs/conf.py
@@ -170,6 +170,7 @@
     'calidns': 'A DNS recursor testing tool',
     'dnsbulktest': 'A debugging tool for intermittent resolver failures',
     'dnsgram': 'A debugging tool for intermittent resolver failures',
+    'dnspcap2calidns': 'A tool to convert PCAPs of DNS traffic to calidns input',
     'dnspcap2protobuf': 'A tool to convert PCAPs of DNS traffic to PowerDNS Protobuf',
     'dnsreplay': 'A PowerDNS nameserver debugging tool',
     'dnsscan': 'List the amount of queries per qtype in a pcap',

diff --git a/docs/manpages/dnspcap2calidns.1.rst b/docs/manpages/dnspcap2calidns.1.rst
@@ -0,0 +1,23 @@
+dnspcap2calidns
+================
+
+Synopsis
+--------
+
+:program:`dnspcap2calidns` *PCAPFILE* *OUTFILE*
+
+Description
+-----------
+
+:program:`dnspcap2calidns` reads the PCAP file *PCAPFILE* for DNS queries and
+writes these to *OUTFILE* in the format understood by :program:`calidns`
+
+Options
+-------
+
+--help           Show a summary of options.
+--version        Display the version of dnspcap2calidns
+
+See also
+--------
+:manpage:`calidns(1)`