Public bug reported:
In the doc "Ubuntu Server Guide » Networking » Network Configuration"
for various releases up to and including 12.04 (e.g.,
https://help.ubuntu.com/12.04/serverguide/network-configuration.html ),
there is an example for setting up /etc/hosts (subsection "Static
Hostnames". The example is flawed, demonstrating the incorrect entry
order of IP/aliases/FQDN. In fact, to use this as a guideline ensures
"hostname -f" will incorrectly return an alias instead of the FQDN. The
examples should show IP/FQDN/aliases:
10.0.0.11 server1 vpn server1.example.com # Wrong - FQDN is not the
first item after the IP address
10.0.0.11 server1.example.com vpn server1 # Correct - FQDN is first
after the IP address
The man page for "hosts" also demonstrates the correct syntax.
This may seem trivial, but every time I've gone hunting for an example
of this the docs here were among the very first search results so I
consider these authoritative. Sometimes I got 12.04's docs and sometimes
earlier docs, but all versions appear to have the same broken example.
In correcting the example, it would also be useful to explicitly state
the correct order for /etc/hosts entries, to reinforce correct usage
patterns.
** Affects: ubuntu-docs (Ubuntu)
Importance: Undecided
Status: New
--
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.
https://bugs.launchpad.net/bugs/1006312
Title:
Persistent error in the /etc/hosts example in the "Ubuntu Server Guide
» Networking » Network Configuration" docs
To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+bug/1006312/+subscriptions
--
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs
