From: Thomas Bartelsmeier <t.bartelsmeier@gmail.com>
Date: Mon, 29 Jun 2020 15:07:16 +0000 (+0200)
Subject: hosts.5: Clarify capability for IPv6 outside of examples
X-Git-Tag: man-pages-5.08~96
X-Git-Url: http://git.ipfire.org/gitweb/gitweb.cgi?a=commitdiff_plain;h=215c784ff4e48b2196226fc0da4715e05de729d5;p=thirdparty%2Fman-pages.git

hosts.5: Clarify capability for IPv6 outside of examples

Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279

Signed-off-by: Thomas Bartelsmeier <t.bartelsmeier@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---

diff --git a/man5/hosts.5 b/man5/hosts.5
index cb055f5f69..1230f9303e 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...]
 .RE
 .PP
+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).
 .PP
 The Berkeley Internet Name Domain (BIND) Server implements the
 Internet name server for UNIX systems.