-
Notifications
You must be signed in to change notification settings - Fork 5
/
nsnotify.1.html
174 lines (168 loc) · 6.8 KB
/
nsnotify.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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<!--
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">NSNOTIFY(1)</td>
<td class="head-vol">General Commands Manual (dns commands manual)</td>
<td class="head-rtitle">NSNOTIFY(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">nsnotify</code> — <span class="Nd">send
DNS NOTIFY messages</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">nsnotify</code></td>
<td>[<code class="Fl">-46dtV</code>] [<code class="Fl">-s</code>
<var class="Ar">addr</var>] [<code class="Fl">-p</code>
<var class="Ar">port</var>] ⟨<var class="Ar">zone</var>⟩
⟨<var class="Ar">target</var>⟩...</td>
</tr>
</table>
<br/>
<table class="Nm">
<tr>
<td><code class="Nm">nsnotify</code></td>
<td>[<code class="Fl">-46dtV</code>] [<code class="Fl">-s</code>
<var class="Ar">addr</var>] [<code class="Fl">-p</code>
<var class="Ar">port</var>] <code class="Fl">-F</code>
<var class="Ar">zones</var>
⟨<var class="Ar">target</var>⟩...</td>
</tr>
</table>
<br/>
<table class="Nm">
<tr>
<td><code class="Nm">nsnotify</code></td>
<td>[<code class="Fl">-46dtV</code>] [<code class="Fl">-s</code>
<var class="Ar">addr</var>] [<code class="Fl">-p</code>
<var class="Ar">port</var>] <code class="Fl">-f</code>
<var class="Ar">targets</var>
⟨<var class="Ar">zones</var>⟩...</td>
</tr>
</table>
<br/>
<table class="Nm">
<tr>
<td><code class="Nm">nsnotify</code></td>
<td>[<code class="Fl">-46dtV</code>] [<code class="Fl">-s</code>
<var class="Ar">addr</var>] [<code class="Fl">-p</code>
<var class="Ar">port</var>] <code class="Fl">-F</code>
<var class="Ar">zones</var> <code class="Fl">-f</code>
<var class="Ar">targets</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">nsnotify</code> program sends DNS NOTIFY
messages for a list of <var class="Ar">zone</var>s to a list of
<var class="Ar">target</var>s. You can either provide a list of
<var class="Ar">target</var>s on the command line, or use the
<code class="Fl">-f</code> <var class="Ar">targets</var> option to read from
a file. To send a notifications about more than one zone, you can use the
<code class="Fl">-F</code> <var class="Ar">zones</var> option to read from a
file.</p>
<p class="Pp">Note: <code class="Nm">nsnotify</code> (without
‘<code class="Li">d</code>’) is a client for sending DNS
NOTIFY messages whereas <code class="Nm">nsnotifyd</code> (with
‘<code class="Li">d</code>’) is a daemon for handling DNS
NOTIFY messages.</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 (apart from the system resolver).</dd>
<dt id="6"><a class="permalink" href="#6"><code class="Fl">-6</code></a></dt>
<dd>Use IPv6 only (apart from the system resolver).</dd>
<dt id="d"><a class="permalink" href="#d"><code class="Fl">-d</code></a></dt>
<dd>Debugging mode.
<p class="Pp">Use once to print successful message sends.</p>
<p class="Pp">Use twice to get dumps of DNS packets.</p>
</dd>
<dt id="F"><a class="permalink" href="#F"><code class="Fl">-F</code></a>
<var class="Ar">zones</var></dt>
<dd>File containing list of zones to send NOTIFY messages about. There must be
one domain name per line, with no comments or extra white space.</dd>
<dt id="f"><a class="permalink" href="#f"><code class="Fl">-f</code></a>
<var class="Ar">targets</var></dt>
<dd>File containing list of addresses to send NOTIFY messages to. There must
be one target address per line, with no comments or extra white space.
<p class="Pp">If <var class="Ar">targets</var> is
‘<code class="Li">-</code>’ then the addresses are read
from <code class="Li">stdin</code>.</p>
</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="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a>
<var class="Ar">addr</var></dt>
<dd>Send NOTIFY messages from a specific source IP address.</dd>
<dt id="t"><a class="permalink" href="#t"><code class="Fl">-t</code></a></dt>
<dd>Make TCP connections instead of using UDP.</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">nsnotify</code>.</dd>
</dl>
</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">nsnotifyd(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>