note that the configuration generated by rndc-confgen -a works on the local

host only (as suggested by Tale)

bin/rndc/rndc-confgen.8

@@ -46,13 +46,23 @@ 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 with no further configuration.
+\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.
 .TP
 \fB-b \fIkeysize\fB\fR
 Specifies the size of the authentication key in bits.

bin/rndc/rndc-confgen.docbook

@@ -16,7 +16,7 @@
  - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- $Id: rndc-confgen.docbook,v 1.3 2001/08/29 03:27:57 marka Exp $ -->
+<!-- $Id: rndc-confgen.docbook,v 1.4 2001/09/11 19:18:11 gson Exp $ -->
 
 <refentry>
   <refentryinfo>
@@ -86,7 +86,8 @@
 	      <filename>rndc.key</filename> file defines a default
               command channel and authentication key allowing
 	      <command>rndc</command> to communicate with
-	      <command>named</command> with no further configuration.
+	      <command>named</command> on the local host
+	      with no further configuration.  
 	  </para>
 	  <para>
 	      Running <command>rndc-confgen -a</command> allows
@@ -95,6 +96,16 @@
 	      with no changes to the existing BIND 8
 	      <filename>named.conf</filename> file.
 	  </para>
+          <para>
+	      If a more elaborate configuration than that
+	      generated by <command>rndc-confgen -a</command>
+	      is required, for example if rndc is to be used remotely,
+	      you should run <command>rndc-confgen</command> without the
+	      <command>-a</command> option and set up a
+	      <filename>rndc.conf</filename> and
+	      <filename>named.conf</filename>
+	      as directed.
+          </para>
 	</listitem>
       </varlistentry>
 

bin/rndc/rndc-confgen.html

@@ -238,7 +238,8 @@ CLASS="COMMAND"
 	      <B
 CLASS="COMMAND"
 >named</B
-> with no further configuration.
+> on the local host
+	      with no further configuration.  
 	  </P
 ><P
 >	      Running <B
@@ -259,6 +260,31 @@ CLASS="FILENAME"
 >named.conf</TT
 > file.
 	  </P
+><P
+>	      If a more elaborate configuration than that
+	      generated by <B
+CLASS="COMMAND"
+>rndc-confgen -a</B
+>
+	      is required, for example if rndc is to be used remotely,
+	      you should run <B
+CLASS="COMMAND"
+>rndc-confgen</B
+> without the
+	      <B
+CLASS="COMMAND"
+>-a</B
+> option and set up a
+	      <TT
+CLASS="FILENAME"
+>rndc.conf</TT
+> and
+	      <TT
+CLASS="FILENAME"
+>named.conf</TT
+>
+	      as directed.
+          </P
 ></DD
 ><DT
 >-b <TT
@@ -448,7 +474,7 @@ CLASS="COMMAND"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN141"
+NAME="AEN147"
 ></A
 ><H2
 >EXAMPLES</H2
@@ -497,7 +523,7 @@ CLASS="USERINPUT"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN154"
+NAME="AEN160"
 ></A
 ><H2
 >SEE ALSO</H2
@@ -532,7 +558,7 @@ CLASS="CITETITLE"
 ><DIV
 CLASS="REFSECT1"
 ><A
-NAME="AEN167"
+NAME="AEN173"
 ></A
 ><H2
 >AUTHOR</H2