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