Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 156478

Summary: Need to clarify the useage of dns_domain_lo in the Network Section
Product: [OLD] Docs on www.gentoo.org Reporter: brianw <me>
Component: Installation HandbookAssignee: nm (RETIRED) <nightmorph>
Status: RESOLVED FIXED    
Severity: normal CC: docs-team
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---

Description brianw 2006-11-27 22:35:48 UTC
I am one of the Gentoo users who supports the many hapless souls in #gentoo on freenode. I have to help ~ 5 people a day who have no dns resolution due to setting dns_domain_lo="some_domain" in /etc/conf.d/net . It is not specified in the Handbook that if they set this /etc/resolv.conf will get overwritten, and the DNS servers handed out by their DHCP server will be overwritten as a result.

There needs to be a clarification in the handbook on the consequences of setting this directive.

Section to which I am refering:

8.b. Networking Information
Code Listing 5: Setting the domainname & Code Listing 6: Setting the NIS domainname
Comment 1 Roy Marples (RETIRED) gentoo-dev 2006-11-27 23:19:55 UTC
On the other hand if you install resolvconf-gentoo then it will manage resolv.conf for you and merge all settings. I've updated baselayout documentation for this in net.example in our svn - will be in the next release.

Maybe the docs team could include that in the handbook too?
Comment 2 nm (RETIRED) gentoo-dev 2006-11-27 23:26:42 UTC
(In reply to comment #0)
> I am one of the Gentoo users who supports the many hapless souls in #gentoo on
> freenode. I have to help ~ 5 people a day who have no dns resolution due to
> setting dns_domain_lo="some_domain" in /etc/conf.d/net . It is not specified in
> the Handbook that if they set this /etc/resolv.conf will get overwritten, and
> the DNS servers handed out by their DHCP server will be overwritten as a
> result.
No, we don't say that baselayout will screw your resolv.conf, but on the other hand, throughout that whole chapter, we constantly provide warning after warning about reading conf.d/net.example to read how to properly use DNS and other similar settings -- the example file is the appropriate place to learn about such advanced topics (and it deals more with proper DNS configuration). I will, however, add a note about emerging resolvconf-gentoo to the networked handbook.
Comment 3 brianw 2006-11-27 23:36:35 UTC
(In reply to comment #2)
> (In reply to comment #0)
> > I am one of the Gentoo users who supports the many hapless souls in #gentoo on
> > freenode. I have to help ~ 5 people a day who have no dns resolution due to
> > setting dns_domain_lo="some_domain" in /etc/conf.d/net . It is not specified in
> > the Handbook that if they set this /etc/resolv.conf will get overwritten, and
> > the DNS servers handed out by their DHCP server will be overwritten as a
> > result.
> No, we don't say that baselayout will screw your resolv.conf, but on the other
> hand, throughout that whole chapter, we constantly provide warning after
> warning about reading conf.d/net.example to read how to properly use DNS and
> other similar settings -- the example file is the appropriate place to learn
> about such advanced topics (and it deals more with proper DNS configuration). I
> will, however, add a note about emerging resolvconf-gentoo to the networked
> handbook.
> 


Yes but in the example file it does not tell people that setting dns_domain_lo will overwrite the resolv.conf file either.

Also many people do not understand networking all that well. And from the handbook, that section seems to say you need to set that dns_domain_lo ...
Comment 4 nm (RETIRED) gentoo-dev 2006-11-27 23:42:52 UTC
Added a note about emerging resolvconf-gentoo to assist with DNS/NIS management. Uberlord, any chance of getting this helpful note into the current stable baselayout, so that users installing 2006.1 will get the helpful message in conf.d/net.example right away? It wouldn't be too much of a problem to "backport" the note, would it? :)

Fixed in CVS on the GDP end.
Comment 5 Thomas Schweikle 2013-01-17 12:39:41 UTC
At certain points you refer to /etc/conf.d/net.example, which doesn't exist. It isn't helpful to refer to an example file not found at the place mentioned ...
Comment 6 Thomas Schweikle 2013-01-17 12:41:01 UTC
This is marked resolved/fixed. After installing gentoo from scratch I'd say: it is not. Not even in the latest snapshot available!