- Copyright (C) Internet Systems Consortium, Inc. ("ISC")

 -

 - This Source Code Form is subject to the terms of the Mozilla Public

 - License, v. 2.0. If a copy of the MPL was not distributed with this

 - file, you can obtain one at https://mozilla.org/MPL/2.0/.

 -

 - See the COPYRIGHT file distributed with this work for additional

 - information regarding copyright ownership.

-->

<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnstap-read">

  <info>

    <date>2015-09-13</date>

  </info>

  <refentryinfo>

    <corpname>ISC</corpname>

    <corpauthor>Internet Systems Consortium, Inc.</corpauthor>

  </refentryinfo>

  <refmeta>

    <refentrytitle><application>dnstap-read</application></refentrytitle>

    <manvolnum>1</manvolnum>

    <refmiscinfo>BIND9</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname><application>dnstap-read</application></refname>

    <refpurpose>print dnstap data in human-readable form</refpurpose>

  </refnamediv>

  <docinfo>

    <copyright>

      <year>2015</year>

      <year>2016</year>

      <year>2018</year>

      <year>2019</year>

      <year>2020</year>

      <holder>Internet Systems Consortium, Inc. ("ISC")</holder>

    </copyright>

  </docinfo>

  <refsynopsisdiv>

    <cmdsynopsis sepchar=" ">

      <command>dnstap-read</command>

      <arg choice="opt" rep="norepeat"><option>-m</option></arg>

      <arg choice="opt" rep="norepeat"><option>-p</option></arg>

      <arg choice="opt" rep="norepeat"><option>-y</option></arg>

      <arg choice="req" rep="norepeat"><replaceable class="parameter">file</replaceable></arg>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsection><info><title>DESCRIPTION</title></info>

    <para>

      <command>dnstap-read</command>

      reads <command>dnstap</command> data from a specified file

      and prints it in a human-readable format.  By default,

      <command>dnstap</command> data is printed in a short summary

      format, but if the <option>-y</option> option is specified,

      then a longer and more detailed YAML format is used instead.

    </para>

  </refsection>

  <refsection><info><title>OPTIONS</title></info>

    <variablelist>

      <varlistentry>

        <term>-m</term>

        <listitem>

          <para>

            Trace memory allocations; used for debugging memory leaks.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>-p</term>

        <listitem>

          <para>

            After printing the <command>dnstap</command> data, print

            the text form of the DNS message that was encapsulated in the

            <command>dnstap</command> frame.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>-y</term>

        <listitem>

          <para>

            Print <command>dnstap</command> data in a detailed YAML

            format.

          </para>

        </listitem>

      </varlistentry>

    </variablelist>

  </refsection>

  <refsection><info><title>SEE ALSO</title></info>

    <para>

      <citerefentry>

        <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>

      </citerefentry>,

      <citerefentry>

        <refentrytitle>rndc</refentrytitle><manvolnum>8</manvolnum>

      </citerefentry>,

      <citetitle>BIND 9 Administrator Reference Manual</citetitle>.

    </para>

  </refsection>

</refentry>