-
Notifications
You must be signed in to change notification settings - Fork 5
/
dumpaxfr.1.html
136 lines (130 loc) · 5.42 KB
/
dumpaxfr.1.html
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
<!--
HTML for nsnotifyd web pages
Written by Tony Finch <[email protected]> in Cambridge.
Permission is hereby granted to use, copy, modify, and/or
distribute this software for any purpose with or without fee.
This software is provided 'as is', without warranty of any kind.
In no event shall the authors be liable for any damages arising
from the use of this software.
SPDX-License-Identifier: 0BSD OR MIT-0
-->
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
<link rel="stylesheet" href="nsnotifyd.css" type="text/css" media="all"/>
<title>nsnotifyd: scripted DNS NOTIFY handler</title>
</head>
<body>
<header>
<h1>
<a href="https://dotat.at/prog/nsnotifyd/">
<img src="https://dotat.at/graphics/dotat-32.png" alt="dotat">
<tt>nsnotifyd</tt>: scripted DNS NOTIFY handler
</a>
</h1>
</header>
<table class="head">
<tr>
<td class="head-ltitle">DUMPAXFR(1)</td>
<td class="head-vol">General Commands Manual (dns commands manual)</td>
<td class="head-rtitle">DUMPAXFR(1)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">dumpaxfr</code> — <span class="Nd">capture
a DNS zone transfer</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<table class="Nm">
<tr>
<td><code class="Nm">dumpaxfr</code></td>
<td>[<code class="Fl">-46dxV</code>] [<code class="Fl">-p</code>
<var class="Ar">port</var>] ⟨<var class="Ar">server</var>⟩
⟨<var class="Ar">zone</var>⟩
[<var class="Ar">prefix</var>]</td>
</tr>
</table>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">dumpaxfr</code> program sends a DNS AXFR zone
transfer query to <var class="Ar">server</var> for
<var class="Ar">zone</var> and saves the response in one or more files. The
files are named like</p>
<div class="Bd
Bd-indent"><var class="Ar">prefix</var><code class="Li">_</code><var class="Ar">server</var><code class="Li">_</code><var class="Ar">zone</var><code class="Li">_</code><var class="Va">N</var><code class="Li">.bin</code></div>
<p class="Pp">You specify the <var class="Ar">server</var>,
<var class="Ar">zone</var>, and <var class="Ar">prefix</var> on the command
line. The default <var class="Ar">prefix</var> is
<code class="Li">xfer</code>.</p>
<p class="Pp">A zone transfer can consist of multiple DNS messages. Each message
is written to a different file numbered <var class="Va">N</var> starting
from 0.</p>
<p class="Pp">The <code class="Li">.bin</code> suffix indicates that the file is
a binary dump.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="OPTIONS"><a class="permalink" href="#OPTIONS">OPTIONS</a></h1>
<dl class="Bl-tag">
<dt id="4"><a class="permalink" href="#4"><code class="Fl">-4</code></a></dt>
<dd>Use IPv4 only.</dd>
<dt id="6"><a class="permalink" href="#6"><code class="Fl">-6</code></a></dt>
<dd>Use IPv6 only.</dd>
<dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt>
<dd>Print query and responses in a similar manner to
<a class="Xr">dig(1)</a>.</dd>
<dt id="x"><a class="permalink" href="#x"><code class="Fl">-x</code></a></dt>
<dd>Print partially-parsed hex dump of responses.</dd>
<dt id="p"><a class="permalink" href="#p"><code class="Fl">-p</code></a>
<var class="Ar">port</var></dt>
<dd>Connect to <var class="Ar">port</var>, which may be a service name or a
port number. The default is the
<a class="permalink" href="#domain"><b class="Sy" id="domain">domain</b></a>
service, port 53.</dd>
<dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a></dt>
<dd>Print details about this version of <code class="Nm">dumpaxfr</code>.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The <code class="Nm">dumpaxfr</code> program incorrectly uses a
<code class="Fn">read</code>() timeout to detect the end of the zone
transfer; it always finishes by reporting an error. The DNS protocol
indicates the end of a zone transfer with a message whose last record is a
second copy of the zone's SOA record. The <code class="Nm">dumpaxfr</code>
program does not parse responses (except when printing decoded messages) so
it is too stupid to detect the end of the zone transfer correctly.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">dig(1)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHOR"><a class="permalink" href="#AUTHOR">AUTHOR</a></h1>
<p class="Pp"><span class="An">Tony Finch</span>
⟨<code class="Li">[email protected]</code>⟩</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">December 5, 2024</td>
<td class="foot-os">DNS</td>
</tr>
</table>
<!-- SPDX-License-Identifier: 0BSD OR MIT-0 -->
<footer>
<address>
<a href="https://dotat.at/prog/nsnotifyd/"><tt>nsnotifyd</tt></a>
was written by
<a href="https://dotat.at/">Tony Finch</a>
<<a href="mailto:[email protected]">[email protected]</a>>
</address>
</footer>
</body>
</html>