Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 53188 - Install Guide contains bad information regarding /etc/hosts
Summary: Install Guide contains bad information regarding /etc/hosts
Status: RESOLVED WORKSFORME
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Gentoo Linux x86 Installation Guide (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-06-06 20:43 UTC by aethyr
Modified: 2004-07-02 09:20 UTC (History)
0 users

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 aethyr 2004-06-06 20:43:22 UTC
Reading the forums the past couple of months, I was wondering why I kept seeing problems related to /etc/hosts (i.e. long application startup).  I finally decided to look today at why everyone was having this problem, only to find the install guide reading:

"If your system is the only system (or the nameservers handle all name resolution) a single line is sufficient:

Code Listing 19: /etc/hosts for lonely or fully integrated PCs

127.0.0.1     localhost"

The old installation guide contained the following warning:
"Note: If you are on a DHCP network, it might be helpful to set localhost to your machine's actual hostname. This will help GNOME and many other programs in name resolution."

http://web.archive.org/web/20030602200935/www.gentoo.org/doc/en/gentoo-x86-install.xml

I believe this warning should not only be put back, but it should also be _highlighted_.  Additionally, this also causes problems for KDE.  Many people are having problems related to this.

See the following for reference:
http://forums.gentoo.org/viewtopic.php?t=182362

(there's lots more like it as well)

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 aethyr 2004-06-06 20:44:35 UTC
Just for reference, my /etc/hosts has the following two lines:

127.0.0.1       localhost
127.0.0.1       machinename
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2004-07-02 09:20:57 UTC
The current instructions regarding /etc/hosts are correct. You just need to make sure that your hostname and fqdn are listed in the /etc/hosts.

"""
For instance, if your internal network consists of three PCs called jenny (192.168.0.5), benny (192.168.0.6) and tux (192.168.0.7 - this system) you would open /etc/hosts and fill in the values:

127.0.0.1     localhost
192.168.0.5   jenny.homenetwork jenny
192.168.0.6   benny.homenetwork benny
192.168.0.7   tux.homenetwork tux
"""

Note the fact that tux is the hostname for _this_ system and is listed in /etc/hosts.