tmpfs.5: Remove reference to mount(8) for discussion of mount options

[thirdparty/man-pages.git] / man5 / hosts.5

diff --git a/man5/hosts.5 b/man5/hosts.5
index 5c0191a4e04afc04aec7d263140b252080ad3e24..53c3df8d43c6e5137ae9d3d62d2dbc90858ab82c 100644 (file)
--- a/man5/hosts.5
+++ b/man5/hosts.5
@@ -1,6 +1,6 @@
-.\" 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
@@ -17,16 +17,16 @@
 .\" 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 "Debian" "Linux Programmer's Manual"
+.TH HOSTS 5 2017-09-15 "Linux" "Linux Programmer's Manual"
 .SH NAME
-hosts \- The static table lookup for host names
+hosts \- static table lookup for hostnames
 .SH SYNOPSIS
 .B /etc/hosts
 .SH DESCRIPTION
@@ -58,7 +58,7 @@ The Berkeley Internet Name Domain (BIND) Server implements the
 Internet name server for UNIX systems.
 It augments or replaces the
 .I /etc/hosts
-file or host name lookup, and frees a host from relying on
+file or hostname lookup, and frees a host from relying on
 .I /etc/hosts
 being up to date and complete.
 .PP
@@ -83,21 +83,15 @@ instead of DNS.
 If the local information rarely changes, and the
 network is not connected to the Internet, DNS offers little
 advantage.
-.SH EXAMPLE
-.nf
-127.0.0.1       localhost
-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 FILES
+.I /etc/hosts
 .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
@@ -110,15 +104,33 @@ though looking around at the time of writing (circa 2000), there are
 historical hosts.txt files on the WWW.
 I just found three, from 92,
 94, and 95.
-.SH FILES
-.I /etc/hosts
-.SH "SEE ALSO"
+.SH EXAMPLE
+.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
+
+# 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),
+.BR named (8)
+.PP
 Internet RFC\ 952
-.SH AUTHOR
-This manual page was written by Manoj Srivastava <srivasta@debian.org>,
-for the Debian GNU/Linux system.
+.\" .SH AUTHOR
+.\" This manual page was written by Manoj Srivastava <srivasta@debian.org>,
+.\" for the Debian GNU/Linux system.