source: networking/netutils/bind-utils.xml

trunk
Last change on this file was 60a2f00, checked in by Bruce Dubbs <bdubbs@…>, 6 days ago

Use an entity for md5sums that are used more than once

  • Property mode set to 100644
File size: 5.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 "https://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
8 <!ENTITY bind-download-ftp "ftp://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
9 <!ENTITY bind-md5sum "&bind-md5;">
10 <!ENTITY bind-size "5.0 MB">
11 <!ENTITY bind-utils-buildsize "102 MB">
12 <!ENTITY bind-utils-time "0.2 SBU">
13]>
14
15<sect1 id="bind-utils" xreflabel="BIND Utilities-&bind-version;">
16 <?dbhtml filename="bind-utils.html"?>
17
18
19 <title>BIND Utilities-&bind-version;</title>
20
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
28 <para>
29 <application>BIND Utilities</application> is not a separate
30 package, it is a collection of the client side programs that are included
31 with <xref linkend="bind"/>. The <application>BIND</application>
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
37 client side applications.</para>
38
39 &lfs112_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&bind-download-http;"/></para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&bind-download-ftp;"/></para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &bind-md5sum;</para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &bind-size;</para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated disk space required: &bind-utils-buildsize;</para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &bind-utils-time;</para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">BIND Utilities Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required">
73 <xref linkend="libuv"/>
74 </para>
75
76 <bridgehead renderas="sect4">Recommended</bridgehead>
77 <para role="recommended">
78 <xref linkend="json-c"/> and
79 <xref linkend="nghttp2"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <xref linkend="libcap-pam"/>,
85 <xref linkend="libxml2"/>, and
86 <xref linkend="sphinx"/>
87 </para>
88
89 <para condition="html" role="usernotes">User Notes:
90 <ulink url="&blfs-wiki;/bind-utils"/></para>
91
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of BIND Utilities</title>
96
97 <para>
98 Install <application>BIND Utilities</application> by
99 running the following commands:</para>
100
101<screen><userinput>./configure --prefix=/usr &amp;&amp;
102make -C lib/isc &amp;&amp;
103make -C lib/dns &amp;&amp;
104make -C lib/ns &amp;&amp;
105make -C lib/isccfg &amp;&amp;
106make -C lib/bind9 &amp;&amp;
107make -C lib/irs &amp;&amp;
108make -C bin/dig &amp;&amp;
109make -C doc</userinput></screen>
110
111 <para>
112 This portion of the package does not come with a test suite.</para>
113
114 <para>
115 Now, as the <systemitem class="username">root</systemitem> user:</para>
116
117<screen role='root'><userinput>make -C lib/isc install &amp;&amp;
118make -C lib/dns install &amp;&amp;
119make -C lib/ns install &amp;&amp;
120make -C lib/isccfg install &amp;&amp;
121make -C lib/bind9 install &amp;&amp;
122make -C lib/irs install &amp;&amp;
123make -C bin/dig install &amp;&amp;
124cp -v doc/man/{dig.1,host.1,nslookup.1} /usr/share/man/man1</userinput></screen>
125
126 </sect2>
127
128 <sect2 role="commands">
129 <title>Command Explanations</title>
130
131 <para>
132 <option>--disable-doh</option>: Use this option if you have not installed
133 <xref linkend="nghttp2" role="nodep"/> and you don't need DNS over HTTPS
134 support.
135 </para>
136
137 <para>
138 <command>make -C lib/...</command>: These commands build the
139 libraries that are needed for the client programs.
140 </para>
141
142 <para>
143 <command>make -C bin/dig</command>: This command builds the
144 client programs.
145 </para>
146
147 <para>
148 <command>make -C doc</command>: This command builds the
149 manual pages if the optional Python module
150 <xref linkend="sphinx"/> is installed.
151 </para>
152
153 <para>
154 Use <command>cp -v doc/man/{dig.1,host.1,nslookup.1} /usr/share/man/man1</command>
155 to install the the manual pages if they have been built.
156 </para>
157
158 </sect2>
159
160 <sect2 role="content">
161 <title>Contents</title>
162
163 <segmentedlist>
164 <segtitle>Installed Programs</segtitle>
165 <segtitle>Installed Libraries</segtitle>
166 <segtitle>Installed Directories</segtitle>
167
168 <seglistitem>
169 <seg>dig, host, and nslookup</seg>
170 <seg>None</seg>
171 <seg>None</seg>
172 </seglistitem>
173 </segmentedlist>
174
175 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
176
177 <para>
178 See the program descriptions in the <xref linkend="bind"/> section.
179 </para>
180
181 </sect2>
182
183</sect1>
Note: See TracBrowser for help on using the repository browser.