Hello Thomas, On 6/29/20 5:07 PM, Thomas Bartelsmeier wrote: > Resolves https://bugzilla.kernel.org/show_bug.cgi?id=208279 > > Signed-off-by: Thomas Bartelsmeier <t.bartelsmeier@xxxxxxxxx> Thanks. Patch applied. Cheers, Michael > --- > > 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...] > .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. > -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
