This commit is contained in:
Mark Andrews 2005-04-03 03:32:07 +00:00
parent 31ec08ccd0
commit d16e5588cc
41 changed files with 5371 additions and 3531 deletions

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: named-checkconf.html,v 1.9.18.4 2004/08/22 23:53:24 marka Exp $ -->
<!-- $Id: named-checkconf.html,v 1.9.18.5 2005/04/03 03:31:59 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>named-checkconf</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,21 +62,23 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>named-checkconf</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-v</VAR
>] [<VAR
>-v</CODE
>] [<CODE
CLASS="OPTION"
>-j</VAR
>] [<VAR
>-j</CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
></VAR
>] {filename} [<VAR
><I
>directory</I
></TT
></CODE
>] {filename} [<CODE
CLASS="OPTION"
>-z</VAR
>-z</CODE
>]</P
></DIV
><DIV
@ -107,9 +109,11 @@ NAME="AEN30"
CLASS="VARIABLELIST"
><DL
><DT
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
></DT
><DD
><P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: named-checkzone.html,v 1.11.18.7 2005/03/16 04:58:30 marka Exp $ -->
<!-- $Id: named-checkzone.html,v 1.11.18.8 2005/04/03 03:32:00 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>named-checkzone</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,63 +62,77 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>named-checkzone</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-d</VAR
>] [<VAR
>-d</CODE
>] [<CODE
CLASS="OPTION"
>-j</VAR
>] [<VAR
>-j</CODE
>] [<CODE
CLASS="OPTION"
>-q</VAR
>] [<VAR
>-q</CODE
>] [<CODE
CLASS="OPTION"
>-v</VAR
>] [<VAR
>-v</CODE
>] [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
></VAR
>] [<VAR
><I
>class</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>mode</VAR
></VAR
>] [<VAR
><I
>mode</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>mode</VAR
></VAR
>] [<VAR
><I
>mode</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-o <VAR
>-o <TT
CLASS="REPLACEABLE"
>filename</VAR
></VAR
>] [<VAR
><I
>filename</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
></VAR
>] [<VAR
><I
>directory</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-w <VAR
>-w <TT
CLASS="REPLACEABLE"
>directory</VAR
></VAR
>] [<VAR
><I
>directory</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-D</VAR
>] [<VAR
>-D</CODE
>] [<CODE
CLASS="OPTION"
>-W <VAR
>-W <TT
CLASS="REPLACEABLE"
>mode</VAR
></VAR
><I
>mode</I
></TT
></CODE
>] {zonename} {filename}</P
></DIV
><DIV
@ -190,9 +204,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
><I
>class</I
></TT
></DT
><DD
><P
@ -200,9 +216,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>mode</VAR
><I
>mode</I
></TT
></DT
><DD
><P
@ -225,9 +243,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>mode</VAR
><I
>mode</I
></TT
></DT
><DD
><P
@ -247,9 +267,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-o <VAR
>-o <TT
CLASS="REPLACEABLE"
>filename</VAR
><I
>filename</I
></TT
></DT
><DD
><P
@ -260,9 +282,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
></DT
><DD
><P
@ -275,9 +299,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-w <VAR
>-w <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
></DT
><DD
><P
@ -301,9 +327,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-W <VAR
>-W <TT
CLASS="REPLACEABLE"
>mode</VAR
><I
>mode</I
></TT
></DT
><DD
><P

File diff suppressed because it is too large Load diff

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: host.html,v 1.7.18.5 2004/11/11 01:55:56 marka Exp $ -->
<!-- $Id: host.html,v 1.7.18.6 2005/04/03 03:32:00 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>host</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -56,51 +56,63 @@ NAME="AEN11"
><B
CLASS="COMMAND"
>host</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-aCdlnrTwv</VAR
>] [<VAR
>-aCdlnrTwv</CODE
>] [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
></VAR
>] [<VAR
><I
>class</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-N <VAR
>-N <TT
CLASS="REPLACEABLE"
>ndots</VAR
></VAR
>] [<VAR
><I
>ndots</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-R <VAR
>-R <TT
CLASS="REPLACEABLE"
>number</VAR
></VAR
>] [<VAR
><I
>number</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>type</VAR
></VAR
>] [<VAR
><I
>type</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-W <VAR
>-W <TT
CLASS="REPLACEABLE"
>wait</VAR
></VAR
>] [<VAR
><I
>wait</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-m <VAR
>-m <TT
CLASS="REPLACEABLE"
>flag</VAR
></VAR
>] [<VAR
><I
>flag</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-4</VAR
>] [<VAR
>-4</CODE
>] [<CODE
CLASS="OPTION"
>-6</VAR
>-6</CODE
>] {name} [server]</P
></DIV
><DIV
@ -124,9 +136,9 @@ CLASS="COMMAND"
>
prints a short summary of its command line arguments and options.</P
><P
><VAR
><CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
> is the domain name that is to be looked
up. It can also be a dotted-decimal IPv4 address or a colon-delimited
IPv6 address, in which case <B
@ -134,9 +146,9 @@ CLASS="COMMAND"
>host</B
> will by default
perform a reverse lookup for that address.
<VAR
<CODE
CLASS="PARAMETER"
>server</VAR
>server</CODE
> is an optional argument which is either
the name or IP address of the name server that <B
CLASS="COMMAND"
@ -148,41 +160,41 @@ CLASS="FILENAME"
>/etc/resolv.conf</TT
>.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-a</VAR
>-a</CODE
> (all) option is equivalent to setting the
<VAR
<CODE
CLASS="OPTION"
>-v</VAR
>-v</CODE
> option and asking <B
CLASS="COMMAND"
>host</B
> to make
a query of type ANY.</P
><P
>When the <VAR
>When the <CODE
CLASS="OPTION"
>-C</VAR
>-C</CODE
> option is used, <B
CLASS="COMMAND"
>host</B
>
will attempt to display the SOA records for zone
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
> from all the listed authoritative name
servers for that zone. The list of name servers is defined by the NS
records that are found for the zone.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-c</VAR
>-c</CODE
> option instructs to make a DNS query of class
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>. This can be used to lookup Hesiod or
Chaosnet class resource records. The default class is IN (Internet).</P
><P
@ -190,57 +202,57 @@ Chaosnet class resource records. The default class is IN (Internet).</P
CLASS="COMMAND"
>host</B
> when the
<VAR
<CODE
CLASS="OPTION"
>-d</VAR
> or <VAR
>-d</CODE
> or <CODE
CLASS="OPTION"
>-v</VAR
>-v</CODE
> option is used. The two
options are equivalent. They have been provided for backwards
compatibility. In previous versions, the <VAR
compatibility. In previous versions, the <CODE
CLASS="OPTION"
>-d</VAR
>-d</CODE
> option
switched on debugging traces and <VAR
switched on debugging traces and <CODE
CLASS="OPTION"
>-v</VAR
>-v</CODE
> enabled verbose
output.</P
><P
>List mode is selected by the <VAR
>List mode is selected by the <CODE
CLASS="OPTION"
>-l</VAR
>-l</CODE
> option. This makes
<B
CLASS="COMMAND"
>host</B
> perform a zone transfer for zone
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>. Transfer the zone printing out the NS, PTR
and address records (A/AAAA). If combined with <VAR
and address records (A/AAAA). If combined with <CODE
CLASS="OPTION"
>-a</VAR
>-a</CODE
>
all records will be printed. </P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-i</VAR
>-i</CODE
>
option specifies that reverse lookups of IPv6 addresses should
use the IP6.INT domain as defined in RFC1886.
The default is to use IP6.ARPA.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-N</VAR
>-N</CODE
> option sets the number of dots that have to be
in <VAR
in <CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
> for it to be considered absolute. The
default value is that defined using the ndots statement in
<TT
@ -262,27 +274,27 @@ CLASS="FILENAME"
>.</P
><P
>The number of UDP retries for a lookup can be changed with the
<VAR
<CODE
CLASS="OPTION"
>-R</VAR
> option. <VAR
>-R</CODE
> option. <CODE
CLASS="PARAMETER"
>number</VAR
>number</CODE
> indicates
how many times <B
CLASS="COMMAND"
>host</B
> will repeat a query that does
not get answered. The default number of retries is 1. If
<VAR
<CODE
CLASS="PARAMETER"
>number</VAR
>number</CODE
> is negative or zero, the number of
retries will default to 1.</P
><P
>Non-recursive queries can be made via the <VAR
>Non-recursive queries can be made via the <CODE
CLASS="OPTION"
>-r</VAR
>-r</CODE
> option.
Setting this option clears the <SPAN
CLASS="TYPE"
@ -293,13 +305,13 @@ CLASS="COMMAND"
>host</B
> makes.
This should mean that the name server receiving the query will not
attempt to resolve <VAR
attempt to resolve <CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>. The
<VAR
<CODE
CLASS="OPTION"
>-r</VAR
>-r</CODE
> option enables <B
CLASS="COMMAND"
>host</B
@ -312,36 +324,36 @@ referrals to other name servers.</P
CLASS="COMMAND"
>host</B
> uses UDP when making queries. The
<VAR
<CODE
CLASS="OPTION"
>-T</VAR
>-T</CODE
> option makes it use a TCP connection when querying
the name server. TCP will be automatically selected for queries that
require it, such as zone transfer (AXFR) requests.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-4</VAR
>-4</CODE
> option forces <B
CLASS="COMMAND"
>host</B
> to only
use IPv4 query transport. The <VAR
use IPv4 query transport. The <CODE
CLASS="OPTION"
>-6</VAR
>-6</CODE
> option forces
<B
CLASS="COMMAND"
>host</B
> to only use IPv6 query transport.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-t</VAR
>-t</CODE
> option is used to select the query type.
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
> can be any recognised query type: CNAME,
NS, SOA, SIG, KEY, AXFR, etc. When no query type is specified,
<B
@ -349,13 +361,13 @@ CLASS="COMMAND"
>host</B
> automatically selects an appropriate query
type. By default it looks for A records, but if the
<VAR
<CODE
CLASS="OPTION"
>-C</VAR
>-C</CODE
> option was given, queries will be made for SOA
records, and if <VAR
records, and if <CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
> is a dotted-decimal IPv4
address or colon-delimited IPv6 address, <B
CLASS="COMMAND"
@ -366,31 +378,31 @@ serial number can be specified by appending an equal followed by the
starting serial number (e.g. -t IXFR=12345678).</P
><P
>The time to wait for a reply can be controlled through the
<VAR
<CODE
CLASS="OPTION"
>-W</VAR
> and <VAR
>-W</CODE
> and <CODE
CLASS="OPTION"
>-w</VAR
>-w</CODE
> options. The
<VAR
<CODE
CLASS="OPTION"
>-W</VAR
>-W</CODE
> option makes <B
CLASS="COMMAND"
>host</B
> wait for
<VAR
<CODE
CLASS="PARAMETER"
>wait</VAR
> seconds. If <VAR
>wait</CODE
> seconds. If <CODE
CLASS="PARAMETER"
>wait</VAR
>wait</CODE
>
is less than one, the wait interval is set to one second. When the
<VAR
<CODE
CLASS="OPTION"
>-w</VAR
>-w</CODE
> option is used, <B
CLASS="COMMAND"
>host</B
@ -399,20 +411,20 @@ effectively wait forever for a reply. The time to wait for a response
will be set to the number of seconds given by the hardware's maximum
value for an integer quantity.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-m</VAR
>-m</CODE
> can be used to set the memory usage debugging flags
<VAR
<CODE
CLASS="PARAMETER"
>record</VAR
>, <VAR
>record</CODE
>, <CODE
CLASS="PARAMETER"
>usage</VAR
>usage</CODE
> and
<VAR
<CODE
CLASS="PARAMETER"
>trace</VAR
>trace</CODE
>. </P
></DIV
><DIV

View file

@ -14,16 +14,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: nslookup.html,v 1.1.10.3 2004/08/22 23:53:25 marka Exp $ -->
<!-- $Id: nslookup.html,v 1.1.10.4 2005/04/03 03:32:00 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>nslookup</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -55,9 +55,9 @@ NAME="AEN11"
><B
CLASS="COMMAND"
>nslookup</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-option</VAR
>-option</CODE
>] [name | -] [server]</P
></DIV
><DIV
@ -161,9 +161,11 @@ the name.</P
><CODE
CLASS="CONSTANT"
>server</CODE
> <VAR
> <TT
CLASS="REPLACEABLE"
>domain</VAR
><I
>domain</I
></TT
></DT
><DD
><P
@ -173,22 +175,28 @@ CLASS="REPLACEABLE"
><CODE
CLASS="CONSTANT"
>lserver</CODE
> <VAR
> <TT
CLASS="REPLACEABLE"
>domain</VAR
><I
>domain</I
></TT
></DT
><DD
><P
>Change the default server to <VAR
>Change the default server to <TT
CLASS="REPLACEABLE"
>domain</VAR
><I
>domain</I
></TT
>; <CODE
CLASS="CONSTANT"
>lserver</CODE
> uses the initial
server to look up information about <VAR
server to look up information about <TT
CLASS="REPLACEABLE"
>domain</VAR
><I
>domain</I
></TT
>, while <CODE
CLASS="CONSTANT"
>server</CODE
@ -264,12 +272,14 @@ CLASS="CONSTANT"
><CODE
CLASS="CONSTANT"
>set</CODE
> <VAR
> <TT
CLASS="REPLACEABLE"
><I
>keyword[<SPAN
CLASS="OPTIONAL"
>=value</SPAN
>]</VAR
>]</I
></TT
></DT
><DD
><P
@ -299,9 +309,11 @@ CLASS="COMMAND"
><CODE
CLASS="CONSTANT"
>class=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>value</VAR
><I
>value</I
></TT
></DT
><DD
><P
@ -359,12 +371,14 @@ CLASS="CONSTANT"
><DT
><CODE
CLASS="CONSTANT"
><VAR
><TT
CLASS="REPLACEABLE"
><I
>[<SPAN
CLASS="OPTIONAL"
>no</SPAN
>]</VAR
>]</I
></TT
>debug</CODE
></DT
><DD
@ -383,12 +397,14 @@ CLASS="OPTIONAL"
><DT
><CODE
CLASS="CONSTANT"
><VAR
><TT
CLASS="REPLACEABLE"
><I
>[<SPAN
CLASS="OPTIONAL"
>no</SPAN
>]</VAR
>]</I
></TT
>d2</CODE
></DT
><DD
@ -405,27 +421,33 @@ CLASS="OPTIONAL"
><CODE
CLASS="CONSTANT"
>domain=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>name</VAR
><I
>name</I
></TT
></DT
><DD
><P
> Sets the search list to <VAR
> Sets the search list to <TT
CLASS="REPLACEABLE"
>name</VAR
><I
>name</I
></TT
>.
</P
></DD
><DT
><CODE
CLASS="CONSTANT"
><VAR
><TT
CLASS="REPLACEABLE"
><I
>[<SPAN
CLASS="OPTIONAL"
>no</SPAN
>]</VAR
>]</I
></TT
>search</CODE
></DT
><DD
@ -443,15 +465,19 @@ CLASS="OPTIONAL"
><CODE
CLASS="CONSTANT"
>port=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>value</VAR
><I
>value</I
></TT
></DT
><DD
><P
> Change the default TCP/UDP name server port to <VAR
> Change the default TCP/UDP name server port to <TT
CLASS="REPLACEABLE"
>value</VAR
><I
>value</I
></TT
>.
</P
><P
@ -462,9 +488,11 @@ CLASS="REPLACEABLE"
><CODE
CLASS="CONSTANT"
>querytype=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>value</VAR
><I
>value</I
></TT
></DT
><DD
><P
@ -474,9 +502,11 @@ CLASS="REPLACEABLE"
><CODE
CLASS="CONSTANT"
>type=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>value</VAR
><I
>value</I
></TT
></DT
><DD
><P
@ -489,12 +519,14 @@ CLASS="REPLACEABLE"
><DT
><CODE
CLASS="CONSTANT"
><VAR
><TT
CLASS="REPLACEABLE"
><I
>[<SPAN
CLASS="OPTIONAL"
>no</SPAN
>]</VAR
>]</I
></TT
>recurse</CODE
></DT
><DD
@ -510,9 +542,11 @@ CLASS="OPTIONAL"
><CODE
CLASS="CONSTANT"
>retry=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>number</VAR
><I
>number</I
></TT
></DT
><DD
><P
@ -523,9 +557,11 @@ CLASS="REPLACEABLE"
><CODE
CLASS="CONSTANT"
>timeout=</CODE
><VAR
><TT
CLASS="REPLACEABLE"
>number</VAR
><I
>number</I
></TT
></DT
><DD
><P
@ -536,12 +572,14 @@ CLASS="REPLACEABLE"
><DT
><CODE
CLASS="CONSTANT"
><VAR
><TT
CLASS="REPLACEABLE"
><I
>[<SPAN
CLASS="OPTIONAL"
>no</SPAN
>]</VAR
>]</I
></TT
>vc</CODE
></DT
><DD

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: dnssec-keygen.html,v 1.9.18.5 2004/08/22 23:53:26 marka Exp $ -->
<!-- $Id: dnssec-keygen.html,v 1.9.18.6 2005/04/03 03:32:01 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>dnssec-keygen</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,72 +62,94 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>dnssec-keygen</B
> {-a <VAR
> {-a <TT
CLASS="REPLACEABLE"
>algorithm</VAR
>} {-b <VAR
><I
>algorithm</I
></TT
>} {-b <TT
CLASS="REPLACEABLE"
>keysize</VAR
>} {-n <VAR
><I
>keysize</I
></TT
>} {-n <TT
CLASS="REPLACEABLE"
>nametype</VAR
>} [<VAR
><I
>nametype</I
></TT
>} [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
></VAR
>] [<VAR
><I
>class</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-e</VAR
>] [<VAR
>-e</CODE
>] [<CODE
CLASS="OPTION"
>-f <VAR
>-f <TT
CLASS="REPLACEABLE"
>flag</VAR
></VAR
>] [<VAR
><I
>flag</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-g <VAR
>-g <TT
CLASS="REPLACEABLE"
>generator</VAR
></VAR
>] [<VAR
><I
>generator</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-h</VAR
>] [<VAR
>-h</CODE
>] [<CODE
CLASS="OPTION"
>-k</VAR
>] [<VAR
>-k</CODE
>] [<CODE
CLASS="OPTION"
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>protocol</VAR
></VAR
>] [<VAR
><I
>protocol</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>randomdev</VAR
></VAR
>] [<VAR
><I
>randomdev</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>strength</VAR
></VAR
>] [<VAR
><I
>strength</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>type</VAR
></VAR
>] [<VAR
><I
>type</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-v <VAR
>-v <TT
CLASS="REPLACEABLE"
>level</VAR
></VAR
><I
>level</I
></TT
></CODE
>] {name}</P
></DIV
><DIV
@ -160,16 +182,18 @@ NAME="AEN57"
CLASS="VARIABLELIST"
><DL
><DT
>-a <VAR
>-a <TT
CLASS="REPLACEABLE"
>algorithm</VAR
><I
>algorithm</I
></TT
></DT
><DD
><P
> Selects the cryptographic algorithm. The value of
<VAR
<CODE
CLASS="OPTION"
>algorithm</VAR
>algorithm</CODE
> must be one of RSAMD5 (RSA) or RSASHA1,
DSA, DH (Diffie Hellman), or HMAC-MD5. These values
are case insensitive.
@ -183,9 +207,11 @@ CLASS="OPTION"
</P
></DD
><DT
>-b <VAR
>-b <TT
CLASS="REPLACEABLE"
>keysize</VAR
><I
>keysize</I
></TT
></DT
><DD
><P
@ -198,16 +224,18 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>nametype</VAR
><I
>nametype</I
></TT
></DT
><DD
><P
> Specifies the owner type of the key. The value of
<VAR
<CODE
CLASS="OPTION"
>nametype</VAR
>nametype</CODE
> must either be ZONE (for a DNSSEC
zone key (KEY/DNSKEY)), HOST or ENTITY (for a key associated with a host (KEY)),
USER (for a key associated with a user(KEY)) or OTHER (DNSKEY). These values are
@ -215,9 +243,11 @@ CLASS="OPTION"
</P
></DD
><DT
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
><I
>class</I
></TT
></DT
><DD
><P
@ -233,9 +263,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-f <VAR
>-f <TT
CLASS="REPLACEABLE"
>flag</VAR
><I
>flag</I
></TT
></DT
><DD
><P
@ -244,9 +276,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-g <VAR
>-g <TT
CLASS="REPLACEABLE"
>generator</VAR
><I
>generator</I
></TT
></DT
><DD
><P
@ -275,9 +309,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>protocol</VAR
><I
>protocol</I
></TT
></DT
><DD
><P
@ -288,9 +324,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>randomdev</VAR
><I
>randomdev</I
></TT
></DT
><DD
><P
@ -314,9 +352,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>strength</VAR
><I
>strength</I
></TT
></DT
><DD
><P
@ -326,15 +366,17 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>type</VAR
><I
>type</I
></TT
></DT
><DD
><P
> Indicates the use of the key. <VAR
> Indicates the use of the key. <CODE
CLASS="OPTION"
>type</VAR
>type</CODE
> must be
one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF. The default
is AUTHCONF. AUTH refers to the ability to authenticate
@ -342,9 +384,11 @@ CLASS="OPTION"
</P
></DD
><DT
>-v <VAR
>-v <TT
CLASS="REPLACEABLE"
>level</VAR
><I
>level</I
></TT
></DT
><DD
><P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: dnssec-signzone.html,v 1.8.18.7 2005/03/23 03:43:51 marka Exp $ -->
<!-- $Id: dnssec-signzone.html,v 1.8.18.8 2005/04/03 03:32:01 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>dnssec-signzone</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,102 +62,128 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>dnssec-signzone</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-a</VAR
>] [<VAR
>-a</CODE
>] [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
></VAR
>] [<VAR
><I
>class</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-d <VAR
>-d <TT
CLASS="REPLACEABLE"
>directory</VAR
></VAR
>] [<VAR
><I
>directory</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-e <VAR
>-e <TT
CLASS="REPLACEABLE"
>end-time</VAR
></VAR
>] [<VAR
><I
>end-time</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-f <VAR
>-f <TT
CLASS="REPLACEABLE"
>output-file</VAR
></VAR
>] [<VAR
><I
>output-file</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-g</VAR
>] [<VAR
>-g</CODE
>] [<CODE
CLASS="OPTION"
>-h</VAR
>] [<VAR
>-h</CODE
>] [<CODE
CLASS="OPTION"
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>key</VAR
></VAR
>] [<VAR
><I
>key</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-l <VAR
>-l <TT
CLASS="REPLACEABLE"
>domain</VAR
></VAR
>] [<VAR
><I
>domain</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-i <VAR
>-i <TT
CLASS="REPLACEABLE"
>interval</VAR
></VAR
>] [<VAR
><I
>interval</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-j <VAR
>-j <TT
CLASS="REPLACEABLE"
>jitter</VAR
></VAR
>] [<VAR
><I
>jitter</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>nthreads</VAR
></VAR
>] [<VAR
><I
>nthreads</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-o <VAR
>-o <TT
CLASS="REPLACEABLE"
>origin</VAR
></VAR
>] [<VAR
><I
>origin</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-p</VAR
>] [<VAR
>-p</CODE
>] [<CODE
CLASS="OPTION"
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>randomdev</VAR
></VAR
>] [<VAR
><I
>randomdev</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>start-time</VAR
></VAR
>] [<VAR
><I
>start-time</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-t</VAR
>] [<VAR
>-t</CODE
>] [<CODE
CLASS="OPTION"
>-v <VAR
>-v <TT
CLASS="REPLACEABLE"
>level</VAR
></VAR
>] [<VAR
><I
>level</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-z</VAR
>-z</CODE
>] {zonefile} [key...]</P
></DIV
><DIV
@ -202,9 +228,11 @@ CLASS="VARIABLELIST"
</P
></DD
><DT
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>class</VAR
><I
>class</I
></TT
></DT
><DD
><P
@ -212,9 +240,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>key</VAR
><I
>key</I
></TT
></DT
><DD
><P
@ -223,9 +253,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-l <VAR
>-l <TT
CLASS="REPLACEABLE"
>domain</VAR
><I
>domain</I
></TT
></DT
><DD
><P
@ -234,9 +266,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-d <VAR
>-d <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
></DT
><DD
><P
@ -244,9 +278,9 @@ CLASS="REPLACEABLE"
CLASS="FILENAME"
>keyset</TT
> files in
<VAR
<CODE
CLASS="OPTION"
>directory</VAR
>directory</CODE
> as the directory
</P
></DD
@ -259,9 +293,11 @@ CLASS="OPTION"
</P
></DD
><DT
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>start-time</VAR
><I
>start-time</I
></TT
></DT
><DD
><P
@ -271,39 +307,43 @@ CLASS="REPLACEABLE"
in YYYYMMDDHHMMSS notation; 20000530144500 denotes
14:45:00 UTC on May 30th, 2000. A relative start time is
indicated by +N, which is N seconds from the current time.
If no <VAR
If no <CODE
CLASS="OPTION"
>start-time</VAR
>start-time</CODE
> is specified, the current
time minus 1 hour (to allow for clock skew) is used.
</P
></DD
><DT
>-e <VAR
>-e <TT
CLASS="REPLACEABLE"
>end-time</VAR
><I
>end-time</I
></TT
></DT
><DD
><P
> Specify the date and time when the generated RRSIG records
expire. As with <VAR
expire. As with <CODE
CLASS="OPTION"
>start-time</VAR
>start-time</CODE
>, an absolute
time is indicated in YYYYMMDDHHMMSS notation. A time relative
to the start time is indicated with +N, which is N seconds from
the start time. A time relative to the current time is
indicated with now+N. If no <VAR
indicated with now+N. If no <CODE
CLASS="OPTION"
>end-time</VAR
>end-time</CODE
> is
specified, 30 days from the start time is used as a default.
</P
></DD
><DT
>-f <VAR
>-f <TT
CLASS="REPLACEABLE"
>output-file</VAR
><I
>output-file</I
></TT
></DT
><DD
><P
@ -327,16 +367,18 @@ CLASS="COMMAND"
</P
></DD
><DT
>-i <VAR
>-i <TT
CLASS="REPLACEABLE"
>interval</VAR
><I
>interval</I
></TT
></DT
><DD
><P
> When a previously signed zone is passed as input, records
may be resigned. The <VAR
may be resigned. The <CODE
CLASS="OPTION"
>interval</VAR
>interval</CODE
> option
specifies the cycle interval as an offset from the current
time (in seconds). If a RRSIG record expires after the
@ -346,12 +388,12 @@ CLASS="OPTION"
><P
> The default cycle interval is one quarter of the difference
between the signature end and start times. So if neither
<VAR
<CODE
CLASS="OPTION"
>end-time</VAR
> or <VAR
>end-time</CODE
> or <CODE
CLASS="OPTION"
>start-time</VAR
>start-time</CODE
>
are specified, <B
CLASS="COMMAND"
@ -372,9 +414,9 @@ CLASS="COMMAND"
simultaneously. If the zone is incrementally signed, i.e.
a previously signed zone is passed as input to the signer,
all expired signatures has to be regenerated at about the
same time. The <VAR
same time. The <CODE
CLASS="OPTION"
>jitter</VAR
>jitter</CODE
> option specifies a
jitter window that will be used to randomize the signature
expire time, thus spreading incremental signature
@ -389,9 +431,11 @@ CLASS="OPTION"
</P
></DD
><DT
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>ncpus</VAR
><I
>ncpus</I
></TT
></DT
><DD
><P
@ -400,9 +444,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-o <VAR
>-o <TT
CLASS="REPLACEABLE"
>origin</VAR
><I
>origin</I
></TT
></DT
><DD
><P
@ -421,9 +467,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>randomdev</VAR
><I
>randomdev</I
></TT
></DT
><DD
><P
@ -454,9 +502,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-v <VAR
>-v <TT
CLASS="REPLACEABLE"
>level</VAR
><I
>level</I
></TT
></DT
><DD
><P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwresd.html,v 1.5.18.4 2004/08/22 23:53:27 marka Exp $ -->
<!-- $Id: lwresd.html,v 1.5.18.5 2005/04/03 03:32:01 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwresd</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,66 +62,82 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>lwresd</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-C <VAR
>-C <TT
CLASS="REPLACEABLE"
>config-file</VAR
></VAR
>] [<VAR
><I
>config-file</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-d <VAR
>-d <TT
CLASS="REPLACEABLE"
>debug-level</VAR
></VAR
>] [<VAR
><I
>debug-level</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-f</VAR
>] [<VAR
>-f</CODE
>] [<CODE
CLASS="OPTION"
>-g</VAR
>] [<VAR
>-g</CODE
>] [<CODE
CLASS="OPTION"
>-i <VAR
>-i <TT
CLASS="REPLACEABLE"
>pid-file</VAR
></VAR
>] [<VAR
><I
>pid-file</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>#cpus</VAR
></VAR
>] [<VAR
><I
>#cpus</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-P <VAR
>-P <TT
CLASS="REPLACEABLE"
>port</VAR
></VAR
>] [<VAR
><I
>port</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
></VAR
>] [<VAR
><I
>port</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-s</VAR
>] [<VAR
>-s</CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
></VAR
>] [<VAR
><I
>directory</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>user</VAR
></VAR
>] [<VAR
><I
>user</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-v</VAR
>-v</CODE
>]</P
></DIV
><DIV
@ -170,18 +186,18 @@ CLASS="COMMAND"
CLASS="FILENAME"
>/etc/resolv.conf</TT
> contains any
<VAR
<CODE
CLASS="OPTION"
>nameserver</VAR
>nameserver</CODE
> entries, <B
CLASS="COMMAND"
>lwresd</B
>
sends recursive DNS queries to those servers. This is similar
to the use of forwarders in a caching name server. If no
<VAR
<CODE
CLASS="OPTION"
>nameserver</VAR
>nameserver</CODE
> entries are present, or if
forwarding fails, <B
CLASS="COMMAND"
@ -204,15 +220,19 @@ NAME="AEN63"
CLASS="VARIABLELIST"
><DL
><DT
>-C <VAR
>-C <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
></DT
><DD
><P
> Use <VAR
> Use <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
> as the
configuration file instead of the default,
<TT
@ -222,15 +242,19 @@ CLASS="FILENAME"
</P
></DD
><DT
>-d <VAR
>-d <TT
CLASS="REPLACEABLE"
>debug-level</VAR
><I
>debug-level</I
></TT
></DT
><DD
><P
> Set the daemon's debug level to <VAR
> Set the daemon's debug level to <TT
CLASS="REPLACEABLE"
>debug-level</VAR
><I
>debug-level</I
></TT
>.
Debugging traces from <B
CLASS="COMMAND"
@ -258,15 +282,19 @@ CLASS="FILENAME"
</P
></DD
><DT
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>#cpus</VAR
><I
>#cpus</I
></TT
></DT
><DD
><P
> Create <VAR
> Create <TT
CLASS="REPLACEABLE"
>#cpus</VAR
><I
>#cpus</I
></TT
> worker threads
to take advantage of multiple CPUs. If not specified,
<B
@ -279,30 +307,38 @@ CLASS="COMMAND"
</P
></DD
><DT
>-P <VAR
>-P <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
></DT
><DD
><P
> Listen for lightweight resolver queries on port
<VAR
<TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
>. If
not specified, the default is port 921.
</P
></DD
><DT
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
></DT
><DD
><P
> Send DNS lookups to port <VAR
> Send DNS lookups to port <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
>. If not
specified, the default is port 53. This provides a
way of testing the lightweight resolver daemon with a
@ -334,18 +370,22 @@ CLASS="NOTE"
></DIV
></DD
><DT
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
></DT
><DD
><P
> <CODE
CLASS="FUNCTION"
>chroot()</CODE
> to <VAR
> to <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
> after
processing the command line arguments, but before
reading the configuration file.
@ -370,9 +410,9 @@ ALIGN="CENTER"
ALIGN="LEFT"
><P
> This option should be used in conjunction with the
<VAR
<CODE
CLASS="OPTION"
>-u</VAR
>-u</CODE
> option, as chrooting a process
running as root doesn't enhance security on most
systems; the way <CODE
@ -388,18 +428,22 @@ CLASS="FUNCTION"
></DIV
></DD
><DT
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>user</VAR
><I
>user</I
></TT
></DT
><DD
><P
> <CODE
CLASS="FUNCTION"
>setuid()</CODE
> to <VAR
> to <TT
CLASS="REPLACEABLE"
>user</VAR
><I
>user</I
></TT
> after completing
privileged operations, such as creating sockets that
listen on privileged ports.

File diff suppressed because it is too large Load diff

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: named.html,v 1.6.18.4 2004/08/22 23:53:28 marka Exp $ -->
<!-- $Id: named.html,v 1.6.18.5 2005/04/03 03:32:02 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>named</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,66 +62,80 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>named</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-4</VAR
>] [<VAR
>-4</CODE
>] [<CODE
CLASS="OPTION"
>-6</VAR
>] [<VAR
>-6</CODE
>] [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>config-file</VAR
></VAR
>] [<VAR
><I
>config-file</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-d <VAR
>-d <TT
CLASS="REPLACEABLE"
>debug-level</VAR
></VAR
>] [<VAR
><I
>debug-level</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-f</VAR
>] [<VAR
>-f</CODE
>] [<CODE
CLASS="OPTION"
>-g</VAR
>] [<VAR
>-g</CODE
>] [<CODE
CLASS="OPTION"
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>#cpus</VAR
></VAR
>] [<VAR
><I
>#cpus</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
></VAR
>] [<VAR
><I
>port</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-s</VAR
>] [<VAR
>-s</CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
></VAR
>] [<VAR
><I
>directory</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>user</VAR
></VAR
>] [<VAR
><I
>user</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-v</VAR
>] [<VAR
>-v</CODE
>] [<CODE
CLASS="OPTION"
>-x <VAR
>-x <TT
CLASS="REPLACEABLE"
>cache-file</VAR
></VAR
><I
>cache-file</I
></TT
></CODE
>]</P
></DIV
><DIV
@ -169,12 +183,12 @@ CLASS="VARIABLELIST"
><DD
><P
> Use IPv4 only even if the host machine is capable of IPv6.
<VAR
<CODE
CLASS="OPTION"
>-4</VAR
> and <VAR
>-4</CODE
> and <CODE
CLASS="OPTION"
>-6</VAR
>-6</CODE
> are mutually
exclusive.
</P
@ -184,26 +198,30 @@ CLASS="OPTION"
><DD
><P
> Use IPv6 only even if the host machine is capable of IPv4.
<VAR
<CODE
CLASS="OPTION"
>-4</VAR
> and <VAR
>-4</CODE
> and <CODE
CLASS="OPTION"
>-6</VAR
>-6</CODE
> are mutually
exclusive.
</P
></DD
><DT
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
></DT
><DD
><P
> Use <VAR
> Use <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
> as the
configuration file instead of the default,
<TT
@ -213,27 +231,33 @@ CLASS="FILENAME"
ensure that reloading the configuration file continues
to work after the server has changed its working
directory due to to a possible
<VAR
<CODE
CLASS="OPTION"
>directory</VAR
>directory</CODE
> option in the configuration
file, <VAR
file, <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
> should be
an absolute pathname.
</P
></DD
><DT
>-d <VAR
>-d <TT
CLASS="REPLACEABLE"
>debug-level</VAR
><I
>debug-level</I
></TT
></DT
><DD
><P
> Set the daemon's debug level to <VAR
> Set the daemon's debug level to <TT
CLASS="REPLACEABLE"
>debug-level</VAR
><I
>debug-level</I
></TT
>.
Debugging traces from <B
CLASS="COMMAND"
@ -261,15 +285,19 @@ CLASS="FILENAME"
</P
></DD
><DT
>-n <VAR
>-n <TT
CLASS="REPLACEABLE"
>#cpus</VAR
><I
>#cpus</I
></TT
></DT
><DD
><P
> Create <VAR
> Create <TT
CLASS="REPLACEABLE"
>#cpus</VAR
><I
>#cpus</I
></TT
> worker threads
to take advantage of multiple CPUs. If not specified,
<B
@ -282,15 +310,19 @@ CLASS="COMMAND"
</P
></DD
><DT
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
></DT
><DD
><P
> Listen for queries on port <VAR
> Listen for queries on port <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
>. If not
specified, the default is port 53.
</P
@ -318,18 +350,22 @@ CLASS="NOTE"
></DIV
></DD
><DT
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
></DT
><DD
><P
> <CODE
CLASS="FUNCTION"
>chroot()</CODE
> to <VAR
> to <TT
CLASS="REPLACEABLE"
>directory</VAR
><I
>directory</I
></TT
> after
processing the command line arguments, but before
reading the configuration file.
@ -354,9 +390,9 @@ ALIGN="CENTER"
ALIGN="LEFT"
><P
> This option should be used in conjunction with the
<VAR
<CODE
CLASS="OPTION"
>-u</VAR
>-u</CODE
> option, as chrooting a process
running as root doesn't enhance security on most
systems; the way <CODE
@ -372,18 +408,22 @@ CLASS="FUNCTION"
></DIV
></DD
><DT
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>user</VAR
><I
>user</I
></TT
></DT
><DD
><P
> <CODE
CLASS="FUNCTION"
>setuid()</CODE
> to <VAR
> to <TT
CLASS="REPLACEABLE"
>user</VAR
><I
>user</I
></TT
> after completing
privileged operations, such as creating sockets that
listen on privileged ports.
@ -405,9 +445,9 @@ CLASS="FUNCTION"
>bind()</CODE
> to a
privileged port and set process resource limits.
Unfortunately, this means that the <VAR
Unfortunately, this means that the <CODE
CLASS="OPTION"
>-u</VAR
>-u</CODE
>
option only works when <B
CLASS="COMMAND"
@ -431,15 +471,19 @@ CLASS="FUNCTION"
</P
></DD
><DT
>-x <VAR
>-x <TT
CLASS="REPLACEABLE"
>cache-file</VAR
><I
>cache-file</I
></TT
></DT
><DD
><P
> Load data from <VAR
> Load data from <TT
CLASS="REPLACEABLE"
>cache-file</VAR
><I
>cache-file</I
></TT
> into the
cache of the default view.
</P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: nsupdate.html,v 1.14.18.3 2004/08/22 23:53:28 marka Exp $ -->
<!-- $Id: nsupdate.html,v 1.14.18.4 2005/04/03 03:32:02 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>nsupdate</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -56,42 +56,52 @@ NAME="AEN11"
><B
CLASS="COMMAND"
>nsupdate</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-d</VAR
>] [<VAR
>-d</CODE
>] [<CODE
CLASS="OPTION"
>-y <VAR
>-y <TT
CLASS="REPLACEABLE"
>keyname:secret</VAR
></VAR
> | <VAR
><I
>keyname:secret</I
></TT
></CODE
> | <CODE
CLASS="OPTION"
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>keyfile</VAR
></VAR
>] [<VAR
><I
>keyfile</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>timeout</VAR
></VAR
>] [<VAR
><I
>timeout</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>udptimeout</VAR
></VAR
>] [<VAR
><I
>udptimeout</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>udpretries</VAR
></VAR
>] [<VAR
><I
>udpretries</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-v</VAR
>-v</CODE
>] [filename]</P
></DIV
><DIV
@ -132,9 +142,9 @@ Requests are sent to the zone's master server.
This is identified by the MNAME field of the zone's SOA record.</P
><P
>The
<VAR
<CODE
CLASS="OPTION"
>-d</VAR
>-d</CODE
>
option makes
<B
@ -194,22 +204,22 @@ CLASS="COMMAND"
>nsupdate</B
>
uses the
<VAR
<CODE
CLASS="OPTION"
>-y</VAR
>-y</CODE
>
or
<VAR
<CODE
CLASS="OPTION"
>-k</VAR
>-k</CODE
>
option (with an HMAC-MD5 key) to provide the shared secret needed to generate
a TSIG record for authenticating Dynamic DNS update requests.
These options are mutually exclusive.
With the
<VAR
<CODE
CLASS="OPTION"
>-k</VAR
>-k</CODE
>
option,
<B
@ -217,9 +227,9 @@ CLASS="COMMAND"
>nsupdate</B
>
reads the shared secret from the file
<VAR
<CODE
CLASS="PARAMETER"
>keyfile</VAR
>keyfile</CODE
>,
whose name is of the form
<TT
@ -233,30 +243,30 @@ CLASS="FILENAME"
>K{name}.+157.+{random}.key</TT
>
must also be present. When the
<VAR
<CODE
CLASS="OPTION"
>-y</VAR
>-y</CODE
>
option is used, a signature is generated from
<VAR
<CODE
CLASS="PARAMETER"
>keyname:secret.</VAR
>keyname:secret.</CODE
>
<VAR
<CODE
CLASS="PARAMETER"
>keyname</VAR
>keyname</CODE
>
is the name of the key,
and
<VAR
<CODE
CLASS="PARAMETER"
>secret</VAR
>secret</CODE
>
is the base64 encoded shared secret.
Use of the
<VAR
<CODE
CLASS="OPTION"
>-y</VAR
>-y</CODE
>
option is discouraged because the shared secret is supplied as a command
line argument in clear text.
@ -270,9 +280,9 @@ CLASS="REFENTRYTITLE"
>
or in a history file maintained by the user's shell.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-k</VAR
>-k</CODE
> may also be used to specify a SIG(0) key used
to authenticate Dynamic DNS update requests. In this case, the key
specified is not an HMAC-MD5 key.</P
@ -285,9 +295,9 @@ CLASS="COMMAND"
uses UDP to send update requests to the name server unless they are too
large to fit in a UDP request in which case TCP will be used.
The
<VAR
<CODE
CLASS="OPTION"
>-v</VAR
>-v</CODE
>
option makes
<B
@ -297,23 +307,23 @@ CLASS="COMMAND"
use a TCP connection.
This may be preferable when a batch of update requests is made.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-t</VAR
>-t</CODE
> option sets the maximum time a update request can
take before it is aborted. The default is 300 seconds. Zero can be used
to disable the timeout.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-u</VAR
>-u</CODE
> option sets the UDP retry interval. The default is
3 seconds. If zero the interval will be computed from the timeout interval
and number of UDP retries.</P
><P
>The <VAR
>The <CODE
CLASS="OPTION"
>-r</VAR
>-r</CODE
> option sets the number of UDP retries. The default is
3. If zero only one update request will be made.</P
></DIV
@ -330,9 +340,9 @@ CLASS="COMMAND"
>nsupdate</B
>
reads input from
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>
or standard input.
Each command is supplied on exactly one line of input.
@ -371,9 +381,9 @@ CLASS="COMMAND"
><DD
><P
>Sends all dynamic update requests to the name server
<VAR
<CODE
CLASS="PARAMETER"
>servername</VAR
>servername</CODE
>.
When no server statement is provided,
<B
@ -383,14 +393,14 @@ CLASS="COMMAND"
will send updates to the master server of the correct zone.
The MNAME field of that zone's SOA record will identify the master
server for that zone.
<VAR
<CODE
CLASS="PARAMETER"
>port</VAR
>port</CODE
>
is the port number on
<VAR
<CODE
CLASS="PARAMETER"
>servername</VAR
>servername</CODE
>
where the dynamic update requests get sent.
If no port number is specified, the default DNS port number of 53 is
@ -406,9 +416,9 @@ CLASS="COMMAND"
><DD
><P
>Sends all dynamic update requests using the local
<VAR
<CODE
CLASS="PARAMETER"
>address</VAR
>address</CODE
>.
When no local statement is provided,
@ -417,9 +427,9 @@ CLASS="COMMAND"
>nsupdate</B
>
will send updates using an address and port chosen by the system.
<VAR
<CODE
CLASS="PARAMETER"
>port</VAR
>port</CODE
>
can additionally be used to make requests come from a specific port.
If no port number is specified, the system will assign one.&#13;</P
@ -434,14 +444,14 @@ CLASS="COMMAND"
><DD
><P
>Specifies that all updates are to be made to the zone
<VAR
<CODE
CLASS="PARAMETER"
>zonename</VAR
>zonename</CODE
>.
If no
<VAR
<CODE
CLASS="PARAMETER"
>zone</VAR
>zone</CODE
>
statement is provided,
<B
@ -460,13 +470,13 @@ CLASS="COMMAND"
><DD
><P
>Specify the default class.
If no <VAR
If no <CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
> is specified the default class is
<VAR
<CODE
CLASS="PARAMETER"
>IN</VAR
>IN</CODE
>.</P
></DD
><DT
@ -479,24 +489,24 @@ CLASS="COMMAND"
><DD
><P
>Specifies that all updates are to be TSIG signed using the
<VAR
<CODE
CLASS="PARAMETER"
>keyname</VAR
> <VAR
>keyname</CODE
> <CODE
CLASS="PARAMETER"
>keysecret</VAR
>keysecret</CODE
> pair.
The <B
CLASS="COMMAND"
>key</B
> command
overrides any key specified on the command line via
<VAR
<CODE
CLASS="OPTION"
>-y</VAR
> or <VAR
>-y</CODE
> or <CODE
CLASS="OPTION"
>-k</VAR
>-k</CODE
>.</P
></DD
><DT
@ -509,9 +519,9 @@ CLASS="COMMAND"
><DD
><P
>Requires that no resource record of any type exists with name
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>.</P
></DD
><DT
@ -524,9 +534,9 @@ CLASS="COMMAND"
><DD
><P
>Requires that
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>
exists (has as at least one resource record, of any type).</P
></DD
@ -540,23 +550,23 @@ CLASS="COMMAND"
><DD
><P
>Requires that no resource record exists of the specified
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>.
If
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>
is omitted, IN (internet) is assumed.</P
></DD
@ -570,24 +580,24 @@ CLASS="COMMAND"
><DD
><P
>This requires that a resource record of the specified
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>
must exist.
If
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>
is omitted, IN (internet) is assumed.</P
></DD
@ -601,45 +611,45 @@ CLASS="COMMAND"
><DD
><P
>The
<VAR
<CODE
CLASS="PARAMETER"
>data</VAR
>data</CODE
>
from each set of prerequisites of this form
sharing a common
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>,
and
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>
are combined to form a set of RRs. This set of RRs must
exactly match the set of RRs existing in the zone at the
given
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>,
and
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>.
The
<VAR
<CODE
CLASS="PARAMETER"
>data</VAR
>data</CODE
>
are written in the standard text representation of the resource record's
RDATA.</P
@ -654,30 +664,30 @@ CLASS="COMMAND"
><DD
><P
>Deletes any resource records named
<VAR
<CODE
CLASS="PARAMETER"
>domain-name</VAR
>domain-name</CODE
>.
If
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>data</VAR
>data</CODE
>
is provided, only matching resource records will be removed.
The internet class is assumed if
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>
is not supplied. The
<VAR
<CODE
CLASS="PARAMETER"
>ttl</VAR
>ttl</CODE
>
is ignored, and is only allowed for compatibility.</P
></DD
@ -691,18 +701,18 @@ CLASS="COMMAND"
><DD
><P
>Adds a new resource record with the specified
<VAR
<CODE
CLASS="PARAMETER"
>ttl</VAR
>ttl</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>data</VAR
>data</CODE
>.</P
></DD
><DT

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: rndc-confgen.html,v 1.8.18.4 2004/08/22 23:53:29 marka Exp $ -->
<!-- $Id: rndc-confgen.html,v 1.8.18.5 2005/04/03 03:32:02 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>rndc-confgen</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,60 +62,76 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>rndc-confgen</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-a</VAR
>] [<VAR
>-a</CODE
>] [<CODE
CLASS="OPTION"
>-b <VAR
>-b <TT
CLASS="REPLACEABLE"
>keysize</VAR
></VAR
>] [<VAR
><I
>keysize</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>keyfile</VAR
></VAR
>] [<VAR
><I
>keyfile</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-h</VAR
>] [<VAR
>-h</CODE
>] [<CODE
CLASS="OPTION"
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>keyname</VAR
></VAR
>] [<VAR
><I
>keyname</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
></VAR
>] [<VAR
><I
>port</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>randomfile</VAR
></VAR
>] [<VAR
><I
>randomfile</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>address</VAR
></VAR
>] [<VAR
><I
>address</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>chrootdir</VAR
></VAR
>] [<VAR
><I
>chrootdir</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>user</VAR
></VAR
><I
>user</I
></TT
></CODE
>]</P
></DIV
><DIV
@ -197,9 +213,9 @@ CLASS="FILENAME"
CLASS="FILENAME"
>/etc</TT
> (or whatever
<VAR
<CODE
CLASS="VARNAME"
>sysconfdir</VAR
>sysconfdir</CODE
>
was specified as when <ACRONYM
CLASS="ACRONYM"
@ -274,9 +290,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-b <VAR
>-b <TT
CLASS="REPLACEABLE"
>keysize</VAR
><I
>keysize</I
></TT
></DT
><DD
><P
@ -285,9 +303,11 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>keyfile</VAR
><I
>keyfile</I
></TT
></DT
><DD
><P
@ -313,9 +333,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>keyname</VAR
><I
>keyname</I
></TT
></DT
><DD
><P
@ -328,9 +350,11 @@ CLASS="CONSTANT"
</P
></DD
><DT
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
></DT
><DD
><P
@ -346,9 +370,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-r <VAR
>-r <TT
CLASS="REPLACEABLE"
>randomfile</VAR
><I
>randomfile</I
></TT
></DT
><DD
><P
@ -373,9 +399,11 @@ CLASS="FILENAME"
</P
></DD
><DT
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>address</VAR
><I
>address</I
></TT
></DT
><DD
><P
@ -392,9 +420,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-t <VAR
>-t <TT
CLASS="REPLACEABLE"
>chrootdir</VAR
><I
>chrootdir</I
></TT
></DT
><DD
><P
@ -418,9 +448,11 @@ CLASS="COMMAND"
</P
></DD
><DT
>-u <VAR
>-u <TT
CLASS="REPLACEABLE"
>user</VAR
><I
>user</I
></TT
></DT
><DD
><P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: rndc.conf.html,v 1.6.18.6 2004/08/22 23:53:29 marka Exp $ -->
<!-- $Id: rndc.conf.html,v 1.6.18.7 2005/04/03 03:32:02 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>rndc.conf</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -111,114 +111,114 @@ CLASS="FILENAME"
and a key statement.
</P
><P
> The <VAR
> The <CODE
CLASS="OPTION"
>options</VAR
>options</CODE
> statement contains five clauses.
The <VAR
The <CODE
CLASS="OPTION"
>default-server</VAR
>default-server</CODE
> clause is followed by the
name or address of a name server. This host will be used when
no name server is given as an argument to
<B
CLASS="COMMAND"
>rndc</B
>. The <VAR
>. The <CODE
CLASS="OPTION"
>default-key</VAR
>default-key</CODE
>
clause is followed by the name of a key which is identified by
a <VAR
a <CODE
CLASS="OPTION"
>key</VAR
>key</CODE
> statement. If no
<VAR
<CODE
CLASS="OPTION"
>keyid</VAR
>keyid</CODE
> is provided on the rndc command line,
and no <VAR
and no <CODE
CLASS="OPTION"
>key</VAR
>key</CODE
> clause is found in a matching
<VAR
<CODE
CLASS="OPTION"
>server</VAR
>server</CODE
> statement, this default key will be
used to authenticate the server's commands and responses. The
<VAR
<CODE
CLASS="OPTION"
>default-port</VAR
>default-port</CODE
> clause is followed by the port
to connect to on the remote name server. If no
<VAR
<CODE
CLASS="OPTION"
>port</VAR
>port</CODE
> option is provided on the rndc command
line, and no <VAR
line, and no <CODE
CLASS="OPTION"
>port</VAR
>port</CODE
> clause is found in a
matching <VAR
matching <CODE
CLASS="OPTION"
>server</VAR
>server</CODE
> statement, this default port
will be used to connect.
The <VAR
The <CODE
CLASS="OPTION"
>default-source-address</VAR
>default-source-address</CODE
> and
<VAR
<CODE
CLASS="OPTION"
>default-source-address-v6</VAR
>default-source-address-v6</CODE
> clauses which
can be used to set the IPv4 and IPv6 source addresses
respectively.
</P
><P
> After the <VAR
> After the <CODE
CLASS="OPTION"
>server</VAR
>server</CODE
> keyword, the server
statement includes a string which is the hostname or address
for a name server. The statement has three possible clauses:
<VAR
<CODE
CLASS="OPTION"
>key</VAR
>, <VAR
>key</CODE
>, <CODE
CLASS="OPTION"
>port</VAR
>port</CODE
> and
<VAR
<CODE
CLASS="OPTION"
>addresses</VAR
>addresses</CODE
>. The key name must match the
name of a key statement in the file. The port number
specifies the port to connect to. If an <VAR
specifies the port to connect to. If an <CODE
CLASS="OPTION"
>addresses</VAR
>addresses</CODE
>
clause is supplied these addresses will be used instead of
the server name. Each address can take a optional port.
If an <VAR
If an <CODE
CLASS="OPTION"
>source-address</VAR
> or <VAR
>source-address</CODE
> or <CODE
CLASS="OPTION"
>source-address-v6</VAR
>source-address-v6</CODE
>
of supplied then these will be used to specify the IPv4 and IPv6
source addresses respectively.
</P
><P
> The <VAR
> The <CODE
CLASS="OPTION"
>key</VAR
>key</CODE
> statement begins with an identifying
string, the name of the key. The statement has two clauses.
<VAR
<CODE
CLASS="OPTION"
>algorithm</VAR
>algorithm</CODE
> identifies the encryption algorithm
for <B
CLASS="COMMAND"
@ -324,13 +324,13 @@ CLASS="FILENAME"
>rndc.conf</TT
> file, including the
randomly generated key, will be written to the standard
output. Commented out <VAR
output. Commented out <CODE
CLASS="OPTION"
>key</VAR
>key</CODE
> and
<VAR
<CODE
CLASS="OPTION"
>controls</VAR
>controls</CODE
> statements for
<TT
CLASS="FILENAME"
@ -367,9 +367,9 @@ CLASS="FILENAME"
CLASS="FILENAME"
>named.conf</TT
>.
See the sections on the <VAR
See the sections on the <CODE
CLASS="OPTION"
>controls</VAR
>controls</CODE
> statement in the
BIND 9 Administrator Reference Manual for details.
</P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: rndc.html,v 1.8.18.5 2004/08/22 23:53:30 marka Exp $ -->
<!-- $Id: rndc.html,v 1.8.18.6 2005/04/03 03:32:02 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>rndc</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -62,45 +62,57 @@ NAME="AEN13"
><B
CLASS="COMMAND"
>rndc</B
> [<VAR
> [<CODE
CLASS="OPTION"
>-b <VAR
>-b <TT
CLASS="REPLACEABLE"
>source-address</VAR
></VAR
>] [<VAR
><I
>source-address</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>config-file</VAR
></VAR
>] [<VAR
><I
>config-file</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>key-file</VAR
></VAR
>] [<VAR
><I
>key-file</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>server</VAR
></VAR
>] [<VAR
><I
>server</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
></VAR
>] [<VAR
><I
>port</I
></TT
></CODE
>] [<CODE
CLASS="OPTION"
>-V</VAR
>] [<VAR
>-V</CODE
>] [<CODE
CLASS="OPTION"
>-y <VAR
>-y <TT
CLASS="REPLACEABLE"
>key_id</VAR
></VAR
><I
>key_id</I
></TT
></CODE
>] {command}</P
></DIV
><DIV
@ -171,15 +183,19 @@ NAME="AEN49"
CLASS="VARIABLELIST"
><DL
><DT
>-b <VAR
>-b <TT
CLASS="REPLACEABLE"
>source-address</VAR
><I
>source-address</I
></TT
></DT
><DD
><P
> Use <VAR
> Use <TT
CLASS="REPLACEABLE"
>source-address</VAR
><I
>source-address</I
></TT
>
as the source address for the connection to the server.
Multiple instances are permitted to allow setting of both
@ -187,15 +203,19 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-c <VAR
>-c <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
></DT
><DD
><P
> Use <VAR
> Use <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
>
as the configuration file instead of the default,
<TT
@ -205,15 +225,19 @@ CLASS="FILENAME"
</P
></DD
><DT
>-k <VAR
>-k <TT
CLASS="REPLACEABLE"
>key-file</VAR
><I
>key-file</I
></TT
></DT
><DD
><P
> Use <VAR
> Use <TT
CLASS="REPLACEABLE"
>key-file</VAR
><I
>key-file</I
></TT
>
as the key file instead of the default,
<TT
@ -224,23 +248,29 @@ CLASS="FILENAME"
CLASS="FILENAME"
>/etc/rndc.key</TT
> will be used to authenticate
commands sent to the server if the <VAR
commands sent to the server if the <TT
CLASS="REPLACEABLE"
>config-file</VAR
><I
>config-file</I
></TT
>
does not exist.
</P
></DD
><DT
>-s <VAR
>-s <TT
CLASS="REPLACEABLE"
>server</VAR
><I
>server</I
></TT
></DT
><DD
><P
> <VAR
> <TT
CLASS="REPLACEABLE"
>server</VAR
><I
>server</I
></TT
> is
the name or address of the server which matches a
server statement in the configuration file for
@ -254,16 +284,20 @@ CLASS="COMMAND"
</P
></DD
><DT
>-p <VAR
>-p <TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
></DT
><DD
><P
> Send commands to TCP port
<VAR
<TT
CLASS="REPLACEABLE"
>port</VAR
><I
>port</I
></TT
> instead
of BIND 9's default control channel port, 953.
</P
@ -276,26 +310,34 @@ CLASS="REPLACEABLE"
</P
></DD
><DT
>-y <VAR
>-y <TT
CLASS="REPLACEABLE"
>keyid</VAR
><I
>keyid</I
></TT
></DT
><DD
><P
> Use the key <VAR
> Use the key <TT
CLASS="REPLACEABLE"
>keyid</VAR
><I
>keyid</I
></TT
>
from the configuration file.
<VAR
<TT
CLASS="REPLACEABLE"
>keyid</VAR
><I
>keyid</I
></TT
> must be
known by named with the same algorithm and secret string
in order for control message validation to succeed.
If no <VAR
If no <TT
CLASS="REPLACEABLE"
>keyid</VAR
><I
>keyid</I
></TT
>
is specified, <B
CLASS="COMMAND"
@ -343,9 +385,9 @@ CLASS="COMMAND"
</P
><P
> There is currently no way to provide the shared secret for a
<VAR
<CODE
CLASS="OPTION"
>key_id</VAR
>key_id</CODE
> without using the configuration file.
</P
><P

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Introduction </TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK
@ -398,9 +398,9 @@ CLASS="emphasis"
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>Fixed Width</VAR
>Fixed Width</TT
></P
></TD
></TR
@ -411,9 +411,9 @@ CLASS="literal"
></TD
><TD
><P
><VAR
><CODE
CLASS="varname"
>Fixed Width</VAR
>Fixed Width</CODE
></P
></TD
></TR
@ -554,30 +554,30 @@ CLASS="emphasis"
>Example, Inc.</I
></SPAN
> could be
<VAR
<TT
CLASS="literal"
>mail.example.com</VAR
>mail.example.com</TT
>,
where <VAR
where <TT
CLASS="literal"
>com</VAR
>com</TT
> is the
top level domain to which
<VAR
<TT
CLASS="literal"
>ourhost.example.com</VAR
>ourhost.example.com</TT
> belongs,
<VAR
<TT
CLASS="literal"
>example</VAR
>example</TT
> is
a subdomain of <VAR
a subdomain of <TT
CLASS="literal"
>com</VAR
>com</TT
>, and
<VAR
<TT
CLASS="literal"
>ourhost</VAR
>ourhost</TT
> is the
name of the host.</P
><P
@ -676,30 +676,30 @@ CLASS="emphasis"
parent zone, which should be matched by equivalent NS records at
the root of the delegated zone.</P
><P
>For instance, consider the <VAR
>For instance, consider the <TT
CLASS="literal"
>example.com</VAR
>example.com</TT
>
domain which includes names
such as <VAR
such as <TT
CLASS="literal"
>host.aaa.example.com</VAR
>host.aaa.example.com</TT
> and
<VAR
<TT
CLASS="literal"
>host.bbb.example.com</VAR
>host.bbb.example.com</TT
> even though
the <VAR
the <TT
CLASS="literal"
>example.com</VAR
>example.com</TT
> zone includes
only delegations for the <VAR
only delegations for the <TT
CLASS="literal"
>aaa.example.com</VAR
>aaa.example.com</TT
> and
<VAR
<TT
CLASS="literal"
>bbb.example.com</VAR
>bbb.example.com</TT
> zones. A zone can map
exactly to a single domain, but could also include only part of a
domain, the rest of which could be delegated to other

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>BIND Resource Requirements</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Name Server Configuration</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK
@ -250,37 +250,37 @@ CLASS="CALSTABLE"
><TR
><TD
><P
><VAR
><TT
CLASS="literal"
>www</VAR
>www</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>600</VAR
>600</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>IN</VAR
>IN</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>A</VAR
>A</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>10.0.0.1</VAR
>10.0.0.1</TT
></P
></TD
></TR
@ -291,30 +291,30 @@ CLASS="literal"
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>600</VAR
>600</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>IN</VAR
>IN</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>A</VAR
>A</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>10.0.0.2</VAR
>10.0.0.2</TT
></P
></TD
></TR
@ -325,30 +325,30 @@ CLASS="literal"
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>600</VAR
>600</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>IN</VAR
>IN</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>A</VAR
>A</TT
></P
></TD
><TD
><P
><VAR
><TT
CLASS="literal"
>10.0.0.3</VAR
>10.0.0.3</TT
></P
></TD
></TR
@ -458,27 +458,41 @@ from the command line.</P
><B
CLASS="command"
>dig</B
> [@<VAR
> [@<TT
CLASS="replaceable"
>server</VAR
>] <VAR
><I
>server</I
></TT
>] <TT
CLASS="replaceable"
>domain</VAR
> [<VAR
><I
>domain</I
></TT
> [<TT
CLASS="replaceable"
>query-type</VAR
>] [<VAR
><I
>query-type</I
></TT
>] [<TT
CLASS="replaceable"
>query-class</VAR
>] [+<VAR
><I
>query-class</I
></TT
>] [+<TT
CLASS="replaceable"
>query-option</VAR
>] [-<VAR
><I
>query-option</I
></TT
>] [-<TT
CLASS="replaceable"
>dig-option</VAR
>] [%<VAR
><I
>dig-option</I
></TT
>] [%<TT
CLASS="replaceable"
>comment</VAR
><I
>comment</I
></TT
>]</P
><P
>The usual simple use of dig will take the form</P
@ -512,27 +526,41 @@ can be extended with the use of options.</P
><B
CLASS="command"
>host</B
> [-aCdlrTwv] [-c <VAR
> [-aCdlrTwv] [-c <TT
CLASS="replaceable"
>class</VAR
>] [-N <VAR
><I
>class</I
></TT
>] [-N <TT
CLASS="replaceable"
>ndots</VAR
>] [-t <VAR
><I
>ndots</I
></TT
>] [-t <TT
CLASS="replaceable"
>type</VAR
>] [-W <VAR
><I
>type</I
></TT
>] [-W <TT
CLASS="replaceable"
>timeout</VAR
>] [-R <VAR
><I
>timeout</I
></TT
>] [-R <TT
CLASS="replaceable"
>retries</VAR
>] <VAR
><I
>retries</I
></TT
>] <TT
CLASS="replaceable"
>hostname</VAR
> [<VAR
><I
>hostname</I
></TT
> [<TT
CLASS="replaceable"
>server</VAR
><I
>server</I
></TT
>]</P
><P
>For more information and a list of available commands and
@ -560,9 +588,11 @@ the name and requested information for a host or domain.</P
><B
CLASS="command"
>nslookup</B
> [-option...] [<VAR
> [-option...] [<TT
CLASS="replaceable"
>host-to-find</VAR
><I
>host-to-find</I
></TT
> | - [server]]</P
><P
>Interactive mode is entered when no arguments are given (the
@ -625,12 +655,16 @@ CLASS="filename"
><B
CLASS="command"
>named-checkconf</B
> [-t <VAR
> [-t <TT
CLASS="replaceable"
>directory</VAR
>] [<VAR
><I
>directory</I
></TT
>] [<TT
CLASS="replaceable"
>filename</VAR
><I
>filename</I
></TT
>]</P
></DD
><DT
@ -652,30 +686,46 @@ CLASS="command"
><B
CLASS="command"
>named-checkzone</B
> [-djqvD] [-c <VAR
> [-djqvD] [-c <TT
CLASS="replaceable"
>class</VAR
>] [-o <VAR
><I
>class</I
></TT
>] [-o <TT
CLASS="replaceable"
>output</VAR
>] [-t <VAR
><I
>output</I
></TT
>] [-t <TT
CLASS="replaceable"
>directory</VAR
>] [-w <VAR
><I
>directory</I
></TT
>] [-w <TT
CLASS="replaceable"
>directory</VAR
>] [-k <VAR
><I
>directory</I
></TT
>] [-k <TT
CLASS="replaceable"
>(ignore|warn|fail)</VAR
>] [-n <VAR
><I
>(ignore|warn|fail)</I
></TT
>] [-n <TT
CLASS="replaceable"
>(ignore|warn|fail)</VAR
>] <VAR
><I
>(ignore|warn|fail)</I
></TT
>] <TT
CLASS="replaceable"
>zone</VAR
> [<VAR
><I
>zone</I
></TT
> [<TT
CLASS="replaceable"
>filename</VAR
><I
>filename</I
></TT
>]</P
></DD
><DT
@ -703,24 +753,36 @@ CLASS="command"
><B
CLASS="command"
>rndc</B
> [-c <VAR
> [-c <TT
CLASS="replaceable"
>config</VAR
>] [-s <VAR
><I
>config</I
></TT
>] [-s <TT
CLASS="replaceable"
>server</VAR
>] [-p <VAR
><I
>server</I
></TT
>] [-p <TT
CLASS="replaceable"
>port</VAR
>] [-y <VAR
><I
>port</I
></TT
>] [-y <TT
CLASS="replaceable"
>key</VAR
>] <VAR
><I
>key</I
></TT
>] <TT
CLASS="replaceable"
>command</VAR
> [<VAR
><I
>command</I
></TT
> [<TT
CLASS="replaceable"
>command</VAR
><I
>command</I
></TT
>...]</P
><P
><B
@ -744,21 +806,27 @@ CLASS="userinput"
><DT
><KBD
CLASS="userinput"
>reload <VAR
>reload <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>class</VAR
><I
>class</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>view</VAR
><I
>view</I
></TT
></SPAN
>]</SPAN
>]</KBD
@ -770,21 +838,27 @@ CLASS="replaceable"
><DT
><KBD
CLASS="userinput"
>refresh <VAR
>refresh <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>class</VAR
><I
>class</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>view</VAR
><I
>view</I
></TT
></SPAN
>]</SPAN
>]</KBD
@ -796,21 +870,27 @@ CLASS="replaceable"
><DT
><KBD
CLASS="userinput"
>retransfer <VAR
>retransfer <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>class</VAR
><I
>class</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>view</VAR
><I
>view</I
></TT
></SPAN
>]</SPAN
>]</KBD
@ -822,21 +902,27 @@ CLASS="replaceable"
><DT
><KBD
CLASS="userinput"
>freeze <VAR
>freeze <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>class</VAR
><I
>class</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>view</VAR
><I
>view</I
></TT
></SPAN
>]</SPAN
>]</KBD
@ -852,21 +938,27 @@ CLASS="replaceable"
><DT
><KBD
CLASS="userinput"
>unfreeze <VAR
>unfreeze <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>class</VAR
><I
>class</I
></TT
>
[<SPAN
CLASS="optional"
><VAR
><TT
CLASS="replaceable"
>view</VAR
><I
>view</I
></TT
></SPAN
>]</SPAN
>]</KBD
@ -977,9 +1069,11 @@ CLASS="userinput"
><DT
><KBD
CLASS="userinput"
>trace <VAR
>trace <TT
CLASS="replaceable"
>level</VAR
><I
>level</I
></TT
></KBD
></DT
><DD
@ -1063,9 +1157,9 @@ CLASS="command"
CLASS="filename"
>/etc/rndc.conf</TT
>, but an alternate
location can be specified with the <VAR
location can be specified with the <CODE
CLASS="option"
>-c</VAR
>-c</CODE
>
option. If the configuration file is not found,
<B
@ -1076,9 +1170,9 @@ CLASS="command"
CLASS="filename"
>/etc/rndc.key</TT
> (or whatever
<VAR
<CODE
CLASS="varname"
>sysconfdir</VAR
>sysconfdir</CODE
> was defined when
the <ACRONYM
CLASS="acronym"
@ -1142,9 +1236,9 @@ CLASS="command"
>default-server</B
> takes a
host name or address argument and represents the server that will
be contacted if no <VAR
be contacted if no <CODE
CLASS="option"
>-s</VAR
>-s</CODE
>
option is provided on the command line.
<B
@ -1289,9 +1383,9 @@ CLASS="programlisting"
</PRE
><P
>and it had an identical key statement for
<VAR
<TT
CLASS="literal"
>rndc_key</VAR
>rndc_key</TT
>.</P
><P
>Running the <B

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Advanced DNS Features</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK
@ -261,9 +261,11 @@ CLASS="command"
to the zone using
<B
CLASS="command"
>rndc freeze <VAR
>rndc freeze <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
></B
>.
This will also remove the zone's <TT
@ -273,9 +275,11 @@ CLASS="filename"
and update the master file. Edit the zone file. Run
<B
CLASS="command"
>rndc unfreeze <VAR
>rndc unfreeze <TT
CLASS="replaceable"
>zone</VAR
><I
>zone</I
></TT
></B
>
to reload the changed zone and re-enable dynamic updates.</P
@ -375,9 +379,9 @@ CLASS="emphasis"
>Example, Inc.</I
></SPAN
>
(<VAR
(<TT
CLASS="literal"
>example.com</VAR
>example.com</TT
>)
has several corporate sites that have an internal network with reserved
Internet Protocol (IP) space and an external demilitarized zone (DMZ),
@ -489,9 +493,9 @@ internal hosts.</P
>Here's an example of a wildcard MX record:</P
><PRE
CLASS="programlisting"
><VAR
><TT
CLASS="literal"
>* IN MX 10 external1.example.com.</VAR
>* IN MX 10 external1.example.com.</TT
></PRE
><P
>Now that they accept mail on behalf of anything in the internal
@ -528,24 +532,24 @@ internal clients will now be able to:</P
><UL
><LI
><P
>Look up any hostnames in the <VAR
>Look up any hostnames in the <TT
CLASS="literal"
>site1</VAR
>site1</TT
> and
<VAR
<TT
CLASS="literal"
>site2.example.com</VAR
>site2.example.com</TT
> zones.</P
></LI
><LI
><P
>Look up any hostnames in the <VAR
>Look up any hostnames in the <TT
CLASS="literal"
>site1.internal</VAR
>site1.internal</TT
> and
<VAR
<TT
CLASS="literal"
>site2.internal</VAR
>site2.internal</TT
> domains.</P
></LI
><LI
@ -564,24 +568,24 @@ CLASS="literal"
><UL
><LI
><P
>Look up any hostnames in the <VAR
>Look up any hostnames in the <TT
CLASS="literal"
>site1</VAR
>site1</TT
> and
<VAR
<TT
CLASS="literal"
>site2.example.com</VAR
>site2.example.com</TT
> zones.</P
></LI
><LI
><P
>Exchange mail with anyone in the <VAR
>Exchange mail with anyone in the <TT
CLASS="literal"
>site1</VAR
>site1</TT
> and
<VAR
<TT
CLASS="literal"
>site2.example.com</VAR
>site2.example.com</TT
> zones.</P
></LI
></UL
@ -599,9 +603,9 @@ CLASS="programlisting"
>&#13;
acl internals { 172.16.72.0/24; 192.168.1.0/24; };
acl externals { <VAR
acl externals { <CODE
CLASS="varname"
>bastion-ips-go-here</VAR
>bastion-ips-go-here</CODE
>; };
options {
@ -609,9 +613,9 @@ options {
...
forward only;
forwarders { // forward to external servers
<VAR
<CODE
CLASS="varname"
>bastion-ips-go-here</VAR
>bastion-ips-go-here</CODE
>;
};
allow-transfer { none; }; // sample allow-transfer (no one)
@ -742,13 +746,13 @@ for TSIG.</P
CLASS="command"
>nsupdate</B
>
program supports TSIG via the <VAR
program supports TSIG via the <CODE
CLASS="option"
>-k</VAR
>-k</CODE
> and
<VAR
<CODE
CLASS="option"
>-y</VAR
>-y</CODE
> command line options.</P
><DIV
CLASS="sect2"
@ -799,18 +803,18 @@ CLASS="filename"
>Khost1-host2.+157+00000.private</TT
>.
Nothing directly uses this file, but the base-64 encoded string
following "<VAR
following "<TT
CLASS="literal"
>Key:</VAR
>Key:</TT
>"
can be extracted from the file and used as a shared secret:</P
><PRE
CLASS="programlisting"
>Key: La/E5CjG9O+os1jq0a2jdA==</PRE
><P
>The string "<VAR
>The string "<TT
CLASS="literal"
>La/E5CjG9O+os1jq0a2jdA==</VAR
>La/E5CjG9O+os1jq0a2jdA==</TT
>" can
be used as the shared secret.</P
></DIV
@ -1188,15 +1192,15 @@ CLASS="acronym"
> 9 ships
with several tools
that are used in this process, which are explained in more detail
below. In all cases, the <VAR
below. In all cases, the <CODE
CLASS="option"
>-h</VAR
>-h</CODE
> option prints a
full list of parameters. Note that the DNSSEC tools require the
keyset files to be in the working directory or the
directory specified by the <VAR
directory specified by the <CODE
CLASS="option"
>-h</VAR
>-h</CODE
> option, and
that the tools shipped with BIND 9.2.x and earlier are not compatible
with the current ones.</P
@ -1205,9 +1209,9 @@ CLASS="option"
the parent and/or child zone to transmit keys. A zone's security
status must be indicated by the parent zone for a DNSSEC capable
resolver to trust its data. This is done through the presense
or absence of a <VAR
or absence of a <TT
CLASS="literal"
>DS</VAR
>DS</TT
> record at the delegation
point.</P
><P
@ -1312,24 +1316,24 @@ CLASS="filename"
>keyset</TT
> files corresponding
to secure subzones should be present. The zone signer will
generate <VAR
generate <TT
CLASS="literal"
>NSEC</VAR
> and <VAR
>NSEC</TT
> and <TT
CLASS="literal"
>RRSIG</VAR
>RRSIG</TT
>
records for the zone, as well as <VAR
records for the zone, as well as <TT
CLASS="literal"
>DS</VAR
>DS</TT
> for
the child zones if <VAR
the child zones if <TT
CLASS="literal"
>'-d'</VAR
>'-d'</TT
> is specified.
If <VAR
If <TT
CLASS="literal"
>'-d'</VAR
>'-d'</TT
> is not specified then DS RRsets for
the secure child zones need to be added manually.</P
><P
@ -1363,12 +1367,12 @@ CLASS="command"
> will also produce a
keyset and dsset files and optionally a dlvset file. These
are used to provide the parent zone administators with the
<VAR
<TT
CLASS="literal"
>DNSKEYs</VAR
> (or their corresponding <VAR
>DNSKEYs</TT
> (or their corresponding <TT
CLASS="literal"
>DS</VAR
>DS</TT
>
records) that are the secure entry point to the zone.</P
></DIV
@ -1500,9 +1504,9 @@ host 3600 IN AAAA 2001:db8::1
><P
>It is recommended that IPv4-in-IPv6 mapped addresses not
be used. If a host has an IPv4 address, use an A record, not
a AAAA, with <VAR
a AAAA, with <TT
CLASS="literal"
>::ffff:192.168.42.1</VAR
>::ffff:192.168.42.1</TT
> as the
address.</P
></DIV
@ -1517,15 +1521,15 @@ NAME="AEN1037"
><P
>When looking up an address in nibble format, the address
components are simply reversed, just as in IPv4, and
<VAR
<TT
CLASS="literal"
>ip6.arpa.</VAR
>ip6.arpa.</TT
> is appended to the resulting name.
For example, the following would provide reverse name lookup for
a host with address
<VAR
<TT
CLASS="literal"
>2001:db8::1</VAR
>2001:db8::1</TT
>.</P
><PRE
CLASS="programlisting"

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>The BIND 9 Lightweight Resolver</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK

File diff suppressed because it is too large Load diff

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>BIND 9 Security Considerations</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK
@ -221,9 +221,9 @@ CLASS="emphasis"
(<B
CLASS="command"
>chroot()</B
>) by specifying the "<VAR
>) by specifying the "<CODE
CLASS="option"
>-t</VAR
>-t</CODE
>"
option. This can help improve system security by placing <ACRONYM
CLASS="acronym"
@ -235,12 +235,14 @@ a "sandbox", which will limit the damage done if a server is compromised.</P
CLASS="acronym"
>BIND</ACRONYM
> is the
ability to run the daemon as an unprivileged user ( <VAR
ability to run the daemon as an unprivileged user ( <CODE
CLASS="option"
>-u</VAR
> <VAR
>-u</CODE
> <TT
CLASS="replaceable"
>user</VAR
><I
>user</I
></TT
> ).
We suggest running as an unprivileged user when using the <B
CLASS="command"

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Troubleshooting</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Appendices</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="BIND 9 Administrator Reference Manual"
HREF="Bv9ARM.html"><LINK
@ -591,13 +591,17 @@ Steering Group (IESG). RFCs can be obtained online via FTP at
<A
HREF="ftp://www.isi.edu/in-notes/"
TARGET="_top"
>ftp://www.isi.edu/in-notes/RFC<VAR
>ftp://www.isi.edu/in-notes/RFC<TT
CLASS="replaceable"
>xxx</VAR
><I
>xxx</I
></TT
>.txt</A
> (where <VAR
> (where <TT
CLASS="replaceable"
>xxx</VAR
><I
>xxx</I
></TT
> is
the number of the RFC). RFCs are also available via the Web at
<A

View file

@ -1,11 +1,11 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>BIND 9 Administrator Reference Manual</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="NEXT"
TITLE="Introduction "
HREF="Bv9ARM.ch01.html"></HEAD

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres.html,v 1.5.18.3 2004/08/22 23:53:34 marka Exp $ -->
<!-- $Id: lwres.html,v 1.5.18.4 2005/04/03 03:32:05 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -130,9 +130,9 @@ CLASS="FUNCTION"
functions are all supported. To allow the lwres library to coexist
with system libraries that define functions of the same name,
the library defines these functions with names prefixed by
<VAR
<TT
CLASS="LITERAL"
>lwres_</VAR
>lwres_</TT
>.
To define the standard names, applications must include the
header file
@ -142,9 +142,9 @@ CLASS="FILENAME"
>
which contains macro definitions mapping the standard function names
into
<VAR
<TT
CLASS="LITERAL"
>lwres_</VAR
>lwres_</TT
>
prefixed ones. Operating system vendors who integrate the lwres
library into their base distributions should rename the functions
@ -201,9 +201,9 @@ sequence of actions.</P
CLASS="TYPE"
>lwres_packet_t</SPAN
>,
called <VAR
called <CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
> below.</P
><P
>(2) Set <CODE
@ -293,9 +293,9 @@ CLASS="FUNCTION"
unmarshall it. This returns a <SPAN
CLASS="TYPE"
>lwres_packet_t</SPAN
> (also called <VAR
> (also called <CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
>, below)
as well as a data specific type, such as <SPAN
CLASS="TYPE"

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_buffer.html,v 1.5.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_buffer.html,v 1.5.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_buffer</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -205,9 +205,9 @@ NAME="AEN106"
>These functions provide bounds checked access to a region of memory
where data is being read or written.
They are based on, and similar to, the
<VAR
<TT
CLASS="LITERAL"
>isc_buffer_</VAR
>isc_buffer_</TT
>
functions in the ISC library.</P
><P
@ -317,19 +317,19 @@ initializes the
CLASS="TYPE"
>lwres_buffer_t</SPAN
>
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
and assocates it with the memory region of size
<VAR
<CODE
CLASS="PARAMETER"
>length</VAR
>length</CODE
>
bytes starting at location
<VAR
<CODE
CLASS="PARAMETER"
>base.</VAR
>base.</CODE
></P
><P
><CODE
@ -337,9 +337,9 @@ CLASS="FUNCTION"
>lwres_buffer_invalidate()</CODE
>
marks the buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
as invalid. Invalidating a buffer after use is not required,
but makes it possible to catch its possible accidental use.</P
@ -356,14 +356,14 @@ CLASS="FUNCTION"
>
respectively increase and decrease the used space in
buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
by
<VAR
<CODE
CLASS="PARAMETER"
>n</VAR
>n</CODE
>
bytes.
<CODE
@ -409,9 +409,9 @@ CLASS="FUNCTION"
>lwres_buffer_first</CODE
>
makes the consumed region of buffer
<VAR
<CODE
CLASS="PARAMETER"
>*p</VAR
>*p</CODE
>
empty by setting
<CODE
@ -425,14 +425,14 @@ CLASS="FUNCTION"
>lwres_buffer_forward()</CODE
>
increases the consumed region of buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
by
<VAR
<CODE
CLASS="PARAMETER"
>n</VAR
>n</CODE
>
bytes, checking for overflow.
Similarly,
@ -441,14 +441,14 @@ CLASS="FUNCTION"
>lwres_buffer_back()</CODE
>
decreases buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>'s
consumed region by
<VAR
<CODE
CLASS="PARAMETER"
>n</VAR
>n</CODE
>
bytes and checks for underflow.</P
><P
@ -457,9 +457,9 @@ CLASS="FUNCTION"
>lwres_buffer_getuint8()</CODE
>
reads an unsigned 8-bit integer from
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>
and returns it.
<CODE
@ -467,14 +467,14 @@ CLASS="FUNCTION"
>lwres_buffer_putuint8()</CODE
>
writes the unsigned 8-bit integer
<VAR
<CODE
CLASS="PARAMETER"
>val</VAR
>val</CODE
>
to buffer
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>.</P
><P
><CODE
@ -493,9 +493,9 @@ CLASS="FUNCTION"
>
except that they respectively read an unsigned 16-bit or 32-bit integer
in network byte order from
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>.
Similarly,
<CODE
@ -508,14 +508,14 @@ CLASS="FUNCTION"
>lwres_buffer_putuint32()</CODE
>
writes the unsigned 16-bit or 32-bit integer
<VAR
<CODE
CLASS="PARAMETER"
>val</VAR
>val</CODE
>
to buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>,
in network byte order.</P
><P
@ -536,19 +536,19 @@ CLASS="FUNCTION"
>lwres_buffer_putmem()</CODE
>
copies
<VAR
<CODE
CLASS="PARAMETER"
>length</VAR
>length</CODE
>
bytes of memory at
<VAR
<CODE
CLASS="PARAMETER"
>base</VAR
>base</CODE
>
to
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>.
Conversely,
<CODE
@ -556,19 +556,19 @@ CLASS="FUNCTION"
>lwres_buffer_getmem()</CODE
>
copies
<VAR
<CODE
CLASS="PARAMETER"
>length</VAR
>length</CODE
>
bytes of memory from
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
to
<VAR
<CODE
CLASS="PARAMETER"
>base</VAR
>base</CODE
>.</P
></DIV
></BODY

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_config.html,v 1.5.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_config.html,v 1.5.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_config</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -124,9 +124,9 @@ CLASS="TYPE"
>lwres_conf_t</SPAN
>
structure for lightweight resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>.</P
><P
><CODE
@ -140,9 +140,9 @@ CLASS="TYPE"
>lwres_conf_t</SPAN
>
structure in resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>.</P
><P
><CODE
@ -150,14 +150,14 @@ CLASS="FUNCTION"
>lwres_conf_parse()</CODE
>
opens the file
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>
and parses it to initialise the resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>'s
<SPAN
CLASS="TYPE"
@ -175,18 +175,18 @@ CLASS="TYPE"
>lwres_conf_t</SPAN
>
structure for resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
to the
<SPAN
CLASS="TYPE"
>FILE</SPAN
>
<VAR
<CODE
CLASS="PARAMETER"
>fp</VAR
>fp</CODE
>.</P
></DIV
><DIV
@ -207,9 +207,9 @@ CLASS="ERRORCODE"
>LWRES_R_SUCCESS</SPAN
>
if it successfully read and parsed
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>.
It returns
<SPAN
@ -217,9 +217,9 @@ CLASS="ERRORCODE"
>LWRES_R_FAILURE</SPAN
>
if
<VAR
<CODE
CLASS="PARAMETER"
>filename</VAR
>filename</CODE
>
could not be opened or contained incorrect
resolver statements.</P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_context.html,v 1.7.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_context.html,v 1.7.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_context</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -148,9 +148,9 @@ CLASS="TYPE"
>lwres_context_t</SPAN
>
is returned through
<VAR
<CODE
CLASS="PARAMETER"
>contextp</VAR
>contextp</CODE
>,
a pointer to a
@ -172,25 +172,25 @@ CLASS="TYPE"
><P
>When the lightweight resolver needs to perform dynamic memory
allocation, it will call
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
to allocate memory and
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
to free it. If
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
are NULL, memory is allocated using
@ -205,36 +205,36 @@ CLASS="REFENTRYTITLE"
>.
It is not permitted to have a NULL
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
and a non-NULL
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
or vice versa.
<VAR
<CODE
CLASS="PARAMETER"
>arg</VAR
>arg</CODE
>
is passed as the first parameter to the memory
allocation functions.
If
<VAR
<CODE
CLASS="PARAMETER"
>malloc_function</VAR
>malloc_function</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>free_function</VAR
>free_function</CODE
>
are NULL,
<VAR
<CODE
CLASS="PARAMETER"
>arg</VAR
>arg</CODE
>
is unused and should be passed as NULL.</P
@ -250,9 +250,9 @@ CLASS="REFENTRYTITLE"
>
and returned via
<VAR
<CODE
CLASS="PARAMETER"
>*contextp</VAR
>*contextp</CODE
>.&#13;</P
><P
><CODE
@ -266,9 +266,9 @@ CLASS="TYPE"
>,
closing its socket.
<VAR
<CODE
CLASS="PARAMETER"
>contextp</VAR
>contextp</CODE
>
is a pointer to a pointer to the context that is to be destroyed.
The pointer will be set to NULL when the context has been destroyed.</P
@ -290,14 +290,14 @@ CLASS="FUNCTION"
>lwres_context_initserial()</CODE
>
sets the serial number for context
<VAR
<CODE
CLASS="PARAMETER"
>*ctx</VAR
>*ctx</CODE
>
to
<VAR
<CODE
CLASS="PARAMETER"
>serial</VAR
>serial</CODE
>.
<CODE
@ -327,9 +327,9 @@ CLASS="FUNCTION"
>lwres_context_allocmem()</CODE
>
allocates
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
>
bytes of memory and if successful returns a pointer to the allocated
storage.
@ -338,14 +338,14 @@ CLASS="FUNCTION"
>lwres_context_freemem()</CODE
>
frees
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
>
bytes of space starting at location
<VAR
<CODE
CLASS="PARAMETER"
>mem</VAR
>mem</CODE
>.&#13;</P
><P
><CODE
@ -353,29 +353,29 @@ CLASS="FUNCTION"
>lwres_context_sendrecv()</CODE
>
performs I/O for the context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>.
Data are read and written from the context's socket.
It writes data from
<VAR
<CODE
CLASS="PARAMETER"
>sendbase</VAR
>sendbase</CODE
>
&mdash; typically a lightweight resolver query packet &mdash;
and waits for a reply which is copied to the receive buffer at
<VAR
<CODE
CLASS="PARAMETER"
>recvbase</VAR
>recvbase</CODE
>.
The number of bytes that were written to this receive buffer is
returned in
<VAR
<CODE
CLASS="PARAMETER"
>*recvd_len</VAR
>*recvd_len</CODE
>.&#13;</P
></DIV
><DIV

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gabn.html,v 1.7.18.3 2004/08/22 23:53:35 marka Exp $ -->
<!-- $Id: lwres_gabn.html,v 1.7.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gabn</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -183,32 +183,32 @@ CLASS="FUNCTION"
>lwres_gabnrequest_render()</CODE
>
uses resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
to convert getaddrbyname request structure
<VAR
<CODE
CLASS="PARAMETER"
>req</VAR
>req</CODE
>
to canonical format.
The packet header structure
<VAR
<CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
>
is initialised and transferred to
buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>.
The contents of
<VAR
<CODE
CLASS="PARAMETER"
>*req</VAR
>*req</CODE
>
are then appended to the buffer in canonical format.
<CODE
@ -227,14 +227,14 @@ CLASS="FUNCTION"
>lwres_gabnrequest_parse()</CODE
>
uses context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
to convert the contents of packet
<VAR
<CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
>
to a
<SPAN
@ -243,9 +243,9 @@ CLASS="TYPE"
>
structure.
Buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
provides space to be used for storing this structure.
When the function succeeds, the resulting
@ -254,9 +254,9 @@ CLASS="TYPE"
>lwres_gabnrequest_t</SPAN
>
is made available through
<VAR
<CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.
<CODE
@ -285,9 +285,9 @@ CLASS="FUNCTION"
>lwres_gabnrequest_free()</CODE
>
release the memory in resolver context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
>
that was allocated to the
<SPAN
@ -300,9 +300,9 @@ CLASS="TYPE"
>lwres_gabnrequest_t</SPAN
>
structures referenced via
<VAR
<CODE
CLASS="PARAMETER"
>structp</VAR
>structp</CODE
>.
Any memory associated with ancillary buffers and strings for those
@ -351,9 +351,9 @@ CLASS="ERRORCODE"
>LWRES_R_UNEXPECTEDEND</SPAN
>
is returned if the available space in the buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
is too small to accommodate the packet header or the
<SPAN

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gai_strerror.html,v 1.6.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_gai_strerror.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gai_strerror</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -220,9 +220,9 @@ The message <SPAN
CLASS="ERRORNAME"
>invalid error code</SPAN
> is returned if
<VAR
<CODE
CLASS="PARAMETER"
>ecode</VAR
>ecode</CODE
>
is out of range.</P
><P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getaddrinfo.html,v 1.10.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_getaddrinfo.html,v 1.10.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getaddrinfo</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -116,14 +116,14 @@ CLASS="FUNCTION"
>lwres_getaddrinfo()</CODE
>
is used to get a list of IP addresses and port numbers for host
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
and service
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>.
The function is the lightweight resolver's implementation of
@ -132,14 +132,14 @@ CLASS="FUNCTION"
>getaddrinfo()</CODE
>
as defined in RFC2133.
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>
are pointers to null-terminated
strings or
@ -148,15 +148,15 @@ CLASS="TYPE"
>NULL</SPAN
>.
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
is either a host name or a numeric host address string: a dotted decimal
IPv4 address or an IPv6 address.
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>
is either a decimal port number or a service name as listed in
<TT
@ -164,9 +164,9 @@ CLASS="FILENAME"
>/etc/services</TT
>.</P
><P
><VAR
><CODE
CLASS="PARAMETER"
>hints</VAR
>hints</CODE
>
is an optional pointer to a
<SPAN
@ -176,9 +176,9 @@ CLASS="TYPE"
This structure can be used to provide hints concerning the type of socket
that the caller supports or wishes to use.
The caller can supply the following structure elements in
<VAR
<CODE
CLASS="PARAMETER"
>*hints</VAR
>*hints</CODE
>:
<P
@ -362,9 +362,9 @@ CLASS="REFENTRYTITLE"
if a connectionless protocol was chosen.
The IP address portion of the socket address structure will be
set to the loopback address if
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
is a
<SPAN
@ -393,9 +393,9 @@ CLASS="TYPE"
>AI_NUMERICHOST</SPAN
>
it indicates that
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
should be treated as a numeric string defining an IPv4 or IPv6 address
and no name resolution should be attempted.</P
@ -408,14 +408,14 @@ and no name resolution should be attempted.</P
CLASS="TYPE"
>struct addrinfo</SPAN
> passed
via <VAR
via <CODE
CLASS="PARAMETER"
>hints</VAR
>hints</CODE
> must be zero.</P
><P
>A <VAR
>A <CODE
CLASS="PARAMETER"
>hints</VAR
>hints</CODE
> of <SPAN
CLASS="TYPE"
>NULL</SPAN
@ -438,9 +438,9 @@ CLASS="CONSTANT"
CLASS="FUNCTION"
>lwres_getaddrinfo()</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>*res</VAR
>*res</CODE
>
is a pointer to a linked list of one or more
<SPAN
@ -531,9 +531,9 @@ is released by
CLASS="FUNCTION"
>lwres_freeaddrinfo()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>ai</VAR
>ai</CODE
>
is a pointer to a
<SPAN
@ -568,14 +568,14 @@ CLASS="REFENTRYTITLE"
>
if an error occurs.
If both
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
and
<VAR
<CODE
CLASS="PARAMETER"
>servname</VAR
>servname</CODE
>
are
<SPAN

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gethostent.html,v 1.9.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_gethostent.html,v 1.9.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gethostent</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -319,9 +319,9 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_gethostbyname2()</CODE
> look up the hostname
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>.
<CODE
CLASS="FUNCTION"
@ -331,9 +331,9 @@ address while <CODE
CLASS="FUNCTION"
>lwres_gethostbyname2()</CODE
> looks for an
address of protocol family <VAR
address of protocol family <CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>: either
<SPAN
CLASS="TYPE"
@ -365,17 +365,17 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_gethostbyaddr()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>addr</VAR
>addr</CODE
> is an address of length
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes and protocol family
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
> &mdash; <SPAN
CLASS="TYPE"
>PF_INET</SPAN
@ -389,13 +389,13 @@ CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
> is a thread-safe function
for forward lookups. If an error occurs, an error code is returned in
<VAR
<CODE
CLASS="PARAMETER"
>*error</VAR
>*error</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
> is a pointer to a <SPAN
CLASS="TYPE"
>struct
@ -405,13 +405,13 @@ hostent</SPAN
CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
> .
<VAR
<CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
> is a buffer of length
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes which is used to store the
<CODE
CLASS="CONSTANT"
@ -427,17 +427,17 @@ CLASS="CONSTANT"
CLASS="TYPE"
>struct
hostent</SPAN
> returned in <VAR
> returned in <CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>.
Successful calls to <CODE
CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
>
return <VAR
return <CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>,
which is a pointer to the <SPAN
CLASS="TYPE"
@ -448,17 +448,17 @@ CLASS="TYPE"
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
> is a thread-safe function
that performs a reverse lookup of address <VAR
that performs a reverse lookup of address <CODE
CLASS="PARAMETER"
>addr</VAR
>addr</CODE
>
which is <VAR
which is <CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes long and is of protocol
family <VAR
family <CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
> &mdash; <SPAN
CLASS="TYPE"
>PF_INET</SPAN
@ -467,17 +467,17 @@ CLASS="TYPE"
CLASS="TYPE"
>PF_INET6</SPAN
>. If an error occurs, the error code is returned
in <VAR
in <CODE
CLASS="PARAMETER"
>*error</VAR
>*error</CODE
>. The other function parameters are
identical to those in <CODE
CLASS="FUNCTION"
>lwres_gethostbyname_r()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
> is a pointer to a <SPAN
CLASS="TYPE"
>struct
@ -487,13 +487,13 @@ hostent</SPAN
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
> is a buffer of length
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
> bytes which is used to store the
<CODE
CLASS="CONSTANT"
@ -509,17 +509,17 @@ CLASS="CONSTANT"
CLASS="TYPE"
>struct
hostent</SPAN
> returned in <VAR
> returned in <CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>. Successful
calls to <CODE
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
> return
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>, which is a pointer to the
<CODE
CLASS="FUNCTION"
@ -645,9 +645,9 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_gethostbyaddr_r()</CODE
> return
<VAR
<CODE
CLASS="PARAMETER"
>resbuf</VAR
>resbuf</CODE
>, a pointer to the <SPAN
CLASS="TYPE"
>struct
@ -656,9 +656,9 @@ hostent</SPAN
<SPAN
CLASS="TYPE"
>NULL</SPAN
> if the lookups fail or if <VAR
> if the lookups fail or if <CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
>
was too small to hold the list of addresses and names referenced by
the <CODE
@ -675,9 +675,9 @@ CLASS="CONSTANT"
CLASS="TYPE"
>struct
hostent</SPAN
>. If <VAR
>. If <CODE
CLASS="PARAMETER"
>buf</VAR
>buf</CODE
> was too small, both
<CODE
CLASS="FUNCTION"

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getipnode.html,v 1.9.18.3 2004/08/22 23:53:36 marka Exp $ -->
<!-- $Id: lwres_getipnode.html,v 1.9.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getipnode</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -199,21 +199,21 @@ CLASS="FUNCTION"
>lwres_getipnodebyname()</CODE
>
looks up addresses of protocol family
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
for the hostname
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>.
The
<VAR
<CODE
CLASS="PARAMETER"
>flags</VAR
>flags</CODE
>
parameter contains ORed flag bits to
specify the types of addresses that are searched
@ -232,9 +232,9 @@ CLASS="CONSTANT"
><DD
><P
>This is used with an
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
of AF_INET6, and causes IPv4 addresses to be returned as IPv4-mapped
IPv6 addresses.</P
@ -247,9 +247,9 @@ CLASS="CONSTANT"
><DD
><P
>This is used with an
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
of AF_INET6, and causes all known addresses (IPv6 and IPv4) to be returned.
If AI_V4MAPPED is also set, the IPv4 addresses are return as mapped
@ -295,19 +295,19 @@ CLASS="FUNCTION"
>
performs a reverse lookup
of address
<VAR
<CODE
CLASS="PARAMETER"
>src</VAR
>src</CODE
>
which is
<VAR
<CODE
CLASS="PARAMETER"
>len</VAR
>len</CODE
>
bytes long.
<VAR
<CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
>
denotes the protocol family, typically
<SPAN
@ -331,9 +331,9 @@ CLASS="TYPE"
>struct hostent</SPAN
>
pointer
<VAR
<CODE
CLASS="PARAMETER"
>he</VAR
>he</CODE
>.
Any memory allocated for the
@ -377,9 +377,9 @@ CLASS="FUNCTION"
>lwres_getipnodebyaddr()</CODE
>
set
<VAR
<CODE
CLASS="PARAMETER"
>*error_num</VAR
>*error_num</CODE
>
to an appropriate error code and the function returns a
<SPAN

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getnameinfo.html,v 1.6.18.3 2004/08/22 23:53:37 marka Exp $ -->
<!-- $Id: lwres_getnameinfo.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getnameinfo</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -96,21 +96,21 @@ CLASS="FUNCTION"
<SPAN
CLASS="TYPE"
>struct sockaddr</SPAN
> <VAR
> <CODE
CLASS="PARAMETER"
>sa</VAR
>sa</CODE
> which is
<VAR
<CODE
CLASS="PARAMETER"
>salen</VAR
>salen</CODE
> bytes long. The hostname is of length
<VAR
<CODE
CLASS="PARAMETER"
>hostlen</VAR
>hostlen</CODE
> and is returned via
<VAR
<CODE
CLASS="PARAMETER"
>*host.</VAR
>*host.</CODE
> The maximum length of the hostname is
1025 bytes: <CODE
CLASS="CONSTANT"
@ -118,25 +118,25 @@ CLASS="CONSTANT"
>.</P
><P
> The name of the service associated with the port number in
<VAR
<CODE
CLASS="PARAMETER"
>sa</VAR
> is returned in <VAR
>sa</CODE
> is returned in <CODE
CLASS="PARAMETER"
>*serv.</VAR
>*serv.</CODE
>
It is <VAR
It is <CODE
CLASS="PARAMETER"
>servlen</VAR
>servlen</CODE
> bytes long. The maximum length
of the service name is <CODE
CLASS="CONSTANT"
>NI_MAXSERV</CODE
> - 32 bytes.</P
><P
> The <VAR
> The <CODE
CLASS="PARAMETER"
>flags</VAR
>flags</CODE
> argument sets the following
bits:
<P

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_getrrsetbyname.html,v 1.6.18.3 2004/08/22 23:53:37 marka Exp $ -->
<!-- $Id: lwres_getrrsetbyname.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_getrrsetbyname</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -116,31 +116,31 @@ CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>
gets a set of resource records associated with a
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>class</VAR
>class</CODE
>,
and
<VAR
<CODE
CLASS="PARAMETER"
>type</VAR
>type</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>hostname</VAR
>hostname</CODE
>
is
a pointer a to null-terminated string. The
<VAR
<CODE
CLASS="PARAMETER"
>flags</VAR
>flags</CODE
>
field is currently unused and must be zero.</P
><P
@ -150,9 +150,9 @@ CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>,
<VAR
<CODE
CLASS="PARAMETER"
>*res</VAR
>*res</CODE
>
is a pointer to an
<SPAN
@ -245,9 +245,9 @@ CLASS="FUNCTION"
>lwres_freerrset()</CODE
>.
<VAR
<CODE
CLASS="PARAMETER"
>rrset</VAR
>rrset</CODE
>
is a pointer to a
<SPAN

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_gnba.html,v 1.7.18.3 2004/08/22 23:53:37 marka Exp $ -->
<!-- $Id: lwres_gnba.html,v 1.7.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_gnba</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -176,31 +176,31 @@ CLASS="FUNCTION"
>lwres_gnbarequest_render()</CODE
>
uses resolver context
<VAR
<CODE
CLASS="VARNAME"
>ctx</VAR
>ctx</CODE
>
to convert getnamebyaddr request structure
<VAR
<CODE
CLASS="VARNAME"
>req</VAR
>req</CODE
>
to canonical format.
The packet header structure
<VAR
<CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
>
is initialised and transferred to
buffer
<VAR
<CODE
CLASS="VARNAME"
>b</VAR
>b</CODE
>.
The contents of
<VAR
<CODE
CLASS="VARNAME"
>*req</VAR
>*req</CODE
>
are then appended to the buffer in canonical format.
<CODE
@ -219,14 +219,14 @@ CLASS="FUNCTION"
>lwres_gnbarequest_parse()</CODE
>
uses context
<VAR
<CODE
CLASS="VARNAME"
>ctx</VAR
>ctx</CODE
>
to convert the contents of packet
<VAR
<CODE
CLASS="VARNAME"
>pkt</VAR
>pkt</CODE
>
to a
<SPAN
@ -235,9 +235,9 @@ CLASS="TYPE"
>
structure.
Buffer
<VAR
<CODE
CLASS="VARNAME"
>b</VAR
>b</CODE
>
provides space to be used for storing this structure.
When the function succeeds, the resulting
@ -246,9 +246,9 @@ CLASS="TYPE"
>lwres_gnbarequest_t</SPAN
>
is made available through
<VAR
<CODE
CLASS="VARNAME"
>*structp</VAR
>*structp</CODE
>.
<CODE
CLASS="FUNCTION"
@ -276,9 +276,9 @@ CLASS="FUNCTION"
>lwres_gnbarequest_free()</CODE
>
release the memory in resolver context
<VAR
<CODE
CLASS="VARNAME"
>ctx</VAR
>ctx</CODE
>
that was allocated to the
<SPAN
@ -291,9 +291,9 @@ CLASS="TYPE"
>lwres_gnbarequest_t</SPAN
>
structures referenced via
<VAR
<CODE
CLASS="VARNAME"
>structp</VAR
>structp</CODE
>.
Any memory associated with ancillary buffers and strings for those
structures is also discarded.</P
@ -341,9 +341,9 @@ CLASS="ERRORCODE"
>LWRES_R_UNEXPECTEDEND</SPAN
>
is returned if the available space in the buffer
<VAR
<CODE
CLASS="VARNAME"
>b</VAR
>b</CODE
>
is too small to accommodate the packet header or the
<SPAN

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_hstrerror.html,v 1.6.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_hstrerror.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_hstrerror</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -94,9 +94,9 @@ NAME="AEN23"
CLASS="FUNCTION"
>lwres_herror()</CODE
> prints the string
<VAR
<CODE
CLASS="PARAMETER"
>s</VAR
>s</CODE
> on <SPAN
CLASS="TYPE"
>stderr</SPAN
@ -114,9 +114,9 @@ CLASS="CONSTANT"
CLASS="FUNCTION"
>lwres_hstrerror()</CODE
> returns an appropriate string
for the error code gievn by <VAR
for the error code gievn by <CODE
CLASS="PARAMETER"
>err</VAR
>err</CODE
>. The values of
the error codes and messages are as follows:

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_inetntop.html,v 1.6.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_inetntop.html,v 1.6.18.4 2005/04/03 03:32:06 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_inetntop</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -86,25 +86,25 @@ NAME="AEN21"
CLASS="FUNCTION"
>lwres_net_ntop()</CODE
> converts an IP address of
protocol family <VAR
protocol family <CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
> &mdash; IPv4 or IPv6 &mdash;
at location <VAR
at location <CODE
CLASS="PARAMETER"
>src</VAR
>src</CODE
> from network format to its
conventional representation as a string. For IPv4 addresses, that
string would be a dotted-decimal. An IPv6 address would be
represented in colon notation as described in RFC1884.</P
><P
>The generated string is copied to <VAR
>The generated string is copied to <CODE
CLASS="PARAMETER"
>dst</VAR
>dst</CODE
> provided
<VAR
<CODE
CLASS="PARAMETER"
>size</VAR
>size</CODE
> indicates it is long enough to store the
ASCII representation of the address.</P
></DIV
@ -116,9 +116,9 @@ NAME="AEN30"
><H2
>RETURN VALUES</H2
><P
>If successful, the function returns <VAR
>If successful, the function returns <CODE
CLASS="PARAMETER"
>dst</VAR
>dst</CODE
>:
a pointer to a string containing the presentation format of the
address. <CODE
@ -136,9 +136,9 @@ CLASS="CONSTANT"
CLASS="ERRORCODE"
>EAFNOSUPPORT</SPAN
> if
the protocol family given in <VAR
the protocol family given in <CODE
CLASS="PARAMETER"
>af</VAR
>af</CODE
> is not
supported.</P
></DIV

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_noop.html,v 1.8.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_noop.html,v 1.8.18.4 2005/04/03 03:32:07 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_noop</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -180,25 +180,25 @@ the response is therefore identical to the request.</P
CLASS="FUNCTION"
>lwres_nooprequest_render()</CODE
> uses resolver
context <VAR
context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> to convert no-op request structure
<VAR
<CODE
CLASS="PARAMETER"
>req</VAR
>req</CODE
> to canonical format. The packet header
structure <VAR
structure <CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
> is initialised and transferred to
buffer <VAR
buffer <CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>. The contents of
<VAR
<CODE
CLASS="PARAMETER"
>*req</VAR
>*req</CODE
> are then appended to the buffer in
canonical format. <CODE
CLASS="FUNCTION"
@ -215,29 +215,29 @@ canonical format.</P
CLASS="FUNCTION"
>lwres_nooprequest_parse()</CODE
> uses context
<VAR
<CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> to convert the contents of packet
<VAR
<CODE
CLASS="PARAMETER"
>pkt</VAR
>pkt</CODE
> to a <SPAN
CLASS="TYPE"
>lwres_nooprequest_t</SPAN
>
structure. Buffer <VAR
structure. Buffer <CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
> provides space to be used
for storing this structure. When the function succeeds, the resulting
<SPAN
CLASS="TYPE"
>lwres_nooprequest_t</SPAN
> is made available through
<VAR
<CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.
<CODE
CLASS="FUNCTION"
@ -260,9 +260,9 @@ CLASS="FUNCTION"
CLASS="FUNCTION"
>lwres_nooprequest_free()</CODE
> release the memory in
resolver context <VAR
resolver context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> that was allocated to the
<SPAN
CLASS="TYPE"
@ -271,9 +271,9 @@ CLASS="TYPE"
CLASS="TYPE"
>lwres_nooprequest_t</SPAN
>
structures referenced via <VAR
structures referenced via <CODE
CLASS="PARAMETER"
>structp</VAR
>structp</CODE
>.</P
></DIV
><DIV
@ -320,9 +320,9 @@ CLASS="ERRORCODE"
>LWRES_R_UNEXPECTEDEND</SPAN
>
is returned if the available space in the buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>
is too small to accommodate the packet header or the
<SPAN

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_packet.html,v 1.9.18.3 2004/08/22 23:53:38 marka Exp $ -->
<!-- $Id: lwres_packet.html,v 1.9.18.4 2005/04/03 03:32:07 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_packet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -291,14 +291,14 @@ contents of lightweight resolver packet structure
<SPAN
CLASS="TYPE"
>lwres_lwpacket_t</SPAN
> <VAR
> <CODE
CLASS="PARAMETER"
>*pkt</VAR
>*pkt</CODE
> in network
byte order to the lightweight resolver buffer,
<VAR
<CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
>.</P
><P
><CODE
@ -306,17 +306,17 @@ CLASS="FUNCTION"
>lwres_lwpacket_parseheader()</CODE
> performs the
converse operation. It transfers data in network byte order from
buffer <VAR
buffer <CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
> to resolver packet
<VAR
<CODE
CLASS="PARAMETER"
>*pkt</VAR
>*pkt</CODE
>. The contents of the buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
> should correspond to a
<SPAN
CLASS="TYPE"
@ -344,13 +344,13 @@ CLASS="FUNCTION"
CLASS="ERRORCODE"
>LWRES_R_SUCCESS</SPAN
>. If there is insufficient
space to copy data between the buffer <VAR
space to copy data between the buffer <CODE
CLASS="PARAMETER"
>*b</VAR
>*b</CODE
> and
lightweight resolver packet <VAR
lightweight resolver packet <CODE
CLASS="PARAMETER"
>*pkt</VAR
>*pkt</CODE
> both functions
return <SPAN
CLASS="ERRORCODE"

View file

@ -15,16 +15,16 @@
- PERFORMANCE OF THIS SOFTWARE.
-->
<!-- $Id: lwres_resutil.html,v 1.9.18.3 2004/08/22 23:53:39 marka Exp $ -->
<!-- $Id: lwres_resutil.html,v 1.9.18.4 2005/04/03 03:32:07 marka Exp $ -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>lwres_resutil</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
@ -111,21 +111,21 @@ CLASS="FUNCTION"
>lwres_string_parse()</CODE
> retrieves a DNS-encoded
string starting the current pointer of lightweight resolver buffer
<VAR
<CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>: i.e. <CODE
CLASS="CONSTANT"
>b-&gt;current</CODE
>.
When the function returns, the address of the first byte of the
encoded string is returned via <VAR
encoded string is returned via <CODE
CLASS="PARAMETER"
>*c</VAR
>*c</CODE
> and the
length of that string is given by <VAR
length of that string is given by <CODE
CLASS="PARAMETER"
>*len</VAR
>*len</CODE
>. The
buffer's current pointer is advanced to point at the character
following the string length, the encoded string, and the trailing
@ -138,9 +138,9 @@ CLASS="TYPE"
CLASS="FUNCTION"
>lwres_addr_parse()</CODE
> extracts an address from the
buffer <VAR
buffer <CODE
CLASS="PARAMETER"
>b</VAR
>b</CODE
>. The buffer's current pointer
<CODE
CLASS="CONSTANT"
@ -209,17 +209,17 @@ functions.</P
CLASS="FUNCTION"
>lwres_getaddrsbyname()</CODE
> to perform foward lookups.
Hostname <VAR
Hostname <CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
> is looked up using the resolver
context <VAR
context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> for memory allocation.
<VAR
<CODE
CLASS="PARAMETER"
>addrtypes</VAR
>addrtypes</CODE
> is a bitmask indicating which type of
addresses are to be looked up. Current values for this bitmask are
<SPAN
@ -230,23 +230,23 @@ CLASS="TYPE"
CLASS="TYPE"
>LWRES_ADDRTYPE_V6</SPAN
> for IPv6 addresses. Results of the
lookup are returned in <VAR
lookup are returned in <CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.</P
><P
><CODE
CLASS="FUNCTION"
>lwres_getnamebyaddr()</CODE
> performs reverse lookups.
Resolver context <VAR
Resolver context <CODE
CLASS="PARAMETER"
>ctx</VAR
>ctx</CODE
> is used for memory
allocation. The address type is indicated by
<VAR
<CODE
CLASS="PARAMETER"
>addrtype</VAR
>addrtype</CODE
>: <SPAN
CLASS="TYPE"
>LWRES_ADDRTYPE_V4</SPAN
@ -255,17 +255,17 @@ CLASS="TYPE"
CLASS="TYPE"
>LWRES_ADDRTYPE_V6</SPAN
>. The address to be looked up is given
by <VAR
by <CODE
CLASS="PARAMETER"
>addr</VAR
>addr</CODE
> and its length is
<VAR
<CODE
CLASS="PARAMETER"
>addrlen</VAR
>addrlen</CODE
> bytes. The result of the function call
is made available through <VAR
is made available through <CODE
CLASS="PARAMETER"
>*structp</VAR
>*structp</CODE
>.</P
></DIV
><DIV
@ -319,9 +319,9 @@ CLASS="ERRORCODE"
>LWRES_R_NOTFOUND</SPAN
>
if the hostname
<VAR
<CODE
CLASS="PARAMETER"
>name</VAR
>name</CODE
>
could not be found.</P
><P