change doc reference
[unix-history] / usr / src / share / man / man5 / hosts.5
CommitLineData
43624042
KM
1.\" Copyright (c) 1983 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
1f2d69c8 5.\" @(#)hosts.5 6.2 (Berkeley) %G%
43624042 6.\"
8612bf3c 7.TH HOSTS 5 ""
43624042
KM
8.UC 5
9.SH NAME
10hosts \- host name data base
11.SH DESCRIPTION
12The
13.I hosts
14file contains information regarding
15the known hosts on the DARPA Internet.
16For each host a single line should be present
17with the following information:
18.HP 10
19official host name
20.br
21.ns
22.HP 10
23Internet address
24.br
25.ns
26.HP 10
27aliases
28.PP
29Items are separated by any number of blanks and/or
30tab characters. A ``#'' indicates the beginning of
31a comment; characters up to the end of the line are
32not interpreted by routines which search the file.
33This file is normally created from the official host
34data base maintained at the Network Information Control
35Center (NIC), though local changes may be required
36to bring it up to date regarding unofficial aliases
37and/or unknown hosts.
38.PP
39Network addresses are specified in the conventional
40``.'' notation using the \fIinet_addr\fP() routine
41from the Internet address manipulation library,
42.IR inet (3N).
43Host names may contain any printable
44character other than a field delimiter, newline,
45or comment character.
1f2d69c8
KD
46.PP
47When using the name server this file is used as a backup for when
48.IR named (8)
49is not running.
50For the name server it is suggested that only a few addresses
51be included in this file.
52These include address for the local interfaces that
53.IR ifconfig (8C)
54needs at boot time and a few machines on the local network.
43624042
KM
55.SH FILES
56/etc/hosts
57.SH "SEE ALSO"
1f2d69c8 58gethostent(3N), ifconfig(8C), named(8), Name Server Operations Guide for BIND