]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
projects / thirdparty / bind9.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: aba1bcf)
regen
authorMark Andrews <marka@isc.org>
Fri, 18 Jun 2004 06:00:41 +0000 (06:00 +0000)
committerMark Andrews <marka@isc.org>
Fri, 18 Jun 2004 06:00:41 +0000 (06:00 +0000)
bin/rndc/rndc.conf.5 patch | blob | blame | history
bin/rndc/rndc.conf.html patch | blob | blame | history

diff --git a/bin/rndc/rndc.conf.5 b/bin/rndc/rndc.conf.5
index 06a32f90c2d3d7faac1621fdf8ce4a155117c018..06451541c6fb18b226418380f3bedd395b5217a9 100644 (file)
--- 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.26 2004/06/03 04:12:38 marka Exp $
+.\" $Id: rndc.conf.5,v 1.27 2004/06/18 06:00:41 marka Exp $
 .\"
 .TH "RNDC.CONF" "5" "June 30, 2000" "BIND9" ""
 .SH NAME
@@ -60,12 +60,15 @@ 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.
+After the \fBserver\fR keyword, the server
+statement includes a string which is the hostname or address
+for a name server. The statement has three possible clauses:
+\fBkey\fR, \fBport\fR and
+\fBaddresses\fR. The key name must match the
+name of a key statement in the file. The port number
+specifies the port to connect to. If an \fBaddresses\fR
+clause is supplied these addresses will be used instead of
+the server name. Each address can take a optional port.
 .PP
 The \fBkey\fR statement begins with an identifying
 string, the name of the key. The statement has two clauses.
@@ -86,7 +89,7 @@ EXAMPLE section for sample command lines for each.
 .SH "EXAMPLE"
 .sp
 .nf
-    options {
+      options {
         default-server  localhost;
         default-key     samplekey;
       };
@@ -95,10 +98,20 @@ EXAMPLE section for sample command lines for each.
         key             samplekey;
       };
 
+      server testserver {
+        key            testkey;
+        addresses      { localhost port 5353; };
+      };
+
       key samplekey {
         algorithm       hmac-md5;
-        secret          "c3Ryb25nIGVub3VnaCBmb3IgYSBtYW4gYnV0IG1hZGUgZm9yIGEgd29tYW4K";
+        secret          "6FMfj43Osz4lyb24OIe2iGEz9lf1llJO+lz";
       };
+       
+      key testkey {
+        algorithm      hmac-md5;
+        secret         "R3HI8P6BKw9ZwXwN3VZKuQ==";
+      }
     
 .sp
 .fi
@@ -111,6 +124,9 @@ 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
+If \fBrndc -s testserver\fR is used then \fBrndc\fR will
+connect to server on localhost port 5353 using the key testkey.
+.PP
 To generate a random secret with \fBrndc-confgen\fR:
 .PP
 \fBrndc-confgen\fR
diff --git a/bin/rndc/rndc.conf.html b/bin/rndc/rndc.conf.html
index 6a06eaa01f753b55de2cd469fe2414925a52ff4f..358371a939877b8c9d9003c660fbca9656c37f8d 100644 (file)
--- a/bin/rndc/rndc.conf.html
+++ b/bin/rndc/rndc.conf.html
@@ -15,7 +15,7 @@
  - PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- $Id: rndc.conf.html,v 1.9 2004/06/03 04:12:38 marka Exp $ -->
+<!-- $Id: rndc.conf.html,v 1.10 2004/06/18 06:00:41 marka Exp $ -->
 
 <HTML
 ><HEAD
@@ -166,21 +166,30 @@ CLASS="OPTION"
        will be used to connect.
     </P
 ><P
->        After the <TT
+>      After the <TT
 CLASS="OPTION"
 >server</TT
-> keyword, the server statement
-       includes a string which is the hostname or address for a name
-       server.  The statement has two possible clauses:
+> keyword, the server
+       statement includes a string which is the hostname or address
+       for a name server.  The statement has three possible clauses:
        <TT
 CLASS="OPTION"
 >key</TT
-> and <TT
+>, <TT
 CLASS="OPTION"
 >port</TT
->. The key name must
-       match the name of a key statement in the file.  The port number
-       specifies the port to connect to.
+> and
+       <TT
+CLASS="OPTION"
+>addresses</TT
+>. The key name must match the
+       name of a key statement in the file.  The port number
+       specifies the port to connect to.  If an <TT
+CLASS="OPTION"
+>addresses</TT
+>
+       clause is supplied these addresses will be used instead of
+       the server name.  Each address can take a optional port.
     </P
 ><P
 >        The <TT
@@ -226,13 +235,13 @@ CLASS="COMMAND"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN54"
+NAME="AEN56"
 ></A
 ><H2
 >EXAMPLE</H2
 ><PRE
 CLASS="PROGRAMLISTING"
->    options {
+>      options {
         default-server  localhost;
         default-key     samplekey;
       };
@@ -241,10 +250,20 @@ CLASS="PROGRAMLISTING"
         key             samplekey;
       };
 
+      server testserver {
+        key            testkey;
+        addresses      { localhost port 5353; };
+      };
+
       key samplekey {
         algorithm       hmac-md5;
-        secret          "c3Ryb25nIGVub3VnaCBmb3IgYSBtYW4gYnV0IG1hZGUgZm9yIGEgd29tYW4K";
+        secret          "6FMfj43Osz4lyb24OIe2iGEz9lf1llJO+lz";
       };
+       
+      key testkey {
+        algorithm      hmac-md5;
+        secret         "R3HI8P6BKw9ZwXwN3VZKuQ==";
+      }
     </PRE
 ><P
 >        In the above example, <B
@@ -259,6 +278,16 @@ CLASS="COMMAND"
        base-64 encoding of the HMAC-MD5 secret enclosed in double quotes.
     </P
 ><P
+>      If <B
+CLASS="COMMAND"
+>rndc -s testserver</B
+> is used then <B
+CLASS="COMMAND"
+>rndc</B
+> will
+       connect to server on localhost port 5353 using the key testkey.
+    </P
+><P
 >        To generate a random secret with <B
 CLASS="COMMAND"
 >rndc-confgen</B
@@ -309,7 +338,7 @@ CLASS="USERINPUT"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN72"
+NAME="AEN77"
 ></A
 ><H2
 >NAME SERVER CONFIGURATION</H2
@@ -333,7 +362,7 @@ CLASS="OPTION"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN78"
+NAME="AEN83"
 ></A
 ><H2
 >SEE ALSO</H2
@@ -368,7 +397,7 @@ CLASS="CITETITLE"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN91"
+NAME="AEN96"
 ></A
 ><H2
 >AUTHOR</H2
Mirror of https://gitlab.isc.org/isc-projects/bind9.git