[Pkg-utopia-maintainers] Bug#885572: man page for NetworkManager.conf: insufficient detail about global-dns section

[Daniel Pocock]

Package: network-manager
Version: 1.6.2-3

I reported[1] this upstream, maybe it could also be addressed within
README.Debian or the wiki[2]

Given that NetworkManager is meant to be GUI-oriented, it feels strange
that users have to specify search domains through a config file and even
more strange that it is not easy because of documentation.

The man page about NetworkManager.conf mentions "GLOBAL-DNS SECTION" and
"GLOBAL-DNS-DOMAIN SECTIONS" but there is not a lot of detail and no
examples.

Searching online I found examples like this:

[global-dns]
enable=yes
searches=example.org

[global-dns-domain-*]
servers=8.8.8.8,8.8.4.4

[global-dns-domain-example.org]
servers=10.0.100.1,10.0.200.1



The "enable=yes" doesn't appear to be necessary, it works without that
line for me.

It is also not clear what I should do if I only want to have "searches"
set globally but I want the DNS servers set automatically from DHCP or
other sources.

For example, I tried just setting this:


[global-dns]
searches=example.org


and not adding any global-dns-domain- sections and the searches
parameter was ignored.




1. https://bugzilla.gnome.org/show_bug.cgi?id=791849
2. https://wiki.debian.org/NetworkManager