xref: /netbsd-src/external/mpl/bind/dist/bin/tools/dnstap-read.rst (revision 9689912e6b171cbda866ec33f15ae94a04e2c02d)
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.. iscman:: dnstap-read
15.. program:: dnstap-read
16.. _man_dnstap-read:
17
18dnstap-read - print dnstap data in human-readable form
19------------------------------------------------------
20
21Synopsis
22~~~~~~~~
23
24:program:`dnstap-read` [**-m**] [**-p**] [**-x**] [**-y**] {file}
25
26Description
27~~~~~~~~~~~
28
29:program:`dnstap-read` reads ``dnstap`` data from a specified file and prints
30it in a human-readable format. By default, ``dnstap`` data is printed in
31a short summary format, but if the :option:`-y` option is specified, a
32longer and more detailed YAML format is used.
33
34Options
35~~~~~~~
36
37.. option:: -m
38
39   This option indicates trace memory allocations, and is used for debugging memory leaks.
40
41.. option:: -p
42
43   This option prints the text form of the DNS
44   message that was encapsulated in the ``dnstap`` frame, after printing the ``dnstap`` data.
45
46.. option:: -t
47
48   This option prints long timestamps with millisecond precision.
49.. option:: -x
50
51   This option prints a hex dump of the wire form
52   of the DNS message that was encapsulated in the ``dnstap`` frame, after printing the ``dnstap`` data.
53
54.. option:: -y
55
56   This option prints ``dnstap`` data in a detailed YAML format.
57
58See Also
59~~~~~~~~
60
61:iscman:`named(8) <named>`, :iscman:`rndc(8) <rndc>`, BIND 9 Administrator Reference Manual.
62