Linux-man Archive on
 help / color / Atom feed
* [PATCH] hosts.5: Clarify capability for IPv6 outside of examples
@ 2020-06-29 15:07 Thomas Bartelsmeier
  2020-06-30  7:34 ` Michael Kerrisk (man-pages)
  0 siblings, 1 reply; 2+ messages in thread
From: Thomas Bartelsmeier @ 2020-06-29 15:07 UTC (permalink / raw)
  To: mtk.manpages; +Cc: linux-man, linux-kernel, Thomas Bartelsmeier


Signed-off-by: Thomas Bartelsmeier <>

The first addition should be relatively uncontroversial.
As the prevalence of IPv6 continues to increase, it is about
time to not only mention the IPv6 compatibility of the hosts
file in the examples at the very bottom of the man page.

The second addition is in relation to the Bugzilla report.
It is a simple statement which is true even for the default
version of the hosts file and its two entries for localhost.
However, I do not consider it necessary for any casual user to
add both IPv4 and IPv6 addresses for any hosts.
Therefore, I cautiously did not change the wording criticized in
the bug report in case of any possible negative interactions.
As a result, the second addition is meant to be for completeness
and for use by people who know they actually need this.

 man5/hosts.5 | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/man5/hosts.5 b/man5/hosts.5
index cb055f5f6..1230f9303 100644
--- a/man5/hosts.5
+++ b/man5/hosts.5
@@ -42,6 +42,7 @@ line should be present with the following information:
 IP_address canonical_hostname [aliases...]
+The IP address can conform to either IPv4 or IPv6.
 Fields of the entry are separated by any number of blanks and/or
 tab characters.
 Text from a "#" character until the end of the line is
@@ -53,6 +54,8 @@ alphabetic character and end with an alphanumeric character.
 Optional aliases provide for name changes, alternate spellings,
 shorter hostnames, or generic hostnames (for example,
 .IR localhost ).
+If required, a host may have two separate entries in this file;
+one for each version of the Internet Protocol (IPv4 and IPv6).
 The Berkeley Internet Name Domain (BIND) Server implements the
 Internet name server for UNIX systems.

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, back to index

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-06-29 15:07 [PATCH] hosts.5: Clarify capability for IPv6 outside of examples Thomas Bartelsmeier
2020-06-30  7:34 ` Michael Kerrisk (man-pages)

Linux-man Archive on

Archives are clonable:
	git clone --mirror linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ \
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:

AGPL code for this site: git clone