lwresd.html revision 6ea1b817e31b89a627e146fe69e23ea0a64c89ec
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<!--
fdd80e9a55c70b36a3bf3e409b86897301c44ff8Automatic Updater - Copyright (C) 2000, 2001 Internet Software Consortium.
3e02c9e33656dcd9c364633d42dd785d3e6fdd66Automatic Updater -
3e02c9e33656dcd9c364633d42dd785d3e6fdd66Automatic Updater - Permission to use, copy, modify, and distribute this software for any
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - purpose with or without fee is hereby granted, provided that the above
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - copyright notice and this permission notice appear in all copies.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater -
3e02c9e33656dcd9c364633d42dd785d3e6fdd66Automatic Updater - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
3e02c9e33656dcd9c364633d42dd785d3e6fdd66Automatic Updater - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater-->
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater<HTML
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><HEAD
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><TITLE
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</TITLE
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><META
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterNAME="GENERATOR"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCONTENT="Modular DocBook HTML Stylesheet Version 1.63
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater"></HEAD
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><BODY
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REFENTRY"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterBGCOLOR="#FFFFFF"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterTEXT="#000000"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterLINK="#0000FF"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterVLINK="#840084"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterALINK="#0000FF"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><H1
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterNAME="AEN1"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><SPAN
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="APPLICATION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</SPAN
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></H1
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><DIV
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REFNAMEDIV"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterNAME="AEN9"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><H2
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>Name</H2
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><SPAN
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="APPLICATION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</SPAN
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater>&nbsp;--&nbsp;lightweight resolver daemon</DIV
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><DIV
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REFSYNOPSISDIV"
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater><A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterNAME="AEN13"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><H2
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater>Synopsis</H2
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><P
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="COMMAND"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-C <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>config-file</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-d <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>debug-level</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-f</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-g</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-i <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>pid-file</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-n <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>#cpus</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic UpdaterCLASS="OPTION"
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater>-P <TT
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic UpdaterCLASS="REPLACEABLE"
64affc54f96a2c71cbd10ed71e246ce0746259aaAutomatic Updater><I
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater>port</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-p <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater>port</I
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater></TT
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater></TT
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater>] [<TT
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic UpdaterCLASS="OPTION"
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater>-s</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-t <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>directory</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-u <TT
5a24d24c8fba3480d707c0c902379ddb36501e12Automatic UpdaterCLASS="REPLACEABLE"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>user</I
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>] [<TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>-v</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>]</P
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater></DIV
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><DIV
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="REFSECT1"
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater><A
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterNAME="AEN48"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><H2
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>DESCRIPTION</H2
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><P
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater> <B
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic UpdaterCLASS="COMMAND"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> is the daemon providing name lookup
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater services to clients that use the BIND 9 lightweight resolver
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater library. It is essentially a stripped-down, caching-only name
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater server that answers queries using the BIND 9 lightweight
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater resolver protocol rather than the DNS protocol.
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater </P
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater><P
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater> <B
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic UpdaterCLASS="COMMAND"
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater>lwresd</B
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater> listens for resolver queries on a
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater UDP port on the IPv4 loopback interface, 127.0.0.1. This
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater means that <B
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic UpdaterCLASS="COMMAND"
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater>lwresd</B
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater> can only be used by
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater processes running on the local machine. By default UDP port
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater number 921 is used for lightweight resolver requests and
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater responses.
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater </P
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater><P
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater> Incoming lightweight resolver requests are decoded by the
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater server which then resolves them using the DNS protocol. When
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater the DNS lookup completes, <B
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic UpdaterCLASS="COMMAND"
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater>lwresd</B
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater> encodes
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater the answers in the lightweight resolver format and returns
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater them to the client that made the request.
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater </P
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><P
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> If <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="FILENAME"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>/etc/resolv.conf</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> contains any
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater>nameserver</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> entries, <B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="COMMAND"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater sends recursive DNS queries to those servers. This is similar
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater to the use of forwarders in a caching name server. If no
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="OPTION"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>nameserver</TT
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> entries are present, or if
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater forwarding fails, <B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="COMMAND"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>lwresd</B
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater> resolves the
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater queries autonomously starting at the root name servers, using
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater a built-in list of root server hints.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater </P
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></DIV
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><DIV
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterCLASS="REFSECT1"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic UpdaterNAME="AEN63"
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater></A
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater><H2
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater>OPTIONS</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>-C <TT
CLASS="REPLACEABLE"
><I
>config-file</I
></TT
></DT
><DD
><P
> Use <TT
CLASS="REPLACEABLE"
><I
>config-file</I
></TT
> as the
configuration file instead of the default,
<TT
CLASS="FILENAME"
>/etc/resolv.conf</TT
>.
</P
></DD
><DT
>-d <TT
CLASS="REPLACEABLE"
><I
>debug-level</I
></TT
></DT
><DD
><P
> Set the daemon's debug level to <TT
CLASS="REPLACEABLE"
><I
>debug-level</I
></TT
>.
Debugging traces from <B
CLASS="COMMAND"
>lwresd</B
> become
more verbose as the debug level increases.
</P
></DD
><DT
>-f</DT
><DD
><P
> Run the server in the foreground (i.e. do not daemonize).
</P
></DD
><DT
>-g</DT
><DD
><P
> Run the server in the foreground and force all logging
to <TT
CLASS="FILENAME"
>stderr</TT
>.
</P
></DD
><DT
>-n <TT
CLASS="REPLACEABLE"
><I
>#cpus</I
></TT
></DT
><DD
><P
> Create <TT
CLASS="REPLACEABLE"
><I
>#cpus</I
></TT
> worker threads
to take advantage of multiple CPUs. If not specified,
<B
CLASS="COMMAND"
>lwresd</B
> will try to determine the
number of CPUs present and create one thread per CPU.
If it is unable to determine the number of CPUs, a
single worker thread will be created.
</P
></DD
><DT
>-P <TT
CLASS="REPLACEABLE"
><I
>port</I
></TT
></DT
><DD
><P
> Listen for lightweight resolver queries on port
<TT
CLASS="REPLACEABLE"
><I
>port</I
></TT
>. If
not specified, the default is port 921.
</P
></DD
><DT
>-p <TT
CLASS="REPLACEABLE"
><I
>port</I
></TT
></DT
><DD
><P
> Send DNS lookups to port <TT
CLASS="REPLACEABLE"
><I
>port</I
></TT
>. If not
specified, the default is port 53. This provides a
way of testing the lightweight resolver daemon with a
name server that listens for queries on a non-standard
port number.
</P
></DD
><DT
>-s</DT
><DD
><P
> Write memory usage statistics to <TT
CLASS="FILENAME"
>stdout</TT
> on exit.
</P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
> This option is mainly of interest to BIND 9 developers
and may be removed or changed in a future release.
</P
></BLOCKQUOTE
></DIV
></DD
><DT
>-t <TT
CLASS="REPLACEABLE"
><I
>directory</I
></TT
></DT
><DD
><P
> <TT
CLASS="FUNCTION"
>chroot()</TT
> to <TT
CLASS="REPLACEABLE"
><I
>directory</I
></TT
> after
processing the command line arguments, but before
reading the configuration file.
</P
><DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
BORDER="1"
WIDTH="90%"
><TR
><TD
ALIGN="CENTER"
><B
>Warning</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
> This option should be used in conjunction with the
<TT
CLASS="OPTION"
>-u</TT
> option, as chrooting a process
running as root doesn't enhance security on most
systems; the way <TT
CLASS="FUNCTION"
>chroot()</TT
> is
defined allows a process with root privileges to
escape a chroot jail.
</P
></TD
></TR
></TABLE
></DIV
></DD
><DT
>-u <TT
CLASS="REPLACEABLE"
><I
>user</I
></TT
></DT
><DD
><P
> <TT
CLASS="FUNCTION"
>setuid()</TT
> to <TT
CLASS="REPLACEABLE"
><I
>user</I
></TT
> after completing
privileged operations, such as creating sockets that
listen on privileged ports.
</P
></DD
><DT
>-v</DT
><DD
><P
> Report the version number and exit.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN137"
></A
><H2
>FILES</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="FILENAME"
>/etc/resolv.conf</TT
></DT
><DD
><P
> The default configuration file.
</P
></DD
><DT
><TT
CLASS="FILENAME"
>/var/run/lwresd.pid</TT
></DT
><DD
><P
> The default process-id file.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN150"
></A
><H2
>SEE ALSO</H2
><P
> <SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>named</SPAN
>(8)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>lwres</SPAN
>(3)</SPAN
>,
<SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>resolver</SPAN
>(5)</SPAN
>.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN162"
></A
><H2
>AUTHOR</H2
><P
> Internet Software Consortium
</P
></DIV
></BODY
></HTML
>