BSD 4_3 release

[unix-history] / usr / man / man5 / hosts.5

diff --git a/usr/man/man5/hosts.5 b/usr/man/man5/hosts.5
index aa28fda..5ff50fb 100644 (file)
--- a/usr/man/man5/hosts.5
+++ b/usr/man/man5/hosts.5
@@ -1,11 +1,18 @@
-.TH HOSTS 5  "15 January 1983"
+.\" Copyright (c) 1983 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)hosts.5     6.3 (Berkeley) 5/14/86
+.\"
+.TH HOSTS 5  "May 14, 1986"
+.UC 5

 .SH NAME
 hosts \- host name data base
 .SH DESCRIPTION
 The
 .I hosts
 file contains information regarding
 .SH NAME
 hosts \- host name data base
 .SH DESCRIPTION
 The
 .I hosts
 file contains information regarding

-the known hosts on the DARPA Internet.
+the known hosts on the network.

 For each host a single line should be present
 with the following information:
 .HP 10
 For each host a single line should be present
 with the following information:
 .HP 10


@@ -23,23 +30,35 @@ Items are separated by any number of blanks and/or
 tab characters.  A ``#'' indicates the beginning of
 a comment; characters up to the end of the line are
 not interpreted by routines which search the file.
 tab characters.  A ``#'' indicates the beginning of
 a comment; characters up to the end of the line are
 not interpreted by routines which search the file.

-This file is normally created from the official host
+.PP
+When using the name server
+.IR named (8),
+this file provides a backup when the name server
+is not running.
+For the name server, it is suggested that only a few addresses
+be included in this file.
+These include  address for the local interfaces that 
+.IR ifconfig (8C)
+needs at boot time and a few machines on the local network.
+.PP
+This file may be created from the official host

 data base maintained at the Network Information Control
 Center (NIC), though local changes may be required
 to bring it up to date regarding unofficial aliases
 data base maintained at the Network Information Control
 Center (NIC), though local changes may be required
 to bring it up to date regarding unofficial aliases

-and/or unknown hosts.
+and/or unknown hosts.  As the data base maintained at NIC
+is incomplete, use of the name server is recommend for
+sites on the DARPA Internet.

 .PP
 Network addresses are specified in the conventional
 ``.'' notation using the \fIinet_addr\fP() routine
 from the Internet address manipulation library,
 .PP
 Network addresses are specified in the conventional
 ``.'' notation using the \fIinet_addr\fP() routine
 from the Internet address manipulation library,

-.IR inet (3).
+.IR inet (3N).

 Host names may contain any printable
 character other than a field delimiter, newline,
 or comment character.
 .SH FILES
 /etc/hosts
 .SH "SEE ALSO"
 Host names may contain any printable
 character other than a field delimiter, newline,
 or comment character.
 .SH FILES
 /etc/hosts
 .SH "SEE ALSO"

-gethostent(3N)
-.SH BUGS
-A name server should be used instead of a static file.
-A binary indexed file format should be available for fast access.
+gethostbyname(3N), ifconfig(8C), named(8)
+.br
+Name Server Operations Guide for BIND