b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt<!--
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - Copyright (C) 2015, 2016 Internet Systems Consortium, Inc. ("ISC")
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt -
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - This Source Code Form is subject to the terms of the Mozilla Public
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - License, v. 2.0. If a copy of the MPL was not distributed with this
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews - file, You can obtain one at http://mozilla.org/MPL/2.0/.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt-->
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<!-- Converted by db4-upgrade version 1.0 -->
83a28ca274521e15086fc39febde507bcc4e145eMark Andrews<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnstap-read">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <info>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <date>2015-09-13</date>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </info>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentryinfo>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <corpname>ISC</corpname>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refentryinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refmeta>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentrytitle><application>dnstap-read</application></refentrytitle>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <manvolnum>1</manvolnum>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refmiscinfo>BIND9</refmiscinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refmeta>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refnamediv>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refname><application>dnstap-read</application></refname>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refpurpose>print dnstap data in human-readable form</refpurpose>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refnamediv>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <docinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <copyright>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <year>2015</year>
0c27b3fe77ac1d5094ba3521e8142d9e7973133fMark Andrews <year>2016</year>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </copyright>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </docinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsynopsisdiv>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <cmdsynopsis sepchar=" ">
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <command>dnstap-read</command>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg choice="opt" rep="norepeat"><option>-m</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg choice="opt" rep="norepeat"><option>-p</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg choice="opt" rep="norepeat"><option>-y</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg choice="req" rep="norepeat"><replaceable class="parameter">file</replaceable></arg>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </cmdsynopsis>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refsynopsisdiv>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsection><info><title>DESCRIPTION</title></info>
30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1Mark Andrews
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <command>dnstap-read</command>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt reads <command>dnstap</command> data from a specified file
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt and prints it in a human-readable format. By default,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <command>dnstap</command> data is printed in a short summary
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt format, but if the <option>-y</option> option is specified,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt then a longer and more detailed YAML format is used instead.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsection><info><title>OPTIONS</title></info>
30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1Mark Andrews
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <variablelist>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <term>-m</term>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt Trace memory allocations; used for debugging memory leaks.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <term>-p</term>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt After printing the <command>dnstap</command> data, print
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt the text form of the DNS message that was encapsulated in the
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <command>dnstap</command> frame.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <term>-y</term>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt Print <command>dnstap</command> data in a detailed YAML
b1866070ef4fb9e17bff16ad458f629bbc5a4accwpk format.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </variablelist>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsection><info><title>SEE ALSO</title></info>
30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1Mark Andrews
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <citerefentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </citerefentry>,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <citerefentry>
19977879caf8579a5fafb0cf3bf1cb983063796cEvan Hunt <refentrytitle>rndc</refentrytitle><manvolnum>8</manvolnum>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </citerefentry>,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt</refentry>