From 25c8119fc7b6a38dfcdf421a5510e36a1b940789 Mon Sep 17 00:00:00 2001 From: Jilles Tjoelker 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 a5ae1df0..fc44fb73 100644 --- a/doc/sgml/oper-guide/config.sgml +++ b/doc/sgml/oper-guide/config.sgml @@ -549,8 +549,6 @@ connect "name" { The hostname or IP to connect to. - Charybdis uses solely DNS for all hostname/address lookups - (no /etc/hosts 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 { + + Hostname resolution (DNS) + + Charybdis uses solely DNS for all hostname/address lookups + (no /etc/hosts or anything else). + The DNS servers are taken from /etc/resolv.conf. + 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.) + + + IPv4 as well as IPv6 DNS servers are supported, but it is not + possible to use both IPv4 and IPv6 in + /etc/resolv.conf. + + + 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 /etc/resolv.conf only + list 127.0.0.1. + +