dnstap-read.docbook revision b66b333f59cf51ef87f973084a5023acd9317fb2
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt [<!ENTITY mdash "&#8212;">]>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt<!--
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - Copyright (C) 2015 Internet Systems Consortium, Inc. ("ISC")
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt -
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 -
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.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt-->
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt<refentry id="man.dnstap-read">
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refentryinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <date>September 13, 2015</date>
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>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </copyright>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </docinfo>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsynopsisdiv>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <cmdsynopsis>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <command>dnstap-read</command>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <arg><option>-m</option></arg>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <arg><option>-p</option></arg>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <arg><option>-y</option></arg>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <arg choice="req"><replaceable class="parameter">file</replaceable></arg>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </cmdsynopsis>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refsynopsisdiv>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <title>DESCRIPTION</title>
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>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <title>OPTIONS</title>
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
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt format. Implies <option>-p</option>.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </listitem>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </varlistentry>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </variablelist>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <title>SEE ALSO</title>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para>
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>.
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <title>AUTHOR</title>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt <para><corpauthor>Internet Systems Consortium</corpauthor>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </para>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt </refsect1>
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt</refentry><!--
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - Local variables:
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - mode: sgml
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt - End:
b66b333f59cf51ef87f973084a5023acd9317fb2Evan Hunt-->