xref: /netbsd-src/external/mpl/bind/dist/bin/tools/dnstap-read.rst (revision dd75ac5b443e967e26b4d18cc8cd5eb98512bfbf)
1.. Copyright (C) Internet Systems Consortium, Inc. ("ISC")
2..
3.. SPDX-License-Identifier: MPL-2.0
4..
5.. This Source Code Form is subject to the terms of the Mozilla Public
6.. License, v. 2.0.  If a copy of the MPL was not distributed with this
7.. file, you can obtain one at https://mozilla.org/MPL/2.0/.
8..
9.. See the COPYRIGHT file distributed with this work for additional
10.. information regarding copyright ownership.
11
12.. highlight: console
13
14.. _man_dnstap-read:
15
16dnstap-read - print dnstap data in human-readable form
17------------------------------------------------------
18
19Synopsis
20~~~~~~~~
21
22:program:`dnstap-read` [**-m**] [**-p**] [**-x**] [**-y**] {file}
23
24Description
25~~~~~~~~~~~
26
27``dnstap-read`` reads ``dnstap`` data from a specified file and prints
28it in a human-readable format. By default, ``dnstap`` data is printed in
29a short summary format, but if the ``-y`` option is specified, a
30longer and more detailed YAML format is used.
31
32Options
33~~~~~~~
34
35``-m``
36   This option indicates trace memory allocations, and is used for debugging memory leaks.
37
38``-p``
39   This option prints the text form of the DNS
40   message that was encapsulated in the ``dnstap`` frame, after printing the ``dnstap`` data.
41
42``-x``
43   This option prints a hex dump of the wire form
44   of the DNS message that was encapsulated in the ``dnstap`` frame, after printing the ``dnstap`` data.
45
46``-y``
47   This option prints ``dnstap`` data in a detailed YAML format.
48
49See Also
50~~~~~~~~
51
52:manpage:`named(8)`, :manpage:`rndc(8)`, BIND 9 Administrator Reference Manual.
53