2 - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
3 - Copyright (C) 2000-2003 Internet Software Consortium.
5 - Permission to use, copy, modify, and/or distribute this software for any
6 - purpose with or without fee is hereby granted, provided that the above
7 - copyright notice and this permission notice appear in all copies.
9 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
10 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
11 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
12 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
13 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15 - PERFORMANCE OF THIS SOFTWARE.
20 <meta http-equiv=
"Content-Type" content=
"text/html; charset=ISO-8859-1">
21 <title>Chapter
5. The BIND
9 Lightweight Resolver
</title>
22 <meta name=
"generator" content=
"DocBook XSL Stylesheets V1.71.1">
23 <link rel=
"start" href=
"Bv9ARM.html" title=
"BIND 9 Administrator Reference Manual">
24 <link rel=
"up" href=
"Bv9ARM.html" title=
"BIND 9 Administrator Reference Manual">
25 <link rel=
"prev" href=
"Bv9ARM.ch04.html" title=
"Chapter 4. Advanced DNS Features">
26 <link rel=
"next" href=
"Bv9ARM.ch06.html" title=
"Chapter 6. BIND 9 Configuration Reference">
28 <body bgcolor=
"white" text=
"black" link=
"#0000FF" vlink=
"#840084" alink=
"#0000FF">
29 <div class=
"navheader">
30 <table width=
"100%" summary=
"Navigation header">
31 <tr><th colspan=
"3" align=
"center">Chapter
5. The
<acronym class=
"acronym">BIND
</acronym> 9 Lightweight Resolver
</th></tr>
33 <td width=
"20%" align=
"left">
34 <a accesskey=
"p" href=
"Bv9ARM.ch04.html">Prev
</a> </td>
35 <th width=
"60%" align=
"center"> </th>
36 <td width=
"20%" align=
"right"> <a accesskey=
"n" href=
"Bv9ARM.ch06.html">Next
</a>
42 <div class=
"chapter" lang=
"en">
43 <div class=
"titlepage"><div><div><h2 class=
"title">
44 <a name=
"Bv9ARM.ch05"></a>Chapter
5. The
<acronym class=
"acronym">BIND
</acronym> 9 Lightweight Resolver
</h2></div></div></div>
46 <p><b>Table of Contents
</b></p>
48 <dt><span class=
"sect1"><a href=
"Bv9ARM.ch05.html#id2571844">The Lightweight Resolver Library
</a></span></dt>
49 <dt><span class=
"sect1"><a href=
"Bv9ARM.ch05.html#lwresd">Running a Resolver Daemon
</a></span></dt>
52 <div class=
"sect1" lang=
"en">
53 <div class=
"titlepage"><div><div><h2 class=
"title" style=
"clear: both">
54 <a name=
"id2571844"></a>The Lightweight Resolver Library
</h2></div></div></div>
56 Traditionally applications have been linked with a stub resolver
57 library that sends recursive DNS queries to a local caching name
61 IPv6 once introduced new complexity into the resolution process,
62 such as following A6 chains and DNAME records, and simultaneous
63 lookup of IPv4 and IPv6 addresses. Though most of the complexity was
64 then removed, these are hard or impossible
65 to implement in a traditional stub resolver.
68 <acronym class=
"acronym">BIND
</acronym> 9 therefore can also provide resolution
69 services to local clients
70 using a combination of a lightweight resolver library and a resolver
71 daemon process running on the local host. These communicate using
72 a simple UDP-based protocol, the
"lightweight resolver protocol"
73 that is distinct from and simpler than the full DNS protocol.
76 <div class=
"sect1" lang=
"en">
77 <div class=
"titlepage"><div><div><h2 class=
"title" style=
"clear: both">
78 <a name=
"lwresd"></a>Running a Resolver Daemon
</h2></div></div></div>
80 To use the lightweight resolver interface, the system must
81 run the resolver daemon
<span><strong class=
"command">lwresd
</strong></span> or a
83 name server configured with a
<span><strong class=
"command">lwres
</strong></span>
87 By default, applications using the lightweight resolver library will
89 UDP requests to the IPv4 loopback address (
127.0.0.1) on port
921.
91 address can be overridden by
<span><strong class=
"command">lwserver
</strong></span>
93 <code class=
"filename">/etc/resolv.conf
</code>.
96 The daemon currently only looks in the DNS, but in the future
97 it may use other sources such as
<code class=
"filename">/etc/hosts
</code>,
101 The
<span><strong class=
"command">lwresd
</strong></span> daemon is essentially a
102 caching-only name server that responds to requests using the
104 resolver protocol rather than the DNS protocol. Because it needs
105 to run on each host, it is designed to require no or minimal
107 Unless configured otherwise, it uses the name servers listed on
108 <span><strong class=
"command">nameserver
</strong></span> lines in
<code class=
"filename">/etc/resolv.conf
</code>
109 as forwarders, but is also capable of doing the resolution
114 The
<span><strong class=
"command">lwresd
</strong></span> daemon may also be
116 <code class=
"filename">named.conf
</code> style configuration file,
118 <code class=
"filename">/etc/lwresd.conf
</code> by default. A name
120 be configured to act as a lightweight resolver daemon using the
121 <span><strong class=
"command">lwres
</strong></span> statement in
<code class=
"filename">named.conf
</code>.
125 <div class=
"navfooter">
127 <table width=
"100%" summary=
"Navigation footer">
129 <td width=
"40%" align=
"left">
130 <a accesskey=
"p" href=
"Bv9ARM.ch04.html">Prev
</a> </td>
131 <td width=
"20%" align=
"center"> </td>
132 <td width=
"40%" align=
"right"> <a accesskey=
"n" href=
"Bv9ARM.ch06.html">Next
</a>
136 <td width=
"40%" align=
"left" valign=
"top">Chapter
4. Advanced DNS Features
</td>
137 <td width=
"20%" align=
"center"><a accesskey=
"h" href=
"Bv9ARM.html">Home
</a></td>
138 <td width=
"40%" align=
"right" valign=
"top"> Chapter
6.
<acronym class=
"acronym">BIND
</acronym> 9 Configuration Reference
</td>
142 <p style=
"text-align: center;">BIND
9.10.2-P4
</p>