docs/124949: Discrepancy between handbook and example hosts file for localhost configuration

[Wayne Sierke]

>Number:         124949
>Category:       docs
>Synopsis:       Discrepancy between handbook and example hosts file for localhost configuration
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 24 17:00:09 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Wayne Sierke
>Release:        FreeBSD 7.0-STABLE i386
>Organization:
>Environment:
FreeBSD predator-ii.buffyverse 7.0-STABLE FreeBSD 7.0-STABLE #1: Sat May 10 14:31:48 CST 2008     root at predator-ii.buffyverse:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
There is a slight but possibly significant discrepancy between the 'localhost' configuration entries given in the handbook 11.10.2.2 /etc/hosts:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/configtuning-configfiles.html

and the installed /usr/share/examples/etc/hosts (and default /etc/hosts) file, viz:

::1                     localhost localhost.my.domain myname.my.domain
127.0.0.1               localhost localhost.my.domain myname.my.domain

::1			localhost localhost.my.domain
127.0.0.1		localhost localhost.my.domain

respectively.

This difference was noticed recently while resolving a 'slow login' problem with sshd. Although I don't have a reference, I seem to recall having seen at least one claim that the hostname entry might be needed (in the loopback config) to circumvent ssh login delays.
>How-To-Repeat:
Compare localhost entries in /usr/share/examples/etc/hosts and default /etc/hosts with instructions in handbook 11.10.2.2.
>Fix:
Unknown. Expert input needed.

If consensus deems that changes are needed, I'm happy to follow up with the requisite patches.


>Release-Note:
>Audit-Trail:
>Unformatted: