-.\" Hey, Emacs! This is an -*- nroff -*- source file.
.\" Copyright (c) 2000 Manoj Srivastava <srivasta@debian.org>
.\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
.\"
.\" Minor polishing, aeb
.\" Modified, 2002-06-16, Mike Coleman
.\"
-.TH HOSTS 5 2002-06-16 "Linux" "Linux Programmer's Manual"
+.TH HOSTS 5 2017-09-15 "Linux" "Linux Programmer's Manual"
.SH NAME
hosts \- static table lookup for hostnames
.SH SYNOPSIS
.SH NOTES
Modifications to this file normally take effect immediately,
except in cases where the file is cached by applications.
-.SS "Historical Notes"
+.SS Historical notes
RFC\ 952 gave the original format for the host table, though it has
since changed.
-
+.PP
Before the advent of DNS, the host table was the only way of resolving
hostnames on the fledgling Internet.
Indeed, this file could be
I just found three, from 92,
94, and 95.
.SH EXAMPLE
-.nf
+.EX
+# The following lines are desirable for IPv4 capable hosts
127.0.0.1 localhost
+
+# 127.0.1.1 is often used for the FQDN of the machine
+127.0.1.1 thishost.mydomain.org thishost
192.168.1.10 foo.mydomain.org foo
192.168.1.13 bar.mydomain.org bar
146.82.138.7 master.debian.org master
209.237.226.90 www.opensource.org
-.fi
-.SH "SEE ALSO"
+
+# The following lines are desirable for IPv6 capable hosts
+::1 localhost ip6-localhost ip6-loopback
+ff02::1 ip6-allnodes
+ff02::2 ip6-allrouters
+.EE
+.SH SEE ALSO
.BR hostname (1),
.BR resolver (3),
+.BR host.conf (5),
+.BR resolv.conf (5),
.BR resolver (5),
.BR hostname (7),
.BR named (8)
-
+.PP
Internet RFC\ 952
.\" .SH AUTHOR
.\" This manual page was written by Manoj Srivastava <srivasta@debian.org>,