diff options
117 files changed, 5654 insertions, 3550 deletions
@@ -1,4 +1,21 @@ + --- 9.3.2b2 released --- + +1930. [port] HPUX: ia64 support. [RT #15473] + +1929. [port] FreeBSD: extend use of PTHREAD_SCOPE_SYSTEM. + +1926. [bug] The Windows installer did not check for empty + passwords. BINDinstall was being installed in + the wrong place. [RT #15483] + +1925. [port] All outer level AC_TRY_RUNs need cross compiling + defaults. [RT #15469] + +1924. [port] libbind: hpux ia64 support. [RT #15473] + +1923. [bug] ns_client_detach() called too early. [RT #15499] + --- 9.3.2b1 released --- 1917. [doc] funcsynopsisinfo wasn't being treated as verbatim diff --git a/bin/check/named-checkconf.8 b/bin/check/named-checkconf.8 index 40bcc222..68b745ae 100644 --- a/bin/check/named-checkconf.8 +++ b/bin/check/named-checkconf.8 @@ -13,60 +13,58 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: named-checkconf.8,v 1.11.12.6 2005/05/12 23:56:53 sra Exp $ +.\" $Id: named-checkconf.8,v 1.11.12.7 2005/10/13 02:33:41 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "NAMED-CHECKCONF" 8 "June 14, 2000" "" "" -.SH NAME -named-checkconf \- named configuration file syntax checking tool +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "NAMED\-CHECKCONF" "8" "June 14, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +named\-checkconf \- named configuration file syntax checking tool .SH "SYNOPSIS" .HP 16 -\fBnamed\-checkconf\fR [\fB\-v\fR] [\fB\-j\fR] [\fB\-t\ \fIdirectory\fR\fR] {filename} [\fB\-z\fR] +\fBnamed\-checkconf\fR [\fB\-v\fR] [\fB\-j\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] {filename} [\fB\-z\fR] .SH "DESCRIPTION" .PP - \fBnamed\-checkconf\fR checks the syntax, but not the semantics, of a named configuration file\&. +\fBnamed\-checkconf\fR +checks the syntax, but not the semantics, of a named configuration file. .SH "OPTIONS" .TP \-t \fIdirectory\fR -chroot to \fIdirectory\fR so that include directives in the configuration file are processed as if run by a similarly chrooted named\&. +chroot to +\fIdirectory\fR +so that include directives in the configuration file are processed as if run by a similarly chrooted named. .TP \-v -Print the version of the \fBnamed\-checkconf\fR program and exit\&. +Print the version of the +\fBnamed\-checkconf\fR +program and exit. .TP \-z -Perform a check load the master zonefiles found in \fInamed\&.conf\fR\&. +Perform a check load the master zonefiles found in +\fInamed.conf\fR. .TP \-j -When loading a zonefile read the journal if it exists\&. +When loading a zonefile read the journal if it exists. .TP filename -The name of the configuration file to be checked\&. If not specified, it defaults to \fI/etc/named\&.conf\fR\&. +The name of the configuration file to be checked. If not specified, it defaults to +\fI/etc/named.conf\fR. .SH "RETURN VALUES" .PP - \fBnamed\-checkconf\fR returns an exit status of 1 if errors were detected and 0 otherwise\&. +\fBnamed\-checkconf\fR +returns an exit status of 1 if errors were detected and 0 otherwise. .SH "SEE ALSO" .PP - \fBnamed\fR(8), BIND 9 Administrator Reference Manual\&. +\fBnamed\fR(8), +BIND 9 Administrator Reference Manual. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/check/named-checkconf.html b/bin/check/named-checkconf.html index 7db38bef..14b8ff89 100644 --- a/bin/check/named-checkconf.html +++ b/bin/check/named-checkconf.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: named-checkconf.html,v 1.5.2.1.4.10 2005/07/18 02:36:43 marka Exp $ --> +<!-- $Id: named-checkconf.html,v 1.5.2.1.4.12 2005/10/13 02:33:42 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>named-checkconf</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">named-checkconf</span> — named configuration file syntax checking tool</p> @@ -32,14 +32,14 @@ <div class="cmdsynopsis"><p><code class="command">named-checkconf</code> [<code class="option">-v</code>] [<code class="option">-j</code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] {filename} [<code class="option">-z</code>]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514548"></a><h2>DESCRIPTION</h2> +<a name="id2525865"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">named-checkconf</strong></span> checks the syntax, but not the semantics, of a named configuration file. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514561"></a><h2>OPTIONS</h2> +<a name="id2525878"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-t <em class="replaceable"><code>directory</code></em></span></dt> <dd><p> @@ -69,21 +69,21 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2514721"></a><h2>RETURN VALUES</h2> +<a name="id2525970"></a><h2>RETURN VALUES</h2> <p> <span><strong class="command">named-checkconf</strong></span> returns an exit status of 1 if errors were detected and 0 otherwise. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514733"></a><h2>SEE ALSO</h2> +<a name="id2525982"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>, <em class="citetitle">BIND 9 Administrator Reference Manual</em>. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514825"></a><h2>AUTHOR</h2> +<a name="id2526006"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/check/named-checkzone.8 b/bin/check/named-checkzone.8 index d899c534..33402d5f 100644 --- a/bin/check/named-checkzone.8 +++ b/bin/check/named-checkzone.8 @@ -13,84 +13,99 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: named-checkzone.8,v 1.11.2.1.8.7 2005/05/12 23:56:53 sra Exp $ +.\" $Id: named-checkzone.8,v 1.11.2.1.8.8 2005/10/13 02:33:41 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "NAMED-CHECKZONE" 8 "June 13, 2000" "" "" -.SH NAME -named-checkzone \- zone file validity checking tool +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "NAMED\-CHECKZONE" "8" "June 13, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +named\-checkzone \- zone file validity checking tool .SH "SYNOPSIS" .HP 16 -\fBnamed\-checkzone\fR [\fB\-d\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fIclass\fR\fR] [\fB\-k\ \fImode\fR\fR] [\fB\-n\ \fImode\fR\fR] [\fB\-o\ \fIfilename\fR\fR] [\fB\-t\ \fIdirectory\fR\fR] [\fB\-w\ \fIdirectory\fR\fR] [\fB\-D\fR] {zonename} {filename} +\fBnamed\-checkzone\fR [\fB\-d\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-k\ \fR\fB\fImode\fR\fR] [\fB\-n\ \fR\fB\fImode\fR\fR] [\fB\-o\ \fR\fB\fIfilename\fR\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-w\ \fR\fB\fIdirectory\fR\fR] [\fB\-D\fR] {zonename} {filename} .SH "DESCRIPTION" .PP - \fBnamed\-checkzone\fR checks the syntax and integrity of a zone file\&. It performs the same checks as \fBnamed\fR does when loading a zone\&. This makes\fBnamed\-checkzone\fR useful for checking zone files before configuring them into a name server\&. +\fBnamed\-checkzone\fR +checks the syntax and integrity of a zone file. It performs the same checks as +\fBnamed\fR +does when loading a zone. This makes +\fBnamed\-checkzone\fR +useful for checking zone files before configuring them into a name server. .SH "OPTIONS" .TP \-d -Enable debugging\&. +Enable debugging. .TP \-q -Quiet mode \- exit code only\&. +Quiet mode \- exit code only. .TP \-v -Print the version of the \fBnamed\-checkzone\fR program and exit\&. +Print the version of the +\fBnamed\-checkzone\fR +program and exit. .TP \-j -When loading the zone file read the journal if it exists\&. +When loading the zone file read the journal if it exists. .TP \-c \fIclass\fR -Specify the class of the zone\&. If not specified "IN" is assumed\&. +Specify the class of the zone. If not specified "IN" is assumed. .TP \-k \fImode\fR -Perform \fB"check\-name"\fR checks with the specified failure mode\&. Possible modes are \fB"fail"\fR, \fB"warn"\fR (default) and \fB"ignore"\fR\&. +Perform +\fB"check\-name"\fR +checks with the specified failure mode. Possible modes are +\fB"fail"\fR, +\fB"warn"\fR +(default) and +\fB"ignore"\fR. .TP \-n \fImode\fR -Specify whether NS records should be checked to see if they are addresses\&. Possible modes are \fB"fail"\fR, \fB"warn"\fR (default) and \fB"ignore"\fR\&. +Specify whether NS records should be checked to see if they are addresses. Possible modes are +\fB"fail"\fR, +\fB"warn"\fR +(default) and +\fB"ignore"\fR. .TP \-o \fIfilename\fR -Write zone output to \fIfilename\fR\&. +Write zone output to +\fIfilename\fR. .TP \-t \fIdirectory\fR -chroot to \fIdirectory\fR so that include directives in the configuration file are processed as if run by a similarly chrooted named\&. +chroot to +\fIdirectory\fR +so that include directives in the configuration file are processed as if run by a similarly chrooted named. .TP \-w \fIdirectory\fR -chdir to \fIdirectory\fR so that relative filenames in master file $INCLUDE directives work\&. This is similar to the directory clause in \fInamed\&.conf\fR\&. +chdir to +\fIdirectory\fR +so that relative filenames in master file $INCLUDE directives work. This is similar to the directory clause in +\fInamed.conf\fR. .TP \-D -Dump zone file in canonical format\&. +Dump zone file in canonical format. .TP zonename -The domain name of the zone being checked\&. +The domain name of the zone being checked. .TP filename -The name of the zone file\&. +The name of the zone file. .SH "RETURN VALUES" .PP - \fBnamed\-checkzone\fR returns an exit status of 1 if errors were detected and 0 otherwise\&. +\fBnamed\-checkzone\fR +returns an exit status of 1 if errors were detected and 0 otherwise. .SH "SEE ALSO" .PP - \fBnamed\fR(8), RFC 1035, BIND 9 Administrator Reference Manual\&. +\fBnamed\fR(8), +RFC 1035, +BIND 9 Administrator Reference Manual. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/check/named-checkzone.html b/bin/check/named-checkzone.html index 99507c46..cf544c94 100644 --- a/bin/check/named-checkzone.html +++ b/bin/check/named-checkzone.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: named-checkzone.html,v 1.5.2.2.4.12 2005/07/18 02:36:43 marka Exp $ --> +<!-- $Id: named-checkzone.html,v 1.5.2.2.4.13 2005/10/13 02:33:42 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>named-checkzone</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">named-checkzone</span> — zone file validity checking tool</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">named-checkzone</code> [<code class="option">-d</code>] [<code class="option">-j</code>] [<code class="option">-q</code>] [<code class="option">-v</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-k <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-n <em class="replaceable"><code>mode</code></em></code>] [<code class="option">-o <em class="replaceable"><code>filename</code></em></code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-w <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-D</code>] {zonename} {filename}</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514673"></a><h2>DESCRIPTION</h2> +<a name="id2525922"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">named-checkzone</strong></span> checks the syntax and integrity of a zone file. It performs the same checks as <span><strong class="command">named</strong></span> @@ -42,7 +42,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514693"></a><h2>OPTIONS</h2> +<a name="id2525942"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-d</span></dt> <dd><p> @@ -111,14 +111,14 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515006"></a><h2>RETURN VALUES</h2> +<a name="id2526187"></a><h2>RETURN VALUES</h2> <p> <span><strong class="command">named-checkzone</strong></span> returns an exit status of 1 if errors were detected and 0 otherwise. </p> </div> <div class="refsect1" lang="en"> -<a name="id2515019"></a><h2>SEE ALSO</h2> +<a name="id2526200"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>, <em class="citetitle">RFC 1035</em>, @@ -126,7 +126,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515046"></a><h2>AUTHOR</h2> +<a name="id2526227"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/dig/dig.1 b/bin/dig/dig.1 index 92ac6777..7031217d 100644 --- a/bin/dig/dig.1 +++ b/bin/dig/dig.1 @@ -13,223 +13,411 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: dig.1,v 1.14.2.4.2.9 2005/08/30 02:34:59 marka Exp $ +.\" $Id: dig.1,v 1.14.2.4.2.10 2005/10/13 02:33:42 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "DIG" 1 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "DIG" "1" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" dig \- DNS lookup utility .SH "SYNOPSIS" .HP 4 -\fBdig\fR [@server] [\fB\-b\ \fIaddress\fR\fR] [\fB\-c\ \fIclass\fR\fR] [\fB\-f\ \fIfilename\fR\fR] [\fB\-k\ \fIfilename\fR\fR] [\fB\-p\ \fIport#\fR\fR] [\fB\-t\ \fItype\fR\fR] [\fB\-x\ \fIaddr\fR\fR] [\fB\-y\ \fIname:key\fR\fR] [\fB\-4\fR] [\fB\-6\fR] [name] [type] [class] [queryopt...] +\fBdig\fR [@server] [\fB\-b\ \fR\fB\fIaddress\fR\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-f\ \fR\fB\fIfilename\fR\fR] [\fB\-k\ \fR\fB\fIfilename\fR\fR] [\fB\-p\ \fR\fB\fIport#\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-x\ \fR\fB\fIaddr\fR\fR] [\fB\-y\ \fR\fB\fIname:key\fR\fR] [\fB\-4\fR] [\fB\-6\fR] [name] [type] [class] [queryopt...] .HP 4 \fBdig\fR [\fB\-h\fR] .HP 4 \fBdig\fR [global\-queryopt...] [query...] .SH "DESCRIPTION" .PP - \fBdig\fR (domain information groper) is a flexible tool for interrogating DNS name servers\&. It performs DNS lookups and displays the answers that are returned from the name server(s) that were queried\&. Most DNS administrators use \fBdig\fR to troubleshoot DNS problems because of its flexibility, ease of use and clarity of output\&. Other lookup tools tend to have less functionality than \fBdig\fR\&. +\fBdig\fR +(domain information groper) is a flexible tool for interrogating DNS name servers. It performs DNS lookups and displays the answers that are returned from the name server(s) that were queried. Most DNS administrators use +\fBdig\fR +to troubleshoot DNS problems because of its flexibility, ease of use and clarity of output. Other lookup tools tend to have less functionality than +\fBdig\fR. .PP -Although \fBdig\fR is normally used with command\-line arguments, it also has a batch mode of operation for reading lookup requests from a file\&. A brief summary of its command\-line arguments and options is printed when the \fB\-h\fR option is given\&. Unlike earlier versions, the BIND9 implementation of \fBdig\fR allows multiple lookups to be issued from the command line\&. +Although +\fBdig\fR +is normally used with command\-line arguments, it also has a batch mode of operation for reading lookup requests from a file. A brief summary of its command\-line arguments and options is printed when the +\fB\-h\fR +option is given. Unlike earlier versions, the BIND9 implementation of +\fBdig\fR +allows multiple lookups to be issued from the command line. .PP -Unless it is told to query a specific name server, \fBdig\fR will try each of the servers listed in \fI/etc/resolv\&.conf\fR\&. +Unless it is told to query a specific name server, +\fBdig\fR +will try each of the servers listed in +\fI/etc/resolv.conf\fR. .PP -When no command line arguments or options are given, will perform an NS query for "\&." (the root)\&. +When no command line arguments or options are given, will perform an NS query for "." (the root). .PP -It is possible to set per\-user defaults for \fBdig\fR via \fI${HOME}/\&.digrc\fR\&. This file is read and any options in it are applied before the command line arguments\&. +It is possible to set per\-user defaults for +\fBdig\fR +via +\fI${HOME}/.digrc\fR. This file is read and any options in it are applied before the command line arguments. .SH "SIMPLE USAGE" .PP -A typical invocation of \fBdig\fR looks like: +A typical invocation of +\fBdig\fR +looks like: +.sp .nf dig @server name type .fi - where: +.sp +where: .TP \fBserver\fR -is the name or IP address of the name server to query\&. This can be an IPv4 address in dotted\-decimal notation or an IPv6 address in colon\-delimited notation\&. When the supplied \fIserver\fR argument is a hostname, \fBdig\fR resolves that name before querying that name server\&. If no \fIserver\fR argument is provided, \fBdig\fR consults \fI/etc/resolv\&.conf\fR and queries the name servers listed there\&. The reply from the name server that responds is displayed\&. +is the name or IP address of the name server to query. This can be an IPv4 address in dotted\-decimal notation or an IPv6 address in colon\-delimited notation. When the supplied +\fIserver\fR +argument is a hostname, +\fBdig\fR +resolves that name before querying that name server. If no +\fIserver\fR +argument is provided, +\fBdig\fR +consults +\fI/etc/resolv.conf\fR +and queries the name servers listed there. The reply from the name server that responds is displayed. .TP \fBname\fR -is the name of the resource record that is to be looked up\&. +is the name of the resource record that is to be looked up. .TP \fBtype\fR -indicates what type of query is required -- ANY, A, MX, SIG, etc\&. \fItype\fR can be any valid query type\&. If no \fItype\fR argument is supplied, \fBdig\fR will perform a lookup for an A record\&. +indicates what type of query is required \(em ANY, A, MX, SIG, etc. +\fItype\fR +can be any valid query type. If no +\fItype\fR +argument is supplied, +\fBdig\fR +will perform a lookup for an A record. .SH "OPTIONS" .PP -The \fB\-b\fR option sets the source IP address of the query to \fIaddress\fR\&. This must be a valid address on one of the host's network interfaces or "0\&.0\&.0\&.0" or "::"\&. An optional port may be specified by appending "#<port>" +The +\fB\-b\fR +option sets the source IP address of the query to +\fIaddress\fR. This must be a valid address on one of the host's network interfaces or "0.0.0.0" or "::". An optional port may be specified by appending "#<port>" .PP -The default query class (IN for internet) is overridden by the \fB\-c\fR option\&. \fIclass\fR is any valid class, such as HS for Hesiod records or CH for CHAOSNET records\&. +The default query class (IN for internet) is overridden by the +\fB\-c\fR +option. +\fIclass\fR +is any valid class, such as HS for Hesiod records or CH for CHAOSNET records. .PP -The \fB\-f\fR option makes \fBdig \fR operate in batch mode by reading a list of lookup requests to process from the file \fIfilename\fR\&. The file contains a number of queries, one per line\&. Each entry in the file should be organised in the same way they would be presented as queries to \fBdig\fR using the command\-line interface\&. +The +\fB\-f\fR +option makes +\fBdig \fR +operate in batch mode by reading a list of lookup requests to process from the file +\fIfilename\fR. The file contains a number of queries, one per line. Each entry in the file should be organised in the same way they would be presented as queries to +\fBdig\fR +using the command\-line interface. .PP -If a non\-standard port number is to be queried, the \fB\-p\fR option is used\&. \fIport#\fR is the port number that \fBdig\fR will send its queries instead of the standard DNS port number 53\&. This option would be used to test a name server that has been configured to listen for queries on a non\-standard port number\&. +If a non\-standard port number is to be queried, the +\fB\-p\fR +option is used. +\fIport#\fR +is the port number that +\fBdig\fR +will send its queries instead of the standard DNS port number 53. This option would be used to test a name server that has been configured to listen for queries on a non\-standard port number. .PP -The \fB\-4\fR option forces \fBdig\fR to only use IPv4 query transport\&. The \fB\-6\fR option forces \fBdig\fR to only use IPv6 query transport\&. +The +\fB\-4\fR +option forces +\fBdig\fR +to only use IPv4 query transport. The +\fB\-6\fR +option forces +\fBdig\fR +to only use IPv6 query transport. .PP -The \fB\-t\fR option sets the query type to \fItype\fR\&. It can be any valid query type which is supported in BIND9\&. The default query type "A", unless the \fB\-x\fR option is supplied to indicate a reverse lookup\&. A zone transfer can be requested by specifying a type of AXFR\&. When an incremental zone transfer (IXFR) is required, \fItype\fR is set to ixfr=N\&. The incremental zone transfer will contain the changes made to the zone since the serial number in the zone's SOA record was \fIN\fR\&. +The +\fB\-t\fR +option sets the query type to +\fItype\fR. It can be any valid query type which is supported in BIND9. The default query type "A", unless the +\fB\-x\fR +option is supplied to indicate a reverse lookup. A zone transfer can be requested by specifying a type of AXFR. When an incremental zone transfer (IXFR) is required, +\fItype\fR +is set to +ixfr=N. The incremental zone transfer will contain the changes made to the zone since the serial number in the zone's SOA record was +\fIN\fR. .PP -Reverse lookups \- mapping addresses to names \- are simplified by the \fB\-x\fR option\&. \fIaddr\fR is an IPv4 address in dotted\-decimal notation, or a colon\-delimited IPv6 address\&. When this option is used, there is no need to provide the \fIname\fR, \fIclass\fR and \fItype\fR arguments\&. \fBdig\fR automatically performs a lookup for a name like 11\&.12\&.13\&.10\&.in\-addr\&.arpa and sets the query type and class to PTR and IN respectively\&. By default, IPv6 addresses are looked up using nibble format under the IP6\&.ARPA domain\&. To use the older RFC1886 method using the IP6\&.INT domain specify the \fB\-i\fR option\&. Bit string labels (RFC2874) are now experimental and are not attempted\&. +Reverse lookups \- mapping addresses to names \- are simplified by the +\fB\-x\fR +option. +\fIaddr\fR +is an IPv4 address in dotted\-decimal notation, or a colon\-delimited IPv6 address. When this option is used, there is no need to provide the +\fIname\fR, +\fIclass\fR +and +\fItype\fR +arguments. +\fBdig\fR +automatically performs a lookup for a name like +11.12.13.10.in\-addr.arpa +and sets the query type and class to PTR and IN respectively. By default, IPv6 addresses are looked up using nibble format under the IP6.ARPA domain. To use the older RFC1886 method using the IP6.INT domain specify the +\fB\-i\fR +option. Bit string labels (RFC2874) are now experimental and are not attempted. .PP -To sign the DNS queries sent by \fBdig\fR and their responses using transaction signatures (TSIG), specify a TSIG key file using the \fB\-k\fR option\&. You can also specify the TSIG key itself on the command line using the \fB\-y\fR option; \fIname\fR is the name of the TSIG key and \fIkey\fR is the actual key\&. The key is a base\-64 encoded string, typically generated by \fBdnssec\-keygen\fR(8)\&. Caution should be taken when using the \fB\-y\fR option on multi\-user systems as the key can be visible in the output from \fBps\fR(1 ) or in the shell's history file\&. When using TSIG authentication with \fBdig\fR, the name server that is queried needs to know the key and algorithm that is being used\&. In BIND, this is done by providing appropriate \fBkey\fR and \fBserver\fR statements in \fInamed\&.conf\fR\&. +To sign the DNS queries sent by +\fBdig\fR +and their responses using transaction signatures (TSIG), specify a TSIG key file using the +\fB\-k\fR +option. You can also specify the TSIG key itself on the command line using the +\fB\-y\fR +option; +\fIname\fR +is the name of the TSIG key and +\fIkey\fR +is the actual key. The key is a base\-64 encoded string, typically generated by +\fBdnssec\-keygen\fR(8). Caution should be taken when using the +\fB\-y\fR +option on multi\-user systems as the key can be visible in the output from +\fBps\fR(1 ) +or in the shell's history file. When using TSIG authentication with +\fBdig\fR, the name server that is queried needs to know the key and algorithm that is being used. In BIND, this is done by providing appropriate +\fBkey\fR +and +\fBserver\fR +statements in +\fInamed.conf\fR. .SH "QUERY OPTIONS" .PP - \fBdig\fR provides a number of query options which affect the way in which lookups are made and the results displayed\&. Some of these set or reset flag bits in the query header, some determine which sections of the answer get printed, and others determine the timeout and retry strategies\&. +\fBdig\fR +provides a number of query options which affect the way in which lookups are made and the results displayed. Some of these set or reset flag bits in the query header, some determine which sections of the answer get printed, and others determine the timeout and retry strategies. .PP -Each query option is identified by a keyword preceded by a plus sign (+)\&. Some keywords set or reset an option\&. These may be preceded by the string no to negate the meaning of that keyword\&. Other keywords assign values to options like the timeout interval\&. They have the form \fB+keyword=value\fR\&. The query options are: +Each query option is identified by a keyword preceded by a plus sign (+). Some keywords set or reset an option. These may be preceded by the string +no +to negate the meaning of that keyword. Other keywords assign values to options like the timeout interval. They have the form +\fB+keyword=value\fR. The query options are: .TP \fB+[no]tcp\fR -Use [do not use] TCP when querying name servers\&. The default behaviour is to use UDP unless an AXFR or IXFR query is requested, in which case a TCP connection is used\&. +Use [do not use] TCP when querying name servers. The default behaviour is to use UDP unless an AXFR or IXFR query is requested, in which case a TCP connection is used. .TP \fB+[no]vc\fR -Use [do not use] TCP when querying name servers\&. This alternate syntax to \fI+[no]tcp\fR is provided for backwards compatibility\&. The "vc" stands for "virtual circuit"\&. +Use [do not use] TCP when querying name servers. This alternate syntax to +\fI+[no]tcp\fR +is provided for backwards compatibility. The "vc" stands for "virtual circuit". .TP \fB+[no]ignore\fR -Ignore truncation in UDP responses instead of retrying with TCP\&. By default, TCP retries are performed\&. +Ignore truncation in UDP responses instead of retrying with TCP. By default, TCP retries are performed. .TP \fB+domain=somename\fR -Set the search list to contain the single domain \fIsomename\fR, as if specified in a \fBdomain\fR directive in \fI/etc/resolv\&.conf\fR, and enable search list processing as if the \fI+search\fR option were given\&. +Set the search list to contain the single domain +\fIsomename\fR, as if specified in a +\fBdomain\fR +directive in +\fI/etc/resolv.conf\fR, and enable search list processing as if the +\fI+search\fR +option were given. .TP \fB+[no]search\fR -Use [do not use] the search list defined by the searchlist or domain directive in \fIresolv\&.conf\fR (if any)\&. The search list is not used by default\&. +Use [do not use] the search list defined by the searchlist or domain directive in +\fIresolv.conf\fR +(if any). The search list is not used by default. .TP \fB+[no]defname\fR -Deprecated, treated as a synonym for \fI+[no]search\fR +Deprecated, treated as a synonym for +\fI+[no]search\fR .TP \fB+[no]aaonly\fR -Sets the "aa" flag in the query\&. +Sets the "aa" flag in the query. .TP \fB+[no]aaflag\fR -A synonym for \fI+[no]aaonly\fR\&. +A synonym for +\fI+[no]aaonly\fR. .TP \fB+[no]adflag\fR -Set [do not set] the AD (authentic data) bit in the query\&. The AD bit currently has a standard meaning only in responses, not in queries, but the ability to set the bit in the query is provided for completeness\&. +Set [do not set] the AD (authentic data) bit in the query. The AD bit currently has a standard meaning only in responses, not in queries, but the ability to set the bit in the query is provided for completeness. .TP \fB+[no]cdflag\fR -Set [do not set] the CD (checking disabled) bit in the query\&. This requests the server to not perform DNSSEC validation of responses\&. +Set [do not set] the CD (checking disabled) bit in the query. This requests the server to not perform DNSSEC validation of responses. .TP \fB+[no]cl\fR -Display [do not display] the CLASS when printing the record\&. +Display [do not display] the CLASS when printing the record. .TP \fB+[no]ttlid\fR -Display [do not display] the TTL when printing the record\&. +Display [do not display] the TTL when printing the record. .TP \fB+[no]recurse\fR -Toggle the setting of the RD (recursion desired) bit in the query\&. This bit is set by default, which means \fBdig\fR normally sends recursive queries\&. Recursion is automatically disabled when the \fI+nssearch\fR or \fI+trace\fR query options are used\&. +Toggle the setting of the RD (recursion desired) bit in the query. This bit is set by default, which means +\fBdig\fR +normally sends recursive queries. Recursion is automatically disabled when the +\fI+nssearch\fR +or +\fI+trace\fR +query options are used. .TP \fB+[no]nssearch\fR -When this option is set, \fBdig\fR attempts to find the authoritative name servers for the zone containing the name being looked up and display the SOA record that each name server has for the zone\&. +When this option is set, +\fBdig\fR +attempts to find the authoritative name servers for the zone containing the name being looked up and display the SOA record that each name server has for the zone. .TP \fB+[no]trace\fR -Toggle tracing of the delegation path from the root name servers for the name being looked up\&. Tracing is disabled by default\&. When tracing is enabled, \fBdig\fR makes iterative queries to resolve the name being looked up\&. It will follow referrals from the root servers, showing the answer from each server that was used to resolve the lookup\&. +Toggle tracing of the delegation path from the root name servers for the name being looked up. Tracing is disabled by default. When tracing is enabled, +\fBdig\fR +makes iterative queries to resolve the name being looked up. It will follow referrals from the root servers, showing the answer from each server that was used to resolve the lookup. .TP \fB+[no]cmd\fR -toggles the printing of the initial comment in the output identifying the version of \fBdig\fR and the query options that have been applied\&. This comment is printed by default\&. +toggles the printing of the initial comment in the output identifying the version of +\fBdig\fR +and the query options that have been applied. This comment is printed by default. .TP \fB+[no]short\fR -Provide a terse answer\&. The default is to print the answer in a verbose form\&. +Provide a terse answer. The default is to print the answer in a verbose form. .TP \fB+[no]identify\fR -Show [or do not show] the IP address and port number that supplied the answer when the \fI+short\fR option is enabled\&. If short form answers are requested, the default is not to show the source address and port number of the server that provided the answer\&. +Show [or do not show] the IP address and port number that supplied the answer when the +\fI+short\fR +option is enabled. If short form answers are requested, the default is not to show the source address and port number of the server that provided the answer. .TP \fB+[no]comments\fR -Toggle the display of comment lines in the output\&. The default is to print comments\&. +Toggle the display of comment lines in the output. The default is to print comments. .TP \fB+[no]stats\fR -This query option toggles the printing of statistics: when the query was made, the size of the reply and so on\&. The default behaviour is to print the query statistics\&. +This query option toggles the printing of statistics: when the query was made, the size of the reply and so on. The default behaviour is to print the query statistics. .TP \fB+[no]qr\fR -Print [do not print] the query as it is sent\&. By default, the query is not printed\&. +Print [do not print] the query as it is sent. By default, the query is not printed. .TP \fB+[no]question\fR -Print [do not print] the question section of a query when an answer is returned\&. The default is to print the question section as a comment\&. +Print [do not print] the question section of a query when an answer is returned. The default is to print the question section as a comment. .TP \fB+[no]answer\fR -Display [do not display] the answer section of a reply\&. The default is to display it\&. +Display [do not display] the answer section of a reply. The default is to display it. .TP \fB+[no]authority\fR -Display [do not display] the authority section of a reply\&. The default is to display it\&. +Display [do not display] the authority section of a reply. The default is to display it. .TP \fB+[no]additional\fR -Display [do not display] the additional section of a reply\&. The default is to display it\&. +Display [do not display] the additional section of a reply. The default is to display it. .TP \fB+[no]all\fR -Set or clear all display flags\&. +Set or clear all display flags. .TP \fB+time=T\fR -Sets the timeout for a query to \fIT\fR seconds\&. The default time out is 5 seconds\&. An attempt to set \fIT\fR to less than 1 will result in a query timeout of 1 second being applied\&. +Sets the timeout for a query to +\fIT\fR +seconds. The default time out is 5 seconds. An attempt to set +\fIT\fR +to less than 1 will result in a query timeout of 1 second being applied. .TP \fB+tries=T\fR -Sets the number of times to try UDP queries to server to \fIT\fR instead of the default, 3\&. If \fIT\fR is less than or equal to zero, the number of tries is silently rounded up to 1\&. +Sets the number of times to try UDP queries to server to +\fIT\fR +instead of the default, 3. If +\fIT\fR +is less than or equal to zero, the number of tries is silently rounded up to 1. .TP \fB+retry=T\fR -Sets the number of times to retry UDP queries to server to \fIT\fR instead of the default, 2\&. Unlike \fI+tries\fR, this does not include the initial query\&. +Sets the number of times to retry UDP queries to server to +\fIT\fR +instead of the default, 2. Unlike +\fI+tries\fR, this does not include the initial query. .TP \fB+ndots=D\fR -Set the number of dots that have to appear in \fIname\fR to \fID\fR for it to be considered absolute\&. The default value is that defined using the ndots statement in \fI/etc/resolv\&.conf\fR, or 1 if no ndots statement is present\&. Names with fewer dots are interpreted as relative names and will be searched for in the domains listed in the \fBsearch\fR or \fBdomain\fR directive in \fI/etc/resolv\&.conf\fR\&. +Set the number of dots that have to appear in +\fIname\fR +to +\fID\fR +for it to be considered absolute. The default value is that defined using the ndots statement in +\fI/etc/resolv.conf\fR, or 1 if no ndots statement is present. Names with fewer dots are interpreted as relative names and will be searched for in the domains listed in the +\fBsearch\fR +or +\fBdomain\fR +directive in +\fI/etc/resolv.conf\fR. .TP \fB+bufsize=B\fR -Set the UDP message buffer size advertised using EDNS0 to \fIB\fR bytes\&. The maximum and minimum sizes of this buffer are 65535 and 0 respectively\&. Values outside this range are rounded up or down appropriately\&. +Set the UDP message buffer size advertised using EDNS0 to +\fIB\fR +bytes. The maximum and minimum sizes of this buffer are 65535 and 0 respectively. Values outside this range are rounded up or down appropriately. .TP \fB+[no]multiline\fR -Print records like the SOA records in a verbose multi\-line format with human\-readable comments\&. The default is to print each record on a single line, to facilitate machine parsing of the \fBdig\fR output\&. +Print records like the SOA records in a verbose multi\-line format with human\-readable comments. The default is to print each record on a single line, to facilitate machine parsing of the +\fBdig\fR +output. .TP \fB+[no]fail\fR -Do not try the next server if you receive a SERVFAIL\&. The default is to not try the next server which is the reverse of normal stub resolver behaviour\&. +Do not try the next server if you receive a SERVFAIL. The default is to not try the next server which is the reverse of normal stub resolver behaviour. .TP \fB+[no]besteffort\fR -Attempt to display the contents of messages which are malformed\&. The default is to not display malformed answers\&. +Attempt to display the contents of messages which are malformed. The default is to not display malformed answers. .TP \fB+[no]dnssec\fR -Requests DNSSEC records be sent by setting the DNSSEC OK bit (DO) in the OPT record in the additional section of the query\&. +Requests DNSSEC records be sent by setting the DNSSEC OK bit (DO) in the OPT record in the additional section of the query. .TP \fB+[no]sigchase\fR -Chase DNSSEC signature chains\&. Requires dig be compiled with \-DDIG_SIGCHASE\&. +Chase DNSSEC signature chains. Requires dig be compiled with \-DDIG_SIGCHASE. .TP \fB+trusted\-key=####\fR -Specifies a file containing trusted keys to be used with \fB+sigchase\fR\&. Each DNSKEY record must be on its own line\&. -If not specified \fBdig\fR will look for \fI/etc/trusted\-key\&.key\fR then \fItrusted\-key\&.key\fR in the current directory\&. -Requires dig be compiled with \-DDIG_SIGCHASE\&. +Specifies a file containing trusted keys to be used with +\fB+sigchase\fR. Each DNSKEY record must be on its own line. +.sp +If not specified +\fBdig\fR +will look for +\fI/etc/trusted\-key.key\fR +then +\fItrusted\-key.key\fR +in the current directory. +.sp +Requires dig be compiled with \-DDIG_SIGCHASE. .TP \fB+[no]topdown\fR -When chasing DNSSEC signature chains perform a top down validation\&. Requires dig be compiled with \-DDIG_SIGCHASE\&. +When chasing DNSSEC signature chains perform a top down validation. Requires dig be compiled with \-DDIG_SIGCHASE. .SH "MULTIPLE QUERIES" .PP -The BIND 9 implementation of \fBdig \fR supports specifying multiple queries on the command line (in addition to supporting the \fB\-f\fR batch file option)\&. Each of those queries can be supplied with its own set of flags, options and query options\&. +The BIND 9 implementation of +\fBdig \fR +supports specifying multiple queries on the command line (in addition to supporting the +\fB\-f\fR +batch file option). Each of those queries can be supplied with its own set of flags, options and query options. .PP -In this case, each \fIquery\fR argument represent an individual query in the command\-line syntax described above\&. Each consists of any of the standard options and flags, the name to be looked up, an optional query type and class and any query options that should be applied to that query\&. +In this case, each +\fIquery\fR +argument represent an individual query in the command\-line syntax described above. Each consists of any of the standard options and flags, the name to be looked up, an optional query type and class and any query options that should be applied to that query. .PP -A global set of query options, which should be applied to all queries, can also be supplied\&. These global query options must precede the first tuple of name, class, type, options, flags, and query options supplied on the command line\&. Any global query options (except the \fB+[no]cmd\fR option) can be overridden by a query\-specific set of query options\&. For example: +A global set of query options, which should be applied to all queries, can also be supplied. These global query options must precede the first tuple of name, class, type, options, flags, and query options supplied on the command line. Any global query options (except the +\fB+[no]cmd\fR +option) can be overridden by a query\-specific set of query options. For example: +.sp .nf -dig +qr www\&.isc\&.org any \-x 127\&.0\&.0\&.1 isc\&.org ns +noqr +dig +qr www.isc.org any \-x 127.0.0.1 isc.org ns +noqr .fi - shows how \fBdig\fR could be used from the command line to make three lookups: an ANY query for www\&.isc\&.org, a reverse lookup of 127\&.0\&.0\&.1 and a query for the NS records of isc\&.org\&. A global query option of \fI+qr\fR is applied, so that \fBdig\fR shows the initial query it made for each lookup\&. The final query has a local query option of \fI+noqr\fR which means that \fBdig\fR will not print the initial query when it looks up the NS records for isc\&.org\&. +.sp +shows how +\fBdig\fR +could be used from the command line to make three lookups: an ANY query for +www.isc.org, a reverse lookup of 127.0.0.1 and a query for the NS records of +isc.org. A global query option of +\fI+qr\fR +is applied, so that +\fBdig\fR +shows the initial query it made for each lookup. The final query has a local query option of +\fI+noqr\fR +which means that +\fBdig\fR +will not print the initial query when it looks up the NS records for +isc.org. .SH "FILES" .PP - \fI/etc/resolv\&.conf\fR +\fI/etc/resolv.conf\fR .PP - \fI${HOME}/\&.digrc\fR +\fI${HOME}/.digrc\fR .SH "SEE ALSO" .PP - \fBhost\fR(1), \fBnamed\fR(8), \fBdnssec\-keygen\fR(8), RFC1035\&. +\fBhost\fR(1), +\fBnamed\fR(8), +\fBdnssec\-keygen\fR(8), +RFC1035. .SH "BUGS " .PP -There are probably too many query options\&. +There are probably too many query options. diff --git a/bin/dig/dig.c b/bin/dig/dig.c index 5c646196..52df6608 100644 --- a/bin/dig/dig.c +++ b/bin/dig/dig.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: dig.c,v 1.157.2.13.2.28 2005/07/04 03:29:44 marka Exp $ */ +/* $Id: dig.c,v 1.157.2.13.2.29 2005/10/14 01:38:40 marka Exp $ */ #include <config.h> #include <stdlib.h> @@ -790,7 +790,7 @@ plus_option(char *option, isc_boolean_t is_batchfile, break; case 'l': /* cl */ FULLCHECK("cl"); - noclass = !state; + noclass = ISC_TF(!state); break; case 'm': /* cmd */ FULLCHECK("cmd"); @@ -1026,7 +1026,7 @@ plus_option(char *option, isc_boolean_t is_batchfile, break; case 't': /* ttlid */ FULLCHECK("ttlid"); - nottl = !state; + nottl = ISC_TF(!state); break; default: goto invalid_option; diff --git a/bin/dig/dig.html b/bin/dig/dig.html index 462aa5c9..3425fb3d 100644 --- a/bin/dig/dig.html +++ b/bin/dig/dig.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: dig.html,v 1.6.2.4.2.12 2005/08/30 02:34:59 marka Exp $ --> +<!-- $Id: dig.html,v 1.6.2.4.2.13 2005/10/13 02:33:43 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>dig</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>dig — DNS lookup utility</p> @@ -34,7 +34,7 @@ <div class="cmdsynopsis"><p><code class="command">dig</code> [global-queryopt...] [query...]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514727"></a><h2>DESCRIPTION</h2> +<a name="id2525976"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">dig</strong></span> (domain information groper) is a flexible tool for interrogating DNS name servers. It performs DNS lookups and @@ -69,7 +69,7 @@ are applied before the command line arguments. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514786"></a><h2>SIMPLE USAGE</h2> +<a name="id2526035"></a><h2>SIMPLE USAGE</h2> <p> A typical invocation of <span><strong class="command">dig</strong></span> looks like: </p> @@ -107,7 +107,7 @@ ANY, A, MX, SIG, etc. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514865"></a><h2>OPTIONS</h2> +<a name="id2526114"></a><h2>OPTIONS</h2> <p> The <code class="option">-b</code> option sets the source IP address of the query to <em class="parameter"><code>address</code></em>. This must be a valid address on @@ -188,7 +188,7 @@ being used. In BIND, this is done by providing appropriate </p> </div> <div class="refsect1" lang="en"> -<a name="id2515116"></a><h2>QUERY OPTIONS</h2> +<a name="id2526365"></a><h2>QUERY OPTIONS</h2> <p> <span><strong class="command">dig</strong></span> provides a number of query options which affect the way in which lookups are made and the results displayed. Some of @@ -446,7 +446,7 @@ Requires dig be compiled with -DDIG_SIGCHASE. </p> </div> <div class="refsect1" lang="en"> -<a name="id2515852"></a><h2>MULTIPLE QUERIES</h2> +<a name="id2527033"></a><h2>MULTIPLE QUERIES</h2> <p> The BIND 9 implementation of <span><strong class="command">dig </strong></span> supports specifying multiple queries on the command line (in addition to @@ -487,7 +487,7 @@ will not print the initial query when it looks up the NS records for </p> </div> <div class="refsect1" lang="en"> -<a name="id2515911"></a><h2>FILES</h2> +<a name="id2527092"></a><h2>FILES</h2> <p> <code class="filename">/etc/resolv.conf</code> </p> @@ -496,7 +496,7 @@ will not print the initial query when it looks up the NS records for </p> </div> <div class="refsect1" lang="en"> -<a name="id2515930"></a><h2>SEE ALSO</h2> +<a name="id2527111"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>, <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>, @@ -505,7 +505,7 @@ will not print the initial query when it looks up the NS records for </p> </div> <div class="refsect1" lang="en"> -<a name="id2515969"></a><h2>BUGS </h2> +<a name="id2527149"></a><h2>BUGS </h2> <p> There are probably too many query options. </p> diff --git a/bin/dig/dighost.c b/bin/dig/dighost.c index 83bc1f7b..6129fedb 100644 --- a/bin/dig/dighost.c +++ b/bin/dig/dighost.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: dighost.c,v 1.221.2.19.2.30 2005/09/09 00:29:10 marka Exp $ */ +/* $Id: dighost.c,v 1.221.2.19.2.31 2005/10/14 01:38:40 marka Exp $ */ /* * Notice to programmers: Do not use this code as an example of how to @@ -2092,7 +2092,7 @@ send_udp(dig_query_t *query) { */ static void connect_timeout(isc_task_t *task, isc_event_t *event) { - dig_lookup_t *l = NULL, *n; + dig_lookup_t *l = NULL; dig_query_t *query = NULL, *cq; UNUSED(task); @@ -2128,7 +2128,7 @@ connect_timeout(isc_task_t *task, isc_event_t *event) { debug("making new TCP request, %d tries left", l->retries); l->retries--; - n = requeue_lookup(l, ISC_TRUE); + requeue_lookup(l, ISC_TRUE); cancel_lookup(l); check_next_lookup(l); } diff --git a/bin/dig/host.1 b/bin/dig/host.1 index 24493879..cf44a5c3 100644 --- a/bin/dig/host.1 +++ b/bin/dig/host.1 @@ -13,69 +13,173 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: host.1,v 1.11.2.1.4.6 2005/05/13 02:43:18 marka Exp $ +.\" $Id: host.1,v 1.11.2.1.4.7 2005/10/13 02:33:43 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "HOST" 1 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "HOST" "1" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" host \- DNS lookup utility .SH "SYNOPSIS" .HP 5 -\fBhost\fR [\fB\-aCdlnrTwv\fR] [\fB\-c\ \fIclass\fR\fR] [\fB\-N\ \fIndots\fR\fR] [\fB\-R\ \fInumber\fR\fR] [\fB\-t\ \fItype\fR\fR] [\fB\-W\ \fIwait\fR\fR] [\fB\-4\fR] [\fB\-6\fR] {name} [server] +\fBhost\fR [\fB\-aCdlnrTwv\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-N\ \fR\fB\fIndots\fR\fR] [\fB\-R\ \fR\fB\fInumber\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-W\ \fR\fB\fIwait\fR\fR] [\fB\-4\fR] [\fB\-6\fR] {name} [server] .SH "DESCRIPTION" .PP - \fBhost\fR is a simple utility for performing DNS lookups\&. It is normally used to convert names to IP addresses and vice versa\&. When no arguments or options are given, \fBhost\fR prints a short summary of its command line arguments and options\&. -.PP - \fIname\fR 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 \fBhost\fR will by default perform a reverse lookup for that address\&. \fIserver\fR is an optional argument which is either the name or IP address of the name server that \fBhost\fR should query instead of the server or servers listed in \fI/etc/resolv\&.conf\fR\&. -.PP -The \fB\-a\fR (all) option is equivalent to setting the \fB\-v\fR option and asking \fBhost\fR to make a query of type ANY\&. -.PP -When the \fB\-C\fR option is used, \fBhost\fR will attempt to display the SOA records for zone \fIname\fR 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\&. -.PP -The \fB\-c\fR option instructs to make a DNS query of class \fIclass\fR\&. This can be used to lookup Hesiod or Chaosnet class resource records\&. The default class is IN (Internet)\&. -.PP -Verbose output is generated by \fBhost\fR when the \fB\-d\fR or \fB\-v\fR option is used\&. The two options are equivalent\&. They have been provided for backwards compatibility\&. In previous versions, the \fB\-d\fR option switched on debugging traces and \fB\-v\fR enabled verbose output\&. -.PP -List mode is selected by the \fB\-l\fR option\&. This makes \fBhost\fR perform a zone transfer for zone \fIname\fR\&. Transfer the zone printing out the NS, PTR and address records (A/AAAA)\&. If combined with \fB\-a\fR all records will be printed\&. -.PP -The \fB\-i\fR 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\&. -.PP -The \fB\-N\fR option sets the number of dots that have to be in \fIname\fR for it to be considered absolute\&. The default value is that defined using the ndots statement in \fI/etc/resolv\&.conf\fR, or 1 if no ndots statement is present\&. Names with fewer dots are interpreted as relative names and will be searched for in the domains listed in the \fBsearch\fR or \fBdomain\fR directive in \fI/etc/resolv\&.conf\fR\&. -.PP -The number of UDP retries for a lookup can be changed with the \fB\-R\fR option\&. \fInumber\fR indicates how many times \fBhost\fR will repeat a query that does not get answered\&. The default number of retries is 1\&. If \fInumber\fR is negative or zero, the number of retries will default to 1\&. -.PP -Non\-recursive queries can be made via the \fB\-r\fR option\&. Setting this option clears the \fBRD\fR -- recursion desired -- bit in the query which \fBhost\fR makes\&. This should mean that the name server receiving the query will not attempt to resolve \fIname\fR\&. The \fB\-r\fR option enables \fBhost\fR to mimic the behaviour of a name server by making non\-recursive queries and expecting to receive answers to those queries that are usually referrals to other name servers\&. -.PP -By default \fBhost\fR uses UDP when making queries\&. The \fB\-T\fR 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\&. -.PP -The \fB\-4\fR option forces \fBhost\fR to only use IPv4 query transport\&. The \fB\-6\fR option forces \fBhost\fR to only use IPv6 query transport\&. -.PP -The \fB\-t\fR option is used to select the query type\&. \fItype\fR can be any recognised query type: CNAME, NS, SOA, SIG, KEY, AXFR, etc\&. When no query type is specified, \fBhost\fR automatically selects an appropriate query type\&. By default it looks for A records, but if the \fB\-C\fR option was given, queries will be made for SOA records, and if \fIname\fR is a dotted\-decimal IPv4 address or colon\-delimited IPv6 address, \fBhost\fR will query for PTR records\&. If a query type of IXFR is chosen the starting serial number can be specified by appending an equal followed by the starting serial number (e\&.g\&. \-t IXFR=12345678)\&. -.PP -The time to wait for a reply can be controlled through the \fB\-W\fR and \fB\-w\fR options\&. The \fB\-W\fR option makes \fBhost\fR wait for \fIwait\fR seconds\&. If \fIwait\fR is less than one, the wait interval is set to one second\&. When the \fB\-w\fR option is used, \fBhost\fR will 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\&. +\fBhost\fR +is a simple utility for performing DNS lookups. It is normally used to convert names to IP addresses and vice versa. When no arguments or options are given, +\fBhost\fR +prints a short summary of its command line arguments and options. +.PP +\fIname\fR +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 +\fBhost\fR +will by default perform a reverse lookup for that address. +\fIserver\fR +is an optional argument which is either the name or IP address of the name server that +\fBhost\fR +should query instead of the server or servers listed in +\fI/etc/resolv.conf\fR. +.PP +The +\fB\-a\fR +(all) option is equivalent to setting the +\fB\-v\fR +option and asking +\fBhost\fR +to make a query of type ANY. +.PP +When the +\fB\-C\fR +option is used, +\fBhost\fR +will attempt to display the SOA records for zone +\fIname\fR +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. +.PP +The +\fB\-c\fR +option instructs to make a DNS query of class +\fIclass\fR. This can be used to lookup Hesiod or Chaosnet class resource records. The default class is IN (Internet). +.PP +Verbose output is generated by +\fBhost\fR +when the +\fB\-d\fR +or +\fB\-v\fR +option is used. The two options are equivalent. They have been provided for backwards compatibility. In previous versions, the +\fB\-d\fR +option switched on debugging traces and +\fB\-v\fR +enabled verbose output. +.PP +List mode is selected by the +\fB\-l\fR +option. This makes +\fBhost\fR +perform a zone transfer for zone +\fIname\fR. Transfer the zone printing out the NS, PTR and address records (A/AAAA). If combined with +\fB\-a\fR +all records will be printed. +.PP +The +\fB\-i\fR +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. +.PP +The +\fB\-N\fR +option sets the number of dots that have to be in +\fIname\fR +for it to be considered absolute. The default value is that defined using the ndots statement in +\fI/etc/resolv.conf\fR, or 1 if no ndots statement is present. Names with fewer dots are interpreted as relative names and will be searched for in the domains listed in the +\fBsearch\fR +or +\fBdomain\fR +directive in +\fI/etc/resolv.conf\fR. +.PP +The number of UDP retries for a lookup can be changed with the +\fB\-R\fR +option. +\fInumber\fR +indicates how many times +\fBhost\fR +will repeat a query that does not get answered. The default number of retries is 1. If +\fInumber\fR +is negative or zero, the number of retries will default to 1. +.PP +Non\-recursive queries can be made via the +\fB\-r\fR +option. Setting this option clears the +\fBRD\fR +\(em recursion desired \(em bit in the query which +\fBhost\fR +makes. This should mean that the name server receiving the query will not attempt to resolve +\fIname\fR. The +\fB\-r\fR +option enables +\fBhost\fR +to mimic the behaviour of a name server by making non\-recursive queries and expecting to receive answers to those queries that are usually referrals to other name servers. +.PP +By default +\fBhost\fR +uses UDP when making queries. The +\fB\-T\fR +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. +.PP +The +\fB\-4\fR +option forces +\fBhost\fR +to only use IPv4 query transport. The +\fB\-6\fR +option forces +\fBhost\fR +to only use IPv6 query transport. +.PP +The +\fB\-t\fR +option is used to select the query type. +\fItype\fR +can be any recognised query type: CNAME, NS, SOA, SIG, KEY, AXFR, etc. When no query type is specified, +\fBhost\fR +automatically selects an appropriate query type. By default it looks for A records, but if the +\fB\-C\fR +option was given, queries will be made for SOA records, and if +\fIname\fR +is a dotted\-decimal IPv4 address or colon\-delimited IPv6 address, +\fBhost\fR +will query for PTR records. If a query type of IXFR is chosen the starting serial number can be specified by appending an equal followed by the starting serial number (e.g. \-t IXFR=12345678). +.PP +The time to wait for a reply can be controlled through the +\fB\-W\fR +and +\fB\-w\fR +options. The +\fB\-W\fR +option makes +\fBhost\fR +wait for +\fIwait\fR +seconds. If +\fIwait\fR +is less than one, the wait interval is set to one second. When the +\fB\-w\fR +option is used, +\fBhost\fR +will 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. .SH "FILES" .PP - \fI/etc/resolv\&.conf\fR +\fI/etc/resolv.conf\fR .SH "SEE ALSO" .PP - \fBdig\fR(1), \fBnamed\fR(8)\&. +\fBdig\fR(1), +\fBnamed\fR(8). diff --git a/bin/dig/host.html b/bin/dig/host.html index c85246ab..7670868c 100644 --- a/bin/dig/host.html +++ b/bin/dig/host.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: host.html,v 1.4.2.1.4.10 2005/07/18 02:36:44 marka Exp $ --> +<!-- $Id: host.html,v 1.4.2.1.4.12 2005/10/13 02:33:44 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>host</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>host — DNS lookup utility</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">host</code> [<code class="option">-aCdlnrTwv</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-N <em class="replaceable"><code>ndots</code></em></code>] [<code class="option">-R <em class="replaceable"><code>number</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-W <em class="replaceable"><code>wait</code></em></code>] [<code class="option">-4</code>] [<code class="option">-6</code>] {name} [server]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514584"></a><h2>DESCRIPTION</h2> +<a name="id2525901"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">host</strong></span> is a simple utility for performing DNS lookups. @@ -155,13 +155,13 @@ value for an integer quantity. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514992"></a><h2>FILES</h2> +<a name="id2526241"></a><h2>FILES</h2> <p> <code class="filename">/etc/resolv.conf</code> </p> </div> <div class="refsect1" lang="en"> -<a name="id2515004"></a><h2>SEE ALSO</h2> +<a name="id2526253"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">dig</span>(1)</span>, <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>. diff --git a/bin/dig/nslookup.1 b/bin/dig/nslookup.1 index 344c6ae3..3de04ca4 100644 --- a/bin/dig/nslookup.1 +++ b/bin/dig/nslookup.1 @@ -12,62 +12,61 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: nslookup.1,v 1.1.6.4 2005/05/13 02:43:18 marka Exp $ +.\" $Id: nslookup.1,v 1.1.6.5 2005/10/13 02:33:43 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "NSLOOKUP" 1 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "NSLOOKUP" "1" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" nslookup \- query Internet name servers interactively .SH "SYNOPSIS" .HP 9 \fBnslookup\fR [\fB\-option\fR] [name\ |\ \-] [server] .SH "DESCRIPTION" .PP - \fBNslookup\fR is a program to query Internet domain name servers\&. \fBNslookup\fR has two modes: interactive and non\-interactive\&. Interactive mode allows the user to query name servers for information about various hosts and domains or to print a list of hosts in a domain\&. Non\-interactive mode is used to print just the name and requested information for a host or domain\&. +\fBNslookup\fR +is a program to query Internet domain name servers. +\fBNslookup\fR +has two modes: interactive and non\-interactive. Interactive mode allows the user to query name servers for information about various hosts and domains or to print a list of hosts in a domain. Non\-interactive mode is used to print just the name and requested information for a host or domain. .SH "ARGUMENTS" .PP -Interactive mode is entered in the following cases: +Interactive mode is entered in the following cases: .TP 3 1. when no arguments are given (the default name server will be used) .TP 2. -when the first argument is a hyphen (\-) and the second argument is the host name or Internet address of a name server\&. -.LP +when the first argument is a hyphen (\-) and the second argument is the host name or Internet address of a name server. .PP -Non\-interactive mode is used when the name or Internet address of the host to be looked up is given as the first argument\&. The optional second argument specifies the host name or address of a name server\&. +Non\-interactive mode is used when the name or Internet address of the host to be looked up is given as the first argument. The optional second argument specifies the host name or address of a name server. .PP -Options can also be specified on the command line if they precede the arguments and are prefixed with a hyphen\&. For example, to change the default query type to host information, and the initial timeout to 10 seconds, type: .IP .nf nslookup \-query=hinfo \-timeout=10 .fi +Options can also be specified on the command line if they precede the arguments and are prefixed with a hyphen. For example, to change the default query type to host information, and the initial timeout to 10 seconds, type: +.IP .sp .nf nslookup \-query=hinfo \-timeout=10 .fi .SH "INTERACTIVE COMMANDS" .TP host [server] -Look up information for host using the current default server or using server, if specified\&. If host is an Internet address and the query type is A or PTR, the name of the host is returned\&. If host is a name and does not have a trailing period, the search list is used to qualify the name\&. -To look up a host not in the current domain, append a period to the name\&. +Look up information for host using the current default server or using server, if specified. If host is an Internet address and the query type is A or PTR, the name of the host is returned. If host is a name and does not have a trailing period, the search list is used to qualify the name. +.sp +To look up a host not in the current domain, append a period to the name. .TP \fBserver\fR \fIdomain\fR .TP \fBlserver\fR \fIdomain\fR -Change the default server to \fIdomain\fR; \fBlserver\fR uses the initial server to look up information about \fIdomain\fR, while \fBserver\fR uses the current default server\&. If an authoritative answer can't be found, the names of servers that might have the answer are returned\&. +Change the default server to +\fIdomain\fR; +\fBlserver\fR +uses the initial server to look up information about +\fIdomain\fR, while +\fBserver\fR +uses the current default server. If an authoritative answer can't be found, the names of servers that might have the answer are returned. .TP \fBroot\fR not implemented @@ -88,17 +87,18 @@ not implemented not implemented .TP \fBexit\fR -Exits the program\&. +Exits the program. .TP -\fBset\fR \fIkeyword[=value]\fR -This command is used to change state information that affects the lookups\&. Valid keywords are: +\fBset\fR \fIkeyword\fR\fI[=value]\fR +This command is used to change state information that affects the lookups. Valid keywords are: .RS .TP \fBall\fR -Prints the current values of the frequently used options to \fBset\fR\&. Information about the current default server and host is also printed\&. +Prints the current values of the frequently used options to +\fBset\fR. Information about the current default server and host is also printed. .TP \fBclass=\fR\fIvalue\fR -Change the query class to one of: +Change the query class to one of: .RS .TP \fBIN\fR @@ -114,55 +114,68 @@ the Hesiod class wildcard .RE .IP - The class specifies the protocol group of the information\&. +The class specifies the protocol group of the information. +.sp (Default = IN; abbreviation = cl) .TP -\fB\fI[no]\fRdebug\fR -Turn debugging mode on\&. A lot more information is printed about the packet sent to the server and the resulting answer\&. -(Default = nodebug; abbreviation = [no]deb) +\fB\fI[no]\fR\fR\fBdebug\fR +Turn debugging mode on. A lot more information is printed about the packet sent to the server and the resulting answer. +.sp +(Default = nodebug; abbreviation = +[no]deb) .TP -\fB\fI[no]\fRd2\fR -Turn debugging mode on\&. A lot more information is printed about the packet sent to the server and the resulting answer\&. +\fB\fI[no]\fR\fR\fBd2\fR +Turn debugging mode on. A lot more information is printed about the packet sent to the server and the resulting answer. +.sp (Default = nod2) .TP \fBdomain=\fR\fIname\fR -Sets the search list to \fIname\fR\&. +Sets the search list to +\fIname\fR. .TP -\fB\fI[no]\fRsearch\fR -If the lookup request contains at least one period but doesn't end with a trailing period, append the domain names in the domain search list to the request until an answer is received\&. +\fB\fI[no]\fR\fR\fBsearch\fR +If the lookup request contains at least one period but doesn't end with a trailing period, append the domain names in the domain search list to the request until an answer is received. +.sp (Default = search) .TP \fBport=\fR\fIvalue\fR -Change the default TCP/UDP name server port to \fIvalue\fR\&. +Change the default TCP/UDP name server port to +\fIvalue\fR. +.sp (Default = 53; abbreviation = po) .TP \fBquerytype=\fR\fIvalue\fR .TP \fBtype=\fR\fIvalue\fR -Change the top of the information query\&. +Change the top of the information query. +.sp (Default = A; abbreviations = q, ty) .TP -\fB\fI[no]\fRrecurse\fR -Tell the name server to query other servers if it does not have the information\&. +\fB\fI[no]\fR\fR\fBrecurse\fR +Tell the name server to query other servers if it does not have the information. +.sp (Default = recurse; abbreviation = [no]rec) .TP \fBretry=\fR\fInumber\fR -Set the number of retries to number\&. +Set the number of retries to number. .TP \fBtimeout=\fR\fInumber\fR -Change the initial timeout interval for waiting for a reply to number seconds\&. +Change the initial timeout interval for waiting for a reply to number seconds. .TP -\fB\fI[no]\fRvc\fR -Always use a virtual circuit when sending requests to the server\&. +\fB\fI[no]\fR\fR\fBvc\fR +Always use a virtual circuit when sending requests to the server. +.sp (Default = novc) .RE .IP .SH "FILES" .PP - \fI/etc/resolv\&.conf\fR +\fI/etc/resolv.conf\fR .SH "SEE ALSO" .PP - \fBdig\fR(1), \fBhost\fR(1), \fBnamed\fR(8)\&. +\fBdig\fR(1), +\fBhost\fR(1), +\fBnamed\fR(8). .SH "AUTHOR" .PP Andrew Cherenson diff --git a/bin/dig/nslookup.html b/bin/dig/nslookup.html index 70f26c4b..fc2e4e80 100644 --- a/bin/dig/nslookup.html +++ b/bin/dig/nslookup.html @@ -13,15 +13,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: nslookup.html,v 1.1.6.7 2005/07/18 02:36:44 marka Exp $ --> +<!-- $Id: nslookup.html,v 1.1.6.9 2005/10/13 02:33:44 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>nslookup</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456976"></a><div class="titlepage"></div> +<a name="id2463728"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>nslookup — query Internet name servers interactively</p> @@ -31,7 +31,7 @@ <div class="cmdsynopsis"><p><code class="command">nslookup</code> [<code class="option">-option</code>] [name | -] [server]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514587"></a><h2>DESCRIPTION</h2> +<a name="id2525973"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">Nslookup</strong></span> is a program to query Internet domain name servers. <span><strong class="command">Nslookup</strong></span> @@ -43,7 +43,7 @@ domain. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514604"></a><h2>ARGUMENTS</h2> +<a name="id2525990"></a><h2>ARGUMENTS</h2> <p> Interactive mode is entered in the following cases: </p> @@ -75,7 +75,7 @@ nslookup -query=hinfo -timeout=10 </p> </div> <div class="refsect1" lang="en"> -<a name="id2514647"></a><h2>INTERACTIVE COMMANDS</h2> +<a name="id2526033"></a><h2>INTERACTIVE COMMANDS</h2> <div class="variablelist"><dl> <dt><span class="term">host [<span class="optional">server</span>]</span></dt> <dd> @@ -241,13 +241,13 @@ the lookups. Valid keywords are: </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515241"></a><h2>FILES</h2> +<a name="id2526490"></a><h2>FILES</h2> <p> <code class="filename">/etc/resolv.conf</code> </p> </div> <div class="refsect1" lang="en"> -<a name="id2515254"></a><h2>SEE ALSO</h2> +<a name="id2526503"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">dig</span>(1)</span>, <span class="citerefentry"><span class="refentrytitle">host</span>(1)</span>, @@ -255,7 +255,7 @@ the lookups. Valid keywords are: </p> </div> <div class="refsect1" lang="en"> -<a name="id2515289"></a><h2>Author</h2> +<a name="id2526538"></a><h2>Author</h2> <p> Andrew Cherenson </p> diff --git a/bin/dnssec/dnssec-keygen.8 b/bin/dnssec/dnssec-keygen.8 index 2f9dd76c..0f8f003d 100644 --- a/bin/dnssec/dnssec-keygen.8 +++ b/bin/dnssec/dnssec-keygen.8 @@ -13,118 +13,152 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: dnssec-keygen.8,v 1.19.12.8 2005/08/30 02:35:00 marka Exp $ +.\" $Id: dnssec-keygen.8,v 1.19.12.9 2005/10/13 02:33:45 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "DNSSEC-KEYGEN" 8 "June 30, 2000" "" "" -.SH NAME -dnssec-keygen \- DNSSEC key generation tool +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "DNSSEC\-KEYGEN" "8" "June 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +dnssec\-keygen \- DNSSEC key generation tool .SH "SYNOPSIS" .HP 14 -\fBdnssec\-keygen\fR {\-a\ \fIalgorithm\fR} {\-b\ \fIkeysize\fR} {\-n\ \fInametype\fR} [\fB\-c\ \fIclass\fR\fR] [\fB\-e\fR] [\fB\-f\ \fIflag\fR\fR] [\fB\-g\ \fIgenerator\fR\fR] [\fB\-h\fR] [\fB\-k\fR] [\fB\-p\ \fIprotocol\fR\fR] [\fB\-r\ \fIrandomdev\fR\fR] [\fB\-s\ \fIstrength\fR\fR] [\fB\-t\ \fItype\fR\fR] [\fB\-v\ \fIlevel\fR\fR] {name} +\fBdnssec\-keygen\fR {\-a\ \fIalgorithm\fR} {\-b\ \fIkeysize\fR} {\-n\ \fInametype\fR} [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-e\fR] [\fB\-f\ \fR\fB\fIflag\fR\fR] [\fB\-g\ \fR\fB\fIgenerator\fR\fR] [\fB\-h\fR] [\fB\-k\fR] [\fB\-p\ \fR\fB\fIprotocol\fR\fR] [\fB\-r\ \fR\fB\fIrandomdev\fR\fR] [\fB\-s\ \fR\fB\fIstrength\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] {name} .SH "DESCRIPTION" .PP - \fBdnssec\-keygen\fR generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC <TBA\\>\&. It can also generate keys for use with TSIG (Transaction Signatures), as defined in RFC 2845\&. +\fBdnssec\-keygen\fR +generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC <TBA\\>. It can also generate keys for use with TSIG (Transaction Signatures), as defined in RFC 2845. .SH "OPTIONS" .TP \-a \fIalgorithm\fR -Selects the cryptographic algorithm\&. The value of \fBalgorithm\fR must be one of RSAMD5 (RSA) or RSASHA1, DSA, DH (Diffie Hellman), or HMAC\-MD5\&. These values are case insensitive\&. -Note 1: that for DNSSEC, RSASHA1 is a mandatory to implement algorithm, and DSA is recommended\&. For TSIG, HMAC\-MD5 is mandatory\&. -Note 2: HMAC\-MD5 and DH automatically set the \-k flag\&. +Selects the cryptographic algorithm. The value of +\fBalgorithm\fR +must be one of RSAMD5 (RSA) or RSASHA1, DSA, DH (Diffie Hellman), or HMAC\-MD5. These values are case insensitive. +.sp +Note 1: that for DNSSEC, RSASHA1 is a mandatory to implement algorithm, and DSA is recommended. For TSIG, HMAC\-MD5 is mandatory. +.sp +Note 2: HMAC\-MD5 and DH automatically set the \-k flag. .TP \-b \fIkeysize\fR -Specifies the number of bits in the key\&. The choice of key size depends on the algorithm used\&. RSAMD5 / RSASHA1 keys must be between 512 and 2048 bits\&. Diffie Hellman keys must be between 128 and 4096 bits\&. DSA keys must be between 512 and 1024 bits and an exact multiple of 64\&. HMAC\-MD5 keys must be between 1 and 512 bits\&. +Specifies the number of bits in the key. The choice of key size depends on the algorithm used. RSAMD5 / RSASHA1 keys must be between 512 and 2048 bits. Diffie Hellman keys must be between 128 and 4096 bits. DSA keys must be between 512 and 1024 bits and an exact multiple of 64. HMAC\-MD5 keys must be between 1 and 512 bits. .TP \-n \fInametype\fR -Specifies the owner type of the key\&. The value of \fBnametype\fR 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 case insensitive\&. +Specifies the owner type of the key. The value of +\fBnametype\fR +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 case insensitive. .TP \-c \fIclass\fR -Indicates that the DNS record containing the key should have the specified class\&. If not specified, class IN is used\&. +Indicates that the DNS record containing the key should have the specified class. If not specified, class IN is used. .TP \-e -If generating an RSAMD5/RSASHA1 key, use a large exponent\&. +If generating an RSAMD5/RSASHA1 key, use a large exponent. .TP \-f \fIflag\fR -Set the specified flag in the flag field of the KEY/DNSKEY record\&. The only recognized flag is KSK (Key Signing Key) DNSKEY\&. +Set the specified flag in the flag field of the KEY/DNSKEY record. The only recognized flag is KSK (Key Signing Key) DNSKEY. .TP \-g \fIgenerator\fR -If generating a Diffie Hellman key, use this generator\&. Allowed values are 2 and 5\&. If no generator is specified, a known prime from RFC 2539 will be used if possible; otherwise the default is 2\&. +If generating a Diffie Hellman key, use this generator. Allowed values are 2 and 5. If no generator is specified, a known prime from RFC 2539 will be used if possible; otherwise the default is 2. .TP \-h -Prints a short summary of the options and arguments to \fBdnssec\-keygen\fR\&. +Prints a short summary of the options and arguments to +\fBdnssec\-keygen\fR. .TP \-k -Generate KEY records rather than DNSKEY records\&. +Generate KEY records rather than DNSKEY records. .TP \-p \fIprotocol\fR -Sets the protocol value for the generated key\&. The protocol is a number between 0 and 255\&. The default is 3 (DNSSEC)\&. Other possible values for this argument are listed in RFC 2535 and its successors\&. +Sets the protocol value for the generated key. The protocol is a number between 0 and 255. The default is 3 (DNSSEC). Other possible values for this argument are listed in RFC 2535 and its successors. .TP \-r \fIrandomdev\fR -Specifies the source of randomness\&. If the operating system does not provide a \fI/dev/random\fR or equivalent device, the default source of randomness is keyboard input\&. \fIrandomdev\fR specifies the name of a character device or file containing random data to be used instead of the default\&. The special value \fIkeyboard\fR indicates that keyboard input should be used\&. +Specifies the source of randomness. If the operating system does not provide a +\fI/dev/random\fR +or equivalent device, the default source of randomness is keyboard input. +\fIrandomdev\fR +specifies the name of a character device or file containing random data to be used instead of the default. The special value +\fIkeyboard\fR +indicates that keyboard input should be used. .TP \-s \fIstrength\fR -Specifies the strength value of the key\&. The strength is a number between 0 and 15, and currently has no defined purpose in DNSSEC\&. +Specifies the strength value of the key. The strength is a number between 0 and 15, and currently has no defined purpose in DNSSEC. .TP \-t \fItype\fR -Indicates the use of the key\&. \fBtype\fR must be one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF\&. The default is AUTHCONF\&. AUTH refers to the ability to authenticate data, and CONF the ability to encrypt data\&. +Indicates the use of the key. +\fBtype\fR +must be one of AUTHCONF, NOAUTHCONF, NOAUTH, or NOCONF. The default is AUTHCONF. AUTH refers to the ability to authenticate data, and CONF the ability to encrypt data. .TP \-v \fIlevel\fR -Sets the debugging level\&. +Sets the debugging level. .SH "GENERATED KEYS" .PP -When \fBdnssec\-keygen\fR completes successfully, it prints a string of the form \fIKnnnn\&.+aaa+iiiii\fR to the standard output\&. This is an identification string for the key it has generated\&. +When +\fBdnssec\-keygen\fR +completes successfully, it prints a string of the form +\fIKnnnn.+aaa+iiiii\fR +to the standard output. This is an identification string for the key it has generated. .TP 3 \(bu - \fInnnn\fR is the key name\&. +\fInnnn\fR +is the key name. .TP \(bu - \fIaaa\fR is the numeric representation of the algorithm\&. +\fIaaa\fR +is the numeric representation of the algorithm. .TP \(bu - \fIiiiii\fR is the key identifier (or footprint)\&. -.LP +\fIiiiii\fR +is the key identifier (or footprint). .PP - \fBdnssec\-keygen\fR creates two file, with names based on the printed string\&. \fIKnnnn\&.+aaa+iiiii\&.key\fR contains the public key, and\fIKnnnn\&.+aaa+iiiii\&.private\fR contains the private key\&. +\fBdnssec\-keygen\fR +creates two file, with names based on the printed string. +\fIKnnnn.+aaa+iiiii.key\fR +contains the public key, and +\fIKnnnn.+aaa+iiiii.private\fR +contains the private key. .PP -The \fI\&.key\fR file contains a DNS KEY record that can be inserted into a zone file (directly or with a $INCLUDE statement)\&. +The +\fI.key\fR +file contains a DNS KEY record that can be inserted into a zone file (directly or with a $INCLUDE statement). .PP -The \fI\&.private\fR file contains algorithm specific fields\&. For obvious security reasons, this file does not have general read permission\&. +The +\fI.private\fR +file contains algorithm specific fields. For obvious security reasons, this file does not have general read permission. .PP -Both \fI\&.key\fR and \fI\&.private\fR files are generated for symmetric encryption algorithm such as HMAC\-MD5, even though the public and private key are equivalent\&. +Both +\fI.key\fR +and +\fI.private\fR +files are generated for symmetric encryption algorithm such as HMAC\-MD5, even though the public and private key are equivalent. .SH "EXAMPLE" .PP -To generate a 768\-bit DSA key for the domain\fBexample\&.com\fR, the following command would be issued: +To generate a 768\-bit DSA key for the domain +\fBexample.com\fR, the following command would be issued: .PP - \fBdnssec\-keygen \-a DSA \-b 768 \-n ZONE example\&.com\fR +\fBdnssec\-keygen \-a DSA \-b 768 \-n ZONE example.com\fR .PP The command would print a string of the form: .PP - \fBKexample\&.com\&.+003+26160\fR +\fBKexample.com.+003+26160\fR .PP -In this example, \fBdnssec\-keygen\fR creates the files \fIKexample\&.com\&.+003+26160\&.key\fR and\fIKexample\&.com\&.+003+26160\&.private\fR +In this example, +\fBdnssec\-keygen\fR +creates the files +\fIKexample.com.+003+26160.key\fR +and +\fIKexample.com.+003+26160.private\fR .SH "SEE ALSO" .PP - \fBdnssec\-signzone\fR(8), BIND 9 Administrator Reference Manual, RFC 2535, RFC 2845, RFC 2539\&. +\fBdnssec\-signzone\fR(8), +BIND 9 Administrator Reference Manual, +RFC 2535, +RFC 2845, +RFC 2539. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/dnssec/dnssec-keygen.html b/bin/dnssec/dnssec-keygen.html index 81705da6..00271faa 100644 --- a/bin/dnssec/dnssec-keygen.html +++ b/bin/dnssec/dnssec-keygen.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: dnssec-keygen.html,v 1.5.2.1.4.12 2005/08/30 02:35:01 marka Exp $ --> +<!-- $Id: dnssec-keygen.html,v 1.5.2.1.4.13 2005/10/13 02:33:45 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>dnssec-keygen</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">dnssec-keygen</span> — DNSSEC key generation tool</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">dnssec-keygen</code> {-a <em class="replaceable"><code>algorithm</code></em>} {-b <em class="replaceable"><code>keysize</code></em>} {-n <em class="replaceable"><code>nametype</code></em>} [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-e</code>] [<code class="option">-f <em class="replaceable"><code>flag</code></em></code>] [<code class="option">-g <em class="replaceable"><code>generator</code></em></code>] [<code class="option">-h</code>] [<code class="option">-k</code>] [<code class="option">-p <em class="replaceable"><code>protocol</code></em></code>] [<code class="option">-r <em class="replaceable"><code>randomdev</code></em></code>] [<code class="option">-s <em class="replaceable"><code>strength</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] {name}</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514707"></a><h2>DESCRIPTION</h2> +<a name="id2525956"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">dnssec-keygen</strong></span> generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC <TBA\>. It can also generate @@ -41,7 +41,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514720"></a><h2>OPTIONS</h2> +<a name="id2525969"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt> <dd> @@ -144,7 +144,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515125"></a><h2>GENERATED KEYS</h2> +<a name="id2526306"></a><h2>GENERATED KEYS</h2> <p> When <span><strong class="command">dnssec-keygen</strong></span> completes successfully, it prints a string of the form <code class="filename">Knnnn.+aaa+iiiii</code> @@ -187,7 +187,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515213"></a><h2>EXAMPLE</h2> +<a name="id2526394"></a><h2>EXAMPLE</h2> <p> To generate a 768-bit DSA key for the domain <strong class="userinput"><code>example.com</code></strong>, the following command would be @@ -209,7 +209,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515259"></a><h2>SEE ALSO</h2> +<a name="id2526440"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">dnssec-signzone</span>(8)</span>, <em class="citetitle">BIND 9 Administrator Reference Manual</em>, @@ -219,7 +219,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515292"></a><h2>AUTHOR</h2> +<a name="id2526473"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/dnssec/dnssec-signzone.8 b/bin/dnssec/dnssec-signzone.8 index 4372aee1..63ffadba 100644 --- a/bin/dnssec/dnssec-signzone.8 +++ b/bin/dnssec/dnssec-signzone.8 @@ -13,112 +13,145 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: dnssec-signzone.8,v 1.23.2.1.4.9 2005/06/26 00:05:50 marka Exp $ +.\" $Id: dnssec-signzone.8,v 1.23.2.1.4.10 2005/10/13 02:33:45 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "DNSSEC-SIGNZONE" 8 "June 30, 2000" "" "" -.SH NAME -dnssec-signzone \- DNSSEC zone signing tool +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "DNSSEC\-SIGNZONE" "8" "June 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +dnssec\-signzone \- DNSSEC zone signing tool .SH "SYNOPSIS" .HP 16 -\fBdnssec\-signzone\fR [\fB\-a\fR] [\fB\-c\ \fIclass\fR\fR] [\fB\-d\ \fIdirectory\fR\fR] [\fB\-e\ \fIend\-time\fR\fR] [\fB\-f\ \fIoutput\-file\fR\fR] [\fB\-g\fR] [\fB\-h\fR] [\fB\-k\ \fIkey\fR\fR] [\fB\-l\ \fIdomain\fR\fR] [\fB\-i\ \fIinterval\fR\fR] [\fB\-n\ \fInthreads\fR\fR] [\fB\-o\ \fIorigin\fR\fR] [\fB\-p\fR] [\fB\-r\ \fIrandomdev\fR\fR] [\fB\-s\ \fIstart\-time\fR\fR] [\fB\-t\fR] [\fB\-v\ \fIlevel\fR\fR] [\fB\-z\fR] {zonefile} [key...] +\fBdnssec\-signzone\fR [\fB\-a\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-d\ \fR\fB\fIdirectory\fR\fR] [\fB\-e\ \fR\fB\fIend\-time\fR\fR] [\fB\-f\ \fR\fB\fIoutput\-file\fR\fR] [\fB\-g\fR] [\fB\-h\fR] [\fB\-k\ \fR\fB\fIkey\fR\fR] [\fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-i\ \fR\fB\fIinterval\fR\fR] [\fB\-n\ \fR\fB\fInthreads\fR\fR] [\fB\-o\ \fR\fB\fIorigin\fR\fR] [\fB\-p\fR] [\fB\-r\ \fR\fB\fIrandomdev\fR\fR] [\fB\-s\ \fR\fB\fIstart\-time\fR\fR] [\fB\-t\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-z\fR] {zonefile} [key...] .SH "DESCRIPTION" .PP - \fBdnssec\-signzone\fR signs a zone\&. It generates NSEC and RRSIG records and produces a signed version of the zone\&. The security status of delegations from the signed zone (that is, whether the child zones are secure or not) is determined by the presence or absence of a\fIkeyset\fR file for each child zone\&. +\fBdnssec\-signzone\fR +signs a zone. It generates NSEC and RRSIG records and produces a signed version of the zone. The security status of delegations from the signed zone (that is, whether the child zones are secure or not) is determined by the presence or absence of a +\fIkeyset\fR +file for each child zone. .SH "OPTIONS" .TP \-a -Verify all generated signatures\&. +Verify all generated signatures. .TP \-c \fIclass\fR -Specifies the DNS class of the zone\&. +Specifies the DNS class of the zone. .TP \-k \fIkey\fR -Treat specified key as a key signing key ignoring any key flags\&. This option may be specified multiple times\&. +Treat specified key as a key signing key ignoring any key flags. This option may be specified multiple times. .TP \-l \fIdomain\fR -Generate a DLV set in addition to the key (DNSKEY) and DS sets\&. The domain is appended to the name of the records\&. +Generate a DLV set in addition to the key (DNSKEY) and DS sets. The domain is appended to the name of the records. .TP \-d \fIdirectory\fR -Look for \fIkeyset\fR files in \fBdirectory\fR as the directory +Look for +\fIkeyset\fR +files in +\fBdirectory\fR +as the directory .TP \-g -Generate DS records for child zones from keyset files\&. Existing DS records will be removed\&. +Generate DS records for child zones from keyset files. Existing DS records will be removed. .TP \-s \fIstart\-time\fR -Specify the date and time when the generated RRSIG records become valid\&. This can be either an absolute or relative time\&. An absolute start time is indicated by a number 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 \fBstart\-time\fR is specified, the current time minus 1 hour (to allow for clock skew) is used\&. +Specify the date and time when the generated RRSIG records become valid. This can be either an absolute or relative time. An absolute start time is indicated by a number 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 +\fBstart\-time\fR +is specified, the current time minus 1 hour (to allow for clock skew) is used. .TP \-e \fIend\-time\fR -Specify the date and time when the generated RRSIG records expire\&. As with \fBstart\-time\fR, 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 \fBend\-time\fR is specified, 30 days from the start time is used as a default\&. +Specify the date and time when the generated RRSIG records expire. As with +\fBstart\-time\fR, 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 +\fBend\-time\fR +is specified, 30 days from the start time is used as a default. .TP \-f \fIoutput\-file\fR -The name of the output file containing the signed zone\&. The default is to append \fI\&.signed\fR to the input file\&. +The name of the output file containing the signed zone. The default is to append +\fI.signed\fR +to the input file. .TP \-h -Prints a short summary of the options and arguments to \fBdnssec\-signzone\fR\&. +Prints a short summary of the options and arguments to +\fBdnssec\-signzone\fR. .TP \-i \fIinterval\fR -When a previously signed zone is passed as input, records may be resigned\&. The \fBinterval\fR option specifies the cycle interval as an offset from the current time (in seconds)\&. If a RRSIG record expires after the cycle interval, it is retained\&. Otherwise, it is considered to be expiring soon, and it will be replaced\&. -The default cycle interval is one quarter of the difference between the signature end and start times\&. So if neither \fBend\-time\fR or \fBstart\-time\fR are specified, \fBdnssec\-signzone\fR generates signatures that are valid for 30 days, with a cycle interval of 7\&.5 days\&. Therefore, if any existing RRSIG records are due to expire in less than 7\&.5 days, they would be replaced\&. +When a previously signed zone is passed as input, records may be resigned. The +\fBinterval\fR +option specifies the cycle interval as an offset from the current time (in seconds). If a RRSIG record expires after the cycle interval, it is retained. Otherwise, it is considered to be expiring soon, and it will be replaced. +.sp +The default cycle interval is one quarter of the difference between the signature end and start times. So if neither +\fBend\-time\fR +or +\fBstart\-time\fR +are specified, +\fBdnssec\-signzone\fR +generates signatures that are valid for 30 days, with a cycle interval of 7.5 days. Therefore, if any existing RRSIG records are due to expire in less than 7.5 days, they would be replaced. .TP \-n \fIncpus\fR -Specifies the number of threads to use\&. By default, one thread is started for each detected CPU\&. +Specifies the number of threads to use. By default, one thread is started for each detected CPU. .TP \-o \fIorigin\fR -The zone origin\&. If not specified, the name of the zone file is assumed to be the origin\&. +The zone origin. If not specified, the name of the zone file is assumed to be the origin. .TP \-p -Use pseudo\-random data when signing the zone\&. This is faster, but less secure, than using real random data\&. This option may be useful when signing large zones or when the entropy source is limited\&. +Use pseudo\-random data when signing the zone. This is faster, but less secure, than using real random data. This option may be useful when signing large zones or when the entropy source is limited. .TP \-r \fIrandomdev\fR -Specifies the source of randomness\&. If the operating system does not provide a \fI/dev/random\fR or equivalent device, the default source of randomness is keyboard input\&. \fIrandomdev\fR specifies the name of a character device or file containing random data to be used instead of the default\&. The special value \fIkeyboard\fR indicates that keyboard input should be used\&. +Specifies the source of randomness. If the operating system does not provide a +\fI/dev/random\fR +or equivalent device, the default source of randomness is keyboard input. +\fIrandomdev\fR +specifies the name of a character device or file containing random data to be used instead of the default. The special value +\fIkeyboard\fR +indicates that keyboard input should be used. .TP \-t -Print statistics at completion\&. +Print statistics at completion. .TP \-v \fIlevel\fR -Sets the debugging level\&. +Sets the debugging level. .TP \-z -Ignore KSK flag on key when determining what to sign\&. +Ignore KSK flag on key when determining what to sign. .TP zonefile -The file containing the zone to be signed\&. +The file containing the zone to be signed. .TP key -The keys used to sign the zone\&. If no keys are specified, the default all zone keys that have private key files in the current directory\&. +The keys used to sign the zone. If no keys are specified, the default all zone keys that have private key files in the current directory. .SH "EXAMPLE" .PP -The following command signs the \fBexample\&.com\fR zone with the DSA key generated in the \fBdnssec\-keygen\fR man page\&. The zone's keys must be in the zone\&. If there are\fIkeyset\fR files associated with child zones, they must be in the current directory\&.\fBexample\&.com\fR, the following command would be issued: +The following command signs the +\fBexample.com\fR +zone with the DSA key generated in the +\fBdnssec\-keygen\fR +man page. The zone's keys must be in the zone. If there are +\fIkeyset\fR +files associated with child zones, they must be in the current directory. +\fBexample.com\fR, the following command would be issued: .PP - \fBdnssec\-signzone \-o example\&.com db\&.example\&.com Kexample\&.com\&.+003+26160\fR +\fBdnssec\-signzone \-o example.com db.example.com Kexample.com.+003+26160\fR .PP The command would print a string of the form: .PP -In this example, \fBdnssec\-signzone\fR creates the file \fIdb\&.example\&.com\&.signed\fR\&. This file should be referenced in a zone statement in a\fInamed\&.conf\fR file\&. +In this example, +\fBdnssec\-signzone\fR +creates the file +\fIdb.example.com.signed\fR. This file should be referenced in a zone statement in a +\fInamed.conf\fR +file. .SH "SEE ALSO" .PP - \fBdnssec\-keygen\fR(8), BIND 9 Administrator Reference Manual, RFC 2535\&. +\fBdnssec\-keygen\fR(8), +BIND 9 Administrator Reference Manual, +RFC 2535. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/dnssec/dnssec-signzone.c b/bin/dnssec/dnssec-signzone.c index f03697ff..93caf497 100644 --- a/bin/dnssec/dnssec-signzone.c +++ b/bin/dnssec/dnssec-signzone.c @@ -16,7 +16,7 @@ * IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: dnssec-signzone.c,v 1.139.2.2.4.20 2005/03/17 03:58:24 marka Exp $ */ +/* $Id: dnssec-signzone.c,v 1.139.2.2.4.21 2005/10/14 01:38:41 marka Exp $ */ #include <config.h> @@ -787,7 +787,6 @@ signname(dns_dbnode_t *node, dns_name_t *name) { dns_rdatasetiter_t *rdsiter; isc_boolean_t isdelegation = ISC_FALSE; isc_boolean_t hasds = ISC_FALSE; - isc_boolean_t atorigin; isc_boolean_t changed = ISC_FALSE; dns_diff_t del, add; char namestr[DNS_NAME_FORMATSIZE]; @@ -795,8 +794,6 @@ signname(dns_dbnode_t *node, dns_name_t *name) { dns_name_format(name, namestr, sizeof(namestr)); - atorigin = dns_name_equal(name, gorigin); - /* * Determine if this is a delegation point. */ @@ -1453,7 +1450,6 @@ warnifallksk(dns_db_t *db) { dns_dbnode_t *node = NULL; dns_rdataset_t rdataset; dns_rdata_t rdata = DNS_RDATA_INIT; - dst_key_t *pubkey; isc_result_t result; dns_rdata_key_t key; isc_boolean_t have_non_ksk = ISC_FALSE; @@ -1474,7 +1470,6 @@ warnifallksk(dns_db_t *db) { result = dns_rdataset_first(&rdataset); check_result(result, "dns_rdataset_first"); while (result == ISC_R_SUCCESS) { - pubkey = NULL; dns_rdata_reset(&rdata); dns_rdataset_current(&rdataset, &rdata); result = dns_rdata_tostruct(&rdata, &key, NULL); diff --git a/bin/dnssec/dnssec-signzone.html b/bin/dnssec/dnssec-signzone.html index 25ae78a9..5cc8c074 100644 --- a/bin/dnssec/dnssec-signzone.html +++ b/bin/dnssec/dnssec-signzone.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: dnssec-signzone.html,v 1.4.2.1.4.13 2005/07/18 02:36:45 marka Exp $ --> +<!-- $Id: dnssec-signzone.html,v 1.4.2.1.4.14 2005/10/13 02:33:46 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>dnssec-signzone</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">dnssec-signzone</span> — DNSSEC zone signing tool</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">dnssec-signzone</code> [<code class="option">-a</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-d <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-e <em class="replaceable"><code>end-time</code></em></code>] [<code class="option">-f <em class="replaceable"><code>output-file</code></em></code>] [<code class="option">-g</code>] [<code class="option">-h</code>] [<code class="option">-k <em class="replaceable"><code>key</code></em></code>] [<code class="option">-l <em class="replaceable"><code>domain</code></em></code>] [<code class="option">-i <em class="replaceable"><code>interval</code></em></code>] [<code class="option">-n <em class="replaceable"><code>nthreads</code></em></code>] [<code class="option">-o <em class="replaceable"><code>origin</code></em></code>] [<code class="option">-p</code>] [<code class="option">-r <em class="replaceable"><code>randomdev</code></em></code>] [<code class="option">-s <em class="replaceable"><code>start-time</code></em></code>] [<code class="option">-t</code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-z</code>] {zonefile} [key...]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514730"></a><h2>DESCRIPTION</h2> +<a name="id2525979"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">dnssec-signzone</strong></span> signs a zone. It generates NSEC and RRSIG records and produces a signed version of the @@ -43,7 +43,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514746"></a><h2>OPTIONS</h2> +<a name="id2525995"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-a</span></dt> <dd><p> @@ -179,7 +179,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515254"></a><h2>EXAMPLE</h2> +<a name="id2526435"></a><h2>EXAMPLE</h2> <p> The following command signs the <strong class="userinput"><code>example.com</code></strong> zone with the DSA key generated in the <span><strong class="command">dnssec-keygen</strong></span> @@ -203,7 +203,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515304"></a><h2>SEE ALSO</h2> +<a name="id2526485"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">dnssec-keygen</span>(8)</span>, <em class="citetitle">BIND 9 Administrator Reference Manual</em>, @@ -211,7 +211,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515331"></a><h2>AUTHOR</h2> +<a name="id2526512"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/named/lwresd.8 b/bin/named/lwresd.8 index 9bf17bee..58f24b06 100644 --- a/bin/named/lwresd.8 +++ b/bin/named/lwresd.8 @@ -13,96 +13,128 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwresd.8,v 1.13.208.4 2005/05/13 02:43:19 marka Exp $ +.\" $Id: lwresd.8,v 1.13.208.5 2005/10/13 02:33:47 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRESD" 8 "June 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRESD" "8" "June 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwresd \- lightweight resolver daemon .SH "SYNOPSIS" .HP 7 -\fBlwresd\fR [\fB\-C\ \fIconfig\-file\fR\fR] [\fB\-d\ \fIdebug\-level\fR\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-i\ \fIpid\-file\fR\fR] [\fB\-n\ \fI#cpus\fR\fR] [\fB\-P\ \fIport\fR\fR] [\fB\-p\ \fIport\fR\fR] [\fB\-s\fR] [\fB\-t\ \fIdirectory\fR\fR] [\fB\-u\ \fIuser\fR\fR] [\fB\-v\fR] +\fBlwresd\fR [\fB\-C\ \fR\fB\fIconfig\-file\fR\fR] [\fB\-d\ \fR\fB\fIdebug\-level\fR\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-i\ \fR\fB\fIpid\-file\fR\fR] [\fB\-n\ \fR\fB\fI#cpus\fR\fR] [\fB\-P\ \fR\fB\fIport\fR\fR] [\fB\-p\ \fR\fB\fIport\fR\fR] [\fB\-s\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-u\ \fR\fB\fIuser\fR\fR] [\fB\-v\fR] .SH "DESCRIPTION" .PP -\fBlwresd\fR is the daemon providing name lookup services to clients that use the BIND 9 lightweight resolver library\&. It is essentially a stripped\-down, caching\-only name server that answers queries using the BIND 9 lightweight resolver protocol rather than the DNS protocol\&. +\fBlwresd\fR +is the daemon providing name lookup services to clients that use the BIND 9 lightweight resolver library. It is essentially a stripped\-down, caching\-only name server that answers queries using the BIND 9 lightweight resolver protocol rather than the DNS protocol. .PP -\fBlwresd\fR listens for resolver queries on a UDP port on the IPv4 loopback interface, 127\&.0\&.0\&.1\&. This means that \fBlwresd\fR can only be used by processes running on the local machine\&. By default UDP port number 921 is used for lightweight resolver requests and responses\&. +\fBlwresd\fR +listens for resolver queries on a UDP port on the IPv4 loopback interface, 127.0.0.1. This means that +\fBlwresd\fR +can only be used by processes running on the local machine. By default UDP port number 921 is used for lightweight resolver requests and responses. .PP -Incoming lightweight resolver requests are decoded by the server which then resolves them using the DNS protocol\&. When the DNS lookup completes, \fBlwresd\fR encodes the answers in the lightweight resolver format and returns them to the client that made the request\&. +Incoming lightweight resolver requests are decoded by the server which then resolves them using the DNS protocol. When the DNS lookup completes, +\fBlwresd\fR +encodes the answers in the lightweight resolver format and returns them to the client that made the request. .PP -If \fI/etc/resolv\&.conf\fR contains any\fBnameserver\fR entries, \fBlwresd\fR sends recursive DNS queries to those servers\&. This is similar to the use of forwarders in a caching name server\&. If no\fBnameserver\fR entries are present, or if forwarding fails, \fBlwresd\fR resolves the queries autonomously starting at the root name servers, using a built\-in list of root server hints\&. +If +\fI/etc/resolv.conf\fR +contains any +\fBnameserver\fR +entries, +\fBlwresd\fR +sends recursive DNS queries to those servers. This is similar to the use of forwarders in a caching name server. If no +\fBnameserver\fR +entries are present, or if forwarding fails, +\fBlwresd\fR +resolves the queries autonomously starting at the root name servers, using a built\-in list of root server hints. .SH "OPTIONS" .TP \-C \fIconfig\-file\fR -Use \fIconfig\-file\fR as the configuration file instead of the default,\fI/etc/resolv\&.conf\fR\&. +Use +\fIconfig\-file\fR +as the configuration file instead of the default, +\fI/etc/resolv.conf\fR. .TP \-d \fIdebug\-level\fR -Set the daemon's debug level to \fIdebug\-level\fR\&. Debugging traces from \fBlwresd\fR become more verbose as the debug level increases\&. +Set the daemon's debug level to +\fIdebug\-level\fR. Debugging traces from +\fBlwresd\fR +become more verbose as the debug level increases. .TP \-f -Run the server in the foreground (i\&.e\&. do not daemonize)\&. +Run the server in the foreground (i.e. do not daemonize). .TP \-g -Run the server in the foreground and force all logging to \fIstderr\fR\&. +Run the server in the foreground and force all logging to +\fIstderr\fR. .TP \-n \fI#cpus\fR -Create \fI#cpus\fR worker threads to take advantage of multiple CPUs\&. If not specified,\fBlwresd\fR will try to determine the number of CPUs present and create one thread per CPU\&. If it is unable to determine the number of CPUs, a single worker thread will be created\&. +Create +\fI#cpus\fR +worker threads to take advantage of multiple CPUs. If not specified, +\fBlwresd\fR +will try to determine the number of CPUs present and create one thread per CPU. If it is unable to determine the number of CPUs, a single worker thread will be created. .TP \-P \fIport\fR -Listen for lightweight resolver queries on port\fIport\fR\&. If not specified, the default is port 921\&. +Listen for lightweight resolver queries on port +\fIport\fR. If not specified, the default is port 921. .TP \-p \fIport\fR -Send DNS lookups to port \fIport\fR\&. If not specified, the default is port 53\&. This provides a way of testing the lightweight resolver daemon with a name server that listens for queries on a non\-standard port number\&. +Send DNS lookups to port +\fIport\fR. If not specified, the default is port 53. This provides a way of testing the lightweight resolver daemon with a name server that listens for queries on a non\-standard port number. .TP \-s -Write memory usage statistics to \fIstdout\fR on exit\&. +Write memory usage statistics to +\fIstdout\fR +on exit. .RS .B "Note:" -This option is mainly of interest to BIND 9 developers and may be removed or changed in a future release\&. +This option is mainly of interest to BIND 9 developers and may be removed or changed in a future release. .RE .TP \-t \fIdirectory\fR -\fBchroot()\fR to \fIdirectory\fR after processing the command line arguments, but before reading the configuration file\&. +\fBchroot()\fR +to +\fIdirectory\fR +after processing the command line arguments, but before reading the configuration file. .RS .B "Warning:" -This option should be used in conjunction with the\fB\-u\fR option, as chrooting a process running as root doesn't enhance security on most systems; the way \fBchroot()\fR is defined allows a process with root privileges to escape a chroot jail\&. +This option should be used in conjunction with the +\fB\-u\fR +option, as chrooting a process running as root doesn't enhance security on most systems; the way +\fBchroot()\fR +is defined allows a process with root privileges to escape a chroot jail. .RE .TP \-u \fIuser\fR -\fBsetuid()\fR to \fIuser\fR after completing privileged operations, such as creating sockets that listen on privileged ports\&. +\fBsetuid()\fR +to +\fIuser\fR +after completing privileged operations, such as creating sockets that listen on privileged ports. .TP \-v -Report the version number and exit\&. +Report the version number and exit. .SH "FILES" .TP -\fI/etc/resolv\&.conf\fR -The default configuration file\&. +\fI/etc/resolv.conf\fR +The default configuration file. .TP -\fI/var/run/lwresd\&.pid\fR -The default process\-id file\&. +\fI/var/run/lwresd.pid\fR +The default process\-id file. .SH "SEE ALSO" .PP -\fBnamed\fR(8),\fBlwres\fR(3),\fBresolver\fR(5)\&. +\fBnamed\fR(8), +\fBlwres\fR(3), +\fBresolver\fR(5). .SH "AUTHOR" .PP -Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/named/lwresd.html b/bin/named/lwresd.html index 7424acc1..439153aa 100644 --- a/bin/named/lwresd.html +++ b/bin/named/lwresd.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwresd.html,v 1.4.2.1.4.7 2005/07/18 02:36:45 marka Exp $ --> +<!-- $Id: lwresd.html,v 1.4.2.1.4.8 2005/10/13 02:33:47 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwresd</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">lwresd</span> — lightweight resolver daemon</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">lwresd</code> [<code class="option">-C <em class="replaceable"><code>config-file</code></em></code>] [<code class="option">-d <em class="replaceable"><code>debug-level</code></em></code>] [<code class="option">-f</code>] [<code class="option">-g</code>] [<code class="option">-i <em class="replaceable"><code>pid-file</code></em></code>] [<code class="option">-n <em class="replaceable"><code>#cpus</code></em></code>] [<code class="option">-P <em class="replaceable"><code>port</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port</code></em></code>] [<code class="option">-s</code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-u <em class="replaceable"><code>user</code></em></code>] [<code class="option">-v</code>]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514670"></a><h2>DESCRIPTION</h2> +<a name="id2525920"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">lwresd</strong></span> is the daemon providing name lookup services to clients that use the BIND 9 lightweight resolver @@ -67,7 +67,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514720"></a><h2>OPTIONS</h2> +<a name="id2525969"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-C <em class="replaceable"><code>config-file</code></em></span></dt> <dd><p> @@ -159,7 +159,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515057"></a><h2>FILES</h2> +<a name="id2526237"></a><h2>FILES</h2> <div class="variablelist"><dl> <dt><span class="term"><code class="filename">/etc/resolv.conf</code></span></dt> <dd><p> @@ -172,7 +172,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515096"></a><h2>SEE ALSO</h2> +<a name="id2526277"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>, <span class="citerefentry"><span class="refentrytitle">lwres</span>(3)</span>, @@ -180,7 +180,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515134"></a><h2>AUTHOR</h2> +<a name="id2526315"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/named/named.8 b/bin/named/named.8 index d1887be6..e072c169 100644 --- a/bin/named/named.8 +++ b/bin/named/named.8 @@ -13,120 +13,170 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: named.8,v 1.17.208.5 2005/05/13 02:43:20 marka Exp $ +.\" $Id: named.8,v 1.17.208.6 2005/10/13 02:33:46 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "NAMED" 8 "June 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "NAMED" "8" "June 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" named \- Internet domain name server .SH "SYNOPSIS" .HP 6 -\fBnamed\fR [\fB\-4\fR] [\fB\-6\fR] [\fB\-c\ \fIconfig\-file\fR\fR] [\fB\-d\ \fIdebug\-level\fR\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-n\ \fI#cpus\fR\fR] [\fB\-p\ \fIport\fR\fR] [\fB\-s\fR] [\fB\-t\ \fIdirectory\fR\fR] [\fB\-u\ \fIuser\fR\fR] [\fB\-v\fR] [\fB\-x\ \fIcache\-file\fR\fR] +\fBnamed\fR [\fB\-4\fR] [\fB\-6\fR] [\fB\-c\ \fR\fB\fIconfig\-file\fR\fR] [\fB\-d\ \fR\fB\fIdebug\-level\fR\fR] [\fB\-f\fR] [\fB\-g\fR] [\fB\-n\ \fR\fB\fI#cpus\fR\fR] [\fB\-p\ \fR\fB\fIport\fR\fR] [\fB\-s\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-u\ \fR\fB\fIuser\fR\fR] [\fB\-v\fR] [\fB\-x\ \fR\fB\fIcache\-file\fR\fR] .SH "DESCRIPTION" .PP -\fBnamed\fR is a Domain Name System (DNS) server, part of the BIND 9 distribution from ISC\&. For more information on the DNS, see RFCs 1033, 1034, and 1035\&. +\fBnamed\fR +is a Domain Name System (DNS) server, part of the BIND 9 distribution from ISC. For more information on the DNS, see RFCs 1033, 1034, and 1035. .PP -When invoked without arguments, \fBnamed\fR will read the default configuration file\fI/etc/named\&.conf\fR, read any initial data, and listen for queries\&. +When invoked without arguments, +\fBnamed\fR +will read the default configuration file +\fI/etc/named.conf\fR, read any initial data, and listen for queries. .SH "OPTIONS" .TP \-4 -Use IPv4 only even if the host machine is capable of IPv6\&.\fB\-4\fR and \fB\-6\fR are mutually exclusive\&. +Use IPv4 only even if the host machine is capable of IPv6. +\fB\-4\fR +and +\fB\-6\fR +are mutually exclusive. .TP \-6 -Use IPv6 only even if the host machine is capable of IPv4\&.\fB\-4\fR and \fB\-6\fR are mutually exclusive\&. +Use IPv6 only even if the host machine is capable of IPv4. +\fB\-4\fR +and +\fB\-6\fR +are mutually exclusive. .TP \-c \fIconfig\-file\fR -Use \fIconfig\-file\fR as the configuration file instead of the default,\fI/etc/named\&.conf\fR\&. To ensure that reloading the configuration file continues to work after the server has changed its working directory due to to a possible\fBdirectory\fR option in the configuration file, \fIconfig\-file\fR should be an absolute pathname\&. +Use +\fIconfig\-file\fR +as the configuration file instead of the default, +\fI/etc/named.conf\fR. To ensure that reloading the configuration file continues to work after the server has changed its working directory due to to a possible +\fBdirectory\fR +option in the configuration file, +\fIconfig\-file\fR +should be an absolute pathname. .TP \-d \fIdebug\-level\fR -Set the daemon's debug level to \fIdebug\-level\fR\&. Debugging traces from \fBnamed\fR become more verbose as the debug level increases\&. +Set the daemon's debug level to +\fIdebug\-level\fR. Debugging traces from +\fBnamed\fR +become more verbose as the debug level increases. .TP \-f -Run the server in the foreground (i\&.e\&. do not daemonize)\&. +Run the server in the foreground (i.e. do not daemonize). .TP \-g -Run the server in the foreground and force all logging to \fIstderr\fR\&. +Run the server in the foreground and force all logging to +\fIstderr\fR. .TP \-n \fI#cpus\fR -Create \fI#cpus\fR worker threads to take advantage of multiple CPUs\&. If not specified,\fBnamed\fR will try to determine the number of CPUs present and create one thread per CPU\&. If it is unable to determine the number of CPUs, a single worker thread will be created\&. +Create +\fI#cpus\fR +worker threads to take advantage of multiple CPUs. If not specified, +\fBnamed\fR +will try to determine the number of CPUs present and create one thread per CPU. If it is unable to determine the number of CPUs, a single worker thread will be created. .TP \-p \fIport\fR -Listen for queries on port \fIport\fR\&. If not specified, the default is port 53\&. +Listen for queries on port +\fIport\fR. If not specified, the default is port 53. .TP \-s -Write memory usage statistics to \fIstdout\fR on exit\&. +Write memory usage statistics to +\fIstdout\fR +on exit. .RS .B "Note:" -This option is mainly of interest to BIND 9 developers and may be removed or changed in a future release\&. +This option is mainly of interest to BIND 9 developers and may be removed or changed in a future release. .RE .TP \-t \fIdirectory\fR -\fBchroot()\fR to \fIdirectory\fR after processing the command line arguments, but before reading the configuration file\&. +\fBchroot()\fR +to +\fIdirectory\fR +after processing the command line arguments, but before reading the configuration file. .RS .B "Warning:" -This option should be used in conjunction with the\fB\-u\fR option, as chrooting a process running as root doesn't enhance security on most systems; the way \fBchroot()\fR is defined allows a process with root privileges to escape a chroot jail\&. +This option should be used in conjunction with the +\fB\-u\fR +option, as chrooting a process running as root doesn't enhance security on most systems; the way +\fBchroot()\fR +is defined allows a process with root privileges to escape a chroot jail. .RE .TP \-u \fIuser\fR -\fBsetuid()\fR to \fIuser\fR after completing privileged operations, such as creating sockets that listen on privileged ports\&. +\fBsetuid()\fR +to +\fIuser\fR +after completing privileged operations, such as creating sockets that listen on privileged ports. .RS .B "Note:" -On Linux, \fBnamed\fR uses the kernel's capability mechanism to drop all root privileges except the ability to \fBbind()\fR to a privileged port and set process resource limits\&. Unfortunately, this means that the \fB\-u\fR option only works when \fBnamed\fR is run on kernel 2\&.2\&.18 or later, or kernel 2\&.3\&.99\-pre3 or later, since previous kernels did not allow privileges to be retained after \fBsetuid()\fR\&. +On Linux, +\fBnamed\fR +uses the kernel's capability mechanism to drop all root privileges except the ability to +\fBbind()\fR +to a privileged port and set process resource limits. Unfortunately, this means that the +\fB\-u\fR +option only works when +\fBnamed\fR +is run on kernel 2.2.18 or later, or kernel 2.3.99\-pre3 or later, since previous kernels did not allow privileges to be retained after +\fBsetuid()\fR. .RE .TP \-v -Report the version number and exit\&. +Report the version number and exit. .TP \-x \fIcache\-file\fR -Load data from \fIcache\-file\fR into the cache of the default view\&. +Load data from +\fIcache\-file\fR +into the cache of the default view. .RS .B "Warning:" -This option must not be used\&. It is only of interest to BIND 9 developers and may be removed or changed in a future release\&. +This option must not be used. It is only of interest to BIND 9 developers and may be removed or changed in a future release. .RE .SH "SIGNALS" .PP -In routine operation, signals should not be used to control the nameserver; \fBrndc\fR should be used instead\&. +In routine operation, signals should not be used to control the nameserver; +\fBrndc\fR +should be used instead. .TP SIGHUP -Force a reload of the server\&. +Force a reload of the server. .TP SIGINT, SIGTERM -Shut down the server\&. +Shut down the server. .PP -The result of sending any other signals to the server is undefined\&. +The result of sending any other signals to the server is undefined. .SH "CONFIGURATION" .PP -The \fBnamed\fR configuration file is too complex to describe in detail here\&. A complete description is provided in the BIND 9 Administrator Reference Manual\&. +The +\fBnamed\fR +configuration file is too complex to describe in detail here. A complete description is provided in the +BIND 9 Administrator Reference Manual. .SH "FILES" .TP -\fI/etc/named\&.conf\fR -The default configuration file\&. +\fI/etc/named.conf\fR +The default configuration file. .TP -\fI/var/run/named\&.pid\fR -The default process\-id file\&. +\fI/var/run/named.pid\fR +The default process\-id file. .SH "SEE ALSO" .PP -RFC 1033,RFC 1034,RFC 1035,\fBrndc\fR(8),\fBlwresd\fR(8),BIND 9 Administrator Reference Manual\&. +RFC 1033, +RFC 1034, +RFC 1035, +\fBrndc\fR(8), +\fBlwresd\fR(8), +BIND 9 Administrator Reference Manual. .SH "AUTHOR" .PP -Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/named/named.conf.5 b/bin/named/named.conf.5 index f188a8d1..d0b690b1 100644 --- a/bin/named/named.conf.5 +++ b/bin/named/named.conf.5 @@ -12,38 +12,29 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: named.conf.5,v 1.1.4.5 2005/05/13 02:43:20 marka Exp $ +.\" $Id: named.conf.5,v 1.1.4.6 2005/10/13 02:33:47 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "NAMED.CONF" 5 "Aug 13, 2004" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "\\FINAMED.CONF\\FR" "5" "Aug 13, 2004" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" named.conf \- configuration file for named .SH "SYNOPSIS" .HP 11 -\fBnamed\&.conf\fR +\fBnamed.conf\fR .SH "DESCRIPTION" .PP -\fInamed\&.conf\fR is the configuration file for\fBnamed\fR\&. Statements are enclosed in braces and terminated with a semi\-colon\&. Clauses in the statements are also semi\-colon terminated\&. The usual comment styles are supported: +\fInamed.conf\fR +is the configuration file for +\fBnamed\fR. Statements are enclosed in braces and terminated with a semi\-colon. Clauses in the statements are also semi\-colon terminated. The usual comment styles are supported: .PP C style: /* */ .PP @@ -51,10 +42,12 @@ C++ style: // to end of line .PP Unix style: # to end of line .SH "ACL" +.sp .nf -acl \fIstring\fR { \fIaddress_match_element\fR; \&.\&.\&. }; +acl \fIstring\fR { \fIaddress_match_element\fR; ... }; .fi .SH "KEY" +.sp .nf key \fIdomain_name\fR { algorithm \fIstring\fR; @@ -62,13 +55,15 @@ key \fIdomain_name\fR { }; .fi .SH "MASTERS" +.sp .nf masters \fIstring\fR [ port \fIinteger\fR ] { ( \fImasters\fR | \fIipv4_address\fR [port \fIinteger\fR] | - \fIipv6_address\fR [port \fIinteger\fR] ) [ key \fIstring\fR ]; \&.\&.\&. + \fIipv6_address\fR [port \fIinteger\fR] ) [ key \fIstring\fR ]; ... }; .fi .SH "SERVER" +.sp .nf server ( \fIipv4_address\fR | \fIipv6_address\fR ) { bogus \fIboolean\fR; @@ -85,23 +80,26 @@ server ( \fIipv4_address\fR | \fIipv6_address\fR ) { support\-ixfr \fIboolean\fR; // obsolete }; .fi -.SH "TRUSTED-KEYS" +.SH "TRUSTED\-KEYS" +.sp .nf trusted\-keys { - \fIdomain_name\fR \fIflags\fR \fIprotocol\fR \fIalgorithm\fR \fIkey\fR; \&.\&.\&. + \fIdomain_name\fR \fIflags\fR \fIprotocol\fR \fIalgorithm\fR \fIkey\fR; ... }; .fi .SH "CONTROLS" +.sp .nf controls { inet ( \fIipv4_address\fR | \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ] - allow { \fIaddress_match_element\fR; \&.\&.\&. } - [ keys { \fIstring\fR; \&.\&.\&. } ]; + allow { \fIaddress_match_element\fR; ... } + [ keys { \fIstring\fR; ... } ]; unix \fIunsupported\fR; // not implemented }; .fi .SH "LOGGING" +.sp .nf logging { channel \fIstring\fR { @@ -114,26 +112,28 @@ logging { print\-severity \fIboolean\fR; print\-category \fIboolean\fR; }; - category \fIstring\fR { \fIstring\fR; \&.\&.\&. }; + category \fIstring\fR { \fIstring\fR; ... }; }; .fi .SH "LWRES" +.sp .nf lwres { listen\-on [ port \fIinteger\fR ] { - ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; \&.\&.\&. + ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ... }; view \fIstring\fR \fIoptional_class\fR; - search { \fIstring\fR; \&.\&.\&. }; + search { \fIstring\fR; ... }; ndots \fIinteger\fR; }; .fi .SH "OPTIONS" +.sp .nf options { - avoid\-v4\-udp\-ports { \fIport\fR; \&.\&.\&. }; - avoid\-v6\-udp\-ports { \fIport\fR; \&.\&.\&. }; - blackhole { \fIaddress_match_element\fR; \&.\&.\&. }; + avoid\-v4\-udp\-ports { \fIport\fR; ... }; + avoid\-v6\-udp\-ports { \fIport\fR; ... }; + blackhole { \fIaddress_match_element\fR; ... }; coresize \fIsize\fR; datasize \fIsize\fR; directory \fIquoted_string\fR; @@ -144,8 +144,8 @@ options { host\-statistics\-max \fInumber\fR; // not implemented hostname ( \fIquoted_string\fR | none ); interface\-interval \fIinteger\fR; - listen\-on [ port \fIinteger\fR ] { \fIaddress_match_element\fR; \&.\&.\&. }; - listen\-on\-v6 [ port \fIinteger\fR ] { \fIaddress_match_element\fR; \&.\&.\&. }; + listen\-on [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... }; + listen\-on\-v6 [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... }; match\-mapped\-addresses \fIboolean\fR; memstatistics\-file \fIquoted_string\fR; pid\-file ( \fIquoted_string\fR | none ); @@ -169,15 +169,15 @@ options { transfers\-out \fIinteger\fR; use\-ixfr \fIboolean\fR; version ( \fIquoted_string\fR | none ); - allow\-recursion { \fIaddress_match_element\fR; \&.\&.\&. }; - sortlist { \fIaddress_match_element\fR; \&.\&.\&. }; - topology { \fIaddress_match_element\fR; \&.\&.\&. }; // not implemented + allow\-recursion { \fIaddress_match_element\fR; ... }; + sortlist { \fIaddress_match_element\fR; ... }; + topology { \fIaddress_match_element\fR; ... }; // not implemented auth\-nxdomain \fIboolean\fR; // default changed minimal\-responses \fIboolean\fR; recursion \fIboolean\fR; rrset\-order { [ class \fIstring\fR ] [ type \fIstring\fR ] - [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; \&.\&.\&. + [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; ... }; provide\-ixfr \fIboolean\fR; request\-ixfr \fIboolean\fR; @@ -201,28 +201,28 @@ options { dual\-stack\-servers [ port \fIinteger\fR ] { ( \fIquoted_string\fR [port \fIinteger\fR] | \fIipv4_address\fR [port \fIinteger\fR] | - \fIipv6_address\fR [port \fIinteger\fR] ); \&.\&.\&. + \fIipv6_address\fR [port \fIinteger\fR] ); ... } edns\-udp\-size \fIinteger\fR; - root\-delegation\-only [ exclude { \fIquoted_string\fR; \&.\&.\&. } ]; - disable\-algorithms \fIstring\fR { \fIstring\fR; \&.\&.\&. }; + root\-delegation\-only [ exclude { \fIquoted_string\fR; ... } ]; + disable\-algorithms \fIstring\fR { \fIstring\fR; ... }; dnssec\-enable \fIboolean\fR; dnssec\-lookaside \fIstring\fR trust\-anchor \fIstring\fR; dnssec\-must\-be\-secure \fIstring\fR \fIboolean\fR; dialup \fIdialuptype\fR; ixfr\-from\-differences \fIixfrdiff\fR; - allow\-query { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-transfer { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-update\-forwarding { \fIaddress_match_element\fR; \&.\&.\&. }; + allow\-query { \fIaddress_match_element\fR; ... }; + allow\-transfer { \fIaddress_match_element\fR; ... }; + allow\-update\-forwarding { \fIaddress_match_element\fR; ... }; notify \fInotifytype\fR; notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ]; notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ]; also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR ) - [ port \fIinteger\fR ]; \&.\&.\&. }; - allow\-notify { \fIaddress_match_element\fR; \&.\&.\&. }; + [ port \fIinteger\fR ]; ... }; + allow\-notify { \fIaddress_match_element\fR; ... }; forward ( first | only ); forwarders [ port \fIinteger\fR ] { - ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; \&.\&.\&. + ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ... }; max\-journal\-size \fIsize_no_default\fR; max\-transfer\-time\-in \fIinteger\fR; @@ -246,7 +246,7 @@ options { use\-alt\-transfer\-source \fIboolean\fR; zone\-statistics \fIboolean\fR; key\-directory \fIquoted_string\fR; - allow\-v6\-synthesis { \fIaddress_match_element\fR; \&.\&.\&. }; // obsolete + allow\-v6\-synthesis { \fIaddress_match_element\fR; ... }; // obsolete deallocate\-on\-exit \fIboolean\fR; // obsolete fake\-iquery \fIboolean\fR; // obsolete fetch\-glue \fIboolean\fR; // obsolete @@ -261,33 +261,34 @@ options { }; .fi .SH "VIEW" +.sp .nf view \fIstring\fR \fIoptional_class\fR { - match\-clients { \fIaddress_match_element\fR; \&.\&.\&. }; - match\-destinations { \fIaddress_match_element\fR; \&.\&.\&. }; + match\-clients { \fIaddress_match_element\fR; ... }; + match\-destinations { \fIaddress_match_element\fR; ... }; match\-recursive\-only \fIboolean\fR; key \fIstring\fR { algorithm \fIstring\fR; secret \fIstring\fR; }; zone \fIstring\fR \fIoptional_class\fR { - \&.\&.\&. + ... }; server ( \fIipv4_address\fR | \fIipv6_address\fR ) { - \&.\&.\&. + ... }; trusted\-keys { - \fIstring\fR \fIinteger\fR \fIinteger\fR \fIinteger\fR \fIquoted_string\fR; \&.\&.\&. + \fIstring\fR \fIinteger\fR \fIinteger\fR \fIinteger\fR \fIquoted_string\fR; ... }; - allow\-recursion { \fIaddress_match_element\fR; \&.\&.\&. }; - sortlist { \fIaddress_match_element\fR; \&.\&.\&. }; - topology { \fIaddress_match_element\fR; \&.\&.\&. }; // not implemented + allow\-recursion { \fIaddress_match_element\fR; ... }; + sortlist { \fIaddress_match_element\fR; ... }; + topology { \fIaddress_match_element\fR; ... }; // not implemented auth\-nxdomain \fIboolean\fR; // default changed minimal\-responses \fIboolean\fR; recursion \fIboolean\fR; rrset\-order { [ class \fIstring\fR ] [ type \fIstring\fR ] - [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; \&.\&.\&. + [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; ... }; provide\-ixfr \fIboolean\fR; request\-ixfr \fIboolean\fR; @@ -311,28 +312,28 @@ view \fIstring\fR \fIoptional_class\fR { dual\-stack\-servers [ port \fIinteger\fR ] { ( \fIquoted_string\fR [port \fIinteger\fR] | \fIipv4_address\fR [port \fIinteger\fR] | - \fIipv6_address\fR [port \fIinteger\fR] ); \&.\&.\&. + \fIipv6_address\fR [port \fIinteger\fR] ); ... }; edns\-udp\-size \fIinteger\fR; - root\-delegation\-only [ exclude { \fIquoted_string\fR; \&.\&.\&. } ]; - disable\-algorithms \fIstring\fR { \fIstring\fR; \&.\&.\&. }; + root\-delegation\-only [ exclude { \fIquoted_string\fR; ... } ]; + disable\-algorithms \fIstring\fR { \fIstring\fR; ... }; dnssec\-enable \fIboolean\fR; dnssec\-lookaside \fIstring\fR trust\-anchor \fIstring\fR; dnssec\-must\-be\-secure \fIstring\fR \fIboolean\fR; dialup \fIdialuptype\fR; ixfr\-from\-differences \fIixfrdiff\fR; - allow\-query { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-transfer { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-update\-forwarding { \fIaddress_match_element\fR; \&.\&.\&. }; + allow\-query { \fIaddress_match_element\fR; ... }; + allow\-transfer { \fIaddress_match_element\fR; ... }; + allow\-update\-forwarding { \fIaddress_match_element\fR; ... }; notify \fInotifytype\fR; notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ]; notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ]; also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR ) - [ port \fIinteger\fR ]; \&.\&.\&. }; - allow\-notify { \fIaddress_match_element\fR; \&.\&.\&. }; + [ port \fIinteger\fR ]; ... }; + allow\-notify { \fIaddress_match_element\fR; ... }; forward ( first | only ); forwarders [ port \fIinteger\fR ] { - ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; \&.\&.\&. + ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ... }; max\-journal\-size \fIsize_no_default\fR; max\-transfer\-time\-in \fIinteger\fR; @@ -356,13 +357,14 @@ view \fIstring\fR \fIoptional_class\fR { use\-alt\-transfer\-source \fIboolean\fR; zone\-statistics \fIboolean\fR; key\-directory \fIquoted_string\fR; - allow\-v6\-synthesis { \fIaddress_match_element\fR; \&.\&.\&. }; // obsolete + allow\-v6\-synthesis { \fIaddress_match_element\fR; ... }; // obsolete fetch\-glue \fIboolean\fR; // obsolete maintain\-ixfr\-base \fIboolean\fR; // obsolete max\-ixfr\-log\-size \fIsize\fR; // obsolete }; .fi .SH "ZONE" +.sp .nf zone \fIstring\fR \fIoptional_class\fR { type ( master | slave | stub | hint | @@ -371,31 +373,31 @@ zone \fIstring\fR \fIoptional_class\fR { masters [ port \fIinteger\fR ] { ( \fImasters\fR | \fIipv4_address\fR [port \fIinteger\fR] | - \fIipv6_address\fR [ port \fIinteger\fR ] ) [ key \fIstring\fR ]; \&.\&.\&. + \fIipv6_address\fR [ port \fIinteger\fR ] ) [ key \fIstring\fR ]; ... }; database \fIstring\fR; delegation\-only \fIboolean\fR; check\-names ( fail | warn | ignore ); dialup \fIdialuptype\fR; ixfr\-from\-differences \fIboolean\fR; - allow\-query { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-transfer { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-update { \fIaddress_match_element\fR; \&.\&.\&. }; - allow\-update\-forwarding { \fIaddress_match_element\fR; \&.\&.\&. }; + allow\-query { \fIaddress_match_element\fR; ... }; + allow\-transfer { \fIaddress_match_element\fR; ... }; + allow\-update { \fIaddress_match_element\fR; ... }; + allow\-update\-forwarding { \fIaddress_match_element\fR; ... }; update\-policy { ( grant | deny ) \fIstring\fR ( name | subdomain | wildcard | self ) \fIstring\fR - \fIrrtypelist\fR; \&.\&.\&. + \fIrrtypelist\fR; ... }; notify \fInotifytype\fR; notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ]; notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ]; also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR ) - [ port \fIinteger\fR ]; \&.\&.\&. }; - allow\-notify { \fIaddress_match_element\fR; \&.\&.\&. }; + [ port \fIinteger\fR ]; ... }; + allow\-notify { \fIaddress_match_element\fR; ... }; forward ( first | only ); forwarders [ port \fIinteger\fR ] { - ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; \&.\&.\&. + ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ... }; max\-journal\-size \fIsize_no_default\fR; max\-transfer\-time\-in \fIinteger\fR; @@ -428,7 +430,9 @@ zone \fIstring\fR \fIoptional_class\fR { .fi .SH "FILES" .PP - \fI/etc/named\&.conf\fR +\fI/etc/named.conf\fR .SH "SEE ALSO" .PP - \fBnamed\fR(8), \fBrndc\fR(8), \fBBIND 9 Adminstrators Reference Manual\fR()\&. +\fBnamed\fR(8), +\fBrndc\fR(8), +\fBBIND 9 Adminstrators Reference Manual\fR(). diff --git a/bin/named/named.conf.html b/bin/named/named.conf.html index d25407d1..8b3b517d 100644 --- a/bin/named/named.conf.html +++ b/bin/named/named.conf.html @@ -13,15 +13,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: named.conf.html,v 1.1.4.8 2005/07/18 02:36:45 marka Exp $ --> +<!-- $Id: named.conf.html,v 1.1.4.10 2005/10/13 02:33:48 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>named.conf</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><code class="filename">named.conf</code> — configuration file for named</p> @@ -31,7 +31,7 @@ <div class="cmdsynopsis"><p><code class="command">named.conf</code> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514571"></a><h2>DESCRIPTION</h2> +<a name="id2525889"></a><h2>DESCRIPTION</h2> <p> <code class="filename">named.conf</code> is the configuration file for <span><strong class="command">named</strong></span>. Statements are enclosed @@ -50,14 +50,14 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514600"></a><h2>ACL</h2> +<a name="id2525917"></a><h2>ACL</h2> <div class="literallayout"><p><br> acl <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>address_match_element</code></em>; ... };<br> <br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514616"></a><h2>KEY</h2> +<a name="id2525933"></a><h2>KEY</h2> <div class="literallayout"><p><br> key <em class="replaceable"><code>domain_name</code></em> {<br> algorithm <em class="replaceable"><code>string</code></em>;<br> @@ -66,7 +66,7 @@ key <em class="replaceable"><code>domain_name</code></em> {<br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514635"></a><h2>MASTERS</h2> +<a name="id2525953"></a><h2>MASTERS</h2> <div class="literallayout"><p><br> masters <em class="replaceable"><code>string</code></em> [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br> ( <em class="replaceable"><code>masters</code></em> | <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br> @@ -75,7 +75,7 @@ masters <em class="replaceable"><code>string</code></em> [<span class="optional" </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514749"></a><h2>SERVER</h2> +<a name="id2525998"></a><h2>SERVER</h2> <div class="literallayout"><p><br> server ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) {<br> bogus <em class="replaceable"><code>boolean</code></em>;<br> @@ -95,7 +95,7 @@ server ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="rep </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514807"></a><h2>TRUSTED-KEYS</h2> +<a name="id2526056"></a><h2>TRUSTED-KEYS</h2> <div class="literallayout"><p><br> trusted-keys {<br> <em class="replaceable"><code>domain_name</code></em> <em class="replaceable"><code>flags</code></em> <em class="replaceable"><code>protocol</code></em> <em class="replaceable"><code>algorithm</code></em> <em class="replaceable"><code>key</code></em>; ... <br> @@ -103,7 +103,7 @@ trusted-keys {<br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514833"></a><h2>CONTROLS</h2> +<a name="id2526082"></a><h2>CONTROLS</h2> <div class="literallayout"><p><br> controls {<br> inet ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> | * )<br> @@ -115,7 +115,7 @@ controls {<br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514868"></a><h2>LOGGING</h2> +<a name="id2526117"></a><h2>LOGGING</h2> <div class="literallayout"><p><br> logging {<br> channel <em class="replaceable"><code>string</code></em> {<br> @@ -133,7 +133,7 @@ logging {<br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514906"></a><h2>LWRES</h2> +<a name="id2526155"></a><h2>LWRES</h2> <div class="literallayout"><p><br> lwres {<br> listen-on [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br> @@ -146,7 +146,7 @@ lwres {<br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514948"></a><h2>OPTIONS</h2> +<a name="id2526197"></a><h2>OPTIONS</h2> <div class="literallayout"><p><br> options {<br> avoid-v4-udp-ports { <em class="replaceable"><code>port</code></em>; ... };<br> @@ -289,7 +289,7 @@ options {<br> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2515541"></a><h2>VIEW</h2> +<a name="id2526858"></a><h2>VIEW</h2> <div class="literallayout"><p><br> view <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br> match-clients { <em class="replaceable"><code>address_match_element</code></em>; ... };<br> @@ -407,7 +407,7 @@ view <em class="replaceable"><code>string</code></em> <em class="replaceable"><c </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2516088"></a><h2>ZONE</h2> +<a name="id2527269"></a><h2>ZONE</h2> <div class="literallayout"><p><br> zone <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br> type ( master | slave | stub | hint |<br> @@ -483,13 +483,13 @@ zone <em class="replaceable"><code>string</code></em> <em class="replaceable"><c </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2516357"></a><h2>FILES</h2> +<a name="id2527606"></a><h2>FILES</h2> <p> <code class="filename">/etc/named.conf</code> </p> </div> <div class="refsect1" lang="en"> -<a name="id2516370"></a><h2>SEE ALSO</h2> +<a name="id2527619"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>, <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>, diff --git a/bin/named/named.html b/bin/named/named.html index 85f6a5d2..f266e70a 100644 --- a/bin/named/named.html +++ b/bin/named/named.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: named.html,v 1.4.2.1.4.8 2005/07/18 02:36:46 marka Exp $ --> +<!-- $Id: named.html,v 1.4.2.1.4.9 2005/10/13 02:33:47 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>named</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">named</span> — Internet domain name server</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">named</code> [<code class="option">-4</code>] [<code class="option">-6</code>] [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>] [<code class="option">-d <em class="replaceable"><code>debug-level</code></em></code>] [<code class="option">-f</code>] [<code class="option">-g</code>] [<code class="option">-n <em class="replaceable"><code>#cpus</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port</code></em></code>] [<code class="option">-s</code>] [<code class="option">-t <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-u <em class="replaceable"><code>user</code></em></code>] [<code class="option">-v</code>] [<code class="option">-x <em class="replaceable"><code>cache-file</code></em></code>]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514674"></a><h2>DESCRIPTION</h2> +<a name="id2525923"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">named</strong></span> is a Domain Name System (DNS) server, part of the BIND 9 distribution from ISC. For more @@ -46,7 +46,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514699"></a><h2>OPTIONS</h2> +<a name="id2525948"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-4</span></dt> <dd><p> @@ -177,7 +177,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515116"></a><h2>SIGNALS</h2> +<a name="id2526297"></a><h2>SIGNALS</h2> <p> In routine operation, signals should not be used to control the nameserver; <span><strong class="command">rndc</strong></span> should be used @@ -198,7 +198,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515163"></a><h2>CONFIGURATION</h2> +<a name="id2526412"></a><h2>CONFIGURATION</h2> <p> The <span><strong class="command">named</strong></span> configuration file is too complex to describe in detail here. A complete description is @@ -207,7 +207,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515180"></a><h2>FILES</h2> +<a name="id2526429"></a><h2>FILES</h2> <div class="variablelist"><dl> <dt><span class="term"><code class="filename">/etc/named.conf</code></span></dt> <dd><p> @@ -220,7 +220,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515220"></a><h2>SEE ALSO</h2> +<a name="id2526469"></a><h2>SEE ALSO</h2> <p> <em class="citetitle">RFC 1033</em>, <em class="citetitle">RFC 1034</em>, @@ -231,7 +231,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515262"></a><h2>AUTHOR</h2> +<a name="id2526512"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/named/update.c b/bin/named/update.c index 325381a8..6c2d7597 100644 --- a/bin/named/update.c +++ b/bin/named/update.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 1999-2003 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: update.c,v 1.88.2.5.2.25 2004/10/21 01:40:22 marka Exp $ */ +/* $Id: update.c,v 1.88.2.5.2.27 2005/10/08 00:21:06 marka Exp $ */ #include <config.h> @@ -2723,8 +2723,8 @@ updatedone_action(isc_task_t *task, isc_event_t *event) { INSIST(client->nupdates > 0); client->nupdates--; respond(client, uev->result); - ns_client_detach(&client); isc_event_free(&event); + ns_client_detach(&client); } /* @@ -2740,8 +2740,8 @@ forward_fail(isc_task_t *task, isc_event_t *event) { INSIST(client->nupdates > 0); client->nupdates--; respond(client, DNS_R_SERVFAIL); - ns_client_detach(&client); isc_event_free(&event); + ns_client_detach(&client); } diff --git a/bin/named/xfrout.c b/bin/named/xfrout.c index 9fb2697a..687c287f 100644 --- a/bin/named/xfrout.c +++ b/bin/named/xfrout.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 1999-2003 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: xfrout.c,v 1.101.2.5.2.10 2004/04/02 06:08:17 marka Exp $ */ +/* $Id: xfrout.c,v 1.101.2.5.2.12 2005/10/14 02:13:05 marka Exp $ */ #include <config.h> @@ -868,7 +868,7 @@ xfrout_log1(ns_client_t *client, dns_name_t *zonename, const char *fmt, ...) ISC_FORMAT_PRINTF(5, 6); static void -xfrout_log(xfrout_ctx_t *xfr, unsigned int level, const char *fmt, ...) +xfrout_log(xfrout_ctx_t *xfr, int level, const char *fmt, ...) ISC_FORMAT_PRINTF(3, 4); /**************************************************************************/ @@ -1710,7 +1710,7 @@ xfrout_log1(ns_client_t *client, dns_name_t *zonename, * Logging function for use when there is a xfrout_ctx_t. */ static void -xfrout_log(xfrout_ctx_t *xfr, unsigned int level, const char *fmt, ...) { +xfrout_log(xfrout_ctx_t *xfr, int level, const char *fmt, ...) { va_list ap; va_start(ap, fmt); xfrout_logv(xfr->client, xfr->qname, xfr->qclass, level, fmt, ap); diff --git a/bin/nsupdate/nsupdate.8 b/bin/nsupdate/nsupdate.8 index 194e41ff..602a55b1 100644 --- a/bin/nsupdate/nsupdate.8 +++ b/bin/nsupdate/nsupdate.8 @@ -13,144 +13,286 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: nsupdate.8,v 1.24.2.2.2.7 2005/05/12 23:57:00 sra Exp $ +.\" $Id: nsupdate.8,v 1.24.2.2.2.8 2005/10/13 02:33:48 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "NSUPDATE" 8 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "NSUPDATE" "8" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" nsupdate \- Dynamic DNS update utility .SH "SYNOPSIS" .HP 9 -\fBnsupdate\fR [\fB\-d\fR] [\fB\fB\-y\ \fIkeyname:secret\fR\fR\fR | \fB\fB\-k\ \fIkeyfile\fR\fR\fR] [\fB\-t\ \fItimeout\fR\fR] [\fB\-u\ \fIudptimeout\fR\fR] [\fB\-r\ \fIudpretries\fR\fR] [\fB\-v\fR] [filename] +\fBnsupdate\fR [\fB\-d\fR] [[\fB\-y\ \fR\fB\fIkeyname:secret\fR\fR] [\fB\-k\ \fR\fB\fIkeyfile\fR\fR]] [\fB\-t\ \fR\fB\fItimeout\fR\fR] [\fB\-u\ \fR\fB\fIudptimeout\fR\fR] [\fB\-r\ \fR\fB\fIudpretries\fR\fR] [\fB\-v\fR] [filename] .SH "DESCRIPTION" .PP - \fBnsupdate\fR is used to submit Dynamic DNS Update requests as defined in RFC2136 to a name server\&. This allows resource records to be added or removed from a zone without manually editing the zone file\&. A single update request can contain requests to add or remove more than one resource record\&. +\fBnsupdate\fR +is used to submit Dynamic DNS Update requests as defined in RFC2136 to a name server. This allows resource records to be added or removed from a zone without manually editing the zone file. A single update request can contain requests to add or remove more than one resource record. .PP -Zones that are under dynamic control via \fBnsupdate\fR or a DHCP server should not be edited by hand\&. Manual edits could conflict with dynamic updates and cause data to be lost\&. +Zones that are under dynamic control via +\fBnsupdate\fR +or a DHCP server should not be edited by hand. Manual edits could conflict with dynamic updates and cause data to be lost. .PP -The resource records that are dynamically added or removed with \fBnsupdate\fR have to be in the same zone\&. Requests are sent to the zone's master server\&. This is identified by the MNAME field of the zone's SOA record\&. +The resource records that are dynamically added or removed with +\fBnsupdate\fR +have to be in the same zone. Requests are sent to the zone's master server. This is identified by the MNAME field of the zone's SOA record. .PP -The \fB\-d\fR option makes \fBnsupdate\fR operate in debug mode\&. This provides tracing information about the update requests that are made and the replies received from the name server\&. +The +\fB\-d\fR +option makes +\fBnsupdate\fR +operate in debug mode. This provides tracing information about the update requests that are made and the replies received from the name server. .PP -Transaction signatures can be used to authenticate the Dynamic DNS updates\&. These use the TSIG resource record type described in RFC2845 or the SIG(0) record described in RFC3535 and RFC2931\&. TSIG relies on a shared secret that should only be known to \fBnsupdate\fR and the name server\&. Currently, the only supported encryption algorithm for TSIG is HMAC\-MD5, which is defined in RFC 2104\&. Once other algorithms are defined for TSIG, applications will need to ensure they select the appropriate algorithm as well as the key when authenticating each other\&. For instance suitable \fBkey\fR and \fBserver\fR statements would be added to \fI/etc/named\&.conf\fR so that the name server can associate the appropriate secret key and algorithm with the IP address of the client application that will be using TSIG authentication\&. SIG(0) uses public key cryptography\&. To use a SIG(0) key, the public key must be stored in a KEY record in a zone served by the name server\&. \fBnsupdate\fR does not read \fI/etc/named\&.conf\fR\&. +Transaction signatures can be used to authenticate the Dynamic DNS updates. These use the TSIG resource record type described in RFC2845 or the SIG(0) record described in RFC3535 and RFC2931. TSIG relies on a shared secret that should only be known to +\fBnsupdate\fR +and the name server. Currently, the only supported encryption algorithm for TSIG is HMAC\-MD5, which is defined in RFC 2104. Once other algorithms are defined for TSIG, applications will need to ensure they select the appropriate algorithm as well as the key when authenticating each other. For instance suitable +\fBkey\fR +and +\fBserver\fR +statements would be added to +\fI/etc/named.conf\fR +so that the name server can associate the appropriate secret key and algorithm with the IP address of the client application that will be using TSIG authentication. SIG(0) uses public key cryptography. To use a SIG(0) key, the public key must be stored in a KEY record in a zone served by the name server. +\fBnsupdate\fR +does not read +\fI/etc/named.conf\fR. .PP - \fBnsupdate\fR uses the \fB\-y\fR or \fB\-k\fR 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 \fB\-k\fR option, \fBnsupdate\fR reads the shared secret from the file \fIkeyfile\fR, whose name is of the form \fIK{name}\&.+157\&.+{random}\&.private\fR\&. For historical reasons, the file \fIK{name}\&.+157\&.+{random}\&.key\fR must also be present\&. When the \fB\-y\fR option is used, a signature is generated from \fIkeyname:secret\&.\fR \fIkeyname\fR is the name of the key, and \fIsecret\fR is the base64 encoded shared secret\&. Use of the \fB\-y\fR option is discouraged because the shared secret is supplied as a command line argument in clear text\&. This may be visible in the output from \fBps\fR(1 ) or in a history file maintained by the user's shell\&. +\fBnsupdate\fR +uses the +\fB\-y\fR +or +\fB\-k\fR +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 +\fB\-k\fR +option, +\fBnsupdate\fR +reads the shared secret from the file +\fIkeyfile\fR, whose name is of the form +\fIK{name}.+157.+{random}.private\fR. For historical reasons, the file +\fIK{name}.+157.+{random}.key\fR +must also be present. When the +\fB\-y\fR +option is used, a signature is generated from +\fIkeyname:secret.\fR\fIkeyname\fR +is the name of the key, and +\fIsecret\fR +is the base64 encoded shared secret. Use of the +\fB\-y\fR +option is discouraged because the shared secret is supplied as a command line argument in clear text. This may be visible in the output from +\fBps\fR(1 ) +or in a history file maintained by the user's shell. .PP -The \fB\-k\fR 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\&. +The +\fB\-k\fR +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. .PP -By default \fBnsupdate\fR 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 \fB\-v\fR option makes \fBnsupdate\fR use a TCP connection\&. This may be preferable when a batch of update requests is made\&. +By default +\fBnsupdate\fR +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 +\fB\-v\fR +option makes +\fBnsupdate\fR +use a TCP connection. This may be preferable when a batch of update requests is made. .PP -The \fB\-t\fR 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\&. +The +\fB\-t\fR +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. .PP -The \fB\-u\fR 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\&. +The +\fB\-u\fR +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. .PP -The \fB\-r\fR option sets the number of UDP retries\&. The default is 3\&. If zero only one update request will be made\&. +The +\fB\-r\fR +option sets the number of UDP retries. The default is 3. If zero only one update request will be made. .SH "INPUT FORMAT" .PP - \fBnsupdate\fR reads input from \fIfilename\fR or standard input\&. Each command is supplied on exactly one line of input\&. Some commands are for administrative purposes\&. The others are either update instructions or prerequisite checks on the contents of the zone\&. These checks set conditions that some name or set of resource records (RRset) either exists or is absent from the zone\&. These conditions must be met if the entire update request is to succeed\&. Updates will be rejected if the tests for the prerequisite conditions fail\&. +\fBnsupdate\fR +reads input from +\fIfilename\fR +or standard input. Each command is supplied on exactly one line of input. Some commands are for administrative purposes. The others are either update instructions or prerequisite checks on the contents of the zone. These checks set conditions that some name or set of resource records (RRset) either exists or is absent from the zone. These conditions must be met if the entire update request is to succeed. Updates will be rejected if the tests for the prerequisite conditions fail. .PP -Every update request consists of zero or more prerequisites and zero or more updates\&. This allows a suitably authenticated update request to proceed if some specified resource records are present or missing from the zone\&. A blank input line (or the \fBsend\fR command) causes the accumulated commands to be sent as one Dynamic DNS update request to the name server\&. +Every update request consists of zero or more prerequisites and zero or more updates. This allows a suitably authenticated update request to proceed if some specified resource records are present or missing from the zone. A blank input line (or the +\fBsend\fR +command) causes the accumulated commands to be sent as one Dynamic DNS update request to the name server. .PP -The command formats and their meaning are as follows: +The command formats and their meaning are as follows: .TP .HP 7 \fBserver\fR {servername} [port] -Sends all dynamic update requests to the name server \fIservername\fR\&. When no server statement is provided, \fBnsupdate\fR 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\&. \fIport\fR is the port number on \fIservername\fR where the dynamic update requests get sent\&. If no port number is specified, the default DNS port number of 53 is used\&. +Sends all dynamic update requests to the name server +\fIservername\fR. When no server statement is provided, +\fBnsupdate\fR +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. +\fIport\fR +is the port number on +\fIservername\fR +where the dynamic update requests get sent. If no port number is specified, the default DNS port number of 53 is used. .TP .HP 6 \fBlocal\fR {address} [port] -Sends all dynamic update requests using the local \fIaddress\fR\&. When no local statement is provided, \fBnsupdate\fR will send updates using an address and port chosen by the system\&. \fIport\fR can additionally be used to make requests come from a specific port\&. If no port number is specified, the system will assign one\&. +Sends all dynamic update requests using the local +\fIaddress\fR. When no local statement is provided, +\fBnsupdate\fR +will send updates using an address and port chosen by the system. +\fIport\fR +can additionally be used to make requests come from a specific port. If no port number is specified, the system will assign one. .TP .HP 5 \fBzone\fR {zonename} -Specifies that all updates are to be made to the zone \fIzonename\fR\&. If no \fIzone\fR statement is provided, \fBnsupdate\fR will attempt determine the correct zone to update based on the rest of the input\&. +Specifies that all updates are to be made to the zone +\fIzonename\fR. If no +\fIzone\fR +statement is provided, +\fBnsupdate\fR +will attempt determine the correct zone to update based on the rest of the input. .TP .HP 6 \fBclass\fR {classname} -Specify the default class\&. If no \fIclass\fR is specified the default class is \fIIN\fR\&. +Specify the default class. If no +\fIclass\fR +is specified the default class is +\fIIN\fR. .TP .HP 4 \fBkey\fR {name} {secret} -Specifies that all updates are to be TSIG signed using the \fIkeyname\fR \fIkeysecret\fR pair\&. The \fBkey\fR command overrides any key specified on the command line via \fB\-y\fR or \fB\-k\fR\&. +Specifies that all updates are to be TSIG signed using the +\fIkeyname\fR\fIkeysecret\fR +pair. The +\fBkey\fR +command overrides any key specified on the command line via +\fB\-y\fR +or +\fB\-k\fR. .TP .HP 16 \fBprereq nxdomain\fR {domain\-name} -Requires that no resource record of any type exists with name \fIdomain\-name\fR\&. +Requires that no resource record of any type exists with name +\fIdomain\-name\fR. .TP .HP 16 \fBprereq yxdomain\fR {domain\-name} -Requires that \fIdomain\-name\fR exists (has as at least one resource record, of any type)\&. +Requires that +\fIdomain\-name\fR +exists (has as at least one resource record, of any type). .TP .HP 15 \fBprereq nxrrset\fR {domain\-name} [class] {type} -Requires that no resource record exists of the specified \fItype\fR, \fIclass\fR and \fIdomain\-name\fR\&. If \fIclass\fR is omitted, IN (internet) is assumed\&. +Requires that no resource record exists of the specified +\fItype\fR, +\fIclass\fR +and +\fIdomain\-name\fR. If +\fIclass\fR +is omitted, IN (internet) is assumed. .TP .HP 15 \fBprereq yxrrset\fR {domain\-name} [class] {type} -This requires that a resource record of the specified \fItype\fR, \fIclass\fR and \fIdomain\-name\fR must exist\&. If \fIclass\fR is omitted, IN (internet) is assumed\&. +This requires that a resource record of the specified +\fItype\fR, +\fIclass\fR +and +\fIdomain\-name\fR +must exist. If +\fIclass\fR +is omitted, IN (internet) is assumed. .TP .HP 15 \fBprereq yxrrset\fR {domain\-name} [class] {type} {data...} -The \fIdata\fR from each set of prerequisites of this form sharing a common \fItype\fR, \fIclass\fR, and \fIdomain\-name\fR 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 \fItype\fR, \fIclass\fR, and \fIdomain\-name\fR\&. The \fIdata\fR are written in the standard text representation of the resource record's RDATA\&. +The +\fIdata\fR +from each set of prerequisites of this form sharing a common +\fItype\fR, +\fIclass\fR, and +\fIdomain\-name\fR +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 +\fItype\fR, +\fIclass\fR, and +\fIdomain\-name\fR. The +\fIdata\fR +are written in the standard text representation of the resource record's RDATA. .TP .HP 14 \fBupdate delete\fR {domain\-name} [ttl] [class] [type\ [data...]] -Deletes any resource records named \fIdomain\-name\fR\&. If \fItype\fR and \fIdata\fR is provided, only matching resource records will be removed\&. The internet class is assumed if \fIclass\fR is not supplied\&. The \fIttl\fR is ignored, and is only allowed for compatibility\&. +Deletes any resource records named +\fIdomain\-name\fR. If +\fItype\fR +and +\fIdata\fR +is provided, only matching resource records will be removed. The internet class is assumed if +\fIclass\fR +is not supplied. The +\fIttl\fR +is ignored, and is only allowed for compatibility. .TP .HP 11 \fBupdate add\fR {domain\-name} {ttl} [class] {type} {data...} -Adds a new resource record with the specified \fIttl\fR, \fIclass\fR and \fIdata\fR\&. +Adds a new resource record with the specified +\fIttl\fR, +\fIclass\fR +and +\fIdata\fR. .TP .HP 5 \fBshow\fR -Displays the current message, containing all of the prerequisites and updates specified since the last send\&. +Displays the current message, containing all of the prerequisites and updates specified since the last send. .TP .HP 5 \fBsend\fR -Sends the current message\&. This is equivalent to entering a blank line\&. +Sends the current message. This is equivalent to entering a blank line. .TP .HP 7 \fBanswer\fR -Displays the answer\&. +Displays the answer. .PP -Lines beginning with a semicolon are comments and are ignored\&. +Lines beginning with a semicolon are comments and are ignored. .SH "EXAMPLES" .PP -The examples below show how \fBnsupdate\fR could be used to insert and delete resource records from the \fBexample\&.com\fR zone\&. Notice that the input in each example contains a trailing blank line so that a group of commands are sent as one dynamic update request to the master name server for \fBexample\&.com\fR\&. +The examples below show how +\fBnsupdate\fR +could be used to insert and delete resource records from the +\fBexample.com\fR +zone. Notice that the input in each example contains a trailing blank line so that a group of commands are sent as one dynamic update request to the master name server for +\fBexample.com\fR. +.sp .nf # nsupdate -> update delete oldhost\&.example\&.com A -> update add newhost\&.example\&.com 86400 A 172\&.16\&.1\&.1 +> update delete oldhost.example.com A +> update add newhost.example.com 86400 A 172.16.1.1 > send .fi +.sp .PP -Any A records for \fBoldhost\&.example\&.com\fR are deleted\&. and an A record for \fBnewhost\&.example\&.com\fR it IP address 172\&.16\&.1\&.1 is added\&. The newly\-added record has a 1 day TTL (86400 seconds) +Any A records for +\fBoldhost.example.com\fR +are deleted. and an A record for +\fBnewhost.example.com\fR +it IP address 172.16.1.1 is added. The newly\-added record has a 1 day TTL (86400 seconds) +.sp .nf # nsupdate -> prereq nxdomain nickname\&.example\&.com -> update add nickname\&.example\&.com 86400 CNAME somehost\&.example\&.com +> prereq nxdomain nickname.example.com +> update add nickname.example.com 86400 CNAME somehost.example.com > send .fi +.sp .PP -The prerequisite condition gets the name server to check that there are no resource records of any type for \fBnickname\&.example\&.com\fR\&. If there are, the update request fails\&. If this name does not exist, a CNAME for it is added\&. This ensures that when the CNAME is added, it cannot conflict with the long\-standing rule in RFC1034 that a name must not exist as any other record type if it exists as a CNAME\&. (The rule has been updated for DNSSEC in RFC2535 to allow CNAMEs to have RRSIG, DNSKEY and NSEC records\&.) +The prerequisite condition gets the name server to check that there are no resource records of any type for +\fBnickname.example.com\fR. If there are, the update request fails. If this name does not exist, a CNAME for it is added. This ensures that when the CNAME is added, it cannot conflict with the long\-standing rule in RFC1034 that a name must not exist as any other record type if it exists as a CNAME. (The rule has been updated for DNSSEC in RFC2535 to allow CNAMEs to have RRSIG, DNSKEY and NSEC records.) .SH "FILES" .TP -\fB/etc/resolv\&.conf\fR +\fB/etc/resolv.conf\fR used to identify default name server .TP -\fBK{name}\&.+157\&.+{random}\&.key\fR -base\-64 encoding of HMAC\-MD5 key created by \fBdnssec\-keygen\fR(8)\&. +\fBK{name}.+157.+{random}.key\fR +base\-64 encoding of HMAC\-MD5 key created by +\fBdnssec\-keygen\fR(8). .TP -\fBK{name}\&.+157\&.+{random}\&.private\fR -base\-64 encoding of HMAC\-MD5 key created by \fBdnssec\-keygen\fR(8)\&. +\fBK{name}.+157.+{random}.private\fR +base\-64 encoding of HMAC\-MD5 key created by +\fBdnssec\-keygen\fR(8). .SH "SEE ALSO" .PP - \fBRFC2136\fR(), \fBRFC3007\fR(), \fBRFC2104\fR(), \fBRFC2845\fR(), \fBRFC1034\fR(), \fBRFC2535\fR(), \fBRFC2931\fR(), \fBnamed\fR(8), \fBdnssec\-keygen\fR(8)\&. +\fBRFC2136\fR(), +\fBRFC3007\fR(), +\fBRFC2104\fR(), +\fBRFC2845\fR(), +\fBRFC1034\fR(), +\fBRFC2535\fR(), +\fBRFC2931\fR(), +\fBnamed\fR(8), +\fBdnssec\-keygen\fR(8). .SH "BUGS" .PP -The TSIG key is redundantly stored in two separate files\&. This is a consequence of nsupdate using the DST library for its cryptographic operations, and may change in future releases\&. +The TSIG key is redundantly stored in two separate files. This is a consequence of nsupdate using the DST library for its cryptographic operations, and may change in future releases. diff --git a/bin/nsupdate/nsupdate.html b/bin/nsupdate/nsupdate.html index 7a1fd4b3..74ba2fbe 100644 --- a/bin/nsupdate/nsupdate.html +++ b/bin/nsupdate/nsupdate.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: nsupdate.html,v 1.9.2.3.2.10 2005/07/18 02:36:46 marka Exp $ --> +<!-- $Id: nsupdate.html,v 1.9.2.3.2.12 2005/10/13 02:33:49 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>nsupdate</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>nsupdate — Dynamic DNS update utility</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">nsupdate</code> [<code class="option">-d</code>] [[<code class="option">-y <em class="replaceable"><code>keyname:secret</code></em></code>] | [<code class="option">-k <em class="replaceable"><code>keyfile</code></em></code>]] [<code class="option">-t <em class="replaceable"><code>timeout</code></em></code>] [<code class="option">-u <em class="replaceable"><code>udptimeout</code></em></code>] [<code class="option">-r <em class="replaceable"><code>udpretries</code></em></code>] [<code class="option">-v</code>] [filename]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514579"></a><h2>DESCRIPTION</h2> +<a name="id2525896"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">nsupdate</strong></span> is used to submit Dynamic DNS Update requests as defined in RFC2136 @@ -160,7 +160,7 @@ and number of UDP retries. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514872"></a><h2>INPUT FORMAT</h2> +<a name="id2526121"></a><h2>INPUT FORMAT</h2> <p> <span><strong class="command">nsupdate</strong></span> reads input from @@ -370,7 +370,7 @@ Lines beginning with a semicolon are comments and are ignored. </p> </div> <div class="refsect1" lang="en"> -<a name="id2515569"></a><h2>EXAMPLES</h2> +<a name="id2526749"></a><h2>EXAMPLES</h2> <p> The examples below show how <span><strong class="command">nsupdate</strong></span> @@ -423,7 +423,7 @@ RRSIG, DNSKEY and NSEC records.) </p> </div> <div class="refsect1" lang="en"> -<a name="id2515612"></a><h2>FILES</h2> +<a name="id2526793"></a><h2>FILES</h2> <div class="variablelist"><dl> <dt><span class="term"><code class="constant">/etc/resolv.conf</code></span></dt> <dd><p> @@ -442,7 +442,7 @@ base-64 encoding of HMAC-MD5 key created by </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2514315"></a><h2>SEE ALSO</h2> +<a name="id2525155"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">RFC2136</span></span>, <span class="citerefentry"><span class="refentrytitle">RFC3007</span></span>, @@ -456,7 +456,7 @@ base-64 encoding of HMAC-MD5 key created by </p> </div> <div class="refsect1" lang="en"> -<a name="id2514387"></a><h2>BUGS</h2> +<a name="id2525226"></a><h2>BUGS</h2> <p> The TSIG key is redundantly stored in two separate files. This is a consequence of nsupdate using the DST library diff --git a/bin/rndc/rndc-confgen.8 b/bin/rndc/rndc-confgen.8 index 522710d0..b29f0095 100644 --- a/bin/rndc/rndc-confgen.8 +++ b/bin/rndc/rndc-confgen.8 @@ -13,83 +13,171 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: rndc-confgen.8,v 1.3.2.5.2.6 2005/05/13 02:43:21 marka Exp $ +.\" $Id: rndc-confgen.8,v 1.3.2.5.2.7 2005/10/13 02:33:50 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "RNDC-CONFGEN" 8 "Aug 27, 2001" "" "" -.SH NAME -rndc-confgen \- rndc key generation tool +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "RNDC\-CONFGEN" "8" "Aug 27, 2001" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +rndc\-confgen \- rndc key generation tool .SH "SYNOPSIS" .HP 13 -\fBrndc\-confgen\fR [\fB\-a\fR] [\fB\-b\ \fIkeysize\fR\fR] [\fB\-c\ \fIkeyfile\fR\fR] [\fB\-h\fR] [\fB\-k\ \fIkeyname\fR\fR] [\fB\-p\ \fIport\fR\fR] [\fB\-r\ \fIrandomfile\fR\fR] [\fB\-s\ \fIaddress\fR\fR] [\fB\-t\ \fIchrootdir\fR\fR] [\fB\-u\ \fIuser\fR\fR] +\fBrndc\-confgen\fR [\fB\-a\fR] [\fB\-b\ \fR\fB\fIkeysize\fR\fR] [\fB\-c\ \fR\fB\fIkeyfile\fR\fR] [\fB\-h\fR] [\fB\-k\ \fR\fB\fIkeyname\fR\fR] [\fB\-p\ \fR\fB\fIport\fR\fR] [\fB\-r\ \fR\fB\fIrandomfile\fR\fR] [\fB\-s\ \fR\fB\fIaddress\fR\fR] [\fB\-t\ \fR\fB\fIchrootdir\fR\fR] [\fB\-u\ \fR\fB\fIuser\fR\fR] .SH "DESCRIPTION" .PP - \fBrndc\-confgen\fR generates configuration files for \fBrndc\fR\&. It can be used as a convenient alternative to writing the \fIrndc\&.conf\fR file and the corresponding \fBcontrols\fR and \fBkey\fR statements in \fInamed\&.conf\fR by hand\&. Alternatively, it can be run with the \fB\-a\fR option to set up a \fIrndc\&.key\fR file and avoid the need for a \fIrndc\&.conf\fR file and a \fBcontrols\fR statement altogether\&. +\fBrndc\-confgen\fR +generates configuration files for +\fBrndc\fR. It can be used as a convenient alternative to writing the +\fIrndc.conf\fR +file and the corresponding +\fBcontrols\fR +and +\fBkey\fR +statements in +\fInamed.conf\fR +by hand. Alternatively, it can be run with the +\fB\-a\fR +option to set up a +\fIrndc.key\fR +file and avoid the need for a +\fIrndc.conf\fR +file and a +\fBcontrols\fR +statement altogether. .SH "OPTIONS" .TP \-a -Do automatic \fBrndc\fR configuration\&. This creates a file \fIrndc\&.key\fR in \fI/etc\fR (or whatever \fIsysconfdir\fR was specified as when BIND was built) that is read by both \fBrndc\fR and \fBnamed\fR on startup\&. The \fIrndc\&.key\fR file defines a default command channel and authentication key allowing \fBrndc\fR to communicate with \fBnamed\fR on the local host with no further configuration\&. -Running \fBrndc\-confgen \-a\fR allows BIND 9 and \fBrndc\fR to be used as drop\-in replacements for BIND 8 and \fBndc\fR, with no changes to the existing BIND 8 \fInamed\&.conf\fR file\&. -If a more elaborate configuration than that generated by \fBrndc\-confgen \-a\fR is required, for example if rndc is to be used remotely, you should run \fBrndc\-confgen\fR without the \fB\-a\fR option and set up a \fIrndc\&.conf\fR and \fInamed\&.conf\fR as directed\&. +Do automatic +\fBrndc\fR +configuration. This creates a file +\fIrndc.key\fR +in +\fI/etc\fR +(or whatever +\fIsysconfdir\fR +was specified as when +BIND +was built) that is read by both +\fBrndc\fR +and +\fBnamed\fR +on startup. The +\fIrndc.key\fR +file defines a default command channel and authentication key allowing +\fBrndc\fR +to communicate with +\fBnamed\fR +on the local host with no further configuration. +.sp +Running +\fBrndc\-confgen \-a\fR +allows BIND 9 and +\fBrndc\fR +to be used as drop\-in replacements for BIND 8 and +\fBndc\fR, with no changes to the existing BIND 8 +\fInamed.conf\fR +file. +.sp +If a more elaborate configuration than that generated by +\fBrndc\-confgen \-a\fR +is required, for example if rndc is to be used remotely, you should run +\fBrndc\-confgen\fR +without the +\fB\-a\fR +option and set up a +\fIrndc.conf\fR +and +\fInamed.conf\fR +as directed. .TP \-b \fIkeysize\fR -Specifies the size of the authentication key in bits\&. Must be between 1 and 512 bits; the default is 128\&. +Specifies the size of the authentication key in bits. Must be between 1 and 512 bits; the default is 128. .TP \-c \fIkeyfile\fR -Used with the \fB\-a\fR option to specify an alternate location for \fIrndc\&.key\fR\&. +Used with the +\fB\-a\fR +option to specify an alternate location for +\fIrndc.key\fR. .TP \-h -Prints a short summary of the options and arguments to \fBrndc\-confgen\fR\&. +Prints a short summary of the options and arguments to +\fBrndc\-confgen\fR. .TP \-k \fIkeyname\fR -Specifies the key name of the rndc authentication key\&. This must be a valid domain name\&. The default is \fBrndc\-key\fR\&. +Specifies the key name of the rndc authentication key. This must be a valid domain name. The default is +\fBrndc\-key\fR. .TP \-p \fIport\fR -Specifies the command channel port where \fBnamed\fR listens for connections from \fBrndc\fR\&. The default is 953\&. +Specifies the command channel port where +\fBnamed\fR +listens for connections from +\fBrndc\fR. The default is 953. .TP \-r \fIrandomfile\fR -Specifies a source of random data for generating the authorization\&. If the operating system does not provide a \fI/dev/random\fR or equivalent device, the default source of randomness is keyboard input\&. \fIrandomdev\fR specifies the name of a character device or file containing random data to be used instead of the default\&. The special value \fIkeyboard\fR indicates that keyboard input should be used\&. +Specifies a source of random data for generating the authorization. If the operating system does not provide a +\fI/dev/random\fR +or equivalent device, the default source of randomness is keyboard input. +\fIrandomdev\fR +specifies the name of a character device or file containing random data to be used instead of the default. The special value +\fIkeyboard\fR +indicates that keyboard input should be used. .TP \-s \fIaddress\fR -Specifies the IP address where \fBnamed\fR listens for command channel connections from \fBrndc\fR\&. The default is the loopback address 127\&.0\&.0\&.1\&. +Specifies the IP address where +\fBnamed\fR +listens for command channel connections from +\fBrndc\fR. The default is the loopback address 127.0.0.1. .TP \-t \fIchrootdir\fR -Used with the \fB\-a\fR option to specify a directory where \fBnamed\fR will run chrooted\&. An additional copy of the \fIrndc\&.key\fR will be written relative to this directory so that it will be found by the chrooted \fBnamed\fR\&. +Used with the +\fB\-a\fR +option to specify a directory where +\fBnamed\fR +will run chrooted. An additional copy of the +\fIrndc.key\fR +will be written relative to this directory so that it will be found by the chrooted +\fBnamed\fR. .TP \-u \fIuser\fR -Used with the \fB\-a\fR option to set the owner of the \fIrndc\&.key\fR file generated\&. If \fB\-t\fR is also specified only the file in the chroot area has its owner changed\&. +Used with the +\fB\-a\fR +option to set the owner of the +\fIrndc.key\fR +file generated. If +\fB\-t\fR +is also specified only the file in the chroot area has its owner changed. .SH "EXAMPLES" .PP -To allow \fBrndc\fR to be used with no manual configuration, run +To allow +\fBrndc\fR +to be used with no manual configuration, run .PP - \fBrndc\-confgen \-a\fR +\fBrndc\-confgen \-a\fR .PP -To print a sample \fIrndc\&.conf\fR file and corresponding \fBcontrols\fR and \fBkey\fR statements to be manually inserted into \fInamed\&.conf\fR, run +To print a sample +\fIrndc.conf\fR +file and corresponding +\fBcontrols\fR +and +\fBkey\fR +statements to be manually inserted into +\fInamed.conf\fR, run .PP - \fBrndc\-confgen\fR +\fBrndc\-confgen\fR .SH "SEE ALSO" .PP - \fBrndc\fR(8), \fBrndc\&.conf\fR(5), \fBnamed\fR(8), BIND 9 Administrator Reference Manual\&. +\fBrndc\fR(8), +\fBrndc.conf\fR(5), +\fBnamed\fR(8), +BIND 9 Administrator Reference Manual. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/rndc/rndc-confgen.html b/bin/rndc/rndc-confgen.html index 8b648b00..ca754008 100644 --- a/bin/rndc/rndc-confgen.html +++ b/bin/rndc/rndc-confgen.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: rndc-confgen.html,v 1.3.2.5.2.9 2005/07/18 02:36:46 marka Exp $ --> +<!-- $Id: rndc-confgen.html,v 1.3.2.5.2.11 2005/10/13 02:33:51 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>rndc-confgen</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">rndc-confgen</span> — rndc key generation tool</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">rndc-confgen</code> [<code class="option">-a</code>] [<code class="option">-b <em class="replaceable"><code>keysize</code></em></code>] [<code class="option">-c <em class="replaceable"><code>keyfile</code></em></code>] [<code class="option">-h</code>] [<code class="option">-k <em class="replaceable"><code>keyname</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port</code></em></code>] [<code class="option">-r <em class="replaceable"><code>randomfile</code></em></code>] [<code class="option">-s <em class="replaceable"><code>address</code></em></code>] [<code class="option">-t <em class="replaceable"><code>chrootdir</code></em></code>] [<code class="option">-u <em class="replaceable"><code>user</code></em></code>]</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514594"></a><h2>DESCRIPTION</h2> +<a name="id2525911"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">rndc-confgen</strong></span> generates configuration files for <span><strong class="command">rndc</strong></span>. It can be used as a @@ -48,7 +48,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514708"></a><h2>OPTIONS</h2> +<a name="id2525957"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-a</span></dt> <dd> @@ -148,7 +148,7 @@ </dl></div> </div> <div class="refsect1" lang="en"> -<a name="id2515090"></a><h2>EXAMPLES</h2> +<a name="id2526270"></a><h2>EXAMPLES</h2> <p> To allow <span><strong class="command">rndc</strong></span> to be used with no manual configuration, run @@ -167,7 +167,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515133"></a><h2>SEE ALSO</h2> +<a name="id2526314"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>, <span class="citerefentry"><span class="refentrytitle">rndc.conf</span>(5)</span>, @@ -176,7 +176,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515176"></a><h2>AUTHOR</h2> +<a name="id2526357"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/rndc/rndc.8 b/bin/rndc/rndc.8 index 5ea9d4b0..fba5529e 100644 --- a/bin/rndc/rndc.8 +++ b/bin/rndc/rndc.8 @@ -13,73 +13,106 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: rndc.8,v 1.24.206.4 2005/05/12 23:57:01 sra Exp $ +.\" $Id: rndc.8,v 1.24.206.5 2005/10/13 02:33:49 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "RNDC" 8 "June 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "RNDC" "8" "June 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" rndc \- name server control utility .SH "SYNOPSIS" .HP 5 -\fBrndc\fR [\fB\-c\ \fIconfig\-file\fR\fR] [\fB\-k\ \fIkey\-file\fR\fR] [\fB\-s\ \fIserver\fR\fR] [\fB\-p\ \fIport\fR\fR] [\fB\-V\fR] [\fB\-y\ \fIkey_id\fR\fR] {command} +\fBrndc\fR [\fB\-c\ \fR\fB\fIconfig\-file\fR\fR] [\fB\-k\ \fR\fB\fIkey\-file\fR\fR] [\fB\-s\ \fR\fB\fIserver\fR\fR] [\fB\-p\ \fR\fB\fIport\fR\fR] [\fB\-V\fR] [\fB\-y\ \fR\fB\fIkey_id\fR\fR] {command} .SH "DESCRIPTION" .PP - \fBrndc\fR controls the operation of a name server\&. It supersedes the \fBndc\fR utility that was provided in old BIND releases\&. If\fBrndc\fR is invoked with no command line options or arguments, it prints a short summary of the supported commands and the available options and their arguments\&. +\fBrndc\fR +controls the operation of a name server. It supersedes the +\fBndc\fR +utility that was provided in old BIND releases. If +\fBrndc\fR +is invoked with no command line options or arguments, it prints a short summary of the supported commands and the available options and their arguments. .PP - \fBrndc\fR communicates with the name server over a TCP connection, sending commands authenticated with digital signatures\&. In the current versions of\fBrndc\fR and \fBnamed\fR named the only supported authentication algorithm is HMAC\-MD5, which uses a shared secret on each end of the connection\&. This provides TSIG\-style authentication for the command request and the name server's response\&. All commands sent over the channel must be signed by a key_id known to the server\&. +\fBrndc\fR +communicates with the name server over a TCP connection, sending commands authenticated with digital signatures. In the current versions of +\fBrndc\fR +and +\fBnamed\fR +named the only supported authentication algorithm is HMAC\-MD5, which uses a shared secret on each end of the connection. This provides TSIG\-style authentication for the command request and the name server's response. All commands sent over the channel must be signed by a key_id known to the server. .PP - \fBrndc\fR reads a configuration file to determine how to contact the name server and decide what algorithm and key it should use\&. +\fBrndc\fR +reads a configuration file to determine how to contact the name server and decide what algorithm and key it should use. .SH "OPTIONS" .TP \-c \fIconfig\-file\fR -Use \fIconfig\-file\fR as the configuration file instead of the default, \fI/etc/rndc\&.conf\fR\&. +Use +\fIconfig\-file\fR +as the configuration file instead of the default, +\fI/etc/rndc.conf\fR. .TP \-k \fIkey\-file\fR -Use \fIkey\-file\fR as the key file instead of the default, \fI/etc/rndc\&.key\fR\&. The key in \fI/etc/rndc\&.key\fR will be used to authenticate commands sent to the server if the \fIconfig\-file\fR does not exist\&. +Use +\fIkey\-file\fR +as the key file instead of the default, +\fI/etc/rndc.key\fR. The key in +\fI/etc/rndc.key\fR +will be used to authenticate commands sent to the server if the +\fIconfig\-file\fR +does not exist. .TP \-s \fIserver\fR - \fIserver\fR is the name or address of the server which matches a server statement in the configuration file for \fBrndc\fR\&. If no server is supplied on the command line, the host named by the default\-server clause in the option statement of the configuration file will be used\&. +\fIserver\fR +is the name or address of the server which matches a server statement in the configuration file for +\fBrndc\fR. If no server is supplied on the command line, the host named by the default\-server clause in the option statement of the configuration file will be used. .TP \-p \fIport\fR -Send commands to TCP port \fIport\fR instead of BIND 9's default control channel port, 953\&. +Send commands to TCP port +\fIport\fR +instead of BIND 9's default control channel port, 953. .TP \-V -Enable verbose logging\&. +Enable verbose logging. .TP \-y \fIkeyid\fR -Use the key \fIkeyid\fR from the configuration file\&. \fIkeyid\fR must be known by named with the same algorithm and secret string in order for control message validation to succeed\&. If no \fIkeyid\fR is specified, \fBrndc\fR will first look for a key clause in the server statement of the server being used, or if no server statement is present for that host, then the default\-key clause of the options statement\&. Note that the configuration file contains shared secrets which are used to send authenticated control commands to name servers\&. It should therefore not have general read or write access\&. +Use the key +\fIkeyid\fR +from the configuration file. +\fIkeyid\fR +must be known by named with the same algorithm and secret string in order for control message validation to succeed. If no +\fIkeyid\fR +is specified, +\fBrndc\fR +will first look for a key clause in the server statement of the server being used, or if no server statement is present for that host, then the default\-key clause of the options statement. Note that the configuration file contains shared secrets which are used to send authenticated control commands to name servers. It should therefore not have general read or write access. .PP -For the complete set of commands supported by \fBrndc\fR, see the BIND 9 Administrator Reference Manual or run \fBrndc\fR without arguments to see its help message\&. +For the complete set of commands supported by +\fBrndc\fR, see the BIND 9 Administrator Reference Manual or run +\fBrndc\fR +without arguments to see its help message. .SH "LIMITATIONS" .PP - \fBrndc\fR does not yet support all the commands of the BIND 8 \fBndc\fR utility\&. +\fBrndc\fR +does not yet support all the commands of the BIND 8 +\fBndc\fR +utility. .PP -There is currently no way to provide the shared secret for a \fBkey_id\fR without using the configuration file\&. +There is currently no way to provide the shared secret for a +\fBkey_id\fR +without using the configuration file. .PP -Several error messages could be clearer\&. +Several error messages could be clearer. .SH "SEE ALSO" .PP - \fBrndc\&.conf\fR(5), \fBnamed\fR(8), \fBnamed\&.conf\fR(5) \fBndc\fR(8), BIND 9 Administrator Reference Manual\&. +\fBrndc.conf\fR(5), +\fBnamed\fR(8), +\fBnamed.conf\fR(5)\fBndc\fR(8), +BIND 9 Administrator Reference Manual. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/rndc/rndc.conf.5 b/bin/rndc/rndc.conf.5 index 67c44b10..1c21e363 100644 --- a/bin/rndc/rndc.conf.5 +++ b/bin/rndc/rndc.conf.5 @@ -13,38 +13,30 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: rndc.conf.5,v 1.21.206.4 2005/05/12 23:57:01 sra Exp $ +.\" $Id: rndc.conf.5,v 1.21.206.5 2005/10/13 02:33:50 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "RNDC.CONF" 5 "June 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "\\FIRNDC.CONF\\FR" "5" "June 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" rndc.conf \- rndc configuration file .SH "SYNOPSIS" .HP 10 -\fBrndc\&.conf\fR +\fBrndc.conf\fR .SH "DESCRIPTION" .PP - \fIrndc\&.conf\fR is the configuration file for \fBrndc\fR, the BIND 9 name server control utility\&. This file has a similar structure and syntax to\fInamed\&.conf\fR\&. Statements are enclosed in braces and terminated with a semi\-colon\&. Clauses in the statements are also semi\-colon terminated\&. The usual comment styles are supported: +\fIrndc.conf\fR +is the configuration file for +\fBrndc\fR, the BIND 9 name server control utility. This file has a similar structure and syntax to +\fInamed.conf\fR. Statements are enclosed in braces and terminated with a semi\-colon. Clauses in the statements are also semi\-colon terminated. The usual comment styles are supported: .PP C style: /* */ .PP @@ -52,16 +44,60 @@ C++ style: // to end of line .PP Unix style: # to end of line .PP - \fIrndc\&.conf\fR is much simpler than\fInamed\&.conf\fR\&. The file uses three statements: an options statement, a server statement and a key statement\&. -.PP -The \fBoptions\fR statement contains three clauses\&. The \fBdefault\-server\fR 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\fBrndc\fR\&. The \fBdefault\-key\fR clause is followed by the name of a key which is identified by a \fBkey\fR statement\&. If no\fBkeyid\fR is provided on the rndc command line, and no \fBkey\fR clause is found in a matching\fBserver\fR statement, this default key will be used to authenticate the server's commands and responses\&. The\fBdefault\-port\fR clause is followed by the port to connect to on the remote name server\&. If no\fBport\fR option is provided on the rndc command line, and no \fBport\fR clause is found in a matching \fBserver\fR statement, this default port will be used to connect\&. -.PP -After the \fBserver\fR keyword, the server statement includes a string which is the hostname or address for a name server\&. The statement has two possible clauses:\fBkey\fR and \fBport\fR\&. The key name must match the name of a key statement in the file\&. The port number specifies the port to connect to\&. -.PP -The \fBkey\fR statement begins with an identifying string, the name of the key\&. The statement has two clauses\&.\fBalgorithm\fR identifies the encryption algorithm for \fBrndc\fR to use; currently only HMAC\-MD5 is supported\&. This is followed by a secret clause which contains the base\-64 encoding of the algorithm's encryption key\&. The base\-64 string is enclosed in double quotes\&. -.PP -There are two common ways to generate the base\-64 string for the secret\&. The BIND 9 program \fBrndc\-confgen\fR can be used to generate a random key, or the\fBmmencode\fR program, also known as\fBmimencode\fR, can be used to generate a base\-64 string from known input\&. \fBmmencode\fR does not ship with BIND 9 but is available on many systems\&. See the EXAMPLE section for sample command lines for each\&. +\fIrndc.conf\fR +is much simpler than +\fInamed.conf\fR. The file uses three statements: an options statement, a server statement and a key statement. +.PP +The +\fBoptions\fR +statement contains three clauses. The +\fBdefault\-server\fR +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 +\fBrndc\fR. The +\fBdefault\-key\fR +clause is followed by the name of a key which is identified by a +\fBkey\fR +statement. If no +\fBkeyid\fR +is provided on the rndc command line, and no +\fBkey\fR +clause is found in a matching +\fBserver\fR +statement, this default key will be used to authenticate the server's commands and responses. The +\fBdefault\-port\fR +clause is followed by the port to connect to on the remote name server. If no +\fBport\fR +option is provided on the rndc command line, and no +\fBport\fR +clause is found in a matching +\fBserver\fR +statement, this default port will be used to connect. +.PP +After the +\fBserver\fR +keyword, the server statement includes a string which is the hostname or address for a name server. The statement has two possible clauses: +\fBkey\fR +and +\fBport\fR. The key name must match the name of a key statement in the file. The port number specifies the port to connect to. +.PP +The +\fBkey\fR +statement begins with an identifying string, the name of the key. The statement has two clauses. +\fBalgorithm\fR +identifies the encryption algorithm for +\fBrndc\fR +to use; currently only HMAC\-MD5 is supported. This is followed by a secret clause which contains the base\-64 encoding of the algorithm's encryption key. The base\-64 string is enclosed in double quotes. +.PP +There are two common ways to generate the base\-64 string for the secret. The BIND 9 program +\fBrndc\-confgen\fR +can be used to generate a random key, or the +\fBmmencode\fR +program, also known as +\fBmimencode\fR, can be used to generate a base\-64 string from known input. +\fBmmencode\fR +does not ship with BIND 9 but is available on many systems. See the EXAMPLE section for sample command lines for each. .SH "EXAMPLE" +.sp .nf options { default\-server localhost; @@ -76,23 +112,43 @@ There are two common ways to generate the base\-64 string for the secret\&. The }; .fi .PP -In the above example, \fBrndc\fR will by default use the server at localhost (127\&.0\&.0\&.1) and the key called samplekey\&. Commands to the localhost server will use the samplekey key, which must also be defined in the server's configuration file with the same name and secret\&. The key statement indicates that samplekey uses the HMAC\-MD5 algorithm and its secret clause contains the base\-64 encoding of the HMAC\-MD5 secret enclosed in double quotes\&. +In the above example, +\fBrndc\fR +will by default use the server at localhost (127.0.0.1) and the key called samplekey. Commands to the localhost server will use the samplekey key, which must also be defined in the server's configuration file with the same name and secret. The key statement indicates that samplekey uses the HMAC\-MD5 algorithm and its secret clause contains the base\-64 encoding of the HMAC\-MD5 secret enclosed in double quotes. .PP -To generate a random secret with \fBrndc\-confgen\fR: +To generate a random secret with +\fBrndc\-confgen\fR: .PP - \fBrndc\-confgen\fR +\fBrndc\-confgen\fR .PP -A complete \fIrndc\&.conf\fR file, including the randomly generated key, will be written to the standard output\&. Commented out \fBkey\fR and \fBcontrols\fR statements for \fInamed\&.conf\fR are also printed\&. +A complete +\fIrndc.conf\fR +file, including the randomly generated key, will be written to the standard output. Commented out +\fBkey\fR +and +\fBcontrols\fR +statements for +\fInamed.conf\fR +are also printed. .PP -To generate a base\-64 secret with \fBmmencode\fR: +To generate a base\-64 secret with +\fBmmencode\fR: .PP - \fBecho "known plaintext for a secret" | mmencode\fR +\fBecho "known plaintext for a secret" | mmencode\fR .SH "NAME SERVER CONFIGURATION" .PP -The name server must be configured to accept rndc connections and to recognize the key specified in the \fIrndc\&.conf\fR file, using the controls statement in \fInamed\&.conf\fR\&. See the sections on the \fBcontrols\fR statement in the BIND 9 Administrator Reference Manual for details\&. +The name server must be configured to accept rndc connections and to recognize the key specified in the +\fIrndc.conf\fR +file, using the controls statement in +\fInamed.conf\fR. See the sections on the +\fBcontrols\fR +statement in the BIND 9 Administrator Reference Manual for details. .SH "SEE ALSO" .PP - \fBrndc\fR(8), \fBrndc\-confgen\fR(8), \fBmmencode\fR(1), BIND 9 Administrator Reference Manual\&. +\fBrndc\fR(8), +\fBrndc\-confgen\fR(8), +\fBmmencode\fR(1), +BIND 9 Administrator Reference Manual. .SH "AUTHOR" .PP - Internet Systems Consortium +Internet Systems Consortium diff --git a/bin/rndc/rndc.conf.html b/bin/rndc/rndc.conf.html index 095107dd..05db0eca 100644 --- a/bin/rndc/rndc.conf.html +++ b/bin/rndc/rndc.conf.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: rndc.conf.html,v 1.5.2.1.4.8 2005/07/18 02:36:47 marka Exp $ --> +<!-- $Id: rndc.conf.html,v 1.5.2.1.4.10 2005/10/13 02:33:51 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>rndc.conf</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><code class="filename">rndc.conf</code> — rndc configuration file</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">rndc.conf</code> </p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514516"></a><h2>DESCRIPTION</h2> +<a name="id2525833"></a><h2>DESCRIPTION</h2> <p> <code class="filename">rndc.conf</code> is the configuration file for <span><strong class="command">rndc</strong></span>, the BIND 9 name server control @@ -105,7 +105,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514787"></a><h2>EXAMPLE</h2> +<a name="id2525968"></a><h2>EXAMPLE</h2> <pre class="programlisting"> options { default-server localhost; @@ -151,7 +151,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514916"></a><h2>NAME SERVER CONFIGURATION</h2> +<a name="id2526028"></a><h2>NAME SERVER CONFIGURATION</h2> <p> The name server must be configured to accept rndc connections and to recognize the key specified in the <code class="filename">rndc.conf</code> @@ -161,7 +161,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514936"></a><h2>SEE ALSO</h2> +<a name="id2526049"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>, <span class="citerefentry"><span class="refentrytitle">rndc-confgen</span>(8)</span>, @@ -170,7 +170,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514979"></a><h2>AUTHOR</h2> +<a name="id2526091"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/rndc/rndc.html b/bin/rndc/rndc.html index 3dd5089b..d23f4682 100644 --- a/bin/rndc/rndc.html +++ b/bin/rndc/rndc.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: rndc.html,v 1.7.2.1.4.8 2005/07/18 02:36:47 marka Exp $ --> +<!-- $Id: rndc.html,v 1.7.2.1.4.10 2005/10/13 02:33:50 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>rndc</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p><span class="application">rndc</span> — name server control utility</p> @@ -32,7 +32,7 @@ <div class="cmdsynopsis"><p><code class="command">rndc</code> [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>] [<code class="option">-k <em class="replaceable"><code>key-file</code></em></code>] [<code class="option">-s <em class="replaceable"><code>server</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port</code></em></code>] [<code class="option">-V</code>] [<code class="option">-y <em class="replaceable"><code>key_id</code></em></code>] {command}</p></div> </div> <div class="refsect1" lang="en"> -<a name="id2514569"></a><h2>DESCRIPTION</h2> +<a name="id2525886"></a><h2>DESCRIPTION</h2> <p> <span><strong class="command">rndc</strong></span> controls the operation of a name server. It supersedes the <span><strong class="command">ndc</strong></span> utility @@ -61,7 +61,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514678"></a><h2>OPTIONS</h2> +<a name="id2525927"></a><h2>OPTIONS</h2> <div class="variablelist"><dl> <dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt> <dd><p> @@ -123,7 +123,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2514929"></a><h2>LIMITATIONS</h2> +<a name="id2526109"></a><h2>LIMITATIONS</h2> <p> <span><strong class="command">rndc</strong></span> does not yet support all the commands of the BIND 8 <span><strong class="command">ndc</strong></span> utility. @@ -137,7 +137,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515026"></a><h2>SEE ALSO</h2> +<a name="id2526138"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">rndc.conf</span>(5)</span>, <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>, @@ -147,7 +147,7 @@ </p> </div> <div class="refsect1" lang="en"> -<a name="id2515078"></a><h2>AUTHOR</h2> +<a name="id2526190"></a><h2>AUTHOR</h2> <p> <span class="corpauthor">Internet Systems Consortium</span> </p> diff --git a/bin/tests/system/dnssec/clean.sh b/bin/tests/system/dnssec/clean.sh index 76161934..bed867dc 100644 --- a/bin/tests/system/dnssec/clean.sh +++ b/bin/tests/system/dnssec/clean.sh @@ -1,6 +1,6 @@ #!/bin/sh # -# Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") +# Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") # Copyright (C) 2000-2002 Internet Software Consortium. # # Permission to use, copy, modify, and distribute this software for any @@ -15,12 +15,13 @@ # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. -# $Id: clean.sh,v 1.10.12.5 2004/09/07 04:17:14 marka Exp $ +# $Id: clean.sh,v 1.10.12.7 2005/09/13 00:34:53 marka Exp $ rm -f */K* */keyset-* */dsset-* */dlvset-* */signedkey-* */*.signed */trusted.conf */tmp* rm -f ns1/root.db ns2/example.db ns3/secure.example.db rm -f ns3/unsecure.example.db ns3/bogus.example.db ns3/keyless.example.db rm -f ns3/dynamic.example.db ns3/dynamic.example.db.signed.jnl +rm -f ns2/private.secure.example.db rm -f */example.bk rm -f dig.out.* rm -f random.data diff --git a/bin/tests/system/views/clean.sh b/bin/tests/system/views/clean.sh index 2de375c9..c52cf76d 100644 --- a/bin/tests/system/views/clean.sh +++ b/bin/tests/system/views/clean.sh @@ -1,6 +1,6 @@ #!/bin/sh # -# Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") +# Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") # Copyright (C) 2000, 2001 Internet Software Consortium. # # Permission to use, copy, modify, and distribute this software for any @@ -15,12 +15,12 @@ # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. -# $Id: clean.sh,v 1.7.206.2 2004/03/10 01:05:55 marka Exp $ +# $Id: clean.sh,v 1.7.206.4 2005/09/13 00:34:54 marka Exp $ # # Clean up after zone transfer tests. # -rm -f ns3/example.bk dig.out.ns2 dig.out.ns3 +rm -f ns3/example.bk dig.out.ns?.? rm -f ns2/named.conf ns2/example.db ns3/named.conf ns3/internal.bk diff --git a/bin/tests/system/xferquota/clean.sh b/bin/tests/system/xferquota/clean.sh index b1344091..12c44cf3 100644 --- a/bin/tests/system/xferquota/clean.sh +++ b/bin/tests/system/xferquota/clean.sh @@ -1,6 +1,6 @@ #!/bin/sh # -# Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") +# Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") # Copyright (C) 2000, 2001 Internet Software Consortium. # # Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. -# $Id: clean.sh,v 1.8.206.2 2004/03/10 01:05:56 marka Exp $ +# $Id: clean.sh,v 1.8.206.4 2005/09/13 00:34:54 marka Exp $ # # Clean up after zone transfer quota tests. @@ -24,3 +24,4 @@ rm -f ns1/zone*.example.db ns1/zones.conf rm -f ns2/zone*.example.bk ns2/zones.conf rm -f dig.out.* ns2/changing.bk +rm -f ns1/changing.db diff --git a/bin/win32/BINDInstall/BINDInstall.rc b/bin/win32/BINDInstall/BINDInstall.rc index 733591d3..8bcb636b 100644 --- a/bin/win32/BINDInstall/BINDInstall.rc +++ b/bin/win32/BINDInstall/BINDInstall.rc @@ -78,7 +78,7 @@ STYLE DS_MODALFRAME | DS_CENTER | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU EXSTYLE WS_EX_APPWINDOW CAPTION "BIND 9 Installer" -FONT 8, "MS Sans Serif" +FONT 8, "MS Sans Serif",0,0,0x1 BEGIN EDITTEXT IDC_TARGETDIR,7,62,196,14,ES_AUTOHSCROLL EDITTEXT IDC_ACCOUNT_NAME,7,94,196,14,ES_AUTOHSCROLL @@ -305,6 +305,8 @@ BEGIN IDS_CREATEACCOUNT_FAILED "Unable to Create Account for the Service." IDS_ERR_PASSWORD "Passwords entered did not match. Please reenter password." IDS_ERR_UPDATE_SERVICE "Error updating service\n(%s)" + IDS_ERR_NULLPASSWORD "Service account password cannot be null" + IDS_ERR_WHITESPACE "Service account password has leading/trailing whitespace" END #endif // English (U.S.) resources diff --git a/bin/win32/BINDInstall/BINDInstallDlg.cpp b/bin/win32/BINDInstall/BINDInstallDlg.cpp index a9c7e68f..511ab6e8 100644 --- a/bin/win32/BINDInstall/BINDInstallDlg.cpp +++ b/bin/win32/BINDInstall/BINDInstallDlg.cpp @@ -1,5 +1,5 @@ /* - * Portions Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Portions Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Portions Copyright (C) 2001, 2003 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: BINDInstallDlg.cpp,v 1.6.2.6.2.10 2004/05/18 01:20:04 marka Exp $ */ +/* $Id: BINDInstallDlg.cpp,v 1.6.2.6.2.12 2005/10/11 23:54:48 marka Exp $ */ /* * Copyright (c) 1999-2000 by Nortel Networks Corporation @@ -385,6 +385,7 @@ void CBINDInstallDlg::OnUninstall() { */ void CBINDInstallDlg::OnInstall() { BOOL success = FALSE; + int oldlen; if (CheckBINDService()) StopBINDService(); @@ -393,18 +394,45 @@ void CBINDInstallDlg::OnInstall() { UpdateData(); - /* Check that the Passwords entered match */ + /* + * Check that the Passwords entered match. + */ if (m_accountPassword != m_accountPasswordConfirm) { MsgBox(IDS_ERR_PASSWORD); return; } - /* Check the entered account name */ + /* + * Check that there is not leading / trailing whitespace. + * This is for compatability with the standard password dialog. + * Passwords really should be treated as opaque blobs. + */ + oldlen = m_accountPassword.GetLength(); + m_accountPassword.TrimLeft(); + m_accountPassword.TrimRight(); + if (m_accountPassword.GetLength() != oldlen) { + MsgBox(IDS_ERR_WHITESPACE); + return; + } + + /* + * Check that the Password is not null. + */ + if (m_accountPassword.GetLength() == 0) { + MsgBox(IDS_ERR_NULLPASSWORD); + return; + } + + /* + * Check the entered account name. + */ if (ValidateServiceAccount() == FALSE) return; - /* For Registration we need to know if account was changed */ + /* + * For Registration we need to know if account was changed. + */ if(m_accountName != m_currentAccount) m_accountUsed = FALSE; @@ -462,15 +490,13 @@ void CBINDInstallDlg::OnInstall() { SetCurrent(IDS_ADD_REMOVE); if (RegCreateKey(HKEY_LOCAL_MACHINE, BIND_UNINSTALL_SUBKEY, - &hKey) == ERROR_SUCCESS) { - char winDir[MAX_PATH]; + &hKey) == ERROR_SUCCESS) { CString buf(BIND_DISPLAY_NAME); - GetWindowsDirectory(winDir, MAX_PATH); RegSetValueEx(hKey, "DisplayName", 0, REG_SZ, (LPBYTE)(LPCTSTR)buf, buf.GetLength()); - buf.Format("%s\\BINDInstall.exe", winDir); + buf.Format("%s\\BINDInstall.exe", m_binDir); RegSetValueEx(hKey, "UninstallString", 0, REG_SZ, (LPBYTE)(LPCTSTR)buf, buf.GetLength()); RegCloseKey(hKey); diff --git a/bin/win32/BINDInstall/resource.h b/bin/win32/BINDInstall/resource.h index fd142d32..14b50846 100644 --- a/bin/win32/BINDInstall/resource.h +++ b/bin/win32/BINDInstall/resource.h @@ -56,6 +56,8 @@ #define IDS_CREATEACCOUNT_FAILED 55 #define IDS_ERR_PASSWORD 56 #define IDS_ERR_UPDATE_SERVICE 57 +#define IDS_ERR_NULLPASSWORD 58 +#define IDS_ERR_WHITESPACE 59 #define IDD_BINDINSTALL_DIALOG 102 #define IDR_MAINFRAME 128 #define IDD_BROWSE 129 diff --git a/config.h.in b/config.h.in index 6c15e653..22a245a7 100644 --- a/config.h.in +++ b/config.h.in @@ -16,7 +16,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: config.h.in,v 1.47.2.3.2.17 2005/07/18 05:26:11 marka Exp $ */ +/* $Id: config.h.in,v 1.47.2.3.2.19 2005/10/14 01:44:44 marka Exp $ */ /*** *** This file is not to be included by any public header files, because @@ -14,7 +14,7 @@ # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. # -# $Id: configure,v 1.284.2.19.2.43 2005/07/18 05:26:11 marka Exp $ +# $Id: configure,v 1.284.2.19.2.46 2005/10/14 01:44:45 marka Exp $ # # Portions Copyright (C) 1996-2001 Nominum, Inc. # @@ -29,7 +29,7 @@ # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -# From configure.in Revision: 1.294.2.23.2.47 . +# From configure.in Revision: 1.294.2.23.2.50 . # Guess values for system-dependent variables and create Makefiles. # Generated by GNU Autoconf 2.59. # @@ -6538,7 +6538,14 @@ _ACEOF fi case $host in - *-freebsd5.3|*-freebsd5.3.*) + *-freebsd5.[012]|*-freebsd5.[012].*);; + *-freebsd5.[3456789]|*-freebsd5.[3456789].*) + cat >>confdefs.h <<\_ACEOF +#define NEED_PTHREAD_SCOPE_SYSTEM 1 +_ACEOF + + ;; + *-freebsd6.*) cat >>confdefs.h <<\_ACEOF #define NEED_PTHREAD_SCOPE_SYSTEM 1 _ACEOF @@ -7187,7 +7194,7 @@ else ;; *) # Turn off the pointlessly noisy warnings. - STD_CWARNINGS="+w1 +W 474,530" + STD_CWARNINGS="+w1 +W 474,530,2193,2236" ;; esac CCOPT="$CCOPT -Ae -z" @@ -8132,7 +8139,7 @@ ia64-*-hpux*) ;; *-*-irix6*) # Find out which ABI we are using. - echo '#line 8135 "configure"' > conftest.$ac_ext + echo '#line 8142 "configure"' > conftest.$ac_ext if { (eval echo "$as_me:$LINENO: \"$ac_compile\"") >&5 (eval $ac_compile) 2>&5 ac_status=$? @@ -9129,7 +9136,7 @@ fi # Provide some information about the compiler. -echo "$as_me:9132:" \ +echo "$as_me:9139:" \ "checking for Fortran 77 compiler version" >&5 ac_compiler=`set X $ac_compile; echo $2` { (eval echo "$as_me:$LINENO: \"$ac_compiler --version </dev/null >&5\"") >&5 @@ -10190,11 +10197,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:10193: $lt_compile\"" >&5) + (eval echo "\"\$as_me:10200: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:10197: \$? = $ac_status" >&5 + echo "$as_me:10204: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -10433,11 +10440,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:10436: $lt_compile\"" >&5) + (eval echo "\"\$as_me:10443: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:10440: \$? = $ac_status" >&5 + echo "$as_me:10447: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -10493,11 +10500,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:10496: $lt_compile\"" >&5) + (eval echo "\"\$as_me:10503: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:10500: \$? = $ac_status" >&5 + echo "$as_me:10507: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -12678,7 +12685,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 12681 "configure" +#line 12688 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -12776,7 +12783,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 12779 "configure" +#line 12786 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -14973,11 +14980,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:14976: $lt_compile\"" >&5) + (eval echo "\"\$as_me:14983: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:14980: \$? = $ac_status" >&5 + echo "$as_me:14987: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -15033,11 +15040,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:15036: $lt_compile\"" >&5) + (eval echo "\"\$as_me:15043: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:15040: \$? = $ac_status" >&5 + echo "$as_me:15047: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -16394,7 +16401,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 16397 "configure" +#line 16404 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -16492,7 +16499,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 16495 "configure" +#line 16502 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -17329,11 +17336,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:17332: $lt_compile\"" >&5) + (eval echo "\"\$as_me:17339: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:17336: \$? = $ac_status" >&5 + echo "$as_me:17343: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -17389,11 +17396,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:17392: $lt_compile\"" >&5) + (eval echo "\"\$as_me:17399: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:17396: \$? = $ac_status" >&5 + echo "$as_me:17403: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -19428,11 +19435,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:19431: $lt_compile\"" >&5) + (eval echo "\"\$as_me:19438: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:19435: \$? = $ac_status" >&5 + echo "$as_me:19442: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -19671,11 +19678,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:19674: $lt_compile\"" >&5) + (eval echo "\"\$as_me:19681: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:19678: \$? = $ac_status" >&5 + echo "$as_me:19685: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -19731,11 +19738,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:19734: $lt_compile\"" >&5) + (eval echo "\"\$as_me:19741: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:19738: \$? = $ac_status" >&5 + echo "$as_me:19745: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -21916,7 +21923,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 21919 "configure" +#line 21926 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -22014,7 +22021,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 22017 "configure" +#line 22024 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -23743,11 +23750,11 @@ rm -f conftest.err conftest.$ac_objext \ echo "$as_me:$LINENO: checking for inet_ntop with IPv6 support" >&5 echo $ECHO_N "checking for inet_ntop with IPv6 support... $ECHO_C" >&6 if test "$cross_compiling" = yes; then - { { echo "$as_me:$LINENO: error: cannot run test program while cross compiling -See \`config.log' for more details." >&5 -echo "$as_me: error: cannot run test program while cross compiling -See \`config.log' for more details." >&2;} - { (exit 1); exit 1; }; } + echo "$as_me:$LINENO: result: assuming inet_ntop needed" >&5 +echo "${ECHO_T}assuming inet_ntop needed" >&6 + ISC_EXTRA_OBJS="$ISC_EXTRA_OBJS inet_ntop.$O" + ISC_EXTRA_SRCS="$ISC_EXTRA_SRCS inet_ntop.c" + ISC_PLATFORM_NEEDNTOP="#define ISC_PLATFORM_NEEDNTOP 1" else cat >conftest.$ac_ext <<_ACEOF /* confdefs.h. */ @@ -26755,9 +26762,10 @@ echo "${ECHO_T}no" >&6 echo "$as_me:$LINENO: checking type of rlim_cur" >&5 echo $ECHO_N "checking type of rlim_cur... $ECHO_C" >&6 if test "$cross_compiling" = yes; then - { { echo "$as_me:$LINENO: error: cannot determine type of rlim_cur when cross compiling - define rlim_t" >&5 -echo "$as_me: error: cannot determine type of rlim_cur when cross compiling - define rlim_t" >&2;} - { (exit 1); exit 1; }; } + +ISC_PLATFORM_RLIMITTYPE="#define ISC_PLATFORM_RLIMITTYPE long long int" +echo "$as_me:$LINENO: result: cannot determine type of rlim_cur when cross compiling - assuming long long int" >&5 +echo "${ECHO_T}cannot determine type of rlim_cur when cross compiling - assuming long long int" >&6 else cat >conftest.$ac_ext <<_ACEOF /* confdefs.h. */ @@ -27817,7 +27825,7 @@ LIBBIND9_API=$srcdir/lib/bind9/api LIBLWRES_API=$srcdir/lib/lwres/api - ac_config_files="$ac_config_files make/rules make/includes Makefile make/Makefile make/mkdep lib/Makefile lib/isc/Makefile lib/isc/include/Makefile lib/isc/include/isc/Makefile lib/isc/include/isc/platform.h lib/isc/unix/Makefile lib/isc/unix/include/Makefile lib/isc/unix/include/isc/Makefile lib/isc/nls/Makefile lib/isc/$thread_dir/Makefile lib/isc/$thread_dir/include/Makefile lib/isc/$thread_dir/include/isc/Makefile lib/isccc/Makefile lib/isccc/include/Makefile lib/isccc/include/isccc/Makefile lib/isccfg/Makefile lib/isccfg/include/Makefile lib/isccfg/include/isccfg/Makefile lib/dns/Makefile lib/dns/include/Makefile lib/dns/include/dns/Makefile lib/dns/include/dst/Makefile lib/bind9/Makefile lib/bind9/include/Makefile lib/bind9/include/bind9/Makefile lib/lwres/Makefile lib/lwres/include/Makefile lib/lwres/include/lwres/Makefile lib/lwres/include/lwres/netdb.h lib/lwres/include/lwres/platform.h lib/lwres/man/Makefile lib/lwres/unix/Makefile lib/lwres/unix/include/Makefile lib/lwres/unix/include/lwres/Makefile lib/tests/Makefile lib/tests/include/Makefile lib/tests/include/tests/Makefile bin/Makefile bin/check/Makefile bin/named/Makefile bin/named/unix/Makefile bin/rndc/Makefile bin/rndc/unix/Makefile bin/dig/Makefile bin/nsupdate/Makefile bin/tests/Makefile bin/tests/names/Makefile bin/tests/master/Makefile bin/tests/rbt/Makefile bin/tests/db/Makefile bin/tests/tasks/Makefile bin/tests/timers/Makefile bin/tests/dst/Makefile bin/tests/mem/Makefile bin/tests/net/Makefile bin/tests/sockaddr/Makefile bin/tests/system/Makefile bin/tests/system/conf.sh bin/tests/system/lwresd/Makefile bin/tests/system/tkey/Makefile bin/tests/headerdep_test.sh bin/dnssec/Makefile doc/Makefile doc/arm/Makefile doc/misc/Makefile isc-config.sh doc/xsl/isc-docbook-chunk.xsl doc/xsl/isc-docbook-html.xsl doc/xsl/isc-docbook-latex.xsl doc/xsl/isc-manpage.xsl" + ac_config_files="$ac_config_files make/rules make/includes Makefile make/Makefile make/mkdep lib/Makefile lib/isc/Makefile lib/isc/include/Makefile lib/isc/include/isc/Makefile lib/isc/include/isc/platform.h lib/isc/unix/Makefile lib/isc/unix/include/Makefile lib/isc/unix/include/isc/Makefile lib/isc/nls/Makefile lib/isc/$thread_dir/Makefile lib/isc/$thread_dir/include/Makefile lib/isc/$thread_dir/include/isc/Makefile lib/isccc/Makefile lib/isccc/include/Makefile lib/isccc/include/isccc/Makefile lib/isccfg/Makefile lib/isccfg/include/Makefile lib/isccfg/include/isccfg/Makefile lib/dns/Makefile lib/dns/include/Makefile lib/dns/include/dns/Makefile lib/dns/include/dst/Makefile lib/bind9/Makefile lib/bind9/include/Makefile lib/bind9/include/bind9/Makefile lib/lwres/Makefile lib/lwres/include/Makefile lib/lwres/include/lwres/Makefile lib/lwres/include/lwres/netdb.h lib/lwres/include/lwres/platform.h lib/lwres/man/Makefile lib/lwres/unix/Makefile lib/lwres/unix/include/Makefile lib/lwres/unix/include/lwres/Makefile lib/tests/Makefile lib/tests/include/Makefile lib/tests/include/tests/Makefile bin/Makefile bin/check/Makefile bin/named/Makefile bin/named/unix/Makefile bin/rndc/Makefile bin/rndc/unix/Makefile bin/dig/Makefile bin/nsupdate/Makefile bin/tests/Makefile bin/tests/names/Makefile bin/tests/master/Makefile bin/tests/rbt/Makefile bin/tests/db/Makefile bin/tests/tasks/Makefile bin/tests/timers/Makefile bin/tests/dst/Makefile bin/tests/mem/Makefile bin/tests/net/Makefile bin/tests/sockaddr/Makefile bin/tests/system/Makefile bin/tests/system/conf.sh bin/tests/system/lwresd/Makefile bin/tests/system/tkey/Makefile bin/tests/headerdep_test.sh bin/dnssec/Makefile doc/Makefile doc/arm/Makefile doc/misc/Makefile doc/xsl/Makefile isc-config.sh doc/xsl/isc-docbook-chunk.xsl doc/xsl/isc-docbook-html.xsl doc/xsl/isc-docbook-latex.xsl doc/xsl/isc-manpage.xsl" cat >confcache <<\_ACEOF # This file is a shell script that caches the results of configure # tests run on this system so they can be shared between configure @@ -28413,6 +28421,7 @@ do "doc/Makefile" ) CONFIG_FILES="$CONFIG_FILES doc/Makefile" ;; "doc/arm/Makefile" ) CONFIG_FILES="$CONFIG_FILES doc/arm/Makefile" ;; "doc/misc/Makefile" ) CONFIG_FILES="$CONFIG_FILES doc/misc/Makefile" ;; + "doc/xsl/Makefile" ) CONFIG_FILES="$CONFIG_FILES doc/xsl/Makefile" ;; "isc-config.sh" ) CONFIG_FILES="$CONFIG_FILES isc-config.sh" ;; "doc/xsl/isc-docbook-chunk.xsl" ) CONFIG_FILES="$CONFIG_FILES doc/xsl/isc-docbook-chunk.xsl" ;; "doc/xsl/isc-docbook-html.xsl" ) CONFIG_FILES="$CONFIG_FILES doc/xsl/isc-docbook-html.xsl" ;; diff --git a/configure.in b/configure.in index 3f7b9a77..8bb2a6c9 100644 --- a/configure.in +++ b/configure.in @@ -18,7 +18,7 @@ AC_DIVERT_PUSH(1)dnl esyscmd([sed "s/^/# /" COPYRIGHT])dnl AC_DIVERT_POP()dnl -AC_REVISION($Revision: 1.294.2.23.2.47 $) +AC_REVISION($Revision: 1.294.2.23.2.50 $) AC_INIT(lib/dns/name.c) AC_PREREQ(2.13) @@ -640,7 +640,11 @@ then *-freebsd*) AC_CHECK_LIB(c_r, sigwait, AC_DEFINE(HAVE_SIGWAIT),) case $host in - *-freebsd5.3|*-freebsd5.3.*) + *-freebsd5.[[012]]|*-freebsd5.[[012]].*);; + *-freebsd5.[[3456789]]|*-freebsd5.[[3456789]].*) + AC_DEFINE(NEED_PTHREAD_SCOPE_SYSTEM) + ;; + *-freebsd6.*) AC_DEFINE(NEED_PTHREAD_SCOPE_SYSTEM) ;; esac @@ -810,7 +814,7 @@ else ;; *) # Turn off the pointlessly noisy warnings. - STD_CWARNINGS="+w1 +W 474,530" + STD_CWARNINGS="+w1 +W 474,530,2193,2236" ;; esac CCOPT="$CCOPT -Ae -z" @@ -1263,6 +1267,10 @@ char a[16],b[64]; return(inet_ntop(AF_INET6, a, b, sizeof(b)) == (char*)0);}], [AC_MSG_RESULT(no) ISC_EXTRA_OBJS="$ISC_EXTRA_OBJS inet_ntop.$O" ISC_EXTRA_SRCS="$ISC_EXTRA_SRCS inet_ntop.c" + ISC_PLATFORM_NEEDNTOP="#define ISC_PLATFORM_NEEDNTOP 1"], + [AC_MSG_RESULT(assuming inet_ntop needed) + ISC_EXTRA_OBJS="$ISC_EXTRA_OBJS inet_ntop.$O" + ISC_EXTRA_SRCS="$ISC_EXTRA_SRCS inet_ntop.c" ISC_PLATFORM_NEEDNTOP="#define ISC_PLATFORM_NEEDNTOP 1"]) @@ -1286,7 +1294,13 @@ main() { char a[16]; return (inet_pton(AF_INET, "1.2.3", a) == 1 ? 1 : ISC_EXTRA_SRCS="$ISC_EXTRA_SRCS inet_pton.c" ISC_PLATFORM_NEEDPTON="#define ISC_PLATFORM_NEEDPTON 1"], [AC_MSG_RESULT(assuming target platform has working inet_pton) - ISC_PLATFORM_NEEDPTON="#undef ISC_PLATFORM_NEEDPTON"]) + ISC_PLATFORM_NEEDPTON="#undef ISC_PLATFORM_NEEDPTON"], + [AC_MSG_RESULT(assuming inet_pton needed) + ISC_EXTRA_OBJS="$ISC_EXTRA_OBJS inet_pton.$O" + ISC_EXTRA_SRCS="$ISC_EXTRA_SRCS inet_pton.c" + ISC_PLATFORM_NEEDPTON="#define ISC_PLATFORM_NEEDPTON 1"], + [AC_MSG_RESULT(assuming target platform has working inet_pton) + ISC_PLATFORM_NEEDPTON="#undef ISC_PLATFORM_NEEDPTON"]) AC_MSG_CHECKING([for inet_aton]) AC_TRY_LINK([ @@ -1714,7 +1728,9 @@ ISC_PLATFORM_RLIMITTYPE="#define ISC_PLATFORM_RLIMITTYPE long long int"], [AC_MSG_ERROR([unable to determine sizeof rlim_cur]) ],[AC_MSG_ERROR(this cannot happen)]) ],[AC_MSG_ERROR(this cannot happen)]) -],[AC_MSG_ERROR(cannot determine type of rlim_cur when cross compiling - define rlim_t)]) +],[ +ISC_PLATFORM_RLIMITTYPE="#define ISC_PLATFORM_RLIMITTYPE long long int" +AC_MSG_RESULT(cannot determine type of rlim_cur when cross compiling - assuming long long int)]) ]) AC_SUBST(ISC_PLATFORM_RLIMITTYPE) @@ -2091,6 +2107,7 @@ AC_OUTPUT( doc/Makefile doc/arm/Makefile doc/misc/Makefile + doc/xsl/Makefile isc-config.sh doc/xsl/isc-docbook-chunk.xsl doc/xsl/isc-docbook-html.xsl diff --git a/contrib/idn/idnkit-1.0-src/patch/bind9/bind-9.3.2-patch b/contrib/idn/idnkit-1.0-src/patch/bind9/bind-9.3.2-patch index 4ad6b8eb..35b58a38 100644 --- a/contrib/idn/idnkit-1.0-src/patch/bind9/bind-9.3.2-patch +++ b/contrib/idn/idnkit-1.0-src/patch/bind9/bind-9.3.2-patch @@ -17,8 +17,8 @@ and install. Index: README.idnkit ---- /dev/null Tue Sep 6 10:40:08 2005 -+++ README.idnkit Tue Sep 6 10:24:31 2005 +--- /dev/null Fri Oct 14 13:31:08 2005 ++++ README.idnkit Fri Oct 14 12:22:36 2005 @@ -0,0 +1,112 @@ + + BIND-9 IDN patch @@ -135,10 +135,17 @@ Index: README.idnkit Index: config.h.in =================================================================== RCS file: /proj/cvs/prod/bind9/config.h.in,v -retrieving revision 1.47.2.3.2.17 -diff -U2 -r1.47.2.3.2.17 config.h.in ---- config.h.in 18 Jul 2005 05:26:11 -0000 1.47.2.3.2.17 -+++ config.h.in 6 Sep 2005 00:40:48 -0000 +retrieving revision 1.47.2.3.2.19 +diff -U2 -r1.47.2.3.2.19 config.h.in +--- config.h.in 14 Oct 2005 01:44:44 -0000 1.47.2.3.2.19 ++++ config.h.in 14 Oct 2005 03:34:48 -0000 +@@ -17,5 +17,5 @@ + */ + +-/* $Id: config.h.in,v 1.47.2.3.2.19 2005/10/14 01:44:44 marka Exp $ */ ++/* $Id: acconfig.h,v 1.35.2.4.2.10 2004/12/04 06:50:02 marka Exp $ */ + + /*** @@ -177,4 +177,7 @@ #undef HAVE_LINUX_CAPABILITY_H @@ -155,25 +162,25 @@ diff -U2 -r1.47.2.3.2.17 config.h.in + /* Define to 1 if you have the <stdint.h> header file. */ #undef HAVE_STDINT_H -@@ -253,4 +259,7 @@ - #undef TIME_WITH_SYS_TIME +@@ -257,4 +263,7 @@ + #undef USE_FIONBIO_IOCTL +/* define if idnkit support is to be included. */ +#undef WITH_IDN + - /* Defined if you need to use ioctl(FIONBIO) instead a fcntl call to make - non-blocking. */ + /* Define to 1 if your processor stores words with the most significant byte + first (like Motorola and SPARC, unlike Intel and VAX). */ Index: configure =================================================================== RCS file: /proj/cvs/prod/bind9/configure,v -retrieving revision 1.284.2.19.2.43 -diff -U2 -r1.284.2.19.2.43 configure ---- configure 18 Jul 2005 05:26:11 -0000 1.284.2.19.2.43 -+++ configure 6 Sep 2005 00:41:54 -0000 +retrieving revision 1.284.2.19.2.46 +diff -U2 -r1.284.2.19.2.46 configure +--- configure 14 Oct 2005 01:44:45 -0000 1.284.2.19.2.46 ++++ configure 14 Oct 2005 03:37:16 -0000 @@ -15,5 +15,5 @@ # PERFORMANCE OF THIS SOFTWARE. # --# $Id: configure,v 1.284.2.19.2.43 2005/07/18 05:26:11 marka Exp $ +-# $Id: configure,v 1.284.2.19.2.46 2005/10/14 01:44:45 marka Exp $ +# $Id: COPYRIGHT,v 1.6.2.2.8.3 2005/01/10 23:51:37 marka Exp $ # # Portions Copyright (C) 1996-2001 Nominum, Inc. @@ -193,183 +200,183 @@ diff -U2 -r1.284.2.19.2.43 configure + --with-idnlib=ARG specify libidnkit Some influential environment variables: -@@ -8133,5 +8137,5 @@ +@@ -8140,5 +8144,5 @@ *-*-irix6*) # Find out which ABI we are using. -- echo '#line 8135 "configure"' > conftest.$ac_ext -+ echo '#line 8139 "configure"' > conftest.$ac_ext +- echo '#line 8142 "configure"' > conftest.$ac_ext ++ echo '#line 8146 "configure"' > conftest.$ac_ext if { (eval echo "$as_me:$LINENO: \"$ac_compile\"") >&5 (eval $ac_compile) 2>&5 -@@ -9130,5 +9134,5 @@ +@@ -9137,5 +9141,5 @@ # Provide some information about the compiler. --echo "$as_me:9132:" \ -+echo "$as_me:9136:" \ +-echo "$as_me:9139:" \ ++echo "$as_me:9143:" \ "checking for Fortran 77 compiler version" >&5 ac_compiler=`set X $ac_compile; echo $2` -@@ -10191,9 +10195,9 @@ +@@ -10198,9 +10202,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:10193: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:10197: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:10200: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:10204: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 -- echo "$as_me:10197: \$? = $ac_status" >&5 -+ echo "$as_me:10201: \$? = $ac_status" >&5 +- echo "$as_me:10204: \$? = $ac_status" >&5 ++ echo "$as_me:10208: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized -@@ -10434,9 +10438,9 @@ +@@ -10441,9 +10445,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:10436: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:10440: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:10443: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:10447: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 -- echo "$as_me:10440: \$? = $ac_status" >&5 -+ echo "$as_me:10444: \$? = $ac_status" >&5 +- echo "$as_me:10447: \$? = $ac_status" >&5 ++ echo "$as_me:10451: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized -@@ -10494,9 +10498,9 @@ +@@ -10501,9 +10505,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:10496: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:10500: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:10503: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:10507: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 -- echo "$as_me:10500: \$? = $ac_status" >&5 -+ echo "$as_me:10504: \$? = $ac_status" >&5 +- echo "$as_me:10507: \$? = $ac_status" >&5 ++ echo "$as_me:10511: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then -@@ -12679,5 +12683,5 @@ +@@ -12686,5 +12690,5 @@ lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF --#line 12681 "configure" -+#line 12685 "configure" +-#line 12688 "configure" ++#line 12692 "configure" #include "confdefs.h" -@@ -12777,5 +12781,5 @@ +@@ -12784,5 +12788,5 @@ lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF --#line 12779 "configure" -+#line 12783 "configure" +-#line 12786 "configure" ++#line 12790 "configure" #include "confdefs.h" -@@ -14974,9 +14978,9 @@ +@@ -14981,9 +14985,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:14976: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:14980: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:14983: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:14987: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 -- echo "$as_me:14980: \$? = $ac_status" >&5 -+ echo "$as_me:14984: \$? = $ac_status" >&5 +- echo "$as_me:14987: \$? = $ac_status" >&5 ++ echo "$as_me:14991: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized -@@ -15034,9 +15038,9 @@ +@@ -15041,9 +15045,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:15036: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:15040: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:15043: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:15047: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 -- echo "$as_me:15040: \$? = $ac_status" >&5 -+ echo "$as_me:15044: \$? = $ac_status" >&5 +- echo "$as_me:15047: \$? = $ac_status" >&5 ++ echo "$as_me:15051: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then -@@ -16395,5 +16399,5 @@ +@@ -16402,5 +16406,5 @@ lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF --#line 16397 "configure" -+#line 16401 "configure" +-#line 16404 "configure" ++#line 16408 "configure" #include "confdefs.h" -@@ -16493,5 +16497,5 @@ +@@ -16500,5 +16504,5 @@ lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF --#line 16495 "configure" -+#line 16499 "configure" +-#line 16502 "configure" ++#line 16506 "configure" #include "confdefs.h" -@@ -17330,9 +17334,9 @@ +@@ -17337,9 +17341,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:17332: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:17336: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:17339: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:17343: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 -- echo "$as_me:17336: \$? = $ac_status" >&5 -+ echo "$as_me:17340: \$? = $ac_status" >&5 +- echo "$as_me:17343: \$? = $ac_status" >&5 ++ echo "$as_me:17347: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized -@@ -17390,9 +17394,9 @@ +@@ -17397,9 +17401,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:17392: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:17396: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:17399: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:17403: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 -- echo "$as_me:17396: \$? = $ac_status" >&5 -+ echo "$as_me:17400: \$? = $ac_status" >&5 +- echo "$as_me:17403: \$? = $ac_status" >&5 ++ echo "$as_me:17407: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then -@@ -19429,9 +19433,9 @@ +@@ -19436,9 +19440,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:19431: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:19435: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:19438: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:19442: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 -- echo "$as_me:19435: \$? = $ac_status" >&5 -+ echo "$as_me:19439: \$? = $ac_status" >&5 +- echo "$as_me:19442: \$? = $ac_status" >&5 ++ echo "$as_me:19446: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized -@@ -19672,9 +19676,9 @@ +@@ -19679,9 +19683,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:19674: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:19678: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:19681: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:19685: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 -- echo "$as_me:19678: \$? = $ac_status" >&5 -+ echo "$as_me:19682: \$? = $ac_status" >&5 +- echo "$as_me:19685: \$? = $ac_status" >&5 ++ echo "$as_me:19689: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized -@@ -19732,9 +19736,9 @@ +@@ -19739,9 +19743,9 @@ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` -- (eval echo "\"\$as_me:19734: $lt_compile\"" >&5) -+ (eval echo "\"\$as_me:19738: $lt_compile\"" >&5) +- (eval echo "\"\$as_me:19741: $lt_compile\"" >&5) ++ (eval echo "\"\$as_me:19745: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 -- echo "$as_me:19738: \$? = $ac_status" >&5 -+ echo "$as_me:19742: \$? = $ac_status" >&5 +- echo "$as_me:19745: \$? = $ac_status" >&5 ++ echo "$as_me:19749: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then -@@ -21917,5 +21921,5 @@ +@@ -21924,5 +21928,5 @@ lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF --#line 21919 "configure" -+#line 21923 "configure" +-#line 21926 "configure" ++#line 21930 "configure" #include "confdefs.h" -@@ -22015,5 +22019,5 @@ +@@ -22022,5 +22026,5 @@ lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF --#line 22017 "configure" -+#line 22021 "configure" +-#line 22024 "configure" ++#line 22028 "configure" #include "confdefs.h" -@@ -27763,4 +27767,354 @@ +@@ -27771,4 +27775,354 @@ # +# IDN support @@ -724,7 +731,7 @@ diff -U2 -r1.284.2.19.2.43 configure +# # Substitutions # -@@ -28651,4 +29005,5 @@ +@@ -28660,4 +29014,5 @@ s,@XSLT_DB2LATEX_STYLE@,$XSLT_DB2LATEX_STYLE,;t t s,@XSLT_DB2LATEX_ADMONITIONS@,$XSLT_DB2LATEX_ADMONITIONS,;t t +s,@IDNLIBS@,$IDNLIBS,;t t @@ -733,11 +740,11 @@ diff -U2 -r1.284.2.19.2.43 configure Index: configure.in =================================================================== RCS file: /proj/cvs/prod/bind9/configure.in,v -retrieving revision 1.294.2.23.2.47 -diff -U2 -r1.294.2.23.2.47 configure.in ---- configure.in 18 Jul 2005 05:22:57 -0000 1.294.2.23.2.47 -+++ configure.in 6 Sep 2005 00:41:57 -0000 -@@ -1966,4 +1966,80 @@ +retrieving revision 1.294.2.23.2.50 +diff -U2 -r1.294.2.23.2.50 configure.in +--- configure.in 14 Oct 2005 01:38:39 -0000 1.294.2.23.2.50 ++++ configure.in 14 Oct 2005 03:37:21 -0000 +@@ -1982,4 +1982,80 @@ # +# IDN support @@ -824,7 +831,7 @@ RCS file: /proj/cvs/prod/bind9/bin/dig/Makefile.in,v retrieving revision 1.25.12.12 diff -U2 -r1.25.12.12 Makefile.in --- bin/dig/Makefile.in 18 Aug 2004 23:25:57 -0000 1.25.12.12 -+++ bin/dig/Makefile.in 6 Sep 2005 00:41:57 -0000 ++++ bin/dig/Makefile.in 14 Oct 2005 03:37:21 -0000 @@ -46,5 +46,5 @@ LIBS = ${LWRESLIBS} ${DNSLIBS} ${BIND9LIBS} ${ISCLIBS} \ @@ -835,32 +842,25 @@ diff -U2 -r1.25.12.12 Makefile.in Index: bin/dig/dig.1 =================================================================== RCS file: /proj/cvs/prod/bind9/bin/dig/dig.1,v -retrieving revision 1.14.2.4.2.9 -diff -U2 -r1.14.2.4.2.9 dig.1 ---- bin/dig/dig.1 30 Aug 2005 02:34:59 -0000 1.14.2.4.2.9 -+++ bin/dig/dig.1 6 Sep 2005 00:41:58 -0000 -@@ -14,5 +14,5 @@ - .\" PERFORMANCE OF THIS SOFTWARE. - .\" --.\" $Id: dig.1,v 1.14.2.4.2.9 2005/08/30 02:34:59 marka Exp $ -+.\" $Id$ - .\" - .hy 0 +retrieving revision 1.14.2.4.2.10 +diff -U2 -r1.14.2.4.2.10 dig.1 +--- bin/dig/dig.1 13 Oct 2005 02:33:42 -0000 1.14.2.4.2.10 ++++ bin/dig/dig.1 14 Oct 2005 03:37:22 -0000 @@ -223,4 +223,7 @@ - .fi - shows how \fBdig\fR could be used from the command line to make three lookups: an ANY query for www\&.isc\&.org, a reverse lookup of 127\&.0\&.0\&.1 and a query for the NS records of isc\&.org\&. A global query option of \fI+qr\fR is applied, so that \fBdig\fR shows the initial query it made for each lookup\&. The final query has a local query option of \fI+noqr\fR which means that \fBdig\fR will not print the initial query when it looks up the NS records for isc\&.org\&. + \fIresolv.conf\fR + (if any). The search list is not used by default. +.SH "IDN SUPPORT" +.PP +If \fBdig\fR has been built with IDN (internationalized domain name) support, it can accept and display non\-ASCII domain names\&. \fBdig\fR appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you'd like to turn off the IDN support for some reason, defines the \fBIDN_DISABLE\fR environment variable\&. The IDN support is disabled if the the variable is set when \fBdig\fR runs\&. - .SH "FILES" - .PP + .TP + \fB+[no]defname\fR Index: bin/dig/dig.docbook =================================================================== RCS file: /proj/cvs/prod/bind9/bin/dig/dig.docbook,v retrieving revision 1.4.2.7.4.12 diff -U2 -r1.4.2.7.4.12 dig.docbook --- bin/dig/dig.docbook 30 Aug 2005 00:50:29 -0000 1.4.2.7.4.12 -+++ bin/dig/dig.docbook 6 Sep 2005 00:42:00 -0000 ++++ bin/dig/dig.docbook 14 Oct 2005 03:37:25 -0000 @@ -608,4 +608,19 @@ <refsect1> @@ -884,10 +884,10 @@ diff -U2 -r1.4.2.7.4.12 dig.docbook Index: bin/dig/dighost.c =================================================================== RCS file: /proj/cvs/prod/bind9/bin/dig/dighost.c,v -retrieving revision 1.221.2.19.2.28 -diff -U2 -r1.221.2.19.2.28 dighost.c ---- bin/dig/dighost.c 1 Sep 2005 03:16:10 -0000 1.221.2.19.2.28 -+++ bin/dig/dighost.c 6 Sep 2005 00:42:10 -0000 +retrieving revision 1.221.2.19.2.31 +diff -U2 -r1.221.2.19.2.31 dighost.c +--- bin/dig/dighost.c 14 Oct 2005 01:38:40 -0000 1.221.2.19.2.31 ++++ bin/dig/dighost.c 14 Oct 2005 03:37:35 -0000 @@ -33,4 +33,15 @@ #include <limits.h> @@ -921,7 +921,7 @@ diff -U2 -r1.221.2.19.2.28 dighost.c + /* * Exit Codes: -@@ -984,4 +1007,8 @@ +@@ -986,4 +1009,8 @@ copy_server_list(lwconf, &server_list); +#ifdef WITH_IDN @@ -930,7 +930,7 @@ diff -U2 -r1.221.2.19.2.28 dighost.c + if (keyfile[0] != 0) setup_file_key(); -@@ -1600,4 +1627,12 @@ +@@ -1602,4 +1629,12 @@ dns_compress_t cctx; char store[MXNAME]; +#ifdef WITH_IDN @@ -943,7 +943,7 @@ diff -U2 -r1.221.2.19.2.28 dighost.c +#endif REQUIRE(lookup != NULL); -@@ -1628,4 +1663,15 @@ +@@ -1630,4 +1665,15 @@ sizeof(lookup->onamespace)); +#ifdef WITH_IDN @@ -959,7 +959,7 @@ diff -U2 -r1.221.2.19.2.28 dighost.c + /* * If the name has too many dots, force the origin to be NULL -@@ -1636,4 +1682,11 @@ +@@ -1638,4 +1684,11 @@ */ /* XXX New search here? */ +#ifdef WITH_IDN @@ -971,7 +971,7 @@ diff -U2 -r1.221.2.19.2.28 dighost.c +#else if ((count_dots(lookup->textname) >= ndots) || !usesearch) lookup->origin = NULL; /* Force abs lookup */ -@@ -1641,5 +1694,27 @@ +@@ -1643,5 +1696,27 @@ lookup->origin = ISC_LIST_HEAD(search_list); +#endif @@ -999,7 +999,7 @@ diff -U2 -r1.221.2.19.2.28 dighost.c +#endif debug("trying origin %s", lookup->origin->origin); result = dns_message_gettempname(lookup->sendmsg, -@@ -1686,4 +1761,13 @@ +@@ -1688,4 +1763,13 @@ dns_name_clone(dns_rootname, lookup->name); else { +#ifdef WITH_IDN @@ -1013,13 +1013,13 @@ diff -U2 -r1.221.2.19.2.28 dighost.c +#else len = strlen(lookup->textname); isc_buffer_init(&b, lookup->textname, len); -@@ -1693,4 +1777,5 @@ +@@ -1695,4 +1779,5 @@ ISC_FALSE, &lookup->namebuf); +#endif } if (result != ISC_R_SUCCESS) { -@@ -3196,6 +3281,101 @@ +@@ -3198,6 +3283,101 @@ } +#ifdef WITH_IDN @@ -1121,41 +1121,28 @@ diff -U2 -r1.221.2.19.2.28 dighost.c +#endif /* WITH_IDN */ #ifdef DIG_SIGCHASE -@@ -5067,5 +5247,4 @@ - return (ret); - } --:q: Command not found. - } - #endif Index: bin/dig/host.1 =================================================================== RCS file: /proj/cvs/prod/bind9/bin/dig/host.1,v -retrieving revision 1.11.2.1.4.6 -diff -U2 -r1.11.2.1.4.6 host.1 ---- bin/dig/host.1 13 May 2005 02:43:18 -0000 1.11.2.1.4.6 -+++ bin/dig/host.1 6 Sep 2005 00:42:11 -0000 -@@ -14,5 +14,5 @@ - .\" PERFORMANCE OF THIS SOFTWARE. - .\" --.\" $Id: host.1,v 1.11.2.1.4.6 2005/05/13 02:43:18 marka Exp $ -+.\" $Id$ - .\" - .hy 0 +retrieving revision 1.11.2.1.4.7 +diff -U2 -r1.11.2.1.4.7 host.1 +--- bin/dig/host.1 13 Oct 2005 02:33:43 -0000 1.11.2.1.4.7 ++++ bin/dig/host.1 14 Oct 2005 03:37:36 -0000 @@ -74,4 +74,7 @@ - .PP - The time to wait for a reply can be controlled through the \fB\-W\fR and \fB\-w\fR options\&. The \fB\-W\fR option makes \fBhost\fR wait for \fIwait\fR seconds\&. If \fIwait\fR is less than one, the wait interval is set to one second\&. When the \fB\-w\fR option is used, \fBhost\fR will 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\&. + when the + \fB\-d\fR +.SH "IDN SUPPORT" +.PP +If \fBhost\fR has been built with IDN (internationalized domain name) support, it can accept and display non\-ASCII domain names\&. \fBhost\fR appropriately converts character encoding of domain name before sending a request to DNS server or displaying a reply from the server\&. If you'd like to turn off the IDN support for some reason, defines the \fBIDN_DISABLE\fR environment variable\&. The IDN support is disabled if the the variable is set when \fBhost\fR runs\&. - .SH "FILES" - .PP + or + \fB\-v\fR Index: bin/dig/host.docbook =================================================================== RCS file: /proj/cvs/prod/bind9/bin/dig/host.docbook,v retrieving revision 1.2.2.2.4.7 diff -U2 -r1.2.2.2.4.7 host.docbook --- bin/dig/host.docbook 13 May 2005 01:22:32 -0000 1.2.2.2.4.7 -+++ bin/dig/host.docbook 6 Sep 2005 00:42:11 -0000 ++++ bin/dig/host.docbook 14 Oct 2005 03:37:36 -0000 @@ -208,4 +208,19 @@ <refsect1> @@ -1179,10 +1166,10 @@ diff -U2 -r1.2.2.2.4.7 host.docbook Index: lib/dns/name.c =================================================================== RCS file: /proj/cvs/prod/bind9/lib/dns/name.c,v -retrieving revision 1.127.2.7.2.13 -diff -U2 -r1.127.2.7.2.13 name.c ---- lib/dns/name.c 23 Jul 2005 04:34:37 -0000 1.127.2.7.2.13 -+++ lib/dns/name.c 6 Sep 2005 00:42:14 -0000 +retrieving revision 1.127.2.7.2.14 +diff -U2 -r1.127.2.7.2.14 name.c +--- lib/dns/name.c 14 Oct 2005 01:38:48 -0000 1.127.2.7.2.14 ++++ lib/dns/name.c 14 Oct 2005 03:37:39 -0000 @@ -183,4 +183,11 @@ dns_fullname_hash(dns_name_t *name, isc_boolean_t case_sensitive); @@ -1195,7 +1182,7 @@ diff -U2 -r1.127.2.7.2.13 name.c + static void set_offsets(const dns_name_t *name, unsigned char *offsets, -@@ -1208,4 +1215,7 @@ +@@ -1201,4 +1208,7 @@ unsigned int labels; isc_boolean_t saw_root = ISC_FALSE; +#ifdef WITH_IDN @@ -1203,7 +1190,7 @@ diff -U2 -r1.127.2.7.2.13 name.c +#endif /* -@@ -1347,4 +1357,9 @@ +@@ -1340,4 +1350,9 @@ isc_buffer_add(target, tlen - trem); +#ifdef WITH_IDN @@ -1213,7 +1200,7 @@ diff -U2 -r1.127.2.7.2.13 name.c + return (ISC_R_SUCCESS); } -@@ -2202,2 +2217,8 @@ +@@ -2195,2 +2210,8 @@ } +#ifdef WITH_IDN @@ -1228,7 +1215,7 @@ RCS file: /proj/cvs/prod/bind9/lib/dns/include/dns/name.h,v retrieving revision 1.95.2.3.2.12 diff -U2 -r1.95.2.3.2.12 name.h --- lib/dns/include/dns/name.h 8 Sep 2004 00:29:34 -0000 1.95.2.3.2.12 -+++ lib/dns/include/dns/name.h 6 Sep 2005 00:42:16 -0000 ++++ lib/dns/include/dns/name.h 14 Oct 2005 03:37:41 -0000 @@ -156,4 +156,15 @@ #define DNS_NAME_MAXWIRE 255 diff --git a/doc/Makefile.in b/doc/Makefile.in index e7dd9ca3..1e69dabd 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -1,4 +1,4 @@ -# Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") +# Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") # Copyright (C) 2000, 2001 Internet Software Consortium. # # Permission to use, copy, modify, and distribute this software for any @@ -13,7 +13,7 @@ # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. -# $Id: Makefile.in,v 1.4.206.1 2004/03/06 13:16:14 marka Exp $ +# $Id: Makefile.in,v 1.4.206.3 2005/09/13 00:34:54 marka Exp $ # This Makefile is a placeholder. It exists merely to make # sure that its directory gets created in the object directory @@ -23,7 +23,7 @@ srcdir = @srcdir@ VPATH = @srcdir@ top_srcdir = @top_srcdir@ -SUBDIRS = arm misc +SUBDIRS = arm misc xsl TARGETS = @BIND9_MAKE_RULES@ diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index d233c4d1..28ccb360 100644 --- a/doc/arm/Bv9ARM-book.xml +++ b/doc/arm/Bv9ARM-book.xml @@ -18,7 +18,7 @@ - PERFORMANCE OF THIS SOFTWARE. --> -<!-- File: $Id: Bv9ARM-book.xml,v 1.155.2.27.2.57 2005/06/07 01:22:34 marka Exp $ --> +<!-- File: $Id: Bv9ARM-book.xml,v 1.155.2.27.2.59 2005/10/10 00:22:24 marka Exp $ --> <book> <title>BIND 9 Administrator Reference Manual</title> @@ -2762,7 +2762,7 @@ statement in the <filename>named.conf</filename> file:</para> <optional> dnssec-lookaside <replaceable>domain</replaceable> trust-anchor <replaceable>domain</replaceable>; </optional> <optional> dnssec-must-be-secure <replaceable>domain yes_or_no</replaceable>; </optional> <optional> forward ( <replaceable>only</replaceable> | <replaceable>first</replaceable> ); </optional> - <optional> forwarders { <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; <optional> <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; ... </optional> }; </optional> + <optional> forwarders { <optional> <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; ... </optional> }; </optional> <optional> dual-stack-servers <optional>port <replaceable>ip_port</replaceable></optional> { ( <replaceable>domain_name</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> | <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ) ; ... }; </optional> <optional> check-names ( <replaceable>master</replaceable> | <replaceable>slave</replaceable> | <replaceable>response</replaceable> )( <replaceable>warn</replaceable> | <replaceable>fail</replaceable> | <replaceable>ignore</replaceable> ); </optional> <optional> allow-notify { <replaceable>address_match_list</replaceable> }; </optional> @@ -2996,7 +2996,7 @@ record does) the DNSKEY RRset is deemed to be trusted. <varlistentry><term><command>dnssec-must-be-secure</command></term> <listitem><para> -Specify heirachies which must / may not be secure (signed and validated). +Specify heirarchies which must / may not be secure (signed and validated). If <userinput>yes</userinput> then named will only accept answers if they are secure. If <userinput>no</userinput> then normal dnssec validation applies @@ -4605,7 +4605,7 @@ Statement Grammar</title> <optional> delegation-only <replaceable>yes_or_no</replaceable> ; </optional> <optional> file <replaceable>string</replaceable> ; </optional> <optional> forward (<constant>only</constant>|<constant>first</constant>) ; </optional> - <optional> forwarders { <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; <optional> <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; ... </optional> }; </optional> + <optional> forwarders { <optional> <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; ... </optional> }; </optional> <optional> ixfr-base <replaceable>string</replaceable> ; </optional> <optional> ixfr-tmp-file <replaceable>string</replaceable> ; </optional> <optional> maintain-ixfr-base <replaceable>yes_or_no</replaceable> ; </optional> diff --git a/doc/arm/Bv9ARM.ch01.html b/doc/arm/Bv9ARM.ch01.html index b158c163..37f1eec3 100644 --- a/doc/arm/Bv9ARM.ch01.html +++ b/doc/arm/Bv9ARM.ch01.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch01.html,v 1.12.2.2.8.7 2005/07/18 02:36:47 marka Exp $ --> +<!-- $Id: Bv9ARM.ch01.html,v 1.12.2.2.8.9 2005/10/13 02:33:58 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 1. Introduction </title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> @@ -45,17 +45,17 @@ <div class="toc"> <p><b>Table of Contents</b></p> <dl> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2533851">Scope of Document</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2534082">Organization of This Document</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2534290">Conventions Used in This Document</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2534889">The Domain Name System (<span class="acronym">DNS</span>)</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2545879">Scope of Document</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2545905">Organization of This Document</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2545976">Conventions Used in This Document</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2546234">The Domain Name System (<span class="acronym">DNS</span>)</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2534909">DNS Fundamentals</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2534945">Domains and Domain Names</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535029">Zones</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535172">Authoritative Name Servers</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535264">Caching Name Servers</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535321">Name Servers in Multiple Roles</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546254">DNS Fundamentals</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2544105">Domains and Domain Names</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546579">Zones</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546653">Authoritative Name Servers</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546950">Caching Name Servers</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2547076">Name Servers in Multiple Roles</a></span></dt> </dl></dd> </dl> </div> @@ -67,7 +67,7 @@ hierarchical databases.</p> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2533851"></a>Scope of Document</h2></div></div></div> +<a name="id2545879"></a>Scope of Document</h2></div></div></div> <p>The Berkeley Internet Name Domain (<span class="acronym">BIND</span>) implements an domain name server for a number of operating systems. This document provides basic information about the installation and @@ -78,7 +78,7 @@ </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2534082"></a>Organization of This Document</h2></div></div></div> +<a name="id2545905"></a>Organization of This Document</h2></div></div></div> <p>In this document, <span class="emphasis"><em>Section 1</em></span> introduces the basic <span class="acronym">DNS</span> and <span class="acronym">BIND</span> concepts. <span class="emphasis"><em>Section 2</em></span> describes resource requirements for running <span class="acronym">BIND</span> in various @@ -103,7 +103,7 @@ </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2534290"></a>Conventions Used in This Document</h2></div></div></div> +<a name="id2545976"></a>Conventions Used in This Document</h2></div></div></div> <p>In this document, we use the following general typographic conventions:</p> <div class="informaltable"><table border="1"> @@ -169,7 +169,7 @@ describe:</em></span></p></td> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2534889"></a>The Domain Name System (<span class="acronym">DNS</span>)</h2></div></div></div> +<a name="id2546234"></a>The Domain Name System (<span class="acronym">DNS</span>)</h2></div></div></div> <p>The purpose of this document is to explain the installation and upkeep of the <span class="acronym">BIND</span> software package, and we begin by reviewing the fundamentals of the Domain Name System @@ -177,7 +177,7 @@ begin by reviewing the fundamentals of the Domain Name System </p> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2534909"></a>DNS Fundamentals</h3></div></div></div> +<a name="id2546254"></a>DNS Fundamentals</h3></div></div></div> <p>The Domain Name System (DNS) is the hierarchical, distributed database. It stores information for mapping Internet host names to IP addresses and vice versa, mail routing information, and other data @@ -192,7 +192,7 @@ libraries, <span><strong class="command">liblwres</strong></span> and <span><str </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2534945"></a>Domains and Domain Names</h3></div></div></div> +<a name="id2544105"></a>Domains and Domain Names</h3></div></div></div> <p>The data stored in the DNS is identified by <span class="emphasis"><em>domain names</em></span> that are organized as a tree according to organizational or administrative boundaries. Each node of the tree, @@ -229,7 +229,7 @@ the DNS protocol, please refer to the standards documents listed in </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535029"></a>Zones</h3></div></div></div> +<a name="id2546579"></a>Zones</h3></div></div></div> <p>To properly operate a name server, it is important to understand the difference between a <span class="emphasis"><em>zone</em></span> and a <span class="emphasis"><em>domain</em></span>.</p> @@ -269,7 +269,7 @@ actually asking for slave service for some collection of zones.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535172"></a>Authoritative Name Servers</h3></div></div></div> +<a name="id2546653"></a>Authoritative Name Servers</h3></div></div></div> <p>Each zone is served by at least one <span class="emphasis"><em>authoritative name server</em></span>, which contains the complete data for the zone. @@ -282,7 +282,7 @@ easy to identify when debugging DNS configurations using tools like <span><strong class="command">dig</strong></span> (<a href="Bv9ARM.ch03.html#diagnostic_tools" title="Diagnostic Tools">the section called “Diagnostic Tools”</a>).</p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2535194"></a>The Primary Master</h4></div></div></div> +<a name="id2546676"></a>The Primary Master</h4></div></div></div> <p> The authoritative server where the master copy of the zone data is maintained is called the <span class="emphasis"><em>primary master</em></span> server, or simply the @@ -293,7 +293,7 @@ the <span class="emphasis"><em>zone file</em></span> or <span class="emphasis">< </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2535216"></a>Slave Servers</h4></div></div></div> +<a name="id2546902"></a>Slave Servers</h4></div></div></div> <p>The other authoritative servers, the <span class="emphasis"><em>slave</em></span> servers (also known as <span class="emphasis"><em>secondary</em></span> servers) load the zone contents from another server using a replication process @@ -304,7 +304,7 @@ may itself act as a master to a subordinate slave server.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2535235"></a>Stealth Servers</h4></div></div></div> +<a name="id2546921"></a>Stealth Servers</h4></div></div></div> <p>Usually all of the zone's authoritative servers are listed in NS records in the parent zone. These NS records constitute a <span class="emphasis"><em>delegation</em></span> of the zone from the parent. @@ -329,7 +329,7 @@ with the outside world.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535264"></a>Caching Name Servers</h3></div></div></div> +<a name="id2546950"></a>Caching Name Servers</h3></div></div></div> <p>The resolver libraries provided by most operating systems are <span class="emphasis"><em>stub resolvers</em></span>, meaning that they are not capable of performing the full DNS resolution process by themselves by talking @@ -348,7 +348,7 @@ Time To Live (TTL) field associated with each resource record. </p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2535296"></a>Forwarding</h4></div></div></div> +<a name="id2547050"></a>Forwarding</h4></div></div></div> <p>Even a caching name server does not necessarily perform the complete recursive lookup itself. Instead, it can <span class="emphasis"><em>forward</em></span> some or all of the queries @@ -371,7 +371,7 @@ of.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535321"></a>Name Servers in Multiple Roles</h3></div></div></div> +<a name="id2547076"></a>Name Servers in Multiple Roles</h3></div></div></div> <p>The <span class="acronym">BIND</span> name server can simultaneously act as a master for some zones, a slave for other zones, and as a caching (recursive) server for a set of local clients.</p> diff --git a/doc/arm/Bv9ARM.ch02.html b/doc/arm/Bv9ARM.ch02.html index e639a72d..d3e946ad 100644 --- a/doc/arm/Bv9ARM.ch02.html +++ b/doc/arm/Bv9ARM.ch02.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch02.html,v 1.10.2.1.8.7 2005/07/18 02:36:47 marka Exp $ --> +<!-- $Id: Bv9ARM.ch02.html,v 1.10.2.1.8.8 2005/10/13 02:33:59 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 2. BIND Resource Requirements</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch01.html" title="Chapter 1. Introduction "> @@ -45,16 +45,16 @@ <div class="toc"> <p><b>Table of Contents</b></p> <dl> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535353">Hardware requirements</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535446">CPU Requirements</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535457">Memory Requirements</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535472">Name Server Intensive Environment Issues</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535480">Supported Operating Systems</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547108">Hardware requirements</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547132">CPU Requirements</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547143">Memory Requirements</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547158">Name Server Intensive Environment Issues</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547303">Supported Operating Systems</a></span></dt> </dl> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535353"></a>Hardware requirements</h2></div></div></div> +<a name="id2547108"></a>Hardware requirements</h2></div></div></div> <p><span class="acronym">DNS</span> hardware requirements have traditionally been quite modest. For many installations, servers that have been pensioned off from active duty have performed admirably as <span class="acronym">DNS</span> servers.</p> @@ -66,7 +66,7 @@ multiprocessor systems for installations that need it.</p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535446"></a>CPU Requirements</h2></div></div></div> +<a name="id2547132"></a>CPU Requirements</h2></div></div></div> <p>CPU requirements for <span class="acronym">BIND</span> 9 range from i486-class machines for serving of static zones without caching, to enterprise-class machines if you intend to process many dynamic updates and DNSSEC @@ -74,7 +74,7 @@ signed zones, serving many thousands of queries per second.</p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535457"></a>Memory Requirements</h2></div></div></div> +<a name="id2547143"></a>Memory Requirements</h2></div></div></div> <p>The memory of the server has to be large enough to fit the cache and zones loaded off disk. The <span><strong class="command">max-cache-size</strong></span> option can be used to limit the amount of memory used by the cache, @@ -88,7 +88,7 @@ fast as they are being inserted.</p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535472"></a>Name Server Intensive Environment Issues</h2></div></div></div> +<a name="id2547158"></a>Name Server Intensive Environment Issues</h2></div></div></div> <p>For name server intensive environments, there are two alternative configurations that may be used. The first is where clients and any second-level internal name servers query a main name server, which @@ -102,7 +102,7 @@ as none of the name servers share their cached data.</p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535480"></a>Supported Operating Systems</h2></div></div></div> +<a name="id2547303"></a>Supported Operating Systems</h2></div></div></div> <p>ISC <span class="acronym">BIND</span> 9 compiles and runs on a large number of Unix-like operating system and on Windows NT / 2000. For an up-to-date list of supported systems, see the README file in the top level directory diff --git a/doc/arm/Bv9ARM.ch03.html b/doc/arm/Bv9ARM.ch03.html index f9201fa2..4d6d93be 100644 --- a/doc/arm/Bv9ARM.ch03.html +++ b/doc/arm/Bv9ARM.ch03.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch03.html,v 1.26.2.5.4.10 2005/07/19 06:15:23 marka Exp $ --> +<!-- $Id: Bv9ARM.ch03.html,v 1.26.2.5.4.11 2005/10/13 02:33:59 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 3. Name Server Configuration</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch02.html" title="Chapter 2. BIND Resource Requirements"> @@ -47,14 +47,14 @@ <dl> <dt><span class="sect1"><a href="Bv9ARM.ch03.html#sample_configuration">Sample Configurations</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2535579">A Caching-only Name Server</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2535595">An Authoritative-only Name Server</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2547334">A Caching-only Name Server</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2547350">An Authoritative-only Name Server</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2535618">Load Balancing</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2535970">Name Server Operations</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2547372">Load Balancing</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2547656">Name Server Operations</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2535975">Tools for Use With the Name Server Daemon</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2537297">Signals</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2547661">Tools for Use With the Name Server Daemon</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2548915">Signals</a></span></dt> </dl></dd> </dl> </div> @@ -66,7 +66,7 @@ option setting.</p> <a name="sample_configuration"></a>Sample Configurations</h2></div></div></div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535579"></a>A Caching-only Name Server</h3></div></div></div> +<a name="id2547334"></a>A Caching-only Name Server</h3></div></div></div> <p>The following sample configuration is appropriate for a caching-only name server for use by clients internal to a corporation. All queries from outside clients are refused using the <span><strong class="command">allow-query</strong></span> @@ -89,7 +89,7 @@ zone "0.0.127.in-addr.arpa" { </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535595"></a>An Authoritative-only Name Server</h3></div></div></div> +<a name="id2547350"></a>An Authoritative-only Name Server</h3></div></div></div> <p>This sample configuration is for an authoritative-only server that is the master server for "<code class="filename">example.com</code>" and a slave for the subdomain "<code class="filename">eng.example.com</code>".</p> @@ -128,7 +128,7 @@ zone "eng.example.com" { </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535618"></a>Load Balancing</h2></div></div></div> +<a name="id2547372"></a>Load Balancing</h2></div></div></div> <p>A primitive form of load balancing can be achieved in the <span class="acronym">DNS</span> by using multiple A records for one name.</p> <p>For example, if you have three WWW servers with network addresses @@ -189,10 +189,10 @@ of the time:</p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2535970"></a>Name Server Operations</h2></div></div></div> +<a name="id2547656"></a>Name Server Operations</h2></div></div></div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2535975"></a>Tools for Use With the Name Server Daemon</h3></div></div></div> +<a name="id2547661"></a>Tools for Use With the Name Server Daemon</h3></div></div></div> <p>There are several indispensable diagnostic, administrative and monitoring tools available to the system administrator for controlling and debugging the name server daemon. We describe several in this @@ -474,7 +474,7 @@ a <code class="filename">rndc.key</code> file and not modify </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2537297"></a>Signals</h3></div></div></div> +<a name="id2548915"></a>Signals</h3></div></div></div> <p>Certain UNIX signals cause the name server to take specific actions, as described in the following table. These signals can be sent using the <span><strong class="command">kill</strong></span> command.</p> diff --git a/doc/arm/Bv9ARM.ch04.html b/doc/arm/Bv9ARM.ch04.html index c91948cb..8165dbba 100644 --- a/doc/arm/Bv9ARM.ch04.html +++ b/doc/arm/Bv9ARM.ch04.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch04.html,v 1.30.2.6.2.13 2005/07/19 06:15:25 marka Exp $ --> +<!-- $Id: Bv9ARM.ch04.html,v 1.30.2.6.2.14 2005/10/13 02:33:59 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 4. Advanced DNS Features</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch03.html" title="Chapter 3. Name Server Configuration"> @@ -49,28 +49,28 @@ <dt><span class="sect1"><a href="Bv9ARM.ch04.html#dynamic_update">Dynamic Update</a></span></dt> <dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch04.html#journal">The journal file</a></span></dt></dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch04.html#incremental_zone_transfers">Incremental Zone Transfers (IXFR)</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2537721">Split DNS</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2549203">Split DNS</a></span></dt> <dt><span class="sect1"><a href="Bv9ARM.ch04.html#tsig">TSIG</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538214">Generate Shared Keys for Each Pair of Hosts</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538280">Copying the Shared Secret to Both Machines</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538289">Informing the Servers of the Key's Existence</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538396">Instructing the Server to Use the Key</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538449">TSIG Key Based Access Control</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538492">Errors</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549627">Generate Shared Keys for Each Pair of Hosts</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549830">Copying the Shared Secret to Both Machines</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549838">Informing the Servers of the Key's Existence</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549878">Instructing the Server to Use the Key</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549998">TSIG Key Based Access Control</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550042">Errors</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2538506">TKEY</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2538555">SIG(0)</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2550056">TKEY</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2550173">SIG(0)</a></span></dt> <dt><span class="sect1"><a href="Bv9ARM.ch04.html#DNSSEC">DNSSEC</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538621">Generating Keys</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538757">Signing the Zone</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538832">Configuring Servers</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550308">Generating Keys</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550375">Signing the Zone</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550450">Configuring Servers</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2538855">IPv6 Support in <span class="acronym">BIND</span> 9</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2550473">IPv6 Support in <span class="acronym">BIND</span> 9</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538982">Address Lookups Using AAAA Records</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2539002">Address to Name Lookups Using Nibble Format</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550600">Address Lookups Using AAAA Records</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550620">Address to Name Lookups Using Nibble Format</a></span></dt> </dl></dd> </dl> </div> @@ -168,7 +168,7 @@ of the <span><strong class="command">server</strong></span> statement.</p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2537721"></a>Split DNS</h2></div></div></div> +<a name="id2549203"></a>Split DNS</h2></div></div></div> <p>Setting up different views, or visibility, of the DNS space to internal and external resolvers is usually referred to as a <span class="emphasis"><em>Split DNS</em></span> setup. There are several reasons an organization @@ -372,13 +372,13 @@ for TSIG.</p> <code class="option">-y</code> command line options.</p> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538214"></a>Generate Shared Keys for Each Pair of Hosts</h3></div></div></div> +<a name="id2549627"></a>Generate Shared Keys for Each Pair of Hosts</h3></div></div></div> <p>A shared secret is generated to be shared between <span class="emphasis"><em>host1</em></span> and <span class="emphasis"><em>host2</em></span>. An arbitrary key name is chosen: "host1-host2.". The key name must be the same on both hosts.</p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2538230"></a>Automatic Generation</h4></div></div></div> +<a name="id2549643"></a>Automatic Generation</h4></div></div></div> <p>The following command will generate a 128 bit (16 byte) HMAC-MD5 key as described above. Longer keys are better, but shorter keys are easier to read. Note that the maximum key length is 512 bits; @@ -395,7 +395,7 @@ be used as the shared secret.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2538264"></a>Manual Generation</h4></div></div></div> +<a name="id2549677"></a>Manual Generation</h4></div></div></div> <p>The shared secret is simply a random sequence of bits, encoded in base-64. Most ASCII strings are valid base-64 strings (assuming the length is a multiple of 4 and only valid characters are used), @@ -406,13 +406,13 @@ a similar program to generate base-64 encoded data.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538280"></a>Copying the Shared Secret to Both Machines</h3></div></div></div> +<a name="id2549830"></a>Copying the Shared Secret to Both Machines</h3></div></div></div> <p>This is beyond the scope of DNS. A secure transport mechanism should be used. This could be secure FTP, ssh, telephone, etc.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538289"></a>Informing the Servers of the Key's Existence</h3></div></div></div> +<a name="id2549838"></a>Informing the Servers of the Key's Existence</h3></div></div></div> <p>Imagine <span class="emphasis"><em>host1</em></span> and <span class="emphasis"><em>host 2</em></span> are both servers. The following is added to each server's <code class="filename">named.conf</code> file:</p> <pre class="programlisting"> @@ -433,7 +433,7 @@ response is signed by the same key.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538396"></a>Instructing the Server to Use the Key</h3></div></div></div> +<a name="id2549878"></a>Instructing the Server to Use the Key</h3></div></div></div> <p>Since keys are shared between two hosts only, the server must be told when keys are to be used. The following is added to the <code class="filename">named.conf</code> file for <span class="emphasis"><em>host1</em></span>, if the IP address of <span class="emphasis"><em>host2</em></span> is @@ -456,7 +456,7 @@ sign request messages to <span class="emphasis"><em>host1</em></span>.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538449"></a>TSIG Key Based Access Control</h3></div></div></div> +<a name="id2549998"></a>TSIG Key Based Access Control</h3></div></div></div> <p><span class="acronym">BIND</span> allows IP addresses and ranges to be specified in ACL definitions and <span><strong class="command">allow-{ query | transfer | update }</strong></span> directives. @@ -474,7 +474,7 @@ allow-update { key host1-host2. ;}; </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538492"></a>Errors</h3></div></div></div> +<a name="id2550042"></a>Errors</h3></div></div></div> <p>The processing of TSIG signed messages can result in several errors. If a signed message is sent to a non-TSIG aware server, a FORMERR will be returned, since the server will not @@ -496,7 +496,7 @@ allow-update { key host1-host2. ;}; </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2538506"></a>TKEY</h2></div></div></div> +<a name="id2550056"></a>TKEY</h2></div></div></div> <p><span><strong class="command">TKEY</strong></span> is a mechanism for automatically generating a shared secret between two hosts. There are several "modes" of <span><strong class="command">TKEY</strong></span> that specify how the key is @@ -523,7 +523,7 @@ allow-update { key host1-host2. ;}; </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2538555"></a>SIG(0)</h2></div></div></div> +<a name="id2550173"></a>SIG(0)</h2></div></div></div> <p><span class="acronym">BIND</span> 9 partially supports DNSSEC SIG(0) transaction signatures as specified in RFC 2535 and RFC2931. SIG(0) uses public/private keys to authenticate messages. Access control @@ -565,7 +565,7 @@ allow-update { key host1-host2. ;}; zone key of another zone above this one in the DNS tree.</p> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538621"></a>Generating Keys</h3></div></div></div> +<a name="id2550308"></a>Generating Keys</h3></div></div></div> <p>The <span><strong class="command">dnssec-keygen</strong></span> program is used to generate keys.</p> <p>A secure zone must contain one or more zone keys. The @@ -598,7 +598,7 @@ allow-update { key host1-host2. ;}; </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538757"></a>Signing the Zone</h3></div></div></div> +<a name="id2550375"></a>Signing the Zone</h3></div></div></div> <p>The <span><strong class="command">dnssec-signzone</strong></span> program is used to sign a zone.</p> <p>Any <code class="filename">keyset</code> files corresponding @@ -625,7 +625,7 @@ allow-update { key host1-host2. ;}; </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538832"></a>Configuring Servers</h3></div></div></div> +<a name="id2550450"></a>Configuring Servers</h3></div></div></div> <p>Unlike <span class="acronym">BIND</span> 8, <span class="acronym">BIND</span> 9 does not verify signatures on load, so zone keys for authoritative zones do not need to be specified @@ -637,7 +637,7 @@ statement, as described later in this document. </p> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2538855"></a>IPv6 Support in <span class="acronym">BIND</span> 9</h2></div></div></div> +<a name="id2550473"></a>IPv6 Support in <span class="acronym">BIND</span> 9</h2></div></div></div> <p><span class="acronym">BIND</span> 9 fully supports all currently defined forms of IPv6 name to address and address to name lookups. It will also use IPv6 addresses to make queries when running on an IPv6 capable @@ -666,7 +666,7 @@ statement, as described later in this document. </p> see <a href="Bv9ARM.ch09.html#ipv6addresses" title="IPv6 addresses (AAAA)">the section called “IPv6 addresses (AAAA)”</a>.</p> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2538982"></a>Address Lookups Using AAAA Records</h3></div></div></div> +<a name="id2550600"></a>Address Lookups Using AAAA Records</h3></div></div></div> <p>The AAAA record is a parallel to the IPv4 A record. It specifies the entire address in a single record. For example,</p> @@ -681,7 +681,7 @@ host 3600 IN AAAA 2001:db8::1 </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2539002"></a>Address to Name Lookups Using Nibble Format</h3></div></div></div> +<a name="id2550620"></a>Address to Name Lookups Using Nibble Format</h3></div></div></div> <p>When looking up an address in nibble format, the address components are simply reversed, just as in IPv4, and <code class="literal">ip6.arpa.</code> is appended to the resulting name. diff --git a/doc/arm/Bv9ARM.ch05.html b/doc/arm/Bv9ARM.ch05.html index 5cce14f6..1720660b 100644 --- a/doc/arm/Bv9ARM.ch05.html +++ b/doc/arm/Bv9ARM.ch05.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch05.html,v 1.24.2.5.2.11 2005/07/19 06:15:25 marka Exp $ --> +<!-- $Id: Bv9ARM.ch05.html,v 1.24.2.5.2.12 2005/10/13 02:34:00 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 5. The BIND 9 Lightweight Resolver</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch04.html" title="Chapter 4. Advanced DNS Features"> @@ -45,13 +45,13 @@ <div class="toc"> <p><b>Table of Contents</b></p> <dl> -<dt><span class="sect1"><a href="Bv9ARM.ch05.html#id2539034">The Lightweight Resolver Library</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch05.html#id2550652">The Lightweight Resolver Library</a></span></dt> <dt><span class="sect1"><a href="Bv9ARM.ch05.html#lwresd">Running a Resolver Daemon</a></span></dt> </dl> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2539034"></a>The Lightweight Resolver Library</h2></div></div></div> +<a name="id2550652"></a>The Lightweight Resolver Library</h2></div></div></div> <p>Traditionally applications have been linked with a stub resolver library that sends recursive DNS queries to a local caching name server.</p> diff --git a/doc/arm/Bv9ARM.ch06.html b/doc/arm/Bv9ARM.ch06.html index a608e433..4b530006 100644 --- a/doc/arm/Bv9ARM.ch06.html +++ b/doc/arm/Bv9ARM.ch06.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch06.html,v 1.56.2.12.2.27 2005/07/19 06:15:26 marka Exp $ --> +<!-- $Id: Bv9ARM.ch06.html,v 1.56.2.12.2.30 2005/10/13 02:34:00 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 6. BIND 9 Configuration Reference</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch05.html" title="Chapter 5. The BIND 9 Lightweight Resolver"> @@ -48,46 +48,46 @@ <dt><span class="sect1"><a href="Bv9ARM.ch06.html#configuration_file_elements">Configuration File Elements</a></span></dt> <dd><dl> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#address_match_lists">Address Match Lists</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2540336">Comment Syntax</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2551817">Comment Syntax</a></span></dt> </dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch06.html#Configuration_File_Grammar">Configuration File Grammar</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2540753"><span><strong class="command">acl</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552302"><span><strong class="command">acl</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#acl"><span><strong class="command">acl</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2540989"><span><strong class="command">controls</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552471"><span><strong class="command">controls</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#controls_statement_definition_and_usage"><span><strong class="command">controls</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541326"><span><strong class="command">include</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541341"><span><strong class="command">include</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541364"><span><strong class="command">key</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541385"><span><strong class="command">key</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541457"><span><strong class="command">logging</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541719"><span><strong class="command">logging</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2542924"><span><strong class="command">lwres</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2542997"><span><strong class="command">lwres</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2543060"><span><strong class="command">masters</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2543104"><span><strong class="command">masters</strong></span> Statement Definition and Usage </a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2543118"><span><strong class="command">options</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552808"><span><strong class="command">include</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552823"><span><strong class="command">include</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552845"><span><strong class="command">key</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552867"><span><strong class="command">key</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2553006"><span><strong class="command">logging</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2553269"><span><strong class="command">logging</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554474"><span><strong class="command">lwres</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554547"><span><strong class="command">lwres</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554610"><span><strong class="command">masters</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554653"><span><strong class="command">masters</strong></span> Statement Definition and Usage </a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554668"><span><strong class="command">options</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#options"><span><strong class="command">options</strong></span> Statement Definition and Usage</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#server_statement_grammar"><span><strong class="command">server</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#server_statement_definition_and_usage"><span><strong class="command">server</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2550624"><span><strong class="command">trusted-keys</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2550672"><span><strong class="command">trusted-keys</strong></span> Statement Definition +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2562233"><span><strong class="command">trusted-keys</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2562281"><span><strong class="command">trusted-keys</strong></span> Statement Definition and Usage</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#view_statement_grammar"><span><strong class="command">view</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2550808"><span><strong class="command">view</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2562349"><span><strong class="command">view</strong></span> Statement Definition and Usage</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#zone_statement_grammar"><span><strong class="command">zone</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2551626"><span><strong class="command">zone</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2563022"><span><strong class="command">zone</strong></span> Statement Definition and Usage</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch06.html#id2553093">Zone File</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch06.html#id2564557">Zone File</a></span></dt> <dd><dl> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#types_of_resource_records_and_when_to_use_them">Types of Resource Records and When to Use Them</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554457">Discussion of MX Records</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2565990">Discussion of MX Records</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#Setting_TTLs">Setting TTLs</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2555022">Inverse Mapping in IPv4</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2555128">Other Zone File Directives</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2555365"><span class="acronym">BIND</span> Master File Extension: the <span><strong class="command">$GENERATE</strong></span> Directive</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2566487">Inverse Mapping in IPv4</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2566593">Other Zone File Directives</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2566761"><span class="acronym">BIND</span> Master File Extension: the <span><strong class="command">$GENERATE</strong></span> Directive</a></span></dt> </dl></dd> </dl> </div> @@ -244,7 +244,7 @@ are restricted to slave and stub zones.</p></td> <a name="address_match_lists"></a>Address Match Lists</h3></div></div></div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2540215"></a>Syntax</h4></div></div></div> +<a name="id2551560"></a>Syntax</h4></div></div></div> <pre class="programlisting"><code class="varname">address_match_list</code> = address_match_list_element ; [<span class="optional"> address_match_list_element; ... </span>] <code class="varname">address_match_list_element</code> = [<span class="optional"> ! </span>] (ip_address [<span class="optional">/length</span>] | @@ -253,7 +253,7 @@ are restricted to slave and stub zones.</p></td> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2540242"></a>Definition and Usage</h4></div></div></div> +<a name="id2551587"></a>Definition and Usage</h4></div></div></div> <p>Address match lists are primarily used to determine access control for various server operations. They are also used in the <span><strong class="command">listen-on</strong></span> and <span><strong class="command">sortlist</strong></span> @@ -303,14 +303,14 @@ other 1.2.3.* hosts fall through.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2540336"></a>Comment Syntax</h3></div></div></div> +<a name="id2551817"></a>Comment Syntax</h3></div></div></div> <p>The <span class="acronym">BIND</span> 9 comment syntax allows for comments to appear anywhere that white space may appear in a <span class="acronym">BIND</span> configuration file. To appeal to programmers of all kinds, they can be written in the C, C++, or shell/perl style.</p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2540350"></a>Syntax</h4></div></div></div> +<a name="id2551832"></a>Syntax</h4></div></div></div> <pre class="programlisting">/* This is a <span class="acronym">BIND</span> comment as in C */</pre> <p> </p> @@ -323,7 +323,7 @@ in the C, C++, or shell/perl style.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2540379"></a>Definition and Usage</h4></div></div></div> +<a name="id2551861"></a>Definition and Usage</h4></div></div></div> <p>Comments may appear anywhere that whitespace may appear in a <span class="acronym">BIND</span> configuration file.</p> <p>C-style comments start with the two characters /* (slash, @@ -444,7 +444,7 @@ a per-server basis.</p></td> configuration.</p> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2540753"></a><span><strong class="command">acl</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2552302"></a><span><strong class="command">acl</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting"><span><strong class="command">acl</strong></span> acl-name { address_match_list }; @@ -495,7 +495,7 @@ IPv6 addresses, just like <span><strong class="command">localhost</strong></span </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2540989"></a><span><strong class="command">controls</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2552471"></a><span><strong class="command">controls</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting"><span><strong class="command">controls</strong></span> { inet ( ip_addr | * ) [<span class="optional"> port ip_port </span>] allow { <em class="replaceable"><code> address_match_list </code></em> } keys { <em class="replaceable"><code> key_list </code></em> }; @@ -599,12 +599,12 @@ statement: <span><strong class="command">controls { };</strong></span>. </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2541326"></a><span><strong class="command">include</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2552808"></a><span><strong class="command">include</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting">include <em class="replaceable"><code>filename</code></em>;</pre> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2541341"></a><span><strong class="command">include</strong></span> Statement Definition and Usage</h3></div></div></div> +<a name="id2552823"></a><span><strong class="command">include</strong></span> Statement Definition and Usage</h3></div></div></div> <p>The <span><strong class="command">include</strong></span> statement inserts the specified file at the point where the <span><strong class="command">include</strong></span> statement is encountered. The <span><strong class="command">include</strong></span> @@ -615,7 +615,7 @@ statement: <span><strong class="command">controls { };</strong></span>. </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2541364"></a><span><strong class="command">key</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2552845"></a><span><strong class="command">key</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting">key <em class="replaceable"><code>key_id</code></em> { algorithm <em class="replaceable"><code>string</code></em>; secret <em class="replaceable"><code>string</code></em>; @@ -624,7 +624,7 @@ statement: <span><strong class="command">controls { };</strong></span>. </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2541385"></a><span><strong class="command">key</strong></span> Statement Definition and Usage</h3></div></div></div> +<a name="id2552867"></a><span><strong class="command">key</strong></span> Statement Definition and Usage</h3></div></div></div> <p>The <span><strong class="command">key</strong></span> statement defines a shared secret key for use with TSIG (see <a href="Bv9ARM.ch04.html#tsig" title="TSIG">the section called “TSIG”</a>) or the command channel @@ -656,7 +656,7 @@ string.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2541457"></a><span><strong class="command">logging</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2553006"></a><span><strong class="command">logging</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting"><span><strong class="command">logging</strong></span> { [ <span><strong class="command">channel</strong></span> <em class="replaceable"><code>channel_name</code></em> { ( <span><strong class="command">file</strong></span> <em class="replaceable"><code>path name</code></em> @@ -680,7 +680,7 @@ string.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2541719"></a><span><strong class="command">logging</strong></span> Statement Definition and Usage</h3></div></div></div> +<a name="id2553269"></a><span><strong class="command">logging</strong></span> Statement Definition and Usage</h3></div></div></div> <p>The <span><strong class="command">logging</strong></span> statement configures a wide variety of logging options for the name server. Its <span><strong class="command">channel</strong></span> phrase associates output methods, format options and severity levels with @@ -703,7 +703,7 @@ channels, or to standard error if the "<code class="option">-g</code>" option was specified.</p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2541771"></a>The <span><strong class="command">channel</strong></span> Phrase</h4></div></div></div> +<a name="id2553321"></a>The <span><strong class="command">channel</strong></span> Phrase</h4></div></div></div> <p>All log output goes to one or more <span class="emphasis"><em>channels</em></span>; you can make as many of them as you want.</p> <p>Every channel definition must include a destination clause that @@ -1018,7 +1018,7 @@ a <span><strong class="command">delegation-only</strong></span> in a hint or stu </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2542924"></a><span><strong class="command">lwres</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2554474"></a><span><strong class="command">lwres</strong></span> Statement Grammar</h3></div></div></div> <p> This is the grammar of the <span><strong class="command">lwres</strong></span> statement in the <code class="filename">named.conf</code> file:</p> <pre class="programlisting"><span><strong class="command">lwres</strong></span> { @@ -1031,7 +1031,7 @@ statement in the <code class="filename">named.conf</code> file:</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2542997"></a><span><strong class="command">lwres</strong></span> Statement Definition and Usage</h3></div></div></div> +<a name="id2554547"></a><span><strong class="command">lwres</strong></span> Statement Definition and Usage</h3></div></div></div> <p>The <span><strong class="command">lwres</strong></span> statement configures the name server to also act as a lightweight resolver server, see <a href="Bv9ARM.ch05.html#lwresd" title="Running a Resolver Daemon">the section called “Running a Resolver Daemon”</a>. There may be be multiple @@ -1059,20 +1059,20 @@ exact match lookup before search path elements are appended.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2543060"></a><span><strong class="command">masters</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2554610"></a><span><strong class="command">masters</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting"> <span><strong class="command">masters</strong></span> <em class="replaceable"><code>name</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] { ( <em class="replaceable"><code>masters_list</code></em> | <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] [<span class="optional">key <em class="replaceable"><code>key</code></em></span>] ) ; [<span class="optional">...</span>] } ; </pre> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2543104"></a><span><strong class="command">masters</strong></span> Statement Definition and Usage </h3></div></div></div> +<a name="id2554653"></a><span><strong class="command">masters</strong></span> Statement Definition and Usage </h3></div></div></div> <p><span><strong class="command">masters</strong></span> lists allow for a common set of masters to be easily used by multiple stub and slave zones.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2543118"></a><span><strong class="command">options</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2554668"></a><span><strong class="command">options</strong></span> Statement Grammar</h3></div></div></div> <p>This is the grammar of the <span><strong class="command">options</strong></span> statement in the <code class="filename">named.conf</code> file:</p> <pre class="programlisting">options { @@ -1109,7 +1109,7 @@ statement in the <code class="filename">named.conf</code> file:</p> [<span class="optional"> dnssec-lookaside <em class="replaceable"><code>domain</code></em> trust-anchor <em class="replaceable"><code>domain</code></em>; </span>] [<span class="optional"> dnssec-must-be-secure <em class="replaceable"><code>domain yes_or_no</code></em>; </span>] [<span class="optional"> forward ( <em class="replaceable"><code>only</code></em> | <em class="replaceable"><code>first</code></em> ); </span>] - [<span class="optional"> forwarders { <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ; [<span class="optional"> <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ; ... </span>] }; </span>] + [<span class="optional"> forwarders { [<span class="optional"> <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ; ... </span>] }; </span>] [<span class="optional"> dual-stack-servers [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] { ( <em class="replaceable"><code>domain_name</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] | <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ) ; ... }; </span>] [<span class="optional"> check-names ( <em class="replaceable"><code>master</code></em> | <em class="replaceable"><code>slave</code></em> | <em class="replaceable"><code>response</code></em> )( <em class="replaceable"><code>warn</code></em> | <em class="replaceable"><code>fail</code></em> | <em class="replaceable"><code>ignore</code></em> ); </span>] [<span class="optional"> allow-notify { <em class="replaceable"><code>address_match_list</code></em> }; </span>] @@ -1315,7 +1315,7 @@ record does) the DNSKEY RRset is deemed to be trusted. </p></dd> <dt><span class="term"><span><strong class="command">dnssec-must-be-secure</strong></span></span></dt> <dd><p> -Specify heirachies which must / may not be secure (signed and validated). +Specify heirarchies which must / may not be secure (signed and validated). If <strong class="userinput"><code>yes</code></strong> then named will only accept answers if they are secure. If <strong class="userinput"><code>no</code></strong> then normal dnssec validation applies @@ -1696,7 +1696,7 @@ IN-ADDR.ARPA, IP6.ARPA, IP6.INT). </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2545809"></a>Forwarding</h4></div></div></div> +<a name="id2557350"></a>Forwarding</h4></div></div></div> <p>The forwarding facility can be used to create a large site-wide cache on a few servers, reducing traffic over links to external name servers. It can also be used to allow queries by servers that @@ -1728,7 +1728,7 @@ Statement Grammar”</a>.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2545859"></a>Dual-stack Servers</h4></div></div></div> +<a name="id2557400"></a>Dual-stack Servers</h4></div></div></div> <p>Dual-stack servers are used as servers of last resort to work around problems in reachability due the lack of support for either IPv4 or IPv6 on the host machine.</p> @@ -1809,7 +1809,7 @@ from these addresses will not be responded to. The default is <strong class="use </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2546106"></a>Interfaces</h4></div></div></div> +<a name="id2557716"></a>Interfaces</h4></div></div></div> <p>The interfaces and ports that the server will answer queries from may be specified using the <span><strong class="command">listen-on</strong></span> option. <span><strong class="command">listen-on</strong></span> takes an optional port, and an <code class="varname">address_match_list</code>. @@ -1859,7 +1859,7 @@ the server will not listen on any IPv6 address.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2546195"></a>Query Address</h4></div></div></div> +<a name="id2557804"></a>Query Address</h4></div></div></div> <p>If the server doesn't know the answer to a question, it will query other name servers. <span><strong class="command">query-source</strong></span> specifies the address and port used for such queries. For queries sent over @@ -2033,7 +2033,7 @@ but applies to notify messages sent to IPv6 addresses.</p></dd> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2546925"></a>Bad UDP Port Lists</h4></div></div></div> +<a name="id2558398"></a>Bad UDP Port Lists</h4></div></div></div> <p> <span><strong class="command">avoid-v4-udp-ports</strong></span> and <span><strong class="command">avoid-v6-udp-ports</strong></span> specify a list of IPv4 and IPv6 UDP ports that will not be used as system @@ -2046,7 +2046,7 @@ to query again. </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2546941"></a>Operating System Resource Limits</h4></div></div></div> +<a name="id2558414"></a>Operating System Resource Limits</h4></div></div></div> <p>The server's usage of many system resources can be limited. Scaled values are allowed when specifying resource limits. For example, <span><strong class="command">1G</strong></span> can be used instead of @@ -2090,7 +2090,7 @@ may use. The default is <code class="literal">default</code>.</p></dd> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2547111"></a>Server Resource Limits</h4></div></div></div> +<a name="id2558584"></a>Server Resource Limits</h4></div></div></div> <p>The following options set limits on the server's resource consumption that are enforced internally by the server rather than the operating system.</p> @@ -2144,7 +2144,7 @@ silently raised. </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2547224"></a>Periodic Task Intervals</h4></div></div></div> +<a name="id2558765"></a>Periodic Task Intervals</h4></div></div></div> <div class="variablelist"><dl> <dt><span class="term"><span><strong class="command">cleaning-interval</strong></span></span></dt> <dd><p>The server will remove expired resource records @@ -2630,7 +2630,7 @@ Form more details, see the description of </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2550624"></a><span><strong class="command">trusted-keys</strong></span> Statement Grammar</h3></div></div></div> +<a name="id2562233"></a><span><strong class="command">trusted-keys</strong></span> Statement Grammar</h3></div></div></div> <pre class="programlisting">trusted-keys { <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>number</code></em> <em class="replaceable"><code>number</code></em> <em class="replaceable"><code>number</code></em> <em class="replaceable"><code>string</code></em> ; [<span class="optional"> <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>number</code></em> <em class="replaceable"><code>number</code></em> <em class="replaceable"><code>number</code></em> <em class="replaceable"><code>string</code></em> ; [<span class="optional">...</span>]</span>] @@ -2639,7 +2639,7 @@ Form more details, see the description of </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2550672"></a><span><strong class="command">trusted-keys</strong></span> Statement Definition +<a name="id2562281"></a><span><strong class="command">trusted-keys</strong></span> Statement Definition and Usage</h3></div></div></div> <p>The <span><strong class="command">trusted-keys</strong></span> statement defines DNSSEC security roots. DNSSEC is described in <a href="Bv9ARM.ch04.html#DNSSEC" title="DNSSEC">the section called “DNSSEC”</a>. A security root is defined when the public key for a non-authoritative @@ -2668,7 +2668,7 @@ key data.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2550808"></a><span><strong class="command">view</strong></span> Statement Definition and Usage</h3></div></div></div> +<a name="id2562349"></a><span><strong class="command">view</strong></span> Statement Definition and Usage</h3></div></div></div> <p>The <span><strong class="command">view</strong></span> statement is a powerful new feature of <span class="acronym">BIND</span> 9 that lets a name server answer a DNS query differently depending on who is asking. It is particularly useful for implementing @@ -2764,7 +2764,7 @@ Statement Grammar</h3></div></div></div> [<span class="optional"> delegation-only <em class="replaceable"><code>yes_or_no</code></em> ; </span>] [<span class="optional"> file <em class="replaceable"><code>string</code></em> ; </span>] [<span class="optional"> forward (<code class="constant">only</code>|<code class="constant">first</code>) ; </span>] - [<span class="optional"> forwarders { <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ; [<span class="optional"> <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ; ... </span>] }; </span>] + [<span class="optional"> forwarders { [<span class="optional"> <em class="replaceable"><code>ip_addr</code></em> [<span class="optional">port <em class="replaceable"><code>ip_port</code></em></span>] ; ... </span>] }; </span>] [<span class="optional"> ixfr-base <em class="replaceable"><code>string</code></em> ; </span>] [<span class="optional"> ixfr-tmp-file <em class="replaceable"><code>string</code></em> ; </span>] [<span class="optional"> maintain-ixfr-base <em class="replaceable"><code>yes_or_no</code></em> ; </span>] @@ -2798,10 +2798,10 @@ Statement Grammar</h3></div></div></div> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2551626"></a><span><strong class="command">zone</strong></span> Statement Definition and Usage</h3></div></div></div> +<a name="id2563022"></a><span><strong class="command">zone</strong></span> Statement Definition and Usage</h3></div></div></div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2551633"></a>Zone Types</h4></div></div></div> +<a name="id2563029"></a>Zone Types</h4></div></div></div> <div class="informaltable"><table border="1"> <colgroup> <col> @@ -2914,7 +2914,7 @@ from forwarders.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2551939"></a>Class</h4></div></div></div> +<a name="id2563267"></a>Class</h4></div></div></div> <p>The zone's name may optionally be followed by a class. If a class is not specified, class <code class="literal">IN</code> (for <code class="varname">Internet</code>), is assumed. This is correct for the vast majority of cases.</p> @@ -2929,7 +2929,7 @@ in the mid-1970s. Zone data for it can be specified with the <code class="litera </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2551970"></a>Zone Options</h4></div></div></div> +<a name="id2563434"></a>Zone Options</h4></div></div></div> <div class="variablelist"><dl> <dt><span class="term"><span><strong class="command">allow-notify</strong></span></span></dt> <dd><p>See the description of @@ -3177,7 +3177,7 @@ name, the rules are checked for each existing record type. </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2553093"></a>Zone File</h2></div></div></div> +<a name="id2564557"></a>Zone File</h2></div></div></div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> <a name="types_of_resource_records_and_when_to_use_them"></a>Types of Resource Records and When to Use Them</h3></div></div></div> @@ -3187,7 +3187,7 @@ Since the publication of RFC 1034, several new RRs have been identified and implemented in the DNS. These are also included.</p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2553179"></a>Resource Records</h4></div></div></div> +<a name="id2564576"></a>Resource Records</h4></div></div></div> <p>A domain name identifies a node. Each node has a set of resource information, which may be empty. The set of resource information associated with a particular name is composed of @@ -3446,7 +3446,7 @@ used as "pointers" to other data in the DNS.</p> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2554032"></a>Textual expression of RRs</h4></div></div></div> +<a name="id2565564"></a>Textual expression of RRs</h4></div></div></div> <p>RRs are represented in binary form in the packets of the DNS protocol, and are usually represented in highly encoded form when stored in a name server or resolver. In the examples provided in @@ -3536,7 +3536,7 @@ each of a different class.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2554457"></a>Discussion of MX Records</h3></div></div></div> +<a name="id2565990"></a>Discussion of MX Records</h3></div></div></div> <p>As described above, domain servers store information as a series of resource records, each of which contains a particular piece of information about a given domain name (which is usually, @@ -3653,7 +3653,7 @@ can be explicitly specified, for example, <code class="literal">1h30m</code>. </ </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2555022"></a>Inverse Mapping in IPv4</h3></div></div></div> +<a name="id2566487"></a>Inverse Mapping in IPv4</h3></div></div></div> <p>Reverse name resolution (that is, translation from IP address to name) is achieved by means of the <span class="emphasis"><em>in-addr.arpa</em></span> domain and PTR records. Entries in the in-addr.arpa domain are made in @@ -3691,7 +3691,7 @@ that the example is relative to the listed origin.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2555128"></a>Other Zone File Directives</h3></div></div></div> +<a name="id2566593"></a>Other Zone File Directives</h3></div></div></div> <p>The Master File Format was initially defined in RFC 1035 and has subsequently been extended. While the Master File Format itself is class independent all records in a Master File must be of the same @@ -3700,7 +3700,7 @@ class.</p> and <span><strong class="command">$TTL.</strong></span></p> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2555147"></a>The <span><strong class="command">$ORIGIN</strong></span> Directive</h4></div></div></div> +<a name="id2566612"></a>The <span><strong class="command">$ORIGIN</strong></span> Directive</h4></div></div></div> <p>Syntax: <span><strong class="command">$ORIGIN </strong></span><em class="replaceable"><code>domain-name</code></em> [<span class="optional"> <em class="replaceable"><code>comment</code></em></span>]</p> <p><span><strong class="command">$ORIGIN</strong></span> sets the domain name that will @@ -3715,7 +3715,7 @@ WWW CNAME MAIN-SERVER</pre> </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2555271"></a>The <span><strong class="command">$INCLUDE</strong></span> Directive</h4></div></div></div> +<a name="id2566667"></a>The <span><strong class="command">$INCLUDE</strong></span> Directive</h4></div></div></div> <p>Syntax: <span><strong class="command">$INCLUDE</strong></span> <em class="replaceable"><code>filename</code></em> [<span class="optional"> <em class="replaceable"><code>origin</code></em> </span>] [<span class="optional"> <em class="replaceable"><code>comment</code></em> </span>]</p> @@ -3739,7 +3739,7 @@ This could be construed as a deviation from RFC 1035, a feature, or both. </div> <div class="sect3" lang="en"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2555334"></a>The <span><strong class="command">$TTL</strong></span> Directive</h4></div></div></div> +<a name="id2566730"></a>The <span><strong class="command">$TTL</strong></span> Directive</h4></div></div></div> <p>Syntax: <span><strong class="command">$TTL</strong></span> <em class="replaceable"><code>default-ttl</code></em> [<span class="optional"> <em class="replaceable"><code>comment</code></em> </span>]</p> @@ -3750,7 +3750,7 @@ with undefined TTLs. Valid TTLs are of the range 0-2147483647 seconds.</p> </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2555365"></a><span class="acronym">BIND</span> Master File Extension: the <span><strong class="command">$GENERATE</strong></span> Directive</h3></div></div></div> +<a name="id2566761"></a><span class="acronym">BIND</span> Master File Extension: the <span><strong class="command">$GENERATE</strong></span> Directive</h3></div></div></div> <p>Syntax: <span><strong class="command">$GENERATE</strong></span> <em class="replaceable"><code>range</code></em> <em class="replaceable"><code>lhs</code></em> [<span class="optional"><em class="replaceable"><code>ttl</code></em></span>] [<span class="optional"><em class="replaceable"><code>class</code></em></span>] <em class="replaceable"><code>type</code></em> <em class="replaceable"><code>rhs</code></em> [<span class="optional"> <em class="replaceable"><code>comment</code></em> </span>]</p> <p><span><strong class="command">$GENERATE</strong></span> is used to create a series of resource records that only differ from each other by an iterator. <span><strong class="command">$GENERATE</strong></span> can diff --git a/doc/arm/Bv9ARM.ch07.html b/doc/arm/Bv9ARM.ch07.html index f62c521b..86c2b6af 100644 --- a/doc/arm/Bv9ARM.ch07.html +++ b/doc/arm/Bv9ARM.ch07.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch07.html,v 1.50.2.9.2.22 2005/07/19 06:15:28 marka Exp $ --> +<!-- $Id: Bv9ARM.ch07.html,v 1.50.2.9.2.24 2005/10/13 02:34:02 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 7. BIND 9 Security Considerations</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch06.html" title="Chapter 6. BIND 9 Configuration Reference"> @@ -46,11 +46,11 @@ <p><b>Table of Contents</b></p> <dl> <dt><span class="sect1"><a href="Bv9ARM.ch07.html#Access_Control_Lists">Access Control Lists</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch07.html#id2555757"><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for +<dt><span class="sect1"><a href="Bv9ARM.ch07.html#id2567222"><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for UNIX servers)</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2555833">The <span><strong class="command">chroot</strong></span> Environment</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2555891">Using the <span><strong class="command">setuid</strong></span> Function</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2567366">The <span><strong class="command">chroot</strong></span> Environment</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2567424">Using the <span><strong class="command">setuid</strong></span> Function</a></span></dt> </dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch07.html#dynamic_update_security">Dynamic Update Security</a></span></dt> </dl> @@ -100,7 +100,7 @@ see the <span class="emphasis"><em>AUSCERT</em></span> advisory at </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2555757"></a><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for +<a name="id2567222"></a><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for UNIX servers)</h2></div></div></div> <p>On UNIX servers, it is possible to run <span class="acronym">BIND</span> in a <span class="emphasis"><em>chrooted</em></span> environment (<span><strong class="command">chroot()</strong></span>) by specifying the "<code class="option">-t</code>" @@ -115,7 +115,7 @@ user 202:</p> <p><strong class="userinput"><code>/usr/local/bin/named -u 202 -t /var/named</code></strong></p> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2555833"></a>The <span><strong class="command">chroot</strong></span> Environment</h3></div></div></div> +<a name="id2567366"></a>The <span><strong class="command">chroot</strong></span> Environment</h3></div></div></div> <p>In order for a <span><strong class="command">chroot()</strong></span> environment to work properly in a particular directory (for example, <code class="filename">/var/named</code>), @@ -140,7 +140,7 @@ to set up things like </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2555891"></a>Using the <span><strong class="command">setuid</strong></span> Function</h3></div></div></div> +<a name="id2567424"></a>Using the <span><strong class="command">setuid</strong></span> Function</h3></div></div></div> <p>Prior to running the <span><strong class="command">named</strong></span> daemon, use the <span><strong class="command">touch</strong></span> utility (to change file access and modification times) or the <span><strong class="command">chown</strong></span> utility (to diff --git a/doc/arm/Bv9ARM.ch08.html b/doc/arm/Bv9ARM.ch08.html index 8ae424ca..9d486e1b 100644 --- a/doc/arm/Bv9ARM.ch08.html +++ b/doc/arm/Bv9ARM.ch08.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch08.html,v 1.50.2.9.2.22 2005/07/19 06:15:28 marka Exp $ --> +<!-- $Id: Bv9ARM.ch08.html,v 1.50.2.9.2.24 2005/10/13 02:34:02 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Chapter 8. Troubleshooting</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch07.html" title="Chapter 7. BIND 9 Security Considerations"> @@ -45,18 +45,18 @@ <div class="toc"> <p><b>Table of Contents</b></p> <dl> -<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2555961">Common Problems</a></span></dt> -<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch08.html#id2555966">It's not working; how can I figure out what's wrong?</a></span></dt></dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2555978">Incrementing and Changing the Serial Number</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2555995">Where Can I Get Help?</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2567630">Common Problems</a></span></dt> +<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch08.html#id2567636">It's not working; how can I figure out what's wrong?</a></span></dt></dl></dd> +<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2567648">Incrementing and Changing the Serial Number</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2567665">Where Can I Get Help?</a></span></dt> </dl> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2555961"></a>Common Problems</h2></div></div></div> +<a name="id2567630"></a>Common Problems</h2></div></div></div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2555966"></a>It's not working; how can I figure out what's wrong?</h3></div></div></div> +<a name="id2567636"></a>It's not working; how can I figure out what's wrong?</h3></div></div></div> <p>The best solution to solving installation and configuration issues is to take preventative measures by setting up logging files beforehand. The log files provide a @@ -66,7 +66,7 @@ </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2555978"></a>Incrementing and Changing the Serial Number</h2></div></div></div> +<a name="id2567648"></a>Incrementing and Changing the Serial Number</h2></div></div></div> <p>Zone serial numbers are just numbers-they aren't date related. A lot of people set them to a number that represents a date, usually of the form YYYYMMDDRR. A number of people have been @@ -87,7 +87,7 @@ </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2555995"></a>Where Can I Get Help?</h2></div></div></div> +<a name="id2567665"></a>Where Can I Get Help?</h2></div></div></div> <p>The Internet Software Consortium (<span class="acronym">ISC</span>) offers a wide range of support and service agreements for <span class="acronym">BIND</span> and <span class="acronym">DHCP</span> servers. Four levels of premium support are available and each level includes diff --git a/doc/arm/Bv9ARM.ch09.html b/doc/arm/Bv9ARM.ch09.html index b9b2ebbe..8c7b2bf4 100644 --- a/doc/arm/Bv9ARM.ch09.html +++ b/doc/arm/Bv9ARM.ch09.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.ch09.html,v 1.50.2.9.2.23 2005/07/19 06:15:28 marka Exp $ --> +<!-- $Id: Bv9ARM.ch09.html,v 1.50.2.9.2.25 2005/10/13 02:34:03 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Appendix A. Appendices</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="up" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="prev" href="Bv9ARM.ch08.html" title="Chapter 8. Troubleshooting"> @@ -43,24 +43,24 @@ <div class="toc"> <p><b>Table of Contents</b></p> <dl> -<dt><span class="sect1"><a href="Bv9ARM.ch09.html#id2556125">Acknowledgments</a></span></dt> -<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2556131">A Brief History of the <span class="acronym">DNS</span> and <span class="acronym">BIND</span></a></span></dt></dl></dd> +<dt><span class="sect1"><a href="Bv9ARM.ch09.html#id2567795">Acknowledgments</a></span></dt> +<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2567800">A Brief History of the <span class="acronym">DNS</span> and <span class="acronym">BIND</span></a></span></dt></dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch09.html#historical_dns_information">General <span class="acronym">DNS</span> Reference Information</a></span></dt> <dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch09.html#ipv6addresses">IPv6 addresses (AAAA)</a></span></dt></dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch09.html#bibliography">Bibliography (and Suggested Reading)</a></span></dt> <dd><dl> <dt><span class="sect2"><a href="Bv9ARM.ch09.html#rfcs">Request for Comments (RFCs)</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch09.html#internet_drafts">Internet Drafts</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2558554">Other Documents About <span class="acronym">BIND</span></a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2570087">Other Documents About <span class="acronym">BIND</span></a></span></dt> </dl></dd> </dl> </div> <div class="sect1" lang="en"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="id2556125"></a>Acknowledgments</h2></div></div></div> +<a name="id2567795"></a>Acknowledgments</h2></div></div></div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2556131"></a>A Brief History of the <span class="acronym">DNS</span> and <span class="acronym">BIND</span></h3></div></div></div> +<a name="id2567800"></a>A Brief History of the <span class="acronym">DNS</span> and <span class="acronym">BIND</span></h3></div></div></div> <p>Although the "official" beginning of the Domain Name System occurred in 1984 with the publication of RFC 920, the core of the new system was described in 1983 in RFCs 882 and @@ -258,7 +258,7 @@ the number of the RFC). RFCs are also available via the Web at </p> <div class="bibliography"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2557111"></a>Bibliography</h4></div></div></div> +<a name="id2568712"></a>Bibliography</h4></div></div></div> <div class="bibliodiv"> <h3 class="title">Standards</h3> <div class="biblioentry"><p>[<span class="abbrev">RFC974</span>] <span class="author"><span class="firstname">C.</span> <span class="surname">Partridge</span>. </span><span class="title"><i>Mail Routing and the Domain System</i>. </span><span class="pubdate">January 1986. </span></p></div> @@ -358,11 +358,11 @@ after which they are deleted unless updated by their authors. </div> <div class="sect2" lang="en"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2558554"></a>Other Documents About <span class="acronym">BIND</span></h3></div></div></div> +<a name="id2570087"></a>Other Documents About <span class="acronym">BIND</span></h3></div></div></div> <p></p> <div class="bibliography"> <div class="titlepage"><div><div><h4 class="title"> -<a name="id2558564"></a>Bibliography</h4></div></div></div> +<a name="id2570097"></a>Bibliography</h4></div></div></div> <div class="biblioentry"><p><span class="authorgroup"><span class="firstname">Paul</span> <span class="surname">Albitz</span> and <span class="firstname">Cricket</span> <span class="surname">Liu</span>. </span><span class="title"><i><span class="acronym">DNS</span> and <span class="acronym">BIND</span></i>. </span><span class="copyright">Copyright © 1998 Sebastopol, CA: O'Reilly and Associates. </span></p></div> </div> </div> diff --git a/doc/arm/Bv9ARM.html b/doc/arm/Bv9ARM.html index e637f290..71ec3299 100644 --- a/doc/arm/Bv9ARM.html +++ b/doc/arm/Bv9ARM.html @@ -14,12 +14,12 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: Bv9ARM.html,v 1.60.2.9.2.23 2005/07/19 06:15:29 marka Exp $ --> +<!-- $Id: Bv9ARM.html,v 1.60.2.9.2.26 2005/10/13 02:33:59 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>BIND 9 Administrator Reference Manual</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> <link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual"> <link rel="next" href="Bv9ARM.ch01.html" title="Chapter 1. Introduction "> </head> @@ -40,7 +40,7 @@ <div class="titlepage"> <div> <div><h1 class="title"> -<a name="id2457013"></a>BIND 9 Administrator Reference Manual</h1></div> +<a name="id2463864"></a>BIND 9 Administrator Reference Manual</h1></div> <div><p class="copyright">Copyright © 2004, 2005 Internet Systems Consortium, Inc. ("ISC")</p></div> <div><p class="copyright">Copyright © 2000-2003 Internet Software Consortium.</p></div> </div> @@ -51,39 +51,39 @@ <dl> <dt><span class="chapter"><a href="Bv9ARM.ch01.html">1. Introduction </a></span></dt> <dd><dl> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2533851">Scope of Document</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2534082">Organization of This Document</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2534290">Conventions Used in This Document</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2534889">The Domain Name System (<span class="acronym">DNS</span>)</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2545879">Scope of Document</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2545905">Organization of This Document</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2545976">Conventions Used in This Document</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch01.html#id2546234">The Domain Name System (<span class="acronym">DNS</span>)</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2534909">DNS Fundamentals</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2534945">Domains and Domain Names</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535029">Zones</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535172">Authoritative Name Servers</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535264">Caching Name Servers</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2535321">Name Servers in Multiple Roles</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546254">DNS Fundamentals</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2544105">Domains and Domain Names</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546579">Zones</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546653">Authoritative Name Servers</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2546950">Caching Name Servers</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch01.html#id2547076">Name Servers in Multiple Roles</a></span></dt> </dl></dd> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch02.html">2. <span class="acronym">BIND</span> Resource Requirements</a></span></dt> <dd><dl> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535353">Hardware requirements</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535446">CPU Requirements</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535457">Memory Requirements</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535472">Name Server Intensive Environment Issues</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2535480">Supported Operating Systems</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547108">Hardware requirements</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547132">CPU Requirements</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547143">Memory Requirements</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547158">Name Server Intensive Environment Issues</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch02.html#id2547303">Supported Operating Systems</a></span></dt> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch03.html">3. Name Server Configuration</a></span></dt> <dd><dl> <dt><span class="sect1"><a href="Bv9ARM.ch03.html#sample_configuration">Sample Configurations</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2535579">A Caching-only Name Server</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2535595">An Authoritative-only Name Server</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2547334">A Caching-only Name Server</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2547350">An Authoritative-only Name Server</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2535618">Load Balancing</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2535970">Name Server Operations</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2547372">Load Balancing</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch03.html#id2547656">Name Server Operations</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2535975">Tools for Use With the Name Server Daemon</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2537297">Signals</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2547661">Tools for Use With the Name Server Daemon</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch03.html#id2548915">Signals</a></span></dt> </dl></dd> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch04.html">4. Advanced DNS Features</a></span></dt> @@ -92,33 +92,33 @@ <dt><span class="sect1"><a href="Bv9ARM.ch04.html#dynamic_update">Dynamic Update</a></span></dt> <dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch04.html#journal">The journal file</a></span></dt></dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch04.html#incremental_zone_transfers">Incremental Zone Transfers (IXFR)</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2537721">Split DNS</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2549203">Split DNS</a></span></dt> <dt><span class="sect1"><a href="Bv9ARM.ch04.html#tsig">TSIG</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538214">Generate Shared Keys for Each Pair of Hosts</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538280">Copying the Shared Secret to Both Machines</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538289">Informing the Servers of the Key's Existence</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538396">Instructing the Server to Use the Key</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538449">TSIG Key Based Access Control</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538492">Errors</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549627">Generate Shared Keys for Each Pair of Hosts</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549830">Copying the Shared Secret to Both Machines</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549838">Informing the Servers of the Key's Existence</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549878">Instructing the Server to Use the Key</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2549998">TSIG Key Based Access Control</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550042">Errors</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2538506">TKEY</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2538555">SIG(0)</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2550056">TKEY</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2550173">SIG(0)</a></span></dt> <dt><span class="sect1"><a href="Bv9ARM.ch04.html#DNSSEC">DNSSEC</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538621">Generating Keys</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538757">Signing the Zone</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538832">Configuring Servers</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550308">Generating Keys</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550375">Signing the Zone</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550450">Configuring Servers</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2538855">IPv6 Support in <span class="acronym">BIND</span> 9</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch04.html#id2550473">IPv6 Support in <span class="acronym">BIND</span> 9</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2538982">Address Lookups Using AAAA Records</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2539002">Address to Name Lookups Using Nibble Format</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550600">Address Lookups Using AAAA Records</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch04.html#id2550620">Address to Name Lookups Using Nibble Format</a></span></dt> </dl></dd> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch05.html">5. The <span class="acronym">BIND</span> 9 Lightweight Resolver</a></span></dt> <dd><dl> -<dt><span class="sect1"><a href="Bv9ARM.ch05.html#id2539034">The Lightweight Resolver Library</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch05.html#id2550652">The Lightweight Resolver Library</a></span></dt> <dt><span class="sect1"><a href="Bv9ARM.ch05.html#lwresd">Running a Resolver Daemon</a></span></dt> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch06.html">6. <span class="acronym">BIND</span> 9 Configuration Reference</a></span></dt> @@ -126,77 +126,77 @@ <dt><span class="sect1"><a href="Bv9ARM.ch06.html#configuration_file_elements">Configuration File Elements</a></span></dt> <dd><dl> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#address_match_lists">Address Match Lists</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2540336">Comment Syntax</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2551817">Comment Syntax</a></span></dt> </dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch06.html#Configuration_File_Grammar">Configuration File Grammar</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2540753"><span><strong class="command">acl</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552302"><span><strong class="command">acl</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#acl"><span><strong class="command">acl</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2540989"><span><strong class="command">controls</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552471"><span><strong class="command">controls</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#controls_statement_definition_and_usage"><span><strong class="command">controls</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541326"><span><strong class="command">include</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541341"><span><strong class="command">include</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541364"><span><strong class="command">key</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541385"><span><strong class="command">key</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541457"><span><strong class="command">logging</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2541719"><span><strong class="command">logging</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2542924"><span><strong class="command">lwres</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2542997"><span><strong class="command">lwres</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2543060"><span><strong class="command">masters</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2543104"><span><strong class="command">masters</strong></span> Statement Definition and Usage </a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2543118"><span><strong class="command">options</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552808"><span><strong class="command">include</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552823"><span><strong class="command">include</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552845"><span><strong class="command">key</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2552867"><span><strong class="command">key</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2553006"><span><strong class="command">logging</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2553269"><span><strong class="command">logging</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554474"><span><strong class="command">lwres</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554547"><span><strong class="command">lwres</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554610"><span><strong class="command">masters</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554653"><span><strong class="command">masters</strong></span> Statement Definition and Usage </a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554668"><span><strong class="command">options</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#options"><span><strong class="command">options</strong></span> Statement Definition and Usage</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#server_statement_grammar"><span><strong class="command">server</strong></span> Statement Grammar</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#server_statement_definition_and_usage"><span><strong class="command">server</strong></span> Statement Definition and Usage</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2550624"><span><strong class="command">trusted-keys</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2550672"><span><strong class="command">trusted-keys</strong></span> Statement Definition +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2562233"><span><strong class="command">trusted-keys</strong></span> Statement Grammar</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2562281"><span><strong class="command">trusted-keys</strong></span> Statement Definition and Usage</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#view_statement_grammar"><span><strong class="command">view</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2550808"><span><strong class="command">view</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2562349"><span><strong class="command">view</strong></span> Statement Definition and Usage</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#zone_statement_grammar"><span><strong class="command">zone</strong></span> Statement Grammar</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2551626"><span><strong class="command">zone</strong></span> Statement Definition and Usage</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2563022"><span><strong class="command">zone</strong></span> Statement Definition and Usage</a></span></dt> </dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch06.html#id2553093">Zone File</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch06.html#id2564557">Zone File</a></span></dt> <dd><dl> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#types_of_resource_records_and_when_to_use_them">Types of Resource Records and When to Use Them</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2554457">Discussion of MX Records</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2565990">Discussion of MX Records</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch06.html#Setting_TTLs">Setting TTLs</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2555022">Inverse Mapping in IPv4</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2555128">Other Zone File Directives</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2555365"><span class="acronym">BIND</span> Master File Extension: the <span><strong class="command">$GENERATE</strong></span> Directive</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2566487">Inverse Mapping in IPv4</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2566593">Other Zone File Directives</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch06.html#id2566761"><span class="acronym">BIND</span> Master File Extension: the <span><strong class="command">$GENERATE</strong></span> Directive</a></span></dt> </dl></dd> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch07.html">7. <span class="acronym">BIND</span> 9 Security Considerations</a></span></dt> <dd><dl> <dt><span class="sect1"><a href="Bv9ARM.ch07.html#Access_Control_Lists">Access Control Lists</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch07.html#id2555757"><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for +<dt><span class="sect1"><a href="Bv9ARM.ch07.html#id2567222"><span><strong class="command">chroot</strong></span> and <span><strong class="command">setuid</strong></span> (for UNIX servers)</a></span></dt> <dd><dl> -<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2555833">The <span><strong class="command">chroot</strong></span> Environment</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2555891">Using the <span><strong class="command">setuid</strong></span> Function</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2567366">The <span><strong class="command">chroot</strong></span> Environment</a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch07.html#id2567424">Using the <span><strong class="command">setuid</strong></span> Function</a></span></dt> </dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch07.html#dynamic_update_security">Dynamic Update Security</a></span></dt> </dl></dd> <dt><span class="chapter"><a href="Bv9ARM.ch08.html">8. Troubleshooting</a></span></dt> <dd><dl> -<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2555961">Common Problems</a></span></dt> -<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch08.html#id2555966">It's not working; how can I figure out what's wrong?</a></span></dt></dl></dd> -<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2555978">Incrementing and Changing the Serial Number</a></span></dt> -<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2555995">Where Can I Get Help?</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2567630">Common Problems</a></span></dt> +<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch08.html#id2567636">It's not working; how can I figure out what's wrong?</a></span></dt></dl></dd> +<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2567648">Incrementing and Changing the Serial Number</a></span></dt> +<dt><span class="sect1"><a href="Bv9ARM.ch08.html#id2567665">Where Can I Get Help?</a></span></dt> </dl></dd> <dt><span class="appendix"><a href="Bv9ARM.ch09.html">A. Appendices</a></span></dt> <dd><dl> -<dt><span class="sect1"><a href="Bv9ARM.ch09.html#id2556125">Acknowledgments</a></span></dt> -<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2556131">A Brief History of the <span class="acronym">DNS</span> and <span class="acronym">BIND</span></a></span></dt></dl></dd> +<dt><span class="sect1"><a href="Bv9ARM.ch09.html#id2567795">Acknowledgments</a></span></dt> +<dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2567800">A Brief History of the <span class="acronym">DNS</span> and <span class="acronym">BIND</span></a></span></dt></dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch09.html#historical_dns_information">General <span class="acronym">DNS</span> Reference Information</a></span></dt> <dd><dl><dt><span class="sect2"><a href="Bv9ARM.ch09.html#ipv6addresses">IPv6 addresses (AAAA)</a></span></dt></dl></dd> <dt><span class="sect1"><a href="Bv9ARM.ch09.html#bibliography">Bibliography (and Suggested Reading)</a></span></dt> <dd><dl> <dt><span class="sect2"><a href="Bv9ARM.ch09.html#rfcs">Request for Comments (RFCs)</a></span></dt> <dt><span class="sect2"><a href="Bv9ARM.ch09.html#internet_drafts">Internet Drafts</a></span></dt> -<dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2558554">Other Documents About <span class="acronym">BIND</span></a></span></dt> +<dt><span class="sect2"><a href="Bv9ARM.ch09.html#id2570087">Other Documents About <span class="acronym">BIND</span></a></span></dt> </dl></dd> </dl></dd> </dl> diff --git a/doc/arm/Bv9ARM.pdf b/doc/arm/Bv9ARM.pdf index 90132d55..1bff6cb0 100755 --- a/doc/arm/Bv9ARM.pdf +++ b/doc/arm/Bv9ARM.pdf @@ -879,13 +879,13 @@ endobj << /S /GoTo /D [590 0 R /FitH ] >> endobj 592 0 obj << -/Length 223 +/Length 222 /Filter /FlateDecode >> stream -xÚ1OÃ@…÷ü -Ô˜óÙNÎ#܆B{E•H¨Òðÿ¹4¥B‚y°|þôÞù¸\Aѱ Ô&¨ŽÖmáà-ïn -:1¢Œ*Ìyøc[²1á +xÚMK1†ïû+æØ‚3_ÝäØâ +*Hnâaݦ¥`·°®ÿßl·A2‡ÌdÞ7y |)‚`è%*ÔQÑ<´ûÊöìn+:1j‚¦"eøcë$ +• endobj 590 0 obj << /Type /Page @@ -2720,17 +2720,16 @@ endobj /ProcSet [ /PDF /Text ] >> endobj 910 0 obj << -/Length 1241 +/Length 1238 /Filter /FlateDecode >> stream -xÚ¥Xßs›8~÷_Ácò Uü†»§4uzé\Ó;×}j;d[@‰Än¯ÿûI–ÀàO&“‘»Ÿv¿Õ.+Û’¶å0ˆØ -cúÈö$Ÿ k-ß½ŸØF4B +õv>ys8VãÀ ¬ùªƒAE¶5O¿^З]\º»¹}ÿevuzóÛOw—ÀñÑÅÍíßS={?»úøñjv ìÈ·/®ÿºúg>éWÁx{{÷N¯Äzxt6½™Î¦w×ÓËïó“é¼õ¥ë¯\åÈÉ×ïÈJ¥Û&ºqä[òA;Ž+Ÿx¾}Ïu›•lòyòoØy»WäÏFÐq%WO ô˶aìûNA?†ë¸-ƒ¶+YA]ä˜RqíågÉI!Îs\)—ßÜøa'2Èn(ÍDñ± $bs¢g%«„žÑrqxø¥‡oÈGzfÔåFä¿V
§iuížìŽ&ØÖ³?õ -*(+ô -.R=ùÂñš´{õØs|èG’Ò.{ZÐíJŽ]/¤‚’Sôp–±G=]±Ê¬é!ayÞX‰1’ôØsD0=.‰ æ4Ûéy͉qbiVò:´ÌŒ,õòÈ[žáóö'+‡C,ƒÆ%àÐÃè@¶oÈf¥¢rĉìQÕrìçjšQlŒqkƒÑ#F½}(ÛŽ ç{¾ @cÙ@ !;4r¼o4-Žöè¥RèBz±QUɓ„«]:AÐX£Ž]Fþ€NŒ ‡’eé€Ú^Ï|“„RÏrbE¡,Ämˆ¤Üƒ<!ûìäÌ‹Šë}æ(®µ¼®ÈÆÅ!雧a
½'•Ä4Õ*úqAÓS:)H"Xe’¼Äb³Pûš$k©àxÛ©ÆH‹=>Ë15,éù³æhùM·T-Œ©'ŸñºÎK°¢cVNruôd™ ¡¥+i:z‡³àµŠªà §Uv„/Xµ(Ø E¸Pl»?§`X"ª &2ë -Þ齪Uâ¸(bW{Œ‚üÊ:JƲ1ÑT'^È@·« -,1u|Ò‚s’ -¼í)^tT£^áX]¦ê3iD6[¯¶í! +xÚ¥Xßs›8~÷_Ácò Uü†»§4uré\Ó;×}j;„ ŠDbß]ÿ÷“,aƒC<™LFBì~ÚýV»¬l[HþÙ–À vb+Œ=è#Û·’b‚¬•|w;±h…@Wêý|òî&p¬ÆXó¬ƒAE¶5O¿]З]\¾¿¹»ý:»º½‹ùÝçûKàøèâæîÏ©žÝή>}ºš];òí‹ë?®þšOgúU`0ÞßÝÐ+±^ +]ˆB/6ª*yR˜°2Ø%p 5êØåä·HàÄúq(Y–¸¡íõÌ7I(õ,'†QÊB¼‘”{”'dw˜•œyXpQÓrµËŵ–×y͸8$}û4¬¡wख¸€¦ZE?.hzJ'¥5I«M’WX¬jŸA“d- +R¨£'ËMø-m\EÓÑ;œ¯UT- +(ðÆ|í›bIêAË +ZÒç &¼’u‡ŒÚ¨ýÌ€D¨Q*%4;J¯ ›*§ ƒfÊ*Ñt +Þé½ê,q\±ˆ=FA~Hecù˜hª/ä? ›¬KÌGŸ´äœ$€”x™Ÿ£3ö ?ú)éV1=u##ŽËdÍêîÛA«
\¡T–2Û£˜¯ä endobj 909 0 obj << /Type /Page @@ -2831,25 +2830,20 @@ endobj /ProcSet [ /PDF /Text ] >> endobj 926 0 obj << -/Length 3372 +/Length 3376 /Filter /FlateDecode >> stream -xÚ¥ZÝsÛ6÷_¡é“<1?ÁÉ“;½ô»g+÷1m(’8¡H•¤ì¸7÷¿ß.v‘¥\ç’–ÀbñÛOHÌ\ø/f2t\? fq8¡+ÂY¶»rgûáJ0ÍÂ-úTß/¯Þ~ˆ¼Yâ$‘Í–ëÞ\Òq¥³eþËüý_n~^Þ=^/¼ÐGÎõ"ŒÜù÷ïo©'¡Çû‡ûøüxsóåLJ{ê~¼ûp÷xwÿþîz!d(à{g8óÁ‡?ÝQë‡Ç›OŸn¯[þxu·´{éïW¸>nä÷«_~sg9lûÇ+×ñÎ^àÅuD’x³ÝUúNø¾é)¯ž®þf'ìêO§äúÒ ¥O0ð{.´ƒh‡‰ùž¯¸®›]ÚѦê5=»¢Æ¯®ë•Ü.ZzæªÍšb¥rî®Æ2ðBá$®HŽë -97}»´¨ÊWî«:à0Ì[†Ù1’tªí`ïà-óô”àÐêb7’<q¬!òœÝ6Ÿz_®ÙY°—¢, ½UÍz¸b•KWFùºšžY½Ûª"K;x)ºíHi7e½JyJ½sb£¿Q -í-žŽ®®Å\Rõu›ÚNåhÑbÚR“iˆYìZÂùì Íì¢gî9-¼lX~û!Œ{Šã±`@áê
¼…óyKzKÄ-‹¤€WtùxõébEE€¢ƒõAft®^i@‹œ€Ñ½¡QlT -åà&Æ'Œ¬ç¡¯óg'vg´ØuÂ0`bë!`µ.ý‚€Å¦Òîh
A½ç&cÇ„Šåø2Š†Û.ª¢+ŒáÍê -Ois dQgY§5™ˆëèO Ý¥Mwس5/vÆ Tù0 -V×I@ù‡&QdÀÕöc^´§ô€óo^ûçßîÁ°i=.yFŠâm uD–
@L¸Áº -©ŸUf1ÉK°Ôtªº÷÷w(¦óh<ÇÃC»Œ¶Õ´*úuÝâ—j£ÕmQc¤7Æ\iR!ÂE.,ÕÌIÈÂDùX^cðÐh»’bè=™Ú‘vâàšÇ\ëÁ‚¿\þtÛRIöNuͳhOMM$5ëï5V±ïDÂÔêkVr>CÔÇú70úq”hªûÚÄ›mm쳆h°h‡—û‡¥A˜Ù—±Råë*ÊÙ0$õ¼àöÿ¾áahþtxó¿:??áß‘UÄ®OŸŸî>–EßÈݹǔîhüý"™S¶ƒÒyr(IXé¬Ühýø.Wß½ãfùl›‡Ö6wWvæõ?ïè`FK‹48¥Dèt…ë~Ãd÷©Î+‘¥ÒÉUÑbƱHËMÝ -¹ŽtãË,¢ -‡NV{ÈÃ-ñ€IG^äL8Œpج{ìê1í[ñ©!+ð/ßš¢cm$C1ÿ†ÑØâ<KàùCXìË©hA"8¾˜æHR:úü -FE–VSu¦š`œSû@rjݳßà:²ó¶g`뀤-vE™6å+O_Tã%åóýÓy9åµjuº0fk¯
ú"âMѨ̮ †ãÆ|ñsÖ‚{ÒsB°‘—-xŸê¼·T=¥Ú!WjíCsjÆ%„4_fÃRMð10ã‰ç$Þˆ'4k}& wªhÒl[Ð{¶nCÈ(µÞÒØ.åt¶ƒ
³7×{a—‹ýSó¾øQ9…›‹ ’ˆK -;eópœÄ£ òUM…žëÄž)Çtä¢ÀÜ¢¶" - -‘Ðz'h3€ßNs¨rŤNÈo©´c§²ñÂ.4⥺Ú8®ŽŒÂ?„nl°Dü¢¿¬+ž•3±Äî‚ò -Æ¥*)Ål9Ø;„÷2Œ.)f„HÞikw‹˜gJl›VEK¯$p„[ -¾-ä_Cèçñ(’HÝ55Uu¼×Ͷ*ûÂ×È®¹‡†³U»šª¸àñUú¥úQº h!ªT +xÚ¥ZÝsÛ6÷_¡é“<1¿ +'vE|\¸¡ÁÃfFÇûý¢ÿÁ)û§ó"ÿO:mòª´ +×là-œÏ[Ò["hY¤œ +¨õ×´h3>CÔ§óo`ôeªûÊÆ›ueí³†hèÐ/÷K‹0»/k¥Š×#T´³aHþêyÁíþ}ÃÃÐüé:öæu~~¿#«ˆ]Ÿ>?Ý}þ„}#wçSº£ñö#ˆdþMÙ†¥óÔP:“°2ur£Ìã»L÷Ž›Ås×l뮹ƒ¸²ÝÙ×ÿ¼£ƒ-M,Òà”¡Ó®û
“ݧ:¯D•I®ò3ŽERlª€iWŸªë(W^fÁM°0P :¬ö‡[â“.Ž½È™pá°ÙöØ5cÆ·âÓ@Và_¾5#DÇÆH†bþ £µÅx–Àó‡°ØSÑ‚Xp|1-Ì‘”r 1ôù +ÏlH˜¡¤hô¡¤ä^wºÙV—Ls04ÑùJ£P›ÙITÎ#[¬!7”q)'áêW| Q퉜’BSØÀzSqYz½±þ*ùhb*EV{_A žä<Q_'’«Õ+y5càƒgÑ{]O]9®Ñÿ~tàì]NŽ>x3rµÝŠ%Iö×fVjór"ásR…^7ÔÅsó/š÷Ñb.‰å£†r¸ <fÀçzj”PYúER¦[’©d&é²h÷{M龤tùx´-oJ}ÉÎÒ[â„HnÉëRß0ç–DÙjm÷ý¥#Ð.&ÊL9£"MÊ©ºSO0Ω} 8µ‡î³ßà:êæÏÀVš€¤Îwy‘ŠWž¾©ÆKÂ#öû§órÊ*]›taͽ¶˜‹ˆG4E£2;¸‚lŽ[ó}ÄÏYî)Ï ÁF^¶à}ªó¼£ê)Õá¸Òh·‡S3® ¤ <y™Žj‚='öF|<¡ÑX£JÉh¾Õù¼eºÍÙ•¡-á8rK·Ü‘ð—\X I¶Q›¶ß…w•ÆðŒ|`a•Q̹ +“YÒnwÊííÕ‹*g§;€"Tá1ce5ÁºÈà”wk:¡Ý™N%ú¦“k*¸~4Ô +TPsã€B *ÉÅ>ßC@w^öÏÌZ Ñdè\ÙA#*IÉ@ðÍH<Š‘°sQÐ& +`<G=P¹x|oPJýýt…5k,LXðw"ãïãçï¤ý¾õ#Š#Ñ…ßP0V’R1 +`ˆ?¡;¨¿©÷ì©'üãMvò%§) ø‘öb?M€G½ÑÑòà½kEÀ‚æt»†w©xM¼¦§JɸÕö¨2ºÌ‚ŽŠ™ÍôáaæGN¤ðG[}ãÅg³ðÃp^äåtÊë®q¡s?Ó0qT™$Ýn¶
Øï1íÇçà'"ô
8ŠM^&
Å‚@Ó»5Æ/èÖZƒ»z8{™
C&UÇɲœ¯üøŽ£9÷›.?tð‡XÀr;ÇòÿÞëøc¸@buç̯| KKË +?c놲þ_¬–ÙÒendstream endobj 925 0 obj << /Type /Page @@ -3768,13 +3762,15 @@ endobj /ProcSet [ /PDF /Text ] >> endobj 1052 0 obj << -/Length 1251 +/Length 1252 /Filter /FlateDecode >> stream -xÚÍXIoÛ8¾ûW=Ùˆ)QzJ3N&Å$í¸žS§0dIvˆjqEʉ翗©5R¢&9|0I‘ï½ï{¨hülÓAŽb9ÀÄŠM4eË¿]L œ£–“Ôæ¬ËÉɹ‰8&2•å¦!ËšmCeéš -ä -œœH©Ölrå†ÅsÙÒ«2‡t^º´’Ø¢}a."îYáR7ŠÜTÈk¥~îr ŽõQyk»QPF“Ki‹/(-<5_ÿiXk2'ÚG½¡[²¹!1kOaÙº5°IÒ[7õ[c~[—ñ8Vëáš¡h r1p,ËlSËó?¹Uy¾“Í¡š¾Ï#›®Šä]…„J«š;þÂ~dAúV²XêÆtS’ö"qMœÙÎçÑðjÛ„u—ðl#_VâË*ÍÊ| +xÚXKoÛ8¾ûW9Ùˆ)Qô”flŠMÚu½§naÈ’œÕÃ)'nœÿ¾”H=-%jø`’ÎÌ÷qfø€ŠÆPÁ&0ä(–c +}ÔÏ—¨c½CTÞZÅn”ÑäRÚâKJOÍ×֚̉öAFoè–,GîHÌÚ",[·6Izï¦~kÌÂàÖe<ŽÕ:F¸e(Z‚\Ë2ÛÔòüOîUžïd³o§¦ïóȦ«"yW!¡Ò«§¦ÆÎúe?³ }/],ucº)I{•º&Îlëóhx³oBºMx +¶‘Š/+ñe•fe> +ymÕQ@¹×“bËR;ÆÆð,ê#}êcQ¥T8ŒîÁ¾Óh®ÒøÌÜ8LnUJ~IÐqËÚ5ÀÖCUâTâGƧ¢©IÆ^3—‘h”Y80u¼Ùf êÄá< myá$ì%üàS-VÓâPûňÐÐ$K½Æ¦M¶F#‚Å\hZ@·ÁU +×÷®Áo0ùcDÏ+„VÝ^ÞüæQ?ñ+nÛ¨zÎ0ôÆY60l®D:•ãÃö‘çåãȱëÿQví}endstream endobj 1051 0 obj << /Type /Page @@ -5275,7 +5271,7 @@ endobj stream xÚíte\Ôí¶6Ò ˆtÃÐÝÝÝÝ¡Ä000Ì ÝÝÝÝ’‚R"‚´t ÒÈ‹>ïÞûüž³?³?½¿w¾Ìÿ^×Z׺î7¶‡Œ5Ü ¬‡¹rðpr‹t´P(ÐWç…CfL9g0ЇÉ]Á¢ -Äü{fXE +Äü{fXE 0Üú÷äè¹aÖÃöOÃoäæìüØã?ûÿxýœÿŒ=ì a.ÌÁAb¡ö™9Y®
Ä£ò/z{xÂœ*Þè—ÖÁ»2#×Dj,ïêÃ8›ÇEµyÍî;Ýoª²n
öA™ºÓÁß‹(üèX>ã.3v±ms™W`gÅúϨ¯"› rnêèš—ß¡RŽwð9£_²Ò¹Ð_8=óe4%v>oFÀk(Ù?`LÙ½¼`êú4ð±ûåÃ&9[~ƒ˜;26cLà«|r)Sƒj…×Íl(ßÛ b¬Å7ÎßÊçÏVð™h9Žù,¢I‚°RÊ• e®äß·RÆ%=²ìÙ
êt›œ(†Ì%³LÇî)®Ž>1Ù¥‘„µ…^Ñ2¼éˆO£Ý %õ‰>•pjÕr{2–ÂwÍ<–g¬™-j—!3cäáakIè,AŒ$ÁLˆÇÆ‹J¯³nöùU»Ïm›Þ‰D3 @@ -5298,7 +5294,7 @@ $OíœàÅ€DÈ t‡Í=žÝbóÆÃwî6ß"£“˵?”JËOP2RÐoQo+†â1)©w†¦ÜèådîI½ÈZ¿VÍ(e÷åû È"[vQÔüFØs(úF$'‘qL ®/¶!õÔ
¤HvkÖ‰Œh¼È‰¬ê؉á¶o?Ùa:Šÿ±qêcŒ°gã!_QÇ~ÏWê¡1üaœ¯UÝGmã§Yñmn%ìRãr9÷¬ß0qˆ5†/‚E…(êÚ“†,W‚˜$Ù½ï¶åçLxËÎÔ|ú奕£w†Z|ÂV€ãž÷,éOd ÞyŠGÝ
ŽÎ¨Ý3lÍ4©¿Î\×T2Zª½Ag—.7Ù#ÏPæï™v¼eŦQLÞ»±Oþ¼Ô\’ ¬ÿĵJÅñ¾(š3Ç].Å*,MÎ>ÛBx(ÃSÃó|D³uû‚Þ¡ï†{:Ò‘Á¨2G9¡Cê{É•<|?ÒK áéá@F)Ø,êw÷ó?È ¸¢Ëa„Çh%Ù±o^Œñ{‹6™Ý@¥-«ä%Å~jÉwXjz1îi´·î¬%uÕ3^¿±g¸`d+ÎK[ŽDe—„]âò†YèÖýÇ?Ï>£³HjË,èkѸÍhÔ8Š”™v_Å
[ªJÖ®²9m=·âú?\‹k>¼à¬‡¤*³Ñ³ž,Y
ê<‹ý¹uÓZ/ZV$S·é#ƒmNOš¨5M@¿§rãÝ0Hõ7¬&7[àçŽAØñêOõƧÈêÚ5±pE6~d»Ž^.x¨T1¬µ¤$£Í7¿ÿ4òÆêüj§‹G1¬èípoóÌ3³QýÐZ:œNÍÆéç,0½‹Š‡Zg‹ðâ£à)‹Q©¯³‹X""œÛÆ0ÏÁ¾äBvFA‚)Y9(ÎYÖý…ì¬S…|¸Ôü¾“qbæÇN.LÔX§…_ï‚¿œ%%½¥åŒìé|°D>W²7}C–Í#—ZR¸$º`bÛGο…a¿9gÝS%\”Á/œîñhC|?s§Ø…šg¯ÎÙÈ)ª¬m}ÐvÖËk†Ÿ.bÉ&O üõí+uqfº`Îa‡„°£â,I§ã¯½/‘˜÷ÇÝ›Á¤'P6ߢH‚Ú?÷›½šÙ¹˜Žà9¦ŠmHr7:pMRYŸ#£ 'æW¥¿ðKCß|-¡mWÝ躖nᲶË0–«ÞÐ3äÛÙ=j’¸Ë-,n–³e±€¢üb½iÙ;‘˜Hâ°l<)žL.ßÐYÖÿ°Ú·)wL=(‚Œ£± L|)=å'ÀÆ-Å@²öò¾µ<ÃNrä³6îµEôʃ3±d¶kÓ»¬ÿ‹%ôµøü·(kD~ô(¬_yñ‡Í;¯åä²fùOî{&*‰äyÒ¯9ÛB±T¨d>è.<Sâ¢éX3p7«Á~ª"럽Ÿ“lË´ÍÔDQÿfŒ°Ì -*s"}Y
;Ò‰¢ú{YÌÝÇí]p¶Òݯ€Ž¶Xo³êÙ} +*s"}Y
;Ò‰¢ú{YÌÝÇí]p¶Òݯ€Ž¶Xo³êÙ} endobj 1181 0 obj << /Type /Font @@ -5307,14 +5303,14 @@ endobj /FirstChar 67 /LastChar 85 /Widths 1337 0 R -/BaseFont /GAYHFA+URWPalladioL-Bold-Slant_167 +/BaseFont /AFGGJZ+URWPalladioL-Bold-Slant_167 /FontDescriptor 1179 0 R >> endobj 1179 0 obj << /Ascent 708 /CapHeight 672 /Descent -266 -/FontName /GAYHFA+URWPalladioL-Bold-Slant_167 +/FontName /AFGGJZ+URWPalladioL-Bold-Slant_167 /ItalicAngle -9 /StemV 123 /XHeight 471 @@ -5334,37 +5330,29 @@ endobj /Filter /FlateDecode >> stream -xÚítuTÔíÖ6Ò’J Cw·ô€ -3383´t‡ ”´„ÒÝ
ÒÒ-%)!)ˆä‡>ï9ç]Ïwþzßó×·¾YkÖúí¸¯}í}íûfg1 -€RRRDì -fgp™™róòòýËó;`ãþÈÍI4Ìà¸ùp‘NŽPæâ|…0öP€-¨è<ÖÒÓ -ö‡†3†°û> -jg‚À¡hô
Ì
öïéü«OÀëÞÚÉ îþç4òOÖ?9À0h(ÜV€(|SŒ¹©mC þ^-„- -“æ{c*>oÿd?ïs¢Î
c—xž6£ÜYXþñèÈ%gr…é GLwÑWªpVØ/:ŽI‘|C
–ãÕ}(X)QÌgfæ½kbO—Ú+rêÌ՛̋m_%-ïŸî#3
î7ŠÇG7¥àç´bŒ½62Lú ó£@ÚÛí¤Ì±Üôì:
Ê8¼2Ô·I•f©®¿VNî¾ç"4¿µ L?Õª*Nsÿa ˆý¢ôœ„ÛGPÔó<•ÒÕ‚„D»b¹Ô=5y÷y‹GDv¯î€ÝÆ'ÂÀÂ>JèÐla¤dˆ/øûçÐö<Z úEüYmñGcŒÌ$ôî}Ý]všø”,ü[Ë3håþo•ßœôj0õæGIѺE÷QÌĪÂ=Sµ†j -a?±"²=;£€»òýÓY1“²aÄ\'ñéÜE2º_ÜrBebPƒ¢y<55J+qD*á„‘C-Ÿn«Öë]¦y,%ƒÔ§Œ‚®Ž¾ïÚí¦ó$à”=+ª:‹º<LÃ,Jdºzo}µ7µšÞÅ zdz/jIÝ}ø|È4‡ú“ lfc{0Y[Fýy¸D‰`; Ù¸.ËÓöR´Ï°H ->©ñ:›BŸÁÖr•–ôì¿žä£ s¥¬i³ÐrªôdxÕaÕrCVäÁé -Rrd
”éaAfµ|ù±G¡A;îR:?+ˆC§Ý‚ôò.¿v¶é²ö™ ØÆùܯF‹Öüp-møPžÁý뉴$Еçhð¿~)£¥ÒcE‡Cá¬' ˆ ù$°Üæ]úZÉë)ÍŒj(Hï;KDldv`ú¶Í –Ÿž›HSJÔÓûcƒuTf¾L)>¾9{rò`ÿ'-MË0šñ7BŒÈèôPÈè†*d¶g¹9«°Oë¨ñ³9¼)*úpĹÄòaõ¶À(“ÁDzØ_Oµ¯\"U#;íÒ¿N3vl†æÎ|T)D<¯áÔc=™-g¨ë2Ée3¶±cýD>¹¬ü•€Õ:atµ¾D -|” -8T–’>úAç*º^îö3®fhCõÇ9™Îãüd”«\ö<äU‰ýe©e™ *4¡ ÜJjÐ/ÖYvwÊrðù²"ìŠ/1^xx6"ìŽQã‚JŠT9o³ -ÅóŽà±—\º©
žÙ×´m¢,ziº¸=[mI…jk)<Â4Èwoï1±q -íµcªîy5`j8NÙÜq#(t.«[q)ÉMì»
º¨¿÷,J΀5J’ןl™–r!º©.6(!’r˦ë-‚к‚n‡_€´} îDÈtr]Ö)cršLÁ¢G3àç6~²
D--ýNïð™aG¿²Ÿ½^§Ë»¿ØGÔsn.p7mB(«â뽋P´‡×ÔNè -+®“Ñs¢§˜òJŸóÜãÖnçvók}ƒ%ó¢òI2¶¸×‰Ë÷Í#|æ8¸œVuä-¸k ±3gzn´¢°oo…~ÏàUòM^{û¼L|ç‰<ÏÎkùþ3žˆ–ÞÄÅ«_ŸüIGÕHç‹•Yý.¬g¿â% ÊÉœ¨¾^øÉJ¯$³‘=THÐ4ÎHe^"ö[` -¤çS–7þp%ÿPhÌÉÝþ9™ê“”=zn£TEùÖ‚prŽw{^aÇÃ}Öíf¤žÜL€ã ésˆ¬;xúFu¡f«9eü÷qmï¢o£b̺£{¤ªÁr)ýÖVfñ0%ñnû˜vÂ.å"[eÀÊ[ŠaöTq&bn2
»SdÐèw)úÐ*Þ×ꩵW®^ jxõÌÛPfÙñþ7éõs„T0Vé–·àö*}åg¸|+þ”ÞYÈm|À+áÙE%) -›´d·EuÈ)˜dK¨bÆ›Q/.K
¼„‚’¾Øsñ¹fL„ -O›[>`³ó¦Q¯fiXWowÎÍb÷WתXü¢÷!Ãà|ï«Ôm»¤žÙ÷Îøêç¥ÝqXZ$[Ö+îæÚ—Ò°Û¥¿ô¢ D³NŸ}f²V—›Ï‚ÎPÌSuÿÖ¾[j‹HχëQÓÛt\~úLÚwBÌM„R0<Qv - êô¸”$\)ÿÒeÙ£8nç—Y?£—št¶÷ÎÔ¸éøÞMõz;´óÌŠ\tà=:'Wþ)ýôzç•âyƒ¨‘ u„÷YuY€ulÙÿÄkèÕ|1º°á“¶ÚeâÕïÝ(Z½_jÚÔ ’Wq[”É%q¸ÖÇ'Ç™?tS¦“æœþüö°‹N?3RܶX0îµ)Òð‡Ò~Ò›ÿSÆ©ÄÖëø¦†k¼LdïÑ÷AùQ‘¬aÜñ®¬E^«Ú;\ÙŒf'3QûºµöH×wB"7;b»4|/Èž’7âWeÁûÃ`°WVÅûFºÉOßt-èš•Œt¸ueq”½8c"÷;ØOUÍ‹Ò¥öß4‰~î]{xw{¦±Fèrž¤(ÿƒ¸ÝªbcĨü™äK‘òJ¹,d|!ÿ}÷ -Ÿ,lã„G™â¯Eì»ÊˆEblȃ2é5®õŽ˜|\Úæ6YØ ý\$¨J"ä/†lùô¨Ü½µK¾Is›L¸'Ò Ž§8ïËÇT3Ù*¶[bº©õ™Ûë'Üf±gÊnñ -ÿ¡'°:N`J¯âZ¬a¾½8ô\k?Qª^¬ü"Aü¶<ï0—‡,PžYeßKn~A±=SƒÄÝŽ}lul™½Ý _ÉûÑÿô"EzTËì±pÚØumœª-5«£è®I™4–áswoªþ -ai(¼3(O²~õKœ…)ÁÂ,of(É°!ˆÉR@ˆ?ÓcúÜzù -GoãÅ ÕJ¯E˜QEAN–£oô¯_±u¯x3H3ŒøI%\Å4rÕ‡¬~«¸™ô¾Ù«Ÿ¦¦4¸¯H~–š±ê.ΡP†]4G¤Ýñ9˜íl¯÷TO´{ØñRßÞ«ÖU¼›7µ¹¼žÒ”È°"¸·ß¢ò|ؼSí;çQž±ÈÇÑï·Ü¨¢]»¯Ðãþbÿ›gÝ^dcŠŠÙÌãÒ`&4>ë/MÙ×F„ªÓÄŠ§Ñ|T¦3½’ò·è[É*gý™Çä7´f_iu¹`æ~á–ö|²¢VUZè_ü w±¢y¥Ë;:ùD+â[ù‘éŠY†šEõa(¹“ªb$°Ò&P¤æ[w÷c¶ò—~¡ -V.‰L„Äu-ábHovWîó±Wƒô½Š·‚p.•†¬Zã«ž'¿°šqäÿ&<ŒÌПëà©ò”çȘàÓÝhäx3y‚{Èx>ty€´õ5
(ή•m“#UxÆGÄÞî 6I¬™Ïw…—ÙìÑx?åÊ쬚¤š ;qè$zÔ>€ÑâÚwcyÅŽ r‡ô+gd`ƒ†m›ÍvߣR+k®Hsm³Á¯}A{}ܥɩ‡\ú¥&îÍsæÞYÎ× t@übWdìIjÐSTqìš¾îÎ}‰Ñ}’•÷Ü)×É×ÆÅldzÖ”þ‡“KbJÆ(ß²Ìà)Öð¤mµô -жý>Bŵé#5Z%ç›o¬¤]§ÙÏEÕ`œVã®vÒ—æ$Œoµµvej¾
ß6e¸—’›4óÐøjk½-0÷”Ì©¸ºn…_ÄÍŽð 2;åùÈbÜ?5Fõ5Ý7§ÊÊ»šè¼§ðu®¤”U”±·ÆâáEÀ¡Š0~Ü×N6´§Õ?òd‘öFdeG¯\-]?^j~ÅÓ–£§¡¶âs·b0࿃Û&ow¯ÖæRÔ¶¢BcĈD^·8ÖÄÜK¬)ÁÅÒ½}‰™îà=Ý;,'ÓÇ”{}š»“‘!¢ÜEÊI®g ëâdï<ëIŽšfý¿íÒ”|ÿ0¨—¯ÉzjÎ,v§,Mý‡ç¤wÔÓ²‡%.ú¥ÜÈ]MÜŽé;w¸nU™²ãˆ+0øÿ:1ÿd“ä"21Û…k!zkÊlÍDD‚kÕFѧ¥ÇÉ„Œ¯1SöçOqßéË¢2eŸu-ò‘ö4ê"®‘õºç4aÌ{âxP9¹HµR÷¥#¸|#æÇ,v2SáèÀêVÇáÆñÍ&m#`b»JºÎéì ýú›Q+EI²©á$8§<ꇡ›Óç…oÚÎÚãeØró¾µc8™&[Uå>Tƒýòf·ßxõÜË=üÂÇØáÉó-”íÍ«W&…P«^Y§4XÑzήhjG -¹I»ÎØ/.^¿v#úNûqÕJƒK²óY°œ}Åö“ÎããÀ{!¡ôñ’ý¦4RÏN¢_Bo TΨ<kçK*ñÍ0µñ4ã‘ó(«f½HZ+ÈñΎʾ#Ζר »¦noÔTX0ß-kùA›ÌÕ3Ãõ'M±q‰p“ÿÝv
[`ùsµìâ“í¹§Ê$±Ö®pS¸LXœóÔ½ã*¾½:-É¢P¤ûÑš¥˜EC]peçÁxažû«—¦Ú3é³êÌ-Q:X*÷;ú½‹bSµðëûÚjOh÷´@\j-¼î‹>~¢×{Y¶_MNA"yZ‚àŻƈûÓ!Ä}vwRC%fB@»Gé¦Ù÷ºQc(ÛZa}6ÆÄÄ1Þ»œžÛ[âÕîU«d5µ{› -vˆ± -ÞͶD=-z¿áݸY,åóS-ú–Óºµ²ú@6WptLZJ:ò]ïebø\û*(R°ô;1î3£á«W4é -*ìÝRÇBáªwx¹:á&ˬ3$àòK6ìþŠë/ÜÀ¢§ÈRZ«³H‡ÐN)ª-šéJZ - ‡•*ÆÂÀƒ98cÂ2›a]Ž]ù±ÛUr©aòºžmº9¾ª&*è»Fæ/b3Èèfr*ݾ9Ð0Ç€%¢azcDùzŒ˜NÉ$Í粿"²G'[DLŸUfÿ(p^RÑ -/Q‡ÏÉ™äžE/nåÄJ÷6c¹L\y/Ô˜0’¾|Ù:'Ÿ_©…dAeº»UO¼é¹Š,Õ&7 å›/~–ÊÈ.Co-Gn‘ïCèJRŽX)-¥yÏ,¿ž9pyO:ò³föˆMìPF#¢‹å™ß¡‚PMYíÈRBü\¥Øëé“o 3\Ñ)÷p÷Éue2Aì0.Œ>ÒÉsE>rÝâðN7ˆhükvŽ¸èÔCdØ›RZ‰‹XìjÍ[èù#úÿ +xÚítuTÔíÖ6Ò)H©ä +ÀÆý‘듸ÀuýáC œaHì5Äÿø `ía +âü»¥?±k˜ë(Gb +Ç8!Àî×µ¯ÁœÐð?4œ1p¤Ý¿ðÐ0;0Š€a0×0×Ø¿§ó¯>ÿ{°“ÂýÏiÔŸ¬r€c10„ )Päº&{]ÛŽ$ú½(ÚH[ +{]Àó?SYð?'ò@âÿˆÀÿyÿwâþ]£ÿv‰ÿ·÷ùïÐ΄>Øñzþz` +–¼¾l¢ +ÛP#…Îö.7gök6¾gµ@4E¥Ñlƒ¸—ØÞ¯Ž±~襌ýõDHç’Ø%R-²Ó.ýË4sÇ·ÐÜ™ª…Èg5¼zœÇ³åLuݦ¹&6vì]T“Ë*_ˆÙÁ c«
Œ%‚ +U™GjN@[9<Ÿ°_E®Â¯Ö¶Üuòæ>Þ×nºÇÆü0+ãÊS‹ÏÉÈ7Ü8ö.sv?7¢å•Ðf‚ñ &È—
‡lý¥"´Dì’‡åökà ¤³ùŠËCÝ,‘%½‹•±Ue¸&ÞÄ´£§,ÿèaÚ=³ã{ͦ#S
÷j>¿¥a‡2sc•ùâëÕìÅÔnÒ¸Åî*ØӥƣœO-¬%¿âNI²}F&œvN§Ù½?Ñç~tSNÛ²–ÖƒCÃH*w¤´Z¬2½çƸ¼oÐÖ6SWt ·¾É—?L““wjoä1µÓüè¥fNïÓ#úPϮ쑨˩ñÌÍÌŽÁ ó ª¦Œ +¿ê³NS-{ÓRÔ}—%J[™òÝ({òTõ§¿¢;…?%0…º/n—•§ ÆhÃe)é#¡ïu/£ëå žBñµBêÀfäe;cLòPQvìòÙóЗ%ö¥VeBj°„‚r3…á€xVÙ)«¡g7S\(‹lp+>ÇxÚˆr:FM)+ÑVäx¼É°ypº<bùÎ$¯þ*&qãYaÔp8_Ú.^à¥ðíb¸rZÂŽ@œL1í]à +\©˜Ì¯t=¯ï.ó$‡—kJ«·j'sV,¼èïs¾)™ÄìH¨ˆ
ÅAjŒ!Rãº7ò#F;Þs£!¾gã¼ìo†;?”è+4Åß‚(fÒVÛά*"ÓQ€§4–:@¶½2Õùò[—9º&ÈÛ1Ž+á+£K°Té +š6!ÓJZ¶ãâIËh]oEfþÌIòÅé TÐ#(I`mkqU|G.YaÄM¢Æ»CˆðáN}3àH
ìiÖ
È@ÓΊ‰ÛM‡â™ÝxÞ#k”ðåB£EÄ™büäþUµO"~`•ØíÐ]àzÒrtv¿¦Ö¾<‚dÆ%&~?Q™i¸÷Ne[ø,T’/KCÏ.Í~—PNtä>†›‡z…Í»GûÐ[’›* +fåÆÛI9“µœ¢ŽécO÷ñ +Z-¬XÛ”úÑÚ³Ö»~Þ»µ±wHQHt‹>”©ê3׿ìlXe*ñŽnÏu!>¥yk÷Ýž¨Y¢¹äL¨çøÊcÍ•T:!ÖR>m›5íEÙ‡Ò‘Ï´¯Ü÷üǸ9}#ïwà F¿u\S¯±–É«ÕìˆÓ3pu~5îÇÙ-›ã¨‹ÒUt_MöGDú'Žø¤Œ§{¬Zs:\Ýþ9´ë
‚¼HÙ—î+qî)|³ÕJú%‹‹<å›eæáøþœn3õyÒlÜ—VŠaÊãa¢¢õö< (íM§~›¹J:Yÿ˜¸;…ö:1Uw¼°5\'îøÔºJÕø4T¦öC=†Ýtߥf Jš%Éë7ÍJyÝJ´ç4P)$•UÓÕ¦fAhCAÃ/@ÚPïSÈtr]Ö sršlÁóû¤g ÏlüäH[ZœÞ™°Âe[/8>}¼Îww±Ÿ´÷ÌBðVÚ'ᬊ/SŒ.ÂÑ^SÛ¡+ìøNþEÏHŸx`Ë+}ÎrZ{œÛ-®—,B4‹Ê'M)9â^%~Z¾k9è3ÇÅã´ª«`É[K‚›9ûÀs£K°ú=ƒOÙwx,yíEì³2‰íÇ +÷·_)dœÞhéK\¼üÕå?D1¦N1_¬ÂîwžeþB˜€".§t¢}ðjá';£AìFjôp!qÓ •9x‰Ìo%‘_EÁägÀ¥Âáq'+LûÇdÚ.i{ÌÜ*V¹Šæ%Éäßּⶇû¬ÆÍX#¹™Ï$ÚïY·ÿäµÚ +RÝVkÊä!þ£Ú¾EßF¥aÙuG÷H5aâåRÆÍÍÌâ²*ÎqÜ„šEŽÊ€•7Ô#œ©º,d¼”švƒf¨ ±ïÒŒ UÂ/3tSk/]½@tˆê™0V¹‰×é\õs$Ä´pv™¶7ö*•§øü\+þ4ÞY¨-"ÀK‘ÙEei +ƒ÷ô‡à7Ý™‘¶ÅBa¯o¢
ñhì'½º2N$Ïq^Å75\fj'[z½ÊŠd{èNx }Q¬fïpi3–ÌB{æêÑÞ¥X߉üÖ‘Ü¡çßxNù„ªù€¨*1‡¸\°.Þ3ÔK~òº{Aϼd´cÐ;‹«ìù)3µ×ÁÑx¢fQ”.½÷: IìcßÚƒ[[35Â÷PóäEùï%ìV•#ÆN¥^ˆ–WÊ·à âîºWødáš$<Ì”x¹è,jß]~H&cC”ɨy¥ÈâãÒ&8÷“ÄÏE*И¶$Bá"aØ–_Ÿ.ÁÝ[§Äð«¯é'÷DzôÑwàÝ…˜j›!¥v+lk{ý'·Ù#Ü™2Ã÷Ÿ•êSñöšk¤ +¡Ìºk”i|)böÐõRG¿îMé%èçü=õèËXRùÁA[ñÃÓ¡/¥„5Ø$H#|Nòià@ù +C‹g<N7«-³–¬JœbBŦň°|DÍP{h0¢.@+‰J·NãFêÛE‡V¸;~|ànÁø}õUÕäCAr鯻¬Ÿ•âzõè¢ÜÓÁdïž +eÑu•bXðÕãýî8Èe‹#ù`§–.±WNÖÍ»Ô=Ûü! ¨=›é|Óo;ÌíSÝJ^×3Bu ÍÈ_Ó šco©Ü·ï¸z¬/ߎ/38\?6á7`B–tée‰Š§®øÁÚF´ ŒRÊzïRfzÌLo×3gßÍÐ'—Ô½êû¾ýº\ߢn({‘Ãh.snìW%›ùz̪ÿº¸‰åÊôÉžfCؾMÁÉí;¥J‚;ò¾dV2ƬÈb[g£ì”…¢w6‡]èÞ¶™oEFËue~u²´¦³pU••"ñ-Òõš'G–yU.[Æ‚y²eV–ù¤–üS;äpš®ìÓ¾˜û4pn#Ã]è0Ä2C–Ð(å@Ñ^Ã?ðÉ>ƒM䵎UÝغôôÞ]$êHêÀà‹±öBìüvö>Å}Ž•p§†|Vk: òÈÈ6· çÞãcüó +ßÙnâ›·œE…Øœnúf©½õ»jG͸¾˜Ü>0Äw cUÉËôÐóÖ~{æ[];×å‹9-oõÍ’áæ Ò 1IÂ4‡uªq2TÞ"Ù$¸7=|žèÓVµ#;@¨Éb1Ÿ+û˜Ù.ˆÒtV¦5'Š(ã=š£Ï}n*p@Oz±0jiOÑ»„Š«Ía©P±~º¯ÉG$z‹0¦ +q³~e|õj˜£óhÅ›I†iÔO:ü2¦‘§f$dõkÅõ¤÷Ì_¾ïššÒÜçy´"õQzÆZ¸§8‡Z~¹Ò‘vÓ?f¶³½ÞS#ÑZüAÇ{¯ZW‰"\¾Ôæòz3R£Šà¾¶Ëʳ‹N!ŒïœGyÆ"?×€ß2p£>ŠQlí®b¯ûóu¯^Üu»‘)ªæ3J7‚Y0DÔì¿´ä^“¨M“)|Šæ§
0›é“R 8d4i¥¬œõgWØОz©]ÔYä‚ûuˆ_ÚÛ…c;L§¦¼0°ø^þ|EëRolò±vÄ×òCqŠóuË"ºƒP*'5¥H`¥M hÍמžGåç.Âì<’™HÉ«Z’ž<ÜîÜg1â/‡û”nâ]([·ÆW=K~n=ã(ðUx™ 9Ó%T»_Pœ#kJÄ@ÐÈõz’ +zøű¦^âM .VîíK¬ûïÞâ8™=¢ÙíßÜ“Œ +ã-RIr=Ý[— |ëYO~Ø4ëÿu‡¾äûû!ý|-öVñ›ei?<·¡}cžVåxlqÑŸiäGoiáwLß¼És£ÊŒOB‘Éÿ×±E—M’‹è§Ùn|K±Sæk¦¢’<«6J>-½N¦”ü™r?JøN_5Pªø¬kS¶§Ññœã‰®×=£_cÝ• „ÉËGª—z¼+uÅwàµ8bã²3”"ÞÇÐm¶:Ö(Š4N|kÔ¡7&Vpª¦ëžÌ±1®¿³FR—$›MBrÊ£~¹9}\øªã¬3A<X†» ?ï[;—iºYUî#I;4 `NÐ@lôÚkÀðNîÁg~æO6¸o¡\?h^£ú )„NíbœÒ`ÍhHâ9s°¸m\›h2ZhÂKÑ}Êy~þê•éwºØ«Öš<ROƒåí+ÆqwÞ‰ eŒ—0£—~zývC°rFõi08_J™†¥M ™ê¾ŠZÖ󤵂¬Qïì¨ì›òáyŠrËaöÆM…ó=rVïu(Ø=3\Ò÷º™”ˆt³øßj×´–?SÏ.>>×™{¢BvE˜!dÃ✧îUñè×iK…¢ÜŒþÐ*Å`©êjE*;÷' +óÜ_¾0Ó™IŸÕ`m‰ÒÅQ½3Ô1àXdt›ªMTßßVãx|{WÄ£ÞÂç¾èã'vµ›eûÅô$š§-Y¼e‚¼·7BÖow3!5Tr&´Óz˜n–}§=Ž¶1à`NLç»Åí¹µy.Qí^µJYS»û ©`›×¸àílKÔ“Ú¢w{çþ¸ë‘ÅÒ>?Õ£o8ƒU4³iy‚£cêÔSÒQoû.z•ÂçÚWA‘B¥78ÉðŸBé^¾¤OWTåì‘>·T»yÜËÕ ?Yv)_@²°a»ðWÜ@á#u–ò¢xXe:ôö”’ú¢¹ž”• ê`DE±bÂ82”3!)“u°ÑãÚQ'¨’O
SlÔ«ðlÓËñU3UÅÜ2¶x›A¥¨ä¸Ï0“SqàöÕž5¾ endobj 980 0 obj << /Type /Font @@ -5373,14 +5361,14 @@ endobj /FirstChar 36 /LastChar 121 /Widths 1338 0 R -/BaseFont /FFZYEW+NimbusSanL-Bold +/BaseFont /DCNWYG+NimbusSanL-Bold /FontDescriptor 978 0 R >> endobj 978 0 obj << /Ascent 722 /CapHeight 722 /Descent -217 -/FontName /FFZYEW+NimbusSanL-Bold +/FontName /DCNWYG+NimbusSanL-Bold /ItalicAngle 0 /StemV 141 /XHeight 532 @@ -5400,30 +5388,32 @@ endobj /Filter /FlateDecode >> stream -xÚízU\›Ûömq§Å‚+(îZ(ÅŠ $8Å-îÖâîRÜÝŠ(ZŠC”â.åÒ½ÿûì{ö9÷é¾ÝßM¾µæ˜ß˜sŽ5ÖÛÇʨ©Ã-v´„<s„»póñ - —{\×Ö B -¿‡\ pW''Ö† ]V¤Àú¾³ÿ¬ -wtòD@ml] -$Ôx|¿pƒÀ~Wº§P‚À!ˆû¦Á¿s5AŠ`¨Ëïqì¶..Nb¼¼NÖ È}Œi͇¸ðrÜ7ªË;:ü&@âþÖLŠ€XÝåÉûOÝìáŽîpïÿ[Cáà?F»:ñêÁ¡Î®ç -ÿ“|Âý;fqù¢@~ -ññþßßáòñÀP+€%Äæþþf¿C¬ÿÜ«\PÀK È -»Û‹Êµñ`“£*‡RïòÔH¨‹á`³{¨c#(“3·å=û•÷KÏŒX¥äG‰uBÉüè.Œ¿o9k`ÒЗæ–ãhlÍpˆ’_îi(Ã|µÄ0§†Ú€vo’ñT:ê'.ÙTŒñêwÏIÊÛˆ-¦gzåý¦B”p]>XÒ‹µvð_Ù–´X_U
9å -ª<5uZxÒ—¯Ÿµý^1ßÊeïK„ßWi‹‡ˆY ¦JZo¬`&Eø_tÌõãÉêi;=<ØPe2¨µ)ŸžÖ<£ïQq#}¿R£¦×®2g˜€“7ÙhQ¯ê -4œëµÈÆ®÷|Õ‡Ö5û,´Ixx\AË¿kåtð`m9ðO<ŽøÜ
©a?&ÕÔ~æ¦T¹žî&]±ÑŒNѳÝ{Ùa¨Ûíq¸>¢db)°%õù©âãðM^¾ºh Ï-(o_©·¼õñòm%[¾Êg[ -õ–2:m›Î)ùd
dõ4(]-DÍŦ½tT2˜£STCì®K½ðhŒá©%¸ú_f·rÓzµ”Xß
‰áR=)âæÁ9Æ9×AzF%6ÏÍl{¬è΀òi’X¨Yû\]èÓ‹Ö´…œ}:Py|N“\q¨=6Õ$¾Ñ†L0mSFèà›ËÛ¿·§ê/»æ¨Í[ )€>š~¶Y×—T&xå¬Ç;+ù.[•öDýéŸÌÓÃWÖ6ù²¾½”6”Rç…O+úÆ4¡VñjM¿ÈÄË—‹ýöæ¤0û£ù~¦x¢œÏ nÉÑÛaý»q¡Ýt9´~Ÿ"wN^$'Ù’)?qwä€Þú8™»÷))gˆ0çpòl2ÉjðرMùÚÎ÷«ÛÂr;)Gpnz'Ìv§ž
Éí ]ù´…¤ëuàûö—¸ø~¨xR3ÂÝ>$4¤‹¿¶Ë/.t¦›¶ÜryðE.xЪžC;X— ÷]É°'Fk(~X×{Ô@¬ü§Ãïh¢»t—³b“€’³æn?Ûæ`ÐÖ wÌLê j¤,³/#mt‹‹š¯dÿãŸhsZ>ÐÕ²Iûé +xÚízU\›Ûömq§Å‚+(nEÅÝŠ $8Å-îÖâîRÜÝŠ(ZŠC”â.åÒ½ÿûì{ö9÷é¾ÝßM¾µæ˜ß˜sŽ5ÖÛÇʨ©Ã-v´„<w„»póñ +¿‡ä\ pW''Ö† ]V¤Àú¾³ÿ¬ +stòD@ml] +`¨Ëïqì¶..Nb¼¼NÖ È}Œi͇¸ðrÜ7ª +ññþßßáòñÀP+€%Äæþþf¿C¬ÿÜ«\PÀK È +ï]sÿàû¯–ú7ü¿ëŸ5ž»Â`¨Âþ§€{= +w~ÆÑJüµÝ‡×U24îÜ›cO{„ôÎî\p#a(ë<¨Ýê”öÅ4Ù§"‰éòšÃ¶R/ÑÔÐPBbh"…ÝíEeÛx°ˆI‚‰Q•B©wyj$ÔÅð°ÙÇ=Ô±”É™ÛržýJûŒ¥gF¬Rr£Ä:!Žd~tÆß·œ50ièKsËq4¶f8Dɯ÷4”`¾Zb˜SCíò@»À7ÉxÊõ—lÊÆxõ»ç$åmÄÓ3½²‚~S!Š¸.,iŒŠ…ÅÚG;ø¯lKZ¬¯ª†œr•Ÿš:-<éË„×ÏÚ~¯‹˜oå²÷%ÂŒï+Š´ÅCÄ,S%7VH0“"ü/:æúñdô´l¨2ÔÚ”OOkžÑ÷(»‘>_©QÓë×F™3LÀÉ›l´¨WuÎõÚŽdb×{¾j‡Cëš}Ú$<<® åß5‰r:x
°¶ø'Ç|î†Ô0ˆ“jj?wS¬\
Ow{V±ÑŒNѳÝ{Ùa¨Ûíq¸>¢hb)°%õù©ÂãðM^¾ºh Ï-(o_©·¼õñrm%[¾Jg[ +õ–2:m›Î)ùd
dõ4(]-DÍŦ½t”3˜£STCì®K½ðhŒá©%¸ú_f·rÓzµYß
‰áR=)âæÁ9Æ9×AzN%6ÏÍl{¬à΀òi’X¨Yû\]è“JkÚBÎ>¨<>§I¶8Ô›jßhC:˜¶)#tðÍåm†ßÛSõ—]sÔæNÐ@M?Û¬ëK*¼ò@Ö‚ã•ü—J{¢ÖþôOæéá+k›¿|Yß^>3”Rç…O+øÆ4¡VñjM«dâåËÆ~{sR˜ƒýÑ|?S<QV‘ç‹„·äèí°þÝŠ¸Ð‚nº,Z¿O‘;'/’“lÉÆ”Ÿ¸;r@o}œÌÎÝû””ˆ³eC˜s8y6H‰d5øaÌئ\mçûÕmaÙ”Æ#87½“Ff»Sχd÷ +P‰®|Z‰ÆBÒõ:ð}ûK\|?T<©ánÒÅ_[ Œå:ÓM[Hn¹<ø"›V<hUÏ!ƒ¬KPÐû®dØ£5?¬ë=j VúŠÓáw4Q]ºËY±I@ÉÙVó·Ÿms0hë„;f&u5R†Y‘—‘6ºÅEÍW²ÿñO´9-èjÙ¤ýÆų >b¦„ -1ߎv9!²eµª°Ü¡@leà4×"_¼FÛv$†ØÄUq~:S‹í <I¥Àá -wÂ;,¢g—=êw0{fnœ(|¨3ŠË1ñשësxÏ<uñwÓîÉÙP»é*rª$›
<íEë+Îseôÿž„´¸HÔ’îx4ùš$Ϭ:ò0AÏëq6êÓK…‡™‹Ì#‹Ž¿»Ý¯È¼”ðŸ¿Æ{ŠÝýÍQÏB´óš·ÏpÐ}êJ/øÑžd_ÂõpЖßÄ\Þ]…MÌcxŸ6ñ"gQåø¨€ÌãÜ¡H7"UZ´@¼ŒCc>λŠ÷¡}IFI&D -ÛŒ7³•vå‹°Ò¯}zökÀ]TÞK[Ó¬^Q“+U×7¶Û4ä /fö:Ck%-¸¯u 8a2Ÿõõ©yo]èBÜê6sJvfûV«C:ó1¥ D¢Ç›È'i½KŸXnZf6dÄŽF"Â-é3ø-±‡ºhGÒúêG=˜/ð6Tc(S"}ŒÇDeHA_A¢<qëRiÚžpmê0qs¶°?©â\¶U¡A›š°ÓF.:6ä2cO=7’C* åéÐë¦-Š1NíæÚë}pZCÎŽŠ¡`²*ÜÅØ?GõºDñšEš10hÉ1°xì™Ìäõ :EªœgE $X2X0ˆðm•õ«Ê“iÍé41xu¼ë¾{#aq·\7ºÍc@Ï¥a€´y×9½ Òñ¢ysec×`?`ÚÝù%,MX2LFIèO²Í¤OÛd®Ò͸¿óŽt?p†ÒLÇ´®_R¤FˆkIcèÛƒ6Ùu<ý¹hîÚ’œkÆ°ÑÏéqPèåÇù~‰šáR„t¶2™Ô¨/B'àÖ¨€ª«œ4›Óù
A-× "«NF–õrÄ9_Šn¶Ð·Q¬´5ŠK¢‘"¥NŽÔz¼±(æŽ{ÒÞD’LâG)qÀ8Š¢1õŸ+bQ‚ÒgôÑu;ûÉ3sÖÒí±qšWöª0Šæ¦rXS>¦«Ä+_h7íªÀÆLÕ¬ÄXWlhBGä
Ë]ÛNÏè±Ô` N ¢í´&4ÞV•Úq~ø(,ø¢Ù¶º®1Íü€š[¥ ÉÚó¦dñ…Ï!ÔšåÇR
Y—&×Q8}mi'^Oé“ömïjx·NócËmüW)P¶ë/sµ¦s™»‰ÜÛäúå´q%K¥ÔÅŠ‰Oµ©~¤ƒ²'m—”êCYhmñûÉN4I¼ý Ìnž?Téç~}̾Նý¨«pð<ÓÕ;ÿôÖò±ÓÆΧ;/Í×N¤Ö½0R{”Ì ×òŽÚ /ç w˜ÁG©^ª%½ÛÀµ¡‚…E6v[? -–>ÙÌ©Y!õ -qÁJì.uý…$iU™`ª
Ïíëo4x^‚çeUa,¹Ï?Óâ\Úéà;Šucî0Dæt¸9š™–v‰¹ÐbⲎ=¢A´½i -!2PåÞ[Üò>1îæÈ–›AÍ'+y&«[–
-ïy&©Ê÷TÒí‚®å@8¯Î3 ·erñÒÂâtžÔ]VyªmÒrGâͧw"D®võ1 -îHÿt°–ói0+ó2V ûȃ6Ó÷É÷÷ÚHÉ›BÐ÷+wç´ÖDm’29ÇXó«+r0’ɼ…W&!óHÐfÛ©ý-õxdð7Ø•\"Ñû\6í¢¥²y”Ç^
ŒGÌVZ´J<u¦
ºbÉ\CÝ؛Ρ-oÛ…§÷e«Iz7ÐéôppÆ&DRƒì‰•˜[R²c=n%½¨älW‰ÅT~KF½IýA¦$Îu÷!Œ÷tòm;1yð‚eÜÕ¡4”êópdâëJûÄÍž‹Oóþ*é\$àV™lØ4»ÛŸ"ª¶iÇ$Š;)ùDcòÞ5Ïœ™åî˜ Fù”/ªoÎ/¢oc~Ûn0›|¾;:öŽ•yEÍR¢«TÂüSî -Î;a~LJ>á/©9=¦ê£‰æÑ8Èb]îì¬ -Éü°®Å.¡Ê1–´Ó”$GW°|2¼Á✮}® -à8m©{P×@7‹Œøb”l¦µxÒEÃëKÿºT)|ô)Iý·‹b¶óè{“Ê=ÔÖI:à ‰ðBúd›åŽÁôµ˜$.[ÁÛ_-ab/é~ö>ŽMë½à/TE½C+6 ø<bvàºÆ¨G¿xýý˜—¼ýÊs%K$.¼>N‘.øããgp‰i fŸ[:ŠßFëƒ/q0[¾K j´¶#³5G<ù»&Ýh*0éz&郷”ÞQPâ1ùªÝýô©Mlk{žÐËîð`ùŸ¾©ö}ô8´1
Œã©Š
”Û
@Ÿœ¿ÙÊžÙÄâØg´±æmKá -S»\fìy–#Þˆä—Ë:QK¶d«™éc1®‰šðúg µ)„|ŽÙ¨bÒ·ñ2îöJ’¨‹fM_.{˜Áêü‹NBCŒ¬—a&}¶~†Ù)l_!ÙŒƒçän²q²*2Ù¥}6¼-à•a~RÉ„ãVÙè¬T[u>³CeÞü -^8™÷YÄ„Íl̺¥—:»©6o†"Ô%n~{çô¤€?oÇÎ
tÀk½ÝŠDÚ"ö€?olÄ(0ÑÙ>/AÅ~½–œÃ¡³î>Þ%˜4}\E_‹Y7£'V?rÚME•8¶œÉv;/õí’Ðý<#5èŸÛ.Ûº>©ÏwýB/ðIX/°¡–õÁÕ NZ‹õòÞ‚hu)Ù¡±˜_Ña#4©Yõ¢jn„‚æ:׺h=LÑÖH<‡ËøHC“9¯ø¥}646]~:Àâs¹N=2 +1ߎv9!²eµª°Ü¡@leà4×"_¼FÛv$†ØÄUa~:S‹í <I¹Àá +wÂ;,¢g—=êw0{fnœ(|¨3ŠË1ñשësxÏ<uñwÓîÉÙP»é*rª$›
<íEë+Îseôÿž„´¸HÔzÖñ>h:ò5IžYuäa‚ž;ÖãlÕ§—ò3™G/v»_‘y)á?÷»û›¢ž…hç5oŸá ûÔ•^ð£=ɾ„ëá -¿ˆ¹¼» +›˜ +Æð>m0âE΢ÊòQ™Ç¹C‘$nDª´h€x‡Æ|œwïCû’Œ’Lˆä.¶?o.f+í +Êa¥_ûôü×€»¨œ—¶¦Y½‚&Wª®ol·iÈA_Ììu†ÖJZp_ëpÂd>ëëSó޺Ѕ¸ÔmæÊ”ìÌöV‡tæcŠAˆD7‘OÒz—>±8Ü´ÌlH+‰D„[Ògð;[b
tÑ2Z¤õÿÔ1Žz1(0_àm¨ÆP¦Hú‰"Ê‚¾‚DiâÖ/¤Ò´=áÚÔaâælaRŹm«Bƒ65a§\<tlÈeÆžza$‹”GÊ>Ò¡×9L[cœÚ͵×ûà´†.œCÁdU¸!Š±Žêu‰â5‹4c aÐ’e`ñØ3™9ÈëtŠT>ÏŠ@H°d°`áÛ*éW•';Óš;Ó5h>bðêx×}÷FÂân¹nt=šÇ:.€žKà +K¢‘"¥NŽÔz¼±(æŽ{ϼ‰$™ÄRâ€qEcê?/ZWÄ¢ŸÑG×Aìì·&Ï0ÌYK·CÄÆi^Ù«Ât*š›Ê`
Lù˜®¯|¡Ý´«3U³c]±¡ -‘7,wm;=£ÇRƒ4:uv‚ˆ¶Ó>˜Ðx?XUjÇùᣰàOxˆfÛ"èºÆ4ójnå‚&kÏ›’EŸB¨4Ë¥:³þŒ\Gþôµ¥x=¥OÚC´½«áÝ:Í-·ñ_¥@Ùþ¿Ì՚Υì&ro“ë–ÓÆ-Po*&>Õ¦ú‘Èœ<¶]R¬e¡µÅï';Ñ$ñök$0»yñP¹Ÿ{øõ1ÿ5 +ûV3ö£®ÂÁóL3TïüÓ[ËÇN;oœv ì¼4_;‘ZsôÂHíQ2'\Ë;jƒ¼œ'Üa¥z©Fiôn׆>ÙØmý +›´žxI7p¢É[úd3§f…Ô8Þha$U§-Ý öF6 SïÐuFÖúù힟ĕ’3ˆµ'‡¶I?m=ÃU¾õ¨Úf©¦•ŒÓË$xyôeJ¡ÓŸÃ`ìcÜžd—²àüA±ô‰!‹îù”wš—gìDsQ¸Ì¬³ö+@žÔ«›|4Úõ(Okº•ó–ˆÑwÄô{0ÌF½fʲfÉïEW +»si4“-öþèÏ7|s¥—€ÖA?¸>p-Cêh.&OÜ@þάß{·„lGJ Ÿ‰¾V[Øç W¡iV0óH{ØÔ$µJìXý!2ξ YÆ {ž„åý$)ÉÕÃܳDW;ïØWÚøÏ^IroLkÄZw(+iÏø‚تC㯑ô×I‘¶û»7¶êzýKê„äo¾;*_ðj™iW´Ð‰³J«yýÈb™[6ÁÞÛ9•|¡´rFn÷ìêÇq\©¶ê¢\—ú´ô±Ú3˜ÑÊ“o¹“Ò—Ç}ARóر;rš/ŽvãŽæ–ó°n?Vª<~xPE+Jö‘(éMDŽoÝ1ÉÐZ>Á:3…JOYîÌû —*Â=“Æ}Ò‚<¥M-*$$z!^™(Þ¼Ü"c(êÄñieÌÒôZ,ÙMs”ƒ6…›¹w*wªéÖ/ó?âÔ5kîFP£vïJË9΄‰ØùtM”1Î2V,—™Ü¸7ñ¾áoäÁgV~‚B\°»K]!IZU&˜jÃsûú
Þ…—àyYUKî‹Ï´8—v:øŽâBݘ;Ñ9nŽf¦å…]"ƒF.´˜¸¬cèÆEmoÀ5á¿FßËŽ›¯)„ljgL«ŸIÞ¸¾vŸñï¡'ÚA¹Áå›Ï”PjÙåú‚ò:»—èââõ³WŒeoG2¤(RôºlÛ¿²Ø2Kn¥*ƒ9Õ
Bž÷¼×¶©x¤ŸßUû=œ•p#úŸN&“p÷Iƒ;ï»Dk Cá!aºÝÍ$ŠÞ‹5Í(BIÉñÏ8¾·ä¨¶Ëy}'œúJi"º¬Z>‡+Øv®Ç¯‚ÊEMѱ¹EEª¬%Å +†Q¢UÊÒÒ‹èÓ…^%T‹çªhT³~3ÔYƘ|«#¯U °c%ÃŃïé¢*ÙCò=©BˆT¹·À·üƒOŒ»y²egPóÉJÞ‚Éê–eBË{F^£IªrÆ=•t{#¯k9Ð#Ϋóèm™„\¼´°¸'u—UžªF›´œÇ‘xó©Å݆‘«]}@£ŒÏPN3-r7CòO×1Æ5L }2•7ÃÖ‹PÃèÚ=¼Ú¬«º&mj ’LNÚq\ñ·&'W/˜¦)J®>Te¿ëÈK&¾r¹~%9:8ј^øÕ…§ÿHÝÝ_á—Õj<ª]h£¬µëHø£˜¨²E~u‹ZEýÓtÀ +¡ÚÓ`é‹We[‡VWšw~LjhJÉO‰Ð/”þRÁ$ŠFyNk®2®¾ïVcÃâÓ,JðþØŒ`8ŠIzØ%˜KÜtÛmüWšwð8›<Ö‰1LÉÔòjÅÂo- +~¥Zº,š6,Àœ±h¯ºî–TÜì“ß¼ü†2“#϶©ÕÛ!À\+¬ÑènR,Š O–2Ü'>µ¦ŽMÀF(RI>»–—ÿ!¾kæxFP|ó‘¥LþQc—ÇÄýKÙ_„‹>JÅf\tâœÙuë¼u_c…Å'ª3-uÖ¥"M@äë$Ûd²ê£© Úšã4bôÒ‰g$ò[5N¤“‘“#»Óè ¹]®Ð\êã>ø‹¼…«Ë s0Lì÷¨ –ѱ¬AP7Ž«Þ[¹C”¬éJ¼üˆåÇ·Š8|âg,gÀmx¤oIÙ“¤’_û£RÄó²–ÂV*iô£“öJ
íï,7
L˜ÛŒ(8ï„ù1)ù„¿¤æô4šª&šGã ‹u¹³³<Þ\nbë!~•Î¾Ø¯¿<¥Ñ äŠMY¦L^Fäó<c/ŸƒoݽrÛAöv>çž_~kn¼IÅ£ÁáÜ éùðXîl¤œyLAy‡L¬4“'ùÓ´Bƒþ?³M¦ü4»rY4Wç¾gÜÀïÙl†ºÊÕL›C`ª-vAŸDÖ=±æ–€õ¡“w}à«v:”Ouâçjx©üPky¢HY$¾Ê»/Ë«R¡öE«Ãñš—‹Ý²oȨ¾Ö²•2ÅïØíŠí]D¬Î*¥¾5f™â›Ù ©Œ‡8½z¡“ÌY€½™w<6:¢wðþ&83Òr?6¹ZSþéuE^ÊÌMÆ0a<¦ ÜÚ¿K’Î<(¨i‹ù«9¯®0&Mª(4ϪueØ^MrÞyÎâN{0ž³`ðI ¢ø¥-ç®YûU~LWüáU^‡ç°6_ {™;¦q«®Ä R$„®ûˆ¾X)ɽҢñj£~ %LŠ~õ%º«n–áö×±Ùbs®óT
F¥”g9ÁxEw|S+êN©)֤Ɣ(Òe&”>‘ÕÚPòüãZ`m8óSfaòŽîÎŽÔ0¾Ú–Ȩ#3Lª—ŽÉ™_Œ õ +6¤¯ƒxº¸aF_DØé·¹—id;–
#)*I,pȲÛûu¥8ozê|?¼[8l?*bý¡%ÿýûˆ 0„%J‚’â9âŽñºGšÅDËÝôiÅx³ÈÊþOñÊ´!-ÃG”½ +#L¬’“oI÷*B›õ“at’+ë´és'ì”Sù,}–fÚRvE©¥çr=ÚÒddv©|¤Û
È&)…ú5±b§„hÖ‚¹83[¶;×XG'Œ•Óµî4áæ‘Pzù¦÷aqzÕÓrk^Þâ‘þk¹ô¢Ô}-µ—"$µÖ!{,/z»>®ÖV©RPMÍÊ…ôª‹ùïÊÔ„ubìAl«M‡à(Lí²™±çYŽx#’_.ëF-Ù’f¦/ŒÅ¸&jÂUôÏ@jS¹³Q…¤oãeÜí•$Q!Ìš¾\ö0Y‚Ôy•NBCŒ¬—a&}¶~†ÙÉo_!ÙŒƒçän²q²*ž2Ù¥}6¼-à•f~RÉ„ãVÙè¬X[u>³CeÞü +^8™÷YÄ„Íl̺¥—:»©6o†"Ô%n~{çô¤€?oÇÎ
tÀk½ÝŠDÚ"ö€?olÄ(0ÑÙ>/AÅ~½–œÃ¡³î>Þ%˜4}\E_‹Y7£'V?rÚME•8¶œÉt;/õí’Ðý<#5èŸÛ.Ûº>©ÏwýB/ðIX/°¡–õÁÕ NZ‹õòÞ‚hu)Ù¡±˜_Ña#4©Yõ¢jn„‚æ:׺h=LÁÖH<‡ËøHC“9¯ø¥}646]~:Àâs¹N=2 +Ù¡T•gDLz|ŒGÙRk¢‚ŒgYYi.+uÓ©fýÊÈ/hg°·Ú‹™O˜}ʵQ“Qš²È¦Úzü.ÔÃu-AÎQãYçe³Ôîz“¡Ï€ÿ`ËË#뛬tLü¿üáþ‚ÿ'¬`ÂÅÑ„°ÇõF@.Žˆß_àþ/bâ’¦endstream endobj 848 0 obj << /Type /Font @@ -5432,14 +5422,14 @@ endobj /FirstChar 2 /LastChar 148 /Widths 1339 0 R -/BaseFont /IOZVJZ+NimbusSanL-Regu +/BaseFont /NKCKWQ+NimbusSanL-Regu /FontDescriptor 846 0 R >> endobj 846 0 obj << /Ascent 712 /CapHeight 712 /Descent -213 -/FontName /IOZVJZ+NimbusSanL-Regu +/FontName /NKCKWQ+NimbusSanL-Regu /ItalicAngle 0 /StemV 85 /XHeight 523 @@ -5455,13 +5445,17 @@ endobj /Length1 771 /Length2 1151 /Length3 532 -/Length 1710 +/Length 1712 /Filter /FlateDecode >> stream -xÚíRiTSבª¡¬2©¤j=,ŒiF
!¡€DŒ¢až$æÞ[’{éå’2ˆ8PIU–EltÉ(*J…UE (µÄ*´€i¡„e-Rµ*N½`]]¥?ßûõÖ;çÏÙßþÎÞßùΦ¹…Ë"Û -ˆÃrÁÐ 9G ð+µjÀ]Ø|!o™Ç§Ð@ –¦Ç‘<é$>i`QÈQ •*XCÖPÈÕ@†)˜Ð3Hë&n¤ƒup:ŒgÀ“Âá -ŒïM>qÓóRmÃùª çڂ鉦¦ààªEM3±ž€¹n~Îó}f;ˆ,@µÓ|¡[Wt_u6Û‰7>¶à˜Ðë@÷ŸÁK"MǽäÚnž—º“y?bi–÷ï6çÂj“õÞµ'LßÏY²ŠÈf¬Ý›z¬&¬f›FÿH0kÏQAýCŽMyöÙ'¢¦ï”ex¨óÛøt)½¶þrí#¡(üye2õ?ÓÒŠâ¨åøXV÷Ìšõ<Ÿ„”WÝ~‡×¬ÎÚµñÁ£›Ël_OÚõ÷¨iâOKr_oé ÑÚ9Š›ÚãÍèÝ£ÆÛß÷!‚Íg:jÝ}c¾Zì×B;ÿË芵®£2"‹Žõ,´î§AÍ•šZäb¹ Oñ0»š¤ÎßJž¸¢¦æ4ö`‚vè剪’(V®¥gÅI/7bÕh¥•-–œR/µšv{úèãWËS|Ó«¡ü†òÿŠð¸‘Šqß;]ãÚ<çËÃ…?Ÿ^&UJ_ÇËö$ÏUfêus2›ºJç9”ë[N¯ÉúœûÅ)Cã&«9øjI8ôµª}Û5ç+¡QöÎæhŽûìHLG¾Í»9…+©ÔOPÃâºQݾºÐRKß‘3#ß/0Ýñˆr-—¼²Žªl·.K8Ä:5*ë
»/TÛ¥ÄK#òm·’6¯’Ö5ße·sP•]Ü5» yÆü›~ry´$CVñeœß9~~FÔÙ`^Ÿÿ¬oÝ©()çÄ`‘¸ú@Ê]qOhö3ÿïÞƒÞ±
Yô8úŒ±°à¹EÕ{Ú»¼X2t¹St³u7¶KÝT]Z°[:»Æiý;!‡Ú/¯:øîj/nç}Ò6F]B¼xr©Ë×úä"NP·áaH˪L=Ü‚Ù¯îmtjógæå‰Jº®ïV%5t\+Ëû”5PÇÛªöÍâDæ±üÚfà63î}p%öÓo’«ù£çÅ-‰W{>Y»ƒÿœȢ'1äÄŠnÞó†'™á‡ò«¨µýìÿpQþ_ࢀB
ËqÓÈñTÊŸ2Œ‰endstream +xÚíRkPSבª¡Ly©¤jÝF‰Ü<5„„1
‡ÄœrJr=œ@Ò +·€/Ò*ÂÆk‘ªUðÕÖé”þlݹ{ÿÙë[ß^ëÛß^4HCaàP%&G‚¥R ‡
È3›M¡Ñ‚qXA ¢ `!à>`¥N¸Ë +¤ +B
kÉJ…È0%&i4`íÄt°N‡ñbR8 +M:<‰Ã(4U éߤVp´L.‹ðþýk'“‘ +%¢i0`ÿÁžŒ9ĤI8¢ñl&›Í!‰ä~{JœÒLŒ*1AS +8¼ö`•q×Æn._°}=EèÐ×Ý/ ¦‰?-Îy½e¤;Lçà,nl‹·¢wšoß‹ú7Ÿ=è¬óôýjq@3µöüFW¬apUQF¶&λÀ¶oœ5UhkÜhÛÀ¥ EŠ—ÕÝ"uýVòĵ4¥™¶…´C/OTËY9Ý+Núx«F+„¨l±ä”f©Í´ÛÓG»<Å7¸Î¯/Û Þ*\7R>î§s\—ëzy¸ ý§Óˤ*éëxٞ乪Lƒ¾cNfcgÉ<§2}0ÃkË錟s¿8ejØd3_-‰„¾±U·m»æz%\î¨ålŽè¹ÏŽÄ¶çÙ½›]°’Jý5-®Õï«
/è=²ãbfôûù–;^r÷qñ+Û8yí`›miÂ!®Ð¥AÙPgÚ}¡¢ÈñC¹&/‰ÊS¶ÞJÚ¼rHZ[|—ÃvÎAuVQçìü¦ówlúÑíÑ’Yù—ëÎñó2ägCy½³¾õ\X¨& ¤ìƒ…âª)wÅÝáYÏ¿{zÇ>ddÑã˜3æ‚üçêžÓ¾eE’¡Ë¢›-»i5šÆª’üÝÒÙÕ.ëß s:ÔvYxÕÉW[Qï“Ö1êâÅ«ø“Kݾ6$rBºLÚWeBèáf,ÄquOƒKk 37WTÔy}ç°:©¾ýZiîOh´¬ž:ÞZ¹o':—Ð:_(°›qïƒ+qŸ~“\Åï=/nN¼ÚýùÈšüÖD=±¡ VtñæX7<ÉŒ<”WIécÿÍEùÿ‰J
¬À L«ÀS)¿VŒ¯endstream endobj 785 0 obj << /Type /Font @@ -5470,14 +5464,14 @@ endobj /FirstChar 60 /LastChar 62 /Widths 1341 0 R -/BaseFont /BOGBEZ+CMMI10 +/BaseFont /CUSVSK+CMMI10 /FontDescriptor 783 0 R >> endobj 783 0 obj << /Ascent 694 /CapHeight 683 /Descent -194 -/FontName /BOGBEZ+CMMI10 +/FontName /CUSVSK+CMMI10 /ItalicAngle -14.04 /StemV 72 /XHeight 431 @@ -5497,37 +5491,33 @@ endobj /Length1 1624 /Length2 5655 /Length3 532 -/Length 6501 +/Length 6502 /Filter /FlateDecode >> stream -xÚíWgP“붦ˆH•Þ…€é½ÒA¤W„$$¡ƒô^¤)*½Ez¯ -"]št¥H“"Üè¾ûì3ûž_÷œ_wnf’ùÞ÷YëYåYßš »¾‘€aQGÀ1"‚² -Ä@df0@ˆŠDdddˆ¹ -êàˆÜ114ãåç¿û×Í/€×ŸÖ
u€¸±îéc°ÿkG#€q„ - -µpÁbX2}ƒ¡ H -«HMˆZ¤&T °Ô»ÓÚ¯É|ˆÃ¹H´˜ðU wÛ^~ù²wŸûTSþ~lô|mñîs^ÿT¨õ
2^2ñæ';•,ªùi»½¢¾8còû;;ãÕt)t%«Ð2Iv9Þœ|qANzLb·’Ïʦ9iÝ,vç*¡:ÔœÃófÕ@Ü8sfö¾f¶é¾¾²ØO9Ý¢‚ÔŸ#AþWÉæù¢%“JÉ'WN_*é™TÑˮ̛?£ÎžUã7Væ) -ÈsÚå'Õ¬ó¹e -–jŠTŽ¢+¥°7"ÉëO mÕlA”2*ÆZÞ 4é›,•ßô^>œ…fiò
i¼‰šà6õ‘”è\ˆò@·¯›×e³Ì[ŠVÏYû -Ž~sƒÆΩ˜ä˜¤Ô;ÅK“ŠfbØ>ø·xúÕ|®ºÓ5ú0¦9”ÅÄéÇÙâ㞘 -y%œ\Ö¯á5»Ž¼eÕ›ËEÚ·%XØž´ótá§Y»Q uVŽ¨º2·4eßÙêÚhJia¤6[Gö¨‘;Î÷0}H½Š3d6År9Ñ3:`¢H ”–«Í¤h~‘ÓÇ%`£ÓµaÖ8"N£KwŸðEˆ†wÛ|Ú2{òËø¹óJÚœÚ9ÎÚšÉâŽ|J9¡©mjÃcpMÛ!â”×·ÇÞhr'ntk>a;:´|¦K¬ÿ*M/xûðá[#Ç< -#xr‘>Cþ]ÅKpPÝ…qNIOu¤ƒ£W™Câ•2tXêùò!+ã5ÚüIvº|eÎ7úCâé×Ö}hW…àô"]xN2RÌ®%d×mØâÕ²U}O.ÒÇáQŠù —ÒúËws 횉3¾ï sû}´f_,â[‘<7ûWÞ(ˆyàFžÙ½JË)èèÑÅÅ£§%|¦TAÞÆ"½ˆcâ
‰cÕZ©R<á®òà^Nç•‹x›þÓÁ{gc°G±$§ãˆ(ÄÁÍSú~ÃGBüò³èò
w8“aÊeû°%m²°‚3ì-b?QÈã©—2W¾×xosL×Ð]Î,[Mbh÷Õ@F&·1Û=ág½ú—•ró¯ 49|Ì1¹ýùË+¸¥-Ú`ý|¸ûqfH‰+ñ´½6ÛîHÍæM¯×Á5!¶Œw|zz_†ÌL}'ŽDÞÛLÛeœAl2¬“¢EÕÎ4žà[…¦»¬>Ç}+[ÆK7û¼¶§>À¥(§ª`cWß”zÞÈ Êd^ãâÖB¤yõ¹ýyìÈ”?UÓçþÒGÞ'ñÖD0|„ÎQš~æææ^‘—qVAöáA Ÿ
ác³©3&"Ðç.R[qöiœ¦ãc¡™ƒÑ -§¨ñÛ -.hŸÉÝê+¶GUÊM…d$Y¦’³¾«†@³ØÞHÜÝŽx¦|ÉyíƒÄëGV3O›Ã}>;l½^TuÒìÍÕÌ?ÎóU©¾Û!CóÞ¨oäM¼]_D´¨„ Òã\-qÿX”jÃ4ʪ[àÛÙJëzx¸d}¨œ»˜'õu ÆmQh.áG$ZôâŽIÄ -Ù®+}êüþ‚`ÈKT‰Qhº£Šéè½QDn€@Uv÷õ•j
µ@T|›˜z“_ž•ãÕj.jY$]¾~Ó}vV€ºðx_U©• xÖÛ5þTô{æš3(Œ—’dŒo˜3tAÏÊʼnٞ¥rìw̶tøÔ/u-¹˜ÎŒ§¤¢×¾>#]óìû¨v…é%²ûŸQ£Œãvu'¯” -“<òVŸ¥4Ž±¥aáš$4.x8¬˜
BSPx§àÚþå»JQìêñ7Ç3¬ûȬå
)ÙÅÑO{F^jû[PßœudÛc ŵuºíF ?6E6k}åÍS™¿¡få)êhhZÑîίFšIŒÅéÓ#a,¤k¹1±tŸ*º¿qÊ’Bp%v2f’N«=…ïhS -&æe}S -ÝY/;¦’ÁÁ8Â×MÛrë,Nys<Ãd{Š$ƈ
7ègï¨0“—«âô\úù‡
Êj+½Tp÷&{[¶Ÿ\ýƒ9ôµ"ùÁ`šªr”v°_ž˜†7½—û툗¸ßãµx—aÛÄ÷çñ¾b]Â.áxæ¦ÆEz\]SÙ$ÄoZzq -Îî_›mgUÔßÂc\½çNÉ·å%bsG£]ô!¯ýe1JE"é¾ú¨ã˜Ë¡ÈBknÊT|©fø¯¸¸¥¿<\Ê‹š³È. x#Ï›qsƆ‘I)_TÂ;ʯŽršØ¼|9ìRÄ&„r€ÂYGÏ -.lo& -AlJ¾&±$)=W ßÂ…±úU}IóJ¹£^Uþ'ž÷ã=&…7ŸŽÃB?Þ£,|
~äº(q•Ù ìÏ%_úÚÅÕxËâ0² -¤qfòbëéG?vCo¹[ᡃ⩮´ÏƒõÕÁ§Çåž´ò»Ë;¾WC#$#}רÂ5F¬ŠeJ»:êK^Û:ô)F{àN÷míçîâ¿”M5à¦9Rq9¹:)1H6¯fÑ« -Ô+¥ž° |¾H5O®v§qÊÓÂÃ’±êHGÞ`ð!oÊ?¹1[E±;ª Ñ¢ãªó¡î^˜žq’jíØ8e_PÕDFœë¦>Mà„XÍeæ‡ÇqJ@ç¢K]ç~-“ûw—Ç^»$Câ}j×kzŽ tî¿c?ð?ˆQ54[f¡ƒ+ÌN¥Ø‹þXZª\¡²ï²% -(Û¼«6·gbâNªÅe¯Vwí.eŸœ6*6ZúÑ´Ò'rˆpðè~6}†XåGàJ Õ}5e–Z9‡ˆ ¼3&58ÆŸ VGhè}ßuj -• -ö„Ë|…K -µ4v_yF¹ìËñR¾à@ãî6î†4«•'ÚmËÃw»ž¹—†wX^Ê©ÚM<¿‡ž£˜#þ¾#r¾ôÚç§@*׈ÄgÛkdU͘ÕxOù·‰ËYµO
F@V2Þº7Ût(:?¬©Å·j}°<Þñ'ýêÝû"Ÿ0ÝKyqÜWªd{ðbÌõaúS˜Šæ3ec%sá®Z$±Î(•3›Ž[‡äš½ð¿ù!þ‚ÿ ˆÂ \€(gâÿ)C„–endstream +xÚíWgP“붦ˆH•Þ…€Cï H‘^B ’¤JïEz¢Ò{Q¤wDº4éJ‘&E¸Ñ}÷Ùgö=¿î9¿îÜÌ$ó½ï³Ö³Ê³¾5Nc 2iÕ@"°@Q!9€ÌÕÞ£‹Dܪ á}{8€$IyxTÑP†D¨°P9€9Pƒ‚bb +` +PÕ7x § ¸¥©g +Є" h`àŽ+¸C(?À‰Àÿ8 +Šv…a0¸g +ÀE5PÓø#O¬û+6†ƒHœ% vÿUÒoGƒC± ÀB=±¿bÙCyábãÈPhØï4Ü10„ã_Ü ¡Ž 4Å`p48î_Ýù«NÀ?UB¡à^¿½‘¿þ‘‹Â„HEÅp1ÁX\lG‚Tø×°h# + +õ„‚I§>!Áò!Îé™Ø*ÆœÞwjVí¢„½¡¨ÂZ“ùÈ6ÿôˆÙR»óÊP¡º!¹‹7^㛨Ÿ_î ¬ô·3ÀùÚR¡Ûyl~7ù;ò©çx›¤W‚„m +)2¶Ìc|v>ÞŸ¿b)%b¶²øÎÐȦàüê¡&qôµcþ€›ùtÜG(ÊÇà´š'ôÍTux4UÏ7·x“Öøºßöõö´íu|a|ö„„GÞã +ot€Û3V%KÓRŸHnEõ·ƒÔdÖIÊC\3>#=dñ9f$s©GŠÙá© Q´ÄŠTÖú·ZûµXð¸¨@–㾪ácî[ ‹/_vïòžh©3Þž«-ÞyÆïŸ +³¹FÁO!Ñüøcǃ’ ?× —´ç'uì Aç1‚š.Å®dUz©.§ëÏÏ)É‚©Bì—óÙ9´&lšÅo]&T‡Zpy^¯ÚƱöheïie›íYªˆÿ”×+*Hý9ä™l‘/V‚5”z|9îü¥’‘E
³äƺñ3êôi5acež"(,ךì I{?#ë¹ ã*n«CÐfqa§òXFÓHñ´´E@‘”×µøêâÎS¬w‡Â8jšÚnPD¯™ÛÇÒyˆy> +²£k˜Y£Wq0³ŽSÓû¨Z2?ÌVÝùÝæžcöv´t]cÙlp™±Iéµæ°§BTlk¯jiŽyØÙ&,Ì‚Ñí¤G„?»ê˜“b‹?k˜A!ÛÄÛÑi‘;§f¾†FÉÁŸáßBÔ¾¯¹<¬et4Ȩl˜³óQÄ{likKþIf¨±©¥B×2é¼·Âp~²C?+Ê¥&©ë
xªQ@J®ŠÙRN§Añ<åuH¢ŽiZ{Ô¡ñVmî-F_MŸœ}ÎaÍÕRG×oÔ?Ø]õ¤¤'x1ž¹í¡AI±nL^ãW’qf·•zªÆûuaÐd^[ÿŠ-/YÿãØx‡ŒÁ¬R¾4Ù7wfó¦võèFò¤N?t +0r$û°Ow¸"änÀ{µµSo'¤3^aøMFvÆe=í—öWkR’V<Ìk1/TO¶+ßV]1¦vó•»ëE¾zä0ê9;bußSE|¦^za#(ÒU³¹Ê¤î²!$Ù¹Ë3!§ þJóT@â,öåÝ0÷7{#éÍqÛâŽwBêü§Jä,çwi-¡eõ¢ŒÐ¶‹v>ùáD×£Ö7ÑfPÛìì¼òæ&¦žï“1Ï–x^UlXÜ° ÆúK
]Ö® ¾iÎö<sœÏ šÍI¾ûð9ß=þmáv6žùn]Xm¥ðÒûúàéšó/UŸ•ƒòœwÉ
ê|n˜A䪚"U¢J©ŒÉòúSB[µZ¥ÌÊı6F׈Mû&J6¼—f`YZƒš¯£ÆyÍ|¤$;çQ0íku™ÅlsVbÕ³6¾B#…ßÜa±³ª&Ã9¦)õÎñ2äb™XŽþÁ-ž~5Ÿ«!>ÌiŽe1qqv„„‡#ÇfÂ^ Çõ«ÍnÃoØõgsQ¶"m –vÇí|Æx”i6î´è]T"ª.-¬ÌXǶ7»Ö›RZØ ©Í6‘=ê”Ns=L‡Ÿß¦Þ Å4Ÿd»ï Ž +0U"NKÕáQ5?ÏéãÚêv›7KÇè1Ü%~¢éÝ6—¶Ä™ü"~ö¬R–>§¶@ž»„¾f¢¸£D—Z^xr‹ÖèRÓöE˜4åÕÍÑ×Z¼‰ëÝZ9¬žê‘¼LÓÞ:¸ÿÆØ)ÀÝÞ¤ú8-w«Ž†åø
4fEN´ÇF0Ÿ~T«m-u¼9`©ªX⤙¾¤¯½aèlŸšH +:Š“M*'K*l¿Cxs‘ãy}M4Ö¬•‹§H¨"žÇŸ3lØ
îd¼Ñ—=Òó^Ë›ÄüärzQV2·R¥Ûŵ®Ö2¼Ôß÷œ&²X>§ÖjYFL–b°_B7Ô†
èÉC^òó˜Ö„$WÐìïœ3MU™“
>Îþ0}oíËÎó6.1-I¹(Ô×NLÅUŽÖå%V–ÞÛµE8°¢yENðáŽ[ZŠnøÐs&³Sûtþöß5ª=£gÁAΞ9ayèÒ²¤LRS-UNXÕ-/€xoÏýݸÂã›Óù 0@ÆëýÀÉæ'_‘kk‡/c¿wÚ_~l+ÑèúÁRaG‹«ÖªÕÅDw«O ݵ‰ûcÒ)$gBEÝÇo(Ù x27*=‰ÔœGzÌ/,>7fyù+×OTm×D†šN“FÇ¿æXÍÖhÍê7MÍ[ˆÇÄ"ߤȥÒ#§<ß-ÕÀd;Ù–¿ªu®È^{&ßàÒ>|˜´Ú)J>ê§ù]2DM¯ç¹¹¼£¹š1ny?:ä… ‘TvîsÉòžºo¾Õ|xz•Kµ¼vË;d£0gñŒ‚’u?¾âuzÃçò,I]–ábÛÐK|†$ã<05ìçÞ.@„«Ü'¥ã¹z<ñ6g¥õ§ÚO²Ê}9k
âSvÖ9r"÷[‰#z«zu·ºìFÂo¹jÂrœ4»@úï§0óI$0åßVº +rí«¾Ÿº‰‚N»Ê`çÍyywȯU8GÝìPteÂÈúLìT_r<¨Ri*¤h%Ë2“šñ]1™ÇöFâïôpųäKÍioí'^
8´ž~ÒîóÙq}ðÕ‚š³Vo®VþQž¯jõÍÜ™¤º÷Æ}ïãíƒ"¢Å$MQÎÔ3‘w¶À©¶,#ìz¾ŒÁð®û‹6*¹yÒ_ßÆ8a-ŠÍ%‚ÈDË^üQÉXa»5åOߟ
z‰)3OuT±¾7ŽÈ
+ÎF¾šËð©2Øý[ŽŠ/Õ°ý6c:é¤ÚSä– +Ø–4Qj[’ð5‰-ùKiÝhè™"ã&>œÝ¯ªèKšWÊ-ªògxñüï°(¾þtúñuá+È·ÉËÌ`|é+W7“M˃<è<ä†Ø:>ªvµ]¿$ÙËj–?}Ks׆"«÷’çu ¾ø ²=eª£u)7›QzLÆêØôÐÕq)ØVdì&Ê{¼fàtäÙ·ÖÎýU¼ïvÙ÷‰üoWTO“Ït»ÄŽCJò"ºÌ´)æi>5ݤB©:½¾HðòêJ¦.sâÙƒŒG4º:!ÃõTó ðDyÓï<ÎÍt3”…vÄ•Q7ÄŽÙÂ,|X-²È¬rû©e¯§ð”/ãí3Ü”±É‰5fZ«Ï¶Jò(mXX+Õ£Mµ¹{‡ fioƒ“ήsM¢“,.Zâ•}õ~ŒÔûfU¨uéG ÊħÍø ùYÙ´¼2Ï—÷ éùÜ“†g=ÝE—.±XqñQ3å…5K ”{E¦ç§œªU¯®3Ëy‹/6Ng¬ÂJv»ã¤µpKO£Ãç2[aNö»fÉkÝÍ©æy«;‡ÃÛeáózœ.÷økï…Ôà¹p*ëvnm×@P²ò0M.•–Ο…µ2T:v@%¸÷b’¢éóóqó—™SÛ±ÒûzÑú&%çy=:Ï=–ˆ.Ô·7µWnÝï¤ÍIÚ?éÜ=ñËÌK<|×BvTj]ôØÛ!‰
":Ö÷þB1‘ùäZ-ýä¹ni™ó*å~mqWßÊ7“í7ÃÔ;×hKZFÞÀU,§ãJ²†EÅthA¹1KS(ÒÌä…Ö“~œFÞò7ÂC$R#ÜèŸ6h@NŽÊ=év–2¶±–/‡É†û®Ð„k>Œ"Z6Ï”qs20‘º²yàSŒy„?Õ·´Kš»CøB&4Õ—îPÕõøò¸Ä˜lQ5!æ_7Б?ëne¢a%j[4€(§³!}¾H7O¬t§rËÓ#Â’qêÈD^cò¡lÊ?¾™1SEµ;¢(Ù¢ã¦û¡îN˜¾I’Zíèu_PÕxFœ0û†]à¸xÍE懇ãqÊ —¢=:—~mÓ»·—F_¹&Cã}j×jzŽˆtï¾ãÜ÷ßQ32_bc@(ÎL¦8ˆýX\®\¦qè´£‚›¨‚(׎¦«C*®‰\·á[oMÖÒ]«Câ ¶øÌåªju ðÊ@
Y´õ-klœUǯ©3«7WÃõw-b^yÕ +@õìšÅ£7¯¸/.ΘlÆßGúF„9ÌÊ<ÒY¥±ªØ¾«¶p`aáMªÅç¬V«wë.᜘2.6^üÑ´Ü'z€t|Ôýtê¹"ˆ,À—®ûjÆ*½|ECù-§MkðL÷?¬ÓÿÐ7þ¾=âÜ +{î_oŒ +ð]Ùˆ/;kÒç'—ëÜX:[æÓoL/§’išOÉ]n»\§Úõø@üš½§3ŒÄë»r
•u†%`2¼¸ˆ‡ÑuÌÌa´åæZôõúô„ÛÃrŒíûÉmwAq¬Ë7ƒÊºŒLÀÜ;_õ°Ï%®´SŠ•à +¹q¼Âóá&V€œ‰'mel³m¦lÖõoGä/<¤ŒÌ.ÝŠ¿ÝJóe¼‹-êp»Š˜IŽv6 +QÅ×o,_*ÆÈQ°1ù{i)SBôZˆ9øí2(¡5÷œIŒ¢ø‚ endobj 711 0 obj << /Type /Font @@ -5536,14 +5526,14 @@ endobj /FirstChar 46 /LastChar 122 /Widths 1342 0 R -/BaseFont /UOVQFR+NimbusMonL-BoldObli +/BaseFont /ONPDMP+NimbusMonL-BoldObli /FontDescriptor 709 0 R >> endobj 709 0 obj << /Ascent 624 /CapHeight 552 /Descent -126 -/FontName /UOVQFR+NimbusMonL-BoldObli +/FontName /ONPDMP+NimbusMonL-BoldObli /ItalicAngle -12 /StemV 103 /XHeight 439 @@ -5563,37 +5553,43 @@ endobj /Filter /FlateDecode >> stream -xÚíwePœí²-î<øàNpww‡à>ÀÀ -xɪ&%óW®6f®¿s»€^`€£Õ‹§¥£…Ûï–þ`/4/¨«ÈÁà -ôpýË°¹@Àfž/¹_È Î ?e¸¹€¬ÿU3Àhmæl º¸¼Ð¼pÿ¾õ øoÝ›A `Ï?ÑŽ¼þYÈÕ¶bEaçxÉiáú’Ûä€òæ÷°È;X9ØÙþ²[ºAþ¹ÿ\ýï™ax)ÂÌÒÑì °Z¡¼Qqt}I ÿŸ©ÌúŸù? ñDàÿˆ¼ÿ;qÿ®Ñ{‰ÿ·ïóß©eÜÀ`3û—økÉ -3³=ÿMàßßÿ*ö¿øþË»š½\Š¸ƒõ‹0,ì¬l™A.2 ¥ÈÕÂ`e~¹³?vmK 3ä -•I»rX<¢X/ÓqP½K#ÇnCøT¢gW¡1»3Hë,ì;ëCè´:ËOq"¿4¾iY")ªHðÙ~ ”bmo½[»Û°XÈ‚p½..;¹ªr7ó›~X=ÐI¨ÐԷΙºw|7y[‹G»¼Häú:!ò,£ÎZo ܉À¸%˜8çcwÂ=_ª½/”i†t³ä$D• £ç.Æ.Fµ°p»B‹…jU|ÙÇ.9 -!>*¼‹B×0ÉÑÛÿḑÚsäëÑDn‰VIïÌòœçÐs|OL²ÍC]z·ìÚu×K¹êwÓ´“|"$Ë;Œ’gl ½Ù2%±ž§,‡øjTàrÞ …C"Õ˜)b‘¶OJjÛì6»G/íƒÛÌ]#_•rÉn!Ÿ7\§<®tŽ6 ¿cÀO@Å-¸Š±|Ñ™4EÄBI&l9%7Á¥ƒÚýÅl»ðsJ–ÓWÌ›wPÉç$J$YfÎ< -H›. =øÁ¬lª2Ì:ÿ³aY{n1.¹û¹ïvõ›Ð6ÔZ®MP,øZ)ä>9”eâŸÝ"¿‹¶u9„ç}zFfÁ4~qÓàuãe68×pLªdB³«u¼…hl”K)s¸Ó4%¨jBzDQ¬Âɇ‰T¯ÎÊœ÷¼®ÛÞ„6°MÍÝ‚*èmâçõ|L‰×n¤Í¯t»:«šS"¾º˜–õ~‘DŸ¬·¯?Ùó-í«ßT·ñKxH&ÔôHõÍEÁ`¡®£×Råâ¯`VæÉ-‡ñ=ô>ÀmWë÷ðxà³ZV:¢u¾£hÆ -†›`Ñ”8ù^;â2ùdâ}8Ì¿”‚8¯;-æg?µMÃJ•«¥•G0P1`¬8ÈyÊý˜ÝR+¥Mí‘LÕF\5l´}I7|#ó#EH—{1NègjòëYìWv™S’ºm¸~Îiªiï}ù=ÄÛZo¾Zmq -M¸^,4ój1ÝPÖ-ɳ÷ñ…ûëU_)Þøþª‘sf†·”ÓO(1ÉW˜3*›‹ÄàõùÈ-Kw -IŠ•ëæ)Mj›·còb³ƒEO§)€¶côs¬ûTÖÑ×Fq²°J0ÒL6R&¬ÑºÓQ ÝP}rÁ•ÖAmB„ -çGø“‡8ë÷ß“ú°ÙCÄš‰– ºóV™CsØ!H‹Ðæòüo’§¦c¦‘™¨Ð9þzNÛ›W#>Dl¸ã!y¦¶0O,þÀ‡Lì¡MMrNJO¸¥5MÜ/´W7ÊŸ´°zÞ¢}=Ù„ =ÁâG¬;D -‹…ð1·<Ü$á¸c[ýžêõPÎ!ùbi±Bؤ=ÉÎ_už2Xö:#?<íH„QØROÙO†¥¾5¶Žè"€{ÊXéµi+MÈájk»Æ°4Ri&ãŸU“‘è?Œ;óšƒmN[EÛwöãJùdÒ÷,Z\7½¢Ÿh”ª*q!þ¸ûXb%| edu:Òh8òÊ×;˦û0ÕÜf”‘rNTOî5û韇9û”,¿§Z™NÀGÁ]#HìŽÏá®[¯-«ê£úÂÍÎåš°×jž&ÛµjS›X^qnØÕ`w“û9‰nÔapG0;$óÉWn4 -Sõã4ÙHÝèšÏ5oÙØFu‘OÒbÛT õv]ë–;/±¬¶‡¹¸žfc±ùÝ( -³Ÿ˜p‰|MíKõIºG”®*L)Ù•Ü×?õu†¿þ2Û6éBFÐË›l¿‹S`î!W–?\ý#Òþ†Žíüp¤`Í¡¢â! &ïÛU剗ƒ8´a¨ðÏ]Ž \ð$tGyJ•°ÄöϸþÔF‘8 -ç‡@ô0S¥pÁñªU‡_Ôt›ô\ç.[ý‘/ÿ†+ÎŽVB}O êø}ž§á“Ë„3êKÃï¿7ED{ö¼‚FFQð]"Ž&Á«P•L}sûVhô°iöëš);·b¶Ñø»n¤›X‡å1éó>ndÞg7Åîì_Q¥5ÓίŸÆŒÄ>RXú ã#8Gl¯T¸E-Þù–eÙÁq‚'Q>D©Á.·C—‡¬ö™Õš#ñÕY”…ý!F¦S3çìºâÆa²OÞð<è4ËÕhB\ÎÛ/f–Ѿ39ó6©ÇdœÝ†ÒanÂÁÏ×áâ”>Ï€V=Æ]‘ïH}zˆ”T°¹Ýˆ“’<ðçö+•ÜÐ~âà<è?¥ðR®M :Öª—¬¯¤1ÕUÓ0jmƒ<ì &oÅ•M<Ã,Aí‹KoLÇ/ ÝžKÅ7 ¡„\¾Cêì+Í5Š(k£JVY+x°ÀBÚ€ÛHŒæó§è×+° -ªÇ¡¹¡âçŒ*Ä4Ê1h³E›Œ’ö -AÚ}EúL™9Q{aâ7 -Æñ&$¹€>^ícõý KLjq“O`0‹¡À›aceëbD²ÕÌ2Ë;ÍÌ*ø,GÃ?JFW3’ùü?ãnS_%÷nOR<ˆSZ}2HæÉÄ OW‹æü¹Îòû¬1ÍÕÚz@¡úË(#Q‰Ÿ{Ãô•B úÏÉ(K4ÆÚQ§ù•£É>êîÔÖ÷lNÍ´6çþá_º¥ÓZQO÷qÞÕU©¼GÀ1XÄÇmA•‹»NOo`#}³©oIx³!ŸH˜‚±¡{»gÿÎ~¥;_ª1ÀPc”ëä㈠1…áùÏ0(¾½·< -¤ÎLM]Êó”RZ{·¬7ú숹4áîf&Ô·ˆ‰ñѧ¾pº¾îÃa)A\‹°mÈYØ—×w‡lʃ\²©)”u^Oªø1O§µýd†IBâp;>'óV(œe6W¡¨ÀÙYœ6f¢¢SÓz«ýPy
çj’\,ó, -r„ÚŠ¨½6w9®®l8ßqÃXGöZ#mè [ó&ä5…@1»¨!U[ž÷VÅï× -!Üéh¶xÇç©·žº[“7 -üPØm\a’sùàõ†ÀEŠu„h˜ûMÉßé5#NF+¯(•ÜíQ¥´vË}ªwì®åëD„È.Yï~è„*¬ÊAȦ¥oM>ëÃàž;!£%dÄeí‰ðˆz)ýþŠÃ¬MÔöõÇÈR‹[uYÊâ™x¶(ä©rLx¹d0±Ù¹9›Ÿ¹`eîW¬ŠjÍ`«
rëáeÕ0yg—¬ÀpÛcoΙ¨,CÚ‰–èÓT`T̽ˆl×-G定äÀ¯ð
7ëg -—³
B ìµÆ¨%"X€A§[c[qu½Í bTP9HÖB„³T)‚,I._’øÊÕ*ê¿‹™BÎ*ªú|zg»µï9
.±ÿiõiº:î&še¼å‘®·£ÔG2N¢†ŠBª½ûž
˜—¡¸õ òÃÚ÷¸N+ÎZ`•½%∶“^Q€c7|?ØJä&»sH/`ïÕYÀ€ÐT¿ï;1* N~•‰4
_‹¥x(øô».ƒç½—2â£yíÒ°»<÷ø]
‚É×bÁ¥è-‰ 4f¢i®À¬çûO_¸Ë'e7&„‘5¯+4>_øšq^Ú%)ú~Ö˜‰zsófbrµ®]ÒÙ‡ÊÍóI:„S©¶gšÔ¤-µD8vv»—RŠñä@á›ðšaÞèáÂb%dù-n:ù뉖GuÝ5XÁðýÊ'è‘~µn¼7¯ků°Ó9Kô§x–¡ªÙZ›* ƒâùµúk *«B‘¬®&œŒÖÏüͲE ¥÷À“ ϱô5w½S~A®}fÂ
`sÛÀ¦VŠ¢ÆÛ×<3ïu#¢’½§CH¡@w C0kÊây]A´Ðï…1¤]w1¡ù+ÀâŒG½Ö`šÀo<k@L±†ïBaéú?xÚÆ|ÓÄüyÌ%_A!Mçÿ -̱„Ѫ ÓÊ.*·,cßÐtG&½Ú¯—j©…#?åýªÈ†š4¨k»U±|\ó“3Ó–÷.ÐMÑ_ŽÈ±Â¯k%U†ypÁ“¢IÖ^ÑDå.ûdè»e89ê$µ|â}Pzd@ÈƈFRçzܾ“žë[ØCŸJ<ã´b .¾HWþÝ^iìÇé†prCm¼–U ”åæ½ -w;³eÅØ«1n®¯_dP†¨½1u]vë³Û«…××VIóp5í³bZù¡Sx¸¹ŸbQÎ -ƒé2Â?ÆT)e‡ÞsÂgä³Sµñ'¾n$•ˆ‡•ÌMæÑ~'eºÆ0ÆZGRã}깫í…:á}Ÿ@ȦZÁ`þ¥„$±Ûíz|pt©`ôQ)…&øº}”ËKÄë§
wÃ}B¸{Zœ5´ëGXž•¾™Ø㧾·‘·`hÈN#¡»ºx›>YÑq´Ã!¶#»˜4iÐcÚ9hÉÒä8VéýÝa{é<|l‹ƒ¬nÍwgΘ>îÇg¡8™,ÛÅêì-…¢Ëè_
¡È;EæÃÆÔöÅ1¯b0ü祰Žé“Ïnù˜ä›!KC·ò²
<™Þmì -‡B¿ÿ:140É+-ê@“ßT)v™7†?ÔæfµI†£¦Í1Q¥áÎUe§^3g£ÕW>/½E¬Vï€ÕTí‡íÆÕkuù²æ¨ 3Þš&ì¸ôÅÒ©6õgdï4m'Ç%M—Ô_Ëù•9d÷—„l,èÜÆ쩺{Ž¯³ŠÉI,×2KYÏad¢á¢»hn€#éJè8k–°£h•lHßiB_çó ²žÇ—ý°±22d
UÆ£º\0Êý -X˜À yî[`Ãv:fQeâ]´²ÎÛÀԱ.Òµš¹ù^îK ϸ½%£FTbÑûZ<…u+w^qÓÐ|¸#2_òÄrVÆ1§ãL^{.ópöyìM'eÂCYªj~“¦]»ƒÏâ,1–V¿T¼F8µø]…8éæÞ}ô.éPX -NÀ‰Ð+¡86œW¥cKñ†32Øj<5pÒF¥Dì^dÔsõÍÙÖ’€ˆ´-…¬Ñ5Šƒä’51©+Ô#â.V«„¼_¾
šÝ½ÑaŠ¸d—‡ïZív)—¬#ùp£´Þw—ÿÔÀ÷ôŸ¹@zô®¿å—þA·žÈFàQ=Á'ªî©¯²_Z»ÔÙÄη+YS0¹Êƒ”ÞTRaÖì¼¢9õ;û¬6÷~ØÅœ9Ä@J32‚àyð½xrʈk -Nši˜BîŒ%ÑzxÞºx†ªÉ{>™:æ«EøøH,ýw[6ûò¡]eh:hŸb¾q# -r€7È~<»ÛãÒ×{O#2‰”R´:?¦ú
¸iq†üÄê’JÊ€vÁÎ^öhÎ>p™§ý©ñ
êVݯi±ñ‡´æà¤|‚“}؆ݡ&û‚XÖF5Ä|R¢æ|ÙÉ +xÚíwePœí²-î®ÁNpww‡à>ÀÀ +hàà +ºÃ¡¿ŽpÊ!Õ×®ðŽdÚ©Û£ˆëIÌå1ñ:–¹M !LŸ+ÏS·×Ö:çñkÏñù È[œÒ¡±Tlü+Û¿-ë•øET×—mÚ<oR[¼Óf0ïw&±½‰2eé²G$QnXß´gÕíÂ_ÙM0¿³Ë]ûÛv¢^íH•%Ü’(ª»Mðîïp[¸x³ŒÎ¶imæéú‡¿ë'
Ú„ÔEÛ¬Ó]ö~!þãømýgRj$¸¤g2¤’Ä¿ïßæBýôQ2í¡8¹ò*Ö!rEºg²Y颺.€ú¡Yœày¢f°‚mÆ™¹@aæt˺—X[Y¶Ë¦’åA$o,çí„Ùš”ÜÝU—w3&´|!|—
Ã8¸XÁ⨡ +µÚ4‹î§AmëÁ$‘u]žœ¢¤é{þé
o)¯vzÞ·þ°ŠÇ~”0†S¶_EÑä¿XA^Àe#Ì”ŒCš¹þvৠ+ýƒ¹`Z¤†.,¡®Çsõ*haç"¿ñíéâ2üE2î$ÏOt:Š«
ŸÛ¨C™`öQÄ–ìëñçO¤¶"æ$:lþa8§}îsž©j“vå°yD±^¦ã z—FŽÝ†ˆ©DÏ®BcvgÖ5XØwχ,Ðiu–ŸòD~i|Ó²DR8T‘ð³ý@(åÚþ{7ŽvŽa±Ñz]|vJUånÖ7ý°z -’„Q¡¨o3mïønò¶ÿõò"±ë«Ä(,XFµÞ.¸qK0I4îÇîÄ{¾4{_(ÓLéfÉIˆ*aGÏ]¬]¬jaáv…õªø²!]J +jEÅÖ* +Ý–”èíC›ÇO/äÊBEQwÚüEšm˜§/ÞôRų#m ¨ŠçöØ +o<sW,³âVݘ”43>Jªb¯-ûÏ¥š¯:ÜÒmSÂcòªÄòGµ›½d–ÝÒ±çfÐ
‡ï*7? Œø¹éݦÕáˆú»2Âœ;ä!X25#ÐjÓ¯*™Zðg‰æ²M¦Û&=N„¡#‰ñô¤—l.gýiŽõŒ'S"œ+€êæíFý=õ1¸nWQ5’F”ÕØ#Äù4]P³sÀ‚Y~ך4Á†Ç®~„ír ݯ¨¨è&K‹F¶òmis–rùÐe'¶“ná}%’,Rñ|ë,ã>aL¦CÁ!0Y1'Ü¥çýüªPXXÊH<–êĨŸer¥¹ãyPå`C—@Gr›Ô!à–Áa•NºÎÄ{eBÀ…P}jlî'qþ z#„y ڬȧ¯úc
ArÅþÃqf§7ÅFù{ÂÎ;x’›¨ÇOÇ™œØνC;óA%‰|ó;ÚŒHö“IÁi²Š1€À+,lÙFl¥ÁxI¢ŠØcØ,ûœÐ×o±©yÞ<œ_4Žø&Ñ337c†u¯ëКuÞp¥Ò+¥ÖU´vûŒ±³Æ¡ŠyT$Aø<)^Ô1&‘»¿¶Ã†ídD™.w2ž¯œ$à°î„!ðØÌÎfíàUœÚ¾QbÓ“›Û™¾ù*¹»$‚ññ8Ÿ°íBŒaº¹?'‡emj#§„böm«]²x.+„ä¨ð.]Ã8$Goÿ“1ŸjÏ‘¯G…%Z%½3WÈs&¾CÏñ= é>4Méݲk×]GÕªßMÓN~|ð‰,ï0Jž±öfË”Äzž²"Ö,¨Àå¼A +/–Tª1KÄ"}žŒ"Ô,®ÿØm<n^Ú¯™»F¾*õ’ÝB>o¸Ny\ém< +~Ç€ŸFš[pcù¢3yŠ˜…Š\ØrJn‚Kµú‹ÙváçÔN_1oÞAM¤œ“*‘~à0sæQ@ÚtíÁ~Ȧ.ìó?–µçã’»ÿ˜ûnW¿ mCåÚÅ‚¯•Rî“CùW&Þ„Ù-’ˆ»[—CxþѧgT`&1|ÑJã—1`~ PVƒs
ÙÇ„ Ú)a4»ZÇ[X€ÆF¹”2‡;mS¢ª&ä GÅ*‚b˜Xõê¬ÌyÏë:°íMhÛÔÑÜ-¨‚Þ¦!anPÏÇ”díFÚüÚI·«³J 95ò«‹iYïIôÉúqËñú“=ŸÑÒ~±úMuk°¿„‡dbMTß\46ê:Úq-u.Á +fežÜrßCï£Üvµ~~1«e¥#Zç»×ÍÀ n®hÆÎJ/_Rîd{!ÏԺǤò3ìóðæ÷`¹’„¾%1íc-qlÇÙ‚iW¶tcL{þÂÄkIcl1‡E5Ã6Ѭ 3€wXGZ´/dÖýÞ=“?Â5¨r!>Æh~X¾2 +×IÙ.Ch’Ŭø^AQ¾f!2¥ý+RS¢°k¾R•]ÍmËç ëDuÙ˸‡è™¨tÓv-º'÷W¿6ÐØW#ŽÛBÐô6Qº9É&˜7`~b8Ìêa²Èé’gΧñu NvA —’ÕW”Ÿm´ifø!:ú4$¹ ÷p_£¬eæš÷ײ‚®LO„yÆ0Ž6O Û—‡œjæýgWp„å^eÖTiDÞ6}Óû—FrV=+ìs¶ÔÈ·Þ:Û;§)^O¯©ótoibçWÒóÑ©„#þ²])Š2ã°À7
-ZC¨JBöjü +|Ò‡b9¢Ý—B”Óeß¡#Ï^+X¤½š^Ô€ã„R|ÿVöàÕâÞ¼ÒDNètúÁQµd¢L¤–²ž3TKâ³°Ñ.ëÚÑÕSÜO3†<—7?¿t—Æ<ôÆè¶?„^K”½û‰ßè€wºÌyÕ…O=ÑaÔ]:»4aNÚYW¦$ñX“S +sÆ@es‘Xü>¹eéN!I±rÝ<¥ImÓávL^Vc°èé4%ÐvcŒ~ŽuŸÚ:æšÐ(^V©FšÉFÊ„5¦@w:¤ªO!¸Ò:¨M„Páüòonñ=¹/)‰=D¬™‘x™( ;o•94‡Í‚¹m.Ïÿ&yj:f•… +ã¯ç´½y5âC̆7’gjóÄâ|ÈÂÚÔ¤à¤ò„[ZÓôÁûòúêFù³‚V"vÏ[´¯'›0¡'Øüˆu‡Haq>æ–‡›äã#‚ +[ê©úɱշÆ#]ðN«³¼6m¥‰8\mm×–æO*Ídœà?Ôd&ùãͼbÀ`›ÂQ EÑöý¸R>™üý‡Âk<7½¢ŸhTª*ñ!þ™ï¹ûXâ%|‰ddu:Ò_'r䕯w–Möaª4¸Í(#在žÜköÓ?%
sö)Y~;=N³2€†»F +ØŸ;Â[·^[VÕG
ô…›Ë5a¯Õ<M±kÕ¦1±¼âÜ0°«Áé&%=ösݨÃ8àŽd*vHᓯÜh¦îÇm0²‘¹Ñ5ŸkÞ²±ê"Ÿ¤Çµ©éì¹Ö-w^þbYm(<rq=ÍÆ$fò»Qf?1áùšÖ—æ“|!Ž(]U˜Z²*¹¯êëýe<®mÒ…œ¡—7Å~·À2ÂC®,0¸úG”ý
)ÛùáHÁšCEÅC2ÁL>þ·«Ê/qhÃP៻AxàIèŽòÔ*a‰íŸñýi"ñ”Îèa¦J‚ãU«¿hè6[é¹Î]¶ú£^þ
Wœ
„úž@Ô ú<O#&—)‰fÔ—†Ã¿7EÆ{ö`A#£(ø.‘ÄâW¨J¦½¹}+4zØ4ûuÍ”[1[Èhü] ¯VÒM¬Ãò˜ìy/*ï³›b÷ ÎÎ/ÊèÒšiçWOcFb)-}q‰Ïœ#6ŠW*Ü¢ï|Ë>ØÁq‚'QÞG«Á.·C—‡¬ö™Õš#ñÕY”…ý!A¦S3çìºâÆe²OÙð<è4ËÕhB\ÎÛ/f–Ѿ39ó6©ÇfžÝ†ÒanÂÁÏ×áá–>Ï€V=Æ]‘ïÈ|zˆ•T°¹ÝH’“=æö+•ÜÐ~áâ>è?¥ðRM :Öª”¬¯¤1ÕUÓ2jmƒ<ì &oÅ•M<Ã,Aí‹KoLÇ/ ÝžKÅ7™ ¡„<¾Cšì+Í5Êhk£JVY+x°ÀBú€ÛH¬æó§˜W+° +Ún3!©E:qg^˜½“çEÉHûK뵋Ùãi¬r°"×$n{G4.ö5b +C'75¾caÁ¢ãmƒž•å ûZ *œ®ÉÙ
@œË¼,A¾‚úqhîA¨øy#³ +1jÚlÑ&³¤= +Øcîmë5+¨38…y-5*6Ó¼'G†I¡s*Éžš<ªf'&Â÷ç)7+9Si|пŠ·ÖC7¿¦´kEª3¡1/`@;ý‚·ÕØ%T¿h¿÷mUBÉg€Kj2ç3gžE>Én+p×úˆlJ<2A1ƒÊÆø4œ/¥Epz¬&ôìÜÿH\tõœÓ%±_~MgþD õ*ÖÆÇûÔ³ K½?€÷£–ò>#¹ëlY–ýaIø +•ªÿ^²~wå0§÷>¬i¡”Ðer;á2\ŸS2ûkÿÚÙJ=ñ8ªÓ;åȲ¦p«.©I*ΪoFãÄjèŸ*˜®$rرpVxO)ß-.LòV"ëàÁËð:¾ßOw(ʽ +X£ÏÕ½ÞÀ
¶aøz·#
OÈ +B–y´S,¯K.Œ¾ÄJ'7Z¤Ýiõ•®G@QÀn•?—‰†Í_#ppÚ“úëslg°ˆ!PB0ŽÇ0!)ô j«ïY:FŒ›|ƒYÞ+[#’¯f•YÞifýP!`9†„øQ1º*˜¹’οçÿ1›†•Ò»=Iù NeõÉ #˜'g€"C-†óçþ9#Èï³Æ<4Wkë] +bvÑCª¶<áVÅák…î4ÛFüÀãó´[OÝÉ›þ(œ6®°Gɹ|ðzCà"å:.B*´ +ÌÇý¦”ït†ˆQF'£•W”‚Jî‹ö¨RZ»å>Õ;v×òu"Bä—,IÆ÷ +?tBVå äÓÒ·&ŸõaðÎÑ3ã?ì‰ðˆz)ýþŠË¬MÜöõÇÈR‹[uYÊâ™xŽ(ä©rLx¹d0©Ù¹9›—€¹`eîWœŠjÍ`«
rëáeÕ0Eg—¬ÀpÛco:,Cú‰–èÓT`T콈l×ÓkŽÊ]5É_oÖÏ +¿Ø„×óF¶?0PA–ßâeP¼šxoyT×]ƒß¯q‚éWëÆóªVüš'ƒ³DŠgªšµ©’((_«¿ª²*ÉêjÂÉÀhýìÀß,[Rz<™ð<ËXs×;åäÚg&Ú +¢…~/Œ%뺋
Í_g>êµÓ~ãYbŠ5| +ËÐÿÁÓ6æ›.æÏcÖ(‰…4Sü4ºÖ. ³îñ à“ò<¯¬ˆ.76Ÿ?õ#»Âoyù£ðc
™2ô2Íû>Úé \‘ðc"l誤çoIk§†²ÇÝ‘Ïs§§+Û¤ßÈ„ÊMðʪìW¯> ÕÅŠJ~à‹“ç—=6óÎ/QP<Ž}%´5*¦²ÍÌà‹r][¸„ìWMfRA¾.¼Ôã·v’ówØøÍÄVn®q»7OçÙ`°W¹(ã#ðmL¢mÚ¬61$"ã”’OãÙ¿ +F
]bI“•C·v0ô]ïsŠ×V*à&Æ:-H<c°1ñõZvO(MDÁ™UnçÖÃMLw¦¼9Ìʘ'f {‚HòZÆpQ¹e熶c08*k¿^Z¨¤ü”÷« jÒ ®íVÅFDøqÍGLÎL[Þ»@7U92ÇŠ ®•pTæÁ_Š6E{E-”»ì“¡ï–á䨓Ôò‰÷Aé‘E +ö;)Ó5†90öê8’ÊøïSÏ]m/‚ƒÐ _èìûD"6ÅÐ +ó/
¤¤IÝn×ャÃH£J©´Á×í£\^"^?m¸î#ÜÓã¡]?Âǫ̀ôÍÄ?õ}ŸÔ½ºCCv‰ØÕÅóØôÉ‹ŽcÄqÙÅÄ 1È‚ÓÏAK–&ÇqJáw‡í¥óðq-²º5{Ü9cúxsœ…vtàtf>Ø.V/èàl)]ÆüjEÞ)â06¦±/ˆÅˆÅðŸ—Â>¦O9L:»åcþ‘o†,
1ÜÊÈ6dðdrx·±+ +þuch`’WZÔ6¿©Rì2oŒ`¨ÍÍj“( FM›c¢JëÊ<^=¢fÎ(V«¯|^z‹DÞ»©ÚÇ«×4úóeÍQCf¼5-LØñè‹9¤ÓlêÏÈßiÚNŽKš.¨¿’ò+sÈî/ ÙXй'ŠÝSu÷ _g““X®d–²žÃ2ÈÄÀÅtÑ"Ý +GŽ—z¥YƹQëкtšI–X˜‡1·Ee#§r}›áŸz±g˜$>ÈÕ&)׬H1ì¶SdrvëOËx0P(îée¬-ÒM`¢!03ðÜW‰M^®#Yâ +.„²5ÚþÈÖñ^ž/|†Saï½ ô»ØIvê +Ý»ê}€‘D=Tÿéâö·½‡žëÑG]#ÂâuöñçP2ÀÂ, +ï:/ÿ©Aàéžµ@vô®ž å—þA·žÈFàQ=á'ê²_Z»ÔÙÄη+YS1¹Êƒ”ÞTRcÖì`Qœú}V›v1g1ÒŒŠ$|OIq
@Ýsêç?ú¾óã°!¾,»Ö.qðŠ×þeËŠ”l~a;$gõ…<¾9K„‹DüÆ©8®À¶IÁI3ýSȱ$FïßûBßP5åqÏ' KÇ|µˆ€€‰¥ÿî`Ëf_>´«Í@MãSì7nDAðùg·u{<úzoáiC&‘RÊVçÇTA¿Wb-ΟØ]2PÉ™Ð.8ÙËÍÙ.ò¯j|ƒz]÷ÞkZlü!½989Ÿðd¶aw¨É¾ ŽµQ
1ŸŒ¸9ŸTv2@&*•šíùAùÿÿOX€fήŽöfÎv(ÿYÍb@endstream endobj 703 0 obj << /Type /Font @@ -5602,14 +5598,14 @@ endobj /FirstChar 40 /LastChar 122 /Widths 1343 0 R -/BaseFont /ISCPLH+NimbusMonL-ReguObli +/BaseFont /DHSEOJ+NimbusMonL-ReguObli /FontDescriptor 701 0 R >> endobj 701 0 obj << /Ascent 625 /CapHeight 557 /Descent -147 -/FontName /ISCPLH+NimbusMonL-ReguObli +/FontName /DHSEOJ+NimbusMonL-ReguObli /ItalicAngle -12 /StemV 43 /XHeight 426 @@ -5631,7 +5627,7 @@ endobj stream xÚí¹UT¤]“%Œ»kቻ;îîîNâZ¸»»;…»»»;…»Z¸ÃÔûõt÷¬ž¹šé«ýy“ω±#Nì8çY¹’œXQ…^ÈÔÞØLÜÞÎ…ž™‰ ¦¬¡hdccd ´—¥W¶·5ü5³Ã‘“‹8™¹ -rp²ÿëaûûK¦hïìâlâtpüͪ(*þouºX¹ü“ÛøØ›ÿõ4µ7qýgKÿÂþÒüE]Œ€vÎ +rp²ÿëaûûK¦hïìâlâtpüͪ(*þouºX¹ü“ÛøØ›ÿõ4µ7qýgKÿÂþÒüE]Œ€vÎ ±ªVõ¶ý^Nc_ñõiܬ槕Q¿ÑŠÔ+«ñïPYŸÌôZ#Ûõ½¼6SºßS7Cç0ÂþD¶X>ªO¯Æ¶aÕl¾JüÁøÒŠuwßùöüh¨ÁŽ7n- ª}»›ËÏì¯ò[ùwµ gïèÕËä‡× †¸ºŽïÛIZR
» ˜Yâu#1¯›t,’‹¤×CMMW•M¬îÓ–$IÁ]•Ð}}™ß×(+X{—üÓHï=s]Ô½í<›Øáb57U‘Ct¸¹# ¹@
²KCúFúØì¸5Ö0ë ƒŽÊ©ˆtÝÊNõ‹æíùu§TþÝ4F¯ä‚™Ï¸ý§:Ù0Ìîz2.‡8Á¤¥"ð@b¹ð:Í(o`Ô¿kM.Z’#ï£2GYŠnplwÌÙm݆øf[8³")Ý-Ì>ØÐÀ"¤¹ú,ï6çš#±VEÿú4Í ÙTÙ ƒ˜êççX}×¹F; yhȱ½ýx˜!:Á<œ?-p©yó>sd³aEG2 ‰iħØä¢_,Ì:ý¡ÒI“ Èú€èç“.ª¡Ü^ó!Ozü(~”@½ð¤Ê¨JïŽ ÷(ù)I¡É’!Ë[í¿7O’0 ™(Öê/Êó#?ŸòtssÕï“wÏgWWÂù;í @@ -5703,7 +5699,7 @@ PÐ¿Ü ¼ST ªjDÒG@œ=ù¢0Vþ23qð8@R‚¢Sx†€ÀˆQšk>Ö˜IÛ»åÆnÕ@ Šœ+7ƒ¥ #xA& V°î2»“u=œÕÏ"¨¡
¥}ŨRpÔG0Ò|Ëÿ°Á÷v¯×ã#Ði¹j3ÍTâè(3Z÷†]ö‰6$áHý.ù2rä"Šñ.Q}Œ[ô(~áa¼ô|·g7LÜëèi GÕzBƒ¤ìò°ôÉy,<ri5¢Ó<øQ°–"ß@X1páJ9¥œÜ{5ÖXOù!Òâ™DŒŸ-ƒÞÒ{ßî|¥Þ‹|õÈ”…;°ßUÃFrEþ÷÷>£–¢€%ÝÞû.îcäG3*Ùºr¢ê.ûÝS²Z°¶¯Üi𥰛‰àò"ë8׊Ê[¬oœæiªÈtB!N²Ma3_#”Ö‘3?z25Q«û%Tb÷‹ºðƒS‰\ ”Ë`DðÌø¹Õ"†Ò»K$šù‘ W»P-$Ô"taâ5í.§œi"2a îÎEg|鞢³‹O-,Œ'²Æ¤ùp|’Ì”‹Ò7rž´‘€µ‘‹Üä!ðvƒŸÖß0ÕBöy\åqýXkÊ€XƒÆ;my»”(~aŸ›{á|±ob’ØÏÖÙxœ=†¤…` Ö罦(h
ö˜85]‰„C¬…ù×UÎu×ÞÃ4 ?0 -tâï¯tãq·˜þ?pÿ?Áÿ'LlÌŒœ\ìmœ¬áþwR°endstream +tâï¯tãq·˜þ?pÿ?Áÿ'LlÌŒœ\ìmœ¬áþ— ðendstream endobj 634 0 obj << /Type /Font @@ -5712,14 +5708,14 @@ endobj /FirstChar 40 /LastChar 90 /Widths 1344 0 R -/BaseFont /EUARBQ+URWPalladioL-Roma-Slant_167 +/BaseFont /SXSQZW+URWPalladioL-Roma-Slant_167 /FontDescriptor 632 0 R >> endobj 632 0 obj << /Ascent 715 /CapHeight 680 /Descent -282 -/FontName /EUARBQ+URWPalladioL-Roma-Slant_167 +/FontName /SXSQZW+URWPalladioL-Roma-Slant_167 /ItalicAngle -9 /StemV 84 /XHeight 469 @@ -5744,52 +5740,59 @@ xÚí·ePeݲ% øk䀣 u9ƒìlÅŒœ¼ ’ tüWƒ¨ÿ™š¿$ŒLíl= -F6àßàï
cüsÇü¿bl@Öÿ›èÿ¨ü7Ãÿˆ´³Ñß6Ûšÿ•‚™‘ùßF“Èhúälb03²þÛ£ÙÕlMŽÖ [à_-ÿÕF -ñ½¿Ý¡$ý6;›˜ ½S‘F‡‡9Lq®÷#7ùºÞAæOy«Æk™¬0\™òã)àÚŠ¯Põýè_°ÏÈ𸯪+WX½À4qW%¸3A pÇ‚yçNјŠhÙFƒ´¼òàH«Qûv¡;±0p•]ßt’~xd,Š‹÷xÂÍ6m$ˆ¤bŽè›a»èýa–Qº ÅZCE{˜Í¸V>$zytgC¿ Ëûž~^üZ΢ë—'¿4vÌ¢€œQ(߈¼ÚóE$9>RÛòvJr—Ž!V•Qê-¦
ç]kˆ«#L¹)N[ -Y'L -Ml%£:Tid„‡ -†{z¼*†ÆO0RÕ[|+uØ<»×xB–)ûµjÃñáÛTK!ëßP.GJ¦
šïHídϷÂó‡8ÍÈÝÑìᣮ¨¹)KÔ«£" [ßáØÓz'f?r÷g‡ÏÁõûd„» Ë}áY‘’¡žRÞÃþÛÈžiuMÛqÁÞÚÖ:ÏÝu)âì¾ -´mg!™Õ[º±dúrTýÛ·àÑï;¾Sh4+mpæN#{•x9)Âv]²O_ÊÚ"¸g)ˬÀ ó6ÌúäT¤q6`Ü,ÎÄÊ“Ê.ÆmRúuZ} -u¯Ôeø9‰ùXg©v«½~ô¤™ÎbfÓ@ËZ€'púÎfjûµ+4Šð9µ?çyG Åš2Ã>öá¡èÓÍõ‹æ©íq½j]F4ÊQc &ÚWÊ¥Œ!¤)Ô¡W;êíˆkúë¥|ÂO!xËl|Ê/"Ë ¥Y8Þg™t‹}1ü¸ê²áüs,écbDŠ‚<ÕÔ&0S™2(Ãmz\Ì#wÔJ$G”ûsuQ#JöõÖ1Œsoæˆ •X1K÷·XøZ°˜©T†fzUàÝô¤˜:%)=ÿ¢NýÌýßáB0$awϬ&8Ž÷SMÕ@: ÿ÷6²±‰ðJe Êq»‘€¿Cø# /ÒT
ÚÁûB2cQ˜ãSŸ_1IãÛóù´P$O´›ä…™±<œBn|\©žêŒ.ymõ¶9ŠLrd¤¼]‰mæâ¥ËNÛ” CSÿ -Ôw(ˆ)¸ôèg¾ÜFþRM–”T–VRƒú¡âÕ€9«\æÁ r˜.°×„ZÎAÆØRöuaÓ^z¾A}É €1X•¢Ä<”BÅ2Ý)×BöÔÚó–7L}ƒ.DMZÖËçÒÌ¡sìÕzÇ<ï§PÙpK`Û¶— -d„½-˜vNªÊ:&¬.U~ø -S–2¶ò¦,|Uº•¹åÿŒ ²]d§ûHÛ±^'Óàrê¥Ñ'Wží¼IëÛËlžœ‹¯‡ýôÊ0àU\|¬¹.wÑ`7ÐÛå/—êâY쵚ûU¿ð½@'Ã\Û#ÿ¨tÓ"¥ÍSûã†ÖÑÖ9X³*¶?"D'Ö ótÉ‘mtå -6¾íè†i#¦‡¨#d]™P8-ÆŒt8ñOÑÇ,«ñæ¿V´Dze<
xzÄz -ÉËh¶*”zT©
:ê%Ë×úì±m,0¼Z©“`Šì£ç!(ÐÖ2Y -<«<Æ;ƒÎdä”4éPйë×¥ß"á§KHe -¬Ÿþðåg¿ÐžT1‚ŒÙ{§ë³÷<¥·qÒVÍïl—ÎЕÑi„¦¨DäÒ)ìW¾V “{©¬1› -ºs„ŒÍDÔTQóÖÉ_+y’‡2„æSu•P¾1YÙÑ"®—tI+Œ,r]
¤'Ü~ÙŠÃüó²-e–´cOKswfÞé¬yòÒƒâÌ’.ËLÿµ_·_Ú•bȼ±ÞõŒCⶓСš¬©%˜îvNBÄ3Àu®*ó^Ú£e3ÐWE>qßiSgb`ÑÞXpœõ
ú~0èu†£ÆBß^ ¨íHßÿó1p}PŠÇ -ÿ¡QÁ{þ -Pä±\7Š‡òÝÐBÞz¾–ܶ< -hÞãBÚ'¡ê{üŸ[gq«JNi9ª J¡ö–”ÍÎBÚ&eš"¡„™G -0ũ㻢×JïØÄæv -®t·Té„Ã}5§¯kŸ1öÖ¥¼?Pe;ö•Pö‘rû0ï}Bϼ˜\ˆÉ6ù·ÒšÏ¹äçMI9!Èèm)L(ãÌSŠ›öž™{ÔˆV"X¡…-’?.ESö®žªAÝP! j#HA±}…KXžÌÕ§ÐÉMŠ[¤ã('©m»Ÿ>¾+›™Q…ºCTmr9ðn«!dØ}û\>KdÚžïËeš»ùØã‚„À¹b¼ôd *Ç£GhU×¹ ->3;J¦@ÝÀ¯ÓrZþ@)%È€Êz¤a¨ädèji|µ€) eãCÊuÙ.ƒæqô~l»JöUþŽžØóáxf‘n#©[6ú<—¼FL¨Õ‚¢p¦áâþòþttÁo¬‚¡:ks_V]º¨ž*Yº‚ÖS,"ƒTæ{à':¨²Ãêﳓ+xòä½o»äß(!\Z,ÓræÁÚÉŸ ðµµV$n« BA†lmº'U'ž½R›~nØõãç":E›çÎy?ž‡
?CÑ<,ê‹DÜ(8Óv}å~õìòÙ¼ŸêGF¾nƒU„]¢6¼óÈ¡@¦]¹:@¾"¹&~žûÔëâÈm!Êê½–B¿™—´¢´ -]éû.@U¥”¹7n0B¹TñÖ€•Ü’ü=²Øü;ApÊ|,êºJCåD…rÿ}œ_PHqÆ»LO…NEt"†‚©ÛAѲ‚÷&¾½&WáõÔ7j§qÝÄ´Öoºêe--Cª±G.y–æQ12Ò7C}Ϥ$)S¢›#qò8R|ﬗT%’„`Ô‡>{|ÓÑ(~‰M€ì¡öÔõ|µ÷•Ý RÙŸ¿°xðÆÜï$xÂ1
ùê”"B/J#_“ÕK`ô!™"WX¥ž]58áqA8Rkªk7bfRCèç`…oŽRÈeé'¶‚©&#É;°õCd€nzc¦}ϛ«ó~×€#\K"™qø$â~FÛŽ›–‰K¹Zð®=¿Í<ÍšQƒT¼hçîuÈÞ Œ&©ò§=&—àÈjóAŸVËpý~‹wåhß\">ÿĺrÁI~¹8îÖ²Øeçmב[~_‡Õ)Úùá!¼Gâƪ̣}^jèÍeìGHj{FƒÏDI‰áž>ç;Ž;
:«^/lü²ÏÜ!*‚v5Bw®vªz‚/{¿É!Ä)Ý_Ò½,0‡Ä83ËqPA¨ÏÀB¤¬PA$.Z„^™ùà À_q\E¯§nT©E|i¢jHm¯© -mO´ø$ZEZ»ß÷êSùâþqÆtd±ã±ïäœ1·+}pyÉi"¾!¼ÈÓ‹ÞBêI†¾y¨‹5Á·n¤l¬ î¹2íib’-þa/mBrZJ¨g“mˆêia1éØæŽÌQt¡ÓÆ˃¨ -¢j)ü™pÒŠb÷"…í¬LÅí^²0Ôô{k>—
¹§‚ˆàêÒ|%
ýˆëã_d;lEO㷳ߗœ×Rfå -ZcÁ²Z!å5Zn;£°¤Êîž4Üb -“â7+:¿ßå²p€‘ßTbºLJzù:˜cÇZŸQyØCV`ÔÖ .ý\ø£é¬—Ò8~û§vYg“ÕŒ1…·ÁÅzýãÚWÕºÌÚùYÞ‘G½ µq€¥Žh”G ;èXîÙ7š%›ŠK–YtÙ÷¿q;Â*ò¾¤ÈfRʽC@Óz†¾>ÑRKíóðdêZ+%{<V6KiH|žz:]6•Æåý̧(j›ÀM¾dxÅ]©äh1=[SîKØ{²Y¿×Û3fãï[4HâÀfppï}:´$ŠÖ‘1
`â;Ø8§QŽVê’ÝýIX† ò«ˆ¤üYL^R3‚ŸW:o»é9¾5¾æÃÿÉ#¡ÊSºyØànJ¾w|fjvä|ðý®PRñgž‡°¼äÃ!Šì1¬è¹Ø”9qζ3™u°œºª¥?™l*¼~þ²[q)7Š–%ñ,L2Û#Šôï[IÒÖÆÂJÏ®B*öç¥6ÙâµÅÀìÝŸ#zç*ûlãoô«âWýr)¿/©Ê»êrBIö…Úäé]›Ê®ß@¾ sL.ƒ6ß!•}º‹É÷E‹šÏrW¹ý ¿ô¦®V*sŠâʨîø»iaŽv|Ýj0=Ø$Q>SÚ¯‘n¾€ûà3µ¨¯¹|Ï‚·#ø2òJ_×Kà?ew5²ò!msZYÝþ³Ûš6·—O,o|iVð”@DOXå¡gg'\ÔQUáÏ‹wƒ§ tÔи7uû]J8IÓ~«]Õgb+©‚±ëõúZ÷0©ÝæöœÉgp£è½»Í¾÷QöÅÒ+*A¶3M{#ˆ2¡éŸ‹\®þK§Œæx'wÅw÷q‡Ø™³G›Is%ößÕlÕ×ÙYó$;ƒ"d™ˆÞ›3™×Vc:DŸ!H™ØºASöò;ªÄ‚3:¬§µˆ6· ¿+><Æögn% ãïcªKZ¬ ýÒEÓý°¡© -oöw¡‰Ç÷ LN(Ú–Ç•ë|¦ÙV0f†BckÔ/ÖözåÄò«ÎMüPC‘&§¤sâQOŸîì?`øá -u€2DZT‡ÿan<øF¢àƒK#ÒÞxpÂä_µB…•’Ä5$(Z£½X÷˜,Çn=F„I1°Sk€/ô¿Ñû’-Ú%6©`Û/XwܸýŒPä°X{]‹{ÁõIê=/uµJLÒ "nÏÖ9 -ÊnQu}±”ÇËÂo¾ÀxÂO¦ßi“Ÿž„Z”ž¬ùáXßâjøLƒMw®ÝÉ¡þ‰à0߉òÐaàð1͈o®ŒKÔ2û%걓ºîöC·wÕ‹Þ«WI±á‰šæN&`†[Ë~©à}ã‘ë!–{«-ƒÐKÜQ>µÓ™ÚHh[“+ÊäŠw˜Œ~š‘o;UK䊋íó¢/¯sö6†>ûþøM7f“wcåwÛƒS^‡ãIÔˆ·œ‘‘O¡"è£á²N´(*–ñYaZÿnŽš -/†¿ -¯)$QF!ËêbVqâ!Š–i× ÛÔáZ4z³2„«#µùjÆa0Ž¢”½¦wÝ̳
Mx¹c"ve·yäÒ0Ëdao†
˜’|¨äÊÎ |ýªm¯;°”`È$ùúgH÷ôT¼‰K6lºæð°1I§Áü<Mø—Ùî¹A‘†*›Ý´ß4èN]ÐL:òs@ˆv.BBÓØ~©ç0ϽxØȸŒ§´zŸÌ¹1lðhSe@¦¹Kz˜$Aˆ"ÆÀô¢A $Õs‚ݸHªêmªœÒòûÜ™\ð€Èª&¿o¢újt§ã;»ô°Š lñëÒñLÅ–ÞÎÙÆòÛÞ¢bòê/Èá‡@°‹Ôp;C¹@˜T¯+,OëBš—UÒæ7v¾µŽó"zÌžƒu¸WÖŠŽ®‰Úƒ6äfôT!m¹dÒ«?¢-gÊsŒÅ¿î•n!yªWƒ¨¡õ…*‚´Û˜d®Ë’Àî¤a‘ð7Àãk¦·nÖdsÈãMU„¼Ž8ðA;²Ÿ‡–œGC¹éâ¿q…”½ïyB–þ|;kßá4\àç¹òNJes
æ¶3ìãdœx1y¼\ø<µè¦>°¯Ì~δ¨ñ¬
&d‰tñ‚Üè>øŒº§ðTÍ”µq¥|rüꆸ´åxùòr¿jÖÑy„æOä¬-d‘Òä[ºz@z6>"Ò(K)+è¸Ê]‚éÉëß-Z¿¹ùÁßP£«•O?.Ÿ7©`ñ§„nºn´ˆ©AÅ -®K·¶M“‹PÐ-øeóù(,•ÐqšW×,׃ññ£™”¦£W…á觇²H•ª£ën“¼ºUÕq/ßíÇ%–Þqÿ J†tù›á8îe p©SíÊw¥N¶oéÑ!í3ày<Áév…‡~ñ¦g‰ûÓGÃPûÅ•'ëyçÅÙö°ê"б2¦<N[—ŸeD·^¸Ï×C2'!ðœþ…`—åæõ¤Ó.Çiæ’,ÝãI~d¿z`4¤‚+õë5e>¯ge&ü¿ˆh8#u÷$å†7 ~g¤ ÌÓj7#)¸"ãbø=ËÈÓF7mõÏx|)ʦR+ËY'¢Æ‹f¯ -é0;êÈÞšGû)¼ÕÝÛ•qòG‚}¢v7~ýUÌØ{/ª//¶£@¢’BxP
?×㺽v/Ò"¢³¬É–²7~õ¥-°ú¾Yâb²4GáY±Þ\ÛêùÑò:u|?í¥LTj/Ïäœän”…xÞN[³Ö´Yg$<o8ó!¯S庅{–¸¾£“7Bb¤ÖRƒû°)©5Õ‘
5e'îäuõÄ]ºv&cÀ…oÊÄ8büR š?òré -GZläÞ¢Åë6}oÛ,“Nxúœ½™§~ãIf7Ù,’y®KuT§Ä‹óˆÞˆ:‘¼ '³é~”*=Ï¥aæ½L
šá(ˆ#}AÀ·åÖ•INø™Õqy»±ýQÐBþtSè³í¸Ç -Oùl_t>»ˆ„Q@·z×À!»Qqf¢Y Îë"Ìãì]/©¦pš¶¢þz¨´ «E¹f‘SÑ”,Y¸!µx·?q¼ÀRœh·×ÚâOÐ`8 Ž÷PÚÑ¡lŽ~ñ¢ª ”HÓVßQk6˜qØ `?'7Àw1²£;Äk§ÕùI…²™e£ -ÁÊýŠ{Eoa’¥VÖôJŠD¢VØ+çòêqgkSÃúæœÖJ!¾íѹ‚§š@.¯¡?4÷k¯ÆpHmÉKHÆ`ÅÀgç»C~\þëÔƱ
)m®ðrô©:ã.ÓŒ±þ(pôs°¶†Yi†u1`kîxÍræN6Ór§‘Ó¾‡‡8êaì%ª?áXhu*‹e²ö×VÒôbÝMcÚí.ä Ü
SߟýŠw×ë±AV‚,“gBsEû&·9Ó3÷–òÎöÀ¥[Œ»ÆT*UD-.ô€]¨ô€–'OWsá€TO›¦õ`¡Š»Ù†ÖáÂuþ¾ñFl ©>ØNRȘa»CSÔ—Ÿ¶†ËÆÁdõÜBx½oÌ«·†)Ô›.hþ¬ng¬ûÛöVhNÁ4ýÔ¦zçŒi=÷·ZÁ¸ö‰ÝbáÂóû=™‰¡-í§ç)Cm=Úy«ôÇÅ“SwCðï—9C$~™¤9Ï…Û‡_ÚóWs¸ ù0.n' ’8_JùïMæüÝRÄbI’OîÚë;Ãwh¯“J¬J´Š^kû³ÅJŽm™ªó‘'i‹lÛüŠßGÀCÿçù#K‰}¢orL-–cƒ9MºNöÊ^âæYj—aíLY&.þˆf$Qžþjõ0Cñɇ\›€®ì³¼kÔ42uR0Ó…µöµ©k)¶¡)–—Í …‚‚Tuº—Æ6°…5ÚÅ(˳«mÀšÇÊõ™¶Ôî^H™¯Ì¯ò,µêiÝò¸: -SþÅ•ù°?UÆh´ÛÆ~‹Ü³µ´FŽÌ½¨
÷`2±Í¾ø_ÑÛ¥¥†%º%B\aáPbs–’´¯xÛŠÍPßí"2¸'\sïa øçÑõØê -ùôÀ®ß`&„jsJ·ÝqüÚy»©N¨ªÊ‚a
'±ð¾•ìýʤhö\êøÔ<{,üág`™ÁZ±Mãêà7G¤¢œ‚ñ¹ÍÃ5¼tÈŠµÎ”ࢼ'}ÍÈž›¹cU{œœ”ñ’£Ñ8þ» *\þ:X)8ìÆäG4k·D«S ½</psð8M´vÊ#'®È?Ý(æDœ&jž]RBqf„I+=µ×õ;˜AüÂÛ©4€…Ï3‘«)Ã`&ùÄ.3Sª[‘¾vÒE&Q†üÕ¤Â3$H˜3ÈX)Òö -Ûfãu¡ÀÐZKÏ¢ÊôG„“ ?î]¢ozNS¥•oNüÖA797mÄÚ¥âFËë -!üÂlŠÏY™Vß‚-#õÛ"òæ)ê§4|÷4û•¦Ç\£Ù.,u˜XÞçAO¯é8h‘$?³DUŽ$ÐN—ýÀôZO¾h¹)8’]íPlÒó!ÌÖ¦¾óí3„@ÍÿBkjû"qJº„‡›áûÛ>Ä£c¤ùÄþâ<NI×–áä‚b…&yK`à3r€ ‹¶ôfæX:„¡'*?§ºnQ~ÓRÙüÌ¢÷¿Ãs¦yÞ$Â9{¶Å*+'QÅö*§H(ð›xrPßÞÐFñ`$•†ÔXóþÈÖxÊ ¥ô*$ƒn%Õu{¸‡£Û"Ýft
/æ.;FÑ÷·ßà9èf¤û*
Žn5ˆò§\S¨ƒÆ+’Iñ$ÉÆãЩ$ÐÈ~f›hD"°[Ir·»FªÁ>ÂnÆmp¥Z[ÆóžC|ø{}Í°†¡P®¦é§ -@á–ŸŽšó‘ŸqJB¬Í×H¬íÅ]¦mš_-Áµd‰[…©ÝG}kÂ'†¹ZñEïJ/2Ž¿I¢Û¼Œ;ÀJ?ЗXÒ²se¥[ñԆص–3—ñ>(ìí,¡’Ó7¿oØc›ŒÆrOã·¨Ó½¹`Ò^¼>¼aˆË;hŒ¹ÿÙÿå`@HZa½¥×¶9‘àÕâ¡[Ü·Å’Øß©UøgéQuz`@ÝD7… 6˜^³&s %qßÕ±%zs‹É«I)Œ—þ[~x4ir:ÿ•Ä5¿‡¼c@'dPí¼+Ê-ußvxØ€F -‹˜>cîÕ‡¬òš¢úcÓÕVAcB8‰à–à3†(¿Ÿ->2$§‰#ϲf~µÉOR¢}Ì^Ô*ëT¦9Ï^°Q¦òÌ0Ò@§…×õ™Û¡f}O†kÞÜ9ìFÄ«òwÛÍbµËØq„ÂL™§ÇÙ宕NÔuKJL:˜Ü
õÚšöÀÎß ---˜TÎÁ?åשּׁ~Ig.äs#IR³1Þdà0säÐl„ë¤)wÜÔC‚5ZêD¡˜A|aK]¾öQŒ)ŠÑßÛ¥fÜ-6wâœÌn¿Ô‘ëZ¬×ñÂe²€KQÊÉ!qäl†ä Ã;¼Â`¯ˆ«Ýjƒ"àFd’(ñ¹%Х埤:ìKÐÙÖ»ûúj?ã0GLÝå/—‡ÕsÉmtèŠ7@F.°vš\õ`òƒ_¨à@ó+ß'9/þ´îQöñ;*œî~¿ˆ\Ý‚°¥ù"@Ãw¥> -«ñh²°þ;f&õÏýtYPXÉ(ÄÑ—îÿ*ìRâ͋MI.riAÛ³eBapX,&L˜”FÄqOÕi/zÌ-JîÙŽX!|½ôÔ{/¥Êl“”2êL¦›$ôéy¶r×òètA3È׸„–MT•Ë¹#“Ÿ_«ê±C˜Ä%3(ØBN®fMݱd[ï0i®§¬Þe˜nùÃ,2†•³>Q~Eó“l¤Ñ‡d¥K -È ¿X¤ô á€S¥M†kh_v.ÊZ°XY–×~dŠZ£þq z3„=pÔÍ*SÈá£.rYÎ8xz¡ªm:è«íƒÂfkl®õ3V°yÇݪ"|pA´q+K¯ìñÄ5ÄÆòX”ñ3³S“K¸8”Xgúy6VœOÉÒÀn‹|@aµ»§Õÿþ\1-óò$jô½·Yâ6IÞåQˆÿ¨Û.†î†!ÿ" Žíë½#kÒŸ@nüšÂ.MV5âÒžpɾT “L$*jsK€kU3P"¢÷ÇÇ‚“\e,Ѷ™ßUeÅATIˆ¼Š#DRÏãþfž‡ïDŒ4ùä;¬«"_u´©+E¸8å´•È.a«MçeÉ™¸m»ÝbîBß_S¨—,ò5žL(Áœ½¼«lè„OÞÐë³,ÜV"éˆeÛæÅ—¶‡~,¡¸ŸÆü€¾µ¦gq8¿¯Z‹—Å}á/Å'laÿ†SÙq³t‡º¶^H·âœNwÌútaES<hpFEž u‹F,p?º°8*ü²z"¼ñ…>«¬¾lfœêð~,¯±Ni`—…ÏgCž@2|§ãÓ>ú6.ûW˜ï>µ½Ø“M¿+Ÿ
$g;µÆñGïÞ—ÆøE×®Ú§qkERãÒÆc{…ŽZ²ÊZd;_Pº·t‡Èû/QOûIàÏg»–%E:)‰7‰‹zz÷Ÿt¸ZúŠ -É9û×ÖN¨Ó©Þ¶Gn‚‰å”÷,Œó¹ñ:Ÿ5Å=©x¹=Z©¥…»Qò‚Gc]qŒð_¿³—«º'í(åDZþ´î€J®‚Iç'«_ßÂ:ŸÇHjDõlÝå„,©qØ`G¾¬†\È@éø¦‚œ—éܪðX¢ÈQ<Ñi8ºÄ|#ñ°Åòõ›O(m£mŸ8½7¸r¯já—"Tày¨
Zì|AúßPqéí
[ÈÃù3Vìlî¾
™VÉlb¼¤.ÛžF
ûoŸJ¶ô +F6àßàï
cüsÇü¿bl@Öÿ›èÿ¨ü7Ãÿˆ´³Ñß6Ûšÿ•‚™‘ùßF“Èhúälb03²þÛ£ÙÕlMŽÖ [à_-ÿÕF +>b,–îo±ðµ`1S¨Íô0ªÀ»éI/0uJR0zþ-Dú™û¿Ã…`HÂ,îžYMp栗ªt@þ;;ïmdc%:á•Ê@•ãv#‡ðG@^6¤©´ƒ÷[…dÆ¢0Ç5¦>¿b’Æ·çói¡Hžh7É3cy8„Üù¸R=Õ]òÚêms™äÈHy»ÛÌÅK—¶)A‡¦>þHÉÂY4û¯úeÐ5jî'º–µÙæcµ`ý¨7¦FÏ9ˆè•ºYÑìiý
¯ËëCÞ×cdÇsMû%×>”d˜D:‹‹ÁÇÞ_ÊHFW¶|vÙ¶k;.•^.Éq'j½èôQc!mÞàuÉYœ{W=ð…B+*p˜ŠH’õdBpühEäPu/¸à*òÎgÙà¥é ¤\.‘5ãÂáh`Ò6[³´
|üUE&2DTÀM“þ@ÊÆK¥0lClw¨ïPSpéÑÏ|¹ü¥š,)©,¤õCÅ«þ +®b‹ µ™º²¨U ‹ 1¹£`EB¤]A·pêÓØ®etÚä$WÂÎyRêý„ý —aØŽéÃ;¾†NÜ¡_Öá9²=^žÓ‚0›.UP´Âëpº 2¸”üÒzœ~qÎâÎ|¶Î +:'4Ì,†Ü3ãT
Íéº[VAz™ðtº8´ã|CÞˆÁ’ryߧe8MfH?'%gã¯ôðkí½,-R×™äl_b¥ý¬ +ˆˆžo챧ľžRr‚YZMSèùcqØŽ?ô~¹U-¹x¨?ª;~õã9LG†3H¾x÷Ô,ö…_ÁA-èÅ’œtá¦ÕÛ +ÕdExVyŒwÉÈ)(i†S < 3rׯK¿E2ÂO5–Ê +JÛîh0=G|»ûáuh…€ÌH[¡$,îó¦ômìÅOHÚ–~Ö×?õïóo.g&õ¹°p}X`ÃvÊ1©¡ +õ‘wÌ”}ŽÒ Å6=9ò`ŠSÇwE¯•ß±‰Í!ì +—°Š}™ªO' !“›5¶HÇQNRÛv?=||WZ73£ +u‡¨ÚäràÝVCÈ°û"ö¹<|–È´<ß—Ë4wó±Ç; sÅxéÉ@TŽG5ŽÐª®s4ZsÄAýÆvÓÜOÀ?ãW—l…0—ÁÕ‹SIæî¹’µ×}‡5ôšuBIC¥¢‘Z€®¿.øʾo÷|fv.”Lº_§å´üRJ +=ºÒ÷]€ªJ)so,Ü`„r©â+¹%ù{d±ù9v‚à”ùXÔu•†Ê ˆ +åþû8¿ âŒ)v™ž +œŠèDS·ƒ¢eïM|{M®Âë©oÔNãº?ˆ>hßtÕËZZ†Tc\ò,?Ì!¢bd¤o<†:ûž)HIR¦D7Gâäq¤øÞY/©J$ Á¨}öø¦£+Pü› +ߥËÒOlSMF’w:`ë‡È +ü¾«S´'òÃCx
.Ž<þÄU™Gû¼ÔÐ›Ë ÙÔöŒŸ‰’Ã<}4ÏwwtV;¼^ØøeŸ¹ÿBTíj„îþ\íTõ<_ö~“CˆSº¿¤{Y`‰qf–ã ‚þPŸ;€…HY¡‚H]´½02ó‡A€¿â¸Š„_OݨR‹øÒDÕÚ^)RÚžhñI´Š´v¿ïÕ§òÅýãŒéÈbÇcßÉ8cnW<ú9àò“Ó,D}Cx‘§½#„Ô“}óPk‚oÝHÙXÜ3r7dÚÓÄ$[üÃ^Ú„ä´”PÏ&Û%ÔÓÂbұ͙£èB§—QDÕRø3á¤ÅþîD +ÛY™ŠÛ½d`: ©é÷Ö|.?rO'!ÁÕ¥ùJú×Ç3¾Èv"ØŠžÆog¿/9'®¥ÌÊ´Æ‚eµBÊk´ÜvFa'(H• Ü<i¸Ä&ÅoVt~¿Ëeá +6°‡¬À¨A\ú¹ðGÓY/¥qüöOí²4&Î4&«c0 +?nƒŠõúǵ¯ªu™µó³¼#zjã +6Êîjdå!CÚ$æ´²ºýg·5mn/ŸXÞøÒ¬à)ˆž°(Ê-BÏ3ÎN¸†)£ªÂŸï „OA訡poêö
º”p’&¦ýV»ªÏÄVRc×#ZëõµîaR»Í!í9/’ÏàFÑ{w›}ï£ì‹¥WT‚lgšöFeBÓ>¹\)ü—NÍñ66NîŠïïã±3g6“æ$Jì¿«Ùª¯³³æIvEÈ2½7g2¯Ætˆ>C2±uƒ¦ìåwT‰gtXOkmnA~W|*"xŒí)ÎÜJ8@ÆÞÇT—µXú=¤‹¦ûaCS†(N®ÊØ‹PK±¬÷`-Ô̱*XÞìïB!ïA™œP´-;+×ùL³`Ì…ÆÖ¨_¬íõ2Ê'ˆå3V›ø¡†"MNIç(Ä£ž„?ÝÙ6ÀðÃJŒ +ŸÊ¢ƒóþ¼O¬åpnïùZKc®ýg‚å×Ø^ÖeŸ–šÔÓåÉ–aâöÚÞ0·nV€Aê ++%‰kHP´F{°î1YŽÝzŒ“b`§Ö +Θft¬UQý£¿o—Ïæm|Ÿ4<¡µ6>¨¾Š[Ó$†ë¥5{¶ƒ†°e
Ó3;¢Á±¯—Ûý}Q8¨þ8”Ý¢êúb)-–…ß|ñ„ÿžL¿Ó&?= µ(=Yó!ñ¾ÅÕð™›î\ º“CýÁa¾å¡ÃÀácšß\—¨eöKÔc'uÝ ì†n諾=V¯’bÃ5ÍLÀZ
¶–ýRÁûÆ#×%B,÷V[¡–¸;¢|j§3µ‘ж&W”Éï0ý4"ßvª–ÈÛçE_^çìm/|öýñ›nÌ&+>îÆÊ0î¶1§¼Ç“¨o9)Z"3"Ÿ4>BEÐGÃe,œhQT,ã³Â´þ'Ü5^ÞònH}_í·'‘Ù<“Z´&#¾1º’<°1ê7¬Á^âÌ£›§ Œ¿À;ÉqnFþ0ÔÙÒ†r´ÝAø˜æâǦÏÕ žhA˜¨ŸÖå%â[ï`;‰(p¶þxuÕ÷zÛ²øÅÄ<5¹'ç°JŸãÌFxx=Šâø0¢‹*NwpCÊsõ¥kè™7¹:’f·Ÿ±t„ø&]’wL]—Ѽ¿>âiÆô‘†¶ú¸šÎîÕ¨~R¾ô²¬ˆõè]wÍlˆCìfçGs餷aOU*;Iúv•Ç1Ì!&ÊTDìbà8êN£`7-naÕîPv¿-é”Ýc1!²æÒ-Ñ#Ïÿ™‡3ÿ’pÞeä›#‡Y¤„H_RÚŠVt$ZO^›Q‰\1¢>ÛçuËßïJ›`H\QËŽYû‡ëûû]ä£^SH¢ŒB–ÕŬâÄC-3Ò®A·3¨ÃµhõfeW/F kóÕŒÂ`E){Mïº?˜3("fšðrÇ<DìÊnóÈ¥a–ÉÂÞ$0$ùPÉ•øúUÛ^w`)ÁIòõφoé©x—lØ$tÍáac’N)‚ùyšð/³Ýsƒ:#
U6»=h¿iÐ(º ™tä3æ€í\„„¦±üSÏaž{ñ°‘9p!Oiõ>™scØàѦʀLs—ô0Iþ&‚!E6Œé1Dƒ@Hªç»q‘ TÕ="ÚT9¥å'ö¹3¹à‘UM~ßDõÕèNÇwvéaAØâ֥㙊 ,½³#Œå·½EÅäÕ_Ã$`5¨áv†r0©^WXžÖ…4/«¤Íoì|kçEô˜=ëp¯¬]/4´mÈÍè©BÚrÉ$¤WD[Δç‹Ý+ÝBòT¯QCë +Ui·1É\—-$
(ÜIÃ"áo€Ç×þLoݬÉæÇ›ª0yqàƒvd?;ÿ,9†,rÓÅã4 +){ßó„:?,ýùvÖ¾Ãi¸À Îså”ÊæÌmgØÇÉ8ñbòx?¸ñyjÑM}`_™ýœiQãYLÈéâ¹Ñ}ðuOá©š)[jãJùäøÕ
qhËñòåå>~Õ £óÍŸÈ;X[È#¥É·tõ&€ôl|D¤Q– +RVÐq#”»Ó“?Ö¿[´~s󃿡6FW+Ÿ~\6>3nRÁâN Ýþ6tÝhSƒŠ\—nm›&¡ [ðËæ;óQX*¡ã4=®®Y®=âãG3)M=F¯ +ÃÑOe‘*UG
ÖÝ&yu«ªã^¾ÛK,½ãþ”éò7ÃqÜËáR§Ú•ïJlßÒ£)BÚgÀóx‚Óí +ýâMÏ÷§†¡ö‹+OÖó΋³íaÕE0 ceL+xœ¶.?ˈ„o½pŸ¯‡dNBà9ýÁ.ËÍë+H§!\ŽÓ,Ì%5XºÇ=’ýÈ~õÀhHW&0ê×kÊ|^ÏÊLø#ÑpFêZïIÊ
o@&üÎ,HA>˜;§ÕnFRpEÆÅ +ð{:—‘§42nÚêŸ-ðøR”L¥V–³NDÍ^jEZO6ÓT8‡ÔýèÕ³¾* ›™!÷häž"ªŽ-*[¹Í||²G×Þ§Öaœ¼l’(5ïêüúœÐ»ˆcÄM.Òav<Ô‘½4)ŽöSx«»%¶5*ãäZûDínüú«˜±÷^T_^lGD%…ð ~®Çu{í^¤EDgÿ Y“-eoüêK[`õ}³ÄÅdÿhŽÂ³b½¹¶Õó£åuêø~ÚK™¨þ*Ô^žÉ9ÉÿÜ(9 +ñ(¼¶fi³ÎHxÞpæC^§Êu÷,q}G!&o„ÄH¥÷aSRkª#jÊ8:NÜÉëꉻtíLÆ€ß ”‰qÄø5¤@4äåÒ¨UFâXÇ ?€ú´ÃªeÈL‚ãþÆók6eJ ·/GTðþ"óPLwä9GÀ@å–;™Ðè:î;V§=7·ð¼gyßaĘý"ò~kÏmbvFDúô;÷ÜyÔîw¬b/c]ŽêmÞ‚é—f™’Ï«Ðì’ëÞ•œ¡ig
b„Fµ‚Ìá¼ç{û4‰w:Á+_î÷$!t"ÆËZ ~b. +±ƒ… +e[3ËF4±ÁGÓ窳ةïÍ7´»‡íZ×¹´ZüýU¡5¡7CmÓR <縄YZ=BÒ¦I”où;ìKžv%<Úwõ1’WÚ˜0ƶg>{q_ ââM“õzqç‹ !:;š$:5ÙX5X“©ì¾5ñŠ%ùÃV0yä5Ÿ$‰ÉÈ¥)¯g¨Nm4Šï$Çø»nóèµ´Ž4[JPæ34q{QØkøû%Ä6M?GR8Þ#ø÷ÖCÖõÇÀ³mca›P±«ž‚•!:û÷ŠÞÂ$3J¬é•‰D°WÎåÕãÎÖ¦†õÍ9•B|Û£sO5\^Chï×^á‘Ú’—Œ)ÀŠÏ2Îw‡ü¸üשc> SÚ\áåèSuÆ]¦#býQàèç`l
³ÒëbÀÖÜñ,šåÌ9œl¦åN#§}%q.ÔÃØKT±ÐêTËdí¯¤éź%šÆ´Û\ȸ¦¾?ûï®×c‚¬Y>&=΄æŠöMns¦g(î-å3ìK·wŒ©TªˆZ\è»Pé4 +·¿ ´ç¯æ.pòa\ÜN@%q¾”ò5ß›Ì7Zù»¥ˆÅ’$)žÜµ×w†ïÐ^'•X•h½Öög‹•Û2Uç#OÒÙ¶ù¿€‡þÏóG–ûDßä˜Z0,Çsštì+”½ÄͳÔ.ÃÚ™²L\üÍH¢<ýÕêa†â“¹6])Øgyרidê¤*`¦kík7R×RlCS,/›A©êt/m`;k´‹Q–gWÛ€5•ë3m#¨Ý½2_™^åXjÕÓºåqu¦ü‹+óaªŒÑh·Œý¹[gki!˜{QîÁd c›}ð¿¢·KK
Kt9J„¸Â¡Äæ:-%i_ñ¶›¡¾ÛEdpO¹æÞÃ@ðÏ£ "ê±Õò7è]+¾Á"LÕæ”n»!âøµ-òvSPU•3ÃNbáÿ|+Ùû•?$HÑì¹Ôñ3¨yöXøÃÏÀ2ƒµb›ÆÕÁoŽHE91âs›‡kxék1œ)ÁEyOúš‘=7sǪö8#8) â%3F!ÿ£qüw;@T¸üu°"RpØÉ6hÖn‰V§@zx^àæàqšhí”GN\‘ºQ$̉8MÔ<»$¤„âÌ“Vzj¯ëw0ƒ"ø…¶1Ri +ØƒÆ JòBN¼Ôçþ÷ßLÈ¢vž
-ŽaÎmÌcp¹ì¥èex?GŸhUû/5Ê|_.‘
s(¹úeccSÍ7v¿ÉHtÇáBø…ÙþŸ³2?¬¾ZFê·EåÍSÔOiøîi$ö+M¹F/²]Xê0°¼
΃ž^ÓqÐ"I*~f‰,"ªI !œ.û鵞>}ÑrSp$»Ú¡Ø¤çC˜M}çÛg
€šÿ…ÖÔ÷Eâ”t 7Ã÷·=|ˆFÇHó‰ýÅyœ’®-ÃÉÅ +Mò—2ÀÀfä +²ù™Eï[%†çL=ò¼I„söl/ŠUVN¢ŠíU<N‘Pà7ñä ¾½¡âÁH*
©±æý‘3ð”JéUH(ÝJªëöpG ¶%DºÍè.^Ì\vŒ¢ïo¿ÁsÐÍH÷UÜjåO¹¦PW$’âI’[Ç¡SI ‘ýÌ6ш$D`·’<änwTƒ}„ÝŒÛàJµ¶Œç=‡øð÷úša
B¡\;!MÓO€Â-?5ç#?㔄,X'š¯‘XÛ‹
6ºLÛ:4¿Z‚kÉ· +S»úÖ„ NsµâŠÞ•^d“D·yw€•~ /±¤e)æÊJ·â¨
±k-g.ã}PØÛYC%§o~[ßZ±Ç6åžÆ- nQ§{sÁZ¥½: y}xÃ:—wÐ!rÿ³ÿËÁ€. ´ÂzK¯ms"Á«ÅC·¸n‹/$±¿S«ðÏÒ£êôÀ€º‰:o +Al0½fMæ@Kâþ2¾;«cKôæ“W“R<.ý·üðhÒätÿ+-ˆk~yÇ€&NÉ ÚyW:”[ê¾íð°1 +{‹X?Îå¶úW7ͼ‚zß™ï™P¨TŽ³à-]òÛº˜*?åë»ó°{Ûè¿ãwwKpÈ P”é@ï-éç)¨‹ièûÃIê6üá›ïk«†ìoTÌõø1UXªC?^àôî™aç’ó–ä6/áíPÇNèdú¨J}|ª<€à˜Š³{ÝßëRÝ,"R‹(öÄU7÷`ŠÉÐLÛl2ÉgJ¿@žHÐ6é +‰Þ•Çt›Ö…áÅØYç·êJ' µìM]¯ tÆ"vÍ"YƒBÓ¼óˆSv±rgW¿®y’ßø¬‡€SâÌÀ¦Û?:ÁR·Ð/ɵ匼|y›ª&âôü†Þ’½©€Žî÷=]ÏUççp†7^ïÒ—7}>'zXõø3€?Úkè÷vÖOåûLW°Þ@ê&J5ÉD‡DE¬—ýk¢Ï†ùeÿ2ñARøä=UaÇ°£Hé4ûPºêBÉÖ_tHÚ7w?-ô1rnrsûG$˜ä©GÂ3ÆõÎ[ÞAƾ&¶ä†B$ iÌ÷z?óž‹{OW›íOΫt»òå¹`ÉÔùm¾Ç¤%íôkHÇi¢×tÇh¤SÍÇça^˜8.ù&³.hæS‡!ù[‰yWWÄÂú·øX½³æ¥ñû\8oµ½$
}YI¿\“ê*·?Ú¬«“A𸔎I7¥f†x¥»õ)d”|kg3h-)K¼Ú²_»:_«Ì<ˆÔðé…|97ÖÃ'TwÁÄvïpg¯ 2n–üÜíË™M ¯ÃŽkªméœßÞê5EÙ‚ä"Õ-xÓõt<yQ‘'‹ñIÙ.k·ßqŽ")¬¿üŠÄ„Ç„5'ø¦ó +@-ú ¯í´g†ÁÞ†p‰ö^³œ½¿…óo3\ŠÂ7Ë4˜M,òaŘ-&Ž×Pâñæ0°ÛT4ynT…Í©a°µ¤W[á¤bi¤¨¾:gE?ò†DX˜IlÈ] ‹1ðzö¤f©ö¸¼d'1SÅÙ¸’9xæуðÐïb‰jf\çË}ë+JnÂ21}Æ +Ü«Y)ä74EõÇ.¦«‚Æ&„,pÁ-Ág(Q?[|d(HNGž9dÍüj“Ÿ0<¤Dû˜½¨UÖ©Lsž½`£Lå™a¤N¯ë3·CÍúž×,¼¹s؈WåﶛÅj—±ã…™2O³Ë]+¨ë–”˜t0;¸êµ5í¿š¦&ÇÆçüâ ËŠ±²›ÀSgƒT˪„ŠÆíÛŸ®œp%sèÔiW©žA6;8BóãÉdâe×+æmúÛ ¾vJ¥&Üfævú¸Š~¯ù<°1'¢ÁµN91e]ä¶("Ò×ç~5”õ¥ +—àýE…ùŒ/wTÎ,û“h«$ó”¡w_+ˆ¸2ˆ¥Z{79Q Ø€ÿ¥gßÙ¤¯mÞ°\»Ëx(aˆ:/h—…¬‹<ë!Böm£–ÜŽbý⩖秸ø‚4Å[c,ÿ´8ò¤Å±úí SÒ!Š¿¤í)}NåIs‚¸K6.:O,þ#â }*FÍ\œ_n¼4E‚Q¾?ð´Ô)½ÉuNÛï*¼øÏõ‡Î¤œ–¸yí°—wUoÐÊënXÇÜ9gôUgIBΘµ³GÑÿ›À)„j™õ]è·÷Tc¹V{Ûù©âÐŽ’¯ñN»°~ [Z0©œ3‚Ê ÞYYý’Î\ÈçF’¤fc¼ÉÀaæÈ¡Ù×IS‡k´ÔˆB1ƒø–º|í£9R£¿·K͸["lîÄ9™Ý,~©#×µX¯ã…5Êd—¢”“CâÈÙ>ÉA‡wx…Á^V»ÕEÀ#ŒÈ$!P:-âsK KË>I[uØ— ³!w÷õÕ~ÆaŽ˜ºË_ .«ç’ÛèÐ9n€Œ\`í43¸0êÁä¿PÁçW¾[Or^üiÝ/¢ìãwT8Ýý~¹ºaK%òD€†ïJ} +%öý[ÿŒ hm%ª±µ- +nÌïŠuéKzf/‚$Ûb«ŠO±™û©
Í3³Üʶ…Æ´GiuÕW +ô.§'•ÝtKŸ”à—Ÿ¨kPSB*~ÂðúâÎ'YÇXÓ‘ÄÐQÓ[Ýo~¾·ü†ë
+=¢ÌXɸwÒø6¡Ô ”Zé bÝrðîŠïïùn«W¢Û©1—È<1 —›¼Nçø¨§`†Ê»Ç˲ ò3ë9†R Do `ÆjäK¥k>y9Ò$äòu„ϱ”LÈpºeûušQ»€ _¯DÒMªg +–)¾^š{-Øùc0kœGÄ>'̘±oâIôG®#}¿ì͚͘‹7[(Û{äö¦â*æ_@Ô稈ê1òóEß¿šŸ¡>›¸§ö‹QÇõ÷´×AØ
i¦Aû–VŲ'}AOžW¦Y7vz‚î¿Óµâx,T¿lNæ˜ö¦×GHF¹Ö³b°„VŠqŽ%JSŠ ÖóQÁƒÄ@$M ÕnZ‘p„ÑÞ ¶<cï8Ñ¿ç†5øö¤%”mÖèCÏ–Šî…«"šÄ›ƒ ØWßrÛØpÅ4ŒS‰ôGáqàºÂÅõ¤7Fò¸d•°‡5îò”‹Ë³’Òbòa›ó¯÷{`«±ƒ`¬ÜFœM÷â +4á°dÉÆöƒ¡ë÷]7Néˆ×5{IMÄ+hœøqÖwM¸êüÍV£ŸØ¿êÅ”q¶Å`àžå׆;î•bG¿osIbã ÖNÞÎÀS‘{Fÿ3òùt«Qe¾Y¾±€Nmå^"'yv@¢NUDÕÛ4ÿN&¤WãÑd3`!ýwÌ.LêŸû,è² °’Qˆ£/Ý9þUØ¥þÄ›Ý{1›’\äÒ‚¶fË„Âà°XL˜0)ˆãžªÓ^ô˜[”ܳ±Bøzé©÷^J•Ù&)eÔ™L7IèÓólå®åÑé‚f¯7<p--›¨*1,–sG&?¿VÕc‡0‰KfP°…œ\ÍšºcɶÞaÒ\O!Y½Ë0Ýò‡(X:d+!g}¢üŠæ'ÙH£ÉK/–~±Hé;¦J›×оì\”µ`± ³,¯ýȵFýã@õf{ਛU +¦ÃG]䲜qðôBUÛtÐW9Ú…ÍÖØ\ëg¬`óŽ»UEøà‚h-âV–^Ùã‰kˆå±(ãgf§&—pq +(±Îôól¬8Ÿ’¥Ýù€ÂjwO«ÿý¹bZæåIÔè{o'²Äm’ ½Ë£ÿQ·]=Ü7,C$þ)DÛ×{5FÖ¤)>+€Üø5…]š¬jÄ¥=á’}©&™HTÔæ–#Ö>ªf <DDï'¹ÊX¢m3¿«ÊŠƒ¨’"x/Fˆ¤žÇýÍ<߉iòÉwXWE¾êhÿRWŠpqÊi+‘]Â4V›Î7Ê’3qÛv»ÅÜ…¾¿¦P!/Yäk<™P‚9{yWÙÐ Ÿ¼¡×gYZ¹DÒ%˶͋/mýXBq?-ø}kMÏâp~_µ/‹7úÂ_ŠOØÂþ
§²ãféum½nÅ9î˜?ô銦xÐàŒŠ<AëXà~t;`qTøeõDxã}VYþ|ÙÌ8ÕáýX^cÒÀ.ŸÏ6†<døNÇ/¦}ôm\ö¯0ß}j{±'?š(~V$>HÎvþjãÞ½/ð‹®]µOãÖŠ¤Æ¥Çö +$µ. +d•3´Èv¾ toè‘÷^¢žö“ÀŸÏv!-!KŠtRoõôî?épµô’sö¯P§S½mÜË)ïYçsã-t>k(Š5zRñr{$´RKw£äƺâá-¾~g .WuOÚQÊcýiÝ•\[“ÎOV¿¾…u>‘ÔˆêÙºË YRã°Á6Ž|Y
¹Òñ-L8/Ó¹Uá±D‘£x¢Ópt‰ùFâa‹å[ë7ŸPÚF)Ú.>p +zopå^ÕÂ/E¨ÀóP´,Øù(‚ô¿# âÒÛ¶‡óg¬Ø;ØÜ}2¬’ÙÄ(xI]¶=öß>•mé–ãÉ–MÌ+ÌÓƪáWî>õ¿ÊVß<
Óï~UL{ýÅ"<¿$Ÿ‚Óž#
V.ܤ¶™<ó©žûí%NGÖzø8k“FåðÝ<u^=wº´Åë¡4 e2Y¦ñ°ÕÙiª™êìí.dˆ¡!Pç%H8eÛWC~_÷·L7r¦ûºÑÎqŠnê³–»vFèðgw´Ï¢H“;©Às…–Ñ–9MûfÐQ]Œ0£p4R’ž@óÿå÷ÿüÀÄhäèlgcäh÷ÿ endobj 627 0 obj << /Type /Font @@ -5798,14 +5801,14 @@ endobj /FirstChar 34 /LastChar 125 /Widths 1345 0 R -/BaseFont /TFCGYJ+NimbusMonL-Bold +/BaseFont /XPASOR+NimbusMonL-Bold /FontDescriptor 625 0 R >> endobj 625 0 obj << /Ascent 624 /CapHeight 552 /Descent -126 -/FontName /TFCGYJ+NimbusMonL-Bold +/FontName /XPASOR+NimbusMonL-Bold /ItalicAngle 0 /StemV 101 /XHeight 439 @@ -5830,7 +5833,7 @@ xÚ¬·eT^ÝÒ%Š» øƒ»www÷÷w‚»»w‚»»w‚ww½yÏéî¯Ç¹}ÿôý~ì1öªª5kVÍZkìMA¢¤Ê læ`”p°wa Qg ±‹•ƒ½˜± 4ˆM¬¬ €¨ƒ£§³•…¥€Z]E“†ŽŽþ¿,ÿ„ ähkìù7÷_0Gg«ÑpYÙ[üz€3ÐÂØÙÌý…ù‹ýOwþ«NÀÿV½±££ç¿v;ü+êq°rmÍXXÿæ4uù›ÛÂÊéŸA‘¶7w -$aå4S²r1µ˜ÛþíÔ¿ìêöf@g[+{à_EÿÕL +$aå4S²r1µ˜ÛþíÔ¿ìêöf@g[+{à_EÿÕL pÊÅÔQ¯ôŽ ÉhB¿n¿ü Öìö6È£ Ç#´“{Q²È_³o—{K†ÎhäK’w–jÝ«Ò¾š›ŠâNšâžýñ¹îJ!Âák"øÔ3cC4[O4|qEÝ ÷®µûIûÒ‡òc~dZ¹³´Þ½f‚™a$µ E´ÕD᥷,"k |+Ë ·K|XÐ4áï赩9•3û¡ï\›õU‰ñ¤9ì븉£Ð¸ñZlà—ÜpPÓ•ŽÂ„Yñ©²g‡ßE”[?>yB¹ÜK”–.buúSc©zg‹Ü¼Úcòhwqj›%þbpŽ8¹wR8y< @@ -5903,7 +5906,7 @@ CÒ3ÉwÙ_&'€›ÏìA¿.﫸E
®wð“3e©g±T×ÎŒ!ÝÛçC4uº¹už×Å›ý4Þ7’Õœ±¸2¹¿3½¾„c¶ üòãVaï‚-Â}‘#Ô–oÞ>ã·8'…SJ6¨î£’s¹5Bùè,͈®x®*·‘|â¶\T˲PÝ0œB}±n{ïËPò#í½·/¬o‰.4Vz´cš×ÌÐû_t§ô–¼’ßÉspãMüƒ Âý,š«»omž§t~®»MzEåQÒZEƒ5tUàÓógó´iN5u}3ïÌì±ONâiZù or)vúm˜„Æf|!¥œ*¹Ö~Â’Y]µ|þF¡œV -îêõ´ì“&©jåN[N/¸†³ˆ=õÞ~¸kÆ~?Í¢ðH1{Ì)ê++?<rnþ›ò˧{Yb€œ¤ 'é0@¨u–-ä¿øàðDxÃÂ"‚aaÀÚnÀ[endstream +îêõ´ì“&©jåN[N/¸†³ˆ=õÞ~¸kÆ~?Í¢ðH1{Ì)ê++?<rnþ›ò˧{Yb€œ¤ 'é0@¨u–-ä¿øàðDxÃÂ"‚aaÀ–¨Àaendstream endobj 624 0 obj << /Type /Font @@ -5912,14 +5915,14 @@ endobj /FirstChar 33 /LastChar 125 /Widths 1346 0 R -/BaseFont /QHKFNE+NimbusMonL-Regu +/BaseFont /UKEFJN+NimbusMonL-Regu /FontDescriptor 622 0 R >> endobj 622 0 obj << /Ascent 625 /CapHeight 557 /Descent -147 -/FontName /QHKFNE+NimbusMonL-Regu +/FontName /UKEFJN+NimbusMonL-Regu /ItalicAngle 0 /StemV 41 /XHeight 426 @@ -5941,7 +5944,7 @@ endobj stream xÚ¬zSx¥]·eœTlcÇv%©Ø¶íìضmÛ¨Šm£b£bÛ6»¾ÿïÓ§ŸÓ}Õ}.ö~Þ5Çœcb¬µö¾xɉ”éM쌀bv¶ÎôÌL\ ´¶³·Ú:ÿ¥øTÎæ@€©…5 ,¯ ))' —SˆmŽ›Pp1²¶0ÈXm€Ô -Ë(gçü7%€êÿMe†ÿ>‘ÿ$þoø¿EÞÿ?qÿ«FÿÛ!þÿ=Ïÿ•ZÌÅÚZÎÐø¯ ÀÜ1 +Ë(gçü7%€êÿMe†ÿ>‘ÿ$þoø¿EÞÿ?qÿ«FÿÛ!þÿ=Ïÿ•ZÌÅÚZÎÐø¯ ÀÜ1 Hk \P3ÏØ©®â%ª«Q¶°sy1*õŸƒð3›Wž®õ;7 K³y²mÇZÉh\HÐçãîäÑ|Àÿ´_˜D®á!)?¬oöër$q0>°±ÏO„<X) @@ -6024,7 +6027,7 @@ lÅŸœ$f_dq_“ÉñøC–C'O§_œ„Í¢z™À7Í°5åAƒí`EûKࣃ„>Ò„rÖ:«Í·ä—ˆ•Ö’"îJìK4åäNÏ @¤õÃo_U¡;¤¢æªe?Z*½¿ÚOæËͦcZ¢6zÓ*î €mK1”£»ãß:¹<f:µ¦V.sF»øÎN®õÎîÅEQ‡gŒ‹uà,¥vz!ìuS,ñš#\¥€ª6KѯAÃIá)è˜SX1ïŒ~†‰<& ;Ã]zÜ)ZP=ëN¾Ðºg¼)Qµ°}¼>Õ˜z_#å*’Ðs,b½“o&‰ð]ÎÎì†Ò¬¦{˜±ãxÂZ©–\å.ÉÉq™5í—]Í_ãÓ~wX~˜½UÖ"bg¬%Ì—ÊÉbÙ¶Õ¾VÂ3a¾$þ—ì!íL;ENLãÖ[µô(ÁzŠþÐÞÂ
:\¦oŽìÿÞÉðdþÌn¤j’Pïn‰“Ì{:}*PDvŸw*[ð@9‚ Ô0a¸¦û[ßÅräÛ%Ó\qŸž]£÷Àëð|O-FêkÞ‹³€'‰Qö.ÊÂTqëÚĵ¦Îš)RžcÀ¾ôßØDã“V¶¢Ååž5yÔLùR„wOƒùͳ¬¯ãƲ¹ûx¥óuj2a™ dêMèaÁxö³]&e9õ};ªÄqÜm–íʳì $j´’V¢_yŸ¹6€W3‚èíRõѹc§EsšN1}œÇ‹”Çžácž!\°1£,,ᄬ¨\XMÔ›ÖÁ€DÊŸ&ë«~9F=Þ'KJk® -ÀÝÏói<ÐÿiŒö?Lüªµendstream +ÀÝÏói<ÐÿiŒö?*¼ªÅendstream endobj 618 0 obj << /Type /Font @@ -6033,14 +6036,14 @@ endobj /FirstChar 2 /LastChar 151 /Widths 1347 0 R -/BaseFont /AWWNBZ+URWPalladioL-Ital +/BaseFont /YIXLXK+URWPalladioL-Ital /FontDescriptor 616 0 R >> endobj 616 0 obj << /Ascent 722 /CapHeight 693 /Descent -261 -/FontName /AWWNBZ+URWPalladioL-Ital +/FontName /YIXLXK+URWPalladioL-Ital /ItalicAngle -9.5 /StemV 78 /XHeight 482 @@ -6056,21 +6059,20 @@ endobj /Length1 862 /Length2 1251 /Length3 532 -/Length 1861 +/Length 1860 /Filter /FlateDecode >> stream xÚíUkTgnõJÀ+Å€€¸ -æ2@ Š&X4–;rQ¤2$H20I0@(PÁ Bå"Pi¥´^€–‹ÁŠ‚g¹iL@°rÕtÐc—þÜýµggþÌû<Ï÷~Ï<ïwÎgfâáM ³‘`ØŠ ¤N®ÞA2 -¸"l®”úÁËæ\a6O"XÉ2ÅŸÇ¢Cø0@ -‡ò{õR
¾¯±”Pž ÉdbﻯÀ›}!d!lž0 PmE¡(v‚°Š -Ä€ -‚±Ìá?@d -†¡æÃœ?ÂÖoáå¡¿Çm1BßXÀ -ñ!w þsp"!P삽-ö# hØÙQý›%AQX(^:›XüïjKa®·a9$…æU'WÄ~qþΑ´^¶Uª{5›ýkcóyìcÞÔsž&!âÒÑbåÕr|˜B?Ëá”.zÅ Ã-ý«éÝ‹WÓŠÊý³â©MÄo|TbšlÍk+óQ¦<Â÷tÁ7JCZúèì·Û¶÷No‹kÓ9ÇV1oœìÖÞhéuÒÒt³]ïÍ7ᣞtn¬Ë»±“5qû¾Ó/rN3Wpµƒ§¡ÙǸ@N¤Baå9Bo¹§RÕgϯwOo ->5N5M1{Þê].I‹5ŒùíV¸&þnêXFñÌ×îZ¸&cÆõ;ò¤JRfüÞFc£¶GÖÜW›Û¬ÜdŸ„W]©5h}ìóK˜òF¥¹¹,öE9VP“k¼çitÄ÷õ;ç|ðLj_VŸ>ø¬´^®Ý]¯êîº×ë”ù²PËC#â*¹:+«åž#á‡Çm:ºïì-}/ø@Ç໯=kpîókŒ–áÁã×Ã)Z¦².;#ó¯|_1W—¯•Xl•\ŠK¤õ«nvvTã‡sb™“Ì4½Ük 0Žo_eÙ¼QV§×SsV&ïÓ1ÖìWfEë)Ld•â çŒölfz†G ›§ÿ—q‡›ó’ÝŸ«Õ}/*ž•!gwŒmIóS'3O´¾œ°š{kÓ.u•ú§šGÁ—mf -4éåg׫˜ -$§ý&Ãÿâ.nar67z*õÜ?L_Æ
þ>ùýÆ¢PÂO1–CÈ}Ù3q#®'˸ϕîuÕeÆ&Ä^ûq»¤žÐHœ#*KjW®yŠ¿iÔyhߊqD\Ö‘ˆ1
]÷rÙí„šë²…²Ù6–óÏJÅ´°Õˆú©G¸¦wëŽ=“k_.ð9µã'5ÅRÒú]ÍvЃéjŸMo2}Ÿw0ôs? û›î¬¿úUDÞü‘aõq•»¬O~÷a~£ôÁï*ŒXŸí–üšœèLhhí¿UdKU}8©¼^ycLÒpÓÁ\FRÞ¦ø$œÉb”æù]üQíź¢²x\ÕÔØS7Ÿ4(Z‡î)ª>¥Í£œgÎã“•¥´Ï½÷ýGsNÒ_üýéMb÷ºV©Q™£*ejºD«õÍV¬ö!÷A=Ùœ•%ƒR½F²¯™ +æ2%P4-wTP¤2$H20I0@¹,P ‚A…ÊE ÒJi½ +& X¹ê +ºè±KîþÚ³3æ}žç{¿gž÷;ç33ñô!8²‘ ØŠ ¤Nn>A2 +ø“‰d2ˆ ±÷íWÀŠÍ>²6OP¨¶ +³p½ÝË>)$¯:¹"ö³s·¿ÿ€¤õ¢RÝ«ÙìW›ÏcÇøPÏz™‹KG‹•WŽËñ¡ +ýÏYö'uÑËîé_N—è^¸’VTî—Om"öøà#Ódk^Y™2åáN|4¤7¡Ï|³m{ïô¶¸6³lãйƹÁní–Þ',M7ÓzÏk¼¿ 9ð¸sëdm\Þõ¬‰[÷\™žx‘Kš¹‚ã 4
Í>Âp" ++¯Ç–»*åQ}öüzô&éãTÓ³g>åÒ™´XÃèßo†iâ癩eÏ|å¡…k2f\¸-Oº®$eÆïi4v5j{hÍ}¹¹ÍÊ]öQ0yÐzÕÅ‘ZƒöGû®S^«47—Å>/‡BjrŸD…W¿sn?>#†øEõ©ƒOKëåÚÝõz î®»½N™/ +µÜ;4Ò(n’+³²Zîñ1~xܦ£ûöžÒ‡ñ‚÷t¾ýÊ+ —á¹¼ÒÈh<v-Œ¢e*뢙yà%suùZQ‰Å&QÉÅø±DzÿQ°êFgx_5žq8'–9ÉLÓË
¾š +!üm94¡ÜÜ›=7âfp¢ŒûLéQg_]flB쵧%õ„DàPYR»rÍü
ëÀÎC{ïSŒÃ㲎„™xjèz”Ë.Ûk'$Ô\×-”…ÌîЉМV*¦…FÔ=3À5½[w8O~¨}©À{ääŽÕKIë·5ûØ÷§«÷ozyàYC?÷£ÐèÎú©_†çÍVSyÈúä—pïç7J¿üñ·¡ÒÉðõùWoʯʉ.„Ö‰Öþ›E¶TÅÑ“Êk•×Ç$
7ìÍe$å-Êþ„ÓYlÿÒ<ß?¨="Y—Uªš{êæSEaÐ]EÕÇôy”óÔe¼Â~²²ÔŸþ©ÏÞ_ã¨bÎ Çç¿œ$½Nì~®Q×*5*óeT¥LM—hµ¾Þê™Õ>ä1¨'›³²dPª×Hö6€4»Ýý†;œ9sç—Úµ¬÷U$FÛéx7:á,?ÔyòÓæݯ¸ùOiD§È‡‹øÄuþ÷T«TêSFaô{ò€Š1b]aÚù_Ýw*S’ç#¶ä]k¬Øu ÙìÓò€vlÃlÓËDÕ7™Už¦«‹ûJ*ƶábuÁÀ$ñö²·p}Â(5ñiQBCG¸çÀ\—$§!7!Ç]~9Šœù¸)ökµÑ)Ç÷D_uo€£ŒÚjnÿ=Õáh׺™;wáÔúBÙ˜«jU´fŸîN—²QÝÖ…Zöî–[£!CŽWµ$Aü6ÍŸd‡š@Â!ß¼tÍ›
‰ˆINzÀxwÁv}ÃuÙF{H¾?>¬iÿ˜ú`v«× íøT6Ý1¿é0S x}Î䇯£Ž¨Fü׆þÜ×¢¯ª«;rª³+Ù7ÖÕt®]šrZ9µqg{7áø®lGÌ}Ÿ3\OkôÏɵV'•Ç²;Bêmиƒ’ž˜lo^·`m`onç=òøàþßà¢vuC¨@h(î_Q=þ`endstream endobj 608 0 obj << /Type /Font @@ -6079,14 +6081,14 @@ endobj /FirstChar 13 /LastChar 110 /Widths 1349 0 R -/BaseFont /GAJUUV+CMSY10 +/BaseFont /DQSLCT+CMSY10 /FontDescriptor 606 0 R >> endobj 606 0 obj << /Ascent 750 /CapHeight 683 /Descent -194 -/FontName /GAJUUV+CMSY10 +/FontName /DQSLCT+CMSY10 /ItalicAngle -14.035 /StemV 85 /XHeight 431 @@ -6111,7 +6113,7 @@ endobj >> stream xÚ¬ºSek´&š•¶Í•¶mÛ¶mÛvf¥mÛf¥mVªÒ¶}kïÓ§OÇé~êÛ3bþßÀ7þ±VLRBeZA{#S1{;ZF:.€ª’º‚¡¡‰¥½’½!௘š”TØÉÔÐÅÒÞNÄÐÅ” nj1501999¡IÂöžN–æ. -0±tv°1ôüû/˜ƒ“å¿i¸:[Ú™ÿW4 +0±tv°1ôüû/˜ƒ“å¿i¸:[Ú™ÿW4 å< (&.ÕÃè25)hTbp§bâßVv*—èTï/o;eÚ0&±º¥Œ¤8FOX5Éávדñ9Ä–ªA àÊü<xâË…×i†y£Ýë*ÐAlyŸU9J’ô(°ÐƒcÆœÝÛÞne£U&¥»‡Û‡è›‡¶Ôœ¥1áÜå\³%Ö)ë]ŸüHÓO6QrB%¤(úkè>·Sog´mY²mÄl?dEŠL0ç…ÿœæ¿Ô¸Å¤ÍÙl\Õ–lfñm³lvÑ+bžþTê¢Jd‚þâ•*®%ß^÷%Mzú,yGºð¢È¨Nï‰ð,-’ Ó`Êá® Ø'J˜KnárËÏÅ%?ÙÜ\óÿâÞõý#„-îÌC½Jœn)„¦Á‚…`ªXS“.ôR°ßµPË,Ñ?Ž™·w©&|!ŽîŠŒ|Õfœ9p-¡BÝÕŸ—þBÐ9’ÐÇ1#ÄÙ€‹—i&®¼Úß= Ň’—cú²LcDvØ·÷GüS
>*²)œ&ü9?·»b“Ä);âxˆðpÆò÷<q{¬œ
šNبkßÄ^µNú:v–ˆóO[PÐfkpÛìÓä…&懦ÅnŠNZË,¯#j‹ìeؽ%
üî†A°ÜÍBÚ<´ iÌItxÍþSƒçŸˆ›ø¹C0¥ òym)¸ÍË•o¬¿|uM¦C¢˜F±uBmÆÇåIZÇëB¥ƒÝÑ=úë›GŠ×ûµ¶-ûÅÒÂoñ¨&N“N
d—âCMwvh¿2vYòj¢W*œÆX•_ £õ¼ÓíøZ ÅÓcA¢\k†Ø8+Ff @@ -6213,7 +6215,7 @@ pS>FŽÇ_è|/ÉQ꣰–—þù"t5@Óºá÷Qу;vä=íÚ[|r9>t4™ynÓry>lä<þ“ýÖˆ•ÑÓpeBïaÂ)& L€-²¥ø»¼Jîýý ¡YÆS4{Ú0…b3ð?°äVf‹±Ò‚"©†¾£:iHß^Áa1`IÊRŠOÊGë½qPÌŽ3†aµæÁ¶ìêÒZ (¾QûÈ´µ*½TÌ~4Wl?tnt49$ºÚÉ-zs^"ΉTŽ ¿ÚLi‹¨'}ãN~)™ØËžIS–+×XC” œï€tsai9£–Óv4êø&O¶ê¾ùš\CV昃ÉZLÞRÈÇHýI½…àV8’ãÚ«#w}Ýá¸û"--xõôLd:ÞÂ9cœBŒÂÙ*ï#»Ã¡áÕô„u ‰¨Ù³)ŸáB¤É®…uÏÎÛoU†LÁÄÙWsÞ×£ö>ÅÉÚéH\"ü…ô›šu0a&†
¸V•Úð¥;T§’›î:¾Ð×'—LÕ=¸‡ Bí;`51&®séUÐœ`¤‘ øŽºT¸‹¥{ Ð]ŸXêy‘ß²oÓ€$ð;ñ^¯$bМǒƒeR¨õJQ°~ð’½¢h•ƒöjtÁð’£ Aš–ÝHFþŒßæ¦>ù~~ÛŽÂÒ“]Ž3 Îk¥@\-`y-Œì|Šò -8¨™€¢íuÉu(
{¤”ðßÁá*¬Ï‡pr^!Þ¢ë0SQPVÆ;”M°(ÎE0’A æÛ£Ÿq E©¸›sFÍ5Ñ¥·¬XÌÖX;q¡{{ïHäP'Iðmå¨u葅ʲz~Ì|™Á¦¤Ê×춻rŠŸ2µÕГ(ÚÆDÕ Š·Ž¾Lb`Ån\a#ð-7ÊaÐ@ß™HÙ¶-dØä.`séBÈ‹Å(Óâ‚4æ/gËÏÂ1‹´ˆ¶êC- +8¨™€¢íuÉu(
{¤”ðßÁá*¬Ï‡pr^!Þ¢ë0SQPVÆ;”M°(ÎE0’A æÛ£Ÿq E©¸›sFÍ5Ñ¥·¬XÌÖX;q¡{{ïHäP'Iðmå¨u葅ʲz~Ì|™Á¦¤Ê×춻rŠŸ2µÕГ(ÚÆDÕ Š·Ž¾Lb`Ån\a#ð-7ÊaÐ@ß™HÙ¶-dØä.`séBÈ‹Å(Óâ‚4æ/gËÏÂ1‹´ˆ¶êC- endobj 600 0 obj << /Type /Font @@ -6222,14 +6224,14 @@ endobj /FirstChar 2 /LastChar 151 /Widths 1350 0 R -/BaseFont /LUQXUL+URWPalladioL-Roma +/BaseFont /BHGHRC+URWPalladioL-Roma /FontDescriptor 598 0 R >> endobj 598 0 obj << /Ascent 715 /CapHeight 680 /Descent -282 -/FontName /LUQXUL+URWPalladioL-Roma +/FontName /BHGHRC+URWPalladioL-Roma /ItalicAngle 0 /StemV 84 /XHeight 469 @@ -6250,7 +6252,7 @@ endobj >> stream xÚ¬zceß³eÙ¶ë–m£Ë¶mÛ¶mWuÙ¶mÛ6»Œ®.×ôïÿ4ñf>ͼ'âìÌÜ+WæʽãÞˆCF¤ L'hbod*foçBÇDÏÈ
PURW0´±14±´—¡²·1ü5³Á‘ ;™ºXÚÛ‰º˜rÔMM -7µ3u2´(¸ÙXd,MíœM© +7µ3u2´(¸ÙXd,MíœM© ð|I¨ ‘wÈ»8hN‚ôÊà3/Õc¼o—eöÀ´ØÕN¦•ôJ? ðg»Xœ nÿP¸ ‘>; ø§7Æ£w#5¡Ôýº$O>ÿóL1<16:Òw>pŒK“MÆãOà˜‹Ë¯¥Z)ZÝL~Ó‘mÂ{ôÔ*’»RÆ¢)ï0=ã½Ég—\"nsYâ‚{s’?ËçžiE«vY«Ôè€9¡ÇΗ©5{ý‰÷r=Fa‘ŠÚòBLÖÔ—J|‚íuÿáq™ßx&™å2‹r&G-H.‹Û"]pYÝÝÝÜ "+0TjêkÉ™”“Œ†yF @@ -6357,7 +6359,7 @@ Lœ›Ê%…LeÌ¿+1Œ-•*ŒÂ0G70ýo2ˆ…"³ôd°Ç\g¶i7±ÝâsqLÆ7!õòîÏ¢{ßr%tCáòA@ò 6_mŠq'2~‹Ò=aFŠ†þÐœ²?Ç ¯Z¡._|;l[×OX˜àJÁ+QGýiÜZÉP&Yyf2—<²è•rŒGÜ75·ïá3òŽÃ#z‡FF⨾ãúF4þN¸ü5àcíÚ6P·¡“eä è‡Ék¢œu_KŸ¥°L‹*·éñ0MH¼CrœT>Ü㇟x FÿàRÂB_!äµi¨NÙ%$hâ]tÞ‰¢èÛîûs¶¼ª=nù<ü¨òÁËY©ÞØîƒQKñ™ÆýgF==ˆ3šöùsCì¶G’Ð!YŠ
WaðŠ +·Yà¾]ˆh‘!{â#iŽ»¤"”¯ùù4bwËZ¨Xà2&£‘.¿l=b, ¢,Ùl<aâr7à')¬Í‹RQÜ.)ö2—.‘ч¥r×uü)RÖ\-Cà" ¨{0öÊðeh饑@s£²çäV>ÔúAœ¦Gôì©5W0!ÒãBîV\Êå6ÔÔëߥåíýŽá;RÐ$øžv(Ó@ÃICM«Çv¹Ì_§/# È ÙÌÑ‚§õ±Á¿2å6ôw’ä{0ëó¬+/6A3C¿X ¬Ÿ? -¥0©jT™¶„qÚ]¡ÁÂ'DY¸
ö.g¬Âñ¨û;AJÒ´á¿ÔÍ[ßÇHûaA@Ôñ ?ÍJµAì»tI•%[Ø$Òð³"ɾs™ÿ?÷€ÿ +¥0©jT™¶„qÚ]¡ÁÂ'DY¸
ö.g¬Âñ¨û;AJÒ´á¿ÔÍ[ßÇHûaA@Ôñ ?ÍJµAì»tI•%[Ø$Òð³"ɾs™ÿ?÷€ÿ endobj 597 0 obj << /Type /Font @@ -6366,14 +6368,14 @@ endobj /FirstChar 2 /LastChar 151 /Widths 1351 0 R -/BaseFont /ADDUWK+URWPalladioL-Bold +/BaseFont /CBLIBS+URWPalladioL-Bold /FontDescriptor 595 0 R >> endobj 595 0 obj << /Ascent 708 /CapHeight 672 /Descent -266 -/FontName /ADDUWK+URWPalladioL-Bold +/FontName /CBLIBS+URWPalladioL-Bold /ItalicAngle 0 /StemV 123 /XHeight 471 @@ -7554,7 +7556,7 @@ endobj /Count -4 >> endobj 1357 0 obj << -/Names [(Access_Control_Lists) 1172 0 R (Bv9ARM.ch01) 613 0 R (Bv9ARM.ch02) 667 0 R (Bv9ARM.ch03) 682 0 R (Bv9ARM.ch04) 730 0 R (Bv9ARM.ch05) 810 0 R (Bv9ARM.ch06) 822 0 R (Bv9ARM.ch07) 1171 0 R (Bv9ARM.ch08) 1189 0 R (Bv9ARM.ch09) 1205 0 R (Configuration_File_Grammar) 849 0 R (DNSSEC) 782 0 R (Doc-Start) 594 0 R (Setting_TTLs) 1141 0 R (access_control) 963 0 R (acl) 857 0 R (address_match_lists) 827 0 R (admin_tools) 704 0 R (appendix.A) 554 0 R (bibliography) 1217 0 R (boolean_options) 736 0 R (builtin) 1025 0 R (chapter.1) 6 0 R (chapter.2) 66 0 R (chapter.3) 90 0 R (chapter.4) 130 0 R (chapter.5) 226 0 R (chapter.6) 238 0 R (chapter.7) 510 0 R (chapter.8) 534 0 R (cite.RFC1034) 1233 0 R (cite.RFC1035) 1235 0 R (cite.RFC1101) 1290 0 R (cite.RFC1123) 1292 0 R (cite.RFC1183) 1270 0 R (cite.RFC1464) 1310 0 R (cite.RFC1535) 1262 0 R (cite.RFC1536) 1264 0 R (cite.RFC1537) 1300 0 R (cite.RFC1591) 1294 0 R (cite.RFC1706) 1272 0 R (cite.RFC1712) 1324 0 R (cite.RFC1713) 1312 0 R (cite.RFC1794) 1314 0 R (cite.RFC1876) 1274 0 R (cite.RFC1886) 1254 0 R (cite.RFC1912) 1302 0 R (cite.RFC1982) 1266 0 R (cite.RFC1995) 1240 0 R (cite.RFC1996) 1242 0 R (cite.RFC2010) 1304 0 R (cite.RFC2052) 1280 0 R (cite.RFC2065) 1256 0 R (cite.RFC2136) 1244 0 R (cite.RFC2137) 1258 0 R (cite.RFC2163) 1282 0 R (cite.RFC2168) 1284 0 R (cite.RFC2181) 1246 0 R (cite.RFC2219) 1306 0 R (cite.RFC2230) 1286 0 R (cite.RFC2240) 1316 0 R (cite.RFC2308) 1248 0 R (cite.RFC2317) 1296 0 R (cite.RFC2345) 1318 0 R (cite.RFC2352) 1320 0 R (cite.RFC2845) 1250 0 R (cite.RFC974) 1237 0 R (cite.id2492507) 1333 0 R (configuration_file_elements) 823 0 R (controls_statement_definition_and_usage) 718 0 R (diagnostic_tools) 655 0 R (dynamic_update) 734 0 R (dynamic_update_policies) 774 0 R (dynamic_update_security) 972 0 R (historical_dns_information) 1212 0 R (id2466061) 614 0 R (id2466116) 615 0 R (id2466798) 619 0 R (id2466807) 620 0 R (id2467648) 690 0 R (id2467665) 691 0 R (id2468484) 635 0 R (id2468627) 637 0 R (id2468647) 638 0 R (id2468673) 999 0 R (id2468955) 639 0 R (id2469040) 642 0 R (id2469114) 649 0 R (id2469205) 652 0 R (id2469226) 653 0 R (id2469245) 654 0 R (id2469274) 660 0 R (id2469306) 661 0 R (id2469332) 662 0 R (id2469364) 668 0 R (id2469388) 669 0 R (id2469399) 670 0 R (id2469481) 671 0 R (id2469490) 677 0 R (id2469521) 684 0 R (id2469537) 685 0 R (id2470116) 694 0 R (id2470121) 695 0 R (id2471306) 723 0 R (id2471318) 724 0 R (id2471731) 745 0 R (id2472292) 761 0 R (id2472308) 762 0 R (id2472342) 763 0 R (id2472358) 769 0 R (id2472366) 770 0 R (id2472406) 771 0 R (id2472458) 772 0 R (id2472502) 779 0 R (id2472516) 780 0 R (id2472633) 781 0 R (id2472699) 790 0 R (id2472766) 791 0 R (id2472909) 792 0 R (id2472933) 797 0 R (id2472992) 799 0 R (id2473012) 800 0 R (id2473112) 811 0 R (id2473387) 824 0 R (id2474020) 832 0 R (id2474046) 833 0 R (id2474140) 838 0 R (id2474155) 839 0 R (id2474184) 840 0 R (id2474329) 850 0 R (id2474694) 856 0 R (id2474736) 858 0 R (id2474862) 860 0 R (id2475131) 868 0 R (id2475146) 869 0 R (id2475169) 870 0 R (id2475190) 871 0 R (id2475261) 880 0 R (id2475456) 881 0 R (id2475508) 882 0 R (id2476201) 897 0 R (id2476729) 903 0 R (id2476870) 904 0 R (id2476933) 912 0 R (id2476977) 913 0 R (id2476992) 914 0 R (id2478682) 934 0 R (id2479682) 960 0 R (id2479800) 962 0 R (id2479979) 971 0 R (id2480136) 977 0 R (id2480730) 989 0 R (id2480746) 990 0 R (id2480984) 997 0 R (id2483483) 1017 0 R (id2484007) 1032 0 R (id2484633) 1042 0 R (id2484681) 1043 0 R (id2484818) 1049 0 R (id2485431) 1058 0 R (id2485437) 1059 0 R (id2485442) 1060 0 R (id2485675) 1066 0 R (id2485706) 1067 0 R (id2486739) 1105 0 R (id2486966) 1107 0 R (id2486984) 1108 0 R (id2487005) 1111 0 R (id2487213) 1117 0 R (id2487864) 1123 0 R (id2487973) 1125 0 R (id2488131) 1130 0 R (id2488352) 1132 0 R (id2488467) 1134 0 R (id2488485) 1135 0 R (id2488790) 1142 0 R (id2488896) 1144 0 R (id2488909) 1145 0 R (id2489001) 1147 0 R (id2489020) 1148 0 R (id2489076) 1154 0 R (id2489139) 1155 0 R (id2489170) 1156 0 R (id2489230) 1161 0 R (id2489562) 1182 0 R (id2489638) 1183 0 R (id2489832) 1184 0 R (id2489971) 1190 0 R (id2489976) 1191 0 R (id2489988) 1192 0 R (id2490005) 1193 0 R (id2490203) 1206 0 R (id2490209) 1207 0 R (id2490396) 1213 0 R (id2490708) 1215 0 R (id2491052) 1229 0 R (id2491054) 1231 0 R (id2491063) 1236 0 R (id2491086) 1232 0 R (id2491110) 1234 0 R (id2491147) 1245 0 R (id2491173) 1247 0 R (id2491198) 1239 0 R (id2491223) 1241 0 R (id2491246) 1243 0 R (id2491302) 1249 0 R (id2491363) 1252 0 R (id2491378) 1253 0 R (id2491416) 1255 0 R (id2491456) 1257 0 R (id2491483) 1260 0 R (id2491492) 1261 0 R (id2491517) 1263 0 R (id2491585) 1265 0 R (id2491621) 1268 0 R (id2491626) 1269 0 R (id2491684) 1271 0 R (id2491721) 1283 0 R (id2491756) 1273 0 R (id2491811) 1279 0 R (id2491850) 1281 0 R (id2491877) 1285 0 R (id2491904) 1288 0 R (id2491911) 1289 0 R (id2491937) 1291 0 R (id2491960) 1293 0 R (id2491981) 1295 0 R (id2492028) 1298 0 R (id2492036) 1299 0 R (id2492061) 1301 0 R (id2492088) 1303 0 R (id2492124) 1305 0 R (id2492164) 1308 0 R (id2492184) 1309 0 R (id2492206) 1311 0 R (id2492231) 1313 0 R (id2492256) 1315 0 R (id2492278) 1317 0 R (id2492324) 1319 0 R (id2492348) 1322 0 R (id2492355) 1323 0 R (id2492496) 1330 0 R (id2492505) 1332 0 R (id2492507) 1334 0 R (incremental_zone_transfers) 742 0 R (internet_drafts) 1325 0 R (ipv6addresses) 801 0 R (journal) 735 0 R (lwresd) 812 0 R (notify) 731 0 R (options) 923 0 R (page.1) 593 0 R (page.10) 689 0 R (page.11) 700 0 R (page.12) 708 0 R (page.13) 715 0 R (page.14) 722 0 R (page.15) 729 0 R (page.16) 741 0 R (page.17) 750 0 R (page.18) 755 0 R (page.19) 759 0 R (page.2) 605 0 R (page.20) 768 0 R (page.21) 778 0 R (page.22) 789 0 R (page.23) 796 0 R (page.24) 805 0 R (page.25) 809 0 R (page.26) 817 0 R (page.27) 821 0 R (page.28) 831 0 R (page.29) 837 0 R (page.3) 612 0 R (page.30) 845 0 R (page.31) 855 0 R (page.32) 865 0 R (page.33) 879 0 R (page.34) 886 0 R (page.35) 890 0 R (page.36) 896 0 R (page.37) 902 0 R (page.38) 911 0 R (page.39) 918 0 R (page.4) 631 0 R (page.40) 922 0 R (page.41) 927 0 R (page.42) 933 0 R (page.43) 940 0 R (page.44) 955 0 R (page.45) 959 0 R (page.46) 969 0 R (page.47) 976 0 R (page.48) 984 0 R (page.49) 988 0 R (page.5) 648 0 R (page.50) 996 0 R (page.51) 1003 0 R (page.52) 1008 0 R (page.53) 1015 0 R (page.54) 1023 0 R (page.55) 1031 0 R (page.56) 1039 0 R (page.57) 1048 0 R (page.58) 1053 0 R (page.59) 1057 0 R (page.6) 659 0 R (page.60) 1065 0 R (page.61) 1077 0 R (page.62) 1088 0 R (page.63) 1104 0 R (page.64) 1116 0 R (page.65) 1122 0 R (page.66) 1129 0 R (page.67) 1140 0 R (page.68) 1153 0 R (page.69) 1160 0 R (page.7) 666 0 R (page.70) 1166 0 R (page.71) 1170 0 R (page.72) 1178 0 R (page.73) 1188 0 R (page.74) 1200 0 R (page.75) 1204 0 R (page.76) 1211 0 R (page.77) 1224 0 R (page.78) 1278 0 R (page.79) 1329 0 R (page.8) 676 0 R (page.9) 681 0 R (proposed_standards) 746 0 R (rfcs) 644 0 R (rndc) 875 0 R (rrset_ordering) 696 0 R (sample_configuration) 683 0 R (section*.1) 1228 0 R (section*.10) 1321 0 R (section*.11) 1331 0 R (section*.2) 1230 0 R (section*.3) 1238 0 R (section*.4) 1251 0 R (section*.5) 1259 0 R (section*.6) 1267 0 R (section*.7) 1287 0 R (section*.8) 1297 0 R (section*.9) 1307 0 R (section.1.1) 10 0 R (section.1.2) 14 0 R (section.1.3) 18 0 R (section.1.4) 22 0 R (section.2.1) 70 0 R (section.2.2) 74 0 R (section.2.3) 78 0 R (section.2.4) 82 0 R (section.2.5) 86 0 R (section.3.1) 94 0 R (section.3.2) 106 0 R (section.3.3) 110 0 R (section.4.1) 134 0 R (section.4.2) 138 0 R (section.4.3) 146 0 R (section.4.4) 150 0 R (section.4.5) 154 0 R (section.4.6) 190 0 R (section.4.7) 194 0 R (section.4.8) 198 0 R (section.4.9) 214 0 R (section.5.1) 230 0 R (section.5.2) 234 0 R (section.6.1) 242 0 R (section.6.2) 270 0 R (section.6.3) 462 0 R (section.7.1) 514 0 R (section.7.2) 518 0 R (section.7.3) 530 0 R (section.8.1) 538 0 R (section.8.2) 546 0 R (section.8.3) 550 0 R (section.A.1) 558 0 R (section.A.2) 566 0 R (section.A.3) 574 0 R (server_statement_definition_and_usage) 951 0 R (server_statement_grammar) 1034 0 R (statsfile) 929 0 R (subsection.1.4.1) 26 0 R (subsection.1.4.2) 30 0 R (subsection.1.4.3) 34 0 R (subsection.1.4.4) 38 0 R (subsection.1.4.5) 54 0 R (subsection.1.4.6) 62 0 R (subsection.3.1.1) 98 0 R (subsection.3.1.2) 102 0 R (subsection.3.3.1) 114 0 R (subsection.3.3.2) 126 0 R (subsection.4.2.1) 142 0 R (subsection.4.5.1) 158 0 R (subsection.4.5.2) 170 0 R (subsection.4.5.3) 174 0 R (subsection.4.5.4) 178 0 R (subsection.4.5.5) 182 0 R (subsection.4.5.6) 186 0 R (subsection.4.8.1) 202 0 R (subsection.4.8.2) 206 0 R (subsection.4.8.3) 210 0 R (subsection.4.9.1) 218 0 R (subsection.4.9.2) 222 0 R (subsection.6.1.1) 246 0 R (subsection.6.1.2) 258 0 R (subsection.6.2.1) 274 0 R (subsection.6.2.10) 310 0 R (subsection.6.2.11) 322 0 R (subsection.6.2.12) 326 0 R (subsection.6.2.13) 330 0 R (subsection.6.2.14) 334 0 R (subsection.6.2.15) 338 0 R (subsection.6.2.16) 342 0 R (subsection.6.2.17) 414 0 R (subsection.6.2.18) 418 0 R (subsection.6.2.19) 422 0 R (subsection.6.2.2) 278 0 R (subsection.6.2.20) 426 0 R (subsection.6.2.21) 430 0 R (subsection.6.2.22) 434 0 R (subsection.6.2.23) 438 0 R (subsection.6.2.24) 442 0 R (subsection.6.2.3) 282 0 R (subsection.6.2.4) 286 0 R (subsection.6.2.5) 290 0 R (subsection.6.2.6) 294 0 R (subsection.6.2.7) 298 0 R (subsection.6.2.8) 302 0 R (subsection.6.2.9) 306 0 R (subsection.6.3.1) 466 0 R (subsection.6.3.2) 478 0 R (subsection.6.3.3) 482 0 R (subsection.6.3.4) 486 0 R (subsection.6.3.5) 490 0 R (subsection.6.3.6) 506 0 R (subsection.7.2.1) 522 0 R (subsection.7.2.2) 526 0 R (subsection.8.1.1) 542 0 R (subsection.A.1.1) 562 0 R (subsection.A.2.1) 570 0 R (subsection.A.3.1) 578 0 R (subsection.A.3.2) 582 0 R (subsection.A.3.3) 586 0 R (subsubsection.1.4.4.1) 42 0 R (subsubsection.1.4.4.2) 46 0 R (subsubsection.1.4.4.3) 50 0 R (subsubsection.1.4.5.1) 58 0 R (subsubsection.3.3.1.1) 118 0 R (subsubsection.3.3.1.2) 122 0 R (subsubsection.4.5.1.1) 162 0 R (subsubsection.4.5.1.2) 166 0 R (subsubsection.6.1.1.1) 250 0 R (subsubsection.6.1.1.2) 254 0 R (subsubsection.6.1.2.1) 262 0 R (subsubsection.6.1.2.2) 266 0 R (subsubsection.6.2.10.1) 314 0 R (subsubsection.6.2.10.2) 318 0 R (subsubsection.6.2.16.1) 346 0 R (subsubsection.6.2.16.10) 382 0 R (subsubsection.6.2.16.11) 386 0 R (subsubsection.6.2.16.12) 390 0 R (subsubsection.6.2.16.13) 394 0 R (subsubsection.6.2.16.14) 398 0 R (subsubsection.6.2.16.15) 402 0 R (subsubsection.6.2.16.16) 406 0 R (subsubsection.6.2.16.17) 410 0 R (subsubsection.6.2.16.2) 350 0 R (subsubsection.6.2.16.3) 354 0 R (subsubsection.6.2.16.4) 358 0 R (subsubsection.6.2.16.5) 362 0 R (subsubsection.6.2.16.6) 366 0 R (subsubsection.6.2.16.7) 370 0 R (subsubsection.6.2.16.8) 374 0 R (subsubsection.6.2.16.9) 378 0 R (subsubsection.6.2.24.1) 446 0 R (subsubsection.6.2.24.2) 450 0 R (subsubsection.6.2.24.3) 454 0 R (subsubsection.6.2.24.4) 458 0 R (subsubsection.6.3.1.1) 470 0 R (subsubsection.6.3.1.2) 474 0 R (subsubsection.6.3.5.1) 494 0 R (subsubsection.6.3.5.2) 498 0 R (subsubsection.6.3.5.3) 502 0 R (table.1.1) 621 0 R (table.1.2) 636 0 R (table.3.1) 692 0 R (table.3.2) 725 0 R (table.6.1) 825 0 R (table.6.10) 1112 0 R (table.6.11) 1118 0 R (table.6.12) 1124 0 R (table.6.13) 1131 0 R (table.6.14) 1133 0 R (table.6.15) 1136 0 R (table.6.16) 1143 0 R (table.6.17) 1146 0 R (table.6.18) 1162 0 R (table.6.2) 851 0 R (table.6.3) 859 0 R (table.6.4) 898 0 R (table.6.5) 935 0 R (table.6.6) 1018 0 R (table.6.7) 1033 0 R (table.6.8) 1061 0 R (table.6.9) 1106 0 R (table.A.1) 1214 0 R (table.A.2) 1216 0 R (the_category_phrase) 892 0 R (the_sortlist_statement) 1009 0 R (topology) 1004 0 R (tsig) 760 0 R (tuning) 1019 0 R (types_of_resource_records_and_when_to_use_them) 643 0 R (view_statement_grammar) 1027 0 R (zone_statement_grammar) 965 0 R (zone_transfers) 737 0 R] +/Names [(Access_Control_Lists) 1172 0 R (Bv9ARM.ch01) 613 0 R (Bv9ARM.ch02) 667 0 R (Bv9ARM.ch03) 682 0 R (Bv9ARM.ch04) 730 0 R (Bv9ARM.ch05) 810 0 R (Bv9ARM.ch06) 822 0 R (Bv9ARM.ch07) 1171 0 R (Bv9ARM.ch08) 1189 0 R (Bv9ARM.ch09) 1205 0 R (Configuration_File_Grammar) 849 0 R (DNSSEC) 782 0 R (Doc-Start) 594 0 R (Setting_TTLs) 1141 0 R (access_control) 963 0 R (acl) 857 0 R (address_match_lists) 827 0 R (admin_tools) 704 0 R (appendix.A) 554 0 R (bibliography) 1217 0 R (boolean_options) 736 0 R (builtin) 1025 0 R (chapter.1) 6 0 R (chapter.2) 66 0 R (chapter.3) 90 0 R (chapter.4) 130 0 R (chapter.5) 226 0 R (chapter.6) 238 0 R (chapter.7) 510 0 R (chapter.8) 534 0 R (cite.RFC1034) 1233 0 R (cite.RFC1035) 1235 0 R (cite.RFC1101) 1290 0 R (cite.RFC1123) 1292 0 R (cite.RFC1183) 1270 0 R (cite.RFC1464) 1310 0 R (cite.RFC1535) 1262 0 R (cite.RFC1536) 1264 0 R (cite.RFC1537) 1300 0 R (cite.RFC1591) 1294 0 R (cite.RFC1706) 1272 0 R (cite.RFC1712) 1324 0 R (cite.RFC1713) 1312 0 R (cite.RFC1794) 1314 0 R (cite.RFC1876) 1274 0 R (cite.RFC1886) 1254 0 R (cite.RFC1912) 1302 0 R (cite.RFC1982) 1266 0 R (cite.RFC1995) 1240 0 R (cite.RFC1996) 1242 0 R (cite.RFC2010) 1304 0 R (cite.RFC2052) 1280 0 R (cite.RFC2065) 1256 0 R (cite.RFC2136) 1244 0 R (cite.RFC2137) 1258 0 R (cite.RFC2163) 1282 0 R (cite.RFC2168) 1284 0 R (cite.RFC2181) 1246 0 R (cite.RFC2219) 1306 0 R (cite.RFC2230) 1286 0 R (cite.RFC2240) 1316 0 R (cite.RFC2308) 1248 0 R (cite.RFC2317) 1296 0 R (cite.RFC2345) 1318 0 R (cite.RFC2352) 1320 0 R (cite.RFC2845) 1250 0 R (cite.RFC974) 1237 0 R (cite.id2492354) 1333 0 R (configuration_file_elements) 823 0 R (controls_statement_definition_and_usage) 718 0 R (diagnostic_tools) 655 0 R (dynamic_update) 734 0 R (dynamic_update_policies) 774 0 R (dynamic_update_security) 972 0 R (historical_dns_information) 1212 0 R (id2466061) 614 0 R (id2466116) 615 0 R (id2466798) 619 0 R (id2466807) 620 0 R (id2467648) 690 0 R (id2467665) 691 0 R (id2468484) 635 0 R (id2468627) 637 0 R (id2468647) 638 0 R (id2468664) 999 0 R (id2468955) 639 0 R (id2469040) 642 0 R (id2469114) 649 0 R (id2469205) 652 0 R (id2469226) 653 0 R (id2469245) 654 0 R (id2469274) 660 0 R (id2469306) 661 0 R (id2469332) 662 0 R (id2469364) 668 0 R (id2469388) 669 0 R (id2469399) 670 0 R (id2469481) 671 0 R (id2469490) 677 0 R (id2469521) 684 0 R (id2469537) 685 0 R (id2470116) 694 0 R (id2470121) 695 0 R (id2471306) 723 0 R (id2471318) 724 0 R (id2471731) 745 0 R (id2472292) 761 0 R (id2472308) 762 0 R (id2472342) 763 0 R (id2472358) 769 0 R (id2472366) 770 0 R (id2472406) 771 0 R (id2472458) 772 0 R (id2472502) 779 0 R (id2472516) 780 0 R (id2472633) 781 0 R (id2472699) 790 0 R (id2472766) 791 0 R (id2472909) 792 0 R (id2472933) 797 0 R (id2472992) 799 0 R (id2473012) 800 0 R (id2473180) 811 0 R (id2473387) 824 0 R (id2474020) 832 0 R (id2474046) 833 0 R (id2474140) 838 0 R (id2474155) 839 0 R (id2474184) 840 0 R (id2474329) 850 0 R (id2474694) 856 0 R (id2474736) 858 0 R (id2474862) 860 0 R (id2475131) 868 0 R (id2475146) 869 0 R (id2475169) 870 0 R (id2475190) 871 0 R (id2475261) 880 0 R (id2475456) 881 0 R (id2475508) 882 0 R (id2476201) 897 0 R (id2476729) 903 0 R (id2476870) 904 0 R (id2476933) 912 0 R (id2476977) 913 0 R (id2476992) 914 0 R (id2478674) 934 0 R (id2479741) 960 0 R (id2479792) 962 0 R (id2479971) 971 0 R (id2480128) 977 0 R (id2480722) 989 0 R (id2480738) 990 0 R (id2480976) 997 0 R (id2483475) 1017 0 R (id2483930) 1032 0 R (id2484556) 1042 0 R (id2484673) 1043 0 R (id2484741) 1049 0 R (id2485414) 1058 0 R (id2485420) 1059 0 R (id2485425) 1060 0 R (id2485658) 1066 0 R (id2485689) 1067 0 R (id2486790) 1105 0 R (id2486949) 1107 0 R (id2486967) 1108 0 R (id2486988) 1111 0 R (id2487128) 1117 0 R (id2487779) 1123 0 R (id2487888) 1125 0 R (id2487909) 1130 0 R (id2488198) 1132 0 R (id2488313) 1134 0 R (id2488331) 1135 0 R (id2488705) 1142 0 R (id2488878) 1144 0 R (id2488892) 1145 0 R (id2488984) 1147 0 R (id2489003) 1148 0 R (id2489059) 1154 0 R (id2489122) 1155 0 R (id2489153) 1156 0 R (id2489213) 1161 0 R (id2489545) 1182 0 R (id2489621) 1183 0 R (id2489678) 1184 0 R (id2489885) 1190 0 R (id2489891) 1191 0 R (id2489902) 1192 0 R (id2489920) 1193 0 R (id2490050) 1206 0 R (id2490055) 1207 0 R (id2490243) 1213 0 R (id2490554) 1215 0 R (id2490899) 1229 0 R (id2490901) 1231 0 R (id2490909) 1236 0 R (id2491001) 1232 0 R (id2491025) 1234 0 R (id2491062) 1245 0 R (id2491088) 1247 0 R (id2491113) 1239 0 R (id2491138) 1241 0 R (id2491161) 1243 0 R (id2491217) 1249 0 R (id2491277) 1252 0 R (id2491292) 1253 0 R (id2491331) 1255 0 R (id2491370) 1257 0 R (id2491398) 1260 0 R (id2491406) 1261 0 R (id2491432) 1263 0 R (id2491499) 1265 0 R (id2491536) 1268 0 R (id2491541) 1269 0 R (id2491598) 1271 0 R (id2491636) 1283 0 R (id2491671) 1273 0 R (id2491725) 1279 0 R (id2491765) 1281 0 R (id2491792) 1285 0 R (id2491818) 1288 0 R (id2491826) 1289 0 R (id2491851) 1291 0 R (id2491875) 1293 0 R (id2491896) 1295 0 R (id2491943) 1298 0 R (id2491950) 1299 0 R (id2491976) 1301 0 R (id2492003) 1303 0 R (id2492039) 1305 0 R (id2492078) 1308 0 R (id2492099) 1309 0 R (id2492121) 1311 0 R (id2492146) 1313 0 R (id2492170) 1315 0 R (id2492193) 1317 0 R (id2492238) 1319 0 R (id2492263) 1322 0 R (id2492269) 1323 0 R (id2492342) 1330 0 R (id2492352) 1332 0 R (id2492354) 1334 0 R (incremental_zone_transfers) 742 0 R (internet_drafts) 1325 0 R (ipv6addresses) 801 0 R (journal) 735 0 R (lwresd) 812 0 R (notify) 731 0 R (options) 923 0 R (page.1) 593 0 R (page.10) 689 0 R (page.11) 700 0 R (page.12) 708 0 R (page.13) 715 0 R (page.14) 722 0 R (page.15) 729 0 R (page.16) 741 0 R (page.17) 750 0 R (page.18) 755 0 R (page.19) 759 0 R (page.2) 605 0 R (page.20) 768 0 R (page.21) 778 0 R (page.22) 789 0 R (page.23) 796 0 R (page.24) 805 0 R (page.25) 809 0 R (page.26) 817 0 R (page.27) 821 0 R (page.28) 831 0 R (page.29) 837 0 R (page.3) 612 0 R (page.30) 845 0 R (page.31) 855 0 R (page.32) 865 0 R (page.33) 879 0 R (page.34) 886 0 R (page.35) 890 0 R (page.36) 896 0 R (page.37) 902 0 R (page.38) 911 0 R (page.39) 918 0 R (page.4) 631 0 R (page.40) 922 0 R (page.41) 927 0 R (page.42) 933 0 R (page.43) 940 0 R (page.44) 955 0 R (page.45) 959 0 R (page.46) 969 0 R (page.47) 976 0 R (page.48) 984 0 R (page.49) 988 0 R (page.5) 648 0 R (page.50) 996 0 R (page.51) 1003 0 R (page.52) 1008 0 R (page.53) 1015 0 R (page.54) 1023 0 R (page.55) 1031 0 R (page.56) 1039 0 R (page.57) 1048 0 R (page.58) 1053 0 R (page.59) 1057 0 R (page.6) 659 0 R (page.60) 1065 0 R (page.61) 1077 0 R (page.62) 1088 0 R (page.63) 1104 0 R (page.64) 1116 0 R (page.65) 1122 0 R (page.66) 1129 0 R (page.67) 1140 0 R (page.68) 1153 0 R (page.69) 1160 0 R (page.7) 666 0 R (page.70) 1166 0 R (page.71) 1170 0 R (page.72) 1178 0 R (page.73) 1188 0 R (page.74) 1200 0 R (page.75) 1204 0 R (page.76) 1211 0 R (page.77) 1224 0 R (page.78) 1278 0 R (page.79) 1329 0 R (page.8) 676 0 R (page.9) 681 0 R (proposed_standards) 746 0 R (rfcs) 644 0 R (rndc) 875 0 R (rrset_ordering) 696 0 R (sample_configuration) 683 0 R (section*.1) 1228 0 R (section*.10) 1321 0 R (section*.11) 1331 0 R (section*.2) 1230 0 R (section*.3) 1238 0 R (section*.4) 1251 0 R (section*.5) 1259 0 R (section*.6) 1267 0 R (section*.7) 1287 0 R (section*.8) 1297 0 R (section*.9) 1307 0 R (section.1.1) 10 0 R (section.1.2) 14 0 R (section.1.3) 18 0 R (section.1.4) 22 0 R (section.2.1) 70 0 R (section.2.2) 74 0 R (section.2.3) 78 0 R (section.2.4) 82 0 R (section.2.5) 86 0 R (section.3.1) 94 0 R (section.3.2) 106 0 R (section.3.3) 110 0 R (section.4.1) 134 0 R (section.4.2) 138 0 R (section.4.3) 146 0 R (section.4.4) 150 0 R (section.4.5) 154 0 R (section.4.6) 190 0 R (section.4.7) 194 0 R (section.4.8) 198 0 R (section.4.9) 214 0 R (section.5.1) 230 0 R (section.5.2) 234 0 R (section.6.1) 242 0 R (section.6.2) 270 0 R (section.6.3) 462 0 R (section.7.1) 514 0 R (section.7.2) 518 0 R (section.7.3) 530 0 R (section.8.1) 538 0 R (section.8.2) 546 0 R (section.8.3) 550 0 R (section.A.1) 558 0 R (section.A.2) 566 0 R (section.A.3) 574 0 R (server_statement_definition_and_usage) 951 0 R (server_statement_grammar) 1034 0 R (statsfile) 929 0 R (subsection.1.4.1) 26 0 R (subsection.1.4.2) 30 0 R (subsection.1.4.3) 34 0 R (subsection.1.4.4) 38 0 R (subsection.1.4.5) 54 0 R (subsection.1.4.6) 62 0 R (subsection.3.1.1) 98 0 R (subsection.3.1.2) 102 0 R (subsection.3.3.1) 114 0 R (subsection.3.3.2) 126 0 R (subsection.4.2.1) 142 0 R (subsection.4.5.1) 158 0 R (subsection.4.5.2) 170 0 R (subsection.4.5.3) 174 0 R (subsection.4.5.4) 178 0 R (subsection.4.5.5) 182 0 R (subsection.4.5.6) 186 0 R (subsection.4.8.1) 202 0 R (subsection.4.8.2) 206 0 R (subsection.4.8.3) 210 0 R (subsection.4.9.1) 218 0 R (subsection.4.9.2) 222 0 R (subsection.6.1.1) 246 0 R (subsection.6.1.2) 258 0 R (subsection.6.2.1) 274 0 R (subsection.6.2.10) 310 0 R (subsection.6.2.11) 322 0 R (subsection.6.2.12) 326 0 R (subsection.6.2.13) 330 0 R (subsection.6.2.14) 334 0 R (subsection.6.2.15) 338 0 R (subsection.6.2.16) 342 0 R (subsection.6.2.17) 414 0 R (subsection.6.2.18) 418 0 R (subsection.6.2.19) 422 0 R (subsection.6.2.2) 278 0 R (subsection.6.2.20) 426 0 R (subsection.6.2.21) 430 0 R (subsection.6.2.22) 434 0 R (subsection.6.2.23) 438 0 R (subsection.6.2.24) 442 0 R (subsection.6.2.3) 282 0 R (subsection.6.2.4) 286 0 R (subsection.6.2.5) 290 0 R (subsection.6.2.6) 294 0 R (subsection.6.2.7) 298 0 R (subsection.6.2.8) 302 0 R (subsection.6.2.9) 306 0 R (subsection.6.3.1) 466 0 R (subsection.6.3.2) 478 0 R (subsection.6.3.3) 482 0 R (subsection.6.3.4) 486 0 R (subsection.6.3.5) 490 0 R (subsection.6.3.6) 506 0 R (subsection.7.2.1) 522 0 R (subsection.7.2.2) 526 0 R (subsection.8.1.1) 542 0 R (subsection.A.1.1) 562 0 R (subsection.A.2.1) 570 0 R (subsection.A.3.1) 578 0 R (subsection.A.3.2) 582 0 R (subsection.A.3.3) 586 0 R (subsubsection.1.4.4.1) 42 0 R (subsubsection.1.4.4.2) 46 0 R (subsubsection.1.4.4.3) 50 0 R (subsubsection.1.4.5.1) 58 0 R (subsubsection.3.3.1.1) 118 0 R (subsubsection.3.3.1.2) 122 0 R (subsubsection.4.5.1.1) 162 0 R (subsubsection.4.5.1.2) 166 0 R (subsubsection.6.1.1.1) 250 0 R (subsubsection.6.1.1.2) 254 0 R (subsubsection.6.1.2.1) 262 0 R (subsubsection.6.1.2.2) 266 0 R (subsubsection.6.2.10.1) 314 0 R (subsubsection.6.2.10.2) 318 0 R (subsubsection.6.2.16.1) 346 0 R (subsubsection.6.2.16.10) 382 0 R (subsubsection.6.2.16.11) 386 0 R (subsubsection.6.2.16.12) 390 0 R (subsubsection.6.2.16.13) 394 0 R (subsubsection.6.2.16.14) 398 0 R (subsubsection.6.2.16.15) 402 0 R (subsubsection.6.2.16.16) 406 0 R (subsubsection.6.2.16.17) 410 0 R (subsubsection.6.2.16.2) 350 0 R (subsubsection.6.2.16.3) 354 0 R (subsubsection.6.2.16.4) 358 0 R (subsubsection.6.2.16.5) 362 0 R (subsubsection.6.2.16.6) 366 0 R (subsubsection.6.2.16.7) 370 0 R (subsubsection.6.2.16.8) 374 0 R (subsubsection.6.2.16.9) 378 0 R (subsubsection.6.2.24.1) 446 0 R (subsubsection.6.2.24.2) 450 0 R (subsubsection.6.2.24.3) 454 0 R (subsubsection.6.2.24.4) 458 0 R (subsubsection.6.3.1.1) 470 0 R (subsubsection.6.3.1.2) 474 0 R (subsubsection.6.3.5.1) 494 0 R (subsubsection.6.3.5.2) 498 0 R (subsubsection.6.3.5.3) 502 0 R (table.1.1) 621 0 R (table.1.2) 636 0 R (table.3.1) 692 0 R (table.3.2) 725 0 R (table.6.1) 825 0 R (table.6.10) 1112 0 R (table.6.11) 1118 0 R (table.6.12) 1124 0 R (table.6.13) 1131 0 R (table.6.14) 1133 0 R (table.6.15) 1136 0 R (table.6.16) 1143 0 R (table.6.17) 1146 0 R (table.6.18) 1162 0 R (table.6.2) 851 0 R (table.6.3) 859 0 R (table.6.4) 898 0 R (table.6.5) 935 0 R (table.6.6) 1018 0 R (table.6.7) 1033 0 R (table.6.8) 1061 0 R (table.6.9) 1106 0 R (table.A.1) 1214 0 R (table.A.2) 1216 0 R (the_category_phrase) 892 0 R (the_sortlist_statement) 1009 0 R (topology) 1004 0 R (tsig) 760 0 R (tuning) 1019 0 R (types_of_resource_records_and_when_to_use_them) 643 0 R (view_statement_grammar) 1027 0 R (zone_statement_grammar) 965 0 R (zone_transfers) 737 0 R] /Limits [(Access_Control_Lists) (zone_transfers)] >> endobj 1358 0 obj << @@ -7573,7 +7575,7 @@ endobj >> endobj 1361 0 obj << /Author()/Title()/Subject()/Creator(LaTeX with hyperref package)/Producer(pdfeTeX-1.21a)/Keywords() -/CreationDate (D:20050906152727+10'00') +/CreationDate (D:20051012113434+10'00') /PTEX.Fullbanner (This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) kpathsea version 3.5.4) >> endobj xref @@ -7584,927 +7586,927 @@ xref 0000000004 00000 f 0000000000 00000 f 0000000009 00000 n -0000018861 00000 n -0000483527 00000 n +0000018860 00000 n +0000483530 00000 n 0000000054 00000 n 0000000086 00000 n -0000018985 00000 n -0000483455 00000 n +0000018984 00000 n +0000483458 00000 n 0000000133 00000 n 0000000173 00000 n -0000019110 00000 n -0000483369 00000 n +0000019109 00000 n +0000483372 00000 n 0000000221 00000 n 0000000273 00000 n -0000019235 00000 n -0000483283 00000 n +0000019234 00000 n +0000483286 00000 n 0000000321 00000 n 0000000377 00000 n -0000023670 00000 n -0000483173 00000 n +0000023669 00000 n +0000483176 00000 n 0000000425 00000 n 0000000478 00000 n -0000023794 00000 n -0000483099 00000 n +0000023793 00000 n +0000483102 00000 n 0000000531 00000 n 0000000572 00000 n -0000023919 00000 n -0000483012 00000 n +0000023918 00000 n +0000483015 00000 n 0000000625 00000 n 0000000674 00000 n -0000024044 00000 n -0000482925 00000 n +0000024043 00000 n +0000482928 00000 n 0000000727 00000 n 0000000757 00000 n -0000028192 00000 n -0000482801 00000 n +0000028191 00000 n +0000482804 00000 n 0000000810 00000 n 0000000861 00000 n -0000028317 00000 n -0000482727 00000 n +0000028316 00000 n +0000482730 00000 n 0000000919 00000 n 0000000964 00000 n -0000028442 00000 n -0000482640 00000 n +0000028441 00000 n +0000482643 00000 n 0000001022 00000 n 0000001062 00000 n -0000028567 00000 n -0000482566 00000 n +0000028566 00000 n +0000482569 00000 n 0000001120 00000 n 0000001162 00000 n -0000031476 00000 n -0000482442 00000 n +0000031475 00000 n +0000482445 00000 n 0000001215 00000 n 0000001260 00000 n -0000031601 00000 n -0000482381 00000 n +0000031600 00000 n +0000482384 00000 n 0000001318 00000 n 0000001355 00000 n -0000031726 00000 n -0000482307 00000 n +0000031725 00000 n +0000482310 00000 n 0000001408 00000 n 0000001463 00000 n -0000034114 00000 n -0000482182 00000 n +0000034113 00000 n +0000482185 00000 n 0000001509 00000 n 0000001556 00000 n -0000034239 00000 n -0000482108 00000 n +0000034238 00000 n +0000482111 00000 n 0000001604 00000 n 0000001648 00000 n -0000034364 00000 n -0000482021 00000 n +0000034363 00000 n +0000482024 00000 n 0000001696 00000 n 0000001735 00000 n -0000034487 00000 n -0000481934 00000 n +0000034486 00000 n +0000481937 00000 n 0000001783 00000 n 0000001825 00000 n -0000034611 00000 n -0000481847 00000 n +0000034610 00000 n +0000481850 00000 n 0000001873 00000 n 0000001936 00000 n -0000035647 00000 n -0000481773 00000 n +0000035646 00000 n +0000481776 00000 n 0000001984 00000 n 0000002034 00000 n -0000037325 00000 n -0000481645 00000 n +0000037324 00000 n +0000481648 00000 n 0000002080 00000 n 0000002126 00000 n -0000037449 00000 n -0000481532 00000 n +0000037448 00000 n +0000481535 00000 n 0000002174 00000 n 0000002218 00000 n -0000037574 00000 n -0000481456 00000 n +0000037573 00000 n +0000481459 00000 n 0000002271 00000 n 0000002323 00000 n -0000037699 00000 n -0000481379 00000 n +0000037698 00000 n +0000481382 00000 n 0000002377 00000 n 0000002436 00000 n -0000040315 00000 n -0000481288 00000 n +0000040314 00000 n +0000481291 00000 n 0000002485 00000 n 0000002523 00000 n -0000040566 00000 n -0000481171 00000 n +0000040565 00000 n +0000481174 00000 n 0000002572 00000 n 0000002618 00000 n -0000040692 00000 n -0000481053 00000 n +0000040691 00000 n +0000481056 00000 n 0000002672 00000 n 0000002739 00000 n -0000043871 00000 n -0000480974 00000 n +0000043870 00000 n +0000480977 00000 n 0000002798 00000 n 0000002842 00000 n -0000043997 00000 n -0000480895 00000 n +0000043996 00000 n +0000480898 00000 n 0000002901 00000 n 0000002949 00000 n -0000053820 00000 n -0000480816 00000 n +0000053819 00000 n +0000480819 00000 n 0000003003 00000 n 0000003036 00000 n -0000057086 00000 n -0000480684 00000 n +0000057085 00000 n +0000480687 00000 n 0000003083 00000 n 0000003126 00000 n -0000057212 00000 n -0000480605 00000 n +0000057211 00000 n +0000480608 00000 n 0000003175 00000 n 0000003205 00000 n -0000057338 00000 n -0000480473 00000 n +0000057337 00000 n +0000480476 00000 n 0000003254 00000 n 0000003292 00000 n -0000057463 00000 n -0000480408 00000 n +0000057462 00000 n +0000480411 00000 n 0000003346 00000 n 0000003388 00000 n -0000061910 00000 n -0000480315 00000 n +0000061909 00000 n +0000480318 00000 n 0000003437 00000 n 0000003496 00000 n -0000062036 00000 n -0000480222 00000 n +0000062035 00000 n +0000480225 00000 n 0000003545 00000 n 0000003578 00000 n -0000068737 00000 n -0000480090 00000 n +0000068736 00000 n +0000480093 00000 n 0000003627 00000 n 0000003655 00000 n -0000068863 00000 n -0000479972 00000 n +0000068862 00000 n +0000479975 00000 n 0000003709 00000 n 0000003778 00000 n -0000068989 00000 n -0000479893 00000 n +0000068988 00000 n +0000479896 00000 n 0000003837 00000 n 0000003885 00000 n -0000069115 00000 n -0000479814 00000 n +0000069114 00000 n +0000479817 00000 n 0000003944 00000 n 0000003989 00000 n -0000072117 00000 n -0000479721 00000 n +0000072116 00000 n +0000479724 00000 n 0000004043 00000 n 0000004111 00000 n -0000072243 00000 n -0000479628 00000 n +0000072242 00000 n +0000479631 00000 n 0000004165 00000 n 0000004235 00000 n -0000072369 00000 n -0000479535 00000 n +0000072368 00000 n +0000479538 00000 n 0000004289 00000 n 0000004352 00000 n -0000072495 00000 n -0000479442 00000 n +0000072494 00000 n +0000479445 00000 n 0000004406 00000 n 0000004461 00000 n -0000076216 00000 n -0000479363 00000 n +0000076215 00000 n +0000479366 00000 n 0000004515 00000 n 0000004547 00000 n -0000076342 00000 n -0000479270 00000 n +0000076341 00000 n +0000479273 00000 n 0000004596 00000 n 0000004624 00000 n -0000076467 00000 n -0000479177 00000 n +0000076466 00000 n +0000479180 00000 n 0000004673 00000 n 0000004705 00000 n -0000076593 00000 n -0000479045 00000 n +0000076592 00000 n +0000479048 00000 n 0000004754 00000 n 0000004784 00000 n -0000080040 00000 n -0000478966 00000 n +0000080039 00000 n +0000478969 00000 n 0000004838 00000 n 0000004879 00000 n -0000080165 00000 n -0000478873 00000 n +0000080164 00000 n +0000478876 00000 n 0000004933 00000 n 0000004975 00000 n -0000080291 00000 n -0000478794 00000 n +0000080290 00000 n +0000478797 00000 n 0000005029 00000 n 0000005074 00000 n -0000082999 00000 n -0000478676 00000 n +0000082998 00000 n +0000478679 00000 n 0000005123 00000 n 0000005169 00000 n -0000083125 00000 n -0000478597 00000 n +0000083124 00000 n +0000478600 00000 n 0000005223 00000 n 0000005283 00000 n -0000083251 00000 n -0000478518 00000 n +0000083250 00000 n +0000478521 00000 n 0000005337 00000 n 0000005406 00000 n -0000086061 00000 n -0000478385 00000 n +0000086060 00000 n +0000478388 00000 n 0000005453 00000 n 0000005506 00000 n -0000086187 00000 n -0000478306 00000 n +0000086186 00000 n +0000478309 00000 n 0000005555 00000 n 0000005611 00000 n -0000086313 00000 n -0000478227 00000 n +0000086312 00000 n +0000478230 00000 n 0000005660 00000 n 0000005709 00000 n -0000090415 00000 n -0000478094 00000 n +0000090414 00000 n +0000478097 00000 n 0000005756 00000 n 0000005808 00000 n -0000090541 00000 n -0000477976 00000 n +0000090540 00000 n +0000477979 00000 n 0000005857 00000 n 0000005908 00000 n -0000094683 00000 n -0000477858 00000 n +0000094682 00000 n +0000477861 00000 n 0000005962 00000 n 0000006007 00000 n -0000094808 00000 n -0000477779 00000 n +0000094807 00000 n +0000477782 00000 n 0000006066 00000 n 0000006100 00000 n -0000094933 00000 n -0000477700 00000 n +0000094932 00000 n +0000477703 00000 n 0000006159 00000 n 0000006207 00000 n -0000098211 00000 n -0000477582 00000 n +0000098210 00000 n +0000477585 00000 n 0000006261 00000 n 0000006301 00000 n -0000098337 00000 n -0000477503 00000 n +0000098336 00000 n +0000477506 00000 n 0000006360 00000 n 0000006394 00000 n -0000098463 00000 n -0000477424 00000 n +0000098462 00000 n +0000477427 00000 n 0000006453 00000 n 0000006501 00000 n -0000102191 00000 n -0000477291 00000 n +0000102190 00000 n +0000477294 00000 n 0000006550 00000 n 0000006600 00000 n -0000105997 00000 n -0000477212 00000 n +0000105996 00000 n +0000477215 00000 n 0000006654 00000 n 0000006701 00000 n -0000106123 00000 n -0000477119 00000 n +0000106122 00000 n +0000477122 00000 n 0000006755 00000 n 0000006815 00000 n -0000106373 00000 n -0000477026 00000 n +0000106372 00000 n +0000477029 00000 n 0000006869 00000 n 0000006921 00000 n -0000106499 00000 n -0000476933 00000 n +0000106498 00000 n +0000476936 00000 n 0000006975 00000 n 0000007040 00000 n -0000111149 00000 n -0000476840 00000 n +0000111148 00000 n +0000476843 00000 n 0000007094 00000 n 0000007145 00000 n -0000111275 00000 n -0000476747 00000 n +0000111274 00000 n +0000476750 00000 n 0000007199 00000 n 0000007263 00000 n -0000111401 00000 n -0000476654 00000 n +0000111400 00000 n +0000476657 00000 n 0000007317 00000 n 0000007364 00000 n -0000111527 00000 n -0000476561 00000 n +0000111526 00000 n +0000476564 00000 n 0000007418 00000 n 0000007478 00000 n -0000114469 00000 n -0000476468 00000 n +0000114468 00000 n +0000476471 00000 n 0000007532 00000 n 0000007583 00000 n -0000114595 00000 n -0000476336 00000 n +0000114594 00000 n +0000476339 00000 n 0000007638 00000 n 0000007703 00000 n -0000114721 00000 n -0000476257 00000 n +0000114720 00000 n +0000476260 00000 n 0000007763 00000 n 0000007810 00000 n -0000125129 00000 n -0000476178 00000 n +0000125128 00000 n +0000476181 00000 n 0000007870 00000 n 0000007918 00000 n -0000128847 00000 n -0000476085 00000 n +0000128846 00000 n +0000476088 00000 n 0000007973 00000 n 0000008023 00000 n -0000128973 00000 n -0000475992 00000 n +0000128972 00000 n +0000475995 00000 n 0000008078 00000 n 0000008141 00000 n -0000130716 00000 n -0000475899 00000 n +0000130712 00000 n +0000475902 00000 n 0000008196 00000 n 0000008248 00000 n -0000130842 00000 n -0000475806 00000 n +0000130838 00000 n +0000475809 00000 n 0000008303 00000 n 0000008368 00000 n -0000130968 00000 n -0000475713 00000 n +0000130964 00000 n +0000475716 00000 n 0000008423 00000 n 0000008475 00000 n -0000136318 00000 n -0000475580 00000 n +0000136314 00000 n +0000475583 00000 n 0000008530 00000 n 0000008595 00000 n 0000140380 00000 n -0000475501 00000 n +0000475504 00000 n 0000008655 00000 n 0000008699 00000 n 0000159493 00000 n -0000475408 00000 n +0000475411 00000 n 0000008759 00000 n 0000008798 00000 n 0000159619 00000 n -0000475315 00000 n +0000475318 00000 n 0000008858 00000 n 0000008905 00000 n 0000159744 00000 n -0000475222 00000 n +0000475225 00000 n 0000008965 00000 n 0000009008 00000 n 0000163658 00000 n -0000475129 00000 n +0000475132 00000 n 0000009068 00000 n 0000009107 00000 n 0000166746 00000 n -0000475036 00000 n +0000475039 00000 n 0000009167 00000 n 0000009209 00000 n 0000166872 00000 n -0000474943 00000 n +0000474946 00000 n 0000009269 00000 n 0000009312 00000 n 0000174776 00000 n -0000474850 00000 n +0000474853 00000 n 0000009372 00000 n 0000009419 00000 n 0000174900 00000 n -0000474757 00000 n +0000474760 00000 n 0000009479 00000 n 0000009540 00000 n 0000178846 00000 n -0000474664 00000 n +0000474667 00000 n 0000009601 00000 n 0000009653 00000 n 0000178972 00000 n -0000474571 00000 n +0000474574 00000 n 0000009714 00000 n 0000009767 00000 n 0000181985 00000 n -0000474478 00000 n +0000474481 00000 n 0000009828 00000 n 0000009866 00000 n 0000185944 00000 n -0000474385 00000 n +0000474388 00000 n 0000009927 00000 n 0000009979 00000 n 0000189322 00000 n -0000474292 00000 n +0000474295 00000 n 0000010040 00000 n 0000010084 00000 n 0000189580 00000 n -0000474199 00000 n +0000474202 00000 n 0000010145 00000 n 0000010181 00000 n 0000194074 00000 n -0000474106 00000 n +0000474109 00000 n 0000010242 00000 n 0000010305 00000 n 0000197230 00000 n -0000474027 00000 n +0000474030 00000 n 0000010366 00000 n 0000010415 00000 n 0000197487 00000 n -0000473934 00000 n +0000473937 00000 n 0000010470 00000 n 0000010521 00000 n 0000197616 00000 n -0000473841 00000 n +0000473844 00000 n 0000010576 00000 n 0000010640 00000 n 0000202326 00000 n -0000473748 00000 n +0000473751 00000 n 0000010695 00000 n 0000010752 00000 n 0000202455 00000 n -0000473655 00000 n +0000473658 00000 n 0000010807 00000 n 0000010877 00000 n 0000206018 00000 n -0000473562 00000 n +0000473565 00000 n 0000010932 00000 n 0000010981 00000 n 0000206147 00000 n -0000473469 00000 n +0000473472 00000 n 0000011036 00000 n 0000011098 00000 n -0000207911 00000 n -0000473376 00000 n +0000207912 00000 n +0000473379 00000 n 0000011153 00000 n 0000011202 00000 n -0000211360 00000 n -0000473258 00000 n +0000211361 00000 n +0000473261 00000 n 0000011257 00000 n 0000011319 00000 n -0000211489 00000 n -0000473179 00000 n +0000211490 00000 n +0000473182 00000 n 0000011379 00000 n 0000011418 00000 n -0000216452 00000 n -0000473086 00000 n +0000216453 00000 n +0000473089 00000 n 0000011478 00000 n 0000011512 00000 n -0000216581 00000 n -0000472993 00000 n +0000216582 00000 n +0000472996 00000 n 0000011572 00000 n 0000011613 00000 n -0000226764 00000 n -0000472914 00000 n +0000226765 00000 n +0000472917 00000 n 0000011673 00000 n 0000011725 00000 n -0000230938 00000 n -0000472796 00000 n +0000230939 00000 n +0000472799 00000 n 0000011774 00000 n 0000011807 00000 n -0000231067 00000 n -0000472678 00000 n +0000231068 00000 n +0000472681 00000 n 0000011861 00000 n 0000011933 00000 n -0000231195 00000 n -0000472599 00000 n +0000231196 00000 n +0000472602 00000 n 0000011992 00000 n 0000012036 00000 n -0000238969 00000 n -0000472520 00000 n +0000238970 00000 n +0000472523 00000 n 0000012095 00000 n 0000012148 00000 n -0000242553 00000 n -0000472427 00000 n +0000242554 00000 n +0000472430 00000 n 0000012202 00000 n 0000012252 00000 n -0000245916 00000 n -0000472334 00000 n +0000245917 00000 n +0000472337 00000 n 0000012306 00000 n 0000012344 00000 n -0000246174 00000 n -0000472241 00000 n +0000246175 00000 n +0000472244 00000 n 0000012398 00000 n 0000012447 00000 n -0000246432 00000 n -0000472109 00000 n +0000246433 00000 n +0000472112 00000 n 0000012501 00000 n 0000012553 00000 n -0000246561 00000 n -0000472030 00000 n +0000246562 00000 n +0000472033 00000 n 0000012612 00000 n 0000012664 00000 n -0000249442 00000 n -0000471937 00000 n +0000249443 00000 n +0000471940 00000 n 0000012723 00000 n 0000012776 00000 n -0000249571 00000 n -0000471858 00000 n +0000249572 00000 n +0000471861 00000 n 0000012835 00000 n 0000012884 00000 n -0000249700 00000 n -0000471779 00000 n +0000249701 00000 n +0000471782 00000 n 0000012938 00000 n 0000013018 00000 n -0000255562 00000 n -0000471646 00000 n +0000255563 00000 n +0000471649 00000 n 0000013065 00000 n 0000013117 00000 n -0000255691 00000 n -0000471567 00000 n +0000255692 00000 n +0000471570 00000 n 0000013166 00000 n 0000013210 00000 n -0000259402 00000 n -0000471435 00000 n +0000259403 00000 n +0000471438 00000 n 0000013259 00000 n 0000013321 00000 n -0000259531 00000 n -0000471356 00000 n +0000259532 00000 n +0000471359 00000 n 0000013375 00000 n 0000013423 00000 n -0000259660 00000 n -0000471277 00000 n +0000259661 00000 n +0000471280 00000 n 0000013477 00000 n 0000013528 00000 n -0000259789 00000 n -0000471198 00000 n +0000259790 00000 n +0000471201 00000 n 0000013577 00000 n 0000013624 00000 n -0000262719 00000 n -0000471065 00000 n +0000262720 00000 n +0000471068 00000 n 0000013671 00000 n 0000013708 00000 n -0000262848 00000 n -0000470947 00000 n +0000262849 00000 n +0000470950 00000 n 0000013757 00000 n 0000013796 00000 n -0000262977 00000 n -0000470882 00000 n +0000262978 00000 n +0000470885 00000 n 0000013850 00000 n 0000013928 00000 n -0000263106 00000 n -0000470789 00000 n +0000263107 00000 n +0000470792 00000 n 0000013977 00000 n 0000014044 00000 n -0000263235 00000 n -0000470710 00000 n +0000263236 00000 n +0000470713 00000 n 0000014093 00000 n 0000014138 00000 n -0000266737 00000 n -0000470591 00000 n +0000266738 00000 n +0000470594 00000 n 0000014186 00000 n 0000014218 00000 n -0000266866 00000 n -0000470473 00000 n +0000266867 00000 n +0000470476 00000 n 0000014267 00000 n 0000014306 00000 n -0000266995 00000 n -0000470408 00000 n +0000266996 00000 n +0000470411 00000 n 0000014360 00000 n 0000014421 00000 n -0000271002 00000 n -0000470276 00000 n +0000271003 00000 n +0000470279 00000 n 0000014470 00000 n 0000014527 00000 n -0000271131 00000 n -0000470211 00000 n +0000271132 00000 n +0000470214 00000 n 0000014581 00000 n 0000014630 00000 n -0000271519 00000 n -0000470093 00000 n +0000271520 00000 n +0000470096 00000 n 0000014679 00000 n 0000014741 00000 n -0000271648 00000 n -0000470014 00000 n +0000271649 00000 n +0000470017 00000 n 0000014795 00000 n 0000014850 00000 n -0000284749 00000 n -0000469921 00000 n +0000284750 00000 n +0000469924 00000 n 0000014904 00000 n 0000014945 00000 n -0000285811 00000 n -0000469842 00000 n +0000285812 00000 n +0000469845 00000 n 0000014999 00000 n 0000015051 00000 n -0000015407 00000 n -0000015655 00000 n +0000015406 00000 n +0000015654 00000 n 0000015104 00000 n -0000015529 00000 n -0000015592 00000 n -0000466701 00000 n -0000441037 00000 n -0000466527 00000 n -0000439988 00000 n -0000414053 00000 n -0000439814 00000 n -0000467706 00000 n -0000016307 00000 n -0000016122 00000 n -0000015740 00000 n -0000016244 00000 n -0000413368 00000 n -0000411223 00000 n -0000413204 00000 n -0000019486 00000 n -0000018676 00000 n -0000016392 00000 n -0000018798 00000 n -0000018922 00000 n -0000019047 00000 n -0000019172 00000 n -0000410369 00000 n -0000390011 00000 n -0000410195 00000 n -0000019297 00000 n -0000019360 00000 n -0000019423 00000 n -0000389070 00000 n -0000369671 00000 n -0000388897 00000 n -0000368944 00000 n -0000352560 00000 n -0000368771 00000 n -0000024169 00000 n -0000022987 00000 n -0000019610 00000 n -0000023481 00000 n -0000352025 00000 n -0000335108 00000 n -0000351841 00000 n -0000023544 00000 n -0000023607 00000 n -0000023731 00000 n -0000023856 00000 n -0000023981 00000 n -0000023137 00000 n -0000023330 00000 n -0000024106 00000 n -0000231131 00000 n -0000271712 00000 n -0000028692 00000 n -0000027657 00000 n -0000024293 00000 n -0000028129 00000 n -0000028254 00000 n -0000027807 00000 n -0000027969 00000 n -0000028379 00000 n -0000028504 00000 n -0000028629 00000 n -0000043934 00000 n -0000031850 00000 n -0000031291 00000 n -0000028816 00000 n -0000031413 00000 n -0000031538 00000 n -0000031663 00000 n -0000031787 00000 n -0000034736 00000 n -0000033929 00000 n -0000031961 00000 n -0000034051 00000 n -0000034176 00000 n -0000034301 00000 n -0000034426 00000 n -0000034548 00000 n -0000034673 00000 n -0000467824 00000 n -0000035772 00000 n -0000035462 00000 n -0000034821 00000 n -0000035584 00000 n -0000035709 00000 n -0000037825 00000 n -0000037140 00000 n -0000035870 00000 n -0000037262 00000 n -0000037387 00000 n -0000037511 00000 n -0000037636 00000 n -0000037762 00000 n -0000040818 00000 n -0000039951 00000 n -0000037923 00000 n -0000040252 00000 n -0000040378 00000 n -0000040441 00000 n -0000040503 00000 n -0000040093 00000 n -0000040629 00000 n -0000040755 00000 n +0000015528 00000 n +0000015591 00000 n +0000466704 00000 n +0000441040 00000 n +0000466530 00000 n +0000439991 00000 n +0000414056 00000 n +0000439817 00000 n +0000467709 00000 n +0000016306 00000 n +0000016121 00000 n +0000015739 00000 n +0000016243 00000 n +0000413371 00000 n +0000411227 00000 n +0000413207 00000 n +0000019485 00000 n +0000018675 00000 n +0000016391 00000 n +0000018797 00000 n +0000018921 00000 n +0000019046 00000 n +0000019171 00000 n +0000410373 00000 n +0000390015 00000 n +0000410199 00000 n +0000019296 00000 n +0000019359 00000 n +0000019422 00000 n +0000389074 00000 n +0000369675 00000 n +0000388901 00000 n +0000368948 00000 n +0000352564 00000 n +0000368775 00000 n +0000024168 00000 n +0000022986 00000 n +0000019609 00000 n +0000023480 00000 n +0000352029 00000 n +0000335112 00000 n +0000351845 00000 n +0000023543 00000 n +0000023606 00000 n +0000023730 00000 n +0000023855 00000 n +0000023980 00000 n +0000023136 00000 n +0000023329 00000 n +0000024105 00000 n +0000231132 00000 n +0000271713 00000 n +0000028691 00000 n +0000027656 00000 n +0000024292 00000 n +0000028128 00000 n +0000028253 00000 n +0000027806 00000 n +0000027968 00000 n +0000028378 00000 n +0000028503 00000 n +0000028628 00000 n +0000043933 00000 n +0000031849 00000 n +0000031290 00000 n +0000028815 00000 n +0000031412 00000 n +0000031537 00000 n +0000031662 00000 n +0000031786 00000 n +0000034735 00000 n +0000033928 00000 n +0000031960 00000 n +0000034050 00000 n +0000034175 00000 n +0000034300 00000 n +0000034425 00000 n +0000034547 00000 n +0000034672 00000 n +0000467827 00000 n +0000035771 00000 n +0000035461 00000 n +0000034820 00000 n +0000035583 00000 n +0000035708 00000 n +0000037824 00000 n +0000037139 00000 n +0000035869 00000 n +0000037261 00000 n +0000037386 00000 n +0000037510 00000 n +0000037635 00000 n +0000037761 00000 n +0000040817 00000 n +0000039950 00000 n +0000037922 00000 n +0000040251 00000 n +0000040377 00000 n +0000040440 00000 n +0000040502 00000 n +0000040092 00000 n +0000040628 00000 n +0000040754 00000 n 0000189386 00000 n -0000044123 00000 n -0000043686 00000 n -0000040929 00000 n -0000043808 00000 n -0000334581 00000 n -0000325272 00000 n -0000334404 00000 n -0000044060 00000 n -0000047628 00000 n -0000047443 00000 n -0000044247 00000 n -0000047565 00000 n -0000324829 00000 n -0000318030 00000 n -0000324652 00000 n -0000051897 00000 n -0000051507 00000 n -0000047791 00000 n -0000051834 00000 n -0000051649 00000 n -0000467942 00000 n -0000106562 00000 n -0000054070 00000 n -0000053635 00000 n -0000052034 00000 n -0000053757 00000 n -0000053883 00000 n -0000053944 00000 n -0000054007 00000 n -0000057589 00000 n -0000056551 00000 n -0000054194 00000 n -0000057023 00000 n -0000057149 00000 n -0000057275 00000 n -0000056701 00000 n -0000056862 00000 n -0000057400 00000 n -0000057526 00000 n +0000044122 00000 n +0000043685 00000 n +0000040928 00000 n +0000043807 00000 n +0000334585 00000 n +0000325276 00000 n +0000334408 00000 n +0000044059 00000 n +0000047627 00000 n +0000047442 00000 n +0000044246 00000 n +0000047564 00000 n +0000324833 00000 n +0000318033 00000 n +0000324656 00000 n +0000051896 00000 n +0000051506 00000 n +0000047790 00000 n +0000051833 00000 n +0000051648 00000 n +0000467945 00000 n +0000106561 00000 n +0000054069 00000 n +0000053634 00000 n +0000052033 00000 n +0000053756 00000 n +0000053882 00000 n +0000053943 00000 n +0000054006 00000 n +0000057588 00000 n +0000056550 00000 n +0000054193 00000 n +0000057022 00000 n +0000057148 00000 n +0000057274 00000 n +0000056700 00000 n +0000056861 00000 n +0000057399 00000 n +0000057525 00000 n 0000140443 00000 n 0000166935 00000 n -0000062162 00000 n -0000061371 00000 n -0000057687 00000 n -0000061847 00000 n -0000061973 00000 n -0000061521 00000 n -0000061686 00000 n -0000062099 00000 n -0000276260 00000 n -0000064991 00000 n -0000064619 00000 n -0000062312 00000 n -0000064928 00000 n -0000064761 00000 n -0000066147 00000 n -0000065962 00000 n -0000065115 00000 n -0000066084 00000 n -0000069241 00000 n -0000068552 00000 n -0000066245 00000 n -0000068674 00000 n -0000068800 00000 n -0000068926 00000 n -0000069052 00000 n -0000069178 00000 n -0000468060 00000 n -0000072621 00000 n -0000071744 00000 n -0000069378 00000 n -0000072054 00000 n -0000072180 00000 n -0000072306 00000 n -0000072432 00000 n -0000072558 00000 n -0000071886 00000 n -0000226828 00000 n -0000076718 00000 n -0000076031 00000 n -0000072758 00000 n -0000076153 00000 n -0000076279 00000 n -0000076405 00000 n -0000076530 00000 n -0000076655 00000 n -0000317677 00000 n -0000315684 00000 n -0000317514 00000 n -0000080415 00000 n -0000079855 00000 n -0000076855 00000 n -0000079977 00000 n -0000080102 00000 n -0000080228 00000 n -0000080352 00000 n -0000083377 00000 n -0000082635 00000 n -0000080539 00000 n -0000082936 00000 n -0000083062 00000 n -0000082777 00000 n -0000083188 00000 n -0000083314 00000 n -0000271195 00000 n -0000083835 00000 n -0000083650 00000 n -0000083501 00000 n -0000083772 00000 n -0000086439 00000 n -0000085876 00000 n -0000083876 00000 n -0000085998 00000 n -0000086124 00000 n -0000086250 00000 n -0000086376 00000 n -0000468178 00000 n -0000086871 00000 n -0000086686 00000 n -0000086537 00000 n -0000086808 00000 n -0000090792 00000 n -0000090044 00000 n -0000086912 00000 n -0000090352 00000 n -0000090478 00000 n -0000090603 00000 n -0000090666 00000 n -0000090729 00000 n -0000090186 00000 n -0000094746 00000 n -0000095059 00000 n -0000094498 00000 n -0000090890 00000 n -0000094620 00000 n -0000094870 00000 n -0000094996 00000 n -0000098589 00000 n -0000098026 00000 n -0000095196 00000 n -0000098148 00000 n -0000098274 00000 n -0000098400 00000 n -0000098526 00000 n -0000101203 00000 n -0000102442 00000 n -0000101081 00000 n -0000098700 00000 n -0000102128 00000 n -0000314871 00000 n -0000306197 00000 n -0000314699 00000 n -0000102254 00000 n -0000102317 00000 n -0000102380 00000 n -0000106625 00000 n -0000105812 00000 n -0000102594 00000 n -0000105934 00000 n -0000106060 00000 n -0000106184 00000 n -0000106247 00000 n -0000106310 00000 n -0000106436 00000 n -0000468296 00000 n -0000111653 00000 n -0000110087 00000 n -0000106736 00000 n -0000111086 00000 n -0000110261 00000 n -0000110411 00000 n -0000111212 00000 n -0000111338 00000 n -0000111464 00000 n -0000111590 00000 n -0000110569 00000 n -0000110720 00000 n -0000110904 00000 n -0000286325 00000 n -0000114847 00000 n -0000114284 00000 n -0000111790 00000 n -0000114406 00000 n -0000114532 00000 n -0000114658 00000 n -0000114784 00000 n -0000119365 00000 n -0000119180 00000 n -0000114984 00000 n -0000119302 00000 n -0000122392 00000 n -0000122022 00000 n -0000119476 00000 n -0000122329 00000 n -0000122164 00000 n -0000125192 00000 n -0000125381 00000 n -0000124944 00000 n -0000122503 00000 n -0000125066 00000 n -0000125255 00000 n -0000125318 00000 n -0000129099 00000 n -0000128331 00000 n -0000125492 00000 n -0000128784 00000 n -0000128910 00000 n -0000129036 00000 n -0000128481 00000 n -0000128632 00000 n -0000468414 00000 n -0000131094 00000 n -0000130531 00000 n -0000129210 00000 n -0000130653 00000 n -0000130779 00000 n -0000130905 00000 n -0000131031 00000 n -0000132630 00000 n -0000132445 00000 n -0000131205 00000 n -0000132567 00000 n -0000136444 00000 n -0000136133 00000 n -0000132728 00000 n -0000136255 00000 n -0000136381 00000 n +0000062161 00000 n +0000061370 00000 n +0000057686 00000 n +0000061846 00000 n +0000061972 00000 n +0000061520 00000 n +0000061685 00000 n +0000062098 00000 n +0000276261 00000 n +0000064990 00000 n +0000064618 00000 n +0000062311 00000 n +0000064927 00000 n +0000064760 00000 n +0000066146 00000 n +0000065961 00000 n +0000065114 00000 n +0000066083 00000 n +0000069240 00000 n +0000068551 00000 n +0000066244 00000 n +0000068673 00000 n +0000068799 00000 n +0000068925 00000 n +0000069051 00000 n +0000069177 00000 n +0000468063 00000 n +0000072620 00000 n +0000071743 00000 n +0000069377 00000 n +0000072053 00000 n +0000072179 00000 n +0000072305 00000 n +0000072431 00000 n +0000072557 00000 n +0000071885 00000 n +0000226829 00000 n +0000076717 00000 n +0000076030 00000 n +0000072757 00000 n +0000076152 00000 n +0000076278 00000 n +0000076404 00000 n +0000076529 00000 n +0000076654 00000 n +0000317680 00000 n +0000315685 00000 n +0000317517 00000 n +0000080414 00000 n +0000079854 00000 n +0000076854 00000 n +0000079976 00000 n +0000080101 00000 n +0000080227 00000 n +0000080351 00000 n +0000083376 00000 n +0000082634 00000 n +0000080538 00000 n +0000082935 00000 n +0000083061 00000 n +0000082776 00000 n +0000083187 00000 n +0000083313 00000 n +0000271196 00000 n +0000083834 00000 n +0000083649 00000 n +0000083500 00000 n +0000083771 00000 n +0000086438 00000 n +0000085875 00000 n +0000083875 00000 n +0000085997 00000 n +0000086123 00000 n +0000086249 00000 n +0000086375 00000 n +0000468181 00000 n +0000086870 00000 n +0000086685 00000 n +0000086536 00000 n +0000086807 00000 n +0000090791 00000 n +0000090043 00000 n +0000086911 00000 n +0000090351 00000 n +0000090477 00000 n +0000090602 00000 n +0000090665 00000 n +0000090728 00000 n +0000090185 00000 n +0000094745 00000 n +0000095058 00000 n +0000094497 00000 n +0000090889 00000 n +0000094619 00000 n +0000094869 00000 n +0000094995 00000 n +0000098588 00000 n +0000098025 00000 n +0000095195 00000 n +0000098147 00000 n +0000098273 00000 n +0000098399 00000 n +0000098525 00000 n +0000101202 00000 n +0000102441 00000 n +0000101080 00000 n +0000098699 00000 n +0000102127 00000 n +0000314872 00000 n +0000306198 00000 n +0000314700 00000 n +0000102253 00000 n +0000102316 00000 n +0000102379 00000 n +0000106624 00000 n +0000105811 00000 n +0000102593 00000 n +0000105933 00000 n +0000106059 00000 n +0000106183 00000 n +0000106246 00000 n +0000106309 00000 n +0000106435 00000 n +0000468299 00000 n +0000111652 00000 n +0000110086 00000 n +0000106735 00000 n +0000111085 00000 n +0000110260 00000 n +0000110410 00000 n +0000111211 00000 n +0000111337 00000 n +0000111463 00000 n +0000111589 00000 n +0000110568 00000 n +0000110719 00000 n +0000110903 00000 n +0000286326 00000 n +0000114846 00000 n +0000114283 00000 n +0000111789 00000 n +0000114405 00000 n +0000114531 00000 n +0000114657 00000 n +0000114783 00000 n +0000119364 00000 n +0000119179 00000 n +0000114983 00000 n +0000119301 00000 n +0000122391 00000 n +0000122021 00000 n +0000119475 00000 n +0000122328 00000 n +0000122163 00000 n +0000125191 00000 n +0000125380 00000 n +0000124943 00000 n +0000122502 00000 n +0000125065 00000 n +0000125254 00000 n +0000125317 00000 n +0000129098 00000 n +0000128330 00000 n +0000125491 00000 n +0000128783 00000 n +0000128909 00000 n +0000129035 00000 n +0000128480 00000 n +0000128631 00000 n +0000468417 00000 n +0000131090 00000 n +0000130527 00000 n +0000129209 00000 n +0000130649 00000 n +0000130775 00000 n +0000130901 00000 n +0000131027 00000 n +0000132626 00000 n +0000132441 00000 n +0000131201 00000 n +0000132563 00000 n +0000136440 00000 n +0000136129 00000 n +0000132724 00000 n +0000136251 00000 n +0000136377 00000 n 0000140506 00000 n 0000140020 00000 n -0000136568 00000 n +0000136564 00000 n 0000140317 00000 n 0000140162 00000 n 0000197294 00000 n @@ -8525,7 +8527,7 @@ xref 0000150539 00000 n 0000150712 00000 n 0000150896 00000 n -0000468532 00000 n +0000468535 00000 n 0000149878 00000 n 0000149935 00000 n 0000150024 00000 n @@ -8543,22 +8545,22 @@ xref 0000159682 00000 n 0000159807 00000 n 0000159265 00000 n -0000207975 00000 n +0000207976 00000 n 0000163783 00000 n 0000163283 00000 n 0000159981 00000 n 0000163595 00000 n 0000163425 00000 n 0000163721 00000 n -0000259852 00000 n +0000259853 00000 n 0000166998 00000 n 0000166561 00000 n 0000163907 00000 n 0000166683 00000 n 0000166809 00000 n -0000305671 00000 n -0000297780 00000 n -0000305498 00000 n +0000305672 00000 n +0000297781 00000 n +0000305499 00000 n 0000170998 00000 n 0000170813 00000 n 0000167163 00000 n @@ -8570,7 +8572,7 @@ xref 0000174837 00000 n 0000174963 00000 n 0000174540 00000 n -0000468650 00000 n +0000468653 00000 n 0000179098 00000 n 0000178487 00000 n 0000175191 00000 n @@ -8613,7 +8615,7 @@ xref 0000197358 00000 n 0000197422 00000 n 0000197551 00000 n -0000468772 00000 n +0000468775 00000 n 0000202584 00000 n 0000201631 00000 n 0000197855 00000 n @@ -8628,325 +8630,325 @@ xref 0000202696 00000 n 0000205953 00000 n 0000206211 00000 n -0000208039 00000 n -0000207720 00000 n +0000208040 00000 n +0000207721 00000 n 0000206388 00000 n -0000207846 00000 n -0000211746 00000 n -0000211169 00000 n -0000208151 00000 n -0000211295 00000 n -0000211424 00000 n -0000211553 00000 n -0000211618 00000 n -0000211683 00000 n -0000216710 00000 n -0000215208 00000 n -0000211858 00000 n -0000216387 00000 n -0000216516 00000 n -0000216645 00000 n -0000215400 00000 n -0000215562 00000 n -0000215724 00000 n -0000215886 00000 n -0000216057 00000 n -0000216227 00000 n -0000221529 00000 n -0000220300 00000 n -0000216822 00000 n -0000221464 00000 n -0000220492 00000 n -0000220655 00000 n -0000220817 00000 n -0000220979 00000 n -0000221139 00000 n -0000221301 00000 n -0000468897 00000 n -0000226892 00000 n -0000224533 00000 n -0000221654 00000 n -0000226699 00000 n -0000224779 00000 n -0000224932 00000 n -0000225094 00000 n -0000225256 00000 n -0000225418 00000 n -0000225580 00000 n -0000225742 00000 n -0000225904 00000 n -0000226066 00000 n -0000226220 00000 n -0000226381 00000 n -0000226536 00000 n -0000231452 00000 n -0000230255 00000 n -0000227017 00000 n -0000230743 00000 n -0000230808 00000 n -0000230873 00000 n -0000231002 00000 n -0000231259 00000 n -0000230411 00000 n -0000230581 00000 n -0000231324 00000 n -0000231388 00000 n -0000235060 00000 n -0000234739 00000 n -0000231577 00000 n -0000234865 00000 n -0000234930 00000 n -0000234995 00000 n -0000239098 00000 n -0000238648 00000 n -0000235159 00000 n -0000238774 00000 n -0000238839 00000 n -0000238904 00000 n -0000239033 00000 n -0000242812 00000 n -0000242102 00000 n -0000239223 00000 n -0000242228 00000 n -0000242293 00000 n -0000242358 00000 n -0000242423 00000 n -0000242488 00000 n -0000242617 00000 n -0000242682 00000 n -0000242747 00000 n -0000246688 00000 n -0000245725 00000 n -0000242937 00000 n -0000245851 00000 n -0000245980 00000 n -0000246045 00000 n -0000246110 00000 n -0000246238 00000 n -0000246302 00000 n -0000246367 00000 n -0000246496 00000 n -0000246624 00000 n -0000469022 00000 n -0000249829 00000 n -0000249251 00000 n -0000246880 00000 n -0000249377 00000 n -0000249506 00000 n -0000249635 00000 n -0000249764 00000 n -0000252798 00000 n -0000252477 00000 n -0000250021 00000 n -0000252603 00000 n -0000252668 00000 n -0000252733 00000 n -0000253251 00000 n -0000253060 00000 n -0000252910 00000 n -0000253186 00000 n -0000255820 00000 n -0000254911 00000 n -0000253293 00000 n -0000255497 00000 n -0000255626 00000 n -0000255755 00000 n -0000255067 00000 n -0000255282 00000 n -0000259916 00000 n -0000259211 00000 n -0000255945 00000 n -0000259337 00000 n -0000297459 00000 n -0000288246 00000 n -0000297273 00000 n -0000259466 00000 n -0000259595 00000 n -0000259724 00000 n -0000263363 00000 n -0000262137 00000 n -0000260081 00000 n -0000262654 00000 n -0000262783 00000 n -0000262912 00000 n -0000263041 00000 n -0000263170 00000 n -0000263299 00000 n -0000262293 00000 n -0000262465 00000 n -0000469147 00000 n -0000263816 00000 n -0000263625 00000 n -0000263475 00000 n -0000263751 00000 n -0000267124 00000 n -0000266546 00000 n -0000263858 00000 n -0000266672 00000 n -0000266801 00000 n -0000266930 00000 n -0000267059 00000 n -0000271776 00000 n -0000270426 00000 n -0000267210 00000 n -0000270937 00000 n -0000271066 00000 n -0000271259 00000 n -0000271324 00000 n -0000271389 00000 n -0000271454 00000 n -0000271583 00000 n -0000270582 00000 n -0000270760 00000 n -0000278658 00000 n -0000274598 00000 n -0000271927 00000 n -0000274772 00000 n -0000275480 00000 n -0000274950 00000 n -0000275128 00000 n -0000275304 00000 n -0000275545 00000 n -0000275610 00000 n -0000275675 00000 n -0000275740 00000 n -0000275805 00000 n -0000275870 00000 n -0000275935 00000 n -0000276000 00000 n -0000276065 00000 n -0000276130 00000 n -0000276195 00000 n -0000276324 00000 n -0000276389 00000 n -0000276454 00000 n -0000276519 00000 n -0000276584 00000 n -0000276648 00000 n -0000276713 00000 n -0000276777 00000 n -0000276842 00000 n -0000276907 00000 n -0000276972 00000 n -0000277037 00000 n -0000277101 00000 n -0000277166 00000 n -0000277231 00000 n -0000277296 00000 n -0000277361 00000 n -0000277426 00000 n -0000277491 00000 n -0000277555 00000 n -0000277620 00000 n -0000277685 00000 n -0000277750 00000 n -0000277815 00000 n -0000277880 00000 n -0000277945 00000 n -0000278010 00000 n -0000278075 00000 n -0000278140 00000 n -0000278205 00000 n -0000278270 00000 n -0000278335 00000 n -0000278400 00000 n -0000278465 00000 n -0000278530 00000 n -0000278594 00000 n -0000284877 00000 n -0000281570 00000 n -0000278809 00000 n -0000281696 00000 n -0000281761 00000 n -0000281826 00000 n -0000281891 00000 n -0000281956 00000 n -0000282021 00000 n -0000282085 00000 n -0000282150 00000 n -0000282215 00000 n -0000282280 00000 n -0000282345 00000 n -0000282410 00000 n -0000282475 00000 n -0000282540 00000 n -0000282605 00000 n -0000282670 00000 n -0000282735 00000 n -0000282800 00000 n -0000282865 00000 n -0000282930 00000 n -0000282995 00000 n -0000283060 00000 n -0000283125 00000 n -0000283190 00000 n -0000283254 00000 n -0000283319 00000 n -0000283384 00000 n -0000283449 00000 n -0000283514 00000 n -0000283579 00000 n -0000283644 00000 n -0000283709 00000 n -0000283774 00000 n -0000283839 00000 n -0000283904 00000 n -0000283969 00000 n -0000284034 00000 n -0000284099 00000 n -0000284164 00000 n -0000284229 00000 n -0000284294 00000 n -0000284359 00000 n -0000284424 00000 n -0000284489 00000 n -0000284554 00000 n -0000284619 00000 n -0000284684 00000 n -0000284813 00000 n -0000286200 00000 n -0000285620 00000 n -0000284989 00000 n -0000285746 00000 n -0000285875 00000 n -0000285940 00000 n -0000286005 00000 n -0000286070 00000 n -0000286135 00000 n -0000469272 00000 n -0000286357 00000 n -0000297701 00000 n -0000305946 00000 n -0000315265 00000 n -0000317922 00000 n -0000317891 00000 n -0000325071 00000 n -0000334867 00000 n -0000352365 00000 n -0000369352 00000 n -0000389634 00000 n -0000410773 00000 n -0000413855 00000 n -0000413625 00000 n -0000440542 00000 n -0000467220 00000 n -0000469352 00000 n -0000469472 00000 n -0000469595 00000 n -0000469684 00000 n -0000469766 00000 n -0000483637 00000 n -0000495599 00000 n -0000495640 00000 n -0000495680 00000 n -0000495814 00000 n +0000207847 00000 n +0000211747 00000 n +0000211170 00000 n +0000208152 00000 n +0000211296 00000 n +0000211425 00000 n +0000211554 00000 n +0000211619 00000 n +0000211684 00000 n +0000216711 00000 n +0000215209 00000 n +0000211859 00000 n +0000216388 00000 n +0000216517 00000 n +0000216646 00000 n +0000215401 00000 n +0000215563 00000 n +0000215725 00000 n +0000215887 00000 n +0000216058 00000 n +0000216228 00000 n +0000221530 00000 n +0000220301 00000 n +0000216823 00000 n +0000221465 00000 n +0000220493 00000 n +0000220656 00000 n +0000220818 00000 n +0000220980 00000 n +0000221140 00000 n +0000221302 00000 n +0000468900 00000 n +0000226893 00000 n +0000224534 00000 n +0000221655 00000 n +0000226700 00000 n +0000224780 00000 n +0000224933 00000 n +0000225095 00000 n +0000225257 00000 n +0000225419 00000 n +0000225581 00000 n +0000225743 00000 n +0000225905 00000 n +0000226067 00000 n +0000226221 00000 n +0000226382 00000 n +0000226537 00000 n +0000231453 00000 n +0000230256 00000 n +0000227018 00000 n +0000230744 00000 n +0000230809 00000 n +0000230874 00000 n +0000231003 00000 n +0000231260 00000 n +0000230412 00000 n +0000230582 00000 n +0000231325 00000 n +0000231389 00000 n +0000235061 00000 n +0000234740 00000 n +0000231578 00000 n +0000234866 00000 n +0000234931 00000 n +0000234996 00000 n +0000239099 00000 n +0000238649 00000 n +0000235160 00000 n +0000238775 00000 n +0000238840 00000 n +0000238905 00000 n +0000239034 00000 n +0000242813 00000 n +0000242103 00000 n +0000239224 00000 n +0000242229 00000 n +0000242294 00000 n +0000242359 00000 n +0000242424 00000 n +0000242489 00000 n +0000242618 00000 n +0000242683 00000 n +0000242748 00000 n +0000246689 00000 n +0000245726 00000 n +0000242938 00000 n +0000245852 00000 n +0000245981 00000 n +0000246046 00000 n +0000246111 00000 n +0000246239 00000 n +0000246303 00000 n +0000246368 00000 n +0000246497 00000 n +0000246625 00000 n +0000469025 00000 n +0000249830 00000 n +0000249252 00000 n +0000246881 00000 n +0000249378 00000 n +0000249507 00000 n +0000249636 00000 n +0000249765 00000 n +0000252799 00000 n +0000252478 00000 n +0000250022 00000 n +0000252604 00000 n +0000252669 00000 n +0000252734 00000 n +0000253252 00000 n +0000253061 00000 n +0000252911 00000 n +0000253187 00000 n +0000255821 00000 n +0000254912 00000 n +0000253294 00000 n +0000255498 00000 n +0000255627 00000 n +0000255756 00000 n +0000255068 00000 n +0000255283 00000 n +0000259917 00000 n +0000259212 00000 n +0000255946 00000 n +0000259338 00000 n +0000297460 00000 n +0000288247 00000 n +0000297274 00000 n +0000259467 00000 n +0000259596 00000 n +0000259725 00000 n +0000263364 00000 n +0000262138 00000 n +0000260082 00000 n +0000262655 00000 n +0000262784 00000 n +0000262913 00000 n +0000263042 00000 n +0000263171 00000 n +0000263300 00000 n +0000262294 00000 n +0000262466 00000 n +0000469150 00000 n +0000263817 00000 n +0000263626 00000 n +0000263476 00000 n +0000263752 00000 n +0000267125 00000 n +0000266547 00000 n +0000263859 00000 n +0000266673 00000 n +0000266802 00000 n +0000266931 00000 n +0000267060 00000 n +0000271777 00000 n +0000270427 00000 n +0000267211 00000 n +0000270938 00000 n +0000271067 00000 n +0000271260 00000 n +0000271325 00000 n +0000271390 00000 n +0000271455 00000 n +0000271584 00000 n +0000270583 00000 n +0000270761 00000 n +0000278659 00000 n +0000274599 00000 n +0000271928 00000 n +0000274773 00000 n +0000275481 00000 n +0000274951 00000 n +0000275129 00000 n +0000275305 00000 n +0000275546 00000 n +0000275611 00000 n +0000275676 00000 n +0000275741 00000 n +0000275806 00000 n +0000275871 00000 n +0000275936 00000 n +0000276001 00000 n +0000276066 00000 n +0000276131 00000 n +0000276196 00000 n +0000276325 00000 n +0000276390 00000 n +0000276455 00000 n +0000276520 00000 n +0000276585 00000 n +0000276649 00000 n +0000276714 00000 n +0000276778 00000 n +0000276843 00000 n +0000276908 00000 n +0000276973 00000 n +0000277038 00000 n +0000277102 00000 n +0000277167 00000 n +0000277232 00000 n +0000277297 00000 n +0000277362 00000 n +0000277427 00000 n +0000277492 00000 n +0000277556 00000 n +0000277621 00000 n +0000277686 00000 n +0000277751 00000 n +0000277816 00000 n +0000277881 00000 n +0000277946 00000 n +0000278011 00000 n +0000278076 00000 n +0000278141 00000 n +0000278206 00000 n +0000278271 00000 n +0000278336 00000 n +0000278401 00000 n +0000278466 00000 n +0000278531 00000 n +0000278595 00000 n +0000284878 00000 n +0000281571 00000 n +0000278810 00000 n +0000281697 00000 n +0000281762 00000 n +0000281827 00000 n +0000281892 00000 n +0000281957 00000 n +0000282022 00000 n +0000282086 00000 n +0000282151 00000 n +0000282216 00000 n +0000282281 00000 n +0000282346 00000 n +0000282411 00000 n +0000282476 00000 n +0000282541 00000 n +0000282606 00000 n +0000282671 00000 n +0000282736 00000 n +0000282801 00000 n +0000282866 00000 n +0000282931 00000 n +0000282996 00000 n +0000283061 00000 n +0000283126 00000 n +0000283191 00000 n +0000283255 00000 n +0000283320 00000 n +0000283385 00000 n +0000283450 00000 n +0000283515 00000 n +0000283580 00000 n +0000283645 00000 n +0000283710 00000 n +0000283775 00000 n +0000283840 00000 n +0000283905 00000 n +0000283970 00000 n +0000284035 00000 n +0000284100 00000 n +0000284165 00000 n +0000284230 00000 n +0000284295 00000 n +0000284360 00000 n +0000284425 00000 n +0000284490 00000 n +0000284555 00000 n +0000284620 00000 n +0000284685 00000 n +0000284814 00000 n +0000286201 00000 n +0000285621 00000 n +0000284990 00000 n +0000285747 00000 n +0000285876 00000 n +0000285941 00000 n +0000286006 00000 n +0000286071 00000 n +0000286136 00000 n +0000469275 00000 n +0000286358 00000 n +0000297702 00000 n +0000305947 00000 n +0000315266 00000 n +0000317925 00000 n +0000317894 00000 n +0000325075 00000 n +0000334871 00000 n +0000352369 00000 n +0000369356 00000 n +0000389638 00000 n +0000410777 00000 n +0000413858 00000 n +0000413628 00000 n +0000440545 00000 n +0000467223 00000 n +0000469355 00000 n +0000469475 00000 n +0000469598 00000 n +0000469687 00000 n +0000469769 00000 n +0000483640 00000 n +0000495602 00000 n +0000495643 00000 n +0000495683 00000 n +0000495817 00000 n trailer << /Size 1362 /Root 1360 0 R /Info 1361 0 R -/ID [<26C10D576DF3B68EBCC2B3A11886CD4B> <26C10D576DF3B68EBCC2B3A11886CD4B>] +/ID [<2BA15F75CFA62EC3C7EEABFE99344C91> <2BA15F75CFA62EC3C7EEABFE99344C91>] >> startxref -496078 +496081 %%EOF diff --git a/doc/xsl/Makefile.in b/doc/xsl/Makefile.in new file mode 100644 index 00000000..ffbedbc7 --- /dev/null +++ b/doc/xsl/Makefile.in @@ -0,0 +1,28 @@ +# Copyright (C) 2005 Internet Systems Consortium, Inc. ("ISC") +# +# Permission to use, copy, modify, and distribute this software for any +# purpose with or without fee is hereby granted, provided that the above +# copyright notice and this permission notice appear in all copies. +# +# THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH +# REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY +# AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, +# INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM +# LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE +# OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR +# PERFORMANCE OF THIS SOFTWARE. + +# $Id: Makefile.in,v 1.2.36.1 2005/09/12 22:41:12 marka Exp $ + +srcdir = @srcdir@ +VPATH = @srcdir@ +top_srcdir = @top_srcdir@ + +SUBDIRS = +TARGETS = + +@BIND9_MAKE_RULES@ + +distclean:: + rm -f isc-docbook-chunk.xsl isc-docbook-html.xsl \ + isc-docbook-latex.xsl isc-manpage.xsl diff --git a/doc/xsl/pre-latex.xsl b/doc/xsl/pre-latex.xsl index 2294d8e8..e641135d 100644 --- a/doc/xsl/pre-latex.xsl +++ b/doc/xsl/pre-latex.xsl @@ -14,7 +14,7 @@ - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: pre-latex.xsl,v 1.2.10.2 2005/05/13 01:22:36 marka Exp $ --> +<!-- $Id: pre-latex.xsl,v 1.2.10.3 2005/09/15 02:28:26 marka Exp $ --> <!-- - Whack — into something that won't choke LaTeX. @@ -25,7 +25,7 @@ <xsl:variable name="mdash" select="'—'"/> - <xsl:template name="fix-mdash" match="text()[contains(., $mdash)]"> + <xsl:template name="fix-mdash" match="text()[contains(., '—')]"> <xsl:param name="s" select="."/> <xsl:choose> <xsl:when test="contains($s, $mdash)"> diff --git a/lib/bind/api b/lib/bind/api index 06a9880e..38cabc1d 100644 --- a/lib/bind/api +++ b/lib/bind/api @@ -1,3 +1,3 @@ LIBINTERFACE = 4 -LIBREVISION = 0 +LIBREVISION = 1 LIBAGE = 0 diff --git a/lib/bind/configure b/lib/bind/configure index e4581d1c..8f126216 100755 --- a/lib/bind/configure +++ b/lib/bind/configure @@ -1,5 +1,5 @@ #! /bin/sh -# From configure.in Revision: 1.83.2.5.2.20 . +# From configure.in Revision: 1.83.2.5.2.22 . # Guess values for system-dependent variables and create Makefiles. # Generated by GNU Autoconf 2.59. # @@ -5752,7 +5752,12 @@ _ACEOF DO_PTHREADS="#define DO_PTHREADS 1" WANT_IRS_THREADSGR_OBJS="\${WANT_IRS_THREADSGR_OBJS}" WANT_IRS_THREADSPW_OBJS="\${WANT_IRS_THREADSPW_OBJS}" - WANT_IRS_THREADS_OBJS="\${WANT_IRS_THREADS_OBJS}" + case $host in + ia64-hp-hpux11.*) + WANT_IRS_THREADS_OBJS="";; + *) + WANT_IRS_THREADS_OBJS="\${WANT_IRS_THREADS_OBJS}";; + esac WANT_THREADS_OBJS="\${WANT_THREADS_OBJS}" thread_dir=pthreads else @@ -6418,7 +6423,7 @@ else ;; *) # Turn off the pointlessly noisy warnings. - STD_CWARNINGS="+w1 +W 474,530" + STD_CWARNINGS="+w1 +W 474,530,2193,2236" ;; esac CCOPT="$CCOPT -Ae -z" @@ -6575,6 +6580,156 @@ fi case "$host" in mips-sgi-irix*) ;; + ia64-hp-hpux11.*) + +echo "$as_me:$LINENO: checking for socket in -lsocket" >&5 +echo $ECHO_N "checking for socket in -lsocket... $ECHO_C" >&6 +if test "${ac_cv_lib_socket_socket+set}" = set; then + echo $ECHO_N "(cached) $ECHO_C" >&6 +else + ac_check_lib_save_LIBS=$LIBS +LIBS="-lsocket $LIBS" +cat >conftest.$ac_ext <<_ACEOF +/* confdefs.h. */ +_ACEOF +cat confdefs.h >>conftest.$ac_ext +cat >>conftest.$ac_ext <<_ACEOF +/* end confdefs.h. */ + +/* Override any gcc2 internal prototype to avoid an error. */ +#ifdef __cplusplus +extern "C" +#endif +/* We use char because int might match the return type of a gcc2 + builtin and then its argument prototype would still apply. */ +char socket (); +int +main () +{ +socket (); + ; + return 0; +} +_ACEOF +rm -f conftest.$ac_objext conftest$ac_exeext +if { (eval echo "$as_me:$LINENO: \"$ac_link\"") >&5 + (eval $ac_link) 2>conftest.er1 + ac_status=$? + grep -v '^ *+' conftest.er1 >conftest.err + rm -f conftest.er1 + cat conftest.err >&5 + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); } && + { ac_try='test -z "$ac_c_werror_flag" + || test ! -s conftest.err' + { (eval echo "$as_me:$LINENO: \"$ac_try\"") >&5 + (eval $ac_try) 2>&5 + ac_status=$? + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); }; } && + { ac_try='test -s conftest$ac_exeext' + { (eval echo "$as_me:$LINENO: \"$ac_try\"") >&5 + (eval $ac_try) 2>&5 + ac_status=$? + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); }; }; then + ac_cv_lib_socket_socket=yes +else + echo "$as_me: failed program was:" >&5 +sed 's/^/| /' conftest.$ac_ext >&5 + +ac_cv_lib_socket_socket=no +fi +rm -f conftest.err conftest.$ac_objext \ + conftest$ac_exeext conftest.$ac_ext +LIBS=$ac_check_lib_save_LIBS +fi +echo "$as_me:$LINENO: result: $ac_cv_lib_socket_socket" >&5 +echo "${ECHO_T}$ac_cv_lib_socket_socket" >&6 +if test $ac_cv_lib_socket_socket = yes; then + cat >>confdefs.h <<_ACEOF +#define HAVE_LIBSOCKET 1 +_ACEOF + + LIBS="-lsocket $LIBS" + +fi + + +echo "$as_me:$LINENO: checking for inet_ntoa in -lnsl" >&5 +echo $ECHO_N "checking for inet_ntoa in -lnsl... $ECHO_C" >&6 +if test "${ac_cv_lib_nsl_inet_ntoa+set}" = set; then + echo $ECHO_N "(cached) $ECHO_C" >&6 +else + ac_check_lib_save_LIBS=$LIBS +LIBS="-lnsl $LIBS" +cat >conftest.$ac_ext <<_ACEOF +/* confdefs.h. */ +_ACEOF +cat confdefs.h >>conftest.$ac_ext +cat >>conftest.$ac_ext <<_ACEOF +/* end confdefs.h. */ + +/* Override any gcc2 internal prototype to avoid an error. */ +#ifdef __cplusplus +extern "C" +#endif +/* We use char because int might match the return type of a gcc2 + builtin and then its argument prototype would still apply. */ +char inet_ntoa (); +int +main () +{ +inet_ntoa (); + ; + return 0; +} +_ACEOF +rm -f conftest.$ac_objext conftest$ac_exeext +if { (eval echo "$as_me:$LINENO: \"$ac_link\"") >&5 + (eval $ac_link) 2>conftest.er1 + ac_status=$? + grep -v '^ *+' conftest.er1 >conftest.err + rm -f conftest.er1 + cat conftest.err >&5 + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); } && + { ac_try='test -z "$ac_c_werror_flag" + || test ! -s conftest.err' + { (eval echo "$as_me:$LINENO: \"$ac_try\"") >&5 + (eval $ac_try) 2>&5 + ac_status=$? + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); }; } && + { ac_try='test -s conftest$ac_exeext' + { (eval echo "$as_me:$LINENO: \"$ac_try\"") >&5 + (eval $ac_try) 2>&5 + ac_status=$? + echo "$as_me:$LINENO: \$? = $ac_status" >&5 + (exit $ac_status); }; }; then + ac_cv_lib_nsl_inet_ntoa=yes +else + echo "$as_me: failed program was:" >&5 +sed 's/^/| /' conftest.$ac_ext >&5 + +ac_cv_lib_nsl_inet_ntoa=no +fi +rm -f conftest.err conftest.$ac_objext \ + conftest$ac_exeext conftest.$ac_ext +LIBS=$ac_check_lib_save_LIBS +fi +echo "$as_me:$LINENO: result: $ac_cv_lib_nsl_inet_ntoa" >&5 +echo "${ECHO_T}$ac_cv_lib_nsl_inet_ntoa" >&6 +if test $ac_cv_lib_nsl_inet_ntoa = yes; then + cat >>confdefs.h <<_ACEOF +#define HAVE_LIBNSL 1 +_ACEOF + + LIBS="-lnsl $LIBS" + +fi + + ;; *) echo "$as_me:$LINENO: checking for gethostbyname_r in -ld4r" >&5 @@ -7447,7 +7602,7 @@ ia64-*-hpux*) ;; *-*-irix6*) # Find out which ABI we are using. - echo '#line 7450 "configure"' > conftest.$ac_ext + echo '#line 7605 "configure"' > conftest.$ac_ext if { (eval echo "$as_me:$LINENO: \"$ac_compile\"") >&5 (eval $ac_compile) 2>&5 ac_status=$? @@ -8444,7 +8599,7 @@ fi # Provide some information about the compiler. -echo "$as_me:8447:" \ +echo "$as_me:8602:" \ "checking for Fortran 77 compiler version" >&5 ac_compiler=`set X $ac_compile; echo $2` { (eval echo "$as_me:$LINENO: \"$ac_compiler --version </dev/null >&5\"") >&5 @@ -9505,11 +9660,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:9508: $lt_compile\"" >&5) + (eval echo "\"\$as_me:9663: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:9512: \$? = $ac_status" >&5 + echo "$as_me:9667: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -9748,11 +9903,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:9751: $lt_compile\"" >&5) + (eval echo "\"\$as_me:9906: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:9755: \$? = $ac_status" >&5 + echo "$as_me:9910: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -9808,11 +9963,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:9811: $lt_compile\"" >&5) + (eval echo "\"\$as_me:9966: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:9815: \$? = $ac_status" >&5 + echo "$as_me:9970: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -11993,7 +12148,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 11996 "configure" +#line 12151 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -12091,7 +12246,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 12094 "configure" +#line 12249 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -14288,11 +14443,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:14291: $lt_compile\"" >&5) + (eval echo "\"\$as_me:14446: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:14295: \$? = $ac_status" >&5 + echo "$as_me:14450: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -14348,11 +14503,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:14351: $lt_compile\"" >&5) + (eval echo "\"\$as_me:14506: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:14355: \$? = $ac_status" >&5 + echo "$as_me:14510: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -15709,7 +15864,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 15712 "configure" +#line 15867 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -15807,7 +15962,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 15810 "configure" +#line 15965 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -16644,11 +16799,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:16647: $lt_compile\"" >&5) + (eval echo "\"\$as_me:16802: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:16651: \$? = $ac_status" >&5 + echo "$as_me:16806: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -16704,11 +16859,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:16707: $lt_compile\"" >&5) + (eval echo "\"\$as_me:16862: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:16711: \$? = $ac_status" >&5 + echo "$as_me:16866: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -18743,11 +18898,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:18746: $lt_compile\"" >&5) + (eval echo "\"\$as_me:18901: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:18750: \$? = $ac_status" >&5 + echo "$as_me:18905: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -18986,11 +19141,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:18989: $lt_compile\"" >&5) + (eval echo "\"\$as_me:19144: $lt_compile\"" >&5) (eval "$lt_compile" 2>conftest.err) ac_status=$? cat conftest.err >&5 - echo "$as_me:18993: \$? = $ac_status" >&5 + echo "$as_me:19148: \$? = $ac_status" >&5 if (exit $ac_status) && test -s "$ac_outfile"; then # The compiler can only warn and ignore the option if not recognized # So say no if there are warnings @@ -19046,11 +19201,11 @@ else -e 's:.*FLAGS}? :&$lt_compiler_flag :; t' \ -e 's: [^ ]*conftest\.: $lt_compiler_flag&:; t' \ -e 's:$: $lt_compiler_flag:'` - (eval echo "\"\$as_me:19049: $lt_compile\"" >&5) + (eval echo "\"\$as_me:19204: $lt_compile\"" >&5) (eval "$lt_compile" 2>out/conftest.err) ac_status=$? cat out/conftest.err >&5 - echo "$as_me:19053: \$? = $ac_status" >&5 + echo "$as_me:19208: \$? = $ac_status" >&5 if (exit $ac_status) && test -s out/conftest2.$ac_objext then # The compiler can only warn and ignore the option if not recognized @@ -21231,7 +21386,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 21234 "configure" +#line 21389 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -21329,7 +21484,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<EOF -#line 21332 "configure" +#line 21487 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -25361,6 +25516,10 @@ _ACEOF fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for getnetbyaddr_r" >&5 echo $ECHO_N "checking for getnetbyaddr_r... $ECHO_C" >&6 if test "${ac_cv_func_getnetbyaddr_r+set}" = set; then @@ -25776,6 +25935,8 @@ NETENT_DATA="#undef NETENT_DATA" fi +esac + case "$host" in *dec-osf*) GETNETBYADDR_ADDR_T="#define GETNETBYADDR_ADDR_T int" ;; esac @@ -26000,6 +26161,11 @@ fi + +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for endnetent_r" >&5 echo $ECHO_N "checking for endnetent_r... $ECHO_C" >&6 if test "${ac_cv_func_endnetent_r+set}" = set; then @@ -26262,6 +26428,7 @@ NET_R_END_RETURN="#define NET_R_END_RETURN void" fi +esac @@ -26839,6 +27006,10 @@ fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for gethostbyname_r" >&5 echo $ECHO_N "checking for gethostbyname_r... $ECHO_C" >&6 if test "${ac_cv_func_gethostbyname_r+set}" = set; then @@ -27129,6 +27300,7 @@ HOSTENT_DATA="#undef HOSTENT_DATA" fi +esac @@ -27139,6 +27311,10 @@ fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for endhostent_r" >&5 echo $ECHO_N "checking for endhostent_r... $ECHO_C" >&6 if test "${ac_cv_func_endhostent_r+set}" = set; then @@ -27404,10 +27580,15 @@ HOST_R_ENT_ARGS="#undef HOST_R_ENT_ARGS /*empty*/" fi +esac; +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for sethostent_r" >&5 echo $ECHO_N "checking for sethostent_r... $ECHO_C" >&6 if test "${ac_cv_func_sethostent_r+set}" = set; then @@ -27661,6 +27842,7 @@ HOST_R_SET_RETURN="#define HOST_R_SET_RETURN void" fi +esac @@ -27832,6 +28014,10 @@ fi rm -f conftest.err conftest.$ac_objext conftest.$ac_ext +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for getnetgrent_r" >&5 echo $ECHO_N "checking for getnetgrent_r... $ECHO_C" >&6 if test "${ac_cv_func_getnetgrent_r+set}" = set; then @@ -28111,6 +28297,7 @@ NGR_R_RETURN="#define NGR_R_RETURN int" fi +esac @@ -28442,6 +28629,10 @@ _ACEOF fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for getprotoent_r" >&5 echo $ECHO_N "checking for getprotoent_r... $ECHO_C" >&6 if test "${ac_cv_func_getprotoent_r+set}" = set; then @@ -28668,6 +28859,7 @@ PROTO_R_RETURN="#define PROTO_R_RETURN struct protoent *" fi +esac @@ -28676,6 +28868,10 @@ fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for endprotoent_r" >&5 echo $ECHO_N "checking for endprotoent_r... $ECHO_C" >&6 if test "${ac_cv_func_endprotoent_r+set}" = set; then @@ -28832,10 +29028,15 @@ PROTO_R_ENT_ARGS="#undef PROTO_R_ENT_ARGS /*empty*/" fi +esac +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for setprotoent_r" >&5 echo $ECHO_N "checking for setprotoent_r... $ECHO_C" >&6 if test "${ac_cv_func_setprotoent_r+set}" = set; then @@ -28987,6 +29188,7 @@ PROTO_R_SET_RETURN="#define PROTO_R_SET_RETURN void" fi +esac @@ -29918,6 +30120,10 @@ _ACEOF fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for getservent_r" >&5 echo $ECHO_N "checking for getservent_r... $ECHO_C" >&6 if test "${ac_cv_func_getservent_r+set}" = set; then @@ -30140,6 +30346,7 @@ SERV_R_RETURN="#define SERV_R_RETURN struct servent *" fi +esac @@ -30148,6 +30355,10 @@ fi +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for endservent_r" >&5 echo $ECHO_N "checking for endservent_r... $ECHO_C" >&6 if test "${ac_cv_func_endservent_r+set}" = set; then @@ -30304,10 +30515,15 @@ SERV_R_ENT_ARGS="#undef SERV_R_ENT_ARGS /*empty*/" fi +esac +case $host in +ia64-hp-hpux11.*) +;; +*) echo "$as_me:$LINENO: checking for setservent_r" >&5 echo $ECHO_N "checking for setservent_r... $ECHO_C" >&6 if test "${ac_cv_func_setservent_r+set}" = set; then @@ -30462,6 +30678,7 @@ SERV_R_SET_RETURN="#define SERV_R_SET_RETURN void" fi +esac diff --git a/lib/bind/configure.in b/lib/bind/configure.in index aad31d3b..50ffe82a 100644 --- a/lib/bind/configure.in +++ b/lib/bind/configure.in @@ -13,7 +13,7 @@ # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. -AC_REVISION($Revision: 1.83.2.5.2.20 $) +AC_REVISION($Revision: 1.83.2.5.2.22 $) AC_INIT(resolv/herror.c) AC_PREREQ(2.13) @@ -430,7 +430,12 @@ then DO_PTHREADS="#define DO_PTHREADS 1" WANT_IRS_THREADSGR_OBJS="\${WANT_IRS_THREADSGR_OBJS}" WANT_IRS_THREADSPW_OBJS="\${WANT_IRS_THREADSPW_OBJS}" - WANT_IRS_THREADS_OBJS="\${WANT_IRS_THREADS_OBJS}" + case $host in + ia64-hp-hpux11.*) + WANT_IRS_THREADS_OBJS="";; + *) + WANT_IRS_THREADS_OBJS="\${WANT_IRS_THREADS_OBJS}";; + esac WANT_THREADS_OBJS="\${WANT_THREADS_OBJS}" thread_dir=pthreads else @@ -528,7 +533,7 @@ else ;; *) # Turn off the pointlessly noisy warnings. - STD_CWARNINGS="+w1 +W 474,530" + STD_CWARNINGS="+w1 +W 474,530,2193,2236" ;; esac CCOPT="$CCOPT -Ae -z" @@ -589,6 +594,10 @@ AC_CHECK_FUNC(catgets, AC_DEFINE(HAVE_CATGETS),) case "$host" in mips-sgi-irix*) ;; + ia64-hp-hpux11.*) + AC_CHECK_LIB(socket, socket) + AC_CHECK_LIB(nsl, inet_ntoa) + ;; *) AC_CHECK_LIB(d4r, gethostbyname_r) AC_CHECK_LIB(socket, socket) @@ -1310,6 +1319,10 @@ AC_SUBST(GETGROUPLIST_ARGS) AC_CHECK_FUNC(setgroupent,,AC_DEFINE(NEED_SETGROUPENT)) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(getnetbyaddr_r, AC_TRY_COMPILE( [ @@ -1433,6 +1446,8 @@ NET_R_RETURN="#define NET_R_RETURN struct netent *" GETNETBYADDR_ADDR_T="#define GETNETBYADDR_ADDR_T long" NETENT_DATA="#undef NETENT_DATA" ) +esac + case "$host" in *dec-osf*) GETNETBYADDR_ADDR_T="#define GETNETBYADDR_ADDR_T int" ;; esac @@ -1481,6 +1496,11 @@ AC_SUBST(NET_R_ENT_ARGS) AC_SUBST(NET_R_SET_RESULT) AC_SUBST(NET_R_SET_RETURN) + +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(endnetent_r, AC_TRY_COMPILE( [ @@ -1525,6 +1545,7 @@ NET_R_END_RETURN="#define NET_R_END_RETURN void" NET_R_END_RESULT="#define NET_R_END_RESULT(x) /*empty*/" NET_R_END_RETURN="#define NET_R_END_RETURN void" ) +esac AC_SUBST(NET_R_END_RESULT) AC_SUBST(NET_R_END_RETURN) @@ -1577,6 +1598,10 @@ AC_SUBST(GROUP_R_SET_RESULT) AC_SUBST(GROUP_R_SET_RETURN) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(gethostbyname_r, AC_TRY_COMPILE( [ @@ -1649,6 +1674,7 @@ HOST_R_RETURN="#define HOST_R_RETURN struct hostent *" HOST_R_SETANSWER="#undef HOST_R_SETANSWER" HOSTENT_DATA="#undef HOSTENT_DATA" ) +esac AC_SUBST(HOST_R_ARGS) AC_SUBST(HOST_R_BAD) AC_SUBST(HOST_R_COPY) @@ -1659,6 +1685,10 @@ AC_SUBST(HOST_R_RETURN) AC_SUBST(HOST_R_SETANSWER) AC_SUBST(HOSTENT_DATA) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(endhostent_r, AC_TRY_COMPILE([ #undef _REENTRANT @@ -1704,10 +1734,15 @@ HOST_R_END_RESULT="#define HOST_R_END_RESULT(x) /*empty*/" HOST_R_END_RETURN="#define HOST_R_END_RETURN void" HOST_R_ENT_ARGS="#undef HOST_R_ENT_ARGS /*empty*/" ) +esac; AC_SUBST(HOST_R_END_RESULT) AC_SUBST(HOST_R_END_RETURN) AC_SUBST(HOST_R_ENT_ARGS) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(sethostent_r, AC_TRY_COMPILE([ #undef _REENTRANT @@ -1743,6 +1778,7 @@ HOST_R_SET_RETURN="#define HOST_R_SET_RETURN void"], HOST_R_SET_RESULT="#undef HOST_R_SET_RESULT" HOST_R_SET_RETURN="#define HOST_R_SET_RETURN void" ) +esac AC_SUBST(HOST_R_SET_RESULT) AC_SUBST(HOST_R_SET_RETURN) @@ -1784,6 +1820,10 @@ SETGRENT_VOID="#undef SETGRENT_VOID" ) AC_SUBST(SETGRENT_VOID) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(getnetgrent_r, AC_TRY_COMPILE( [ @@ -1851,6 +1891,7 @@ NGR_R_COPY_ARGS="#define NGR_R_COPY_ARGS NGR_R_ARGS" NGR_R_OK="#define NGR_R_OK 1" NGR_R_RETURN="#define NGR_R_RETURN int" ) +esac AC_SUBST(NGR_R_ARGS) AC_SUBST(NGR_R_BAD) AC_SUBST(NGR_R_COPY) @@ -1895,6 +1936,10 @@ AC_SUBST(NGR_R_SET_RETURN) AC_CHECK_FUNC(innetgr_r,,AC_DEFINE(NEED_INNETGR_R)) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(getprotoent_r, AC_TRY_COMPILE( [ @@ -1949,6 +1994,7 @@ PROTO_R_OK="#define PROTO_R_OK pptr" PROTO_R_SETANSWER="#undef PROTO_R_SETANSWER" PROTO_R_RETURN="#define PROTO_R_RETURN struct protoent *" ) +esac AC_SUBST(PROTO_R_ARGS) AC_SUBST(PROTO_R_BAD) AC_SUBST(PROTO_R_COPY) @@ -1957,6 +2003,10 @@ AC_SUBST(PROTO_R_OK) AC_SUBST(PROTO_R_SETANSWER) AC_SUBST(PROTO_R_RETURN) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(endprotoent_r, AC_TRY_COMPILE( [ @@ -1980,10 +2030,15 @@ PROTO_R_END_RESULT="#define PROTO_R_END_RESULT(x) /*empty*/" PROTO_R_END_RETURN="#define PROTO_R_END_RETURN void" PROTO_R_ENT_ARGS="#undef PROTO_R_ENT_ARGS /*empty*/" ) +esac AC_SUBST(PROTO_R_END_RESULT) AC_SUBST(PROTO_R_END_RETURN) AC_SUBST(PROTO_R_ENT_ARGS) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(setprotoent_r, AC_TRY_COMPILE( [ @@ -2002,6 +2057,7 @@ PROTO_R_SET_RETURN="#define PROTO_R_SET_RETURN void" PROTO_R_SET_RESULT="#undef PROTO_R_SET_RESULT" PROTO_R_SET_RETURN="#define PROTO_R_SET_RETURN void" ) +esac AC_SUBST(PROTO_R_SET_RESULT) AC_SUBST(PROTO_R_SET_RETURN) @@ -2091,6 +2147,10 @@ AC_SUBST(PASS_R_SET_RETURN) AC_CHECK_FUNC(getpwnam_r,,AC_DEFINE(NEED_GETPWNAM_R)) AC_CHECK_FUNC(getpwuid_r,,AC_DEFINE(NEED_GETPWUID_R)) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(getservent_r, AC_TRY_COMPILE([ #undef __USE_MISC @@ -2137,6 +2197,7 @@ SERV_R_OK="#define SERV_R_OK sptr" SERV_R_SETANSWER="#undef SERV_R_SETANSWER" SERV_R_RETURN="#define SERV_R_RETURN struct servent *" ) +esac AC_SUBST(SERV_R_ARGS) AC_SUBST(SERV_R_BAD) AC_SUBST(SERV_R_COPY) @@ -2145,6 +2206,10 @@ AC_SUBST(SERV_R_OK) AC_SUBST(SERV_R_SETANSWER) AC_SUBST(SERV_R_RETURN) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(endservent_r, AC_TRY_COMPILE( [ @@ -2169,10 +2234,15 @@ SERV_R_END_RESULT="#define SERV_R_END_RESULT(x) /*empty*/" SERV_R_END_RETURN="#define SERV_R_END_RETURN void " SERV_R_ENT_ARGS="#undef SERV_R_ENT_ARGS /*empty*/" ) +esac AC_SUBST(SERV_R_END_RESULT) AC_SUBST(SERV_R_END_RETURN) AC_SUBST(SERV_R_ENT_ARGS) +case $host in +ia64-hp-hpux11.*) +;; +*) AC_CHECK_FUNC(setservent_r, AC_TRY_COMPILE( [ @@ -2194,6 +2264,7 @@ SERV_R_SET_RETURN="#define SERV_R_SET_RETURN void" SERV_R_SET_RESULT="#undef SERV_R_SET_RESULT" SERV_R_SET_RETURN="#define SERV_R_SET_RETURN void" ) +esac AC_SUBST(SERV_R_SET_RESULT) AC_SUBST(SERV_R_SET_RETURN) diff --git a/lib/bind/dst/dst_api.c b/lib/bind/dst/dst_api.c index b33aebc8..51dfd0b8 100644 --- a/lib/bind/dst/dst_api.c +++ b/lib/bind/dst/dst_api.c @@ -1,5 +1,5 @@ #ifndef LINT -static const char rcsid[] = "$Header: /proj/cvs/prod/bind9/lib/bind/dst/dst_api.c,v 1.4.2.6.8.2 2005/07/28 07:43:16 marka Exp $"; +static const char rcsid[] = "$Header: /proj/cvs/prod/bind9/lib/bind/dst/dst_api.c,v 1.4.2.6.8.3 2005/10/11 00:48:14 marka Exp $"; #endif /* @@ -956,7 +956,6 @@ dst_generate_key(const char *name, const int bits, const int exp, const int flags, const int protocol, const int alg) { DST_KEY *new_key = NULL; - int res; int dnslen; u_char dns[2048]; @@ -978,7 +977,7 @@ dst_generate_key(const char *name, const int bits, const int exp, alg)); return (dst_free_key(new_key)); } - if ((res = new_key->dk_func->generate(new_key, exp)) <= 0) { + if (new_key->dk_func->generate(new_key, exp) <= 0) { EREPORT(("dst_generate_key_pair(): Key generation failure %s %d %d %d\n", new_key->dk_key_name, new_key->dk_alg, new_key->dk_key_size, exp)); diff --git a/lib/bind/dst/support.c b/lib/bind/dst/support.c index 7f66ca4f..8fe3cdb4 100644 --- a/lib/bind/dst/support.c +++ b/lib/bind/dst/support.c @@ -1,4 +1,4 @@ -static const char rcsid[] = "$Header: /proj/cvs/prod/bind9/lib/bind/dst/support.c,v 1.2.2.1.10.1 2005/07/28 07:43:17 marka Exp $"; +static const char rcsid[] = "$Header: /proj/cvs/prod/bind9/lib/bind/dst/support.c,v 1.2.2.1.10.2 2005/10/11 00:48:14 marka Exp $"; /* @@ -103,7 +103,7 @@ dst_s_id_calc(const u_char *key, const int keysize) int size = keysize; if (!key || (keysize <= 0)) - return (-1); + return (0xffffU); for (ac = 0; size > 1; size -= 2, kp += 2) ac += ((*kp) << 8) + *(kp + 1); diff --git a/lib/bind/irs/dns_ho.c b/lib/bind/irs/dns_ho.c index 69b4b4f2..e8da61a0 100644 --- a/lib/bind/irs/dns_ho.c +++ b/lib/bind/irs/dns_ho.c @@ -52,7 +52,7 @@ /* BIND Id: gethnamaddr.c,v 8.15 1996/05/22 04:56:30 vixie Exp $ */ #if defined(LIBC_SCCS) && !defined(lint) -static const char rcsid[] = "$Id: dns_ho.c,v 1.5.2.7.4.5 2004/08/24 00:32:15 marka Exp $"; +static const char rcsid[] = "$Id: dns_ho.c,v 1.5.2.7.4.6 2005/10/11 00:48:14 marka Exp $"; #endif /* LIBC_SCCS and not lint */ /* Imports. */ @@ -688,7 +688,7 @@ gethostans(struct irs_ho *this, { struct pvt *pvt = (struct pvt *)this->private; int type, class, ancount, qdcount, n, haveanswer, had_error; - int error = NETDB_SUCCESS, arcount; + int error = NETDB_SUCCESS; int (*name_ok)(const char *); const HEADER *hp; const u_char *eom; @@ -735,7 +735,6 @@ gethostans(struct irs_ho *this, hp = (const HEADER *)ansbuf; ancount = ntohs(hp->ancount); qdcount = ntohs(hp->qdcount); - arcount = ntohs(hp->arcount); bp = pvt->hostbuf; ep = pvt->hostbuf + sizeof(pvt->hostbuf); cp = ansbuf + HFIXEDSZ; diff --git a/lib/bind/isc/memcluster.c b/lib/bind/isc/memcluster.c index 8db8c51d..c5b72028 100644 --- a/lib/bind/isc/memcluster.c +++ b/lib/bind/isc/memcluster.c @@ -24,7 +24,7 @@ #if !defined(LINT) && !defined(CODECENTER) -static const char rcsid[] = "$Id: memcluster.c,v 1.3.206.6 2005/08/22 01:34:30 marka Exp $"; +static const char rcsid[] = "$Id: memcluster.c,v 1.3.206.7 2005/10/11 00:48:15 marka Exp $"; #endif /* not lint */ #include "port_before.h" @@ -108,8 +108,10 @@ static unsigned int memlock = 0; static size_t max_size; static size_t mem_target; +#ifndef MEMCLUSTER_BIG_MALLOC static size_t mem_target_half; static size_t mem_target_fudge; +#endif static memcluster_element ** freelists; #ifdef MEMCLUSTER_RECORD static memcluster_element ** activelists; @@ -146,8 +148,10 @@ meminit(size_t init_max_size, size_t target_size) { mem_target = DEF_MEM_TARGET; else mem_target = target_size; +#ifndef MEMCLUSTER_BIG_MALLOC mem_target_half = mem_target / 2; mem_target_fudge = mem_target + mem_target / 4; +#endif freelists = malloc(max_size * sizeof (memcluster_element *)); stats = malloc((max_size+1) * sizeof (struct stats)); if (freelists == NULL || stats == NULL) { diff --git a/lib/bind/nameser/ns_parse.c b/lib/bind/nameser/ns_parse.c index 8dfdd6cd..19a6f51b 100644 --- a/lib/bind/nameser/ns_parse.c +++ b/lib/bind/nameser/ns_parse.c @@ -16,7 +16,7 @@ */ #ifndef lint -static const char rcsid[] = "$Id: ns_parse.c,v 1.3.2.1.4.2 2005/08/12 01:36:23 marka Exp $"; +static const char rcsid[] = "$Id: ns_parse.c,v 1.3.2.1.4.3 2005/10/11 00:48:16 marka Exp $"; #endif /* Import. */ @@ -140,7 +140,8 @@ ns_parserr(ns_msg *handle, ns_sect section, int rrnum, ns_rr *rr) { int tmp; /* Make section right. */ - if ((tmp = section) < 0 || section >= ns_s_max) + tmp = section; + if (tmp < 0 || section >= ns_s_max) RETERR(ENODEV); if (section != handle->_sect) setsection(handle, section); diff --git a/lib/bind/nameser/ns_verify.c b/lib/bind/nameser/ns_verify.c index 7ee00a61..adda249b 100644 --- a/lib/bind/nameser/ns_verify.c +++ b/lib/bind/nameser/ns_verify.c @@ -16,7 +16,7 @@ */ #ifndef lint -static const char rcsid[] = "$Id: ns_verify.c,v 1.1.206.1 2004/03/09 08:33:45 marka Exp $"; +static const char rcsid[] = "$Id: ns_verify.c,v 1.1.206.2 2005/10/11 00:48:16 marka Exp $"; #endif /* Import. */ @@ -144,7 +144,7 @@ ns_verify(u_char *msg, int *msglen, void *k, int n; int error; u_int16_t type, length; - u_int16_t fudge, sigfieldlen, id, otherfieldlen; + u_int16_t fudge, sigfieldlen, otherfieldlen; dst_init(); if (msg == NULL || msglen == NULL || *msglen < 0) @@ -198,9 +198,9 @@ ns_verify(u_char *msg, int *msglen, void *k, sigstart = cp; cp += sigfieldlen; - /* Read the original id and error. */ + /* Skip id and read error. */ BOUNDS_CHECK(cp, 2*INT16SZ); - GETSHORT(id, cp); + cp += INT16SZ; GETSHORT(error, cp); /* Parse the other data. */ @@ -341,12 +341,12 @@ ns_verify_tcp(u_char *msg, int *msglen, ns_tcp_tsig_state *state, int required) { HEADER *hp = (HEADER *)msg; - u_char *recstart, *rdatastart, *sigstart; + u_char *recstart, *sigstart; unsigned int sigfieldlen, otherfieldlen; u_char *cp, *eom = msg + *msglen, *cp2; char name[MAXDNAME], alg[MAXDNAME]; u_char buf[MAXDNAME]; - int n, type, length, fudge, id, error; + int n, type, length, fudge, error; time_t timesigned; if (msg == NULL || msglen == NULL || state == NULL) @@ -403,7 +403,6 @@ ns_verify_tcp(u_char *msg, int *msglen, ns_tcp_tsig_state *state, return (NS_TSIG_ERROR_FORMERR); /* Read the algorithm name. */ - rdatastart = cp; n = dn_expand(msg, eom, cp, alg, MAXDNAME); if (n < 0) return (NS_TSIG_ERROR_FORMERR); @@ -429,9 +428,9 @@ ns_verify_tcp(u_char *msg, int *msglen, ns_tcp_tsig_state *state, sigstart = cp; cp += sigfieldlen; - /* Read the original id and error. */ + /* Skip id and read error. */ BOUNDS_CHECK(cp, 2*INT16SZ); - GETSHORT(id, cp); + cp += INT16SZ; GETSHORT(error, cp); /* Parse the other data. */ diff --git a/lib/bind/port_after.h.in b/lib/bind/port_after.h.in index 73d2dbda..0c956b71 100644 --- a/lib/bind/port_after.h.in +++ b/lib/bind/port_after.h.in @@ -299,7 +299,7 @@ GROUP_R_SET_RETURN setgrent_r(GROUP_R_ENT_ARGS); GROUP_R_END_RETURN endgrent_r(GROUP_R_ENT_ARGS); #endif -#ifdef NEED_INNETGR_R +#if defined(NEED_INNETGR_R) && defined(NGR_R_RETURN) NGR_R_RETURN innetgr_r(const char *, const char *, const char *, const char *); #endif @@ -382,7 +382,9 @@ int isc__gettimeofday(struct timeval *tp, struct timezone *tzp); int getnetgrent(char **machinep, char **userp, char **domainp); +#ifdef NGR_R_ARGS int getnetgrent_r(char **machinep, char **userp, char **domainp, NGR_R_ARGS); +#endif #ifdef SETNETGRENT_ARGS void setnetgrent(SETNETGRENT_ARGS); diff --git a/lib/bind/resolv/res_findzonecut.c b/lib/bind/resolv/res_findzonecut.c index 154babde..804beb64 100644 --- a/lib/bind/resolv/res_findzonecut.c +++ b/lib/bind/resolv/res_findzonecut.c @@ -1,5 +1,5 @@ #if !defined(lint) && !defined(SABER) -static const char rcsid[] = "$Id: res_findzonecut.c,v 1.2.2.3.4.3 2004/09/16 07:06:11 marka Exp $"; +static const char rcsid[] = "$Id: res_findzonecut.c,v 1.2.2.3.4.4 2005/10/11 00:48:16 marka Exp $"; #endif /* not lint */ /* @@ -319,7 +319,6 @@ get_soa(res_state statp, const char *dname, ns_class class, int opts, for (i = 0; i < n; i++) { const char *t; const u_char *rdata; - int rdlen; ns_rr rr; if (ns_parserr(&msg, sect, i, &rr) < 0) { @@ -368,7 +367,6 @@ get_soa(res_state statp, const char *dname, ns_class class, int opts, } strcpy(zname, t); rdata = ns_rr_rdata(rr); - rdlen = ns_rr_rdlen(rr); if (ns_name_uncompress(resp, ns_msg_end(msg), rdata, mname, msize) < 0) { DPRINTF(("get_soa: ns_name_uncompress failed") @@ -526,7 +524,6 @@ save_ns(res_state statp, ns_msg *msg, ns_sect sect, const u_char *rdata; rr_ns *nsrr; ns_rr rr; - int rdlen; if (ns_parserr(msg, sect, i, &rr) < 0) { DPRINTF(("save_ns: ns_parserr(%s, %d) failed", @@ -545,7 +542,6 @@ save_ns(res_state statp, ns_msg *msg, ns_sect sect, return (-1); } rdata = ns_rr_rdata(rr); - rdlen = ns_rr_rdlen(rr); if (ns_name_uncompress(ns_msg_base(*msg), ns_msg_end(*msg), rdata, tname, sizeof tname) < 0) { diff --git a/lib/bind/resolv/res_mkupdate.c b/lib/bind/resolv/res_mkupdate.c index aac95e59..a474b67f 100644 --- a/lib/bind/resolv/res_mkupdate.c +++ b/lib/bind/resolv/res_mkupdate.c @@ -21,7 +21,7 @@ */ #if !defined(lint) && !defined(SABER) -static const char rcsid[] = "$Id: res_mkupdate.c,v 1.1.2.1.4.3 2004/06/03 04:44:48 marka Exp $"; +static const char rcsid[] = "$Id: res_mkupdate.c,v 1.1.2.1.4.4 2005/10/11 00:48:16 marka Exp $"; #endif /* not lint */ #include "port_before.h" @@ -78,7 +78,7 @@ int res_nmkupdate(res_state statp, ns_updrec *rrecp_in, u_char *buf, int buflen) { ns_updrec *rrecp_start = rrecp_in; HEADER *hp; - u_char *cp, *sp1, *sp2, *startp, *endp; + u_char *cp, *sp2, *startp, *endp; int n, i, soanum, multiline; ns_updrec *rrecp; struct in_addr ina; @@ -101,7 +101,6 @@ res_nmkupdate(res_state statp, ns_updrec *rrecp_in, u_char *buf, int buflen) { hp->id = htons(++statp->id); hp->opcode = ns_o_update; hp->rcode = NOERROR; - sp1 = buf + 2*INT16SZ; /* save pointer to zocount */ cp = buf + HFIXEDSZ; buflen -= HFIXEDSZ; dpp = dnptrs; diff --git a/lib/bind9/getaddresses.c b/lib/bind9/getaddresses.c index fafc0a6d..02d11047 100644 --- a/lib/bind9/getaddresses.c +++ b/lib/bind9/getaddresses.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 2001, 2002 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: getaddresses.c,v 1.13.126.6 2004/09/16 01:00:58 marka Exp $ */ +/* $Id: getaddresses.c,v 1.13.126.8 2005/10/14 02:13:06 marka Exp $ */ #include <config.h> #include <string.h> @@ -65,8 +65,8 @@ bind9_getaddresses(const char *hostname, in_port_t port, REQUIRE(addrcount != NULL); REQUIRE(addrsize > 0); - have_ipv4 = (isc_net_probeipv4() == ISC_R_SUCCESS); - have_ipv6 = (isc_net_probeipv6() == ISC_R_SUCCESS); + have_ipv4 = ISC_TF((isc_net_probeipv4() == ISC_R_SUCCESS)); + have_ipv6 = ISC_TF((isc_net_probeipv6() == ISC_R_SUCCESS)); /* * Try IPv4, then IPv6. In order to handle the extended format diff --git a/lib/dns/adb.c b/lib/dns/adb.c index 30e0d9b0..5f26c665 100644 --- a/lib/dns/adb.c +++ b/lib/dns/adb.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: adb.c,v 1.181.2.11.2.22 2005/03/17 03:58:29 marka Exp $ */ +/* $Id: adb.c,v 1.181.2.11.2.23 2005/10/14 01:38:47 marka Exp $ */ /* * Implementation notes @@ -1784,7 +1784,7 @@ shutdown_task(isc_task_t *task, isc_event_t *ev) { static isc_boolean_t check_expire_name(dns_adbname_t **namep, isc_stdtime_t now) { dns_adbname_t *name; - isc_result_t result = ISC_FALSE; + isc_boolean_t result = ISC_FALSE; INSIST(namep != NULL && DNS_ADBNAME_VALID(*namep)); name = *namep; @@ -3366,7 +3366,7 @@ dns_adb_marklame(dns_adb_t *adb, dns_adbaddrinfo_t *addr, dns_name_t *zone, unlock: UNLOCK(&adb->entrylocks[bucket]); - return (ISC_R_SUCCESS); + return (result); } void diff --git a/lib/dns/name.c b/lib/dns/name.c index bebb1588..116a56a8 100644 --- a/lib/dns/name.c +++ b/lib/dns/name.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: name.c,v 1.127.2.7.2.13 2005/07/23 04:34:37 marka Exp $ */ +/* $Id: name.c,v 1.127.2.7.2.14 2005/10/14 01:38:48 marka Exp $ */ #include <config.h> @@ -945,9 +945,9 @@ dns_name_fromtext(dns_name_t *name, isc_buffer_t *source, unsigned char *ndata, *label; char *tdata; char c; - ft_state state, kind; - unsigned int value, count, tbcount, bitlength, maxlength; - unsigned int n1, n2, vlen, tlen, nrem, nused, digits, labels, tused; + ft_state state; + unsigned int value, count; + unsigned int n1, n2, tlen, nrem, nused, digits, labels, tused; isc_boolean_t done; unsigned char *offsets; dns_offsets_t odata; @@ -985,15 +985,10 @@ dns_name_fromtext(dns_name_t *name, isc_buffer_t *source, */ n1 = 0; n2 = 0; - vlen = 0; label = NULL; digits = 0; value = 0; count = 0; - tbcount = 0; - bitlength = 0; - maxlength = 0; - kind = ft_init; /* * Make 'name' empty in case of failure. @@ -1051,7 +1046,6 @@ dns_name_fromtext(dns_name_t *name, isc_buffer_t *source, state = ft_initialescape; break; } - kind = ft_ordinary; state = ft_ordinary; if (nrem == 0) return (ISC_R_NOSPACE); @@ -1094,7 +1088,6 @@ dns_name_fromtext(dns_name_t *name, isc_buffer_t *source, */ return (DNS_R_BADLABELTYPE); } - kind = ft_ordinary; state = ft_escape; /* FALLTHROUGH */ case ft_escape: diff --git a/lib/dns/rbtdb.c b/lib/dns/rbtdb.c index d2da6343..f399dd17 100644 --- a/lib/dns/rbtdb.c +++ b/lib/dns/rbtdb.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: rbtdb.c,v 1.168.2.11.2.21 2005/07/07 02:58:53 marka Exp $ */ +/* $Id: rbtdb.c,v 1.168.2.11.2.22 2005/10/14 01:38:48 marka Exp $ */ /* * Principal Author: Bob Halley @@ -2758,10 +2758,9 @@ find_coveringnsec(rbtdb_search_t *search, dns_dbnode_t **nodep, isc_result_t result; dns_fixedname_t fname, forigin; dns_name_t *name, *origin; - rbtdb_rdatatype_t matchtype, sigmatchtype, nsectype; + rbtdb_rdatatype_t matchtype, sigmatchtype; matchtype = RBTDB_RDATATYPE_VALUE(dns_rdatatype_nsec, 0); - nsectype = RBTDB_RDATATYPE_VALUE(0, dns_rdatatype_nsec); sigmatchtype = RBTDB_RDATATYPE_VALUE(dns_rdatatype_rrsig, dns_rdatatype_nsec); diff --git a/lib/dns/resolver.c b/lib/dns/resolver.c index 8d1dbd7d..6f803eb1 100644 --- a/lib/dns/resolver.c +++ b/lib/dns/resolver.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: resolver.c,v 1.218.2.18.4.55 2005/08/25 01:54:32 marka Exp $ */ +/* $Id: resolver.c,v 1.218.2.18.4.56 2005/10/14 01:38:48 marka Exp $ */ #include <config.h> @@ -1890,7 +1890,6 @@ fctx_getaddresses(fetchctx_t *fctx) { isc_boolean_t pruned, all_bad; dns_rdata_ns_t ns; isc_boolean_t need_alternate = ISC_FALSE; - isc_boolean_t unshared; FCTXTRACE("getaddresses"); @@ -1906,7 +1905,6 @@ fctx_getaddresses(fetchctx_t *fctx) { res = fctx->res; pruned = ISC_FALSE; stdoptions = 0; /* Keep compiler happy. */ - unshared = ISC_TF((fctx->options | DNS_FETCHOPT_UNSHARED) != 0); /* * Forwarders. @@ -3483,7 +3481,7 @@ cache_name(fetchctx_t *fctx, dns_name_t *name, dns_adbaddrinfo_t *addrinfo, /* * Cache or validate each cacheable rdataset. */ - fail = (fctx->res->options & DNS_RESOLVER_CHECKNAMESFAIL) != 0; + fail = ISC_TF((fctx->res->options & DNS_RESOLVER_CHECKNAMESFAIL) != 0); for (rdataset = ISC_LIST_HEAD(name->list); rdataset != NULL; rdataset = ISC_LIST_NEXT(rdataset, link)) { diff --git a/lib/dns/validator.c b/lib/dns/validator.c index d65d33e5..17b5bcc5 100644 --- a/lib/dns/validator.c +++ b/lib/dns/validator.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: validator.c,v 1.91.2.5.8.19 2005/08/25 01:54:33 marka Exp $ */ +/* $Id: validator.c,v 1.91.2.5.8.20 2005/10/14 01:38:49 marka Exp $ */ #include <config.h> @@ -323,7 +323,6 @@ static void dsfetched2(isc_task_t *task, isc_event_t *event) { dns_fetchevent_t *devent; dns_validator_t *val; - dns_rdataset_t *rdataset; dns_name_t *tname; isc_boolean_t want_destroy; isc_result_t result; @@ -333,7 +332,6 @@ dsfetched2(isc_task_t *task, isc_event_t *event) { INSIST(event->ev_type == DNS_EVENT_FETCHDONE); devent = (dns_fetchevent_t *)event; val = devent->ev_arg; - rdataset = &val->frdataset; eresult = devent->result; dns_resolver_destroyfetch(&val->fetch); @@ -622,7 +620,7 @@ static void authvalidated(isc_task_t *task, isc_event_t *event) { dns_validatorevent_t *devent; dns_validator_t *val; - dns_rdataset_t *rdataset, *sigrdataset; + dns_rdataset_t *rdataset; isc_boolean_t want_destroy; isc_result_t result; isc_boolean_t exists, data; @@ -632,7 +630,6 @@ authvalidated(isc_task_t *task, isc_event_t *event) { devent = (dns_validatorevent_t *)event; rdataset = devent->rdataset; - sigrdataset = devent->sigrdataset; val = devent->ev_arg; result = devent->result; dns_validator_destroy(&val->subvalidator); diff --git a/lib/dns/xfrin.c b/lib/dns/xfrin.c index aa4d054c..a6a53bd7 100644 --- a/lib/dns/xfrin.c +++ b/lib/dns/xfrin.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 1999-2003 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: xfrin.c,v 1.124.2.4.2.9 2004/10/13 22:28:42 marka Exp $ */ +/* $Id: xfrin.c,v 1.124.2.4.2.11 2005/10/14 02:13:07 marka Exp $ */ #include <config.h> @@ -232,7 +232,7 @@ xfrin_log1(int level, dns_name_t *zonename, dns_rdataclass_t rdclass, ISC_FORMAT_PRINTF(5, 6); static void -xfrin_log(dns_xfrin_ctx_t *xfr, unsigned int level, const char *fmt, ...) +xfrin_log(dns_xfrin_ctx_t *xfr, int level, const char *fmt, ...) ISC_FORMAT_PRINTF(3, 4); /**************************************************************************/ @@ -1391,7 +1391,7 @@ xfrin_log1(int level, dns_name_t *zonename, dns_rdataclass_t rdclass, */ static void -xfrin_log(dns_xfrin_ctx_t *xfr, unsigned int level, const char *fmt, ...) +xfrin_log(dns_xfrin_ctx_t *xfr, int level, const char *fmt, ...) { va_list ap; diff --git a/lib/isc/lfsr.c b/lib/isc/lfsr.c index 5a566a25..6d5b7ff8 100644 --- a/lib/isc/lfsr.c +++ b/lib/isc/lfsr.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: lfsr.c,v 1.11.2.2.2.5 2005/06/09 23:54:30 marka Exp $ */ +/* $Id: lfsr.c,v 1.11.2.2.2.6 2005/10/14 01:38:50 marka Exp $ */ #include <config.h> @@ -56,9 +56,6 @@ isc_lfsr_init(isc_lfsr_t *lfsr, isc_uint32_t state, unsigned int bits, static inline isc_uint32_t lfsr_generate(isc_lfsr_t *lfsr) { - unsigned int highbit; - - highbit = 1 << (lfsr->bits - 1); /* * If the previous state is zero, we must fill it with something diff --git a/lib/isc/unix/ifiter_ioctl.c b/lib/isc/unix/ifiter_ioctl.c index 6842c1f3..0b01b96f 100644 --- a/lib/isc/unix/ifiter_ioctl.c +++ b/lib/isc/unix/ifiter_ioctl.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 1999-2003 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: ifiter_ioctl.c,v 1.19.2.5.2.15 2004/11/10 22:22:49 marka Exp $ */ +/* $Id: ifiter_ioctl.c,v 1.19.2.5.2.17 2005/10/14 02:13:07 marka Exp $ */ /* * Obtain the list of network interfaces using the SIOCGLIFCONF ioctl. @@ -896,7 +896,9 @@ internal_current(isc_interfaceiter_t *iter) { */ static isc_result_t internal_next4(isc_interfaceiter_t *iter) { +#ifdef ISC_PLATFORM_HAVESALEN struct ifreq *ifrp; +#endif REQUIRE (iter->pos < (unsigned int) iter->ifc.ifc_len); @@ -906,14 +908,14 @@ internal_next4(isc_interfaceiter_t *iter) { if (!iter->first) return (ISC_R_SUCCESS); #endif +#ifdef ISC_PLATFORM_HAVESALEN ifrp = (struct ifreq *)((char *) iter->ifc.ifc_req + iter->pos); -#ifdef ISC_PLATFORM_HAVESALEN if (ifrp->ifr_addr.sa_len > sizeof(struct sockaddr)) iter->pos += sizeof(ifrp->ifr_name) + ifrp->ifr_addr.sa_len; else #endif - iter->pos += sizeof(*ifrp); + iter->pos += sizeof(struct ifreq); if (iter->pos >= (unsigned int) iter->ifc.ifc_len) return (ISC_R_NOMORE); @@ -924,21 +926,23 @@ internal_next4(isc_interfaceiter_t *iter) { #if defined(SIOCGLIFCONF) && defined(SIOCGLIFADDR) static isc_result_t internal_next6(isc_interfaceiter_t *iter) { +#ifdef ISC_PLATFORM_HAVESALEN struct LIFREQ *ifrp; +#endif if (iter->result6 != ISC_R_SUCCESS && iter->result6 != ISC_R_IGNORE) return (iter->result6); REQUIRE(iter->pos6 < (unsigned int) iter->lifc.lifc_len); +#ifdef ISC_PLATFORM_HAVESALEN ifrp = (struct LIFREQ *)((char *) iter->lifc.lifc_req + iter->pos6); -#ifdef ISC_PLATFORM_HAVESALEN if (ifrp->lifr_addr.sa_len > sizeof(struct sockaddr)) iter->pos6 += sizeof(ifrp->lifr_name) + ifrp->lifr_addr.sa_len; else #endif - iter->pos6 += sizeof(*ifrp); + iter->pos6 += sizeof(struct LIFREQ); if (iter->pos6 >= (unsigned int) iter->lifc.lifc_len) return (ISC_R_NOMORE); diff --git a/lib/isc/unix/os.c b/lib/isc/unix/os.c index 0838e127..4d34d8ce 100644 --- a/lib/isc/unix/os.c +++ b/lib/isc/unix/os.c @@ -1,5 +1,5 @@ /* - * Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") + * Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC") * Copyright (C) 2000, 2001 Internet Software Consortium. * * Permission to use, copy, modify, and distribute this software for any @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: os.c,v 1.11.12.4 2004/05/18 01:39:20 marka Exp $ */ +/* $Id: os.c,v 1.11.12.6 2005/10/14 02:13:07 marka Exp $ */ #include <config.h> @@ -26,6 +26,7 @@ #include <unistd.h> +#ifndef __hpux static inline long sysconf_ncpus(void) { #if defined(_SC_NPROCESSORS_ONLN) @@ -36,6 +37,7 @@ sysconf_ncpus(void) { return (0); #endif } +#endif #endif /* HAVE_SYSCONF */ diff --git a/lib/lwres/man/lwres.3 b/lib/lwres/man/lwres.3 index fd8542a5..3411eac9 100644 --- a/lib/lwres/man/lwres.3 +++ b/lib/lwres/man/lwres.3 @@ -13,85 +13,145 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres.3,v 1.15.206.4 2005/09/12 00:47:30 marka Exp $ +.\" $Id: lwres.3,v 1.15.206.5 2005/10/13 02:33:58 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres \- introduction to the lightweight resolver library .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi .SH "DESCRIPTION" .PP -The BIND 9 lightweight resolver library is a simple, name service independent stub resolver library\&. It provides hostname\-to\-address and address\-to\-hostname lookup services to applications by transmitting lookup requests to a resolver daemon \fBlwresd\fR running on the local host\&. The resover daemon performs the lookup using the DNS or possibly other name service protocols, and returns the results to the application through the library\&. The library and resolver daemon communicate using a simple UDP\-based protocol\&. +The BIND 9 lightweight resolver library is a simple, name service independent stub resolver library. It provides hostname\-to\-address and address\-to\-hostname lookup services to applications by transmitting lookup requests to a resolver daemon +\fBlwresd\fR +running on the local host. The resover daemon performs the lookup using the DNS or possibly other name service protocols, and returns the results to the application through the library. The library and resolver daemon communicate using a simple UDP\-based protocol. .SH "OVERVIEW" .PP -The lwresd library implements multiple name service APIs\&. The standard \fBgethostbyname()\fR, \fBgethostbyaddr()\fR, \fBgethostbyname_r()\fR, \fBgethostbyaddr_r()\fR, \fBgetaddrinfo()\fR, \fBgetipnodebyname()\fR, and \fBgetipnodebyaddr()\fR 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 lwres_\&. To define the standard names, applications must include the header file \fI<lwres/netdb\&.h>\fR which contains macro definitions mapping the standard function names into lwres_ prefixed ones\&. Operating system vendors who integrate the lwres library into their base distributions should rename the functions in the library proper so that the renaming macros are not needed\&. -.PP -The library also provides a native API consisting of the functions \fBlwres_getaddrsbyname()\fR and \fBlwres_getnamebyaddr()\fR\&. These may be called by applications that require more detailed control over the lookup process than the standard functions provide\&. -.PP -In addition to these name service independent address lookup functions, the library implements a new, experimental API for looking up arbitrary DNS resource records, using the \fBlwres_getaddrsbyname()\fR function\&. -.PP -Finally, there is a low\-level API for converting lookup requests and responses to and from raw lwres protocol packets\&. This API can be used by clients requiring nonblocking operation, and is also used when implementing the server side of the lwres protocol, for example in the \fBlwresd\fR resolver daemon\&. The use of this low\-level API in clients and servers is outlined in the following sections\&. -.SH "CLIENT-SIDE LOW-LEVEL API CALL FLOW" -.PP -When a client program wishes to make an lwres request using the native low\-level API, it typically performs the following sequence of actions\&. -.PP -(1) Allocate or use an existing \fBlwres_packet_t\fR, called \fIpkt\fR below\&. -.PP -(2) Set pkt\&.recvlength to the maximum length we will accept\&. This is done so the receiver of our packets knows how large our receive buffer is\&. The "default" is a constant in \fIlwres\&.h\fR: \fBLWRES_RECVLENGTH = 4096\fR\&. -.PP -(3) Set pkt\&.serial to a unique serial number\&. This value is echoed back to the application by the remote server\&. -.PP -(4) Set pkt\&.pktflags\&. Usually this is set to 0\&. -.PP -(5) Set pkt\&.result to 0\&. -.PP -(6) Call \fBlwres_*request_render()\fR, or marshall in the data using the primitives such as \fBlwres_packet_render()\fR and storing the packet data\&. -.PP -(7) Transmit the resulting buffer\&. -.PP -(8) Call \fBlwres_*response_parse()\fR to parse any packets received\&. -.PP -(9) Verify that the opcode and serial match a request, and process the packet specific information contained in the body\&. -.SH "SERVER-SIDE LOW-LEVEL API CALL FLOW" -.PP -When implementing the server side of the lightweight resolver protocol using the lwres library, a sequence of actions like the following is typically involved in processing each request packet\&. -.PP -Note that the same \fBlwres_packet_t\fR is used in both the \fB_parse()\fR and \fB_render()\fR calls, with only a few modifications made to the packet header's contents between uses\&. This method is recommended as it keeps the serial, opcode, and other fields correct\&. -.PP -(1) When a packet is received, call \fBlwres_*request_parse()\fR to unmarshall it\&. This returns a \fBlwres_packet_t\fR (also called \fIpkt\fR, below) as well as a data specific type, such as \fBlwres_gabnrequest_t\fR\&. -.PP -(2) Process the request in the data specific type\&. -.PP -(3) Set the pkt\&.result, pkt\&.recvlength as above\&. All other fields can be left untouched since they were filled in by the \fB*_parse()\fR call above\&. If using \fBlwres_*response_render()\fR, pkt\&.pktflags will be set up properly\&. Otherwise, the \fBLWRES_LWPACKETFLAG_RESPONSE\fR bit should be set\&. -.PP -(4) Call the data specific rendering function, such as \fBlwres_gabnresponse_render()\fR\&. -.PP -(5) Send the resulting packet to the client\&. +The lwresd library implements multiple name service APIs. The standard +\fBgethostbyname()\fR, +\fBgethostbyaddr()\fR, +\fBgethostbyname_r()\fR, +\fBgethostbyaddr_r()\fR, +\fBgetaddrinfo()\fR, +\fBgetipnodebyname()\fR, and +\fBgetipnodebyaddr()\fR +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 +lwres_. To define the standard names, applications must include the header file +\fI<lwres/netdb.h>\fR +which contains macro definitions mapping the standard function names into +lwres_ +prefixed ones. Operating system vendors who integrate the lwres library into their base distributions should rename the functions in the library proper so that the renaming macros are not needed. +.PP +The library also provides a native API consisting of the functions +\fBlwres_getaddrsbyname()\fR +and +\fBlwres_getnamebyaddr()\fR. These may be called by applications that require more detailed control over the lookup process than the standard functions provide. +.PP +In addition to these name service independent address lookup functions, the library implements a new, experimental API for looking up arbitrary DNS resource records, using the +\fBlwres_getaddrsbyname()\fR +function. +.PP +Finally, there is a low\-level API for converting lookup requests and responses to and from raw lwres protocol packets. This API can be used by clients requiring nonblocking operation, and is also used when implementing the server side of the lwres protocol, for example in the +\fBlwresd\fR +resolver daemon. The use of this low\-level API in clients and servers is outlined in the following sections. +.SH "CLIENT\-SIDE LOW\-LEVEL API CALL FLOW" +.PP +When a client program wishes to make an lwres request using the native low\-level API, it typically performs the following sequence of actions. +.PP +(1) Allocate or use an existing +\fBlwres_packet_t\fR, called +\fIpkt\fR +below. +.PP +(2) Set +pkt.recvlength +to the maximum length we will accept. This is done so the receiver of our packets knows how large our receive buffer is. The "default" is a constant in +\fIlwres.h\fR: +\fBLWRES_RECVLENGTH = 4096\fR. +.PP +(3) Set +pkt.serial +to a unique serial number. This value is echoed back to the application by the remote server. +.PP +(4) Set +pkt.pktflags. Usually this is set to 0. +.PP +(5) Set +pkt.result +to 0. +.PP +(6) Call +\fBlwres_*request_render()\fR, or marshall in the data using the primitives such as +\fBlwres_packet_render()\fR +and storing the packet data. +.PP +(7) Transmit the resulting buffer. +.PP +(8) Call +\fBlwres_*response_parse()\fR +to parse any packets received. +.PP +(9) Verify that the opcode and serial match a request, and process the packet specific information contained in the body. +.SH "SERVER\-SIDE LOW\-LEVEL API CALL FLOW" +.PP +When implementing the server side of the lightweight resolver protocol using the lwres library, a sequence of actions like the following is typically involved in processing each request packet. +.PP +Note that the same +\fBlwres_packet_t\fR +is used in both the +\fB_parse()\fR +and +\fB_render()\fR +calls, with only a few modifications made to the packet header's contents between uses. This method is recommended as it keeps the serial, opcode, and other fields correct. +.PP +(1) When a packet is received, call +\fBlwres_*request_parse()\fR +to unmarshall it. This returns a +\fBlwres_packet_t\fR +(also called +\fIpkt\fR, below) as well as a data specific type, such as +\fBlwres_gabnrequest_t\fR. +.PP +(2) Process the request in the data specific type. +.PP +(3) Set the +pkt.result, +pkt.recvlength +as above. All other fields can be left untouched since they were filled in by the +\fB*_parse()\fR +call above. If using +\fBlwres_*response_render()\fR, +pkt.pktflags +will be set up properly. Otherwise, the +\fBLWRES_LWPACKETFLAG_RESPONSE\fR +bit should be set. +.PP +(4) Call the data specific rendering function, such as +\fBlwres_gabnresponse_render()\fR. +.PP +(5) Send the resulting packet to the client. .PP .SH "SEE ALSO" .PP - \fBlwres_gethostent\fR(3), \fBlwres_getipnode\fR(3), \fBlwres_getnameinfo\fR(3), \fBlwres_noop\fR(3), \fBlwres_gabn\fR(3), \fBlwres_gnba\fR(3), \fBlwres_context\fR(3), \fBlwres_config\fR(3), \fBresolver\fR(5), \fBlwresd\fR(8)\&. +\fBlwres_gethostent\fR(3), +\fBlwres_getipnode\fR(3), +\fBlwres_getnameinfo\fR(3), +\fBlwres_noop\fR(3), +\fBlwres_gabn\fR(3), +\fBlwres_gnba\fR(3), +\fBlwres_context\fR(3), +\fBlwres_config\fR(3), +\fBresolver\fR(5), +\fBlwresd\fR(8). diff --git a/lib/lwres/man/lwres.html b/lib/lwres/man/lwres.html index 0e8b0581..1d5e57bf 100644 --- a/lib/lwres/man/lwres.html +++ b/lib/lwres/man/lwres.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres.html,v 1.4.2.1.4.7 2005/07/18 02:36:51 marka Exp $ --> +<!-- $Id: lwres.html,v 1.4.2.1.4.9 2005/10/13 02:33:54 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres — introduction to the lightweight resolver library</p> @@ -32,7 +32,7 @@ <div class="funcsynopsis"><pre class="funcsynopsisinfo">#include <lwres/lwres.h></pre></div> </div> <div class="refsect1" lang="en"> -<a name="id2514515"></a><h2>DESCRIPTION</h2> +<a name="id2525832"></a><h2>DESCRIPTION</h2> <p> The BIND 9 lightweight resolver library is a simple, name service independent stub resolver library. It provides hostname-to-address @@ -47,7 +47,7 @@ UDP-based protocol. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514528"></a><h2>OVERVIEW</h2> +<a name="id2525845"></a><h2>OVERVIEW</h2> <p> The lwresd library implements multiple name service APIs. The standard @@ -101,7 +101,7 @@ and servers is outlined in the following sections. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514592"></a><h2>CLIENT-SIDE LOW-LEVEL API CALL FLOW</h2> +<a name="id2525909"></a><h2>CLIENT-SIDE LOW-LEVEL API CALL FLOW</h2> <p> When a client program wishes to make an lwres request using the native low-level API, it typically performs the following @@ -147,7 +147,7 @@ packet specific information contained in the body. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514875"></a><h2>SERVER-SIDE LOW-LEVEL API CALL FLOW</h2> +<a name="id2526056"></a><h2>SERVER-SIDE LOW-LEVEL API CALL FLOW</h2> <p> When implementing the server side of the lightweight resolver protocol using the lwres library, a sequence of actions like the @@ -188,7 +188,7 @@ set. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514961"></a><h2>SEE ALSO</h2> +<a name="id2526141"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres_gethostent</span>(3)</span>, diff --git a/lib/lwres/man/lwres_buffer.3 b/lib/lwres/man/lwres_buffer.3 index fc177a1e..93e888b0 100644 --- a/lib/lwres/man/lwres_buffer.3 +++ b/lib/lwres/man/lwres_buffer.3 @@ -13,77 +13,81 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_buffer.3,v 1.12.2.1.8.4 2005/09/12 00:47:30 marka Exp $ +.\" $Id: lwres_buffer.3,v 1.12.2.1.8.5 2005/10/13 02:33:58 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_BUFFER" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_BUFFER" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_buffer_init, lwres_buffer_invalidate, lwres_buffer_add, lwres_buffer_subtract, lwres_buffer_clear, lwres_buffer_first, lwres_buffer_forward, lwres_buffer_back, lwres_buffer_getuint8, lwres_buffer_putuint8, lwres_buffer_getuint16, lwres_buffer_putuint16, lwres_buffer_getuint32, lwres_buffer_putuint32, lwres_buffer_putmem, lwres_buffer_getmem \- lightweight resolver buffer management .SH "SYNOPSIS" .nf -#include <lwres/lwbuffer\&.h> +#include <lwres/lwbuffer.h> .fi +.HP 23 +\fBvoid\ \fBlwres_buffer_init\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBvoid\ *base\fR\fB, \fR\fBunsigned\ int\ length\fR\fB);\fR +.HP 29 +\fBvoid\ \fBlwres_buffer_invalidate\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 22 +\fBvoid\ \fBlwres_buffer_add\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBunsigned\ int\ n\fR\fB);\fR +.HP 27 +\fBvoid\ \fBlwres_buffer_subtract\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBunsigned\ int\ n\fR\fB);\fR .HP 24 -void\ \fBlwres_buffer_init\fR\ (lwres_buffer_t\ *b, void\ *base, unsigned\ int\ length); -.HP 30 -void\ \fBlwres_buffer_invalidate\fR\ (lwres_buffer_t\ *b); +\fBvoid\ \fBlwres_buffer_clear\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 24 +\fBvoid\ \fBlwres_buffer_first\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 26 +\fBvoid\ \fBlwres_buffer_forward\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBunsigned\ int\ n\fR\fB);\fR .HP 23 -void\ \fBlwres_buffer_add\fR\ (lwres_buffer_t\ *b, unsigned\ int\ n); +\fBvoid\ \fBlwres_buffer_back\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBunsigned\ int\ n\fR\fB);\fR +.HP 36 +\fBlwres_uint8_t\ \fBlwres_buffer_getuint8\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 27 +\fBvoid\ \fBlwres_buffer_putuint8\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_uint8_t\ val\fR\fB);\fR +.HP 38 +\fBlwres_uint16_t\ \fBlwres_buffer_getuint16\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 28 +\fBvoid\ \fBlwres_buffer_putuint16\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_uint16_t\ val\fR\fB);\fR +.HP 38 +\fBlwres_uint32_t\ \fBlwres_buffer_getuint32\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB);\fR .HP 28 -void\ \fBlwres_buffer_subtract\fR\ (lwres_buffer_t\ *b, unsigned\ int\ n); +\fBvoid\ \fBlwres_buffer_putuint32\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_uint32_t\ val\fR\fB);\fR .HP 25 -void\ \fBlwres_buffer_clear\fR\ (lwres_buffer_t\ *b); +\fBvoid\ \fBlwres_buffer_putmem\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBconst\ unsigned\ char\ *base\fR\fB, \fR\fBunsigned\ int\ length\fR\fB);\fR .HP 25 -void\ \fBlwres_buffer_first\fR\ (lwres_buffer_t\ *b); -.HP 27 -void\ \fBlwres_buffer_forward\fR\ (lwres_buffer_t\ *b, unsigned\ int\ n); -.HP 24 -void\ \fBlwres_buffer_back\fR\ (lwres_buffer_t\ *b, unsigned\ int\ n); -.HP 37 -lwres_uint8_t\ \fBlwres_buffer_getuint8\fR\ (lwres_buffer_t\ *b); -.HP 28 -void\ \fBlwres_buffer_putuint8\fR\ (lwres_buffer_t\ *b, lwres_uint8_t\ val); -.HP 39 -lwres_uint16_t\ \fBlwres_buffer_getuint16\fR\ (lwres_buffer_t\ *b); -.HP 29 -void\ \fBlwres_buffer_putuint16\fR\ (lwres_buffer_t\ *b, lwres_uint16_t\ val); -.HP 39 -lwres_uint32_t\ \fBlwres_buffer_getuint32\fR\ (lwres_buffer_t\ *b); -.HP 29 -void\ \fBlwres_buffer_putuint32\fR\ (lwres_buffer_t\ *b, lwres_uint32_t\ val); -.HP 26 -void\ \fBlwres_buffer_putmem\fR\ (lwres_buffer_t\ *b, const\ unsigned\ char\ *base, unsigned\ int\ length); -.HP 26 -void\ \fBlwres_buffer_getmem\fR\ (lwres_buffer_t\ *b, unsigned\ char\ *base, unsigned\ int\ length); +\fBvoid\ \fBlwres_buffer_getmem\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBunsigned\ char\ *base\fR\fB, \fR\fBunsigned\ int\ length\fR\fB);\fR .SH "DESCRIPTION" .PP -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 isc_buffer_ functions in the ISC library\&. -.PP -A buffer is a region of memory, together with a set of related subregions\&. The \fIused region\fR and the \fIavailable\fR region are disjoint, and their union is the buffer's region\&. The used region extends from the beginning of the buffer region to the last used byte\&. The available region extends from one byte greater than the last used byte to the end of the buffer's region\&. The size of the used region can be changed using various buffer commands\&. Initially, the used region is empty\&. -.PP -The used region is further subdivided into two disjoint regions: the \fIconsumed region\fR and the \fIremaining region\fR\&. The union of these two regions is the used region\&. The consumed region extends from the beginning of the used region to the byte before the \fIcurrent\fR offset (if any)\&. The \fIremaining\fR region the current pointer to the end of the used region\&. The size of the consumed region can be changed using various buffer commands\&. Initially, the consumed region is empty\&. -.PP -The \fIactive region\fR is an (optional) subregion of the remaining region\&. It extends from the current offset to an offset in the remaining region\&. Initially, the active region is empty\&. If the current offset advances beyond the chosen offset, the active region will also be empty\&. +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 +isc_buffer_ +functions in the ISC library. +.PP +A buffer is a region of memory, together with a set of related subregions. The +\fIused region\fR +and the +\fIavailable\fR +region are disjoint, and their union is the buffer's region. The used region extends from the beginning of the buffer region to the last used byte. The available region extends from one byte greater than the last used byte to the end of the buffer's region. The size of the used region can be changed using various buffer commands. Initially, the used region is empty. +.PP +The used region is further subdivided into two disjoint regions: the +\fIconsumed region\fR +and the +\fIremaining region\fR. The union of these two regions is the used region. The consumed region extends from the beginning of the used region to the byte before the +\fIcurrent\fR +offset (if any). The +\fIremaining\fR +region the current pointer to the end of the used region. The size of the consumed region can be changed using various buffer commands. Initially, the consumed region is empty. +.PP +The +\fIactive region\fR +is an (optional) subregion of the remaining region. It extends from the current offset to an offset in the remaining region. Initially, the active region is empty. If the current offset advances beyond the chosen offset, the active region will also be empty. .PP .nf /\-\-\-\-\-\-\-\-\-\-\-\-entire length\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\\\\ @@ -92,32 +96,116 @@ The \fIactive region\fR is an (optional) subregion of the remaining region\&. It | consumed | remaining | | +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ a b c d e - a == base of buffer\&. - b == current pointer\&. Can be anywhere between a and d\&. - c == active pointer\&. Meaningful between b and d\&. - d == used pointer\&. - e == length of buffer\&. - a\-e == entire length of buffer\&. - a\-d == used region\&. - a\-b == consumed region\&. - b\-d == remaining region\&. - b\-c == optional active region\&. + a == base of buffer. + b == current pointer. Can be anywhere between a and d. + c == active pointer. Meaningful between b and d. + d == used pointer. + e == length of buffer. + a\-e == entire length of buffer. + a\-d == used region. + a\-b == consumed region. + b\-d == remaining region. + b\-c == optional active region. .fi -.PP - \fBlwres_buffer_init()\fR initializes the \fBlwres_buffer_t\fR \fI*b\fR and assocates it with the memory region of size \fIlength\fR bytes starting at location \fIbase\&.\fR -.PP - \fBlwres_buffer_invalidate()\fR marks the buffer \fI*b\fR as invalid\&. Invalidating a buffer after use is not required, but makes it possible to catch its possible accidental use\&. -.PP -The functions \fBlwres_buffer_add()\fR and \fBlwres_buffer_subtract()\fR respectively increase and decrease the used space in buffer \fI*b\fR by \fIn\fR bytes\&. \fBlwres_buffer_add()\fR checks for buffer overflow and \fBlwres_buffer_subtract()\fR checks for underflow\&. These functions do not allocate or deallocate memory\&. They just change the value of used\&. -.PP -A buffer is re\-initialised by \fBlwres_buffer_clear()\fR\&. The function sets used , current and active to zero\&. -.PP - \fBlwres_buffer_first\fR makes the consumed region of buffer \fI*p\fR empty by setting current to zero (the start of the buffer)\&. -.PP - \fBlwres_buffer_forward()\fR increases the consumed region of buffer \fI*b\fR by \fIn\fR bytes, checking for overflow\&. Similarly, \fBlwres_buffer_back()\fR decreases buffer \fIb\fR's consumed region by \fIn\fR bytes and checks for underflow\&. -.PP - \fBlwres_buffer_getuint8()\fR reads an unsigned 8\-bit integer from \fI*b\fR and returns it\&. \fBlwres_buffer_putuint8()\fR writes the unsigned 8\-bit integer \fIval\fR to buffer \fI*b\fR\&. -.PP - \fBlwres_buffer_getuint16()\fR and \fBlwres_buffer_getuint32()\fR are identical to \fBlwres_buffer_putuint8()\fR except that they respectively read an unsigned 16\-bit or 32\-bit integer in network byte order from \fIb\fR\&. Similarly, \fBlwres_buffer_putuint16()\fR and \fBlwres_buffer_putuint32()\fR writes the unsigned 16\-bit or 32\-bit integer \fIval\fR to buffer \fIb\fR, in network byte order\&. -.PP -Arbitrary amounts of data are read or written from a lightweight resolver buffer with \fBlwres_buffer_getmem()\fR and \fBlwres_buffer_putmem()\fR respectively\&. \fBlwres_buffer_putmem()\fR copies \fIlength\fR bytes of memory at \fIbase\fR to \fIb\fR\&. Conversely, \fBlwres_buffer_getmem()\fR copies \fIlength\fR bytes of memory from \fIb\fR to \fIbase\fR\&. +.sp +.PP +\fBlwres_buffer_init()\fR +initializes the +\fBlwres_buffer_t\fR\fI*b\fR +and assocates it with the memory region of size +\fIlength\fR +bytes starting at location +\fIbase.\fR +.PP +\fBlwres_buffer_invalidate()\fR +marks the buffer +\fI*b\fR +as invalid. Invalidating a buffer after use is not required, but makes it possible to catch its possible accidental use. +.PP +The functions +\fBlwres_buffer_add()\fR +and +\fBlwres_buffer_subtract()\fR +respectively increase and decrease the used space in buffer +\fI*b\fR +by +\fIn\fR +bytes. +\fBlwres_buffer_add()\fR +checks for buffer overflow and +\fBlwres_buffer_subtract()\fR +checks for underflow. These functions do not allocate or deallocate memory. They just change the value of +used. +.PP +A buffer is re\-initialised by +\fBlwres_buffer_clear()\fR. The function sets +used +, +current +and +active +to zero. +.PP +\fBlwres_buffer_first\fR +makes the consumed region of buffer +\fI*p\fR +empty by setting +current +to zero (the start of the buffer). +.PP +\fBlwres_buffer_forward()\fR +increases the consumed region of buffer +\fI*b\fR +by +\fIn\fR +bytes, checking for overflow. Similarly, +\fBlwres_buffer_back()\fR +decreases buffer +\fIb\fR's consumed region by +\fIn\fR +bytes and checks for underflow. +.PP +\fBlwres_buffer_getuint8()\fR +reads an unsigned 8\-bit integer from +\fI*b\fR +and returns it. +\fBlwres_buffer_putuint8()\fR +writes the unsigned 8\-bit integer +\fIval\fR +to buffer +\fI*b\fR. +.PP +\fBlwres_buffer_getuint16()\fR +and +\fBlwres_buffer_getuint32()\fR +are identical to +\fBlwres_buffer_putuint8()\fR +except that they respectively read an unsigned 16\-bit or 32\-bit integer in network byte order from +\fIb\fR. Similarly, +\fBlwres_buffer_putuint16()\fR +and +\fBlwres_buffer_putuint32()\fR +writes the unsigned 16\-bit or 32\-bit integer +\fIval\fR +to buffer +\fIb\fR, in network byte order. +.PP +Arbitrary amounts of data are read or written from a lightweight resolver buffer with +\fBlwres_buffer_getmem()\fR +and +\fBlwres_buffer_putmem()\fR +respectively. +\fBlwres_buffer_putmem()\fR +copies +\fIlength\fR +bytes of memory at +\fIbase\fR +to +\fIb\fR. Conversely, +\fBlwres_buffer_getmem()\fR +copies +\fIlength\fR +bytes of memory from +\fIb\fR +to +\fIbase\fR. diff --git a/lib/lwres/man/lwres_buffer.html b/lib/lwres/man/lwres_buffer.html index c6bcf387..5a203f1a 100644 --- a/lib/lwres/man/lwres_buffer.html +++ b/lib/lwres/man/lwres_buffer.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_buffer.html,v 1.4.2.1.4.7 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_buffer.html,v 1.4.2.1.4.8 2005/10/13 02:33:55 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_buffer</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_buffer_init, lwres_buffer_invalidate, lwres_buffer_add, lwres_buffer_subtract, lwres_buffer_clear, lwres_buffer_first, lwres_buffer_forward, lwres_buffer_back, lwres_buffer_getuint8, lwres_buffer_putuint8, lwres_buffer_getuint16, lwres_buffer_putuint16, lwres_buffer_getuint32, lwres_buffer_putuint32, lwres_buffer_putmem, lwres_buffer_getmem — lightweight resolver buffer management</p> @@ -249,7 +249,7 @@ void </div> </div> <div class="refsect1" lang="en"> -<a name="id2514860"></a><h2>DESCRIPTION</h2> +<a name="id2526109"></a><h2>DESCRIPTION</h2> <p> These functions provide bounds checked access to a region of memory where data is being read or written. diff --git a/lib/lwres/man/lwres_config.3 b/lib/lwres/man/lwres_config.3 index 20d95a3d..94302837 100644 --- a/lib/lwres/man/lwres_config.3 +++ b/lib/lwres/man/lwres_config.3 @@ -13,63 +13,85 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_config.3,v 1.12.2.1.8.4 2005/09/12 00:47:30 marka Exp $ +.\" $Id: lwres_config.3,v 1.12.2.1.8.5 2005/10/13 02:33:58 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_CONFIG" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_CONFIG" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get \- lightweight resolver configuration .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi +.HP 21 +\fBvoid\ \fBlwres_conf_init\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB);\fR .HP 22 -void\ \fBlwres_conf_init\fR\ (lwres_context_t\ *ctx); -.HP 23 -void\ \fBlwres_conf_clear\fR\ (lwres_context_t\ *ctx); -.HP 33 -lwres_result_t\ \fBlwres_conf_parse\fR\ (lwres_context_t\ *ctx, const\ char\ *filename); -.HP 33 -lwres_result_t\ \fBlwres_conf_print\fR\ (lwres_context_t\ *ctx, FILE\ *fp); +\fBvoid\ \fBlwres_conf_clear\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB);\fR +.HP 32 +\fBlwres_result_t\ \fBlwres_conf_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBconst\ char\ *filename\fR\fB);\fR .HP 32 -lwres_conf_t\ *\ \fBlwres_conf_get\fR\ (lwres_context_t\ *ctx); +\fBlwres_result_t\ \fBlwres_conf_print\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBFILE\ *fp\fR\fB);\fR +.HP 30 +\fBlwres_conf_t\ *\ \fBlwres_conf_get\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB);\fR .SH "DESCRIPTION" .PP - \fBlwres_conf_init()\fR creates an empty \fBlwres_conf_t\fR structure for lightweight resolver context \fIctx\fR\&. +\fBlwres_conf_init()\fR +creates an empty +\fBlwres_conf_t\fR +structure for lightweight resolver context +\fIctx\fR. .PP - \fBlwres_conf_clear()\fR frees up all the internal memory used by that \fBlwres_conf_t\fR structure in resolver context \fIctx\fR\&. +\fBlwres_conf_clear()\fR +frees up all the internal memory used by that +\fBlwres_conf_t\fR +structure in resolver context +\fIctx\fR. .PP - \fBlwres_conf_parse()\fR opens the file \fIfilename\fR and parses it to initialise the resolver context \fIctx\fR's \fBlwres_conf_t\fR structure\&. +\fBlwres_conf_parse()\fR +opens the file +\fIfilename\fR +and parses it to initialise the resolver context +\fIctx\fR's +\fBlwres_conf_t\fR +structure. .PP - \fBlwres_conf_print()\fR prints the \fBlwres_conf_t\fR structure for resolver context \fIctx\fR to the \fBFILE\fR \fIfp\fR\&. +\fBlwres_conf_print()\fR +prints the +\fBlwres_conf_t\fR +structure for resolver context +\fIctx\fR +to the +\fBFILE\fR\fIfp\fR. .SH "RETURN VALUES" .PP - \fBlwres_conf_parse()\fR returns \fBLWRES_R_SUCCESS\fR if it successfully read and parsed \fIfilename\fR\&. It returns \fBLWRES_R_FAILURE\fR if \fIfilename\fR could not be opened or contained incorrect resolver statements\&. +\fBlwres_conf_parse()\fR +returns +\fBLWRES_R_SUCCESS\fR +if it successfully read and parsed +\fIfilename\fR. It returns +\fBLWRES_R_FAILURE\fR +if +\fIfilename\fR +could not be opened or contained incorrect resolver statements. .PP - \fBlwres_conf_print()\fR returns \fBLWRES_R_SUCCESS\fR unless an error occurred when converting the network addresses to a numeric host address string\&. If this happens, the function returns \fBLWRES_R_FAILURE\fR\&. +\fBlwres_conf_print()\fR +returns +\fBLWRES_R_SUCCESS\fR +unless an error occurred when converting the network addresses to a numeric host address string. If this happens, the function returns +\fBLWRES_R_FAILURE\fR. .SH "SEE ALSO" .PP - \fBstdio\fR(3), \fBresolver\fR(5)\&. +\fBstdio\fR(3), +\fBresolver\fR(5). .SH "FILES" .PP - \fI/etc/resolv\&.conf\fR +\fI/etc/resolv.conf\fR diff --git a/lib/lwres/man/lwres_config.html b/lib/lwres/man/lwres_config.html index 41f04877..7ea416b6 100644 --- a/lib/lwres/man/lwres_config.html +++ b/lib/lwres/man/lwres_config.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_config.html,v 1.4.2.1.4.7 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_config.html,v 1.4.2.1.4.9 2005/10/13 02:33:55 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_config</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_conf_init, lwres_conf_clear, lwres_conf_parse, lwres_conf_print, lwres_conf_get — lightweight resolver configuration</p> @@ -88,7 +88,7 @@ lwres_conf_t * </div> </div> <div class="refsect1" lang="en"> -<a name="id2514593"></a><h2>DESCRIPTION</h2> +<a name="id2525910"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_conf_init()</code> creates an empty @@ -125,7 +125,7 @@ to the </p> </div> <div class="refsect1" lang="en"> -<a name="id2514664"></a><h2>RETURN VALUES</h2> +<a name="id2525981"></a><h2>RETURN VALUES</h2> <p> <code class="function">lwres_conf_parse()</code> returns @@ -150,14 +150,14 @@ If this happens, the function returns </p> </div> <div class="refsect1" lang="en"> -<a name="id2514772"></a><h2>SEE ALSO</h2> +<a name="id2526021"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">stdio</span>(3)</span>, <span class="citerefentry"><span class="refentrytitle">resolver</span>(5)</span>. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514798"></a><h2>FILES</h2> +<a name="id2526048"></a><h2>FILES</h2> <p> <code class="filename">/etc/resolv.conf</code> </p> diff --git a/lib/lwres/man/lwres_context.3 b/lib/lwres/man/lwres_context.3 index c839781d..be8cd387 100644 --- a/lib/lwres/man/lwres_context.3 +++ b/lib/lwres/man/lwres_context.3 @@ -13,72 +13,149 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_context.3,v 1.13.2.2.2.5 2005/09/12 00:47:26 marka Exp $ +.\" $Id: lwres_context.3,v 1.13.2.2.2.6 2005/10/13 02:33:52 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_CONTEXT" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_CONTEXT" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_context_create, lwres_context_destroy, lwres_context_nextserial, lwres_context_initserial, lwres_context_freemem, lwres_context_allocmem, lwres_context_sendrecv \- lightweight resolver context management .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi +.HP 36 +\fBlwres_result_t\ \fBlwres_context_create\fR\fR\fB(\fR\fBlwres_context_t\ **contextp\fR\fB, \fR\fBvoid\ *arg\fR\fB, \fR\fBlwres_malloc_t\ malloc_function\fR\fB, \fR\fBlwres_free_t\ free_function\fR\fB);\fR .HP 37 -lwres_result_t\ \fBlwres_context_create\fR\ (lwres_context_t\ **contextp, void\ *arg, lwres_malloc_t\ malloc_function, lwres_free_t\ free_function); -.HP 38 -lwres_result_t\ \fBlwres_context_destroy\fR\ (lwres_context_t\ **contextp); -.HP 31 -void\ \fBlwres_context_initserial\fR\ (lwres_context_t\ *ctx, lwres_uint32_t\ serial); -.HP 41 -lwres_uint32_t\ \fBlwres_context_nextserial\fR\ (lwres_context_t\ *ctx); +\fBlwres_result_t\ \fBlwres_context_destroy\fR\fR\fB(\fR\fBlwres_context_t\ **contextp\fR\fB);\fR +.HP 30 +\fBvoid\ \fBlwres_context_initserial\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_uint32_t\ serial\fR\fB);\fR +.HP 40 +\fBlwres_uint32_t\ \fBlwres_context_nextserial\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB);\fR +.HP 27 +\fBvoid\ \fBlwres_context_freemem\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBvoid\ *mem\fR\fB, \fR\fBsize_t\ len\fR\fB);\fR .HP 28 -void\ \fBlwres_context_freemem\fR\ (lwres_context_t\ *ctx, void\ *mem, size_t\ len); -.HP 29 -void\ \fBlwres_context_allocmem\fR\ (lwres_context_t\ *ctx, size_t\ len); -.HP 32 -void\ *\ \fBlwres_context_sendrecv\fR\ (lwres_context_t\ *ctx, void\ *sendbase, int\ sendlen, void\ *recvbase, int\ recvlen, int\ *recvd_len); +\fBvoid\ \fBlwres_context_allocmem\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBsize_t\ len\fR\fB);\fR +.HP 30 +\fBvoid\ *\ \fBlwres_context_sendrecv\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBvoid\ *sendbase\fR\fB, \fR\fBint\ sendlen\fR\fB, \fR\fBvoid\ *recvbase\fR\fB, \fR\fBint\ recvlen\fR\fB, \fR\fBint\ *recvd_len\fR\fB);\fR .SH "DESCRIPTION" .PP - \fBlwres_context_create()\fR creates a \fBlwres_context_t\fR structure for use in lightweight resolver operations\&. It holds a socket and other data needed for communicating with a resolver daemon\&. The new \fBlwres_context_t\fR is returned through \fIcontextp\fR, a pointer to a \fBlwres_context_t\fR pointer\&. This \fBlwres_context_t\fR pointer must initially be NULL, and is modified to point to the newly created \fBlwres_context_t\fR\&. +\fBlwres_context_create()\fR +creates a +\fBlwres_context_t\fR +structure for use in lightweight resolver operations. It holds a socket and other data needed for communicating with a resolver daemon. The new +\fBlwres_context_t\fR +is returned through +\fIcontextp\fR, a pointer to a +\fBlwres_context_t\fR +pointer. This +\fBlwres_context_t\fR +pointer must initially be NULL, and is modified to point to the newly created +\fBlwres_context_t\fR. .PP -When the lightweight resolver needs to perform dynamic memory allocation, it will call \fImalloc_function\fR to allocate memory and \fIfree_function\fR to free it\&. If \fImalloc_function\fR and \fIfree_function\fR are NULL, memory is allocated using \&.Xr malloc 3 and \fBfree\fR(3)\&. It is not permitted to have a NULL \fImalloc_function\fR and a non\-NULL \fIfree_function\fR or vice versa\&. \fIarg\fR is passed as the first parameter to the memory allocation functions\&. If \fImalloc_function\fR and \fIfree_function\fR are NULL, \fIarg\fR is unused and should be passed as NULL\&. +When the lightweight resolver needs to perform dynamic memory allocation, it will call +\fImalloc_function\fR +to allocate memory and +\fIfree_function\fR +to free it. If +\fImalloc_function\fR +and +\fIfree_function\fR +are NULL, memory is allocated using .Xr malloc 3 and +\fBfree\fR(3). It is not permitted to have a NULL +\fImalloc_function\fR +and a non\-NULL +\fIfree_function\fR +or vice versa. +\fIarg\fR +is passed as the first parameter to the memory allocation functions. If +\fImalloc_function\fR +and +\fIfree_function\fR +are NULL, +\fIarg\fR +is unused and should be passed as NULL. .PP -Once memory for the structure has been allocated, it is initialized using \fBlwres_conf_init\fR(3) and returned via \fI*contextp\fR\&. +Once memory for the structure has been allocated, it is initialized using +\fBlwres_conf_init\fR(3) +and returned via +\fI*contextp\fR. .PP - \fBlwres_context_destroy()\fR destroys a \fBlwres_context_t\fR, closing its socket\&. \fIcontextp\fR 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\&. +\fBlwres_context_destroy()\fR +destroys a +\fBlwres_context_t\fR, closing its socket. +\fIcontextp\fR +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. .PP -The context holds a serial number that is used to identify resolver request packets and associate responses with the corresponding requests\&. This serial number is controlled using \fBlwres_context_initserial()\fR and \fBlwres_context_nextserial()\fR\&. \fBlwres_context_initserial()\fR sets the serial number for context \fI*ctx\fR to \fIserial\fR\&. \fBlwres_context_nextserial()\fR increments the serial number and returns the previous value\&. +The context holds a serial number that is used to identify resolver request packets and associate responses with the corresponding requests. This serial number is controlled using +\fBlwres_context_initserial()\fR +and +\fBlwres_context_nextserial()\fR. +\fBlwres_context_initserial()\fR +sets the serial number for context +\fI*ctx\fR +to +\fIserial\fR. +\fBlwres_context_nextserial()\fR +increments the serial number and returns the previous value. .PP -Memory for a lightweight resolver context is allocated and freed using \fBlwres_context_allocmem()\fR and \fBlwres_context_freemem()\fR\&. These use whatever allocations were defined when the context was created with \fBlwres_context_create()\fR\&. \fBlwres_context_allocmem()\fR allocates \fIlen\fR bytes of memory and if successful returns a pointer to the allocated storage\&. \fBlwres_context_freemem()\fR frees \fIlen\fR bytes of space starting at location \fImem\fR\&. +Memory for a lightweight resolver context is allocated and freed using +\fBlwres_context_allocmem()\fR +and +\fBlwres_context_freemem()\fR. These use whatever allocations were defined when the context was created with +\fBlwres_context_create()\fR. +\fBlwres_context_allocmem()\fR +allocates +\fIlen\fR +bytes of memory and if successful returns a pointer to the allocated storage. +\fBlwres_context_freemem()\fR +frees +\fIlen\fR +bytes of space starting at location +\fImem\fR. .PP - \fBlwres_context_sendrecv()\fR performs I/O for the context \fIctx\fR\&. Data are read and written from the context's socket\&. It writes data from \fIsendbase\fR -- typically a lightweight resolver query packet -- and waits for a reply which is copied to the receive buffer at \fIrecvbase\fR\&. The number of bytes that were written to this receive buffer is returned in \fI*recvd_len\fR\&. +\fBlwres_context_sendrecv()\fR +performs I/O for the context +\fIctx\fR. Data are read and written from the context's socket. It writes data from +\fIsendbase\fR +\(em typically a lightweight resolver query packet \(em and waits for a reply which is copied to the receive buffer at +\fIrecvbase\fR. The number of bytes that were written to this receive buffer is returned in +\fI*recvd_len\fR. .SH "RETURN VALUES" .PP - \fBlwres_context_create()\fR returns \fBLWRES_R_NOMEMORY\fR if memory for the \fBstruct lwres_context\fR could not be allocated, \fBLWRES_R_SUCCESS\fR otherwise\&. +\fBlwres_context_create()\fR +returns +\fBLWRES_R_NOMEMORY\fR +if memory for the +\fBstruct lwres_context\fR +could not be allocated, +\fBLWRES_R_SUCCESS\fR +otherwise. .PP -Successful calls to the memory allocator \fBlwres_context_allocmem()\fR return a pointer to the start of the allocated space\&. It returns NULL if memory could not be allocated\&. +Successful calls to the memory allocator +\fBlwres_context_allocmem()\fR +return a pointer to the start of the allocated space. It returns NULL if memory could not be allocated. .PP - \fBLWRES_R_SUCCESS\fR is returned when \fBlwres_context_sendrecv()\fR completes successfully\&. \fBLWRES_R_IOERROR\fR is returned if an I/O error occurs and \fBLWRES_R_TIMEOUT\fR is returned if \fBlwres_context_sendrecv()\fR times out waiting for a response\&. +\fBLWRES_R_SUCCESS\fR +is returned when +\fBlwres_context_sendrecv()\fR +completes successfully. +\fBLWRES_R_IOERROR\fR +is returned if an I/O error occurs and +\fBLWRES_R_TIMEOUT\fR +is returned if +\fBlwres_context_sendrecv()\fR +times out waiting for a response. .SH "SEE ALSO" .PP - \fBlwres_conf_init\fR(3), \fBmalloc\fR(3), \fBfree\fR(3 )\&. +\fBlwres_conf_init\fR(3), +\fBmalloc\fR(3), +\fBfree\fR(3 ). diff --git a/lib/lwres/man/lwres_context.html b/lib/lwres/man/lwres_context.html index 7ef6a708..8988c5dc 100644 --- a/lib/lwres/man/lwres_context.html +++ b/lib/lwres/man/lwres_context.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_context.html,v 1.5.2.2.2.8 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_context.html,v 1.5.2.2.2.10 2005/10/13 02:33:55 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_context</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_context_create, lwres_context_destroy, lwres_context_nextserial, lwres_context_initserial, lwres_context_freemem, lwres_context_allocmem, lwres_context_sendrecv — lightweight resolver context management</p> @@ -160,7 +160,7 @@ void * </div> </div> <div class="refsect1" lang="en"> -<a name="id2514658"></a><h2>DESCRIPTION</h2> +<a name="id2525975"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_context_create()</code> creates a @@ -290,7 +290,7 @@ returned in </p> </div> <div class="refsect1" lang="en"> -<a name="id2514976"></a><h2>RETURN VALUES</h2> +<a name="id2526156"></a><h2>RETURN VALUES</h2> <p> <code class="function">lwres_context_create()</code> returns @@ -321,7 +321,7 @@ times out waiting for a response. </p> </div> <div class="refsect1" lang="en"> -<a name="id2515027"></a><h2>SEE ALSO</h2> +<a name="id2526208"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres_conf_init</span>(3)</span>, diff --git a/lib/lwres/man/lwres_gabn.3 b/lib/lwres/man/lwres_gabn.3 index 07bd783b..60a56fe4 100644 --- a/lib/lwres/man/lwres_gabn.3 +++ b/lib/lwres/man/lwres_gabn.3 @@ -13,55 +13,50 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_gabn.3,v 1.13.2.1.8.4 2005/09/12 00:47:26 marka Exp $ +.\" $Id: lwres_gabn.3,v 1.13.2.1.8.5 2005/10/13 02:33:52 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GABN" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GABN" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_gabnrequest_render, lwres_gabnresponse_render, lwres_gabnrequest_parse, lwres_gabnresponse_parse, lwres_gabnresponse_free, lwres_gabnrequest_free \- lightweight resolver getaddrbyname message handling .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi -.HP 41 -lwres_result_t\ \fBlwres_gabnrequest_render\fR\ (lwres_context_t\ *ctx, lwres_gabnrequest_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b); -.HP 42 -lwres_result_t\ \fBlwres_gabnresponse_render\fR\ (lwres_context_t\ *ctx, lwres_gabnresponse_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b); .HP 40 -lwres_result_t\ \fBlwres_gabnrequest_parse\fR\ (lwres_context_t\ *ctx, lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt, lwres_gabnrequest_t\ **structp); +\fBlwres_result_t\ \fBlwres_gabnrequest_render\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gabnrequest_t\ *req\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB);\fR .HP 41 -lwres_result_t\ \fBlwres_gabnresponse_parse\fR\ (lwres_context_t\ *ctx, lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt, lwres_gabnresponse_t\ **structp); -.HP 30 -void\ \fBlwres_gabnresponse_free\fR\ (lwres_context_t\ *ctx, lwres_gabnresponse_t\ **structp); +\fBlwres_result_t\ \fBlwres_gabnresponse_render\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gabnresponse_t\ *req\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 39 +\fBlwres_result_t\ \fBlwres_gabnrequest_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_gabnrequest_t\ **structp\fR\fB);\fR +.HP 40 +\fBlwres_result_t\ \fBlwres_gabnresponse_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_gabnresponse_t\ **structp\fR\fB);\fR .HP 29 -void\ \fBlwres_gabnrequest_free\fR\ (lwres_context_t\ *ctx, lwres_gabnrequest_t\ **structp); +\fBvoid\ \fBlwres_gabnresponse_free\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gabnresponse_t\ **structp\fR\fB);\fR +.HP 28 +\fBvoid\ \fBlwres_gabnrequest_free\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gabnrequest_t\ **structp\fR\fB);\fR .SH "DESCRIPTION" .PP -These are low\-level routines for creating and parsing lightweight resolver name\-to\-address lookup request and response messages\&. +These are low\-level routines for creating and parsing lightweight resolver name\-to\-address lookup request and response messages. .PP -There are four main functions for the getaddrbyname opcode\&. One render function converts a getaddrbyname request structure -- \fBlwres_gabnrequest_t\fR -- to the lighweight resolver's canonical format\&. It is complemented by a parse function that converts a packet in this canonical format to a getaddrbyname request structure\&. Another render function converts the getaddrbyname response structure -- \fBlwres_gabnresponse_t\fR -- to the canonical format\&. This is complemented by a parse function which converts a packet in canonical format to a getaddrbyname response structure\&. +There are four main functions for the getaddrbyname opcode. One render function converts a getaddrbyname request structure \(em +\fBlwres_gabnrequest_t\fR +\(em to the lighweight resolver's canonical format. It is complemented by a parse function that converts a packet in this canonical format to a getaddrbyname request structure. Another render function converts the getaddrbyname response structure \(em +\fBlwres_gabnresponse_t\fR +\(em to the canonical format. This is complemented by a parse function which converts a packet in canonical format to a getaddrbyname response structure. .PP -These structures are defined in \fI<lwres/lwres\&.h>\fR\&. They are shown below\&. +These structures are defined in +\fI<lwres/lwres.h>\fR. They are shown below. +.sp .nf #define LWRES_OPCODE_GETADDRSBYNAME 0x00010001U typedef struct lwres_addr lwres_addr_t; @@ -85,15 +80,87 @@ typedef struct { size_t baselen; } lwres_gabnresponse_t; .fi +.sp .PP - \fBlwres_gabnrequest_render()\fR uses resolver context \fIctx\fR to convert getaddrbyname request structure \fIreq\fR to canonical format\&. The packet header structure \fIpkt\fR is initialised and transferred to buffer \fIb\fR\&. The contents of \fI*req\fR are then appended to the buffer in canonical format\&. \fBlwres_gabnresponse_render()\fR performs the same task, except it converts a getaddrbyname response structure \fBlwres_gabnresponse_t\fR to the lightweight resolver's canonical format\&. +\fBlwres_gabnrequest_render()\fR +uses resolver context +\fIctx\fR +to convert getaddrbyname request structure +\fIreq\fR +to canonical format. The packet header structure +\fIpkt\fR +is initialised and transferred to buffer +\fIb\fR. The contents of +\fI*req\fR +are then appended to the buffer in canonical format. +\fBlwres_gabnresponse_render()\fR +performs the same task, except it converts a getaddrbyname response structure +\fBlwres_gabnresponse_t\fR +to the lightweight resolver's canonical format. .PP - \fBlwres_gabnrequest_parse()\fR uses context \fIctx\fR to convert the contents of packet \fIpkt\fR to a \fBlwres_gabnrequest_t\fR structure\&. Buffer \fIb\fR provides space to be used for storing this structure\&. When the function succeeds, the resulting \fBlwres_gabnrequest_t\fR is made available through \fI*structp\fR\&. \fBlwres_gabnresponse_parse()\fR offers the same semantics as \fBlwres_gabnrequest_parse()\fR except it yields a \fBlwres_gabnresponse_t\fR structure\&. +\fBlwres_gabnrequest_parse()\fR +uses context +\fIctx\fR +to convert the contents of packet +\fIpkt\fR +to a +\fBlwres_gabnrequest_t\fR +structure. Buffer +\fIb\fR +provides space to be used for storing this structure. When the function succeeds, the resulting +\fBlwres_gabnrequest_t\fR +is made available through +\fI*structp\fR. +\fBlwres_gabnresponse_parse()\fR +offers the same semantics as +\fBlwres_gabnrequest_parse()\fR +except it yields a +\fBlwres_gabnresponse_t\fR +structure. .PP - \fBlwres_gabnresponse_free()\fR and \fBlwres_gabnrequest_free()\fR release the memory in resolver context \fIctx\fR that was allocated to the \fBlwres_gabnresponse_t\fR or \fBlwres_gabnrequest_t\fR structures referenced via \fIstructp\fR\&. Any memory associated with ancillary buffers and strings for those structures is also discarded\&. +\fBlwres_gabnresponse_free()\fR +and +\fBlwres_gabnrequest_free()\fR +release the memory in resolver context +\fIctx\fR +that was allocated to the +\fBlwres_gabnresponse_t\fR +or +\fBlwres_gabnrequest_t\fR +structures referenced via +\fIstructp\fR. Any memory associated with ancillary buffers and strings for those structures is also discarded. .SH "RETURN VALUES" .PP -The getaddrbyname opcode functions \fBlwres_gabnrequest_render()\fR, \fBlwres_gabnresponse_render()\fR \fBlwres_gabnrequest_parse()\fR and \fBlwres_gabnresponse_parse()\fR all return \fBLWRES_R_SUCCESS\fR on success\&. They return \fBLWRES_R_NOMEMORY\fR if memory allocation fails\&. \fBLWRES_R_UNEXPECTEDEND\fR is returned if the available space in the buffer \fIb\fR is too small to accommodate the packet header or the \fBlwres_gabnrequest_t\fR and \fBlwres_gabnresponse_t\fR structures\&. \fBlwres_gabnrequest_parse()\fR and \fBlwres_gabnresponse_parse()\fR will return \fBLWRES_R_UNEXPECTEDEND\fR if the buffer is not empty after decoding the received packet\&. These functions will return \fBLWRES_R_FAILURE\fR if pktflags in the packet header structure \fBlwres_lwpacket_t\fR indicate that the packet is not a response to an earlier query\&. +The getaddrbyname opcode functions +\fBlwres_gabnrequest_render()\fR, +\fBlwres_gabnresponse_render()\fR\fBlwres_gabnrequest_parse()\fR +and +\fBlwres_gabnresponse_parse()\fR +all return +\fBLWRES_R_SUCCESS\fR +on success. They return +\fBLWRES_R_NOMEMORY\fR +if memory allocation fails. +\fBLWRES_R_UNEXPECTEDEND\fR +is returned if the available space in the buffer +\fIb\fR +is too small to accommodate the packet header or the +\fBlwres_gabnrequest_t\fR +and +\fBlwres_gabnresponse_t\fR +structures. +\fBlwres_gabnrequest_parse()\fR +and +\fBlwres_gabnresponse_parse()\fR +will return +\fBLWRES_R_UNEXPECTEDEND\fR +if the buffer is not empty after decoding the received packet. These functions will return +\fBLWRES_R_FAILURE\fR +if +pktflags +in the packet header structure +\fBlwres_lwpacket_t\fR +indicate that the packet is not a response to an earlier query. .SH "SEE ALSO" .PP - \fBlwres_packet\fR(3 ) +\fBlwres_packet\fR(3 ) diff --git a/lib/lwres/man/lwres_gabn.html b/lib/lwres/man/lwres_gabn.html index a1cf0728..77139450 100644 --- a/lib/lwres/man/lwres_gabn.html +++ b/lib/lwres/man/lwres_gabn.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_gabn.html,v 1.6.2.1.4.7 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_gabn.html,v 1.6.2.1.4.9 2005/10/13 02:33:55 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_gabn</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_gabnrequest_render, lwres_gabnresponse_render, lwres_gabnrequest_parse, lwres_gabnresponse_parse, lwres_gabnresponse_free, lwres_gabnrequest_free — lightweight resolver getaddrbyname message handling</p> @@ -164,7 +164,7 @@ void </div> </div> <div class="refsect1" lang="en"> -<a name="id2514646"></a><h2>DESCRIPTION</h2> +<a name="id2525963"></a><h2>DESCRIPTION</h2> <p> These are low-level routines for creating and parsing lightweight resolver name-to-address lookup request and @@ -279,7 +279,7 @@ structures is also discarded. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514906"></a><h2>RETURN VALUES</h2> +<a name="id2526155"></a><h2>RETURN VALUES</h2> <p> The getaddrbyname opcode functions <code class="function">lwres_gabnrequest_render()</code>, @@ -317,7 +317,7 @@ indicate that the packet is not a response to an earlier query. </p> </div> <div class="refsect1" lang="en"> -<a name="id2515040"></a><h2>SEE ALSO</h2> +<a name="id2526220"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres_packet</span>(3 )</span> diff --git a/lib/lwres/man/lwres_gai_strerror.3 b/lib/lwres/man/lwres_gai_strerror.3 index 90086bbe..388c59e0 100644 --- a/lib/lwres/man/lwres_gai_strerror.3 +++ b/lib/lwres/man/lwres_gai_strerror.3 @@ -13,41 +13,33 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_gai_strerror.3,v 1.13.2.1.8.4 2005/09/12 00:47:26 marka Exp $ +.\" $Id: lwres_gai_strerror.3,v 1.13.2.1.8.5 2005/10/13 02:33:52 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GAI_STRERROR" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GAI_STRERROR" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" gai_strerror \- print suitable error string .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 22 -char\ *\ \fBgai_strerror\fR\ (int\ ecode); +.HP 20 +\fBchar\ *\ \fBgai_strerror\fR\fR\fB(\fR\fBint\ ecode\fR\fB);\fR .SH "DESCRIPTION" .PP - \fBlwres_gai_strerror()\fR returns an error message corresponding to an error code returned by \fBgetaddrinfo()\fR\&. The following error codes and their meaning are defined in \fIinclude/lwres/netdb\&.h\fR\&. +\fBlwres_gai_strerror()\fR +returns an error message corresponding to an error code returned by +\fBgetaddrinfo()\fR. The following error codes and their meaning are defined in +\fIinclude/lwres/netdb.h\fR. .TP \fBEAI_ADDRFAMILY\fR address family for hostname not supported @@ -56,13 +48,15 @@ address family for hostname not supported temporary failure in name resolution .TP \fBEAI_BADFLAGS\fR -invalid value for \fBai_flags\fR +invalid value for +\fBai_flags\fR .TP \fBEAI_FAIL\fR non\-recoverable failure in name resolution .TP \fBEAI_FAMILY\fR - \fBai_family\fR not supported +\fBai_family\fR +not supported .TP \fBEAI_MEMORY\fR memory allocation failure @@ -74,16 +68,32 @@ no address associated with hostname hostname or servname not provided, or not known .TP \fBEAI_SERVICE\fR -servname not supported for \fBai_socktype\fR +servname not supported for +\fBai_socktype\fR .TP \fBEAI_SOCKTYPE\fR - \fBai_socktype\fR not supported +\fBai_socktype\fR +not supported .TP \fBEAI_SYSTEM\fR system error returned in errno - The message invalid error code is returned if \fIecode\fR is out of range\&. +The message +invalid error code +is returned if +\fIecode\fR +is out of range. .PP - \fBai_flags\fR, \fBai_family\fR and \fBai_socktype\fR are elements of the \fBstruct addrinfo\fR used by \fBlwres_getaddrinfo()\fR\&. +\fBai_flags\fR, +\fBai_family\fR +and +\fBai_socktype\fR +are elements of the +\fBstruct addrinfo\fR +used by +\fBlwres_getaddrinfo()\fR. .SH "SEE ALSO" .PP - \fBstrerror\fR(3), \fBlwres_getaddrinfo\fR(3), \fBgetaddrinfo\fR(3), \fBRFC2133\fR()\&. +\fBstrerror\fR(3), +\fBlwres_getaddrinfo\fR(3), +\fBgetaddrinfo\fR(3), +\fBRFC2133\fR(). diff --git a/lib/lwres/man/lwres_gai_strerror.html b/lib/lwres/man/lwres_gai_strerror.html index f54fa509..55065641 100644 --- a/lib/lwres/man/lwres_gai_strerror.html +++ b/lib/lwres/man/lwres_gai_strerror.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_gai_strerror.html,v 1.5.2.1.4.7 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_gai_strerror.html,v 1.5.2.1.4.9 2005/10/13 02:33:55 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_gai_strerror</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>gai_strerror — print suitable error string</p> @@ -37,7 +37,7 @@ char * </div> </div> <div class="refsect1" lang="en"> -<a name="id2514525"></a><h2>DESCRIPTION</h2> +<a name="id2525843"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_gai_strerror()</code> returns an error message corresponding to an error code returned by @@ -109,7 +109,7 @@ used by </p> </div> <div class="refsect1" lang="en"> -<a name="id2514791"></a><h2>SEE ALSO</h2> +<a name="id2526040"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">strerror</span>(3)</span>, diff --git a/lib/lwres/man/lwres_getaddrinfo.3 b/lib/lwres/man/lwres_getaddrinfo.3 index 3b9ea6c6..df1390a9 100644 --- a/lib/lwres/man/lwres_getaddrinfo.3 +++ b/lib/lwres/man/lwres_getaddrinfo.3 @@ -13,42 +13,33 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_getaddrinfo.3,v 1.16.2.1.8.5 2005/09/12 00:47:26 marka Exp $ +.\" $Id: lwres_getaddrinfo.3,v 1.16.2.1.8.6 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GETADDRINFO" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GETADDRINFO" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_getaddrinfo, lwres_freeaddrinfo \- socket address structure to host and service name .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 23 -int\ \fBlwres_getaddrinfo\fR\ (const\ char\ *hostname, const\ char\ *servname, const\ struct\ addrinfo\ *hints, struct\ addrinfo\ **res); -.HP 25 -void\ \fBlwres_freeaddrinfo\fR\ (struct\ addrinfo\ *ai); +.HP 22 +\fBint\ \fBlwres_getaddrinfo\fR\fR\fB(\fR\fBconst\ char\ *hostname\fR\fB, \fR\fBconst\ char\ *servname\fR\fB, \fR\fBconst\ struct\ addrinfo\ *hints\fR\fB, \fR\fBstruct\ addrinfo\ **res\fR\fB);\fR +.HP 24 +\fBvoid\ \fBlwres_freeaddrinfo\fR\fR\fB(\fR\fBstruct\ addrinfo\ *ai\fR\fB);\fR .PP -If the operating system does not provide a \fBstruct addrinfo\fR, the following structure is used: +If the operating system does not provide a +\fBstruct addrinfo\fR, the following structure is used: +.sp .nf struct addrinfo { int ai_flags; /* AI_PASSIVE, AI_CANONNAME */ @@ -61,36 +52,176 @@ struct addrinfo { struct addrinfo *ai_next; /* next structure in linked list */ }; .fi +.sp .SH "DESCRIPTION" .PP - \fBlwres_getaddrinfo()\fR is used to get a list of IP addresses and port numbers for host \fIhostname\fR and service \fIservname\fR\&. The function is the lightweight resolver's implementation of \fBgetaddrinfo()\fR as defined in RFC2133\&. \fIhostname\fR and \fIservname\fR are pointers to null\-terminated strings or \fBNULL\fR\&. \fIhostname\fR is either a host name or a numeric host address string: a dotted decimal IPv4 address or an IPv6 address\&. \fIservname\fR is either a decimal port number or a service name as listed in \fI/etc/services\fR\&. +\fBlwres_getaddrinfo()\fR +is used to get a list of IP addresses and port numbers for host +\fIhostname\fR +and service +\fIservname\fR. The function is the lightweight resolver's implementation of +\fBgetaddrinfo()\fR +as defined in RFC2133. +\fIhostname\fR +and +\fIservname\fR +are pointers to null\-terminated strings or +\fBNULL\fR. +\fIhostname\fR +is either a host name or a numeric host address string: a dotted decimal IPv4 address or an IPv6 address. +\fIservname\fR +is either a decimal port number or a service name as listed in +\fI/etc/services\fR. .PP - \fIhints\fR is an optional pointer to a \fBstruct addrinfo\fR\&. 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 \fI*hints\fR: +\fIhints\fR +is an optional pointer to a +\fBstruct addrinfo\fR. 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 +\fI*hints\fR: .TP \fBai_family\fR -The protocol family that should be used\&. When \fBai_family\fR is set to \fBPF_UNSPEC\fR, it means the caller will accept any protocol family supported by the operating system\&. +The protocol family that should be used. When +\fBai_family\fR +is set to +\fBPF_UNSPEC\fR, it means the caller will accept any protocol family supported by the operating system. .TP \fBai_socktype\fR -denotes the type of socket -- \fBSOCK_STREAM\fR, \fBSOCK_DGRAM\fR or \fBSOCK_RAW\fR -- that is wanted\&. When \fBai_socktype\fR is zero the caller will accept any socket type\&. +denotes the type of socket \(em +\fBSOCK_STREAM\fR, +\fBSOCK_DGRAM\fR +or +\fBSOCK_RAW\fR +\(em that is wanted. When +\fBai_socktype\fR +is zero the caller will accept any socket type. .TP \fBai_protocol\fR -indicates which transport protocol is wanted: IPPROTO_UDP or IPPROTO_TCP\&. If \fBai_protocol\fR is zero the caller will accept any protocol\&. +indicates which transport protocol is wanted: IPPROTO_UDP or IPPROTO_TCP. If +\fBai_protocol\fR +is zero the caller will accept any protocol. .TP \fBai_flags\fR -Flag bits\&. If the \fBAI_CANONNAME\fR bit is set, a successful call to \fBlwres_getaddrinfo()\fR will return a null\-terminated string containing the canonical name of the specified hostname in \fBai_canonname\fR of the first \fBaddrinfo\fR structure returned\&. Setting the \fBAI_PASSIVE\fR bit indicates that the returned socket address structure is intended for used in a call to \fBbind\fR(2)\&. In this case, if the hostname argument is a \fBNULL\fR pointer, then the IP address portion of the socket address structure will be set to \fBINADDR_ANY\fR for an IPv4 address or \fBIN6ADDR_ANY_INIT\fR for an IPv6 address\&. -When \fBai_flags\fR does not set the \fBAI_PASSIVE\fR bit, the returned socket address structure will be ready for use in a call to \fBconnect\fR(2 ) for a connection\-oriented protocol or \fBconnect\fR(2), \fBsendto\fR(2), or \fBsendmsg\fR(2 ) if a connectionless protocol was chosen\&. The IP address portion of the socket address structure will be set to the loopback address if \fIhostname\fR is a \fBNULL\fR pointer and \fBAI_PASSIVE\fR is not set in \fBai_flags\fR\&. -If \fBai_flags\fR is set to \fBAI_NUMERICHOST\fR it indicates that \fIhostname\fR should be treated as a numeric string defining an IPv4 or IPv6 address and no name resolution should be attempted\&. +Flag bits. If the +\fBAI_CANONNAME\fR +bit is set, a successful call to +\fBlwres_getaddrinfo()\fR +will return a null\-terminated string containing the canonical name of the specified hostname in +\fBai_canonname\fR +of the first +\fBaddrinfo\fR +structure returned. Setting the +\fBAI_PASSIVE\fR +bit indicates that the returned socket address structure is intended for used in a call to +\fBbind\fR(2). In this case, if the hostname argument is a +\fBNULL\fR +pointer, then the IP address portion of the socket address structure will be set to +\fBINADDR_ANY\fR +for an IPv4 address or +\fBIN6ADDR_ANY_INIT\fR +for an IPv6 address. +.sp +When +\fBai_flags\fR +does not set the +\fBAI_PASSIVE\fR +bit, the returned socket address structure will be ready for use in a call to +\fBconnect\fR(2 ) +for a connection\-oriented protocol or +\fBconnect\fR(2), +\fBsendto\fR(2), or +\fBsendmsg\fR(2 ) +if a connectionless protocol was chosen. The IP address portion of the socket address structure will be set to the loopback address if +\fIhostname\fR +is a +\fBNULL\fR +pointer and +\fBAI_PASSIVE\fR +is not set in +\fBai_flags\fR. +.sp +If +\fBai_flags\fR +is set to +\fBAI_NUMERICHOST\fR +it indicates that +\fIhostname\fR +should be treated as a numeric string defining an IPv4 or IPv6 address and no name resolution should be attempted. .PP -All other elements of the \fBstruct addrinfo\fR passed via \fIhints\fR must be zero\&. +All other elements of the +\fBstruct addrinfo\fR +passed via +\fIhints\fR +must be zero. .PP -A \fIhints\fR of \fBNULL\fR is treated as if the caller provided a \fBstruct addrinfo\fR initialized to zero with \fBai_family\fRset to \fBPF_UNSPEC\fR\&. +A +\fIhints\fR +of +\fBNULL\fR +is treated as if the caller provided a +\fBstruct addrinfo\fR +initialized to zero with +\fBai_family\fRset to +\fBPF_UNSPEC\fR. .PP -After a successful call to \fBlwres_getaddrinfo()\fR, \fI*res\fR is a pointer to a linked list of one or more \fBaddrinfo\fR structures\&. Each \fBstruct addrinfo\fR in this list cn be processed by following the \fBai_next\fR pointer, until a \fBNULL\fR pointer is encountered\&. The three members \fBai_family\fR, \fBai_socktype\fR, and \fBai_protocol\fR in each returned \fBaddrinfo\fR structure contain the corresponding arguments for a call to \fBsocket\fR(2)\&. For each \fBaddrinfo\fR structure in the list, the \fBai_addr\fR member points to a filled\-in socket address structure of length \fBai_addrlen\fR\&. +After a successful call to +\fBlwres_getaddrinfo()\fR, +\fI*res\fR +is a pointer to a linked list of one or more +\fBaddrinfo\fR +structures. Each +\fBstruct addrinfo\fR +in this list cn be processed by following the +\fBai_next\fR +pointer, until a +\fBNULL\fR +pointer is encountered. The three members +\fBai_family\fR, +\fBai_socktype\fR, and +\fBai_protocol\fR +in each returned +\fBaddrinfo\fR +structure contain the corresponding arguments for a call to +\fBsocket\fR(2). For each +\fBaddrinfo\fR +structure in the list, the +\fBai_addr\fR +member points to a filled\-in socket address structure of length +\fBai_addrlen\fR. .PP -All of the information returned by \fBlwres_getaddrinfo()\fR is dynamically allocated: the addrinfo structures, and the socket address structures and canonical host name strings pointed to by the \fBaddrinfo\fRstructures\&. Memory allocated for the dynamically allocated structures created by a successful call to \fBlwres_getaddrinfo()\fR is released by \fBlwres_freeaddrinfo()\fR\&. \fIai\fR is a pointer to a \fBstruct addrinfo\fR created by a call to \fBlwres_getaddrinfo()\fR\&. +All of the information returned by +\fBlwres_getaddrinfo()\fR +is dynamically allocated: the addrinfo structures, and the socket address structures and canonical host name strings pointed to by the +\fBaddrinfo\fRstructures. Memory allocated for the dynamically allocated structures created by a successful call to +\fBlwres_getaddrinfo()\fR +is released by +\fBlwres_freeaddrinfo()\fR. +\fIai\fR +is a pointer to a +\fBstruct addrinfo\fR +created by a call to +\fBlwres_getaddrinfo()\fR. .SH "RETURN VALUES" .PP - \fBlwres_getaddrinfo()\fR returns zero on success or one of the error codes listed in \fBgai_strerror\fR(3 ) if an error occurs\&. If both \fIhostname\fR and \fIservname\fR are \fBNULL\fR \fBlwres_getaddrinfo()\fR returns \fBEAI_NONAME\fR\&. +\fBlwres_getaddrinfo()\fR +returns zero on success or one of the error codes listed in +\fBgai_strerror\fR(3 ) +if an error occurs. If both +\fIhostname\fR +and +\fIservname\fR +are +\fBNULL\fR\fBlwres_getaddrinfo()\fR +returns +\fBEAI_NONAME\fR. .SH "SEE ALSO" .PP - \fBlwres\fR(3), \fBlwres_getaddrinfo\fR(3), \fBlwres_freeaddrinfo\fR(3), \fBlwres_gai_strerror\fR(3), \fBRFC2133\fR(), \fBgetservbyname\fR(3), \fBbind\fR(2), \fBconnect\fR(2), \fBsendto\fR(2), \fBsendmsg\fR(2), \fBsocket\fR(2)\&. +\fBlwres\fR(3), +\fBlwres_getaddrinfo\fR(3), +\fBlwres_freeaddrinfo\fR(3), +\fBlwres_gai_strerror\fR(3), +\fBRFC2133\fR(), +\fBgetservbyname\fR(3), +\fBbind\fR(2), +\fBconnect\fR(2), +\fBsendto\fR(2), +\fBsendmsg\fR(2), +\fBsocket\fR(2). diff --git a/lib/lwres/man/lwres_getaddrinfo.html b/lib/lwres/man/lwres_getaddrinfo.html index 41475a69..bc84e74f 100644 --- a/lib/lwres/man/lwres_getaddrinfo.html +++ b/lib/lwres/man/lwres_getaddrinfo.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_getaddrinfo.html,v 1.8.2.1.4.8 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_getaddrinfo.html,v 1.8.2.1.4.10 2005/10/13 02:33:56 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_getaddrinfo</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_getaddrinfo, lwres_freeaddrinfo — socket address structure to host and service name</p> @@ -87,7 +87,7 @@ struct addrinfo { </p> </div> <div class="refsect1" lang="en"> -<a name="id2514566"></a><h2>DESCRIPTION</h2> +<a name="id2525883"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_getaddrinfo()</code> is used to get a list of IP addresses and port numbers for host @@ -284,7 +284,7 @@ created by a call to </p> </div> <div class="refsect1" lang="en"> -<a name="id2515128"></a><h2>RETURN VALUES</h2> +<a name="id2526309"></a><h2>RETURN VALUES</h2> <p> <code class="function">lwres_getaddrinfo()</code> returns zero on success or one of the error codes listed in @@ -304,7 +304,7 @@ returns </p> </div> <div class="refsect1" lang="en"> -<a name="id2515166"></a><h2>SEE ALSO</h2> +<a name="id2526347"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres</span>(3)</span>, diff --git a/lib/lwres/man/lwres_gethostent.3 b/lib/lwres/man/lwres_gethostent.3 index 3dcc2b71..99dc5338 100644 --- a/lib/lwres/man/lwres_gethostent.3 +++ b/lib/lwres/man/lwres_gethostent.3 @@ -13,61 +13,56 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_gethostent.3,v 1.16.2.1.8.4 2005/09/12 00:47:27 marka Exp $ +.\" $Id: lwres_gethostent.3,v 1.16.2.1.8.5 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GETHOSTENT" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GETHOSTENT" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_gethostbyname, lwres_gethostbyname2, lwres_gethostbyaddr, lwres_gethostent, lwres_sethostent, lwres_endhostent, lwres_gethostbyname_r, lwres_gethostbyaddr_r, lwres_gethostent_r, lwres_sethostent_r, lwres_endhostent_r \- lightweight resolver get network host entry .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 40 -struct\ hostent\ *\ \fBlwres_gethostbyname\fR\ (const\ char\ *name); -.HP 41 -struct\ hostent\ *\ \fBlwres_gethostbyname2\fR\ (const\ char\ *name, int\ af); -.HP 40 -struct\ hostent\ *\ \fBlwres_gethostbyaddr\fR\ (const\ char\ *addr, int\ len, int\ type); .HP 37 -struct\ hostent\ *\ \fBlwres_gethostent\fR\ (void); -.HP 23 -void\ \fBlwres_sethostent\fR\ (int\ stayopen); -.HP 23 -void\ \fBlwres_endhostent\fR\ (void); -.HP 42 -struct\ hostent\ *\ \fBlwres_gethostbyname_r\fR\ (const\ char\ *name, struct\ hostent\ *resbuf, char\ *buf, int\ buflen, int\ *error); -.HP 42 -struct\ hostent\ *\ \fBlwres_gethostbyaddr_r\fR\ (const\ char\ *addr, int\ len, int\ type, struct\ hostent\ *resbuf, char\ *buf, int\ buflen, int\ *error); +\fBstruct\ hostent\ *\ \fBlwres_gethostbyname\fR\fR\fB(\fR\fBconst\ char\ *name\fR\fB);\fR +.HP 38 +\fBstruct\ hostent\ *\ \fBlwres_gethostbyname2\fR\fR\fB(\fR\fBconst\ char\ *name\fR\fB, \fR\fBint\ af\fR\fB);\fR +.HP 37 +\fBstruct\ hostent\ *\ \fBlwres_gethostbyaddr\fR\fR\fB(\fR\fBconst\ char\ *addr\fR\fB, \fR\fBint\ len\fR\fB, \fR\fBint\ type\fR\fB);\fR +.HP 34 +\fBstruct\ hostent\ *\ \fBlwres_gethostent\fR\fR\fB(\fR\fBvoid\fR\fB);\fR +.HP 22 +\fBvoid\ \fBlwres_sethostent\fR\fR\fB(\fR\fBint\ stayopen\fR\fB);\fR +.HP 22 +\fBvoid\ \fBlwres_endhostent\fR\fR\fB(\fR\fBvoid\fR\fB);\fR .HP 39 -struct\ hostent\ *\ \fBlwres_gethostent_r\fR\ (struct\ hostent\ *resbuf, char\ *buf, int\ buflen, int\ *error); -.HP 25 -void\ \fBlwres_sethostent_r\fR\ (int\ stayopen); -.HP 25 -void\ \fBlwres_endhostent_r\fR\ (void); +\fBstruct\ hostent\ *\ \fBlwres_gethostbyname_r\fR\fR\fB(\fR\fBconst\ char\ *name\fR\fB, \fR\fBstruct\ hostent\ *resbuf\fR\fB, \fR\fBchar\ *buf\fR\fB, \fR\fBint\ buflen\fR\fB, \fR\fBint\ *error\fR\fB);\fR +.HP 39 +\fBstruct\ hostent\ *\ \fBlwres_gethostbyaddr_r\fR\fR\fB(\fR\fBconst\ char\ *addr\fR\fB, \fR\fBint\ len\fR\fB, \fR\fBint\ type\fR\fB, \fR\fBstruct\ hostent\ *resbuf\fR\fB, \fR\fBchar\ *buf\fR\fB, \fR\fBint\ buflen\fR\fB, \fR\fBint\ *error\fR\fB);\fR +.HP 36 +\fBstruct\ hostent\ *\ \fBlwres_gethostent_r\fR\fR\fB(\fR\fBstruct\ hostent\ *resbuf\fR\fB, \fR\fBchar\ *buf\fR\fB, \fR\fBint\ buflen\fR\fB, \fR\fBint\ *error\fR\fB);\fR +.HP 24 +\fBvoid\ \fBlwres_sethostent_r\fR\fR\fB(\fR\fBint\ stayopen\fR\fB);\fR +.HP 24 +\fBvoid\ \fBlwres_endhostent_r\fR\fR\fB(\fR\fBvoid\fR\fB);\fR .SH "DESCRIPTION" .PP -These functions provide hostname\-to\-address and address\-to\-hostname lookups by means of the lightweight resolver\&. They are similar to the standard \fBgethostent\fR(3 ) functions provided by most operating systems\&. They use a \fBstruct hostent\fR which is usually defined in \fI<namedb\&.h>\fR\&. +These functions provide hostname\-to\-address and address\-to\-hostname lookups by means of the lightweight resolver. They are similar to the standard +\fBgethostent\fR(3 ) +functions provided by most operating systems. They use a +\fBstruct hostent\fR +which is usually defined in +\fI<namedb.h>\fR. +.sp .nf struct hostent { char *h_name; /* official name of host */ @@ -78,59 +73,216 @@ struct hostent { }; #define h_addr h_addr_list[0] /* address, for backward compatibility */ .fi +.sp .PP -The members of this structure are: +The members of this structure are: .TP \fBh_name\fR -The official (canonical) name of the host\&. +The official (canonical) name of the host. .TP \fBh_aliases\fR -A NULL\-terminated array of alternate names (nicknames) for the host\&. +A NULL\-terminated array of alternate names (nicknames) for the host. .TP \fBh_addrtype\fR -The type of address being returned -- \fBPF_INET\fR or \fBPF_INET6\fR\&. +The type of address being returned \(em +\fBPF_INET\fR +or +\fBPF_INET6\fR. .TP \fBh_length\fR -The length of the address in bytes\&. +The length of the address in bytes. .TP \fBh_addr_list\fR -A \fBNULL\fR terminated array of network addresses for the host\&. Host addresses are returned in network byte order\&. +A +\fBNULL\fR +terminated array of network addresses for the host. Host addresses are returned in network byte order. .PP -For backward compatibility with very old software, \fBh_addr\fR is the first address in \fBh_addr_list\&.\fR +For backward compatibility with very old software, +\fBh_addr\fR +is the first address in +\fBh_addr_list.\fR .PP - \fBlwres_gethostent()\fR, \fBlwres_sethostent()\fR, \fBlwres_endhostent()\fR, \fBlwres_gethostent_r()\fR, \fBlwres_sethostent_r()\fR and \fBlwres_endhostent_r()\fR provide iteration over the known host entries on systems that provide such functionality through facilities like \fI/etc/hosts\fR or NIS\&. The lightweight resolver does not currently implement these functions; it only provides them as stub functions that always return failure\&. +\fBlwres_gethostent()\fR, +\fBlwres_sethostent()\fR, +\fBlwres_endhostent()\fR, +\fBlwres_gethostent_r()\fR, +\fBlwres_sethostent_r()\fR +and +\fBlwres_endhostent_r()\fR +provide iteration over the known host entries on systems that provide such functionality through facilities like +\fI/etc/hosts\fR +or NIS. The lightweight resolver does not currently implement these functions; it only provides them as stub functions that always return failure. .PP - \fBlwres_gethostbyname()\fR and \fBlwres_gethostbyname2()\fR look up the hostname \fIname\fR\&. \fBlwres_gethostbyname()\fR always looks for an IPv4 address while \fBlwres_gethostbyname2()\fR looks for an address of protocol family \fIaf\fR: either \fBPF_INET\fR or \fBPF_INET6\fR -- IPv4 or IPV6 addresses respectively\&. Successful calls of the functions return a \fBstruct hostent\fRfor the name that was looked up\&. \fBNULL\fR is returned if the lookups by \fBlwres_gethostbyname()\fR or \fBlwres_gethostbyname2()\fR fail\&. +\fBlwres_gethostbyname()\fR +and +\fBlwres_gethostbyname2()\fR +look up the hostname +\fIname\fR. +\fBlwres_gethostbyname()\fR +always looks for an IPv4 address while +\fBlwres_gethostbyname2()\fR +looks for an address of protocol family +\fIaf\fR: either +\fBPF_INET\fR +or +\fBPF_INET6\fR +\(em IPv4 or IPV6 addresses respectively. Successful calls of the functions return a +\fBstruct hostent\fRfor the name that was looked up. +\fBNULL\fR +is returned if the lookups by +\fBlwres_gethostbyname()\fR +or +\fBlwres_gethostbyname2()\fR +fail. .PP -Reverse lookups of addresses are performed by \fBlwres_gethostbyaddr()\fR\&. \fIaddr\fR is an address of length \fIlen\fR bytes and protocol family \fItype\fR -- \fBPF_INET\fR or \fBPF_INET6\fR\&. \fBlwres_gethostbyname_r()\fR is a thread\-safe function for forward lookups\&. If an error occurs, an error code is returned in \fI*error\fR\&. \fIresbuf\fR is a pointer to a \fBstruct hostent\fR which is initialised by a successful call to \fBlwres_gethostbyname_r()\fR \&. \fIbuf\fR is a buffer of length \fIlen\fR bytes which is used to store the \fBh_name\fR, \fBh_aliases\fR, and \fBh_addr_list\fR elements of the \fBstruct hostent\fR returned in \fIresbuf\fR\&. Successful calls to \fBlwres_gethostbyname_r()\fR return \fIresbuf\fR, which is a pointer to the \fBstruct hostent\fR it created\&. +Reverse lookups of addresses are performed by +\fBlwres_gethostbyaddr()\fR. +\fIaddr\fR +is an address of length +\fIlen\fR +bytes and protocol family +\fItype\fR +\(em +\fBPF_INET\fR +or +\fBPF_INET6\fR. +\fBlwres_gethostbyname_r()\fR +is a thread\-safe function for forward lookups. If an error occurs, an error code is returned in +\fI*error\fR. +\fIresbuf\fR +is a pointer to a +\fBstruct hostent\fR +which is initialised by a successful call to +\fBlwres_gethostbyname_r()\fR +. +\fIbuf\fR +is a buffer of length +\fIlen\fR +bytes which is used to store the +\fBh_name\fR, +\fBh_aliases\fR, and +\fBh_addr_list\fR +elements of the +\fBstruct hostent\fR +returned in +\fIresbuf\fR. Successful calls to +\fBlwres_gethostbyname_r()\fR +return +\fIresbuf\fR, which is a pointer to the +\fBstruct hostent\fR +it created. .PP - \fBlwres_gethostbyaddr_r()\fR is a thread\-safe function that performs a reverse lookup of address \fIaddr\fR which is \fIlen\fR bytes long and is of protocol family \fItype\fR -- \fBPF_INET\fR or \fBPF_INET6\fR\&. If an error occurs, the error code is returned in \fI*error\fR\&. The other function parameters are identical to those in \fBlwres_gethostbyname_r()\fR\&. \fIresbuf\fR is a pointer to a \fBstruct hostent\fR which is initialised by a successful call to \fBlwres_gethostbyaddr_r()\fR\&. \fIbuf\fR is a buffer of length \fIlen\fR bytes which is used to store the \fBh_name\fR, \fBh_aliases\fR, and \fBh_addr_list\fR elements of the \fBstruct hostent\fR returned in \fIresbuf\fR\&. Successful calls to \fBlwres_gethostbyaddr_r()\fR return \fIresbuf\fR, which is a pointer to the \fBstruct hostent()\fR it created\&. +\fBlwres_gethostbyaddr_r()\fR +is a thread\-safe function that performs a reverse lookup of address +\fIaddr\fR +which is +\fIlen\fR +bytes long and is of protocol family +\fItype\fR +\(em +\fBPF_INET\fR +or +\fBPF_INET6\fR. If an error occurs, the error code is returned in +\fI*error\fR. The other function parameters are identical to those in +\fBlwres_gethostbyname_r()\fR. +\fIresbuf\fR +is a pointer to a +\fBstruct hostent\fR +which is initialised by a successful call to +\fBlwres_gethostbyaddr_r()\fR. +\fIbuf\fR +is a buffer of length +\fIlen\fR +bytes which is used to store the +\fBh_name\fR, +\fBh_aliases\fR, and +\fBh_addr_list\fR +elements of the +\fBstruct hostent\fR +returned in +\fIresbuf\fR. Successful calls to +\fBlwres_gethostbyaddr_r()\fR +return +\fIresbuf\fR, which is a pointer to the +\fBstruct hostent()\fR +it created. .SH "RETURN VALUES" .PP -The functions \fBlwres_gethostbyname()\fR, \fBlwres_gethostbyname2()\fR, \fBlwres_gethostbyaddr()\fR, and \fBlwres_gethostent()\fR return NULL to indicate an error\&. In this case the global variable \fBlwres_h_errno\fR will contain one of the following error codes defined in \fI<lwres/netdb\&.h>\fR: +The functions +\fBlwres_gethostbyname()\fR, +\fBlwres_gethostbyname2()\fR, +\fBlwres_gethostbyaddr()\fR, and +\fBlwres_gethostent()\fR +return NULL to indicate an error. In this case the global variable +\fBlwres_h_errno\fR +will contain one of the following error codes defined in +\fI<lwres/netdb.h>\fR: .TP \fBHOST_NOT_FOUND\fR -The host or address was not found\&. +The host or address was not found. .TP \fBTRY_AGAIN\fR -A recoverable error occurred, e\&.g\&., a timeout\&. Retrying the lookup may succeed\&. +A recoverable error occurred, e.g., a timeout. Retrying the lookup may succeed. .TP \fBNO_RECOVERY\fR -A non\-recoverable error occurred\&. +A non\-recoverable error occurred. .TP \fBNO_DATA\fR -The name exists, but has no address information associated with it (or vice versa in the case of a reverse lookup)\&. The code NO_ADDRESS is accepted as a synonym for NO_DATA for backwards compatibility\&. +The name exists, but has no address information associated with it (or vice versa in the case of a reverse lookup). The code NO_ADDRESS is accepted as a synonym for NO_DATA for backwards compatibility. .PP - \fBlwres_hstrerror\fR(3 ) translates these error codes to suitable error messages\&. +\fBlwres_hstrerror\fR(3 ) +translates these error codes to suitable error messages. .PP - \fBlwres_gethostent()\fR and \fBlwres_gethostent_r()\fR always return \fBNULL\fR\&. +\fBlwres_gethostent()\fR +and +\fBlwres_gethostent_r()\fR +always return +\fBNULL\fR. .PP -Successful calls to \fBlwres_gethostbyname_r()\fR and \fBlwres_gethostbyaddr_r()\fR return \fIresbuf\fR, a pointer to the \fBstruct hostent\fR that was initialised by these functions\&. They return \fBNULL\fR if the lookups fail or if \fIbuf\fR was too small to hold the list of addresses and names referenced by the \fBh_name\fR, \fBh_aliases\fR, and \fBh_addr_list\fR elements of the \fBstruct hostent\fR\&. If \fIbuf\fR was too small, both \fBlwres_gethostbyname_r()\fR and \fBlwres_gethostbyaddr_r()\fR set the global variable \fBerrno\fR to \fBERANGE\fR\&. +Successful calls to +\fBlwres_gethostbyname_r()\fR +and +\fBlwres_gethostbyaddr_r()\fR +return +\fIresbuf\fR, a pointer to the +\fBstruct hostent\fR +that was initialised by these functions. They return +\fBNULL\fR +if the lookups fail or if +\fIbuf\fR +was too small to hold the list of addresses and names referenced by the +\fBh_name\fR, +\fBh_aliases\fR, and +\fBh_addr_list\fR +elements of the +\fBstruct hostent\fR. If +\fIbuf\fR +was too small, both +\fBlwres_gethostbyname_r()\fR +and +\fBlwres_gethostbyaddr_r()\fR +set the global variable +\fBerrno\fR +to +\fBERANGE\fR. .SH "SEE ALSO" .PP - \fBgethostent\fR(3), \fBlwres_getipnode\fR(3), \fBlwres_hstrerror\fR(3 ) +\fBgethostent\fR(3), +\fBlwres_getipnode\fR(3), +\fBlwres_hstrerror\fR(3 ) .SH "BUGS" .PP - \fBlwres_gethostbyname()\fR, \fBlwres_gethostbyname2()\fR, \fBlwres_gethostbyaddr()\fR and \fBlwres_endhostent()\fR are not thread safe; they return pointers to static data and provide error codes through a global variable\&. Thread\-safe versions for name and address lookup are provided by \fBlwres_gethostbyname_r()\fR, and \fBlwres_gethostbyaddr_r()\fR respectively\&. +\fBlwres_gethostbyname()\fR, +\fBlwres_gethostbyname2()\fR, +\fBlwres_gethostbyaddr()\fR +and +\fBlwres_endhostent()\fR +are not thread safe; they return pointers to static data and provide error codes through a global variable. Thread\-safe versions for name and address lookup are provided by +\fBlwres_gethostbyname_r()\fR, and +\fBlwres_gethostbyaddr_r()\fR +respectively. .PP -The resolver daemon does not currently support any non\-DNS name services such as \fI/etc/hosts\fR or \fBNIS\fR, consequently the above functions don't, either\&. +The resolver daemon does not currently support any non\-DNS name services such as +\fI/etc/hosts\fR +or +\fBNIS\fR, consequently the above functions don't, either. diff --git a/lib/lwres/man/lwres_gethostent.html b/lib/lwres/man/lwres_gethostent.html index 8e6d708b..263f9932 100644 --- a/lib/lwres/man/lwres_gethostent.html +++ b/lib/lwres/man/lwres_gethostent.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_gethostent.html,v 1.8.2.1.4.6 2005/07/18 02:36:52 marka Exp $ --> +<!-- $Id: lwres_gethostent.html,v 1.8.2.1.4.8 2005/10/13 02:33:56 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_gethostent</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_gethostbyname, lwres_gethostbyname2, lwres_gethostbyaddr, lwres_gethostent, lwres_sethostent, lwres_endhostent, lwres_gethostbyname_r, lwres_gethostbyaddr_r, lwres_gethostent_r, lwres_sethostent_r, lwres_endhostent_r — lightweight resolver get network host entry</p> @@ -187,7 +187,7 @@ void </div> </div> <div class="refsect1" lang="en"> -<a name="id2514724"></a><h2>DESCRIPTION</h2> +<a name="id2526041"></a><h2>DESCRIPTION</h2> <p> These functions provide hostname-to-address and address-to-hostname lookups by means of the lightweight resolver. @@ -324,7 +324,7 @@ calls to <code class="function">lwres_gethostbyaddr_r()</code> return </p> </div> <div class="refsect1" lang="en"> -<a name="id2515200"></a><h2>RETURN VALUES</h2> +<a name="id2526380"></a><h2>RETURN VALUES</h2> <p> The functions <code class="function">lwres_gethostbyname()</code>, @@ -391,7 +391,7 @@ hostent</span>. If <em class="parameter"><code>buf</code></em> was too small, b </p> </div> <div class="refsect1" lang="en"> -<a name="id2515360"></a><h2>SEE ALSO</h2> +<a name="id2526540"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">gethostent</span>(3)</span>, @@ -402,7 +402,7 @@ hostent</span>. If <em class="parameter"><code>buf</code></em> was too small, b </p> </div> <div class="refsect1" lang="en"> -<a name="id2515395"></a><h2>BUGS</h2> +<a name="id2526644"></a><h2>BUGS</h2> <p> <code class="function">lwres_gethostbyname()</code>, <code class="function">lwres_gethostbyname2()</code>, diff --git a/lib/lwres/man/lwres_getipnode.3 b/lib/lwres/man/lwres_getipnode.3 index 1f7907c8..d83758c5 100644 --- a/lib/lwres/man/lwres_getipnode.3 +++ b/lib/lwres/man/lwres_getipnode.3 @@ -13,47 +13,40 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_getipnode.3,v 1.13.2.2.4.5 2005/09/12 00:47:27 marka Exp $ +.\" $Id: lwres_getipnode.3,v 1.13.2.2.4.6 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GETIPNODE" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GETIPNODE" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_getipnodebyname, lwres_getipnodebyaddr, lwres_freehostent \- lightweight resolver nodename / address translation API .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 42 -struct\ hostent\ *\ \fBlwres_getipnodebyname\fR\ (const\ char\ *name, int\ af, int\ flags, int\ *error_num); -.HP 42 -struct\ hostent\ *\ \fBlwres_getipnodebyaddr\fR\ (const\ void\ *src, size_t\ len, int\ af, int\ *error_num); -.HP 24 -void\ \fBlwres_freehostent\fR\ (struct\ hostent\ *he); +.HP 39 +\fBstruct\ hostent\ *\ \fBlwres_getipnodebyname\fR\fR\fB(\fR\fBconst\ char\ *name\fR\fB, \fR\fBint\ af\fR\fB, \fR\fBint\ flags\fR\fB, \fR\fBint\ *error_num\fR\fB);\fR +.HP 39 +\fBstruct\ hostent\ *\ \fBlwres_getipnodebyaddr\fR\fR\fB(\fR\fBconst\ void\ *src\fR\fB, \fR\fBsize_t\ len\fR\fB, \fR\fBint\ af\fR\fB, \fR\fBint\ *error_num\fR\fB);\fR +.HP 23 +\fBvoid\ \fBlwres_freehostent\fR\fR\fB(\fR\fBstruct\ hostent\ *he\fR\fB);\fR .SH "DESCRIPTION" .PP -These functions perform thread safe, protocol independent nodename\-to\-address and address\-to\-nodename translation as defined in RFC2553\&. +These functions perform thread safe, protocol independent nodename\-to\-address and address\-to\-nodename translation as defined in RFC2553. .PP -They use a \fBstruct hostent\fR which is defined in \fInamedb\&.h\fR: +They use a +\fBstruct hostent\fR +which is defined in +\fInamedb.h\fR: +.sp .nf struct hostent { char *h_name; /* official name of host */ @@ -64,58 +57,114 @@ struct hostent { }; #define h_addr h_addr_list[0] /* address, for backward compatibility */ .fi +.sp .PP -The members of this structure are: +The members of this structure are: .TP \fBh_name\fR -The official (canonical) name of the host\&. +The official (canonical) name of the host. .TP \fBh_aliases\fR -A NULL\-terminated array of alternate names (nicknames) for the host\&. +A NULL\-terminated array of alternate names (nicknames) for the host. .TP \fBh_addrtype\fR -The type of address being returned \- usually \fBPF_INET\fR or \fBPF_INET6\fR\&. +The type of address being returned \- usually +\fBPF_INET\fR +or +\fBPF_INET6\fR. .TP \fBh_length\fR -The length of the address in bytes\&. +The length of the address in bytes. .TP \fBh_addr_list\fR -A \fBNULL\fR terminated array of network addresses for the host\&. Host addresses are returned in network byte order\&. +A +\fBNULL\fR +terminated array of network addresses for the host. Host addresses are returned in network byte order. .PP - \fBlwres_getipnodebyname()\fR looks up addresses of protocol family \fIaf\fR for the hostname \fIname\fR\&. The \fIflags\fR parameter contains ORed flag bits to specify the types of addresses that are searched for, and the types of addresses that are returned\&. The flag bits are: +\fBlwres_getipnodebyname()\fR +looks up addresses of protocol family +\fIaf\fR +for the hostname +\fIname\fR. The +\fIflags\fR +parameter contains ORed flag bits to specify the types of addresses that are searched for, and the types of addresses that are returned. The flag bits are: .TP \fBAI_V4MAPPED\fR -This is used with an \fIaf\fR of AF_INET6, and causes IPv4 addresses to be returned as IPv4\-mapped IPv6 addresses\&. +This is used with an +\fIaf\fR +of AF_INET6, and causes IPv4 addresses to be returned as IPv4\-mapped IPv6 addresses. .TP \fBAI_ALL\fR -This is used with an \fIaf\fR 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 IPv6 addresses\&. +This is used with an +\fIaf\fR +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 IPv6 addresses. .TP \fBAI_ADDRCONFIG\fR -Only return an IPv6 or IPv4 address if here is an active network interface of that type\&. This is not currently implemented in the BIND 9 lightweight resolver, and the flag is ignored\&. +Only return an IPv6 or IPv4 address if here is an active network interface of that type. This is not currently implemented in the BIND 9 lightweight resolver, and the flag is ignored. .TP \fBAI_DEFAULT\fR -This default sets the \fBAI_V4MAPPED\fR and \fBAI_ADDRCONFIG\fR flag bits\&. +This default sets the +\fBAI_V4MAPPED\fR +and +\fBAI_ADDRCONFIG\fR +flag bits. .PP - \fBlwres_getipnodebyaddr()\fR performs a reverse lookup of address \fIsrc\fR which is \fIlen\fR bytes long\&. \fIaf\fR denotes the protocol family, typically \fBPF_INET\fR or \fBPF_INET6\fR\&. +\fBlwres_getipnodebyaddr()\fR +performs a reverse lookup of address +\fIsrc\fR +which is +\fIlen\fR +bytes long. +\fIaf\fR +denotes the protocol family, typically +\fBPF_INET\fR +or +\fBPF_INET6\fR. .PP - \fBlwres_freehostent()\fR releases all the memory associated with the \fBstruct hostent\fR pointer \fIhe\fR\&. Any memory allocated for the \fBh_name\fR, \fBh_addr_list\fR and \fBh_aliases\fR is freed, as is the memory for the \fBhostent\fR structure itself\&. +\fBlwres_freehostent()\fR +releases all the memory associated with the +\fBstruct hostent\fR +pointer +\fIhe\fR. Any memory allocated for the +\fBh_name\fR, +\fBh_addr_list\fR +and +\fBh_aliases\fR +is freed, as is the memory for the +\fBhostent\fR +structure itself. .SH "RETURN VALUES" .PP -If an error occurs, \fBlwres_getipnodebyname()\fR and \fBlwres_getipnodebyaddr()\fR set \fI*error_num\fR to an appropriate error code and the function returns a \fBNULL\fR pointer\&. The error codes and their meanings are defined in \fI<lwres/netdb\&.h>\fR: +If an error occurs, +\fBlwres_getipnodebyname()\fR +and +\fBlwres_getipnodebyaddr()\fR +set +\fI*error_num\fR +to an appropriate error code and the function returns a +\fBNULL\fR +pointer. The error codes and their meanings are defined in +\fI<lwres/netdb.h>\fR: .TP \fBHOST_NOT_FOUND\fR -No such host is known\&. +No such host is known. .TP \fBNO_ADDRESS\fR -The server recognised the request and the name but no address is available\&. Another type of request to the name server for the domain might return an answer\&. +The server recognised the request and the name but no address is available. Another type of request to the name server for the domain might return an answer. .TP \fBTRY_AGAIN\fR -A temporary and possibly transient error occurred, such as a failure of a server to respond\&. The request may succeed if retried\&. +A temporary and possibly transient error occurred, such as a failure of a server to respond. The request may succeed if retried. .TP \fBNO_RECOVERY\fR -An unexpected failure occurred, and retrying the request is pointless\&. +An unexpected failure occurred, and retrying the request is pointless. .PP - \fBlwres_hstrerror\fR(3 ) translates these error codes to suitable error messages\&. +\fBlwres_hstrerror\fR(3 ) +translates these error codes to suitable error messages. .SH "SEE ALSO" .PP - \fBRFC2553\fR(), \fBlwres\fR(3), \fBlwres_gethostent\fR(3), \fBlwres_getaddrinfo\fR(3), \fBlwres_getnameinfo\fR(3), \fBlwres_hstrerror\fR(3)\&. +\fBRFC2553\fR(), +\fBlwres\fR(3), +\fBlwres_gethostent\fR(3), +\fBlwres_getaddrinfo\fR(3), +\fBlwres_getnameinfo\fR(3), +\fBlwres_hstrerror\fR(3). diff --git a/lib/lwres/man/lwres_getipnode.html b/lib/lwres/man/lwres_getipnode.html index 7f650ac1..c5038b4f 100644 --- a/lib/lwres/man/lwres_getipnode.html +++ b/lib/lwres/man/lwres_getipnode.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_getipnode.html,v 1.7.2.1.4.7 2005/07/18 02:36:53 marka Exp $ --> +<!-- $Id: lwres_getipnode.html,v 1.7.2.1.4.9 2005/10/13 02:33:56 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_getipnode</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_getipnodebyname, lwres_getipnodebyaddr, lwres_freehostent — lightweight resolver nodename / address translation API</p> @@ -92,7 +92,7 @@ void </div> </div> <div class="refsect1" lang="en"> -<a name="id2514579"></a><h2>DESCRIPTION</h2> +<a name="id2525896"></a><h2>DESCRIPTION</h2> <p> These functions perform thread safe, protocol independent nodename-to-address and address-to-nodename @@ -233,7 +233,7 @@ structure itself. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514950"></a><h2>RETURN VALUES</h2> +<a name="id2526131"></a><h2>RETURN VALUES</h2> <p> If an error occurs, <code class="function">lwres_getipnodebyname()</code> @@ -279,7 +279,7 @@ translates these error codes to suitable error messages. </p> </div> <div class="refsect1" lang="en"> -<a name="id2515041"></a><h2>SEE ALSO</h2> +<a name="id2526290"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">RFC2553</span></span>, diff --git a/lib/lwres/man/lwres_getnameinfo.3 b/lib/lwres/man/lwres_getnameinfo.3 index 185d19fd..853c2b9b 100644 --- a/lib/lwres/man/lwres_getnameinfo.3 +++ b/lib/lwres/man/lwres_getnameinfo.3 @@ -13,66 +13,86 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_getnameinfo.3,v 1.15.2.1.8.4 2005/09/12 00:47:28 marka Exp $ +.\" $Id: lwres_getnameinfo.3,v 1.15.2.1.8.5 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GETNAMEINFO" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GETNAMEINFO" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_getnameinfo \- lightweight resolver socket address structure to hostname and service name .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 23 -int\ \fBlwres_getnameinfo\fR\ (const\ struct\ sockaddr\ *sa, size_t\ salen, char\ *host, size_t\ hostlen, char\ *serv, size_t\ servlen, int\ flags); +.HP 22 +\fBint\ \fBlwres_getnameinfo\fR\fR\fB(\fR\fBconst\ struct\ sockaddr\ *sa\fR\fB, \fR\fBsize_t\ salen\fR\fB, \fR\fBchar\ *host\fR\fB, \fR\fBsize_t\ hostlen\fR\fB, \fR\fBchar\ *serv\fR\fB, \fR\fBsize_t\ servlen\fR\fB, \fR\fBint\ flags\fR\fB);\fR .SH "DESCRIPTION" .PP -This function is equivalent to the \fBgetnameinfo\fR(3) function defined in RFC2133\&. \fBlwres_getnameinfo()\fR returns the hostname for the \fBstruct sockaddr\fR \fIsa\fR which is \fIsalen\fR bytes long\&. The hostname is of length \fIhostlen\fR and is returned via \fI*host\&.\fR The maximum length of the hostname is 1025 bytes: \fBNI_MAXHOST\fR\&. +This function is equivalent to the +\fBgetnameinfo\fR(3) +function defined in RFC2133. +\fBlwres_getnameinfo()\fR +returns the hostname for the +\fBstruct sockaddr\fR\fIsa\fR +which is +\fIsalen\fR +bytes long. The hostname is of length +\fIhostlen\fR +and is returned via +\fI*host.\fR +The maximum length of the hostname is 1025 bytes: +\fBNI_MAXHOST\fR. .PP -The name of the service associated with the port number in \fIsa\fR is returned in \fI*serv\&.\fR It is \fIservlen\fR bytes long\&. The maximum length of the service name is \fBNI_MAXSERV\fR \- 32 bytes\&. +The name of the service associated with the port number in +\fIsa\fR +is returned in +\fI*serv.\fR +It is +\fIservlen\fR +bytes long. The maximum length of the service name is +\fBNI_MAXSERV\fR +\- 32 bytes. .PP -The \fIflags\fR argument sets the following bits: +The +\fIflags\fR +argument sets the following bits: .TP \fBNI_NOFQDN\fR -A fully qualified domain name is not required for local hosts\&. The local part of the fully qualified domain name is returned instead\&. +A fully qualified domain name is not required for local hosts. The local part of the fully qualified domain name is returned instead. .TP \fBNI_NUMERICHOST\fR -Return the address in numeric form, as if calling inet_ntop(), instead of a host name\&. +Return the address in numeric form, as if calling inet_ntop(), instead of a host name. .TP \fBNI_NAMEREQD\fR -A name is required\&. If the hostname cannot be found in the DNS and this flag is set, a non\-zero error code is returned\&. If the hostname is not found and the flag is not set, the address is returned in numeric form\&. +A name is required. If the hostname cannot be found in the DNS and this flag is set, a non\-zero error code is returned. If the hostname is not found and the flag is not set, the address is returned in numeric form. .TP \fBNI_NUMERICSERV\fR -The service name is returned as a digit string representing the port number\&. +The service name is returned as a digit string representing the port number. .TP \fBNI_DGRAM\fR -Specifies that the service being looked up is a datagram service, and causes getservbyport() to be called with a second argument of "udp" instead of its default of "tcp"\&. This is required for the few ports (512\-514) that have different services for UDP and TCP\&. +Specifies that the service being looked up is a datagram service, and causes getservbyport() to be called with a second argument of "udp" instead of its default of "tcp". This is required for the few ports (512\-514) that have different services for UDP and TCP. .SH "RETURN VALUES" .PP - \fBlwres_getnameinfo()\fR returns 0 on success or a non\-zero error code if an error occurs\&. +\fBlwres_getnameinfo()\fR +returns 0 on success or a non\-zero error code if an error occurs. .SH "SEE ALSO" .PP - \fBRFC2133\fR(), \fBgetservbyport\fR(3), \fBlwres\fR(3), \fBlwres_getnameinfo\fR(3), \fBlwres_getnamebyaddr\fR(3)\&. \fBlwres_net_ntop\fR(3)\&. +\fBRFC2133\fR(), +\fBgetservbyport\fR(3), +\fBlwres\fR(3), +\fBlwres_getnameinfo\fR(3), +\fBlwres_getnamebyaddr\fR(3). +\fBlwres_net_ntop\fR(3). .SH "BUGS" .PP -RFC2133 fails to define what the nonzero return values of \fBgetnameinfo\fR(3) are\&. +RFC2133 fails to define what the nonzero return values of +\fBgetnameinfo\fR(3) +are. diff --git a/lib/lwres/man/lwres_getnameinfo.html b/lib/lwres/man/lwres_getnameinfo.html index 700cedad..6e7a7b16 100644 --- a/lib/lwres/man/lwres_getnameinfo.html +++ b/lib/lwres/man/lwres_getnameinfo.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_getnameinfo.html,v 1.5.2.1.4.7 2005/07/18 02:36:53 marka Exp $ --> +<!-- $Id: lwres_getnameinfo.html,v 1.5.2.1.4.9 2005/10/13 02:33:56 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_getnameinfo</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_getnameinfo — lightweight resolver socket address structure to hostname and service name</p> @@ -74,7 +74,7 @@ int </div> </div> <div class="refsect1" lang="en"> -<a name="id2514545"></a><h2>DESCRIPTION</h2> +<a name="id2525862"></a><h2>DESCRIPTION</h2> <p> This function is equivalent to the <span class="citerefentry"><span class="refentrytitle">getnameinfo</span>(3)</span> function defined in RFC2133. <code class="function">lwres_getnameinfo()</code> returns the hostname for the <span class="type">struct sockaddr</span> <em class="parameter"><code>sa</code></em> which is @@ -125,14 +125,14 @@ TCP. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514807"></a><h2>RETURN VALUES</h2> +<a name="id2525988"></a><h2>RETURN VALUES</h2> <p> <code class="function">lwres_getnameinfo()</code> returns 0 on success or a non-zero error code if an error occurs. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514820"></a><h2>SEE ALSO</h2> +<a name="id2526001"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">RFC2133</span></span>, <span class="citerefentry"><span class="refentrytitle">getservbyport</span>(3)</span>, @@ -143,7 +143,7 @@ returns 0 on success or a non-zero error code if an error occurs. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514878"></a><h2>BUGS</h2> +<a name="id2526059"></a><h2>BUGS</h2> <p> RFC2133 fails to define what the nonzero return values of <span class="citerefentry"><span class="refentrytitle">getnameinfo</span>(3)</span> diff --git a/lib/lwres/man/lwres_getrrsetbyname.3 b/lib/lwres/man/lwres_getrrsetbyname.3 index 256061b8..6d900f86 100644 --- a/lib/lwres/man/lwres_getrrsetbyname.3 +++ b/lib/lwres/man/lwres_getrrsetbyname.3 @@ -13,49 +13,39 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_getrrsetbyname.3,v 1.11.2.1.8.4 2005/09/12 00:47:28 marka Exp $ +.\" $Id: lwres_getrrsetbyname.3,v 1.11.2.1.8.5 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GETRRSETBYNA" 3 "Oct 18, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GETRRSETBYNAME" "3" "Oct 18, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_getrrsetbyname, lwres_freerrset \- retrieve DNS records .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 26 -int\ \fBlwres_getrrsetbyname\fR\ (const\ char\ *hostname, unsigned\ int\ rdclass, unsigned\ int\ rdtype, unsigned\ int\ flags, struct\ rrsetinfo\ **res); -.HP 22 -void\ \fBlwres_freerrset\fR\ (struct\ rrsetinfo\ *rrset); +.HP 25 +\fBint\ \fBlwres_getrrsetbyname\fR\fR\fB(\fR\fBconst\ char\ *hostname\fR\fB, \fR\fBunsigned\ int\ rdclass\fR\fB, \fR\fBunsigned\ int\ rdtype\fR\fB, \fR\fBunsigned\ int\ flags\fR\fB, \fR\fBstruct\ rrsetinfo\ **res\fR\fB);\fR +.HP 21 +\fBvoid\ \fBlwres_freerrset\fR\fR\fB(\fR\fBstruct\ rrsetinfo\ *rrset\fR\fB);\fR .PP -The following structures are used: +The following structures are used: +.sp .nf struct rdatainfo { unsigned int rdi_length; /* length of data */ unsigned char *rdi_data; /* record data */ }; struct rrsetinfo { - unsigned int rri_flags; /* RRSET_VALIDATED\&.\&.\&. */ + unsigned int rri_flags; /* RRSET_VALIDATED... */ unsigned int rri_rdclass; /* class number */ unsigned int rri_rdtype; /* RR type number */ unsigned int rri_ttl; /* time to live */ @@ -66,17 +56,65 @@ struct rrsetinfo { struct rdatainfo *rri_sigs; /* individual signatures */ }; .fi +.sp .SH "DESCRIPTION" .PP - \fBlwres_getrrsetbyname()\fR gets a set of resource records associated with a \fIhostname\fR, \fIclass\fR, and \fItype\fR\&. \fIhostname\fR is a pointer a to null\-terminated string\&. The \fIflags\fR field is currently unused and must be zero\&. +\fBlwres_getrrsetbyname()\fR +gets a set of resource records associated with a +\fIhostname\fR, +\fIclass\fR, and +\fItype\fR. +\fIhostname\fR +is a pointer a to null\-terminated string. The +\fIflags\fR +field is currently unused and must be zero. .PP -After a successful call to \fBlwres_getrrsetbyname()\fR, \fI*res\fR is a pointer to an \fBrrsetinfo\fR structure, containing a list of one or more \fBrdatainfo\fR structures containing resource records and potentially another list of \fBrdatainfo\fR structures containing SIG resource records associated with those records\&. The members \fBrri_rdclass\fR and \fBrri_rdtype\fR are copied from the parameters\&. \fBrri_ttl\fR and \fBrri_name\fR are properties of the obtained rrset\&. The resource records contained in \fBrri_rdatas\fR and \fBrri_sigs\fR are in uncompressed DNS wire format\&. Properties of the rdataset are represented in the \fBrri_flags\fR bitfield\&. If the RRSET_VALIDATED bit is set, the data has been DNSSEC validated and the signatures verified\&. +After a successful call to +\fBlwres_getrrsetbyname()\fR, +\fI*res\fR +is a pointer to an +\fBrrsetinfo\fR +structure, containing a list of one or more +\fBrdatainfo\fR +structures containing resource records and potentially another list of +\fBrdatainfo\fR +structures containing SIG resource records associated with those records. The members +\fBrri_rdclass\fR +and +\fBrri_rdtype\fR +are copied from the parameters. +\fBrri_ttl\fR +and +\fBrri_name\fR +are properties of the obtained rrset. The resource records contained in +\fBrri_rdatas\fR +and +\fBrri_sigs\fR +are in uncompressed DNS wire format. Properties of the rdataset are represented in the +\fBrri_flags\fR +bitfield. If the RRSET_VALIDATED bit is set, the data has been DNSSEC validated and the signatures verified. .PP -All of the information returned by \fBlwres_getrrsetbyname()\fR is dynamically allocated: the \fBrrsetinfo\fR and \fBrdatainfo\fR structures, and the canonical host name strings pointed to by the \fBrrsetinfo\fRstructure\&. Memory allocated for the dynamically allocated structures created by a successful call to \fBlwres_getrrsetbyname()\fR is released by \fBlwres_freerrset()\fR\&. \fIrrset\fR is a pointer to a \fBstruct rrset\fR created by a call to \fBlwres_getrrsetbyname()\fR\&. +All of the information returned by +\fBlwres_getrrsetbyname()\fR +is dynamically allocated: the +\fBrrsetinfo\fR +and +\fBrdatainfo\fR +structures, and the canonical host name strings pointed to by the +\fBrrsetinfo\fRstructure. Memory allocated for the dynamically allocated structures created by a successful call to +\fBlwres_getrrsetbyname()\fR +is released by +\fBlwres_freerrset()\fR. +\fIrrset\fR +is a pointer to a +\fBstruct rrset\fR +created by a call to +\fBlwres_getrrsetbyname()\fR. .PP .SH "RETURN VALUES" .PP - \fBlwres_getrrsetbyname()\fR returns zero on success, and one of the following error codes if an error occurred: +\fBlwres_getrrsetbyname()\fR +returns zero on success, and one of the following error codes if an error occurred: .TP \fBERRSET_NONAME\fR the name does not exist @@ -93,7 +131,6 @@ a parameter is invalid \fBERRSET_FAIL\fR other failure .TP -\fB\fR .SH "SEE ALSO" .PP - \fBlwres\fR(3)\&. +\fBlwres\fR(3). diff --git a/lib/lwres/man/lwres_getrrsetbyname.html b/lib/lwres/man/lwres_getrrsetbyname.html index 980e40ae..f36a1d21 100644 --- a/lib/lwres/man/lwres_getrrsetbyname.html +++ b/lib/lwres/man/lwres_getrrsetbyname.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_getrrsetbyname.html,v 1.5.2.1.4.7 2005/07/18 02:36:53 marka Exp $ --> +<!-- $Id: lwres_getrrsetbyname.html,v 1.5.2.1.4.9 2005/10/13 02:33:57 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_getrrsetbyname</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_getrrsetbyname, lwres_freerrset — retrieve DNS records</p> @@ -95,7 +95,7 @@ struct rrsetinfo { </p> </div> <div class="refsect1" lang="en"> -<a name="id2514561"></a><h2>DESCRIPTION</h2> +<a name="id2525878"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_getrrsetbyname()</code> gets a set of resource records associated with a @@ -172,7 +172,7 @@ created by a call to </p> </div> <div class="refsect1" lang="en"> -<a name="id2514877"></a><h2>RETURN VALUES</h2> +<a name="id2526058"></a><h2>RETURN VALUES</h2> <p> <code class="function">lwres_getrrsetbyname()</code> returns zero on success, and one of the following error @@ -208,7 +208,7 @@ other failure </p> </div> <div class="refsect1" lang="en"> -<a name="id2514951"></a><h2>SEE ALSO</h2> +<a name="id2526132"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres</span>(3)</span>. </p> diff --git a/lib/lwres/man/lwres_gnba.3 b/lib/lwres/man/lwres_gnba.3 index b3158d68..58047ce6 100644 --- a/lib/lwres/man/lwres_gnba.3 +++ b/lib/lwres/man/lwres_gnba.3 @@ -13,55 +13,50 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_gnba.3,v 1.13.2.1.8.4 2005/09/12 00:47:28 marka Exp $ +.\" $Id: lwres_gnba.3,v 1.13.2.1.8.5 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_GNBA" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_GNBA" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_gnbarequest_render, lwres_gnbaresponse_render, lwres_gnbarequest_parse, lwres_gnbaresponse_parse, lwres_gnbaresponse_free, lwres_gnbarequest_free \- lightweight resolver getnamebyaddress message handling .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi -.HP 41 -lwres_result_t\ \fBlwres_gnbarequest_render\fR\ (lwres_context_t\ *\fIctx\fR, lwres_gnbarequest_t\ *\fIreq\fR, lwres_lwpacket_t\ *\fIpkt\fR, lwres_buffer_t\ *\fIb\fR); -.HP 42 -lwres_result_t\ \fBlwres_gnbaresponse_render\fR\ (lwres_context_t\ *ctx, lwres_gnbaresponse_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b); .HP 40 -lwres_result_t\ \fBlwres_gnbarequest_parse\fR\ (lwres_context_t\ *ctx, lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt, lwres_gnbarequest_t\ **structp); +\fBlwres_result_t\ \fBlwres_gnbarequest_render\fR\fR\fB(\fR\fBlwres_context_t\ *\fR\fB\fIctx\fR\fR\fB, \fR\fBlwres_gnbarequest_t\ *\fR\fB\fIreq\fR\fR\fB, \fR\fBlwres_lwpacket_t\ *\fR\fB\fIpkt\fR\fR\fB, \fR\fBlwres_buffer_t\ *\fR\fB\fIb\fR\fR\fB);\fR .HP 41 -lwres_result_t\ \fBlwres_gnbaresponse_parse\fR\ (lwres_context_t\ *ctx, lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt, lwres_gnbaresponse_t\ **structp); -.HP 30 -void\ \fBlwres_gnbaresponse_free\fR\ (lwres_context_t\ *ctx, lwres_gnbaresponse_t\ **structp); +\fBlwres_result_t\ \fBlwres_gnbaresponse_render\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gnbaresponse_t\ *req\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 39 +\fBlwres_result_t\ \fBlwres_gnbarequest_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_gnbarequest_t\ **structp\fR\fB);\fR +.HP 40 +\fBlwres_result_t\ \fBlwres_gnbaresponse_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_gnbaresponse_t\ **structp\fR\fB);\fR .HP 29 -void\ \fBlwres_gnbarequest_free\fR\ (lwres_context_t\ *ctx, lwres_gnbarequest_t\ **structp); +\fBvoid\ \fBlwres_gnbaresponse_free\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gnbaresponse_t\ **structp\fR\fB);\fR +.HP 28 +\fBvoid\ \fBlwres_gnbarequest_free\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_gnbarequest_t\ **structp\fR\fB);\fR .SH "DESCRIPTION" .PP -These are low\-level routines for creating and parsing lightweight resolver address\-to\-name lookup request and response messages\&. +These are low\-level routines for creating and parsing lightweight resolver address\-to\-name lookup request and response messages. .PP -There are four main functions for the getnamebyaddr opcode\&. One render function converts a getnamebyaddr request structure -- \fBlwres_gnbarequest_t\fR -- to the lightweight resolver's canonical format\&. It is complemented by a parse function that converts a packet in this canonical format to a getnamebyaddr request structure\&. Another render function converts the getnamebyaddr response structure -- \fBlwres_gnbaresponse_t\fR to the canonical format\&. This is complemented by a parse function which converts a packet in canonical format to a getnamebyaddr response structure\&. +There are four main functions for the getnamebyaddr opcode. One render function converts a getnamebyaddr request structure \(em +\fBlwres_gnbarequest_t\fR +\(em to the lightweight resolver's canonical format. It is complemented by a parse function that converts a packet in this canonical format to a getnamebyaddr request structure. Another render function converts the getnamebyaddr response structure \(em +\fBlwres_gnbaresponse_t\fR +to the canonical format. This is complemented by a parse function which converts a packet in canonical format to a getnamebyaddr response structure. .PP -These structures are defined in \fIlwres/lwres\&.h\fR\&. They are shown below\&. +These structures are defined in +\fIlwres/lwres.h\fR. They are shown below. +.sp .nf #define LWRES_OPCODE_GETNAMEBYADDR 0x00010002U typedef struct { @@ -79,15 +74,87 @@ typedef struct { size_t baselen; } lwres_gnbaresponse_t; .fi +.sp .PP - \fBlwres_gnbarequest_render()\fR uses resolver context \fIctx\fR to convert getnamebyaddr request structure \fIreq\fR to canonical format\&. The packet header structure \fIpkt\fR is initialised and transferred to buffer \fIb\fR\&. The contents of \fI*req\fR are then appended to the buffer in canonical format\&. \fBlwres_gnbaresponse_render()\fR performs the same task, except it converts a getnamebyaddr response structure \fBlwres_gnbaresponse_t\fR to the lightweight resolver's canonical format\&. +\fBlwres_gnbarequest_render()\fR +uses resolver context +\fIctx\fR +to convert getnamebyaddr request structure +\fIreq\fR +to canonical format. The packet header structure +\fIpkt\fR +is initialised and transferred to buffer +\fIb\fR. The contents of +\fI*req\fR +are then appended to the buffer in canonical format. +\fBlwres_gnbaresponse_render()\fR +performs the same task, except it converts a getnamebyaddr response structure +\fBlwres_gnbaresponse_t\fR +to the lightweight resolver's canonical format. .PP - \fBlwres_gnbarequest_parse()\fR uses context \fIctx\fR to convert the contents of packet \fIpkt\fR to a \fBlwres_gnbarequest_t\fR structure\&. Buffer \fIb\fR provides space to be used for storing this structure\&. When the function succeeds, the resulting \fBlwres_gnbarequest_t\fR is made available through \fI*structp\fR\&. \fBlwres_gnbaresponse_parse()\fR offers the same semantics as \fBlwres_gnbarequest_parse()\fR except it yields a \fBlwres_gnbaresponse_t\fR structure\&. +\fBlwres_gnbarequest_parse()\fR +uses context +\fIctx\fR +to convert the contents of packet +\fIpkt\fR +to a +\fBlwres_gnbarequest_t\fR +structure. Buffer +\fIb\fR +provides space to be used for storing this structure. When the function succeeds, the resulting +\fBlwres_gnbarequest_t\fR +is made available through +\fI*structp\fR. +\fBlwres_gnbaresponse_parse()\fR +offers the same semantics as +\fBlwres_gnbarequest_parse()\fR +except it yields a +\fBlwres_gnbaresponse_t\fR +structure. .PP - \fBlwres_gnbaresponse_free()\fR and \fBlwres_gnbarequest_free()\fR release the memory in resolver context \fIctx\fR that was allocated to the \fBlwres_gnbaresponse_t\fR or \fBlwres_gnbarequest_t\fR structures referenced via \fIstructp\fR\&. Any memory associated with ancillary buffers and strings for those structures is also discarded\&. +\fBlwres_gnbaresponse_free()\fR +and +\fBlwres_gnbarequest_free()\fR +release the memory in resolver context +\fIctx\fR +that was allocated to the +\fBlwres_gnbaresponse_t\fR +or +\fBlwres_gnbarequest_t\fR +structures referenced via +\fIstructp\fR. Any memory associated with ancillary buffers and strings for those structures is also discarded. .SH "RETURN VALUES" .PP -The getnamebyaddr opcode functions \fBlwres_gnbarequest_render()\fR, \fBlwres_gnbaresponse_render()\fR \fBlwres_gnbarequest_parse()\fR and \fBlwres_gnbaresponse_parse()\fR all return \fBLWRES_R_SUCCESS\fR on success\&. They return \fBLWRES_R_NOMEMORY\fR if memory allocation fails\&. \fBLWRES_R_UNEXPECTEDEND\fR is returned if the available space in the buffer \fIb\fR is too small to accommodate the packet header or the \fBlwres_gnbarequest_t\fR and \fBlwres_gnbaresponse_t\fR structures\&. \fBlwres_gnbarequest_parse()\fR and \fBlwres_gnbaresponse_parse()\fR will return \fBLWRES_R_UNEXPECTEDEND\fR if the buffer is not empty after decoding the received packet\&. These functions will return \fBLWRES_R_FAILURE\fR if pktflags in the packet header structure \fBlwres_lwpacket_t\fR indicate that the packet is not a response to an earlier query\&. +The getnamebyaddr opcode functions +\fBlwres_gnbarequest_render()\fR, +\fBlwres_gnbaresponse_render()\fR\fBlwres_gnbarequest_parse()\fR +and +\fBlwres_gnbaresponse_parse()\fR +all return +\fBLWRES_R_SUCCESS\fR +on success. They return +\fBLWRES_R_NOMEMORY\fR +if memory allocation fails. +\fBLWRES_R_UNEXPECTEDEND\fR +is returned if the available space in the buffer +\fIb\fR +is too small to accommodate the packet header or the +\fBlwres_gnbarequest_t\fR +and +\fBlwres_gnbaresponse_t\fR +structures. +\fBlwres_gnbarequest_parse()\fR +and +\fBlwres_gnbaresponse_parse()\fR +will return +\fBLWRES_R_UNEXPECTEDEND\fR +if the buffer is not empty after decoding the received packet. These functions will return +\fBLWRES_R_FAILURE\fR +if +pktflags +in the packet header structure +\fBlwres_lwpacket_t\fR +indicate that the packet is not a response to an earlier query. .SH "SEE ALSO" .PP - \fBlwres_packet\fR(3)\&. +\fBlwres_packet\fR(3). diff --git a/lib/lwres/man/lwres_gnba.html b/lib/lwres/man/lwres_gnba.html index 19ac7d3a..89cf35e0 100644 --- a/lib/lwres/man/lwres_gnba.html +++ b/lib/lwres/man/lwres_gnba.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_gnba.html,v 1.6.2.1.4.7 2005/07/18 02:36:53 marka Exp $ --> +<!-- $Id: lwres_gnba.html,v 1.6.2.1.4.9 2005/10/13 02:33:57 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_gnba</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_gnbarequest_render, lwres_gnbaresponse_render, lwres_gnbarequest_parse, lwres_gnbaresponse_parse, lwres_gnbaresponse_free, lwres_gnbarequest_free — lightweight resolver getnamebyaddress message handling</p> @@ -172,7 +172,7 @@ void </div> </div> <div class="refsect1" lang="en"> -<a name="id2514658"></a><h2>DESCRIPTION</h2> +<a name="id2525975"></a><h2>DESCRIPTION</h2> <p> These are low-level routines for creating and parsing lightweight resolver address-to-name lookup request and @@ -277,7 +277,7 @@ structures is also discarded. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514782"></a><h2>RETURN VALUES</h2> +<a name="id2526100"></a><h2>RETURN VALUES</h2> <p> The getnamebyaddr opcode functions <code class="function">lwres_gnbarequest_render()</code>, @@ -315,7 +315,7 @@ indicate that the packet is not a response to an earlier query. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514984"></a><h2>SEE ALSO</h2> +<a name="id2526165"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres_packet</span>(3)</span>. </p> diff --git a/lib/lwres/man/lwres_hstrerror.3 b/lib/lwres/man/lwres_hstrerror.3 index 4ca84ce5..a1ecf7c2 100644 --- a/lib/lwres/man/lwres_hstrerror.3 +++ b/lib/lwres/man/lwres_hstrerror.3 @@ -13,63 +13,69 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_hstrerror.3,v 1.13.2.1.8.4 2005/09/12 00:47:29 marka Exp $ +.\" $Id: lwres_hstrerror.3,v 1.13.2.1.8.5 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_HSTRERROR" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_HSTRERROR" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_herror, lwres_hstrerror \- lightweight resolver error message generation .SH "SYNOPSIS" .nf -#include <lwres/netdb\&.h> +#include <lwres/netdb.h> .fi -.HP 19 -void\ \fBlwres_herror\fR\ (const\ char\ *s); -.HP 32 -const\ char\ *\ \fBlwres_hstrerror\fR\ (int\ err); +.HP 18 +\fBvoid\ \fBlwres_herror\fR\fR\fB(\fR\fBconst\ char\ *s\fR\fB);\fR +.HP 29 +\fBconst\ char\ *\ \fBlwres_hstrerror\fR\fR\fB(\fR\fBint\ err\fR\fB);\fR .SH "DESCRIPTION" .PP - \fBlwres_herror()\fR prints the string \fIs\fR on \fBstderr\fR followed by the string generated by \fBlwres_hstrerror()\fR for the error code stored in the global variable \fBlwres_h_errno\fR\&. +\fBlwres_herror()\fR +prints the string +\fIs\fR +on +\fBstderr\fR +followed by the string generated by +\fBlwres_hstrerror()\fR +for the error code stored in the global variable +\fBlwres_h_errno\fR. .PP - \fBlwres_hstrerror()\fR returns an appropriate string for the error code gievn by \fIerr\fR\&. The values of the error codes and messages are as follows: +\fBlwres_hstrerror()\fR +returns an appropriate string for the error code gievn by +\fIerr\fR. The values of the error codes and messages are as follows: .TP \fBNETDB_SUCCESS\fR - Resolver Error 0 (no error) +Resolver Error 0 (no error) .TP \fBHOST_NOT_FOUND\fR - Unknown host +Unknown host .TP \fBTRY_AGAIN\fR - Host name lookup failure +Host name lookup failure .TP \fBNO_RECOVERY\fR - Unknown server error +Unknown server error .TP \fBNO_DATA\fR - No address associated with name +No address associated with name .SH "RETURN VALUES" .PP -The string Unknown resolver error is returned by \fBlwres_hstrerror()\fR when the value of \fBlwres_h_errno\fR is not a valid error code\&. +The string +Unknown resolver error +is returned by +\fBlwres_hstrerror()\fR +when the value of +\fBlwres_h_errno\fR +is not a valid error code. .SH "SEE ALSO" .PP - \fBherror\fR(3), \fBlwres_hstrerror\fR(3)\&. +\fBherror\fR(3), +\fBlwres_hstrerror\fR(3). diff --git a/lib/lwres/man/lwres_hstrerror.html b/lib/lwres/man/lwres_hstrerror.html index 8f0081b6..4204a336 100644 --- a/lib/lwres/man/lwres_hstrerror.html +++ b/lib/lwres/man/lwres_hstrerror.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_hstrerror.html,v 1.5.2.1.4.7 2005/07/18 02:36:53 marka Exp $ --> +<!-- $Id: lwres_hstrerror.html,v 1.5.2.1.4.9 2005/10/13 02:33:57 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_hstrerror</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_herror, lwres_hstrerror — lightweight resolver error message generation</p> @@ -40,7 +40,7 @@ const char * </div> </div> <div class="refsect1" lang="en"> -<a name="id2514541"></a><h2>DESCRIPTION</h2> +<a name="id2525859"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_herror()</code> prints the string <em class="parameter"><code>s</code></em> on <span class="type">stderr</span> followed by the string @@ -79,7 +79,7 @@ the error codes and messages are as follows: </p> </div> <div class="refsect1" lang="en"> -<a name="id2514722"></a><h2>RETURN VALUES</h2> +<a name="id2525971"></a><h2>RETURN VALUES</h2> <p> The string <span class="errorname">Unknown resolver error</span> is returned by <code class="function">lwres_hstrerror()</code> @@ -89,7 +89,7 @@ is not a valid error code. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514741"></a><h2>SEE ALSO</h2> +<a name="id2525990"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">herror</span>(3)</span>, diff --git a/lib/lwres/man/lwres_inetntop.3 b/lib/lwres/man/lwres_inetntop.3 index 6b43b9d1..782cbafd 100644 --- a/lib/lwres/man/lwres_inetntop.3 +++ b/lib/lwres/man/lwres_inetntop.3 @@ -13,46 +13,57 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_inetntop.3,v 1.12.2.1.8.4 2005/09/12 00:47:29 marka Exp $ +.\" $Id: lwres_inetntop.3,v 1.12.2.1.8.5 2005/10/13 02:33:53 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_INETNTOP" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_INETNTOP" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_net_ntop \- lightweight resolver IP address presentation .SH "SYNOPSIS" .nf -#include <lwres/net\&.h> +#include <lwres/net.h> .fi -.HP 31 -const\ char\ *\ \fBlwres_net_ntop\fR\ (int\ af, const\ void\ *src, char\ *dst, size_t\ size); +.HP 28 +\fBconst\ char\ *\ \fBlwres_net_ntop\fR\fR\fB(\fR\fBint\ af\fR\fB, \fR\fBconst\ void\ *src\fR\fB, \fR\fBchar\ *dst\fR\fB, \fR\fBsize_t\ size\fR\fB);\fR .SH "DESCRIPTION" .PP - \fBlwres_net_ntop()\fR converts an IP address of protocol family \fIaf\fR -- IPv4 or IPv6 -- at location \fIsrc\fR 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\&. +\fBlwres_net_ntop()\fR +converts an IP address of protocol family +\fIaf\fR +\(em IPv4 or IPv6 \(em at location +\fIsrc\fR +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. .PP -The generated string is copied to \fIdst\fR provided \fIsize\fR indicates it is long enough to store the ASCII representation of the address\&. +The generated string is copied to +\fIdst\fR +provided +\fIsize\fR +indicates it is long enough to store the ASCII representation of the address. .SH "RETURN VALUES" .PP -If successful, the function returns \fIdst\fR: a pointer to a string containing the presentation format of the address\&. \fBlwres_net_ntop()\fR returns \fBNULL\fR and sets the global variable \fBerrno\fR to \fBEAFNOSUPPORT\fR if the protocol family given in \fIaf\fR is not supported\&. +If successful, the function returns +\fIdst\fR: a pointer to a string containing the presentation format of the address. +\fBlwres_net_ntop()\fR +returns +\fBNULL\fR +and sets the global variable +\fBerrno\fR +to +\fBEAFNOSUPPORT\fR +if the protocol family given in +\fIaf\fR +is not supported. .SH "SEE ALSO" .PP - \fBRFC1884\fR(), \fBinet_ntop\fR(3), \fBerrno\fR(3)\&. +\fBRFC1884\fR(), +\fBinet_ntop\fR(3), +\fBerrno\fR(3). diff --git a/lib/lwres/man/lwres_inetntop.html b/lib/lwres/man/lwres_inetntop.html index 5625f562..3c794a53 100644 --- a/lib/lwres/man/lwres_inetntop.html +++ b/lib/lwres/man/lwres_inetntop.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_inetntop.html,v 1.5.2.1.4.7 2005/07/18 02:36:54 marka Exp $ --> +<!-- $Id: lwres_inetntop.html,v 1.5.2.1.4.9 2005/10/13 02:33:57 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_inetntop</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_net_ntop — lightweight resolver IP address presentation</p> @@ -59,7 +59,7 @@ const char * </div> </div> <div class="refsect1" lang="en"> -<a name="id2514537"></a><h2>DESCRIPTION</h2> +<a name="id2525854"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_net_ntop()</code> converts an IP address of protocol family <em class="parameter"><code>af</code></em> — IPv4 or IPv6 — @@ -75,7 +75,7 @@ ASCII representation of the address. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514570"></a><h2>RETURN VALUES</h2> +<a name="id2525888"></a><h2>RETURN VALUES</h2> <p> If successful, the function returns <em class="parameter"><code>dst</code></em>: a pointer to a string containing the presentation format of the @@ -87,7 +87,7 @@ supported. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514601"></a><h2>SEE ALSO</h2> +<a name="id2525918"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">RFC1884</span></span>, <span class="citerefentry"><span class="refentrytitle">inet_ntop</span>(3)</span>, diff --git a/lib/lwres/man/lwres_noop.3 b/lib/lwres/man/lwres_noop.3 index 0efce1af..d2eba576 100644 --- a/lib/lwres/man/lwres_noop.3 +++ b/lib/lwres/man/lwres_noop.3 @@ -13,57 +13,54 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_noop.3,v 1.14.2.1.8.4 2005/09/12 00:47:29 marka Exp $ +.\" $Id: lwres_noop.3,v 1.14.2.1.8.5 2005/10/13 02:33:54 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_NOOP" 3 "Jun 30, 2000" "" "" -.SH NAME -lwres_nooprequest_render, lwres_noopresponse_render, lwres_nooprequest_parse, lwres_noopresponse_parse, lwres_noopresponse_free, lwres_nooprequest_free \- lightweight resolver no-op message handling +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_NOOP" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +lwres_nooprequest_render, lwres_noopresponse_render, lwres_nooprequest_parse, lwres_noopresponse_parse, lwres_noopresponse_free, lwres_nooprequest_free \- lightweight resolver no\-op message handling .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi -.HP 41 -lwres_result_t\ \fBlwres_nooprequest_render\fR\ (lwres_context_t\ *ctx, lwres_nooprequest_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b); -.HP 42 -lwres_result_t\ \fBlwres_noopresponse_render\fR\ (lwres_context_t\ *ctx, lwres_noopresponse_t\ *req, lwres_lwpacket_t\ *pkt, lwres_buffer_t\ *b); .HP 40 -lwres_result_t\ \fBlwres_nooprequest_parse\fR\ (lwres_context_t\ *ctx, lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt, lwres_nooprequest_t\ **structp); +\fBlwres_result_t\ \fBlwres_nooprequest_render\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_nooprequest_t\ *req\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB);\fR .HP 41 -lwres_result_t\ \fBlwres_noopresponse_parse\fR\ (lwres_context_t\ *ctx, lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt, lwres_noopresponse_t\ **structp); -.HP 30 -void\ \fBlwres_noopresponse_free\fR\ (lwres_context_t\ *ctx, lwres_noopresponse_t\ **structp); +\fBlwres_result_t\ \fBlwres_noopresponse_render\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_noopresponse_t\ *req\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB);\fR +.HP 39 +\fBlwres_result_t\ \fBlwres_nooprequest_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_nooprequest_t\ **structp\fR\fB);\fR +.HP 40 +\fBlwres_result_t\ \fBlwres_noopresponse_parse\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB, \fR\fBlwres_noopresponse_t\ **structp\fR\fB);\fR .HP 29 -void\ \fBlwres_nooprequest_free\fR\ (lwres_context_t\ *ctx, lwres_nooprequest_t\ **structp); +\fBvoid\ \fBlwres_noopresponse_free\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_noopresponse_t\ **structp\fR\fB);\fR +.HP 28 +\fBvoid\ \fBlwres_nooprequest_free\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_nooprequest_t\ **structp\fR\fB);\fR .SH "DESCRIPTION" .PP -These are low\-level routines for creating and parsing lightweight resolver no\-op request and response messages\&. +These are low\-level routines for creating and parsing lightweight resolver no\-op request and response messages. .PP -The no\-op message is analogous to a \fBping\fR packet: a packet is sent to the resolver daemon and is simply echoed back\&. The opcode is intended to allow a client to determine if the server is operational or not\&. +The no\-op message is analogous to a +\fBping\fR +packet: a packet is sent to the resolver daemon and is simply echoed back. The opcode is intended to allow a client to determine if the server is operational or not. .PP -There are four main functions for the no\-op opcode\&. One render function converts a no\-op request structure -- \fBlwres_nooprequest_t\fR -- to the lighweight resolver's canonical format\&. It is complemented by a parse function that converts a packet in this canonical format to a no\-op request structure\&. Another render function converts the no\-op response structure -- \fBlwres_noopresponse_t\fR to the canonical format\&. This is complemented by a parse function which converts a packet in canonical format to a no\-op response structure\&. +There are four main functions for the no\-op opcode. One render function converts a no\-op request structure \(em +\fBlwres_nooprequest_t\fR +\(em to the lighweight resolver's canonical format. It is complemented by a parse function that converts a packet in this canonical format to a no\-op request structure. Another render function converts the no\-op response structure \(em +\fBlwres_noopresponse_t\fR +to the canonical format. This is complemented by a parse function which converts a packet in canonical format to a no\-op response structure. .PP -These structures are defined in \fIlwres/lwres\&.h\fR\&. They are shown below\&. +These structures are defined in +\fIlwres/lwres.h\fR. They are shown below. +.sp .nf #define LWRES_OPCODE_NOOP 0x00000000U typedef struct { @@ -75,16 +72,88 @@ typedef struct { unsigned char *data; } lwres_noopresponse_t; .fi - Although the structures have different types, they are identical\&. This is because the no\-op opcode simply echos whatever data was sent: the response is therefore identical to the request\&. +.sp +Although the structures have different types, they are identical. This is because the no\-op opcode simply echos whatever data was sent: the response is therefore identical to the request. .PP - \fBlwres_nooprequest_render()\fR uses resolver context \fIctx\fR to convert no\-op request structure \fIreq\fR to canonical format\&. The packet header structure \fIpkt\fR is initialised and transferred to buffer \fIb\fR\&. The contents of \fI*req\fR are then appended to the buffer in canonical format\&. \fBlwres_noopresponse_render()\fR performs the same task, except it converts a no\-op response structure \fBlwres_noopresponse_t\fR to the lightweight resolver's canonical format\&. +\fBlwres_nooprequest_render()\fR +uses resolver context +\fIctx\fR +to convert no\-op request structure +\fIreq\fR +to canonical format. The packet header structure +\fIpkt\fR +is initialised and transferred to buffer +\fIb\fR. The contents of +\fI*req\fR +are then appended to the buffer in canonical format. +\fBlwres_noopresponse_render()\fR +performs the same task, except it converts a no\-op response structure +\fBlwres_noopresponse_t\fR +to the lightweight resolver's canonical format. .PP - \fBlwres_nooprequest_parse()\fR uses context \fIctx\fR to convert the contents of packet \fIpkt\fR to a \fBlwres_nooprequest_t\fR structure\&. Buffer \fIb\fR provides space to be used for storing this structure\&. When the function succeeds, the resulting \fBlwres_nooprequest_t\fR is made available through \fI*structp\fR\&. \fBlwres_noopresponse_parse()\fR offers the same semantics as \fBlwres_nooprequest_parse()\fR except it yields a \fBlwres_noopresponse_t\fR structure\&. +\fBlwres_nooprequest_parse()\fR +uses context +\fIctx\fR +to convert the contents of packet +\fIpkt\fR +to a +\fBlwres_nooprequest_t\fR +structure. Buffer +\fIb\fR +provides space to be used for storing this structure. When the function succeeds, the resulting +\fBlwres_nooprequest_t\fR +is made available through +\fI*structp\fR. +\fBlwres_noopresponse_parse()\fR +offers the same semantics as +\fBlwres_nooprequest_parse()\fR +except it yields a +\fBlwres_noopresponse_t\fR +structure. .PP - \fBlwres_noopresponse_free()\fR and \fBlwres_nooprequest_free()\fR release the memory in resolver context \fIctx\fR that was allocated to the \fBlwres_noopresponse_t\fR or \fBlwres_nooprequest_t\fR structures referenced via \fIstructp\fR\&. +\fBlwres_noopresponse_free()\fR +and +\fBlwres_nooprequest_free()\fR +release the memory in resolver context +\fIctx\fR +that was allocated to the +\fBlwres_noopresponse_t\fR +or +\fBlwres_nooprequest_t\fR +structures referenced via +\fIstructp\fR. .SH "RETURN VALUES" .PP -The no\-op opcode functions \fBlwres_nooprequest_render()\fR, \fBlwres_noopresponse_render()\fR \fBlwres_nooprequest_parse()\fR and \fBlwres_noopresponse_parse()\fR all return \fBLWRES_R_SUCCESS\fR on success\&. They return \fBLWRES_R_NOMEMORY\fR if memory allocation fails\&. \fBLWRES_R_UNEXPECTEDEND\fR is returned if the available space in the buffer \fIb\fR is too small to accommodate the packet header or the \fBlwres_nooprequest_t\fR and \fBlwres_noopresponse_t\fR structures\&. \fBlwres_nooprequest_parse()\fR and \fBlwres_noopresponse_parse()\fR will return \fBLWRES_R_UNEXPECTEDEND\fR if the buffer is not empty after decoding the received packet\&. These functions will return \fBLWRES_R_FAILURE\fR if \fBpktflags\fR in the packet header structure \fBlwres_lwpacket_t\fR indicate that the packet is not a response to an earlier query\&. +The no\-op opcode functions +\fBlwres_nooprequest_render()\fR, +\fBlwres_noopresponse_render()\fR\fBlwres_nooprequest_parse()\fR +and +\fBlwres_noopresponse_parse()\fR +all return +\fBLWRES_R_SUCCESS\fR +on success. They return +\fBLWRES_R_NOMEMORY\fR +if memory allocation fails. +\fBLWRES_R_UNEXPECTEDEND\fR +is returned if the available space in the buffer +\fIb\fR +is too small to accommodate the packet header or the +\fBlwres_nooprequest_t\fR +and +\fBlwres_noopresponse_t\fR +structures. +\fBlwres_nooprequest_parse()\fR +and +\fBlwres_noopresponse_parse()\fR +will return +\fBLWRES_R_UNEXPECTEDEND\fR +if the buffer is not empty after decoding the received packet. These functions will return +\fBLWRES_R_FAILURE\fR +if +\fBpktflags\fR +in the packet header structure +\fBlwres_lwpacket_t\fR +indicate that the packet is not a response to an earlier query. .SH "SEE ALSO" .PP - \fBlwres_packet\fR(3 ) +\fBlwres_packet\fR(3 ) diff --git a/lib/lwres/man/lwres_noop.html b/lib/lwres/man/lwres_noop.html index be9ffe8b..261bac80 100644 --- a/lib/lwres/man/lwres_noop.html +++ b/lib/lwres/man/lwres_noop.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_noop.html,v 1.7.2.1.4.7 2005/07/18 02:36:54 marka Exp $ --> +<!-- $Id: lwres_noop.html,v 1.7.2.1.4.9 2005/10/13 02:33:57 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_noop</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_nooprequest_render, lwres_noopresponse_render, lwres_nooprequest_parse, lwres_noopresponse_parse, lwres_noopresponse_free, lwres_nooprequest_free — lightweight resolver no-op message handling</p> @@ -165,7 +165,7 @@ void </div> </div> <div class="refsect1" lang="en"> -<a name="id2514646"></a><h2>DESCRIPTION</h2> +<a name="id2525963"></a><h2>DESCRIPTION</h2> <p> These are low-level routines for creating and parsing lightweight resolver no-op request and response messages. @@ -246,7 +246,7 @@ structures referenced via <em class="parameter"><code>structp</code></em>. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514846"></a><h2>RETURN VALUES</h2> +<a name="id2526096"></a><h2>RETURN VALUES</h2> <p> The no-op opcode functions <code class="function">lwres_nooprequest_render()</code>, @@ -285,7 +285,7 @@ indicate that the packet is not a response to an earlier query. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514979"></a><h2>SEE ALSO</h2> +<a name="id2526160"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres_packet</span>(3 )</span> diff --git a/lib/lwres/man/lwres_packet.3 b/lib/lwres/man/lwres_packet.3 index 51e7b79d..777e0c76 100644 --- a/lib/lwres/man/lwres_packet.3 +++ b/lib/lwres/man/lwres_packet.3 @@ -13,43 +13,36 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_packet.3,v 1.15.2.1.8.4 2005/09/12 00:47:29 marka Exp $ +.\" $Id: lwres_packet.3,v 1.15.2.1.8.5 2005/10/13 02:33:54 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_PACKET" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_PACKET" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_lwpacket_renderheader, lwres_lwpacket_parseheader \- lightweight resolver packet handling functions .SH "SYNOPSIS" .nf -#include <lwres/lwpacket\&.h> +#include <lwres/lwpacket.h> .fi -.HP 44 -lwres_result_t\ \fBlwres_lwpacket_renderheader\fR\ (lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt); .HP 43 -lwres_result_t\ \fBlwres_lwpacket_parseheader\fR\ (lwres_buffer_t\ *b, lwres_lwpacket_t\ *pkt); +\fBlwres_result_t\ \fBlwres_lwpacket_renderheader\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB);\fR +.HP 42 +\fBlwres_result_t\ \fBlwres_lwpacket_parseheader\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_lwpacket_t\ *pkt\fR\fB);\fR .SH "DESCRIPTION" .PP -These functions rely on a \fBstruct lwres_lwpacket\fR which is defined in \fIlwres/lwpacket\&.h\fR\&. +These functions rely on a +\fBstruct lwres_lwpacket\fR +which is defined in +\fIlwres/lwpacket.h\fR. +.sp .nf typedef struct lwres_lwpacket lwres_lwpacket_t; struct lwres_lwpacket { @@ -64,50 +57,73 @@ struct lwres_lwpacket { lwres_uint16_t authlength; }; .fi +.sp .PP -The elements of this structure are: +The elements of this structure are: .TP \fBlength\fR -the overall packet length, including the entire packet header\&. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls\&. +the overall packet length, including the entire packet header. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls. .TP \fBversion\fR -the header format\&. There is currently only one format, \fBLWRES_LWPACKETVERSION_0\fR\&. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls\&. +the header format. There is currently only one format, +\fBLWRES_LWPACKETVERSION_0\fR. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls. .TP \fBpktflags\fR -library\-defined flags for this packet: for instance whether the packet is a request or a reply\&. Flag values can be set, but not defined by the caller\&. This field is filled in by the application wit the exception of the LWRES_LWPACKETFLAG_RESPONSE bit, which is set by the library in the lwres_gabn_*() and lwres_gnba_*() calls\&. +library\-defined flags for this packet: for instance whether the packet is a request or a reply. Flag values can be set, but not defined by the caller. This field is filled in by the application wit the exception of the LWRES_LWPACKETFLAG_RESPONSE bit, which is set by the library in the lwres_gabn_*() and lwres_gnba_*() calls. .TP \fBserial\fR -is set by the requestor and is returned in all replies\&. If two or more packets from the same source have the same serial number and are from the same source, they are assumed to be duplicates and the latter ones may be dropped\&. This field must be set by the application\&. +is set by the requestor and is returned in all replies. If two or more packets from the same source have the same serial number and are from the same source, they are assumed to be duplicates and the latter ones may be dropped. This field must be set by the application. .TP \fBopcode\fR -indicates the operation\&. Opcodes between 0x00000000 and 0x03ffffff are reserved for use by the lightweight resolver library\&. Opcodes between 0x04000000 and 0xffffffff are application defined\&. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls\&. +indicates the operation. Opcodes between 0x00000000 and 0x03ffffff are reserved for use by the lightweight resolver library. Opcodes between 0x04000000 and 0xffffffff are application defined. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls. .TP \fBresult\fR -is only valid for replies\&. Results between 0x04000000 and 0xffffffff are application defined\&. Results between 0x00000000 and 0x03ffffff are reserved for library use\&. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls\&. +is only valid for replies. Results between 0x04000000 and 0xffffffff are application defined. Results between 0x00000000 and 0x03ffffff are reserved for library use. This field is filled in by the lwres_gabn_*() and lwres_gnba_*() calls. .TP \fBrecvlength\fR -is the maximum buffer size that the receiver can handle on requests and the size of the buffer needed to satisfy a request when the buffer is too large for replies\&. This field is supplied by the application\&. +is the maximum buffer size that the receiver can handle on requests and the size of the buffer needed to satisfy a request when the buffer is too large for replies. This field is supplied by the application. .TP \fBauthtype\fR -defines the packet level authentication that is used\&. Authorisation types between 0x1000 and 0xffff are application defined and types between 0x0000 and 0x0fff are reserved for library use\&. Currently these are not used and must be zero\&. +defines the packet level authentication that is used. Authorisation types between 0x1000 and 0xffff are application defined and types between 0x0000 and 0x0fff are reserved for library use. Currently these are not used and must be zero. .TP \fBauthlen\fR -gives the length of the authentication data\&. Since packet authentication is currently not used, this must be zero\&. +gives the length of the authentication data. Since packet authentication is currently not used, this must be zero. .PP -The following opcodes are currently defined: +The following opcodes are currently defined: .TP \fBNOOP\fR -Success is always returned and the packet contents are echoed\&. The lwres_noop_*() functions should be used for this type\&. +Success is always returned and the packet contents are echoed. The lwres_noop_*() functions should be used for this type. .TP \fBGETADDRSBYNAME\fR -returns all known addresses for a given name\&. The lwres_gabn_*() functions should be used for this type\&. +returns all known addresses for a given name. The lwres_gabn_*() functions should be used for this type. .TP \fBGETNAMEBYADDR\fR -return the hostname for the given address\&. The lwres_gnba_*() functions should be used for this type\&. +return the hostname for the given address. The lwres_gnba_*() functions should be used for this type. .PP - \fBlwres_lwpacket_renderheader()\fR transfers the contents of lightweight resolver packet structure \fBlwres_lwpacket_t\fR \fI*pkt\fR in network byte order to the lightweight resolver buffer, \fI*b\fR\&. +\fBlwres_lwpacket_renderheader()\fR +transfers the contents of lightweight resolver packet structure +\fBlwres_lwpacket_t\fR\fI*pkt\fR +in network byte order to the lightweight resolver buffer, +\fI*b\fR. .PP - \fBlwres_lwpacket_parseheader()\fR performs the converse operation\&. It transfers data in network byte order from buffer \fI*b\fR to resolver packet \fI*pkt\fR\&. The contents of the buffer \fIb\fR should correspond to a \fBlwres_lwpacket_t\fR\&. +\fBlwres_lwpacket_parseheader()\fR +performs the converse operation. It transfers data in network byte order from buffer +\fI*b\fR +to resolver packet +\fI*pkt\fR. The contents of the buffer +\fIb\fR +should correspond to a +\fBlwres_lwpacket_t\fR. .SH "RETURN VALUES" .PP -Successful calls to \fBlwres_lwpacket_renderheader()\fR and \fBlwres_lwpacket_parseheader()\fR return \fBLWRES_R_SUCCESS\fR\&. If there is insufficient space to copy data between the buffer \fI*b\fR and lightweight resolver packet \fI*pkt\fR both functions return \fBLWRES_R_UNEXPECTEDEND\fR\&. +Successful calls to +\fBlwres_lwpacket_renderheader()\fR +and +\fBlwres_lwpacket_parseheader()\fR +return +\fBLWRES_R_SUCCESS\fR. If there is insufficient space to copy data between the buffer +\fI*b\fR +and lightweight resolver packet +\fI*pkt\fR +both functions return +\fBLWRES_R_UNEXPECTEDEND\fR. diff --git a/lib/lwres/man/lwres_packet.html b/lib/lwres/man/lwres_packet.html index cdbb5406..b83fbcbf 100644 --- a/lib/lwres/man/lwres_packet.html +++ b/lib/lwres/man/lwres_packet.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_packet.html,v 1.8.2.1.4.7 2005/07/18 02:36:54 marka Exp $ --> +<!-- $Id: lwres_packet.html,v 1.8.2.1.4.9 2005/10/13 02:33:57 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_packet</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_lwpacket_renderheader, lwres_lwpacket_parseheader — lightweight resolver packet handling functions</p> @@ -64,7 +64,7 @@ lwres_result_t </div> </div> <div class="refsect1" lang="en"> -<a name="id2514548"></a><h2>DESCRIPTION</h2> +<a name="id2525865"></a><h2>DESCRIPTION</h2> <p> These functions rely on a <span class="type">struct lwres_lwpacket</span> @@ -202,7 +202,7 @@ buffer <em class="parameter"><code>*b</code></em> to resolver packet </p> </div> <div class="refsect1" lang="en"> -<a name="id2514955"></a><h2>RETURN VALUES</h2> +<a name="id2526068"></a><h2>RETURN VALUES</h2> <p> Successful calls to <code class="function">lwres_lwpacket_renderheader()</code> and <code class="function">lwres_lwpacket_parseheader()</code> return diff --git a/lib/lwres/man/lwres_resutil.3 b/lib/lwres/man/lwres_resutil.3 index 82800b59..5d4cfc05 100644 --- a/lib/lwres/man/lwres_resutil.3 +++ b/lib/lwres/man/lwres_resutil.3 @@ -13,51 +13,64 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.\" $Id: lwres_resutil.3,v 1.14.2.1.8.4 2005/09/12 00:47:29 marka Exp $ +.\" $Id: lwres_resutil.3,v 1.14.2.1.8.5 2005/10/13 02:33:54 marka Exp $ .\" .hy 0 .ad l -.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "LWRES_RESUTIL" 3 "Jun 30, 2000" "" "" -.SH NAME +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "LWRES_RESUTIL" "3" "Jun 30, 2000" "BIND9" "BIND9" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" lwres_string_parse, lwres_addr_parse, lwres_getaddrsbyname, lwres_getnamebyaddr \- lightweight resolver utility functions .SH "SYNOPSIS" .nf -#include <lwres/lwres\&.h> +#include <lwres/lwres.h> .fi -.HP 35 -lwres_result_t\ \fBlwres_string_parse\fR\ (lwres_buffer_t\ *b, char\ **c, lwres_uint16_t\ *len); -.HP 33 -lwres_result_t\ \fBlwres_addr_parse\fR\ (lwres_buffer_t\ *b, lwres_addr_t\ *addr); -.HP 37 -lwres_result_t\ \fBlwres_getaddrsbyname\fR\ (lwres_context_t\ *ctx, const\ char\ *name, lwres_uint32_t\ addrtypes, lwres_gabnresponse_t\ **structp); +.HP 34 +\fBlwres_result_t\ \fBlwres_string_parse\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBchar\ **c\fR\fB, \fR\fBlwres_uint16_t\ *len\fR\fB);\fR +.HP 32 +\fBlwres_result_t\ \fBlwres_addr_parse\fR\fR\fB(\fR\fBlwres_buffer_t\ *b\fR\fB, \fR\fBlwres_addr_t\ *addr\fR\fB);\fR .HP 36 -lwres_result_t\ \fBlwres_getnamebyaddr\fR\ (lwres_context_t\ *ctx, lwres_uint32_t\ addrtype, lwres_uint16_t\ addrlen, const\ unsigned\ char\ *addr, lwres_gnbaresponse_t\ **structp); +\fBlwres_result_t\ \fBlwres_getaddrsbyname\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBconst\ char\ *name\fR\fB, \fR\fBlwres_uint32_t\ addrtypes\fR\fB, \fR\fBlwres_gabnresponse_t\ **structp\fR\fB);\fR +.HP 35 +\fBlwres_result_t\ \fBlwres_getnamebyaddr\fR\fR\fB(\fR\fBlwres_context_t\ *ctx\fR\fB, \fR\fBlwres_uint32_t\ addrtype\fR\fB, \fR\fBlwres_uint16_t\ addrlen\fR\fB, \fR\fBconst\ unsigned\ char\ *addr\fR\fB, \fR\fBlwres_gnbaresponse_t\ **structp\fR\fB);\fR .SH "DESCRIPTION" .PP - \fBlwres_string_parse()\fR retrieves a DNS\-encoded string starting the current pointer of lightweight resolver buffer \fIb\fR: i\&.e\&. \fBb\->current\fR\&. When the function returns, the address of the first byte of the encoded string is returned via \fI*c\fR and the length of that string is given by \fI*len\fR\&. The buffer's current pointer is advanced to point at the character following the string length, the encoded string, and the trailing \fBNULL\fR character\&. +\fBlwres_string_parse()\fR +retrieves a DNS\-encoded string starting the current pointer of lightweight resolver buffer +\fIb\fR: i.e. +\fBb\->current\fR. When the function returns, the address of the first byte of the encoded string is returned via +\fI*c\fR +and the length of that string is given by +\fI*len\fR. The buffer's current pointer is advanced to point at the character following the string length, the encoded string, and the trailing +\fBNULL\fR +character. .PP - \fBlwres_addr_parse()\fR extracts an address from the buffer \fIb\fR\&. The buffer's current pointer \fBb\->current\fR is presumed to point at an encoded address: the address preceded by a 32\-bit protocol family identifier and a 16\-bit length field\&. The encoded address is copied to \fBaddr\->address\fR and \fBaddr\->length\fR indicates the size in bytes of the address that was copied\&. \fBb\->current\fR is advanced to point at the next byte of available data in the buffer following the encoded address\&. +\fBlwres_addr_parse()\fR +extracts an address from the buffer +\fIb\fR. The buffer's current pointer +\fBb\->current\fR +is presumed to point at an encoded address: the address preceded by a 32\-bit protocol family identifier and a 16\-bit length field. The encoded address is copied to +\fBaddr\->address\fR +and +\fBaddr\->length\fR +indicates the size in bytes of the address that was copied. +\fBb\->current\fR +is advanced to point at the next byte of available data in the buffer following the encoded address. .PP - \fBlwres_getaddrsbyname()\fR and \fBlwres_getnamebyaddr()\fR use the \fBlwres_gnbaresponse_t\fR structure defined below: +\fBlwres_getaddrsbyname()\fR +and +\fBlwres_getnamebyaddr()\fR +use the +\fBlwres_gnbaresponse_t\fR +structure defined below: +.sp .nf typedef struct { lwres_uint32_t flags; @@ -72,20 +85,76 @@ typedef struct { size_t baselen; } lwres_gabnresponse_t; .fi - The contents of this structure are not manipulated directly but they are controlled through the \fBlwres_gabn\fR(3 ) functions\&. +.sp +The contents of this structure are not manipulated directly but they are controlled through the +\fBlwres_gabn\fR(3 ) +functions. .PP -The lightweight resolver uses \fBlwres_getaddrsbyname()\fR to perform foward lookups\&. Hostname \fIname\fR is looked up using the resolver context \fIctx\fR for memory allocation\&. \fIaddrtypes\fR is a bitmask indicating which type of addresses are to be looked up\&. Current values for this bitmask are \fBLWRES_ADDRTYPE_V4\fR for IPv4 addresses and \fBLWRES_ADDRTYPE_V6\fR for IPv6 addresses\&. Results of the lookup are returned in \fI*structp\fR\&. +The lightweight resolver uses +\fBlwres_getaddrsbyname()\fR +to perform foward lookups. Hostname +\fIname\fR +is looked up using the resolver context +\fIctx\fR +for memory allocation. +\fIaddrtypes\fR +is a bitmask indicating which type of addresses are to be looked up. Current values for this bitmask are +\fBLWRES_ADDRTYPE_V4\fR +for IPv4 addresses and +\fBLWRES_ADDRTYPE_V6\fR +for IPv6 addresses. Results of the lookup are returned in +\fI*structp\fR. .PP - \fBlwres_getnamebyaddr()\fR performs reverse lookups\&. Resolver context \fIctx\fR is used for memory allocation\&. The address type is indicated by \fIaddrtype\fR: \fBLWRES_ADDRTYPE_V4\fR or \fBLWRES_ADDRTYPE_V6\fR\&. The address to be looked up is given by \fIaddr\fR and its length is \fIaddrlen\fR bytes\&. The result of the function call is made available through \fI*structp\fR\&. +\fBlwres_getnamebyaddr()\fR +performs reverse lookups. Resolver context +\fIctx\fR +is used for memory allocation. The address type is indicated by +\fIaddrtype\fR: +\fBLWRES_ADDRTYPE_V4\fR +or +\fBLWRES_ADDRTYPE_V6\fR. The address to be looked up is given by +\fIaddr\fR +and its length is +\fIaddrlen\fR +bytes. The result of the function call is made available through +\fI*structp\fR. .SH "RETURN VALUES" .PP -Successful calls to \fBlwres_string_parse()\fR and \fBlwres_addr_parse()\fR return \fBLWRES_R_SUCCESS\&.\fR Both functions return \fBLWRES_R_FAILURE\fR if the buffer is corrupt or \fBLWRES_R_UNEXPECTEDEND\fR if the buffer has less space than expected for the components of the encoded string or address\&. +Successful calls to +\fBlwres_string_parse()\fR +and +\fBlwres_addr_parse()\fR +return +\fBLWRES_R_SUCCESS.\fR +Both functions return +\fBLWRES_R_FAILURE\fR +if the buffer is corrupt or +\fBLWRES_R_UNEXPECTEDEND\fR +if the buffer has less space than expected for the components of the encoded string or address. .PP - \fBlwres_getaddrsbyname()\fR returns \fBLWRES_R_SUCCESS\fR on success and it returns \fBLWRES_R_NOTFOUND\fR if the hostname \fIname\fR could not be found\&. +\fBlwres_getaddrsbyname()\fR +returns +\fBLWRES_R_SUCCESS\fR +on success and it returns +\fBLWRES_R_NOTFOUND\fR +if the hostname +\fIname\fR +could not be found. .PP - \fBLWRES_R_SUCCESS\fR is returned by a successful call to \fBlwres_getnamebyaddr()\fR\&. +\fBLWRES_R_SUCCESS\fR +is returned by a successful call to +\fBlwres_getnamebyaddr()\fR. .PP -Both \fBlwres_getaddrsbyname()\fR and \fBlwres_getnamebyaddr()\fR return \fBLWRES_R_NOMEMORY\fR when memory allocation requests fail and \fBLWRES_R_UNEXPECTEDEND\fR if the buffers used for sending queries and receiving replies are too small\&. +Both +\fBlwres_getaddrsbyname()\fR +and +\fBlwres_getnamebyaddr()\fR +return +\fBLWRES_R_NOMEMORY\fR +when memory allocation requests fail and +\fBLWRES_R_UNEXPECTEDEND\fR +if the buffers used for sending queries and receiving replies are too small. .SH "SEE ALSO" .PP - \fBlwres_buffer\fR(3), \fBlwres_gabn\fR(3)\&. +\fBlwres_buffer\fR(3), +\fBlwres_gabn\fR(3). diff --git a/lib/lwres/man/lwres_resutil.html b/lib/lwres/man/lwres_resutil.html index d34a6a4e..4cee0c78 100644 --- a/lib/lwres/man/lwres_resutil.html +++ b/lib/lwres/man/lwres_resutil.html @@ -14,15 +14,15 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> -<!-- $Id: lwres_resutil.html,v 1.8.2.1.4.7 2005/07/18 02:36:54 marka Exp $ --> +<!-- $Id: lwres_resutil.html,v 1.8.2.1.4.9 2005/10/13 02:33:58 marka Exp $ --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>lwres_resutil</title> -<meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> +<meta name="generator" content="DocBook XSL Stylesheets V1.69.1"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"> -<a name="id2456972"></a><div class="titlepage"></div> +<a name="id2463721"></a><div class="titlepage"></div> <div class="refnamediv"> <h2>Name</h2> <p>lwres_string_parse, lwres_addr_parse, lwres_getaddrsbyname, lwres_getnamebyaddr — lightweight resolver utility functions</p> @@ -124,7 +124,7 @@ lwres_result_t </div> </div> <div class="refsect1" lang="en"> -<a name="id2514603"></a><h2>DESCRIPTION</h2> +<a name="id2525921"></a><h2>DESCRIPTION</h2> <p> <code class="function">lwres_string_parse()</code> retrieves a DNS-encoded string starting the current pointer of lightweight resolver buffer @@ -200,7 +200,7 @@ is made available through <em class="parameter"><code>*structp</code></em>. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514880"></a><h2>RETURN VALUES</h2> +<a name="id2526060"></a><h2>RETURN VALUES</h2> <p> Successful calls to <code class="function">lwres_string_parse()</code> @@ -244,7 +244,7 @@ small. </p> </div> <div class="refsect1" lang="en"> -<a name="id2514949"></a><h2>SEE ALSO</h2> +<a name="id2526130"></a><h2>SEE ALSO</h2> <p> <span class="citerefentry"><span class="refentrytitle">lwres_buffer</span>(3)</span>, diff --git a/lib/lwres/print.c b/lib/lwres/print.c index 9bf3f187..15522284 100644 --- a/lib/lwres/print.c +++ b/lib/lwres/print.c @@ -15,7 +15,7 @@ * PERFORMANCE OF THIS SOFTWARE. */ -/* $Id: print.c,v 1.2.4.6 2005/06/08 02:08:31 marka Exp $ */ +/* $Id: print.c,v 1.2.4.7 2005/10/14 01:38:51 marka Exp $ */ #include <config.h> @@ -72,7 +72,6 @@ lwres__print_vsnprintf(char *str, size_t size, const char *format, va_list ap) { int left; int plus; int space; - int neg; long long tmpi; unsigned long long tmpui; unsigned long width; @@ -112,7 +111,7 @@ lwres__print_vsnprintf(char *str, size_t size, const char *format, va_list ap) { /* * Reset flags. */ - dot = neg = space = plus = left = zero = alt = h = l = q = 0; + dot = space = plus = left = zero = alt = h = l = q = 0; width = precision = 0; head = ""; length = pad = zeropad = 0; @@ -1,4 +1,4 @@ -# $Id: version,v 1.26.2.17.2.18 2005/06/20 03:26:01 marka Exp $ +# $Id: version,v 1.26.2.17.2.19 2005/10/11 23:26:02 marka Exp $ # # This file must follow /bin/sh rules. It is imported directly via # configure. @@ -7,4 +7,4 @@ MAJORVER=9 MINORVER=3 PATCHVER=2 RELEASETYPE=b -RELEASEVER=1 +RELEASEVER=2 |