dnstap-read.docbook revision 14a656f94b1fd0ababd84a772228dfa52276ba15
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley<!--
41f11644387cf54e4affe496c0532165ac41eb87Automatic Updater - Copyright (C) 2015 Internet Systems Consortium, Inc. ("ISC")
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews -
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - Permission to use, copy, modify, and/or distribute this software for any
ec5347e2c775f027573ce5648b910361aa926c01Automatic Updater - purpose with or without fee is hereby granted, provided that the above
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley - copyright notice and this permission notice appear in all copies.
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley -
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews-->
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley<!-- Converted by db4-upgrade version 1.0 -->
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnstap-read">
41f11644387cf54e4affe496c0532165ac41eb87Automatic Updater <info>
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence <date>2015-09-13</date>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley </info>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <refentryinfo>
76c8294c81fb48b1da6e1fc5b83322a4cedb8e58Andreas Gustafsson <corpname>ISC</corpname>
504b5167f3cec4c32d787d435f6fd9e238f7a4ddBrian Wellington <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
2ae4dd0dbd50b3159476537c60ccdc8b64364356Mark Andrews </refentryinfo>
5597be9bb88de138dfec9fa9176708443813925eTatuya JINMEI 神明達哉
96b8d611a7a8d508954955f7c4bd8233374b04f8Andreas Gustafsson <refmeta>
b2086d798b442a428d50ddc247925f114aa4112fEvan Hunt <refentrytitle><application>dnstap-read</application></refentrytitle>
d9059b0c38bd630c367d81424d72b1308cd74b04Tatuya JINMEI 神明達哉 <manvolnum>1</manvolnum>
2ae4dd0dbd50b3159476537c60ccdc8b64364356Mark Andrews <refmiscinfo>BIND9</refmiscinfo>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence </refmeta>
96b8d611a7a8d508954955f7c4bd8233374b04f8Andreas Gustafsson
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <refnamediv>
440be4c866f6935ac069db79a414304507a664c2Michael Graff <refname><application>dnstap-read</application></refname>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <refpurpose>print dnstap data in human-readable form</refpurpose>
dc570b92f6cc60def4207733c7a194fbb69a4399Michael Sawyer </refnamediv>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <docinfo>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <copyright>
08c90261660649ca7d92065f6f13a61ec5a9a86dMark Andrews <year>2015</year>
27151990b2b48f027f7f01972fe8e0dfa1df52d3Mark Andrews <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
ac77fece9a62537a9e0e5852498ebeda7b2978c3Bob Halley </copyright>
8f086b9df8f1f8f4421effc2e19f4c65289b8f38Andreas Gustafsson </docinfo>
ac77fece9a62537a9e0e5852498ebeda7b2978c3Bob Halley
ac77fece9a62537a9e0e5852498ebeda7b2978c3Bob Halley <refsynopsisdiv>
08c90261660649ca7d92065f6f13a61ec5a9a86dMark Andrews <cmdsynopsis sepchar=" ">
8907d8fa04fdaa65baf0bc6b01230b2ebde93106Mark Andrews <command>dnstap-read</command>
0586029c81ed29bec8c52a16c76422bbf1f5d221Brian Wellington <arg choice="opt" rep="norepeat"><option>-m</option></arg>
173b32c660c1e4d5141b5ca740e8fab3c593652fBob Halley <arg choice="opt" rep="norepeat"><option>-p</option></arg>
143c2d39fafc0e36e0fa291b7708b60309e5a1b6Andreas Gustafsson <arg choice="opt" rep="norepeat"><option>-y</option></arg>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <arg choice="req" rep="norepeat"><replaceable class="parameter">file</replaceable></arg>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson </cmdsynopsis>
a4b6a1622b1b6672a6e0c7186167bbe3997568c6Bob Halley </refsynopsisdiv>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson
db30f4bdcb66afb7eb1ab0c6882cc70be9a53d79Mark Andrews <refsection><info><title>DESCRIPTION</title></info>
6017f424ee3c02d7f22132c77576ea38542fa949Andreas Gustafsson
7f3441d2a8a3b0ce868909d888e636ad696e6ac9Andreas Gustafsson <para>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <command>dnstap-read</command>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson reads <command>dnstap</command> data from a specified file
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson and prints it in a human-readable format. By default,
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <command>dnstap</command> data is printed in a short summary
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson format, but if the <option>-y</option> option is specified,
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein then a longer and more detailed YAML format is used instead.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </para>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </refsection>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <refsection><info><title>OPTIONS</title></info>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <variablelist>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <varlistentry>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <term>-m</term>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <listitem>
e5f8f2659bf1cbaa5b45c09605a23dc8ba9f94d6Andreas Gustafsson <para>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley Trace memory allocations; used for debugging memory leaks.
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley </para>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley </listitem>
60c83e9d7c613a1c5ed6220465f5b524ff2f14bfAndreas Gustafsson </varlistentry>
a4b6a1622b1b6672a6e0c7186167bbe3997568c6Bob Halley
a4b6a1622b1b6672a6e0c7186167bbe3997568c6Bob Halley <varlistentry>
3f0751e5af097496e227b6fc3f669db7195d555cBob Halley <term>-p</term>
60c83e9d7c613a1c5ed6220465f5b524ff2f14bfAndreas Gustafsson <listitem>
a4b6a1622b1b6672a6e0c7186167bbe3997568c6Bob Halley <para>
a4b6a1622b1b6672a6e0c7186167bbe3997568c6Bob Halley After printing the <command>dnstap</command> data, print
a4b6a1622b1b6672a6e0c7186167bbe3997568c6Bob Halley the text form of the DNS message that was encapsulated in the
3f0751e5af097496e227b6fc3f669db7195d555cBob Halley <command>dnstap</command> frame.
60c83e9d7c613a1c5ed6220465f5b524ff2f14bfAndreas Gustafsson </para>
60771bb1b4b197744b8b8172721e11412c9b1a8eBob Halley </listitem>
60771bb1b4b197744b8b8172721e11412c9b1a8eBob Halley </varlistentry>
60771bb1b4b197744b8b8172721e11412c9b1a8eBob Halley
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <varlistentry>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley <term>-y</term>
b77cab68c65633bc534090b09fbac743b161f9b7Bob Halley <listitem>
b77cab68c65633bc534090b09fbac743b161f9b7Bob Halley <para>
b35a009df86b4aa3793e87602c95af2a503ec0eeMark Andrews Print <command>dnstap</command> data in a detailed YAML
15e74726b3797a48b13b7a6723c00af411c1b34eAndreas Gustafsson format. Implies <option>-p</option>.
15e74726b3797a48b13b7a6723c00af411c1b34eAndreas Gustafsson </para>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley </listitem>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </varlistentry>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </variablelist>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </refsection>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <refsection><info><title>SEE ALSO</title></info>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <para>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <citerefentry>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </citerefentry>,
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <citerefentry>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <refentrytitle>nsupdate</refentrytitle><manvolnum>8</manvolnum>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </citerefentry>,
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </para>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews </refsection>
d08c5dfcd4d1f69004c1382ffc00cc1848dcd1a3Mark Andrews
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein</refentry>
7e6c9a9a733f7a57ace98e4692573f42a2cad0edBob Halley