Bv9ARM.ch05.html revision ea94d370123a5892f6c47a97f21d1b28d44bb168
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!--
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User - Copyright (C) 2004-2012 Internet Systems Consortium, Inc. ("ISC")
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2000-2003 Internet Software Consortium.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User -
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and/or distribute this software for any
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - purpose with or without fee is hereby granted, provided that the above
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - copyright notice and this permission notice appear in all copies.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User -
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User - PERFORMANCE OF THIS SOFTWARE.
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User-->
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<!-- $Id$ -->
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<html>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<head>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<title>Chapter�5.�The BIND 9 Lightweight Resolver</title>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User<link rel="prev" href="Bv9ARM.ch04.html" title="Chapter�4.�Advanced DNS Features">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<link rel="next" href="Bv9ARM.ch06.html" title="Chapter�6.�BIND 9 Configuration Reference">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User</head>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<div class="navheader">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<table width="100%" summary="Navigation header">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<tr><th colspan="3" align="center">Chapter�5.�The <acronym class="acronym">BIND</acronym> 9 Lightweight Resolver</th></tr>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<tr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<td width="20%" align="left">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<a accesskey="p" href="Bv9ARM.ch04.html">Prev</a>�</td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<th width="60%" align="center">�</th>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<td width="20%" align="right">�<a accesskey="n" href="Bv9ARM.ch06.html">Next</a>
dec590a3deb8e87380a8bd3a77d535dba3729bf6Tinderbox User</td>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User</tr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</table>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<hr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</div>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<div class="chapter" lang="en">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<div class="titlepage"><div><div><h2 class="title">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a name="Bv9ARM.ch05"></a>Chapter�5.�The <acronym class="acronym">BIND</acronym> 9 Lightweight Resolver</h2></div></div></div>
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User<div class="toc">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<p><b>Table of Contents</b></p>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<dl>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<dt><span class="sect1"><a href="Bv9ARM.ch05.html#id2573017">The Lightweight Resolver Library</a></span></dt>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<dt><span class="sect1"><a href="Bv9ARM.ch05.html#lwresd">Running a Resolver Daemon</a></span></dt>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User</dl>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</div>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<div class="sect1" lang="en">
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User<div class="titlepage"><div><div><h2 class="title" style="clear: both">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a name="id2573017"></a>The Lightweight Resolver Library</h2></div></div></div>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Traditionally applications have been linked with a stub resolver
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User library that sends recursive DNS queries to a local caching name
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User server.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User </p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<p>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User IPv6 once introduced new complexity into the resolution process,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User such as following A6 chains and DNAME records, and simultaneous
9d557856c2a19ec95ee73245f60a92f8675cf5baTinderbox User lookup of IPv4 and IPv6 addresses. Though most of the complexity was
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User then removed, these are hard or impossible
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User to implement in a traditional stub resolver.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User </p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <acronym class="acronym">BIND</acronym> 9 therefore can also provide resolution
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User services to local clients
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User using a combination of a lightweight resolver library and a resolver
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt daemon process running on the local host. These communicate using
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User a simple UDP-based protocol, the "lightweight resolver protocol"
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User that is distinct from and simpler than the full DNS protocol.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User </p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User</div>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<div class="sect1" lang="en">
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<div class="titlepage"><div><div><h2 class="title" style="clear: both">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a name="lwresd"></a>Running a Resolver Daemon</h2></div></div></div>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User To use the lightweight resolver interface, the system must
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User run the resolver daemon <span><strong class="command">lwresd</strong></span> or a
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User local
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User name server configured with a <span><strong class="command">lwres</strong></span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User statement.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User </p>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User<p>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User By default, applications using the lightweight resolver library will
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User make
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User UDP requests to the IPv4 loopback address (127.0.0.1) on port 921.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User The
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User address can be overridden by <span><strong class="command">lwserver</strong></span>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User lines in
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User <code class="filename">/etc/resolv.conf</code>.
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User </p>
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User<p>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User The daemon currently only looks in the DNS, but in the future
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User it may use other sources such as <code class="filename">/etc/hosts</code>,
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User NIS, etc.
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User </p>
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User<p>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User The <span><strong class="command">lwresd</strong></span> daemon is essentially a
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User caching-only name server that responds to requests using the
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User lightweight
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User resolver protocol rather than the DNS protocol. Because it needs
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User to run on each host, it is designed to require no or minimal
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User configuration.
c2258eedf2d9d0207b45b90014f8fde5413b41a3Tinderbox User Unless configured otherwise, it uses the name servers listed on
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User <span><strong class="command">nameserver</strong></span> lines in <code class="filename">/etc/resolv.conf</code>
1ebb25608fa10737ea27abd4e0481707ccd45581Tinderbox User as forwarders, but is also capable of doing the resolution
autonomously if
none are specified.
</p>
<p>
The <span><strong class="command">lwresd</strong></span> daemon may also be
configured with a
<code class="filename">named.conf</code> style configuration file,
in
<code class="filename">/etc/lwresd.conf</code> by default. A name
server may also
be configured to act as a lightweight resolver daemon using the
<span><strong class="command">lwres</strong></span> statement in <code class="filename">named.conf</code>.
</p>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="Bv9ARM.ch04.html">Prev</a>�</td>
<td width="20%" align="center">�</td>
<td width="40%" align="right">�<a accesskey="n" href="Bv9ARM.ch06.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Chapter�4.�Advanced DNS Features�</td>
<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
<td width="40%" align="right" valign="top">�Chapter�6.�<acronym class="acronym">BIND</acronym> 9 Configuration Reference</td>
</tr>
</table>
</div>
</body>
</html>