man.dnstap-read.html revision 14a656f94b1fd0ababd84a772228dfa52276ba15
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington<!--
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
1fa26403d7679235a30fbf6289f68fed5872df30Mark Andrews - Copyright (C) 2000-2003 Internet Software Consortium.
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews -
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews - purpose with or without fee is hereby granted, provided that the above
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews - copyright notice and this permission notice appear in all copies.
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington -
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews - PERFORMANCE OF THIS SOFTWARE.
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews-->
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<html>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<head>
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<title>dnstap-read</title>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
af5073d03288a53b646ec3b807ac25ced64d7879Mark Andrews<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<link rel="prev" href="man.arpaname.html" title="arpaname">
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<link rel="next" href="man.genrandom.html" title="genrandom">
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews</head>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<div class="navheader">
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington<table width="100%" summary="Navigation header">
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<tr><th colspan="3" align="center"><span class="application">dnstap-read</span></th></tr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<tr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<td width="20%" align="left">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<a accesskey="p" href="man.arpaname.html">Prev</a>�</td>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<th width="60%" align="center">Manual pages</th>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<td width="20%" align="right">�<a accesskey="n" href="man.genrandom.html">Next</a>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</td>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</tr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</table>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<hr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</div>
a0624cf8d5711cca4e3907859fbc8062a7e460faMark Andrews<div class="refentry">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<a name="man.dnstap-read"></a><div class="titlepage"></div>
a0624cf8d5711cca4e3907859fbc8062a7e460faMark Andrews
a0624cf8d5711cca4e3907859fbc8062a7e460faMark Andrews
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews <div class="refnamediv">
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<h2>Name</h2>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<p>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews <span class="application">dnstap-read</span>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson &#8212; print dnstap data in human-readable form
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews </p>
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington</div>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <div class="refsynopsisdiv">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<h2>Synopsis</h2>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <div class="cmdsynopsis"><p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <code class="command">dnstap-read</code>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews [<code class="option">-m</code>]
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews [<code class="option">-p</code>]
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews [<code class="option">-y</code>]
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews {<em class="replaceable"><code>file</code></em>}
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </p></div>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </div>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews <div class="refsection">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<a name="id-1.14.28.7"></a><h2>DESCRIPTION</h2>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews <p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <span class="command"><strong>dnstap-read</strong></span>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson reads <span class="command"><strong>dnstap</strong></span> data from a specified file
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson and prints it in a human-readable format. By default,
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <span class="command"><strong>dnstap</strong></span> data is printed in a short summary
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson format, but if the <code class="option">-y</code> option is specified,
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson then a longer and more detailed YAML format is used instead.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson </p>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson </div>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <div class="refsection">
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<a name="id-1.14.28.8"></a><h2>OPTIONS</h2>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson <div class="variablelist"><dl class="variablelist">
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson<dt><span class="term">-m</span></dt>
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington<dd>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews <p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews Trace memory allocations; used for debugging memory leaks.
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </p>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews </dd>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<dt><span class="term">-p</span></dt>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<dd>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews After printing the <span class="command"><strong>dnstap</strong></span> data, print
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews the text form of the DNS message that was encapsulated in the
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <span class="command"><strong>dnstap</strong></span> frame.
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </dd>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<dt><span class="term">-y</span></dt>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<dd>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews Print <span class="command"><strong>dnstap</strong></span> data in a detailed YAML
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews format. Implies <code class="option">-p</code>.
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </dd>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</dl></div>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </div>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <div class="refsection">
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<a name="id-1.14.28.9"></a><h2>SEE ALSO</h2>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <span class="citerefentry">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <span class="refentrytitle">named</span>(8)
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews </span>,
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <span class="citerefentry">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <span class="refentrytitle">nsupdate</span>(8)
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </span>,
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </p>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews </div>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</div>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<div class="navfooter">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<hr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<table width="100%" summary="Navigation footer">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<tr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<td width="40%" align="left">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<a accesskey="p" href="man.arpaname.html">Prev</a>�</td>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<td width="40%" align="right">�<a accesskey="n" href="man.genrandom.html">Next</a>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</td>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</tr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<tr>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<td width="40%" align="left" valign="top">
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews<span class="application">arpaname</span>�</td>
a0624cf8d5711cca4e3907859fbc8062a7e460faMark Andrews<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
a0624cf8d5711cca4e3907859fbc8062a7e460faMark Andrews<td width="40%" align="right" valign="top">�<span class="application">genrandom</span>
a0624cf8d5711cca4e3907859fbc8062a7e460faMark Andrews</td>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</tr>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</table>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</div>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.0pre-alpha</p>
75216e007570b8ea36b3ac9cca096bf70c0ca6f6Mark Andrews</body>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews</html>
068a66979695c77359e7a9181bb3f831c965b21cMark Andrews