Mailinglist Archive: opensuse-bugs (4691 mails)

< Previous Next >
[Bug 580361] netconfig(8) manpage misses crucial dnsmasq setup information
  • From: bugzilla_noreply@xxxxxxxxxx
  • Date: Thu, 18 Feb 2010 11:48:16 +0000
  • Message-id: <20100218114816.A0045CC7CE@xxxxxxxxxxxxxxxxxxxxxx>
http://bugzilla.novell.com/show_bug.cgi?id=580361

http://bugzilla.novell.com/show_bug.cgi?id=580361#c1


Marius Tomaschewski <mt@xxxxxxxxxx> changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |ke@xxxxxxxxxx

--- Comment #1 from Marius Tomaschewski <mt@xxxxxxxxxx> 2010-02-18 11:48:15 UTC
---
(In reply to comment #0)

--> Pls add to the appropriate paragraph a notice for dnsmasq that
/var/run/dnsmasq-forwarders.conf will be modified instead of /etc/resolv.conf,
which should be referenced in dnsmasq with the "resolv-file" option. The same
for bind (/etc/name.d/forwarders.conf and whatever option necessary to include
that file).
[...]

The netconfig.8 IMO documents this already:

"[...]
NETCONFIG MODULES
[...]
dns-bind
This module writes the DNS nameservers as forwarders for the
bind nameserver into the /etc/named.d/forwarders.conf file.
Please verify that this file is included in the options section
of /etc/named.conf, like:
options {
#forward first;
include "/etc/named.d/forwarders.conf";
# [...]
You can use the yast2 dns-server module to configure bind as
forwarder.
[...]
dns-dnsmasq
This module writes the DNS nameservers as forwarders for the
dnsmasq nameserver into the /var/run/dnsmasq-forwarders.conf
file. Please verify, that this file is set in the resolv-file
keyword in the /etc/dnsmasq.conf.
[...]"


--> Pls add to the appropriate paragraph also a note that 127.0.0.1 should not
be declared in NETCONFIG_DNS_STATIC_SERVERS since glibc will automatically use
the local nameserver.

Yes. It is documented in "man resolv.conf", but it makes sense to add it and
filter out at least 127.0.0.1 and ::1 from dnsmasq/bind forwarders list.

BTW: We are improving the NETCONFIG_DNS_FORWARDER documentation in sysconfig
variables and the man page in bug 580506 as well. All together, I'm going to
change to:

-## Type: string
+## Type: string(resolver,bind,dnsmasq,)
## Default: "resolver"
#
# Defines the name of the DNS forwarder that has to be configured.
+# Currently implemented are "bind", "dnsmasq" and "resolver", that
+# causes to write the name server IP addresses to /etc/resolv.conf
+# only (no forwarder). Empty string defaults to "resolver".
#
NETCONFIG_DNS_FORWARDER="resolver"

## Type: string
## Default: ""
#
# List of DNS domain names used for host-name lookup.
+# It is written as search list into the /etc/resolv.conf file.
#
NETCONFIG_DNS_STATIC_SEARCHLIST=""

## Type: string
## Default: ""
#
# List of DNS nameserver IP addresses to use for host-name lookup.
+# When the NETCONFIG_DNS_FORWARDER variable is set to "resolver",
+# the name servers are written directly to /etc/resolv.conf.
+# Otherwise, the nameserver are written into a forwarder specific
+# configuration file and the /etc/resolv.conf does not contain any
+# nameservers causing the glibc to use the name server on the local
+# machine (the forwarder). See also netconfig(8) manual page.
#
NETCONFIG_DNS_STATIC_SERVERS=""

-## Type: string
+## Type: string(yes,no,)
## Default: "yes"
#
# Defines whether to set the default NIS domain. When enabled and no domain
[...]
NETCONFIG_NIS_SETDOMAINNAME="yes"

--
Configure bugmail: http://bugzilla.novell.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.

< Previous Next >
References