Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 452662 - Networking setup does not work as expected by the handbook
Summary: Networking setup does not work as expected by the handbook
Status: RESOLVED INVALID
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-01-17 13:11 UTC by Thomas Schweikle
Modified: 2013-01-18 23:01 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Thomas Schweikle 2013-01-17 13:11:31 UTC
Install gentoo from scratch, using the latest snapshot. Set up networking as adviced by the handbook.

dns_domain_lo="example.com"

is stated to set a dns-domain. It does set "domain" within "/etc/resolv.conf", but "hostname" reports only the configured hostname (even if used with "-f").

setting
dns_domain_lo="example.com"
and
dns_domain_eth0="example.com"

leads to only include all configurations for "eth0". The configurations given for "lo" are ignored or overwritten.

It is stated in the handbook you shall look at /etc/conf.d/net.example for additional informations about setting up networking. The file isn't installed at the position stated.

It is stated in the handbook "dns_search_domains="example.com example1.com"" would set searching domains. Instead this is "dns_search="example.com example1.com"".

Reproducible: Always

Steps to Reproduce:
1. Set up networking as adviced by the handbook
2.
3.
Actual Results:  
Networking partly works.
Things that do not work:
- setting domain


Expected Results:  
Setting up networking as adviced by the handbook works as expected.
Comment 1 Thomas Deutschmann (RETIRED) gentoo-dev 2013-01-17 19:37:40 UTC
I think you misunderstood resolv.conf:

Your domain is example.org. You want to be able to reach other clients just via their short name (hostname). In other words:

~ # ping bar.example.org
~ # ping bar

Both commands should work.

To do that, you would set DOMAIN to example.org in /etc/resolv.conf.

But what would you do, if you want to search in another domain (example.local), too? In this case you would also set SEARCH.

With SEARCH you can also specify the order.

Summary: resolv.conf (and /etc/conf.d/net) isn't used for setting the FQDN!


If we want to set the FQDN "foo.example.org", we would do:

1. Set hostname (and only the hostname!) in /etc/conf.d/hostname

~ # cat /etc/conf.d/hostname
# Set to the hostname of this machine
hostname="foo"


2. Edit /etc/hosts and add the FQDN and hostame. Take care of the order!

~ # cat /etc/hosts | grep localhost
# IPv4 and IPv6 localhost aliases
127.0.0.1	foo.example.org foo localhost
::1		foo.example.org foo localhost


3. Apply settings (restart hostname... or just reboot :p)

4. Verify

~ # hostname
foo

~ # hostname -f
foo.example.org


I would agree with you, that "domain_search_domains" is invalid. But I only find it on <http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=4&chap=4#doc_chap4> at the end. Can you post a link to the handbook you used?
Comment 2 nm (RETIRED) gentoo-dev 2013-01-18 23:01:24 UTC
1. None of the current English handbooks refer to /etc/conf.d/net.example, so this complaint is invalid.

2. Thomas D posted the right way to go about doing this sort of search. Use /etc/hosts.

3. The handbook follows the examples written in /usr/share/openrc/net.example.bz2, and upstream does a good job of maintaining those in working order. If there's a bug with the installed manpage, then please file a bug with the OpenRC maintainers. Otherwise, help requests for networking configuration can be posted to https://forums.gentoo.org.