Bug 75997

Summary:	Handbook section on DNS needs updating
Product:	Documentation	Reporter:	krunkalot <krunkalot>
Component:	Books & Articles	Assignee:	jcamou
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description krunkalot 2005-01-09 17:20:21 UTC

The DNS section is incorrect in a couple of areas. Those I have noted are: 
1) The configuration tool is now rndc not ndc
2) No mention of setting up rndc in named.conf. Produces an error of:
rndc: connect failed: connection refused
3) sh make-localhost does not create localhost.rev in /etc/namedb but in /etc/namedb/master

Fix: 

update the handbook

Comment 1 Matteo Riondato freebsd_committer

2005-06-22 13:04:53 UTC

About 1): According to the rndc(8), this utility does not yet support
all the commands of the BIND 8 ndc utility so I would not change this
yet

About 2): I didn't get it. Can you please explain this again? Thanks.

About 3): Patch follows (can be found at
http://people.freebsd.org/~matteo/diff/handbook-dns.diff)

--- chapter.sgml.orig	Wed Jun 22 13:24:38 2005
+++ chapter.sgml	Wed Jun 22 13:40:35 2005
@@ -3236,7 +3236,7 @@
         <screen>&prompt.root; <userinput>cd /etc/namedb</userinput>
 &prompt.root; <userinput>sh make-localhost</userinput></screen>
         <para>to properly create the local reverse DNS zone file in
-          <filename>/etc/namedb/localhost.rev</filename>.
+          <filename>/etc/namedb/master/localhost.rev</filename>.
         </para>
       </sect3>
 
@@ -3728,7 +3728,7 @@
 &prompt.root; <userinput>mv named.conf etc && ln -sf etc/named.conf</userinput>
 &prompt.root; <userinput>mv named.root master</userinput>
 <!-- I don't like this next bit -->
-&prompt.root; <userinput>sh make-localhost && mv localhost.rev localhost-v6.rev master</userinput>
+&prompt.root; <userinput>sh make-localhost</userinput>
 &prompt.root; <userinput>cat > master/named.localhost
 $ORIGIN localhost.
 $TTL 6h

Hope someone will commit this.
Best Regards
-- 
Matteo Riondato
FreeBSD Volunteer (http://freebsd.org)
G.U.F.I. Staff Member (http://www.gufi.org)
FreeSBIE Developer (http://www.freesbie.org)

Comment 2 jcamou freebsd_committer

2005-06-22 22:28:43 UTC

Responsible Changed
From-To: freebsd-doc->jcamou

Take it, I'm working on it.

Comment 3 jcamou freebsd_committer

2005-06-25 00:47:56 UTC

State Changed
From-To: open->closed

Some of the changes on this pr have been committed, thanks 
Matteo for generating the patch and thanks to the submitter 
for letting us know.