source: server/major/bind.xml@ 4c24eb0a

10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 4c24eb0a was 4c24eb0a, checked in by Pierre Labastie <pieere@…>, 3 years ago

Remove period at the end of short descriptions.
In the process, some attributes in single quotes have been changed to double
quotes, and a few attribute lists have been written on one line instead of
several lines.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24236 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 34.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY bind-download-http " ">
8 <!ENTITY bind-download-ftp "ftp://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
9 <!ENTITY bind-md5sum "61c545db393628152e5b2c957e8bf712">
10 <!ENTITY bind-size "4.8 MB">
11 <!ENTITY bind-buildsize "129 MB (23 MB installed)">
12 <!ENTITY bind-time "0.8 SBU (with parallelism=4; add 29+ minutes, somewhat processor independent, to run the complete test suite)">
13]>
14
15<sect1 id="bind" xreflabel="BIND-&bind-version;">
16 <?dbhtml filename="bind.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>BIND-&bind-version;</title>
24
25 <indexterm zone="bind">
26 <primary sortas="a-BIND">BIND</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to BIND</title>
31
32 <para>
33 The <application>BIND</application> package provides a DNS server
34 and client utilities. If you are only interested in the utilities, refer
35 to the <xref linkend="bind-utils"/>.
36 </para>
37
38 &lfs10_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&bind-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&bind-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &bind-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &bind-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &bind-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &bind-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">BIND Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libuv"/>
79 </para>
80
81 <bridgehead renderas="sect4">Recommended</bridgehead>
82 <para role="recommended">
83 <xref linkend="json-c"/> and
84 <xref linkend="libcap-pam"/>
85 </para>
86
87 <bridgehead renderas="sect4">Optional</bridgehead>
88 <para role="optional">
89 <xref linkend="curl"/>,
90 <xref linkend="libidn2"/>,
91 <xref linkend="libxml2"/>,
92 <xref linkend="lmdb"/>,
93 <xref linkend="mitkrb"/>,
94 <ulink url="https://cmocka.org/">cmocka</ulink>,
95 <ulink url="https://github.com/cjheath/geoip">geoip</ulink>,
96 <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink>,
97 <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>, and
98 <ulink url="&w3m-url;">w3m</ulink>
99 </para>
100
101 <bridgehead renderas="sect4">Optional database backends</bridgehead>
102 <para role="optional">
103 <xref linkend="db"/>,
104 <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
105 <xref linkend="openldap"/>,
106 <xref linkend="postgresql"/>, and
107 <xref linkend="unixodbc"/>
108 </para>
109
110 <bridgehead renderas="sect4">Optional (to run the test suite)</bridgehead>
111 <para role="optional">
112 <xref linkend="perl-net-dns"/>
113 </para>
114
115 <bridgehead renderas="sect4">Optional (to rebuild the documentation)</bridgehead>
116 <para role="optional">
117 <xref linkend="doxygen"/>,
118 <xref linkend="libxslt"/>, and
119 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
120 </para>
121
122 <para condition="html" role="usernotes">User Notes:
123 <ulink url="&blfs-wiki;/bind"/></para>
124
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of BIND</title>
129
130 <para>
131 To ensure <application>BIND</application> will build dnssec-keymgr,
132 install a python module as the <systemitem
133 class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>pip3 install ply</userinput></screen>
137
138 <para>
139 Install <application>BIND</application> by running the
140 following commands:
141 </para>
142
143<screen><userinput>./configure --prefix=/usr \
144 --sysconfdir=/etc \
145 --localstatedir=/var \
146 --mandir=/usr/share/man \
147 --with-libtool \
148 --disable-static &amp;&amp;
149make</userinput></screen>
150
151 <para>
152 Issue the following commands to run the complete suite of tests.
153 First, as the <systemitem class="username">root</systemitem> user, set up
154 some test interfaces:
155 </para>
156
157 <note>
158 <para>
159 If IPv6 is not enabled in the kernel, there will be several
160 error messages: "RTNETLINK answers: Operation not permitted". These
161 messages do not affect the tests.
162 </para>
163 </note>
164
165<screen role="root"
166 remap="test"><userinput>bin/tests/system/ifconfig.sh up</userinput></screen>
167
168 <para>
169 The test suite may indicate some skipped tests depending on
170 what configuration options are used. Some tests are marked
171 <quote>UNTESTED</quote> if <xref linkend="perl-net-dns"/> is not
172 installed. One test, <quote>CPU</quote>, is known to fail.
173 To run the tests, as an unprivileged user, execute:
174 </para>
175
176<screen remap="test"><userinput>make -k check</userinput></screen>
177
178 <para>
179 Again as <systemitem class="username">root</systemitem>, clean up the
180 test interfaces:
181 </para>
182
183<screen role="root"
184 remap="test"><userinput>bin/tests/system/ifconfig.sh down</userinput></screen>
185
186 <para>
187 Finally, install the package as the <systemitem
188 class="username">root</systemitem> user:
189 </para>
190
191<screen role="root"><userinput>make install</userinput></screen>
192 </sect2>
193
194<!-- Documentation is an issue - The docs are now all in .rst format and appear
195to be sphinx based.
196-->
197
198 <sect2 role="commands">
199 <title>Command Explanations</title>
200
201 <para>
202 <parameter>--sysconfdir=/etc</parameter>: This parameter forces
203 <application>BIND</application> to look for configuration
204 files in <filename class='directory'>/etc</filename> instead of
205 <filename class='directory'>/usr/etc</filename>.
206 </para>
207
208 <para>
209 <parameter>--with-libtool</parameter>: This parameter forces the
210 building of dynamic libraries and links the installed binaries to these
211 libraries.
212 </para>
213
214 <para>
215 <option>--with-libidn2</option>: This parameter enables
216 the IDNA2008 (Internationalized Domain Names in Applications)
217 support.
218 </para>
219
220 <para>
221 <option>--enable-fetchlimit</option>: Use this option if you want
222 to be able to limit the rate of recursive client queries. This may be
223 useful on servers which receive a large number of queries.
224 </para>
225
226 <para>
227 <option>--disable-linux-caps</option>: BIND can also be built without
228 capability support by using this option, at the cost of some loss of
229 security.
230 </para>
231
232 <para>
233 <option>--with-dlz-{mysql,bdb,filesystem,ldap,odbc,stub}</option>: Use
234 one (or more) of those options to add Dynamically Loadable Zones support.
235 For more information refer to <ulink
236 url="http://bind-dlz.sourceforge.net/">bind-dlz.sourceforge.net</ulink>.
237 </para>
238
239 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
240 href="../../xincludes/static-libraries.xml"/>
241
242 </sect2>
243
244 <sect2 role="configuration">
245 <title>Configuring BIND</title>
246
247 <sect3 id="bind-config">
248 <title>Config files</title>
249
250 <para>
251 <filename>named.conf</filename>,
252 <filename>root.hints</filename>,
253 <filename>127.0.0</filename>,
254 <filename>rndc.conf</filename>, and
255 <filename>resolv.conf</filename>
256 </para>
257
258 <indexterm zone="bind bind-config">
259 <primary sortas="e-etc-named.conf">/etc/named.conf</primary>
260 </indexterm>
261
262 <indexterm zone="bind bind-config">
263 <primary sortas="e-etc-rndc.conf">/etc/rndc.conf</primary>
264 </indexterm>
265
266 <indexterm zone="bind bind-config">
267 <primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
268 </indexterm>
269
270 <indexterm zone="bind bind-config">
271 <primary
272 sortas="e-etc-namedb-root.hints">/etc/namedb/root.hints</primary>
273 </indexterm>
274
275 <indexterm zone="bind bind-config">
276 <primary
277 sortas="e-etc-namedb-pz-127.0.0.0">/etc/namedb/pz/127.0.0.0</primary>
278 </indexterm>
279 </sect3>
280
281 <sect3>
282 <title>Configuration Information</title>
283
284 <para>
285 <application>BIND</application> will be configured to run in a
286 <command>chroot</command> jail as an unprivileged user (<systemitem
287 class="username">named</systemitem>). This configuration is more secure
288 in that a DNS compromise can only affect a few files in the <systemitem
289 class="username">named</systemitem> user's <envar>HOME</envar>
290 directory.
291 </para>
292
293 <para>
294 Create the unprivileged user and group <systemitem
295 class="username">named</systemitem>:
296 </para>
297
298<screen role="root"><userinput>groupadd -g 20 named &amp;&amp;
299useradd -c "BIND Owner" -g named -s /bin/false -u 20 named &amp;&amp;
300install -d -m770 -o named -g named /srv/named</userinput></screen>
301
302 <para>
303 Set up some files, directories and devices needed by
304 <application>BIND</application>:
305 </para>
306
307<screen role="root"><userinput>mkdir -p /srv/named &amp;&amp;
308cd /srv/named &amp;&amp;
309mkdir -p dev etc/named/{slave,pz} usr/lib/engines var/run/named &amp;&amp;
310mknod /srv/named/dev/null c 1 3 &amp;&amp;
311mknod /srv/named/dev/urandom c 1 9 &amp;&amp;
312chmod 666 /srv/named/dev/{null,urandom} &amp;&amp;
313cp /etc/localtime etc</userinput></screen>
314
315 <para>
316 The <filename>rndc.conf</filename> file contains information for
317 controlling <command>named</command> operations with the
318 <command>rndc</command> utility. Generate a key for use in the
319 <filename>named.conf</filename> and <filename>rdnc.conf</filename>
320 with the <command>rndc-confgen</command> command:
321 </para>
322
323<screen role="root"><userinput>rndc-confgen -a -b 512 -t /srv/named</userinput></screen>
324
325 <para>
326 Complete the <filename>named.conf</filename> file from which
327 <command>named</command> will read the location of zone files, root
328 name servers and secure DNS keys:
329 </para>
330
331<screen role="root"><?dbfo keep-together="auto"?><userinput>cat &gt;&gt; /srv/named/etc/named.conf &lt;&lt; "EOF"
332<literal>options {
333 directory "/etc/named";
334 pid-file "/var/run/named.pid";
335 statistics-file "/var/run/named.stats";
336
337};
338zone "." {
339 type hint;
340 file "root.hints";
341};
342zone "0.0.127.in-addr.arpa" {
343 type master;
344 file "pz/127.0.0";
345};
346
347// Bind 9 now logs by default through syslog (except debug).
348// These are the default logging rules.
349
350logging {
351 category default { default_syslog; default_debug; };
352 category unmatched { null; };
353
354 channel default_syslog {
355 syslog daemon; // send to syslog's daemon
356 // facility
357 severity info; // only send priority info
358 // and higher
359 };
360
361 channel default_debug {
362 file "named.run"; // write to named.run in
363 // the working directory
364 // Note: stderr is used instead
365 // of "named.run"
366 // if the server is started
367 // with the '-f' option.
368 severity dynamic; // log at the server's
369 // current debug level
370 };
371
372 channel default_stderr {
373 stderr; // writes to stderr
374 severity info; // only send priority info
375 // and higher
376 };
377
378 channel null {
379 null; // toss anything sent to
380 // this channel
381 };
382};</literal>
383EOF</userinput></screen>
384
385 <para>
386 Create a zone file with the following contents:
387 </para>
388
389<screen role="root"><userinput>cat &gt; /srv/named/etc/named/pz/127.0.0 &lt;&lt; "EOF"
390<literal>$TTL 3D
391@ IN SOA ns.local.domain. hostmaster.local.domain. (
392 1 ; Serial
393 8H ; Refresh
394 2H ; Retry
395 4W ; Expire
396 1D) ; Minimum TTL
397 NS ns.local.domain.
3981 PTR localhost.</literal>
399EOF</userinput></screen>
400
401 <para>
402 Create the <filename>root.hints</filename> file with the following
403 commands:
404 </para>
405
406 <note>
407 <para>
408 Caution must be used to ensure there are no leading spaces in
409 this file.
410 </para>
411 </note>
412
413<screen role="root"><userinput>cat &gt; /srv/named/etc/named/root.hints &lt;&lt; "EOF"
414<literal>. 6D IN NS A.ROOT-SERVERS.NET.
415. 6D IN NS B.ROOT-SERVERS.NET.
416. 6D IN NS C.ROOT-SERVERS.NET.
417. 6D IN NS D.ROOT-SERVERS.NET.
418. 6D IN NS E.ROOT-SERVERS.NET.
419. 6D IN NS F.ROOT-SERVERS.NET.
420. 6D IN NS G.ROOT-SERVERS.NET.
421. 6D IN NS H.ROOT-SERVERS.NET.
422. 6D IN NS I.ROOT-SERVERS.NET.
423. 6D IN NS J.ROOT-SERVERS.NET.
424. 6D IN NS K.ROOT-SERVERS.NET.
425. 6D IN NS L.ROOT-SERVERS.NET.
426. 6D IN NS M.ROOT-SERVERS.NET.
427A.ROOT-SERVERS.NET. 6D IN A 198.41.0.4
428A.ROOT-SERVERS.NET. 6D IN AAAA 2001:503:ba3e::2:30
429B.ROOT-SERVERS.NET. 6D IN A 192.228.79.201
430B.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:200::b
431C.ROOT-SERVERS.NET. 6D IN A 192.33.4.12
432C.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2::c
433D.ROOT-SERVERS.NET. 6D IN A 199.7.91.13
434D.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2d::d
435E.ROOT-SERVERS.NET. 6D IN A 192.203.230.10
436E.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:a8::e
437F.ROOT-SERVERS.NET. 6D IN A 192.5.5.241
438F.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2f::f
439G.ROOT-SERVERS.NET. 6D IN A 192.112.36.4
440G.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:12::d0d
441H.ROOT-SERVERS.NET. 6D IN A 198.97.190.53
442H.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:1::53
443I.ROOT-SERVERS.NET. 6D IN A 192.36.148.17
444I.ROOT-SERVERS.NET. 6D IN AAAA 2001:7fe::53
445J.ROOT-SERVERS.NET. 6D IN A 192.58.128.30
446J.ROOT-SERVERS.NET. 6D IN AAAA 2001:503:c27::2:30
447K.ROOT-SERVERS.NET. 6D IN A 193.0.14.129
448K.ROOT-SERVERS.NET. 6D IN AAAA 2001:7fd::1
449L.ROOT-SERVERS.NET. 6D IN A 199.7.83.42
450L.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:9f::42
451M.ROOT-SERVERS.NET. 6D IN A 202.12.27.33
452M.ROOT-SERVERS.NET. 6D IN AAAA 2001:dc3::35</literal>
453EOF</userinput></screen>
454
455 <para>
456 The <filename>root.hints</filename> file is a list of root name
457 servers. This file must be updated periodically with the
458 <command>dig</command> utility. A current copy of root.hints can be
459 obtained from <ulink url="ftp://rs.internic.net/domain/named.root" />.
460 For details, consult the "BIND 9 Administrator Reference Manual",
461 included in every source archive of BIND 9 distributed by ISC, in HTML
462 and PDF formats, also available at <ulink
463 url="ftp://ftp.isc.org/isc/bind9/cur/&bind-minor-version;/doc/arm/Bv9ARM.html">
464 BIND 9 Administrator Reference Manual</ulink>.
465 </para>
466
467 <para>
468 Create or modify <filename>resolv.conf</filename> to use the new
469 name server with the following commands:
470 </para>
471
472 <note>
473 <para>
474 Replace <replaceable>&lt;yourdomain.com&gt;</replaceable> with
475 your own valid domain name.
476 </para>
477 </note>
478
479<screen role="root"><userinput>cp /etc/resolv.conf /etc/resolv.conf.bak &amp;&amp;
480cat &gt; /etc/resolv.conf &lt;&lt; "EOF"
481<literal>search <replaceable>&lt;yourdomain.com&gt;</replaceable>
482nameserver 127.0.0.1</literal>
483EOF</userinput></screen>
484
485 <para>
486 Set permissions on the <command>chroot</command> jail with the
487 following command:
488 </para>
489
490<screen role="root"><userinput>chown -R named:named /srv/named</userinput></screen>
491
492 </sect3>
493
494 <sect3 id="bind-init">
495 <title><phrase revision="sysv">Boot Script</phrase>
496 <phrase revision="systemd">Systemd Unit</phrase></title>
497
498 <para>
499 To start the DNS server at boot, install the
500 <phrase revision="sysv"><filename>/etc/rc.d/init.d/bind</filename> init
501 script</phrase>
502 <phrase revision="systemd"><filename>named.service</filename>
503 unit</phrase> included in the
504 <xref linkend="bootscripts" revision="sysv"/>
505 <xref linkend="systemd-units" revision="systemd"/> package:
506 </para>
507
508 <indexterm zone="bind bind-init">
509 <primary sortas="f-bind">bind</primary>
510 </indexterm>
511
512<screen role="root" revision="sysv"><userinput>make install-bind</userinput></screen>
513<screen role="root" revision="systemd"><userinput>make install-named</userinput></screen>
514
515 <para>
516 Now start <application>BIND</application> with the following command:
517 </para>
518
519<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/bind start</userinput></screen>
520<screen role="root" revision="systemd"><userinput>systemctl start named</userinput></screen>
521
522 </sect3>
523
524 <sect3>
525 <title>Testing BIND</title>
526
527 <para>
528 Test out the new <application>BIND</application> 9 installation.
529 First query the local host address with <command>dig</command>:
530 </para>
531
532<screen><userinput>dig -x 127.0.0.1</userinput></screen>
533
534 <para>
535 Now try an external name lookup, taking note of the speed
536 difference in repeated lookups due to the caching. Run the
537 <command>dig</command> command twice on the same address:
538 </para>
539
540<screen><userinput>dig www.&lfs-domainname; &amp;&amp;
541dig www.&lfs-domainname;</userinput></screen>
542
543 <para>
544 You can see almost instantaneous results with the named caching
545 lookups. Consult the <application>BIND</application> Administrator
546 Reference Manual located at
547 <ulink url="https://kb.isc.org/docs/bind-916-administrative-reference-manual"/>
548 for further configuration options.
549 </para>
550
551 </sect3>
552
553 </sect2>
554
555 <sect2 role="content">
556 <title>Contents</title>
557
558 <segmentedlist>
559 <segtitle>Installed Programs</segtitle>
560 <segtitle>Installed Libraries</segtitle>
561 <segtitle>Installed Directories</segtitle>
562
563 <seglistitem>
564
565 <seg>arpaname, <!--bind9-config hardlinked to isc-config.sh,-->
566 ddns-confgen, delv, dig, dnssec-cds, dnssec-checkds, dnssec-coverage,
567 dnssec-dsfromkey, dnssec-importkey, dnssec-keyfromlabel, dnssec-keygen,
568 dnssec-keymgr, dnssec-revoke, dnssec-settime, dnssec-signzone,
569 dnssec-verify, host, mdig, named, named-checkconf,
570 named-checkzone, named-compilezone (symlink), named-journalprint,
571 named-nzd2nzf, named-rrchecker, nsec3hash, nslookup, nsupdate, rndc,
572 rndc-confgen, and tsig-keygen (symlink)</seg>
573
574 <seg>libbind9.so, libdns.so, libirs.so, libisc.so, libisccc.so,
575 libisccfg.so, and libns.so</seg>
576
577 <seg>/usr/include/{bind9,dns,dst,irs,isc,isccc,isccfg,ns,pk11,pkcs11},
578 /usr/lib/named, /usr/lib/python&python3-majorver;/site-packages/isc,
579 and /srv/named</seg>
580 </seglistitem>
581 </segmentedlist>
582
583 <variablelist>
584 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
585 <?dbfo list-presentation="list"?>
586 <?dbhtml list-presentation="table"?>
587
588 <varlistentry id="arpaname">
589 <term><command>arpaname</command></term>
590 <listitem>
591 <para>
592 translates IP addresses to the corresponding ARPA names
593 </para>
594 <indexterm zone="bind arpaname">
595 <primary sortas="b-arpaname">arpaname</primary>
596 </indexterm>
597 </listitem>
598 </varlistentry>
599
600<!-- Not present as of 9.16.5
601 <varlistentry id="bind9-config">
602 <term><command>bind9-config</command></term>
603 <listitem>
604 <para>
605 is hardlinked to <command>isc-config.sh</command>.
606 </para>
607 <indexterm zone="bind bind9-config">
608 <primary sortas="b-bind9-config">bind9-config</primary>
609 </indexterm>
610 </listitem>
611 </varlistentry>
612-->
613
614 <varlistentry id="ddns-confgen">
615 <term><command>ddns-confgen</command></term>
616 <listitem>
617 <para>
618 generates a key for use by nsupdate and named
619 </para>
620 <indexterm zone="bind ddns-confgen">
621 <primary sortas="b-ddns-confgen">ddns-confgen</primary>
622 </indexterm>
623 </listitem>
624 </varlistentry>
625
626 <varlistentry id="delv">
627 <term><command>delv</command></term>
628 <listitem>
629 <para>
630 is a new debugging tool that is a successor to
631 <command>dig</command>
632 </para>
633 <indexterm zone="bind delv">
634 <primary sortas="b-delv">delv</primary>
635 </indexterm>
636 </listitem>
637 </varlistentry>
638
639 <varlistentry id="dig">
640 <term><command>dig</command></term>
641 <listitem>
642 <para>
643 interrogates DNS servers
644 </para>
645 <indexterm zone="bind dig">
646 <primary sortas="b-dig">dig</primary>
647 </indexterm>
648 </listitem>
649 </varlistentry>
650
651 <varlistentry id="dnssec-cds">
652 <term><command>dnssec-cds</command></term>
653 <listitem>
654 <para>
655 changes DS records for a child zone based on
656 CDS/CDNSKEY
657 </para>
658 <indexterm zone="bind dnssec-cds">
659 <primary sortas="b-dnssec-cds">dnssec-cds</primary>
660 </indexterm>
661 </listitem>
662 </varlistentry>
663
664 <varlistentry id="dnssec-checkds">
665 <term><command>dnssec-checkds</command></term>
666 <listitem>
667 <para>
668 is a DNSSEC delegation consistency checking tool
669 </para>
670 <indexterm zone="bind dnssec-checkds">
671 <primary sortas="b-dnssec-checkds">dnssec-checkds</primary>
672 </indexterm>
673 </listitem>
674 </varlistentry>
675
676 <varlistentry id="dnssec-coverage">
677 <term><command>dnssec-coverage</command></term>
678 <listitem>
679 <para>
680 verifies that the DNSSEC keys for a given zone or a set of zones
681 have timing metadata set properly to ensure no future lapses
682 in DNSSEC coverage
683 </para>
684 <indexterm zone="bind dnssec-coverage">
685 <primary sortas="b-dnssec-coverage">dnssec-coverage</primary>
686 </indexterm>
687 </listitem>
688 </varlistentry>
689
690 <varlistentry id="dnssec-dsfromkey">
691 <term><command>dnssec-dsfromkey</command></term>
692 <listitem>
693 <para>
694 outputs the Delegation Signer (DS) resource record (RR)
695 </para>
696 <indexterm zone="bind dnssec-dsfromkey">
697 <primary sortas="b-dnssec-dsfromkey">dnssec-dsfromkey</primary>
698 </indexterm>
699 </listitem>
700 </varlistentry>
701
702 <varlistentry id="dnssec-importkey">
703 <term><command>dnssec-importkey</command></term>
704 <listitem>
705 <para>
706 reads a public DNSKEY record and generates a pair of
707 .key/.private files
708 </para>
709 <indexterm zone="bind dnssec-importkey">
710 <primary sortas="b-dnssec-importkey">dnssec-importkey</primary>
711 </indexterm>
712 </listitem>
713 </varlistentry>
714
715 <varlistentry id="dnssec-keyfromlabel">
716 <term><command>dnssec-keyfromlabel</command></term>
717 <listitem>
718 <para>
719 gets keys with the given label from a cryptography hardware device
720 and builds key files for DNSSEC
721 </para>
722 <indexterm zone="bind dnssec-keyfromlabel">
723 <primary sortas="b-dnssec-keyfromlabel">dnssec-keyfromlabel</primary>
724 </indexterm>
725 </listitem>
726 </varlistentry>
727
728 <varlistentry id="dnssec-keygen">
729 <term><command>dnssec-keygen</command></term>
730 <listitem>
731 <para>
732 is a key generator for secure DNS
733 </para>
734 <indexterm zone="bind dnssec-keygen">
735 <primary sortas="b-dnssec-keygen">dnssec-keygen</primary>
736 </indexterm>
737 </listitem>
738 </varlistentry>
739
740 <varlistentry id="dnssec-keymgr">
741 <term><command>dnssec-keymgr</command></term>
742 <listitem>
743 <para>
744 ensures correct DNSKEY coverage based on a defined policy
745 </para>
746 <indexterm zone="bind dnssec-keymgr">
747 <primary sortas="b-dnssec-keymgr">dnssec-keymgr</primary>
748 </indexterm>
749 </listitem>
750 </varlistentry>
751
752 <varlistentry id="dnssec-revoke">
753 <term><command>dnssec-revoke</command></term>
754 <listitem>
755 <para>
756 sets the REVOKED bit on a DNSSEC key
757 </para>
758 <indexterm zone="bind dnssec-revoke">
759 <primary sortas="b-dnssec-revoke">dnssec-revoke</primary>
760 </indexterm>
761 </listitem>
762 </varlistentry>
763
764 <varlistentry id="dnssec-settime">
765 <term><command>dnssec-settime</command></term>
766 <listitem>
767 <para>
768 sets the key timing metadata for a DNSSEC key
769 </para>
770 <indexterm zone="bind dnssec-settime">
771 <primary sortas="b-dnssec-settime">dnssec-settime</primary>
772 </indexterm>
773 </listitem>
774 </varlistentry>
775
776 <varlistentry id="dnssec-signzone">
777 <term><command>dnssec-signzone</command></term>
778 <listitem>
779 <para>
780 generates signed versions of zone files
781 </para>
782 <indexterm zone="bind dnssec-signzone">
783 <primary sortas="b-dnssec-signzone">dnssec-signzone</primary>
784 </indexterm>
785 </listitem>
786 </varlistentry>
787
788 <varlistentry id="dnssec-verify">
789 <term><command>dnssec-verify</command></term>
790 <listitem>
791 <para>
792 verifies that a zone is fully signed for each algorithm found
793 in the DNSKEY RRset for the zone, and that the NSEC / NSEC3
794 chains are complete
795 </para>
796 <indexterm zone="bind dnssec-verify">
797 <primary sortas="b-dnssec-verify">dnssec-verify</primary>
798 </indexterm>
799 </listitem>
800 </varlistentry>
801
802<!-- No longer present with 9.16.5
803 <varlistentry id="genrandom">
804 <term><command>genrandom</command></term>
805 <listitem>
806 <para>
807 generates a file containing random data.
808 </para>
809 <indexterm zone="bind genrandom">
810 <primary sortas="b-genrandom">genrandom</primary>
811 </indexterm>
812 </listitem>
813 </varlistentry>
814-->
815
816 <varlistentry id="host">
817 <term><command>host</command></term>
818 <listitem>
819 <para>
820 is a utility for DNS lookups
821 </para>
822 <indexterm zone="bind host">
823 <primary sortas="b-host">host</primary>
824 </indexterm>
825 </listitem>
826 </varlistentry>
827
828 <!-- No longer present with 9.16.5
829 <varlistentry id="isc-config.sh">
830 <term><command>isc-config.sh</command></term>
831 <listitem>
832 <para>
833 prints information related to the installed version of ISC BIND.
834 </para>
835 <indexterm zone="bind isc-config.sh">
836 <primary sortas="b-isc-config.sh">isc-config.sh</primary>
837 </indexterm>
838 </listitem>
839 </varlistentry>
840
841 <varlistentry id="isc-hmac-fixup">
842 <term><command>isc-hmac-fixup</command></term>
843 <listitem>
844 <para>
845 fixes HMAC keys generated by older versions of BIND.
846 </para>
847 <indexterm zone="bind isc-hmac-fixup">
848 <primary sortas="b-isc-hmac-fixup">isc-hmac-fixup</primary>
849 </indexterm>
850 </listitem>
851 </varlistentry>
852
853 <varlistentry id="lwresd">
854 <term><command>lwresd</command></term>
855 <listitem>
856 <para>
857 is a caching-only name server for local process use.
858 </para>
859 <indexterm zone="bind lwresd">
860 <primary sortas="b-lwresd">lwresd</primary>
861 </indexterm>
862 </listitem>
863 </varlistentry>
864-->
865
866 <varlistentry id="mdig">
867 <term><command>mdig</command></term>
868 <listitem>
869 <para>
870 is a version of dig that allows multiple queries at once
871 </para>
872 <indexterm zone="bind mdig">
873 <primary sortas="b-mdig">mdig</primary>
874 </indexterm>
875 </listitem>
876 </varlistentry>
877
878 <varlistentry id="named">
879 <term><command>named</command></term>
880 <listitem>
881 <para>
882 is the name server daemon
883 </para>
884 <indexterm zone="bind named">
885 <primary sortas="b-named">named</primary>
886 </indexterm>
887 </listitem>
888 </varlistentry>
889
890 <varlistentry id="named-checkconf">
891 <term><command>named-checkconf</command></term>
892 <listitem>
893 <para>
894 checks the syntax of <filename>named.conf</filename>
895 files
896 </para>
897 <indexterm zone="bind named-checkconf">
898 <primary sortas="b-named-checkconf">named-checkconf</primary>
899 </indexterm>
900 </listitem>
901 </varlistentry>
902
903 <varlistentry id="named-checkzone">
904 <term><command>named-checkzone</command></term>
905 <listitem>
906 <para>
907 checks zone file validity
908 </para>
909 <indexterm zone="bind named-checkzone">
910 <primary sortas="b-named-checkzone">named-checkzone</primary>
911 </indexterm>
912 </listitem>
913 </varlistentry>
914
915 <varlistentry id="named-compilezone">
916 <term><command>named-compilezone</command></term>
917 <listitem>
918 <para>
919 is similar to <command>named-checkzone</command>, but it always
920 dumps the zone contents to a specified file in a specified format
921 </para>
922 <indexterm zone="bind named-compilezone">
923 <primary sortas="b-named-compilezone">named-compilezone</primary>
924 </indexterm>
925 </listitem>
926 </varlistentry>
927
928 <varlistentry id="named-journalprint">
929 <term><command>named-journalprint</command></term>
930 <listitem>
931 <para>
932 prints the zone journal in human-readable form
933 </para>
934 <indexterm zone="bind named-journalprint">
935 <primary sortas="b-named-journalprint">named-journalprint</primary>
936 </indexterm>
937 </listitem>
938 </varlistentry>
939
940 <varlistentry id="named-rrchecker">
941 <term><command>named-rrchecker</command></term>
942 <listitem>
943 <para>
944 reads an individual DNS resource record from standard input and
945 checks if it is syntactically correct
946 </para>
947 <indexterm zone="bind named-rrchecker">
948 <primary sortas="b-named-rrchecker">named-rrchecker</primary>
949 </indexterm>
950 </listitem>
951 </varlistentry>
952
953 <varlistentry id="named-nzd2nzf">
954 <term><command>named-nzd2nzf</command></term>
955 <listitem>
956 <para>
957 converts an NZD database to NZF text format
958 </para>
959 <indexterm zone="bind named-nzd2nzf">
960 <primary sortas="b-named-nzd2nzf">named-nzd2nzf</primary>
961 </indexterm>
962 </listitem>
963 </varlistentry>
964
965 <varlistentry id="nsec3hash">
966 <term><command>nsec3hash</command></term>
967 <listitem>
968 <para>
969 generates an NSEC3 hash based on a set of NSEC3 parameters
970 </para>
971 <indexterm zone="bind nsec3hash">
972 <primary sortas="b-nsec3hash">nsec3hash</primary>
973 </indexterm>
974 </listitem>
975 </varlistentry>
976
977 <varlistentry id="nslookup">
978 <term><command>nslookup</command></term>
979 <listitem>
980 <para>
981 is a program used to query Internet domain nameservers
982 </para>
983 <indexterm zone="bind nslookup">
984 <primary sortas="b-nslookup">nslookup</primary>
985 </indexterm>
986 </listitem>
987 </varlistentry>
988
989 <varlistentry id="nsupdate">
990 <term><command>nsupdate</command></term>
991 <listitem>
992 <para>
993 is used to submit DNS update requests
994 </para>
995 <indexterm zone="bind nsupdate">
996 <primary sortas="b-nsupdate">nsupdate</primary>
997 </indexterm>
998 </listitem>
999 </varlistentry>
1000
1001 <varlistentry id="rndc">
1002 <term><command>rndc</command></term>
1003 <listitem>
1004 <para>
1005 controls the operation of <application>BIND</application>
1006 </para>
1007 <indexterm zone="bind rndc">
1008 <primary sortas="b-rndc">rndc</primary>
1009 </indexterm>
1010 </listitem>
1011 </varlistentry>
1012
1013 <varlistentry id="rndc-confgen">
1014 <term><command>rndc-confgen</command></term>
1015 <listitem>
1016 <para>
1017 generates <filename>rndc.conf</filename> files
1018 </para>
1019 <indexterm zone="bind rndc-confgen">
1020 <primary sortas="b-rndc-confgen">rndc-confgen</primary>
1021 </indexterm>
1022 </listitem>
1023 </varlistentry>
1024
1025 <varlistentry id="tsig-keygen">
1026 <term><command>tsig-keygen</command></term>
1027 <listitem>
1028 <para>
1029 is a symlink to <command>ddns-confgen</command>
1030 </para>
1031 <indexterm zone="bind tsig-keygen">
1032 <primary sortas="b-tsig-keygen">tsig-keygen</primary>
1033 </indexterm>
1034 </listitem>
1035 </varlistentry>
1036
1037 </variablelist>
1038
1039 </sect2>
1040
1041</sect1>
Note: See TracBrowser for help on using the repository browser.