From 40a53c07b415d1dcec3d1e10d3b67e31b5c2cefa Mon Sep 17 00:00:00 2001
From: Jilles Tjoelker <jilles@stack.nl>
Date: Thu, 10 Jul 2008 23:31:46 +0200
Subject: [PATCH] Add a DNS section to charybdis-oper-guide.

---
 doc/sgml/oper-guide/config.sgml | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/doc/sgml/oper-guide/config.sgml b/doc/sgml/oper-guide/config.sgml
index a5ae1df..fc44fb7 100644
--- a/doc/sgml/oper-guide/config.sgml
+++ b/doc/sgml/oper-guide/config.sgml
@@ -549,8 +549,6 @@ connect "<replaceable>name</replaceable>" {
 	    <listitem>
 	      <para>The hostname or IP to connect to.</para>
 	      <note><para>
-		Charybdis uses solely DNS for all hostname/address lookups
-		(no <filename>/etc/hosts</filename> or anything else).
 		Furthermore, if a hostname is used, it must have an A or AAAA
 		record (no CNAME) and it must be the primary
 		hostname for inbound connections to work.
@@ -1094,6 +1092,28 @@ service {
 	</variablelist>
       </sect2>
     </sect1>
+    <sect1>
+      <title>Hostname resolution (DNS)</title>
+      <para>
+	Charybdis uses solely DNS for all hostname/address lookups
+	(no <filename>/etc/hosts</filename> or anything else).
+	The DNS servers are taken from <filename>/etc/resolv.conf</filename>.
+	If this file does not exist or no valid IP addresses are listed in it,
+	the local host (127.0.0.1) is used. (Note that the latter part
+	did not work in older versions of Charybdis.)
+      </para>
+      <para>
+	IPv4 as well as IPv6 DNS servers are supported, but it is not
+	possible to use both IPv4 and IPv6 in
+	<filename>/etc/resolv.conf</filename>.
+      </para>
+      <para>
+	For both security and performance reasons, it is recommended
+	that a caching nameserver such as BIND be run on the same machine
+	as Charybdis and that <filename>/etc/resolv.conf</filename> only
+	list 127.0.0.1.
+      </para>
+    </sect1>
   </chapter>
 <!-- Keep this comment at the end of the file
 Local variables: