[3bba7e2] | 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" [
|
---|
[3bba7e2] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
[8dfc5c3] | 6 |
|
---|
[cd9f166a] | 7 | <!ENTITY bind-download-http "https://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
|
---|
[d8c65d6] | 8 | <!ENTITY bind-download-ftp "ftp://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
|
---|
[60a2f00] | 9 | <!ENTITY bind-md5sum "&bind-md5;">
|
---|
[f40d447] | 10 | <!ENTITY bind-size "5.2 MB">
|
---|
[0116db66] | 11 | <!ENTITY bind-utils-buildsize "97 MB">
|
---|
| 12 | <!ENTITY bind-utils-time "0.3 SBU">
|
---|
[3bba7e2] | 13 | ]>
|
---|
| 14 |
|
---|
[c951082] | 15 | <sect1 id="bind-utils" xreflabel="BIND Utilities-&bind-version;">
|
---|
[927b60fc] | 16 | <?dbhtml filename="bind-utils.html"?>
|
---|
[50b8d8b] | 17 |
|
---|
| 18 |
|
---|
[c951082] | 19 | <title>BIND Utilities-&bind-version;</title>
|
---|
[50b8d8b] | 20 |
|
---|
[927b60fc] | 21 | <indexterm zone="bind-utils">
|
---|
| 22 | <primary sortas="a-BIND-Utilities">BIND Utilities</primary>
|
---|
| 23 | </indexterm>
|
---|
| 24 |
|
---|
| 25 | <sect2 role="package">
|
---|
| 26 | <title>Introduction to BIND Utilities</title>
|
---|
| 27 |
|
---|
[7c56ece] | 28 | <para>
|
---|
| 29 | <application>BIND Utilities</application> is not a separate
|
---|
[1065a91] | 30 | package, it is a collection of the client side programs that are included
|
---|
[50b8d8b] | 31 | with <xref linkend="bind"/>. The <application>BIND</application>
|
---|
[1065a91] | 32 | package includes the client side programs <command>nslookup</command>,
|
---|
| 33 | <command>dig</command> and <command>host</command>. If you install
|
---|
| 34 | <application>BIND</application> server, these programs will be installed
|
---|
| 35 | automatically. This section is for those users who don't need the complete
|
---|
| 36 | <application>BIND</application> server, but need these
|
---|
[927b60fc] | 37 | client side applications.</para>
|
---|
[50b8d8b] | 38 |
|
---|
[7481fd4] | 39 | &lfs120_checked;
|
---|
[40399b1] | 40 |
|
---|
[927b60fc] | 41 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 42 | <itemizedlist spacing="compact">
|
---|
| 43 | <listitem>
|
---|
[7c56ece] | 44 | <para>
|
---|
| 45 | Download (HTTP): <ulink url="&bind-download-http;"/></para>
|
---|
[927b60fc] | 46 | </listitem>
|
---|
| 47 | <listitem>
|
---|
[7c56ece] | 48 | <para>
|
---|
| 49 | Download (FTP): <ulink url="&bind-download-ftp;"/></para>
|
---|
[927b60fc] | 50 | </listitem>
|
---|
| 51 | <listitem>
|
---|
[7c56ece] | 52 | <para>
|
---|
| 53 | Download MD5 sum: &bind-md5sum;</para>
|
---|
[927b60fc] | 54 | </listitem>
|
---|
| 55 | <listitem>
|
---|
[7c56ece] | 56 | <para>
|
---|
| 57 | Download size: &bind-size;</para>
|
---|
[927b60fc] | 58 | </listitem>
|
---|
| 59 | <listitem>
|
---|
[7c56ece] | 60 | <para>
|
---|
| 61 | Estimated disk space required: &bind-utils-buildsize;</para>
|
---|
[927b60fc] | 62 | </listitem>
|
---|
| 63 | <listitem>
|
---|
[7c56ece] | 64 | <para>
|
---|
| 65 | Estimated build time: &bind-utils-time;</para>
|
---|
[2174baa] | 66 | </listitem>
|
---|
[927b60fc] | 67 | </itemizedlist>
|
---|
[50b8d8b] | 68 |
|
---|
[927b60fc] | 69 | <bridgehead renderas="sect3">BIND Utilities Dependencies</bridgehead>
|
---|
[50b8d8b] | 70 |
|
---|
[af0874b] | 71 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
| 72 | <para role="required">
|
---|
| 73 | <xref linkend="libuv"/>
|
---|
| 74 | </para>
|
---|
| 75 |
|
---|
[24f32bb] | 76 | <bridgehead renderas="sect4">Recommended</bridgehead>
|
---|
| 77 | <para role="recommended">
|
---|
[0ebcf2e] | 78 | <xref linkend="json-c"/> and
|
---|
| 79 | <xref linkend="nghttp2"/>
|
---|
[24f32bb] | 80 | </para>
|
---|
| 81 |
|
---|
[927b60fc] | 82 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
[7ba60b6e] | 83 | <para role="optional">
|
---|
[5162d792] | 84 | <xref linkend="libcap-pam"/>,
|
---|
| 85 | <xref linkend="libxml2"/>, and
|
---|
[402910e] | 86 | <xref linkend="sphinx"/>
|
---|
[7ba60b6e] | 87 | </para>
|
---|
[50b8d8b] | 88 |
|
---|
[927b60fc] | 89 | </sect2>
|
---|
[50b8d8b] | 90 |
|
---|
[927b60fc] | 91 | <sect2 role="installation">
|
---|
| 92 | <title>Installation of BIND Utilities</title>
|
---|
| 93 |
|
---|
[7c56ece] | 94 | <para>
|
---|
| 95 | Install <application>BIND Utilities</application> by
|
---|
[927b60fc] | 96 | running the following commands:</para>
|
---|
| 97 |
|
---|
[c0cf007f] | 98 | <screen><userinput>./configure --prefix=/usr &&
|
---|
[345c66e] | 99 | make -C lib/isc &&
|
---|
[a8d67ac6] | 100 | make -C lib/dns &&
|
---|
| 101 | make -C lib/ns &&
|
---|
[b8214dc6] | 102 | make -C lib/isccfg &&
|
---|
[a8d67ac6] | 103 | make -C lib/bind9 &&
|
---|
[345c66e] | 104 | make -C lib/irs &&
|
---|
[5162d792] | 105 | make -C bin/dig &&
|
---|
| 106 | make -C doc</userinput></screen>
|
---|
[50b8d8b] | 107 |
|
---|
[7c56ece] | 108 | <para>
|
---|
| 109 | This portion of the package does not come with a test suite.</para>
|
---|
[c27abcb4] | 110 |
|
---|
[7c56ece] | 111 | <para>
|
---|
| 112 | Now, as the <systemitem class="username">root</systemitem> user:</para>
|
---|
[927b60fc] | 113 |
|
---|
[a8d67ac6] | 114 | <screen role='root'><userinput>make -C lib/isc install &&
|
---|
| 115 | make -C lib/dns install &&
|
---|
| 116 | make -C lib/ns install &&
|
---|
| 117 | make -C lib/isccfg install &&
|
---|
| 118 | make -C lib/bind9 install &&
|
---|
| 119 | make -C lib/irs install &&
|
---|
| 120 | make -C bin/dig install &&
|
---|
[5162d792] | 121 | cp -v doc/man/{dig.1,host.1,nslookup.1} /usr/share/man/man1</userinput></screen>
|
---|
[50b8d8b] | 122 |
|
---|
[927b60fc] | 123 | </sect2>
|
---|
[50b8d8b] | 124 |
|
---|
[927b60fc] | 125 | <sect2 role="commands">
|
---|
| 126 | <title>Command Explanations</title>
|
---|
[50b8d8b] | 127 |
|
---|
[0ebcf2e] | 128 | <para>
|
---|
| 129 | <option>--disable-doh</option>: Use this option if you have not installed
|
---|
| 130 | <xref linkend="nghttp2" role="nodep"/> and you don't need DNS over HTTPS
|
---|
| 131 | support.
|
---|
| 132 | </para>
|
---|
| 133 |
|
---|
[7c56ece] | 134 | <para>
|
---|
| 135 | <command>make -C lib/...</command>: These commands build the
|
---|
[5162d792] | 136 | libraries that are needed for the client programs.
|
---|
| 137 | </para>
|
---|
[50b8d8b] | 138 |
|
---|
[7c56ece] | 139 | <para>
|
---|
| 140 | <command>make -C bin/dig</command>: This command builds the
|
---|
[5162d792] | 141 | client programs.
|
---|
| 142 | </para>
|
---|
| 143 |
|
---|
| 144 | <para>
|
---|
| 145 | <command>make -C doc</command>: This command builds the
|
---|
[54d58907] | 146 | manual pages if the optional Python module
|
---|
[c10acfe] | 147 | <xref linkend="sphinx"/> is installed.
|
---|
[5162d792] | 148 | </para>
|
---|
| 149 |
|
---|
| 150 | <para>
|
---|
[54d58907] | 151 | Use <command>cp -v doc/man/{dig.1,host.1,nslookup.1} /usr/share/man/man1</command>
|
---|
[5fb7e6d9] | 152 | to install the the manual pages if they have been built.
|
---|
[5162d792] | 153 | </para>
|
---|
[50b8d8b] | 154 |
|
---|
[927b60fc] | 155 | </sect2>
|
---|
[50b8d8b] | 156 |
|
---|
[927b60fc] | 157 | <sect2 role="content">
|
---|
| 158 | <title>Contents</title>
|
---|
| 159 |
|
---|
| 160 | <segmentedlist>
|
---|
| 161 | <segtitle>Installed Programs</segtitle>
|
---|
| 162 | <segtitle>Installed Libraries</segtitle>
|
---|
| 163 | <segtitle>Installed Directories</segtitle>
|
---|
[50b8d8b] | 164 |
|
---|
[927b60fc] | 165 | <seglistitem>
|
---|
| 166 | <seg>dig, host, and nslookup</seg>
|
---|
| 167 | <seg>None</seg>
|
---|
| 168 | <seg>None</seg>
|
---|
| 169 | </seglistitem>
|
---|
| 170 | </segmentedlist>
|
---|
[50b8d8b] | 171 |
|
---|
[927b60fc] | 172 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
[50b8d8b] | 173 |
|
---|
[7c56ece] | 174 | <para>
|
---|
| 175 | See the program descriptions in the <xref linkend="bind"/> section.
|
---|
| 176 | </para>
|
---|
[927b60fc] | 177 |
|
---|
| 178 | </sect2>
|
---|
[89033ca] | 179 |
|
---|
[57dda11f] | 180 | </sect1>
|
---|