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