From ddf779ee2d2314950b8f5ce026fe89acc71d38c7 Mon Sep 17 00:00:00 2001 From: Mark Andrews Date: Wed, 9 May 2007 03:32:36 +0000 Subject: [PATCH] regen --- bin/check/named-checkconf.8 | 6 ++-- bin/check/named-checkconf.html | 6 ++-- bin/check/named-checkzone.8 | 4 +-- bin/check/named-checkzone.html | 4 +-- bin/dig/dig.1 | 20 +++++------ bin/dig/dig.html | 28 ++++++++-------- bin/dig/host.1 | 6 ++-- bin/dig/host.html | 6 ++-- bin/dig/nslookup.1 | 6 ++-- bin/dig/nslookup.html | 12 +++---- bin/dnssec/dnssec-keygen.8 | 12 +++---- bin/dnssec/dnssec-keygen.html | 16 ++++----- bin/dnssec/dnssec-signzone.8 | 41 +++++++++++++++-------- bin/dnssec/dnssec-signzone.html | 59 ++++++++++++++++++--------------- bin/named/lwresd.8 | 8 ++--- bin/named/lwresd.html | 8 ++--- bin/named/named.8 | 12 +++---- bin/named/named.conf.5 | 4 +-- bin/named/named.conf.html | 4 +-- bin/named/named.html | 12 +++---- bin/nsupdate/nsupdate.8 | 18 +++++----- bin/nsupdate/nsupdate.html | 20 +++++------ bin/rndc/rndc.8 | 4 +-- bin/rndc/rndc.conf.5 | 4 +-- bin/rndc/rndc.conf.html | 4 +-- bin/rndc/rndc.html | 4 +-- 26 files changed, 174 insertions(+), 154 deletions(-) diff --git a/bin/check/named-checkconf.8 b/bin/check/named-checkconf.8 index d604276281..49a2692fbf 100644 --- a/bin/check/named-checkconf.8 +++ b/bin/check/named-checkconf.8 @@ -13,7 +13,7 @@ .\" 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.11 2007/01/18 04:20:22 marka Exp $ +.\" $Id: named-checkconf.8,v 1.11.12.12 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -42,7 +42,7 @@ checks the syntax, but not the semantics, of a named configuration file. .PP \-t \fIdirectory\fR .RS 4 -chroot to +Chroot to \fIdirectory\fR so that include directives in the configuration file are processed as if run by a similarly chrooted named. .RE @@ -56,7 +56,7 @@ program and exit. .PP \-z .RS 4 -Perform a check load the master zonefiles found in +Perform a test load of all master zones found in \fInamed.conf\fR. .RE .PP diff --git a/bin/check/named-checkconf.html b/bin/check/named-checkconf.html index 57a1b5c09f..737d6883df 100644 --- a/bin/check/named-checkconf.html +++ b/bin/check/named-checkconf.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -43,7 +43,7 @@
-t directory

- chroot to directory so that include + Chroot to directory so that include directives in the configuration file are processed as if run by a similarly chrooted named.

@@ -54,7 +54,7 @@

-z

- Perform a check load the master zonefiles found in + Perform a test load of all master zones found in named.conf.

-j
diff --git a/bin/check/named-checkzone.8 b/bin/check/named-checkzone.8 index fe47bd3825..3f412a50f3 100644 --- a/bin/check/named-checkzone.8 +++ b/bin/check/named-checkzone.8 @@ -13,7 +13,7 @@ .\" 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.14 2007/01/18 04:20:22 marka Exp $ +.\" $Id: named-checkzone.8,v 1.11.2.1.8.15 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -99,7 +99,7 @@ Write zone output to .PP \-t \fIdirectory\fR .RS 4 -chroot to +Chroot to \fIdirectory\fR so that include directives in the configuration file are processed as if run by a similarly chrooted named. .RE diff --git a/bin/check/named-checkzone.html b/bin/check/named-checkzone.html index d89f2564c7..c02de475c4 100644 --- a/bin/check/named-checkzone.html +++ b/bin/check/named-checkzone.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -85,7 +85,7 @@

-t directory

- chroot to directory so that include + Chroot to directory so that include directives in the configuration file are processed as if run by a similarly chrooted named.

diff --git a/bin/dig/dig.1 b/bin/dig/dig.1 index 8f34010a9d..6ea4fb73af 100644 --- a/bin/dig/dig.1 +++ b/bin/dig/dig.1 @@ -13,7 +13,7 @@ .\" 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.15 2007/01/30 00:11:47 marka Exp $ +.\" $Id: dig.1,v 1.14.2.4.2.16 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -50,7 +50,7 @@ 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 +option is given. Unlike earlier versions, the BIND 9 implementation of \fBdig\fR allows multiple lookups to be issued from the command line. .PP @@ -133,7 +133,7 @@ The 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 +\fIfilename\fR. The file contains a number of queries, one per line. Each entry in the file should be organized in the same way they would be presented as queries to \fBdig\fR using the command\-line interface. .PP @@ -158,7 +158,7 @@ to only use IPv6 query transport. 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 +\fItype\fR. It can be any valid query type which is supported in BIND 9. 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 @@ -166,7 +166,7 @@ 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 +Reverse lookups \(em mapping addresses to names \(em are simplified by the \fB\-x\fR option. \fIaddr\fR @@ -217,7 +217,7 @@ to negate the meaning of that keyword. Other keywords assign values to options l .PP \fB+[no]tcp\fR .RS 4 -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 behavior is to use UDP unless an AXFR or IXFR query is requested, in which case a TCP connection is used. .RE .PP \fB+[no]vc\fR @@ -338,7 +338,7 @@ Toggle the display of comment lines in the output. The default is to print comme .PP \fB+[no]stats\fR .RS 4 -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 behavior is to print the query statistics. .RE .PP \fB+[no]qr\fR @@ -375,7 +375,7 @@ Set or clear all display flags. .RS 4 Sets the timeout for a query to \fIT\fR -seconds. The default time out is 5 seconds. An attempt to set +seconds. The default timeout is 5 seconds. An attempt to set \fIT\fR to less than 1 will result in a query timeout of 1 second being applied. .RE @@ -428,7 +428,7 @@ output. .PP \fB+[no]fail\fR .RS 4 -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 behavior. .RE .PP \fB+[no]besteffort\fR @@ -464,7 +464,7 @@ Requires dig be compiled with \-DDIG_SIGCHASE. .PP \fB+[no]topdown\fR .RS 4 -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. .RE .SH "MULTIPLE QUERIES" .PP diff --git a/bin/dig/dig.html b/bin/dig/dig.html index fa1065427e..0c171cb107 100644 --- a/bin/dig/dig.html +++ b/bin/dig/dig.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -49,7 +49,7 @@ Although dig is normally used with 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 -h option is given. -Unlike earlier versions, the BIND9 implementation of +Unlike earlier versions, the BIND 9 implementation of dig allows multiple lookups to be issued from the command line.

@@ -129,7 +129,7 @@ class, such as HS for Hesiod records or CH for CHAOSNET records. The -f option makes dig operate in batch mode by reading a list of lookup requests to process from the file filename. The file contains a number of -queries, one per line. Each entry in the file should be organised in +queries, one per line. Each entry in the file should be organized in the same way they would be presented as queries to dig using the command-line interface.

@@ -149,7 +149,7 @@ use IPv4 query transport. The -6 option forces

The -t option sets the query type to type. It can be any valid query type which is -supported in BIND9. The default query type "A", unless the +supported in BIND 9. The default query type "A", unless the -x 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, @@ -159,7 +159,7 @@ since the serial number in the zone's SOA record was N.

-Reverse lookups - mapping addresses to names - are simplified by the +Reverse lookups — mapping addresses to names — are simplified by the -x option. addr 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 @@ -215,7 +215,7 @@ The query options are:

+[no]tcp

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 +behavior is to use UDP unless an AXFR or IXFR query is requested, in which case a TCP connection is used.

+[no]vc
@@ -325,7 +325,7 @@ print comments.
+[no]stats

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 +was made, the size of the reply and so on. The default behavior is to print the query statistics.

+[no]qr
@@ -361,7 +361,7 @@ Set or clear all display flags.

Sets the timeout for a query to -T seconds. The default time out is 5 seconds. +T seconds. The default timeout is 5 seconds. An attempt to set T to less than 1 will result in a query timeout of 1 second being applied.

@@ -408,7 +408,7 @@ of the dig output.

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. +behavior.

+[no]besteffort

@@ -443,7 +443,7 @@ Chase DNSSEC signature chains. Requires dig be compiled with

+[no]topdown

-When chasing DNSSEC signature chains perform a top down validation. +When chasing DNSSEC signature chains perform a top-down validation. Requires dig be compiled with -DDIG_SIGCHASE.

@@ -452,7 +452,7 @@ Requires dig be compiled with -DDIG_SIGCHASE.

-

MULTIPLE QUERIES

+

MULTIPLE QUERIES

The BIND 9 implementation of dig supports specifying multiple queries on the command line (in addition to @@ -493,7 +493,7 @@ will not print the initial query when it looks up the NS records for

-

FILES

+

FILES

/etc/resolv.conf

@@ -502,7 +502,7 @@ will not print the initial query when it looks up the NS records for

-

SEE ALSO

+

SEE ALSO

host(1), named(8), @@ -511,7 +511,7 @@ will not print the initial query when it looks up the NS records for

-

BUGS

+

BUGS

There are probably too many query options.

diff --git a/bin/dig/host.1 b/bin/dig/host.1 index 9a3bb19058..2d1687a687 100644 --- a/bin/dig/host.1 +++ b/bin/dig/host.1 @@ -13,7 +13,7 @@ .\" 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.11 2007/01/18 04:20:22 marka Exp $ +.\" $Id: host.1,v 1.11.2.1.4.12 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -130,7 +130,7 @@ makes. This should mean that the name server receiving the query will not attemp \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. +to mimic the behavior 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 @@ -152,7 +152,7 @@ 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, +can be any recognized 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 diff --git a/bin/dig/host.html b/bin/dig/host.html index 686c6f863e..07c930550f 100644 --- a/bin/dig/host.html +++ b/bin/dig/host.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -114,7 +114,7 @@ desired — bit in the query which hostname. The -r option enables host to mimic -the behaviour of a name server by making non-recursive queries and +the behavior 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.

@@ -131,7 +131,7 @@ use IPv4 query transport. The -6 option forces

The -t option is used to select the query type. -type can be any recognised query type: CNAME, +type can be any recognized query type: CNAME, NS, SOA, SIG, KEY, AXFR, etc. When no query type is specified, host automatically selects an appropriate query type. By default it looks for A records, but if the diff --git a/bin/dig/nslookup.1 b/bin/dig/nslookup.1 index 514b1de0aa..3c051f310b 100644 --- a/bin/dig/nslookup.1 +++ b/bin/dig/nslookup.1 @@ -12,7 +12,7 @@ .\" 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.10 2007/01/30 00:11:47 marka Exp $ +.\" $Id: nslookup.1,v 1.1.6.11 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -158,7 +158,7 @@ The class specifies the protocol group of the information. .PP \fB\fI[no]\fR\fR\fBdebug\fR .RS 4 -Turn debugging mode on. A lot more information is printed about the packet sent to the server and the resulting answer. +Turn on or off the display of the full response packet and any intermediate response packets when searching. .sp (Default = nodebug; abbreviation = [no]deb) @@ -166,7 +166,7 @@ Turn debugging mode on. A lot more information is printed about the packet sent .PP \fB\fI[no]\fR\fR\fBd2\fR .RS 4 -Turn debugging mode on. A lot more information is printed about the packet sent to the server and the resulting answer. +Turn debugging mode on or off. This displays more about about what nslookup is doing. .sp (Default = nod2) .RE diff --git a/bin/dig/nslookup.html b/bin/dig/nslookup.html index 7575dcef05..b4271f7b25 100644 --- a/bin/dig/nslookup.html +++ b/bin/dig/nslookup.html @@ -13,7 +13,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -151,9 +151,8 @@ the lookups. Valid keywords are:

[no]debug

- Turn debugging mode on. A lot more information is - printed about the packet sent to the server and the - resulting answer. + Turn on or off the display of the full response packet and + any intermediate response packets when searching.

(Default = nodebug; abbreviation = [no]deb) @@ -162,9 +161,8 @@ the lookups. Valid keywords are:

[no]d2

- Turn debugging mode on. A lot more information is - printed about the packet sent to the server and the - resulting answer. + Turn debugging mode on or off. This displays more about + about what nslookup is doing.

(Default = nod2) diff --git a/bin/dnssec/dnssec-keygen.8 b/bin/dnssec/dnssec-keygen.8 index 130e3e5584..877ac07829 100644 --- a/bin/dnssec/dnssec-keygen.8 +++ b/bin/dnssec/dnssec-keygen.8 @@ -13,7 +13,7 @@ .\" 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.12 2007/01/30 00:11:47 marka Exp $ +.\" $Id: dnssec-keygen.8,v 1.19.12.13 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -37,7 +37,7 @@ dnssec\-keygen \- DNSSEC key generation tool .SH "DESCRIPTION" .PP \fBdnssec\-keygen\fR -generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC . It can also generate keys for use with TSIG (Transaction Signatures), as defined in RFC 2845. +generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC 4034. It can also generate keys for use with TSIG (Transaction Signatures), as defined in RFC 2845. .SH "OPTIONS" .PP \-a \fIalgorithm\fR @@ -147,7 +147,7 @@ is the numeric representation of the algorithm. is the key identifier (or footprint). .PP \fBdnssec\-keygen\fR -creates two file, with names based on the printed string. +creates two files, with names based on the printed string. \fIKnnnn.+aaa+iiiii.key\fR contains the public key, and \fIKnnnn.+aaa+iiiii.private\fR @@ -159,13 +159,13 @@ file contains a DNS KEY record that can be inserted into a zone file (directly o .PP The \fI.private\fR -file contains algorithm specific fields. For obvious security reasons, this file does not have general read permission. +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. +files are generated for symmetric encryption algorithms 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 @@ -182,7 +182,7 @@ In this example, creates the files \fIKexample.com.+003+26160.key\fR and -\fIKexample.com.+003+26160.private\fR +\fIKexample.com.+003+26160.private\fR. .SH "SEE ALSO" .PP \fBdnssec\-signzone\fR(8), diff --git a/bin/dnssec/dnssec-keygen.html b/bin/dnssec/dnssec-keygen.html index 8c6c98eff8..6d3cc83f5d 100644 --- a/bin/dnssec/dnssec-keygen.html +++ b/bin/dnssec/dnssec-keygen.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -35,7 +35,7 @@

DESCRIPTION

dnssec-keygen generates keys for DNSSEC - (Secure DNS), as defined in RFC 2535 and RFC <TBA\>. It can also generate + (Secure DNS), as defined in RFC 2535 and RFC 4034. It can also generate keys for use with TSIG (Transaction Signatures), as defined in RFC 2845.

@@ -164,7 +164,7 @@

- dnssec-keygen creates two file, with names based + dnssec-keygen creates two files, with names based on the printed string. Knnnn.+aaa+iiiii.key contains the public key, and Knnnn.+aaa+iiiii.private contains the private @@ -176,18 +176,18 @@ statement).

- The .private file contains algorithm specific + The .private file contains algorithm-specific fields. For obvious security reasons, this file does not have general read permission.

Both .key and .private - files are generated for symmetric encryption algorithm such as + files are generated for symmetric encryption algorithms such as HMAC-MD5, even though the public and private key are equivalent.

-

EXAMPLE

+

EXAMPLE

To generate a 768-bit DSA key for the domain example.com, the following command would be @@ -205,11 +205,11 @@

In this example, dnssec-keygen creates the files Kexample.com.+003+26160.key and - Kexample.com.+003+26160.private + Kexample.com.+003+26160.private.

-

SEE ALSO

+

SEE ALSO

dnssec-signzone(8), BIND 9 Administrator Reference Manual, diff --git a/bin/dnssec/dnssec-signzone.8 b/bin/dnssec/dnssec-signzone.8 index 22abc8aa85..e1e88c8466 100644 --- a/bin/dnssec/dnssec-signzone.8 +++ b/bin/dnssec/dnssec-signzone.8 @@ -13,7 +13,7 @@ .\" 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.13 2007/01/30 00:11:47 marka Exp $ +.\" $Id: dnssec-signzone.8,v 1.23.2.1.4.14 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -95,7 +95,7 @@ is specified, 30 days from the start time is used as a default. .RS 4 The name of the output file containing the signed zone. The default is to append \fI.signed\fR -to the input file. +to the input filename. .RE .PP \-h @@ -106,7 +106,7 @@ Prints a short summary of the options and arguments to .PP \-i \fIinterval\fR .RS 4 -When a previously signed zone is passed as input, records may be resigned. The +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 @@ -167,29 +167,44 @@ The file containing the zone to be signed. .PP key .RS 4 -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. +Specify which keys should be used to sign the zone. If no keys are specified, then the zone will be examined for DNSKEY records at the zone apex. If these are found and there are matching private keys, in the current directory, then these will be used for signing. .RE .SH "EXAMPLE" .PP The following command signs the \fBexample.com\fR -zone with the DSA key generated in the +zone with the DSA key generated by \fBdnssec\-keygen\fR -man page. The zone's keys must be in the zone. If there are +(Kexample.com.+003+17247). The zone's keys must be in the master file (\fIdb.example.com\fR). This invocation looks for \fIkeyset\fR -files associated with child zones, they must be in the current directory. -\fBexample.com\fR, the following command would be issued: +files, in the current directory, so that DS records can be generated from them (\fB\-g\fR). +.sp +.RS 4 +.nf +% dnssec\-signzone \-g \-o example.com db.example.com \\ +Kexample.com.+003+17247 +db.example.com.signed +% +.fi +.RE .PP -\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, +In the above 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. +.PP +This example re\-signs a previously signed zone with default parameters. The private keys are assumed to be in the current directory. +.sp +.RS 4 +.nf +% cp db.example.com.signed db.example.com +% dnssec\-signzone \-o example.com db.example.com +db.example.com.signed +% +.fi +.RE .SH "SEE ALSO" .PP \fBdnssec\-keygen\fR(8), diff --git a/bin/dnssec/dnssec-signzone.html b/bin/dnssec/dnssec-signzone.html index 959c5c91ab..b3d00ce0f0 100644 --- a/bin/dnssec/dnssec-signzone.html +++ b/bin/dnssec/dnssec-signzone.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -98,7 +98,7 @@

The name of the output file containing the signed zone. The default is to append .signed to the - input file. + input filename.

-h

@@ -108,7 +108,7 @@

-i interval

- When a previously signed zone is passed as input, records + When a previously-signed zone is passed as input, records may be resigned. The interval option specifies the cycle interval as an offset from the current time (in seconds). If a RRSIG record expires after the @@ -172,38 +172,45 @@

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. + Specify which keys should be used to sign the zone. If + no keys are specified, then the zone will be examined + for DNSKEY records at the zone apex. If these are found and + there are matching private keys, in the current directory, + then these will be used for signing.

-

EXAMPLE

+

EXAMPLE

- The following command signs the example.com - zone with the DSA key generated in the dnssec-keygen - man page. The zone's keys must be in the zone. If there are - keyset files associated with child zones, - they must be in the current directory. - example.com, the following command would be - issued: + The following command signs the example.com + zone with the DSA key generated by dnssec-keygen + (Kexample.com.+003+17247). The zone's keys must be in the master + file (db.example.com). This invocation looks + for keyset files, in the current directory, + so that DS records can be generated from them (-g). +

+
% dnssec-signzone -g -o example.com db.example.com \
+Kexample.com.+003+17247
+db.example.com.signed
+%
+

+ In the above example, dnssec-signzone creates + the file db.example.com.signed. This + file should be referenced in a zone statement in a + named.conf file.

- dnssec-signzone -o example.com db.example.com Kexample.com.+003+26160 -

-

- The command would print a string of the form: -

-

- In this example, dnssec-signzone creates - the file db.example.com.signed. This file - should be referenced in a zone statement in a - named.conf file. + This example re-signs a previously signed zone with default parameters. + The private keys are assumed to be in the current directory.

+
% cp db.example.com.signed db.example.com
+% dnssec-signzone -o example.com db.example.com
+db.example.com.signed
+%
-

SEE ALSO

+

SEE ALSO

dnssec-keygen(8), BIND 9 Administrator Reference Manual, @@ -211,7 +218,7 @@

-

AUTHOR

+

AUTHOR

Internet Systems Consortium

diff --git a/bin/named/lwresd.8 b/bin/named/lwresd.8 index 1fa4966f6d..a5f9d72017 100644 --- a/bin/named/lwresd.8 +++ b/bin/named/lwresd.8 @@ -13,7 +13,7 @@ .\" 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.8 2007/01/30 00:11:47 marka Exp $ +.\" $Id: lwresd.8,v 1.13.208.9 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -122,7 +122,7 @@ This option is mainly of interest to BIND 9 developers and may be removed or cha .PP \-t \fIdirectory\fR .RS 4 -\fBchroot()\fR +\fBChroot\fR to \fIdirectory\fR after processing the command line arguments, but before reading the configuration file. @@ -131,14 +131,14 @@ after processing the command line arguments, but before reading the configuratio 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 +\fBchroot(2)\fR is defined allows a process with root privileges to escape a chroot jail. .RE .RE .PP \-u \fIuser\fR .RS 4 -\fBsetuid()\fR +\fBSetuid\fR to \fIuser\fR after completing privileged operations, such as creating sockets that listen on privileged ports. diff --git a/bin/named/lwresd.html b/bin/named/lwresd.html index b54160dbb9..04159bc0da 100644 --- a/bin/named/lwresd.html +++ b/bin/named/lwresd.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -130,7 +130,7 @@
-t directory

- chroot() to directory after + Chroot to directory after processing the command line arguments, but before reading the configuration file.

@@ -140,7 +140,7 @@ This option should be used in conjunction with the -u option, as chrooting a process running as root doesn't enhance security on most - systems; the way chroot() is + systems; the way chroot(2) is defined allows a process with root privileges to escape a chroot jail.

@@ -148,7 +148,7 @@
-u user

- setuid() to user after completing + Setuid to user after completing privileged operations, such as creating sockets that listen on privileged ports.

diff --git a/bin/named/named.8 b/bin/named/named.8 index 612dddad55..bbf02f9579 100644 --- a/bin/named/named.8 +++ b/bin/named/named.8 @@ -13,7 +13,7 @@ .\" 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.11 2007/01/30 00:11:47 marka Exp $ +.\" $Id: named.8,v 1.17.208.12 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -122,7 +122,7 @@ This option is mainly of interest to BIND 9 developers and may be removed or cha .PP \-t \fIdirectory\fR .RS 4 -\fBchroot()\fR +\fBChroot\fR to \fIdirectory\fR after processing the command line arguments, but before reading the configuration file. @@ -131,14 +131,14 @@ after processing the command line arguments, but before reading the configuratio 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 +\fBchroot(2)\fR is defined allows a process with root privileges to escape a chroot jail. .RE .RE .PP \-u \fIuser\fR .RS 4 -\fBsetuid()\fR +\fBSetuid\fR to \fIuser\fR after completing privileged operations, such as creating sockets that listen on privileged ports. @@ -147,13 +147,13 @@ after completing privileged operations, such as creating sockets that listen on On Linux, \fBnamed\fR uses the kernel's capability mechanism to drop all root privileges except the ability to -\fBbind()\fR +\fBbind(2)\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. +\fBsetuid(2)\fR. .RE .RE .PP diff --git a/bin/named/named.conf.5 b/bin/named/named.conf.5 index ca225c6210..eeff5c5315 100644 --- a/bin/named/named.conf.5 +++ b/bin/named/named.conf.5 @@ -12,7 +12,7 @@ .\" 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.12 2007/01/30 00:11:47 marka Exp $ +.\" $Id: named.conf.5,v 1.1.4.13 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -461,7 +461,7 @@ zone \fIstring\fR \fIoptional_class\fR { .PP \fBnamed\fR(8), \fBrndc\fR(8), -\fBBIND 9 Administrator Reference Manual\fR(). +BIND 9 Administrator Reference Manual .SH "COPYRIGHT" Copyright \(co 2004\-2007 Internet Systems Consortium, Inc. ("ISC") .br diff --git a/bin/named/named.conf.html b/bin/named/named.conf.html index 8d7964fa7c..9b78c03c91 100644 --- a/bin/named/named.conf.html +++ b/bin/named/named.conf.html @@ -13,7 +13,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -494,7 +494,7 @@ zone

named(8), rndc(8), -BIND 9 Administrator Reference Manual. +BIND 9 Administrator Reference Manual

diff --git a/bin/named/named.html b/bin/named/named.html index de48cba616..7f9c08e73b 100644 --- a/bin/named/named.html +++ b/bin/named/named.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -117,7 +117,7 @@
-t directory

- chroot() to directory after + Chroot to directory after processing the command line arguments, but before reading the configuration file.

@@ -127,7 +127,7 @@ This option should be used in conjunction with the -u option, as chrooting a process running as root doesn't enhance security on most - systems; the way chroot() is + systems; the way chroot(2) is defined allows a process with root privileges to escape a chroot jail.

@@ -136,7 +136,7 @@
-u user

- setuid() to user after completing + Setuid to user after completing privileged operations, such as creating sockets that listen on privileged ports.

@@ -145,13 +145,13 @@

On Linux, named uses the kernel's capability mechanism to drop all root privileges - except the ability to bind() to a + except the ability to bind(2) to a privileged port and set process resource limits. Unfortunately, this means that the -u option only works when named 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 setuid(). + to be retained after setuid(2).

diff --git a/bin/nsupdate/nsupdate.8 b/bin/nsupdate/nsupdate.8 index 20b389b098..5d608e3565 100644 --- a/bin/nsupdate/nsupdate.8 +++ b/bin/nsupdate/nsupdate.8 @@ -13,7 +13,7 @@ .\" 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.12 2007/01/30 00:11:48 marka Exp $ +.\" $Id: nsupdate.8,v 1.24.2.2.2.13 2007/05/09 03:32:36 marka Exp $ .\" .hy 0 .ad l @@ -55,7 +55,7 @@ operate in debug mode. This provides tracing information about the update reques .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 +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 @@ -106,15 +106,15 @@ use a TCP connection. This may be preferable when a batch of update requests is .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. +option sets the maximum time an 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. +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. +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 @@ -164,13 +164,13 @@ will attempt determine the correct zone to update based on the rest of the input .RS 4 Specify the default class. If no \fIclass\fR -is specified the default class is +is specified, the default class is \fIIN\fR. .RE .PP \fBkey\fR {name} {secret} .RS 4 -Specifies that all updates are to be TSIG signed using the +Specifies that all updates are to be TSIG\-signed using the \fIkeyname\fR \fIkeysecret\fR pair. The @@ -293,9 +293,9 @@ zone. Notice that the input in each example contains a trailing blank line so th .PP Any A records for \fBoldhost.example.com\fR -are deleted. and an A record for +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) +with IP address 172.16.1.1 is added. The newly\-added record has a 1 day TTL (86400 seconds). .sp .RS 4 .nf diff --git a/bin/nsupdate/nsupdate.html b/bin/nsupdate/nsupdate.html index 5d94700900..009942d11b 100644 --- a/bin/nsupdate/nsupdate.html +++ b/bin/nsupdate/nsupdate.html @@ -14,7 +14,7 @@ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR - PERFORMANCE OF THIS SOFTWARE. --> - + @@ -77,7 +77,7 @@ 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 +For instance, suitable key and server @@ -147,16 +147,16 @@ option makes use a TCP connection. This may be preferable when a batch of update requests is made.

-

The -t option sets the maximum time a update request can +

The -t option sets the maximum time an update request can take before it is aborted. The default is 300 seconds. Zero can be used to disable the timeout.

The -u option sets the UDP retry interval. The default is -3 seconds. If zero the interval will be computed from the timeout interval +3 seconds. If zero, the interval will be computed from the timeout interval and number of UDP retries.

The -r option sets the number of UDP retries. The default is -3. If zero only one update request will be made. +3. If zero, only one update request will be made.

@@ -243,7 +243,7 @@ will attempt determine the correct zone to update based on the rest of the input

Specify the default class. -If no class is specified the default class is +If no class is specified, the default class is IN.

@@ -252,7 +252,7 @@ If no class is specified the default cla {secret}

-Specifies that all updates are to be TSIG signed using the +Specifies that all updates are to be TSIG-signed using the keyname keysecret pair. The key command overrides any key specified on the command line via @@ -424,10 +424,10 @@ master name server for Any A records for oldhost.example.com are deleted. -and an A record for +And an A record for newhost.example.com -it IP address 172.16.1.1 is added. -The newly-added record has a 1 day TTL (86400 seconds) +with IP address 172.16.1.1 is added. +The newly-added record has a 1 day TTL (86400 seconds). 

 # nsupdate
diff --git a/bin/rndc/rndc.8 b/bin/rndc/rndc.8
index df1ccd879c..1dee13ca2e 100644
--- a/bin/rndc/rndc.8
+++ b/bin/rndc/rndc.8
@@ -13,7 +13,7 @@
 .\" 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.8 2007/01/30 00:11:48 marka Exp $
+.\" $Id: rndc.8,v 1.24.206.9 2007/05/09 03:32:36 marka Exp $
 .\"
 .hy 0
 .ad l
@@ -126,7 +126,7 @@ Several error messages could be clearer.
 .PP
 \fBrndc.conf\fR(5),
 \fBnamed\fR(8),
-\fBnamed.conf\fR(5)
+\fBnamed.conf\fR(5),
 \fBndc\fR(8),
 BIND 9 Administrator Reference Manual.
 .SH "AUTHOR"
diff --git a/bin/rndc/rndc.conf.5 b/bin/rndc/rndc.conf.5
index d5e05fae44..d71cc50395 100644
--- a/bin/rndc/rndc.conf.5
+++ b/bin/rndc/rndc.conf.5
@@ -13,7 +13,7 @@
 .\" 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.8 2007/01/30 00:11:48 marka Exp $
+.\" $Id: rndc.conf.5,v 1.21.206.9 2007/05/09 03:32:36 marka Exp $
 .\"
 .hy 0
 .ad l
@@ -128,7 +128,7 @@ To generate a random secret with
 .PP
 A complete
 \fIrndc.conf\fR
-file, including the randomly generated key, will be written to the standard output. Commented out
+file, including the randomly generated key, will be written to the standard output. Commented\-out
 \fBkey\fR
 and
 \fBcontrols\fR
diff --git a/bin/rndc/rndc.conf.html b/bin/rndc/rndc.conf.html
index d55d9c1499..2bf728e106 100644
--- a/bin/rndc/rndc.conf.html
+++ b/bin/rndc/rndc.conf.html
@@ -14,7 +14,7 @@
  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  - PERFORMANCE OF THIS SOFTWARE.
 -->
-
+
 
 
 
@@ -139,7 +139,7 @@
 

         A complete rndc.conf file, including the
         randomly generated key, will be written to the standard
-        output.  Commented out key and
+        output.  Commented-out key and
         controls statements for
         named.conf are also printed.
     

diff --git a/bin/rndc/rndc.html b/bin/rndc/rndc.html
index 831a1204b5..b1e397ddb2 100644
--- a/bin/rndc/rndc.html
+++ b/bin/rndc/rndc.html
@@ -14,7 +14,7 @@
  - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  - PERFORMANCE OF THIS SOFTWARE.
 -->
-
+
 
 
 
@@ -141,7 +141,7 @@
 

       rndc.conf(5),
       named(8),
-      named.conf(5)
+      named.conf(5),
       ndc(8),
       BIND 9 Administrator Reference Manual.