diff --git a/bin/rndc/rndc.conf.5 b/bin/rndc/rndc.conf.5 index 862b6803bc..ab85fe8166 100644 --- a/bin/rndc/rndc.conf.5 +++ b/bin/rndc/rndc.conf.5 @@ -75,7 +75,7 @@ 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 \fBdnssec-keygen\fR can +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 @@ -110,21 +110,19 @@ 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 \fBdnssec-keygen\fR: +To generate a random secret with \fBrndc-confgen\fR: .PP -\fB$ dnssec-keygen -a hmac-md5 -b 128 -n user rndc\fR +\fBrndc-confgen\fR .PP -The base-64 string will appear in two files, -\fIKrndc.+157.+{random}.key\fR and -\fIKrndc.+157.+{random}.private\fR. After -extracting the key to be placed in the -\fIrndc.conf\fR and -\fInamed.conf\fR key statements, the -\&.key and .private files can be removed. +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 random secret with \fBmmencode\fR: +To generate a base-64 secret with \fBmmencode\fR: .PP -\fB$ echo "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 @@ -135,7 +133,7 @@ BIND 9 Administrator Reference Manual for details. .SH "SEE ALSO" .PP \fBrndc\fR(8), -\fBdnssec-keygen\fR(8), +\fBrndc-confgen\fR(8), \fBmmencode\fR(1), \fIBIND 9 Administrator Reference Manual\fR. .SH "AUTHOR" diff --git a/bin/rndc/rndc.conf.html b/bin/rndc/rndc.conf.html index 14fdfd2282..93dad779dc 100644 --- a/bin/rndc/rndc.conf.html +++ b/bin/rndc/rndc.conf.html @@ -201,7 +201,7 @@ CLASS="COMMAND" > There are two common ways to generate the base-64 string for the secret. The BIND 9 program dnssec-keygenrndc-confgen can be used to generate a random key, or the
To generate a random secret with dnssec-keygenrndc-confgen:
$ dnssec-keygen -a hmac-md5 -b 128 -n user rndcrndc-confgen
The base-64 string will appear in two files, - Krndc.+157.+{random}.key and - Krndc.+157.+{random}.private. After - extracting the key to be placed in the - A complete rndc.conf and - file, including the + randomly generated key, will be written to the standard + output. Commented out key and + controls statements for + named.conf key statements, the - .key and .private files can be removed. +> are also printed.
To generate a random secret with To generate a base-64 secret with mmencode: @@ -300,7 +298,7 @@ CLASS="COMMAND" > $ echo "known plaintext for a secret" | mmencodeecho "known plaintext for a secret" | mmencode
dnssec-keygenrndc-confgen(8),The pathname of the file the server writes -its process ID in. If not specified, the default is operating system -dependent, but is usually -The pathname of the file the server writes its process ID +in. If not specified, the default is /var/run/named.pid or /etc/named.pid. The pid-file is used by programs that want to send signals to the running nameserver.
Note: The address specified in the query-source currently applies only -to UDP queries; TCP queries always use a wildcard IP address and -a random unprivileged port.
option +is used for both UDP and TCP queries, but the port applies only to +UDP queries. TCP queries always use a random +unprivileged port.[RFC974] [RFC1034] [RFC1035] [RFC2181] [RFC2308] [RFC1995] [RFC1996] [RFC2136] [RFC2845] [RFC1886] [RFC2065] [RFC2137] [RFC1535] [RFC1536] [RFC1982] [RFC1183] [RFC1706] [RFC2168] [RFC1876] [RFC2052] [RFC2163] [RFC2230] [RFC1101] [RFC1123] [RFC1591] [RFC2317] [RFC1537] [RFC1912] [RFC1912] [RFC2010] [RFC2219] [RFC1464] [RFC1713] [RFC1794] [RFC2240] [RFC2345] [RFC2352] [RFC1712] Proposed Standards Still Under Development
Other Important RFCs About DNS
Resource Record Types
DNS
DNS
Other DNS
Obsolete and Unimplemented Experimental RRs
A.4.3. Other Documents About BIND
Bibliography