dnstap-read.docbook revision 30eec077db2bdcb6f2a0dc388a3cdde2ede75ec1
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - Copyright (C) 2015 Internet Systems Consortium, Inc. ("ISC")
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - Permission to use, copy, modify, and/or distribute this software for any
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - purpose with or without fee is hereby granted, provided that the above
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - copyright notice and this permission notice appear in all copies.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - PERFORMANCE OF THIS SOFTWARE.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<!-- Converted by db4-upgrade version 1.0 -->
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnstap-read">
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentryinfo>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refentryinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentrytitle><application>dnstap-read</application></refentrytitle>
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 <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </copyright>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsynopsisdiv>
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>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsection><info><title>DESCRIPTION</title></info>
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.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <variablelist>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt Trace memory allocations; used for debugging memory leaks.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
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 </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt Print <command>dnstap</command> data in a detailed YAML
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </variablelist>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <citerefentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </citerefentry>,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <citerefentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentrytitle>nsupdate</refentrytitle><manvolnum>8</manvolnum>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </citerefentry>,
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsection>