man.lwresd.html revision 350e5eecadfc5ee72b11b2cc46828c9a0bcd717c
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC")
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - This Source Code Form is subject to the terms of the Mozilla Public
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - License, v. 2.0. If a copy of the MPL was not distributed with this
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - file, You can obtain one at http://mozilla.org/MPL/2.0/.
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt<link rel="prev" href="man.dnssec-verify.html" title="dnssec-verify">
e2e4d321999340802f77adaacd19c797d04b4b95Automatic Updater<link rel="next" href="man.named.html" title="named">
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt<tr><th colspan="3" align="center"><span class="application">lwresd</span></th></tr>
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt<a accesskey="p" href="man.dnssec-verify.html">Prev</a>�</td>
e2e4d321999340802f77adaacd19c797d04b4b95Automatic Updater<td width="20%" align="right">�<a accesskey="n" href="man.named.html">Next</a>
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt<a name="man.lwresd"></a><div class="titlepage"></div>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User — lightweight resolver daemon
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [<code class="option">-C <em class="replaceable"><code>config-file</code></em></code>]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [<code class="option">-d <em class="replaceable"><code>debug-level</code></em></code>]
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User [<code class="option">-i <em class="replaceable"><code>pid-file</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-m <em class="replaceable"><code>flag</code></em></code>]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [<code class="option">-n <em class="replaceable"><code>#cpus</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-P <em class="replaceable"><code>port</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-p <em class="replaceable"><code>port</code></em></code>]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>]
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt [<code class="option">-u <em class="replaceable"><code>user</code></em></code>]
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <p><span class="command"><strong>lwresd</strong></span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User is the daemon providing name lookup
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User services to clients that use the BIND 9 lightweight resolver
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User library. It is essentially a stripped-down, caching-only name
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt server that answers queries using the BIND 9 lightweight
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User resolver protocol rather than the DNS protocol.
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt <p><span class="command"><strong>lwresd</strong></span>
ec899c963c91c16c393e067996400ae244921110Tinderbox User listens for resolver queries on a
ec899c963c91c16c393e067996400ae244921110Tinderbox User UDP port on the IPv4 loopback interface, 127.0.0.1. This
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User means that <span class="command"><strong>lwresd</strong></span> can only be used by
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt processes running on the local machine. By default, UDP port
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User number 921 is used for lightweight resolver requests and
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Incoming lightweight resolver requests are decoded by the
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt server which then resolves them using the DNS protocol. When
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updater the DNS lookup completes, <span class="command"><strong>lwresd</strong></span> encodes
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updater the answers in the lightweight resolver format and returns
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updater them to the client that made the request.
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updater If <code class="filename">/etc/resolv.conf</code> contains any
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt <code class="option">nameserver</code> entries, <span class="command"><strong>lwresd</strong></span>
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt sends recursive DNS queries to those servers. This is similar
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User to the use of forwarders in a caching name server. If no
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt <code class="option">nameserver</code> entries are present, or if
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User forwarding fails, <span class="command"><strong>lwresd</strong></span> resolves the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt queries autonomously starting at the root name servers, using
ec899c963c91c16c393e067996400ae244921110Tinderbox User a built-in list of root server hints.
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt <div class="variablelist"><dl class="variablelist">
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt Use IPv4 only even if the host machine is capable of IPv6.
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt <code class="option">-4</code> and <code class="option">-6</code> are mutually
ec899c963c91c16c393e067996400ae244921110Tinderbox User Use IPv6 only even if the host machine is capable of IPv4.
ec899c963c91c16c393e067996400ae244921110Tinderbox User <code class="option">-4</code> and <code class="option">-6</code> are mutually
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updater<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updater Use <em class="replaceable"><code>config-file</code></em> as the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User configuration file instead of the default,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <code class="option">-c</code> can not be used with <code class="option">-C</code>.
ec899c963c91c16c393e067996400ae244921110Tinderbox User<dt><span class="term">-C <em class="replaceable"><code>config-file</code></em></span></dt>
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updater Use <em class="replaceable"><code>config-file</code></em> as the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User configuration file instead of the default,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <code class="option">-C</code> can not be used with <code class="option">-c</code>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term">-d <em class="replaceable"><code>debug-level</code></em></span></dt>
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt Set the daemon's debug level to <em class="replaceable"><code>debug-level</code></em>.
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt Debugging traces from <span class="command"><strong>lwresd</strong></span> become
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User more verbose as the debug level increases.
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt Run the server in the foreground (i.e. do not daemonize).
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt Run the server in the foreground and force all logging
e2e4d321999340802f77adaacd19c797d04b4b95Automatic Updater<dt><span class="term">-i <em class="replaceable"><code>pid-file</code></em></span></dt>
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt Use <em class="replaceable"><code>pid-file</code></em> as the
76786c2904942b708d8a7a4659df74da5dc9446eEvan Hunt PID file instead of the default,
1ca759b3f5c0672b2a66bc02288fe010cabbfe37Tinderbox User <code class="filename">/var/run/lwresd/lwresd.pid</code>.
<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.2 (Extended Support Version)</p>