summaryrefslogtreecommitdiffstats
path: root/bin/tools/dnstap-read.rst
blob: 104c05f2e62d3067e21e37293b22f3022e231408 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.. Copyright (C) Internet Systems Consortium, Inc. ("ISC")
..
.. SPDX-License-Identifier: MPL-2.0
..
.. 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.

.. highlight: console

.. _man_dnstap-read:

dnstap-read - print dnstap data in human-readable form
------------------------------------------------------

Synopsis
~~~~~~~~

:program:`dnstap-read` [**-m**] [**-p**] [**-x**] [**-y**] {file}

Description
~~~~~~~~~~~

``dnstap-read`` reads ``dnstap`` data from a specified file and prints
it in a human-readable format. By default, ``dnstap`` data is printed in
a short summary format, but if the ``-y`` option is specified, a
longer and more detailed YAML format is used.

Options
~~~~~~~

``-m``
   This option indicates trace memory allocations, and is used for debugging memory leaks.

``-p``
   This option prints the text form of the DNS
   message that was encapsulated in the ``dnstap`` frame, after printing the ``dnstap`` data.

``-x``
   This option prints a hex dump of the wire form
   of the DNS message that was encapsulated in the ``dnstap`` frame, after printing the ``dnstap`` data.

``-y``
   This option prints ``dnstap`` data in a detailed YAML format.

See Also
~~~~~~~~

:manpage:`named(8)`, :manpage:`rndc(8)`, BIND 9 Administrator Reference Manual.