source: networking/netutils/bind-utils.xml@ 378990d3

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY bind-download-http   "https://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
  <!ENTITY bind-download-ftp    " ">
  <!ENTITY bind-md5sum          "&bind-md5;">
  <!ENTITY bind-size            "5.5 MB">
  <!ENTITY bind-utils-buildsize "117 MB">
  <!ENTITY bind-utils-time      "0.5 SBU (using parallelism=4)">
]>

<sect1 id="bind-utils" xreflabel="BIND Utilities-&bind-version;">
  <?dbhtml filename="bind-utils.html"?>


  <title>BIND Utilities-&bind-version;</title>

  <indexterm zone="bind-utils">
    <primary sortas="a-BIND-Utilities">BIND Utilities</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to BIND Utilities</title>

    <para>
      <application>BIND Utilities</application> is not a separate
      package, it is a collection of the client side programs that are included
      with <xref linkend="bind"/>. The <application>BIND</application>
      package includes the client side programs <command>nslookup</command>,
      <command>dig</command> and <command>host</command>. If you install
      <application>BIND</application> server, these programs will be installed
      automatically. This section is for those users who don't need the complete
      <application>BIND</application> server, but need these
      client side applications.
    </para>

    &lfs122_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&bind-download-http;"/></para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&bind-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &bind-md5sum;</para>
      </listitem>
      <listitem>
        <para>
          Download size: &bind-size;</para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &bind-utils-buildsize;</para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &bind-utils-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">BIND Utilities Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="liburcu"/> and
      <xref linkend="libuv"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="json-c"/> and
      <xref linkend="nghttp2"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="libcap-pam"/>,
      <xref linkend="libxml2"/>, and
      <xref linkend="sphinx"/>
    </para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of BIND Utilities</title>

    <para>
      Install <application>BIND Utilities</application> by
    running the following commands:</para>

<screen><userinput>./configure --prefix=/usr &amp;&amp;
make -C lib/isc      &amp;&amp;
make -C lib/dns      &amp;&amp;
make -C lib/ns       &amp;&amp;
make -C lib/isccfg   &amp;&amp;
make -C lib/isccc    &amp;&amp;
make -C bin/dig      &amp;&amp;
make -C bin/nsupdate &amp;&amp;
make -C bin/rndc     &amp;&amp;
make -C doc</userinput></screen>

    <para>
      This portion of the package does not come with a test suite.</para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role='root'><userinput>make -C lib/isc      install &amp;&amp;
make -C lib/dns      install &amp;&amp;
make -C lib/ns       install &amp;&amp;
make -C lib/isccfg   install &amp;&amp;
make -C lib/isccc    install &amp;&amp;
make -C bin/dig      install &amp;&amp;
make -C bin/nsupdate install &amp;&amp;
make -C bin/rndc     install &amp;&amp;
cp -v doc/man/{dig.1,host.1,nslookup.1,nsupdate.1} /usr/share/man/man1 &amp;&amp;
cp -v doc/man/rndc.8 /usr/share/man/man8</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <option>--disable-doh</option>: Use this option if you have not installed
      <xref linkend="nghttp2" role="nodep"/> and you don't need DNS over HTTPS
      support.
    </para>

    <para>
      <command>make -C lib/...</command>: These commands build the
      libraries that are needed for the client programs.
    </para>

    <para>
      <command>make -C bin/...</command>: This command builds the
      client programs.
    </para>

    <para>
      <command>make -C doc</command>: This command builds the
      manual pages if the optional Python module
      <xref linkend="sphinx"/> is installed.
    </para>

    <para>
      Use <command>cp -v doc/man/... /usr/share/man/man...</command>
      to install the manual pages if they have been built.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>dig, host, nslookup, nsupdate and rndc</seg>
        <seg>None</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

    <bridgehead renderas="sect3">Short Descriptions</bridgehead>

    <para>
      See the program descriptions in the <xref linkend="bind"/> section.
    </para>

  </sect2>

</sect1>