dnstap-read.docbook revision 14a656f94b1fd0ababd84a772228dfa52276ba15
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync<!--
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - Copyright (C) 2015 Internet Systems Consortium, Inc. ("ISC")
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync -
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - Permission to use, copy, modify, and/or distribute this software for any
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - purpose with or without fee is hereby granted, provided that the above
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - copyright notice and this permission notice appear in all copies.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync -
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync - PERFORMANCE OF THIS SOFTWARE.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync-->
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync<!-- Converted by db4-upgrade version 1.0 -->
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnstap-read">
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <info>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <date>2015-09-13</date>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </info>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refentryinfo>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <corpname>ISC</corpname>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refentryinfo>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refmeta>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refentrytitle><application>dnstap-read</application></refentrytitle>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <manvolnum>1</manvolnum>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refmiscinfo>BIND9</refmiscinfo>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refmeta>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refnamediv>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refname><application>dnstap-read</application></refname>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refpurpose>print dnstap data in human-readable form</refpurpose>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refnamediv>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <docinfo>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <copyright>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <year>2015</year>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </copyright>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </docinfo>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refsynopsisdiv>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <cmdsynopsis sepchar=" ">
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <command>dnstap-read</command>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <arg choice="opt" rep="norepeat"><option>-m</option></arg>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <arg choice="opt" rep="norepeat"><option>-p</option></arg>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <arg choice="opt" rep="norepeat"><option>-y</option></arg>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <arg choice="req" rep="norepeat"><replaceable class="parameter">file</replaceable></arg>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </cmdsynopsis>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refsynopsisdiv>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refsection><info><title>DESCRIPTION</title></info>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <command>dnstap-read</command>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync reads <command>dnstap</command> data from a specified file
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync and prints it in a human-readable format. By default,
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <command>dnstap</command> data is printed in a short summary
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync format, but if the <option>-y</option> option is specified,
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync then a longer and more detailed YAML format is used instead.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refsection>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refsection><info><title>OPTIONS</title></info>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <variablelist>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <varlistentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <term>-m</term>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <listitem>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync Trace memory allocations; used for debugging memory leaks.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </listitem>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </varlistentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <varlistentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <term>-p</term>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <listitem>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync After printing the <command>dnstap</command> data, print
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync the text form of the DNS message that was encapsulated in the
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <command>dnstap</command> frame.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </listitem>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </varlistentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <varlistentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <term>-y</term>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <listitem>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync Print <command>dnstap</command> data in a detailed YAML
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync format. Implies <option>-p</option>.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </listitem>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </varlistentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </variablelist>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refsection>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refsection><info><title>SEE ALSO</title></info>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <citerefentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </citerefentry>,
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <citerefentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <refentrytitle>nsupdate</refentrytitle><manvolnum>8</manvolnum>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </citerefentry>,
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </para>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync </refsection>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync</refentry>
f9a51917495bc8ba8b60632219652a7b122c1190vboxsync