source: server/major/bind.xml@ 3a49c0b

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 3a49c0b was da3e8de, checked in by DJ Lucas <dj@…>, 8 years ago

Add IPv6 entries to bind root.hints.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17679 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 31.8 KB
RevLine 
[0931098]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[0931098]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
[80c8e88]6
[064df5c4]7 <!ENTITY bind-download-http " ">
[50287538]8 <!ENTITY bind-download-ftp "ftp://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.gz">
[db029b6]9 <!ENTITY bind-md5sum "50163d229020c48929c84bec5b0068d7">
[31a01ed]10 <!ENTITY bind-size "8.9 MB">
[db029b6]11 <!ENTITY bind-buildsize "119 MB (additional 10 MB for the test suite)">
[31a01ed]12 <!ENTITY bind-time "1.1 SBU (additional 22+ minutes, processor independent, to run the complete test suite)">
[0931098]13]>
14
[c951082]15<sect1 id="bind" xreflabel="BIND-&bind-version;">
[53217a6]16 <?dbhtml filename="bind.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
[c951082]23 <title>BIND-&bind-version;</title>
[53217a6]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>The <application>BIND</application> package provides a DNS server
33 and client utilities. If you are only interested in the utilities, refer
34 to the <xref linkend="bind-utils"/>.</para>
35
[da3e8de]36 &lfs7a_checked;
[40399b1]37
[53217a6]38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&bind-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&bind-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &bind-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &bind-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &bind-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &bind-time;</para>
57 </listitem>
58 </itemizedlist>
59
[9288855]60 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
61 <itemizedlist spacing='compact'>
62 <listitem>
[bae16652]63 <para>Optional patch (if net-tools is not installed):
[634cf991]64 <ulink
65 url="&patch-root;/bind-&bind-version;-use_iproute2-1.patch"/></para>
[9288855]66 </listitem>
67 </itemizedlist>
68
[53217a6]69 <bridgehead renderas="sect3">BIND Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Optional</bridgehead>
[a87a374]72 <para role="optional">
[56605b9]73 <xref linkend="libcap-pam"/>,
[7ba60b6e]74 <xref linkend="libxml2"/>,
[74fe55c]75 <xref linkend="mitkrb"/>,
[2c95b08]76 <xref linkend="openssl"/>, and
77 <ulink url='https://github.com/cjheath/geoip'>geoip</ulink>
[0f6476c]78 </para>
[160e58a4]79
80 <bridgehead renderas="sect4">Optional database backends</bridgehead>
81 <para role="optional">
82 <xref linkend="db"/>,
[bf6aefc]83 <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
84 <xref linkend="openldap"/>,
85 <xref linkend="postgresql"/>, and
[160e58a4]86 <xref linkend="unixodbc"/>
[a87a374]87 </para>
[53217a6]88
[9288855]89 <bridgehead renderas="sect4">Optional (to run the test suite)</bridgehead>
[a87a374]90 <para role="optional">
[91b65df]91 <xref linkend="perl-net-dns"/> and
[a87a374]92 <xref linkend="net-tools"/> (you may omit net-tools by using the optional
93 patch to utilize iproute2, but the IPv6 tests will fail)
94 </para>
95
96 <bridgehead renderas="sect4">Optional (to rebuild the documentation)</bridgehead>
97 <para role="optional">
98 <xref linkend="doxygen"/>,
[bf6aefc]99 <xref linkend="libxslt"/>, and
100 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
[a87a374]101 </para>
[53217a6]102
[3cb0c57]103 <para condition="html" role="usernotes">User Notes:
104 <ulink url="&blfs-wiki;/bind"/></para>
105
[53217a6]106 </sect2>
107
108 <sect2 role="installation">
109 <title>Installation of BIND</title>
110
[bae16652]111 <para>If you have chosen not to install net-tools, apply the iproute2
112 patch with the following command:</para>
113
114<screen><userinput>patch -Np1 -i ../bind-&bind-version;-use_iproute2-1.patch</userinput></screen>
115
[15e49d1]116 <para>Install <application>BIND</application> by running the
117 following commands:</para>
[a3e2a06d]118
[15e49d1]119<screen><userinput>./configure --prefix=/usr \
[a87a374]120 --sysconfdir=/etc \
121 --localstatedir=/var \
[d4a47c5a]122 --mandir=/usr/share/man \
[a87a374]123 --enable-threads \
[7ba60b6e]124 --with-libtool \
[d1ce445]125 --disable-static \
126 --with-randomdev=/dev/urandom &amp;&amp;
[53217a6]127make</userinput></screen>
[a2fe8d47]128
[ade9c75]129 <para>Issue the following commands to run the complete suite of tests.
[d4a47c5a]130 First, as the <systemitem class="username">root</systemitem> user, set up
131 some test interfaces:</para>
[ade9c75]132
[a3e2a06d]133 <note><para>If IPv6 is not enabled in the kernel, there will be several
134 error messages: "RTNETLINK answers: Operation not permitted". These
135 messages do not afffect the tests.</para></note>
[bf6aefc]136
[bccbdaea]137<screen role="root"><userinput>bin/tests/system/ifconfig.sh up</userinput></screen>
[ade9c75]138
[ec898c7]139 <para>The test suite may indicate some skipped tests depending on
140 what configuration options are used. Some tests are marked <quote>UNTESTED
141 </quote> if <xref linkend="perl-net-dns"/> is not installed.
[bf6aefc]142 To run the tests, as an unprivileged user, execute:</para>
[4c288b0]143
[bf6aefc]144<screen><userinput>make -k check</userinput></screen>
[ade9c75]145
146 <para>Again as <systemitem class="username">root</systemitem>, clean up the
147 test interfaces:</para>
148
149<screen role="root"><userinput>bin/tests/system/ifconfig.sh down</userinput></screen>
150
151 <para>Finally, install the package as the <systemitem
152 class="username">root</systemitem> user:</para>
[a2fe8d47]153
[53217a6]154<screen role="root"><userinput>make install &amp;&amp;
[d4a47c5a]155
[8bcd51bd]156install -v -m755 -d /usr/share/doc/bind-&bind-version;/{arm,misc} &amp;&amp;
157install -v -m644 doc/arm/*.html \
158 /usr/share/doc/bind-&bind-version;/arm &amp;&amp;
[b873579]159install -v -m644 doc/misc/{dnssec,ipv6,migrat*,options,rfc-compliance,roadmap,sdb} \
160 /usr/share/doc/bind-&bind-version;/misc</userinput></screen>
[53217a6]161 </sect2>
162
163 <sect2 role="commands">
164 <title>Command Explanations</title>
[efe9371]165
[53217a6]166 <para><parameter>--sysconfdir=/etc</parameter>: This parameter forces
167 <application>BIND</application> to look for configuration
168 files in <filename class='directory'>/etc</filename> instead of
169 <filename class='directory'>/usr/etc</filename>.</para>
170
171 <para><parameter>--enable-threads</parameter>: This parameter enables
172 multi-threading capability.</para>
173
174 <para><parameter>--with-libtool</parameter>: This parameter forces the
175 building of dynamic libraries and links the installed binaries to these
176 libraries.</para>
[fd7e0ed6]177
[74fe55c]178 <para><parameter>--with-randomdev=/dev/urandom</parameter>: This parameter
[d1ce445]179 specifes a non-blocking random device for use with digital signatures.</para>
180
[ec898c7]181 <para><option>--enable-fetchlimit</option>: Use this option if you want
182 to be able to limit the the rate of recursive client queries. This may be
183 useful on servers which receive a large number of queries.</para>
184
[7ba60b6e]185 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
186 href="../../xincludes/static-libraries.xml"/>
187
[d4a47c5a]188 <para><command>cd doc; install ...</command>: These commands install
189 additional package documentation. Omit any or all of these commands if
190 desired.</para>
[53217a6]191 </sect2>
192
193 <sect2 role="configuration">
194 <title>Configuring BIND</title>
195
196 <sect3 id="bind-config">
197 <title>Config files</title>
198
199 <para><filename>named.conf</filename>,
200 <filename>root.hints</filename>,
201 <filename>127.0.0</filename>,
202 <filename>rndc.conf</filename> and
203 <filename>resolv.conf</filename></para>
204
205 <indexterm zone="bind bind-config">
206 <primary sortas="e-etc-named.conf">/etc/named.conf</primary>
207 </indexterm>
208
209 <indexterm zone="bind bind-config">
210 <primary sortas="e-etc-rndc.conf">/etc/rndc.conf</primary>
211 </indexterm>
212
213 <indexterm zone="bind bind-config">
214 <primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
215 </indexterm>
216
217 <indexterm zone="bind bind-config">
[634cf991]218 <primary
219 sortas="e-etc-namedb-root.hints">/etc/namedb/root.hints</primary>
[53217a6]220 </indexterm>
221
222 <indexterm zone="bind bind-config">
[634cf991]223 <primary
224 sortas="e-etc-namedb-pz-127.0.0.0">/etc/namedb/pz/127.0.0.0</primary>
[53217a6]225 </indexterm>
226 </sect3>
227
228 <sect3>
229 <title>Configuration Information</title>
230
231 <para><application>BIND</application> will be configured to run in a
232 <command>chroot</command> jail as an unprivileged user (<systemitem
233 class="username">named</systemitem>). This configuration is more secure
234 in that a DNS compromise can only affect a few files in the <systemitem
235 class="username">named</systemitem> user's <envar>HOME</envar>
236 directory.</para>
237
238 <para>Create the unprivileged user and group <systemitem
239 class="username">named</systemitem>:</para>
240
[b785ab29]241<screen role="root"><userinput>groupadd -g 20 named &amp;&amp;
[9288855]242useradd -c "BIND Owner" -g named -s /bin/false -u 20 named &amp;&amp;
[068bb16]243install -d -m770 -o named -g named /srv/named</userinput></screen>
[53217a6]244
245 <para>Set up some files, directories and devices needed by
246 <application>BIND</application>:</para>
247
[068bb16]248<screen role="root"><userinput>cd /srv/named &amp;&amp;
[634cf991]249mkdir -p dev etc/namedb/{slave,pz} usr/lib/engines var/run/named &amp;&amp;
[068bb16]250mknod /srv/named/dev/null c 1 3 &amp;&amp;
[e14ac42]251mknod /srv/named/dev/urandom c 1 9 &amp;&amp;
[d8805ba2]252chmod 666 /srv/named/dev/{null,urandom} &amp;&amp;
[634cf991]253cp /etc/localtime etc &amp;&amp;
254touch /srv/named/managed-keys.bind &amp;&amp;
255cp /usr/lib/engines/libgost.so usr/lib/engines &amp;&amp;
[60bb78f]256[ $(uname -m) = x86_64 ] &amp;&amp; ln -sv lib usr/lib64</userinput></screen>
[0931098]257
[634cf991]258 <para>The <filename>rndc.conf</filename> file contains information for
259 controlling <command>named</command> operations with the
260 <command>rndc</command> utility. Generate a key for use in the <filename>named.conf</filename> and <filename>rdnc.conf</filename> with the
[53217a6]261 <command>rndc-confgen</command> command:</para>
[b8214dc6]262
[634cf991]263<screen role="root"><userinput>rndc-confgen -r /dev/urandom -b 512 > /etc/rndc.conf &amp;&amp;
264sed '/conf/d;/^#/!d;s:^# ::' /etc/rndc.conf > /srv/named/etc/named.conf</userinput></screen>
[b8214dc6]265
[634cf991]266 <para>Complete the <filename>named.conf</filename> file from which
[53217a6]267 <command>named</command> will read the location of zone files, root
268 name servers and secure DNS keys:</para>
[0931098]269
[634cf991]270<screen role="root"><?dbfo keep-together="auto"?><userinput>cat &gt;&gt; /srv/named/etc/named.conf &lt;&lt; "EOF"
271<literal>options {
[73ded0c]272 directory "/etc/namedb";
[0931098]273 pid-file "/var/run/named.pid";
274 statistics-file "/var/run/named.stats";
[53217a6]275
[634cf991]276};
277zone "." {
278 type hint;
279 file "root.hints";
280};
281zone "0.0.127.in-addr.arpa" {
282 type master;
283 file "pz/127.0.0";
284};
[1c2cfae1]285
286// Bind 9 now logs by default through syslog (except debug).
287// These are the default logging rules.
288
289logging {
[634cf991]290 category default { default_syslog; default_debug; };
291 category unmatched { null; };
[1c2cfae1]292
293 channel default_syslog {
294 syslog daemon; // send to syslog's daemon
295 // facility
296 severity info; // only send priority info
297 // and higher
298 };
299
300 channel default_debug {
301 file "named.run"; // write to named.run in
302 // the working directory
303 // Note: stderr is used instead
304 // of "named.run"
305 // if the server is started
306 // with the '-f' option.
307 severity dynamic; // log at the server's
308 // current debug level
309 };
310
311 channel default_stderr {
312 stderr; // writes to stderr
313 severity info; // only send priority info
314 // and higher
315 };
316
317 channel null {
[634cf991]318 null; // toss anything sent to
[1c2cfae1]319 // this channel
320 };
[53217a6]321};</literal>
322EOF</userinput></screen>
[16473a92]323
[53217a6]324 <para>Create a zone file with the following contents:</para>
[0931098]325
[068bb16]326<screen role="root"><userinput>cat &gt; /srv/named/etc/namedb/pz/127.0.0 &lt;&lt; "EOF"
[53217a6]327<literal>$TTL 3D
[0931098]328@ IN SOA ns.local.domain. hostmaster.local.domain. (
329 1 ; Serial
330 8H ; Refresh
331 2H ; Retry
332 4W ; Expire
333 1D) ; Minimum TTL
334 NS ns.local.domain.
[53217a6]3351 PTR localhost.</literal>
336EOF</userinput></screen>
[0931098]337
[53217a6]338 <para>Create the <filename>root.hints</filename> file with the following
339 commands:</para>
[0931098]340
[53217a6]341 <note>
342 <para>Caution must be used to ensure there are no leading spaces in
343 this file.</para>
344 </note>
[0931098]345
[068bb16]346<screen role="root"><userinput>cat &gt; /srv/named/etc/namedb/root.hints &lt;&lt; "EOF"
[53217a6]347<literal>. 6D IN NS A.ROOT-SERVERS.NET.
[0931098]348. 6D IN NS B.ROOT-SERVERS.NET.
349. 6D IN NS C.ROOT-SERVERS.NET.
350. 6D IN NS D.ROOT-SERVERS.NET.
351. 6D IN NS E.ROOT-SERVERS.NET.
352. 6D IN NS F.ROOT-SERVERS.NET.
353. 6D IN NS G.ROOT-SERVERS.NET.
354. 6D IN NS H.ROOT-SERVERS.NET.
355. 6D IN NS I.ROOT-SERVERS.NET.
356. 6D IN NS J.ROOT-SERVERS.NET.
357. 6D IN NS K.ROOT-SERVERS.NET.
358. 6D IN NS L.ROOT-SERVERS.NET.
359. 6D IN NS M.ROOT-SERVERS.NET.
360A.ROOT-SERVERS.NET. 6D IN A 198.41.0.4
[da3e8de]361A.ROOT-SERVERS.NET. 6D IN AAAA 2001:503:ba3e::2:30
[1c2cfae1]362B.ROOT-SERVERS.NET. 6D IN A 192.228.79.201
[da3e8de]363B.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:84::b
[0931098]364C.ROOT-SERVERS.NET. 6D IN A 192.33.4.12
[da3e8de]365C.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2::c
[7ba60b6e]366D.ROOT-SERVERS.NET. 6D IN A 199.7.91.13
[da3e8de]367D.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2d::d
[0931098]368E.ROOT-SERVERS.NET. 6D IN A 192.203.230.10
[da3e8de]369E.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:a8::e
[0931098]370F.ROOT-SERVERS.NET. 6D IN A 192.5.5.241
[da3e8de]371F.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:2f::f
[0931098]372G.ROOT-SERVERS.NET. 6D IN A 192.112.36.4
[da3e8de]373H.ROOT-SERVERS.NET. 6D IN A 198.97.190.53
374H.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:1::53
[0931098]375I.ROOT-SERVERS.NET. 6D IN A 192.36.148.17
[da3e8de]376I.ROOT-SERVERS.NET. 6D IN AAAA 2001:7fe::53
[0931098]377J.ROOT-SERVERS.NET. 6D IN A 192.58.128.30
[da3e8de]378J.ROOT-SERVERS.NET. 6D IN AAAA 2001:503:c27::2:30
[0931098]379K.ROOT-SERVERS.NET. 6D IN A 193.0.14.129
[da3e8de]380K.ROOT-SERVERS.NET. 6D IN AAAA 2001:7fd::1
[9288855]381L.ROOT-SERVERS.NET. 6D IN A 199.7.83.42
[da3e8de]382L.ROOT-SERVERS.NET. 6D IN AAAA 2001:500:9f::42
383M.ROOT-SERVERS.NET. 6D IN A 202.12.27.33
384M.ROOT-SERVERS.NET. 6D IN AAAA 2001:dc3::35</literal>
[53217a6]385EOF</userinput></screen>
[f45b1953]386
[2dcd27e]387 <para>The <filename>root.hints</filename> file is a list of root name
388 servers. This file must be updated periodically with the
[53217a6]389 <command>dig</command> utility. A current copy of root.hints can be
390 obtained from <ulink url="ftp://rs.internic.net/domain/named.root" />.
[2dcd27e]391 For details, consult the "BIND 9 Administrator Reference Manual", included
392 in every source archive of BIND 9 distributed by ISC, in HTML and PDF
393 formats, also available at
394 <ulink url="ftp://ftp.isc.org/isc/bind9/cur/&bind-minor-version;/doc/arm/Bv9ARM.html">
395 BIND 9 Administrator Reference Manual</ulink>.</para>
[53217a6]396
397 <para>Create or modify <filename>resolv.conf</filename> to use the new
398 name server with the following commands:</para>
[f45b1953]399
[53217a6]400 <note>
[3cb0c57]401 <para>Replace <replaceable>&lt;yourdomain.com&gt;</replaceable> with
[53217a6]402 your own valid domain name.</para>
403 </note>
404
405<screen role="root"><userinput>cp /etc/resolv.conf /etc/resolv.conf.bak &amp;&amp;
406cat &gt; /etc/resolv.conf &lt;&lt; "EOF"
[3cb0c57]407<literal>search <replaceable>&lt;yourdomain.com&gt;</replaceable>
[53217a6]408nameserver 127.0.0.1</literal>
409EOF</userinput></screen>
410
411 <para>Set permissions on the <command>chroot</command> jail with the
412 following command:</para>
413
[634cf991]414<screen role="root"><userinput>chown -R named:named /srv/named</userinput></screen>
[53217a6]415
416 </sect3>
417
418 <sect3 id="bind-init">
[1258125]419 <title><phrase revision="sysv">Boot Script</phrase>
420 <phrase revision="systemd">Systemd Unit</phrase></title>
[53217a6]421
422 <para>To start the DNS server at boot, install the
[1258125]423 <phrase revision="sysv"><filename>/etc/rc.d/init.d/bind</filename> init
424 script</phrase>
425 <phrase revision="systemd"><filename>named.service</filename>
426 unit</phrase> included in the
427 <xref linkend="bootscripts" revision="sysv"/>
[3c7bd00]428 <xref linkend="systemd-units" revision="systemd"/> package.</para>
[53217a6]429
430 <indexterm zone="bind bind-init">
431 <primary sortas="f-bind">bind</primary>
432 </indexterm>
433
434<screen role="root"><userinput>make install-bind</userinput></screen>
435
436 <para>Now start <application>BIND</application> with
[1258125]437 the following command:</para>
[53217a6]438
[1258125]439<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/bind start</userinput></screen>
440<screen role="root" revision="systemd"><userinput>systemctl start named</userinput></screen>
[53217a6]441
442 </sect3>
443
444 <sect3>
445 <title>Testing BIND</title>
446
447 <para>Test out the new <application>BIND</application> 9 installation.
448 First query the local host address with <command>dig</command>:</para>
449
450<screen><userinput>dig -x 127.0.0.1</userinput></screen>
451
452 <para>Now try an external name lookup, taking note of the speed
453 difference in repeated lookups due to the caching. Run the
454 <command>dig</command> command twice on the same address:</para>
455
[4e88613]456<screen><userinput>dig www.&lfs-domainname; &amp;&amp;
457dig www.&lfs-domainname;</userinput></screen>
[53217a6]458
459 <para>You can see almost instantaneous results with the named caching
460 lookups. Consult the <application>BIND</application> Administrator
461 Reference Manual located at <filename>doc/arm/Bv9ARM.html</filename>
462 in the package source tree, for further configuration options.</para>
463
464 </sect3>
465
466 </sect2>
467
468 <sect2 role="content">
469 <title>Contents</title>
470
471 <segmentedlist>
472 <segtitle>Installed Programs</segtitle>
473 <segtitle>Installed Libraries</segtitle>
474 <segtitle>Installed Directories</segtitle>
475
476 <seglistitem>
[efe9371]477
[1dab11a6]478 <seg>arpaname, bind9-config hardlinked to isc-config.sh, ddns-confgen,
479 delv, dig, dnssec-checkds, dnssec-coverage, dnssec-dsfromkey,
480 dnssec-importkey, dnssec-keyfromlabel, dnssec-keygen, dnssec-revoke,
481 dnssec-settime, dnssec-signzone, dnssec-verify, genrandom, host,
482 isc-hmac-fixup, lwresd hardlinked to named, named-checkconf,
483 named-checkzone, named-compilezone (symlink), named-journalprint,
484 named-rrchecker, nsec3hash, nslookup, nsupdate, rndc, rndc-confgen,
485 and tsig-keygen (symlink)</seg>
[74fe55c]486
487 <seg>libbind9.so, libdns.so, libirs.so, libisc.so, libisccc.so,
[efe9371]488 libisccfg.so, and liblwres.so</seg>
489
[af176a5f]490 <seg>/usr/include/{bind9,dns,dst,irs,isc,isccc,isccfg,lwres,pk11,pkcs11},
491 /usr/share/doc/bind-&bind-version; and /srv/named</seg>
[53217a6]492 </seglistitem>
493 </segmentedlist>
494
495 <variablelist>
496 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
497 <?dbfo list-presentation="list"?>
498 <?dbhtml list-presentation="table"?>
499
[298fee30]500 <varlistentry id="arpaname">
501 <term><command>arpaname</command></term>
502 <listitem>
503 <para>
504 translate IP addresses to the corresponding ARPA names.
505 </para>
506 <indexterm zone="bind arpaname">
507 <primary sortas="b-arpaname">arpaname</primary>
508 </indexterm>
509 </listitem>
510 </varlistentry>
511
512 <varlistentry id="bind9-config">
513 <term><command>bind9-config</command></term>
514 <listitem>
515 <para>
516 hardlinked to <command>isc-config.sh</command>.
517 </para>
518 <indexterm zone="bind bind9-config">
519 <primary sortas="b-bind9-config">bind9-config</primary>
520 </indexterm>
521 </listitem>
522 </varlistentry>
523
524 <varlistentry id="ddns-confgen">
525 <term><command>ddns-confgen</command></term>
526 <listitem>
527 <para>
528 generates a key for use by nsupdate and named.
529 </para>
530 <indexterm zone="bind ddns-confgen">
531 <primary sortas="b-ddns-confgen">ddns-confgen</primary>
532 </indexterm>
533 </listitem>
534 </varlistentry>
535
536 <varlistentry id="delv">
537 <term><command>delv</command></term>
538 <listitem>
539 <para>
[c18b8f23]540 is a new debugging tool that is a successor to
[298fee30]541 <command>dig</command>.
542 </para>
543 <indexterm zone="bind delv">
544 <primary sortas="b-delv">delv</primary>
545 </indexterm>
546 </listitem>
547 </varlistentry>
548
[53217a6]549 <varlistentry id="dig">
550 <term><command>dig</command></term>
551 <listitem>
552 <para>interrogates DNS servers.</para>
553 <indexterm zone="bind dig">
554 <primary sortas="b-dig">dig</primary>
555 </indexterm>
556 </listitem>
557 </varlistentry>
558
[298fee30]559 <varlistentry id="dnssec-checkds">
560 <term><command>dnssec-checkds</command></term>
561 <listitem>
562 <para>
563 is a DNSSEC delegation consistency checking tool.
564 </para>
565 <indexterm zone="bind dnssec-checkds">
566 <primary sortas="b-dnssec-checkds">dnssec-checkds</primary>
567 </indexterm>
568 </listitem>
569 </varlistentry>
570
571 <varlistentry id="dnssec-coverage">
572 <term><command>dnssec-coverage</command></term>
573 <listitem>
574 <para>
[c18b8f23]575 verifies that the DNSSEC keys for a given zone or a set of zones
[298fee30]576 have timing metadata set properly to ensure no future lapses
577 in DNSSEC coverage.
578 </para>
579 <indexterm zone="bind dnssec-coverage">
580 <primary sortas="b-dnssec-coverage">dnssec-coverage</primary>
581 </indexterm>
582 </listitem>
583 </varlistentry>
[c18b8f23]584
[298fee30]585 <varlistentry id="dnssec-dsfromkey">
586 <term><command>dnssec-dsfromkey</command></term>
587 <listitem>
588 <para>
589 outputs the Delegation Signer (DS) resource record (RR).
590 </para>
591 <indexterm zone="bind dnssec-dsfromkey">
592 <primary sortas="b-dnssec-dsfromkey">dnssec-dsfromkey</primary>
593 </indexterm>
594 </listitem>
595 </varlistentry>
596
597 <varlistentry id="dnssec-importkey">
598 <term><command>dnssec-importkey</command></term>
599 <listitem>
600 <para>
[c18b8f23]601 reads a public DNSKEY record and generates a pair of
[298fee30]602 .key/.private files.
603 </para>
604 <indexterm zone="bind dnssec-importkey">
605 <primary sortas="b-dnssec-importkey">dnssec-importkey</primary>
606 </indexterm>
607 </listitem>
608 </varlistentry>
609
610 <varlistentry id="dnssec-keyfromlabel">
611 <term><command>dnssec-keyfromlabel</command></term>
612 <listitem>
613 <para>
[c18b8f23]614 gets keys with the given label from a crypto hardware and builds
[298fee30]615 key files for DNSSEC.
616 </para>
617 <indexterm zone="bind dnssec-keyfromlabel">
618 <primary sortas="b-dnssec-keyfromlabel">dnssec-keyfromlabel</primary>
619 </indexterm>
620 </listitem>
621 </varlistentry>
622
[53217a6]623 <varlistentry id="dnssec-keygen">
624 <term><command>dnssec-keygen</command></term>
625 <listitem>
626 <para>is a key generator for secure DNS.</para>
627 <indexterm zone="bind dnssec-keygen">
628 <primary sortas="b-dnssec-keygen">dnssec-keygen</primary>
629 </indexterm>
630 </listitem>
631 </varlistentry>
632
[298fee30]633 <varlistentry id="dnssec-revoke">
634 <term><command>dnssec-revoke</command></term>
635 <listitem>
636 <para>
637 Set the REVOKED bit on a DNSSEC key.
638 </para>
639 <indexterm zone="bind dnssec-revoke">
640 <primary sortas="b-dnssec-revoke">dnssec-revoke</primary>
641 </indexterm>
642 </listitem>
643 </varlistentry>
644
645 <varlistentry id="dnssec-settime">
646 <term><command>dnssec-settime</command></term>
647 <listitem>
648 <para>
649 set the key timing metadata for a DNSSEC key.
650 </para>
651 <indexterm zone="bind dnssec-settime">
652 <primary sortas="b-dnssec-settime">dnssec-settime</primary>
653 </indexterm>
654 </listitem>
655 </varlistentry>
656
[53217a6]657 <varlistentry id="dnssec-signzone">
658 <term><command>dnssec-signzone</command></term>
659 <listitem>
660 <para>generates signed versions of zone files.</para>
661 <indexterm zone="bind dnssec-signzone">
662 <primary sortas="b-dnssec-signzone">dnssec-signzone</primary>
663 </indexterm>
664 </listitem>
665 </varlistentry>
666
[298fee30]667 <varlistentry id="dnssec-verify">
668 <term><command>dnssec-verify</command></term>
669 <listitem>
670 <para>
[c18b8f23]671 verifies that a zone is fully signed for each algorithm found
672 in the DNSKEY RRset for the zone, and that the NSEC / NSEC3
[298fee30]673 chains are complete.
674 </para>
675 <indexterm zone="bind dnssec-verify">
676 <primary sortas="b-dnssec-verify">dnssec-verify</primary>
677 </indexterm>
678 </listitem>
679 </varlistentry>
680
681 <varlistentry id="genrandom">
682 <term><command>genrandom</command></term>
683 <listitem>
684 <para>
685 generate a file containing random data.
686 </para>
687 <indexterm zone="bind genrandom">
688 <primary sortas="b-genrandom">genrandom</primary>
689 </indexterm>
690 </listitem>
691 </varlistentry>
692
[53217a6]693 <varlistentry id="host">
694 <term><command>host</command></term>
695 <listitem>
696 <para>is a utility for DNS lookups.</para>
697 <indexterm zone="bind host">
698 <primary sortas="b-host">host</primary>
699 </indexterm>
700 </listitem>
701 </varlistentry>
702
[298fee30]703 <varlistentry id="isc-config.sh">
704 <term><command>isc-config.sh</command></term>
705 <listitem>
706 <para>
707 prints information related to the installed version of ISC BIND.
708 </para>
709 <indexterm zone="bind isc-config.sh">
710 <primary sortas="b-isc-config.sh">isc-config.sh</primary>
711 </indexterm>
712 </listitem>
713 </varlistentry>
714
715 <varlistentry id="isc-hmac-fixup">
716 <term><command>isc-hmac-fixup</command></term>
717 <listitem>
718 <para>
719 fixes HMAC keys generated by older versions of BIND.
720 </para>
721 <indexterm zone="bind isc-hmac-fixup">
722 <primary sortas="b-isc-hmac-fixup">isc-hmac-fixup</primary>
723 </indexterm>
724 </listitem>
725 </varlistentry>
726
[53217a6]727 <varlistentry id="lwresd">
728 <term><command>lwresd</command></term>
729 <listitem>
730 <para>is a caching-only name server for local process use.</para>
731 <indexterm zone="bind lwresd">
732 <primary sortas="b-lwresd">lwresd</primary>
733 </indexterm>
734 </listitem>
735 </varlistentry>
736
737 <varlistentry id="named">
738 <term><command>named</command></term>
739 <listitem>
740 <para>is the name server daemon.</para>
741 <indexterm zone="bind named">
742 <primary sortas="b-named">named</primary>
743 </indexterm>
744 </listitem>
745 </varlistentry>
746
747 <varlistentry id="named-checkconf">
748 <term><command>named-checkconf</command></term>
749 <listitem>
750 <para>checks the syntax of <filename>named.conf</filename>
751 files.</para>
752 <indexterm zone="bind named-checkconf">
753 <primary sortas="b-named-checkconf">named-checkconf</primary>
754 </indexterm>
755 </listitem>
756 </varlistentry>
757
758 <varlistentry id="named-checkzone">
759 <term><command>named-checkzone</command></term>
760 <listitem>
761 <para>checks zone file validity.</para>
762 <indexterm zone="bind named-checkzone">
763 <primary sortas="b-named-checkzone">named-checkzone</primary>
764 </indexterm>
765 </listitem>
766 </varlistentry>
767
[298fee30]768 <varlistentry id="named-compilezone">
769 <term><command>named-compilezone</command></term>
770 <listitem>
771 <para>
[c18b8f23]772 is similar to <command>named-checkzone</command>, but it always
[298fee30]773 dumps the zone contents to a specified file in a specified format.
774 </para>
775 <indexterm zone="bind named-compilezone">
776 <primary sortas="b-named-compilezone">named-compilezone</primary>
777 </indexterm>
778 </listitem>
779 </varlistentry>
780
781 <varlistentry id="named-journalprint">
782 <term><command>named-journalprint</command></term>
783 <listitem>
784 <para>
785 print zone journal in human-readable form.
786 </para>
787 <indexterm zone="bind named-journalprint">
788 <primary sortas="b-named-journalprint">named-journalprint</primary>
789 </indexterm>
790 </listitem>
791 </varlistentry>
792
793 <varlistentry id="named-rrchecker">
794 <term><command>named-rrchecker</command></term>
795 <listitem>
796 <para>
[c18b8f23]797 read a individual DNS resource record from standard input and
[298fee30]798 checks if it is syntactically correct.
799 </para>
800 <indexterm zone="bind named-rrchecker">
801 <primary sortas="b-named-rrchecker">named-rrchecker</primary>
802 </indexterm>
803 </listitem>
804 </varlistentry>
805
806 <varlistentry id="nsec3hash">
807 <term><command>nsec3hash</command></term>
808 <listitem>
809 <para>
810 generates an NSEC3 hash based on a set of NSEC3 parameters.
811 </para>
812 <indexterm zone="bind nsec3hash">
813 <primary sortas="b-nsec3hash">nsec3hash</primary>
814 </indexterm>
815 </listitem>
816 </varlistentry>
817
[53217a6]818 <varlistentry id="nslookup">
819 <term><command>nslookup</command></term>
820 <listitem>
821 <para>is a program used to query Internet domain nameservers.</para>
822 <indexterm zone="bind nslookup">
823 <primary sortas="b-nslookup">nslookup</primary>
824 </indexterm>
825 </listitem>
826 </varlistentry>
827
828 <varlistentry id="nsupdate">
829 <term><command>nsupdate</command></term>
830 <listitem>
831 <para>is used to submit DNS update requests.</para>
832 <indexterm zone="bind nsupdate">
833 <primary sortas="b-nsupdate">nsupdate</primary>
834 </indexterm>
835 </listitem>
836 </varlistentry>
837
838 <varlistentry id="rndc">
839 <term><command>rndc</command></term>
840 <listitem>
841 <para>controls the operation of <application>BIND</application>.</para>
842 <indexterm zone="bind rndc">
843 <primary sortas="b-rndc">rndc</primary>
844 </indexterm>
845 </listitem>
846 </varlistentry>
847
848 <varlistentry id="rndc-confgen">
849 <term><command>rndc-confgen</command></term>
850 <listitem>
851 <para>generates <filename>rndc.conf</filename> files.</para>
852 <indexterm zone="bind rndc-confgen">
853 <primary sortas="b-rndc-confgen">rndc-confgen</primary>
854 </indexterm>
855 </listitem>
856 </varlistentry>
857
[298fee30]858 <varlistentry id="tsig-keygen">
859 <term><command>tsig-keygen</command></term>
860 <listitem>
861 <para>
[c18b8f23]862 is a symlink to <command>ddns-confgen</command>.
[298fee30]863 </para>
864 <indexterm zone="bind tsig-keygen">
865 <primary sortas="b-tsig-keygen">tsig-keygen</primary>
866 </indexterm>
867 </listitem>
868 </varlistentry>
869
[53217a6]870 </variablelist>
871
872 </sect2>
873
874</sect1>
Note: See TracBrowser for help on using the repository browser.