dnstap-read.docbook revision 83a28ca274521e15086fc39febde507bcc4e145e
fb84f9014321c5f33c4682de5661b579fcde318fAndreas Gustafsson<!--
665a24faf6b3711e4012ac02ae5f0981c093ac1eTinderbox User - Copyright (C) 2015, 2016 Internet Systems Consortium, Inc. ("ISC")
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews -
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - This Source Code Form is subject to the terms of the Mozilla Public
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - License, v. 2.0. If a copy of the MPL was not distributed with this
fb84f9014321c5f33c4682de5661b579fcde318fAndreas Gustafsson - file, You can obtain one at http://mozilla.org/MPL/2.0/.
fb84f9014321c5f33c4682de5661b579fcde318fAndreas Gustafsson-->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews<!-- Converted by db4-upgrade version 1.0 -->
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews<refentry xmlns:db="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnstap-read">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <info>
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews <date>2015-09-13</date>
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews </info>
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews <refentryinfo>
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews <corpname>ISC</corpname>
fb84f9014321c5f33c4682de5661b579fcde318fAndreas Gustafsson <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User </refentryinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refmeta>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refentrytitle><application>dnstap-read</application></refentrytitle>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <manvolnum>1</manvolnum>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <refmiscinfo>BIND9</refmiscinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refmeta>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refname><application>dnstap-read</application></refname>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <refpurpose>print dnstap data in human-readable form</refpurpose>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refnamediv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <docinfo>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <copyright>
b46346eb3026ba4bebc093bc93cfe159131e541eTinderbox User <year>2015</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <year>2016</year>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </copyright>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User </docinfo>
b46346eb3026ba4bebc093bc93cfe159131e541eTinderbox User
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <cmdsynopsis sepchar=" ">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>dnstap-read</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg choice="opt" rep="norepeat"><option>-m</option></arg>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <arg choice="opt" rep="norepeat"><option>-p</option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg choice="opt" rep="norepeat"><option>-y</option></arg>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <arg choice="req" rep="norepeat"><replaceable class="parameter">file</replaceable></arg>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User </cmdsynopsis>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsynopsisdiv>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <refsection><info><title>DESCRIPTION</title></info>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <command>dnstap-read</command>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein reads <command>dnstap</command> data from a specified file
d71e2e0c61df16ff37c9934c371a4a60c08974f7Mark Andrews and prints it in a human-readable format. By default,
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <command>dnstap</command> data is printed in a short summary
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein format, but if the <option>-y</option> option is specified,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein then a longer and more detailed YAML format is used instead.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </refsection>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <refsection><info><title>OPTIONS</title></info>
03c0efc6892ef2ed17338b2ecbb2c5f23fbad0c9Tinderbox User
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User
d8620c7234281056fdfd2ee40cf16636b8281092Tinderbox User <variablelist>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-m</term>
b49958b502ee45022010a0b1bed3968f598895a4Automatic Updater <listitem>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Trace memory allocations; used for debugging memory leaks.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-p</term>
b3cbb2f1ad021349e89807f3492df6e4e679cd56Mark Andrews <listitem>
b3cbb2f1ad021349e89807f3492df6e4e679cd56Mark Andrews <para>
665a24faf6b3711e4012ac02ae5f0981c093ac1eTinderbox User After printing the <command>dnstap</command> data, print
b49958b502ee45022010a0b1bed3968f598895a4Automatic Updater the text form of the DNS message that was encapsulated in the
b49958b502ee45022010a0b1bed3968f598895a4Automatic Updater <command>dnstap</command> frame.
b3cbb2f1ad021349e89807f3492df6e4e679cd56Mark Andrews </para>
b3cbb2f1ad021349e89807f3492df6e4e679cd56Mark Andrews </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User
b46346eb3026ba4bebc093bc93cfe159131e541eTinderbox User <varlistentry>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <term>-y</term>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User <listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <para>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Print <command>dnstap</command> data in a detailed YAML
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein format. Implies <option>-p</option>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </para>
61e1dc26d62c2a0059e3ca7efe2ad0f4a5b8df92Mark Andrews </listitem>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </varlistentry>
3afd0ff6628df1e7e20161e4afa99469a1195a5bTinderbox User
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein </variablelist>
d8620c7234281056fdfd2ee40cf16636b8281092Tinderbox User </refsection>
d8620c7234281056fdfd2ee40cf16636b8281092Tinderbox User
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <refsection><info><title>SEE ALSO</title></info>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <para>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <citerefentry>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User </citerefentry>,
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <citerefentry>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <refentrytitle>rndc</refentrytitle><manvolnum>8</manvolnum>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User </citerefentry>,
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User </para>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User </refsection>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User</refentry>
6bcac4b58d16ee91184a72bd4ff05c41538fd932Tinderbox User