manual page first distributed with 4.2BSD
[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.\"
5.\" @(#)hosts.5 5.1 (Berkeley) %G%
6.\"
7.TH HOSTS 5 "15 January 1983"
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.
46.SH FILES
47/etc/hosts
48.SH "SEE ALSO"
49gethostent(3N)
50.SH BUGS
51A name server should be used instead of a static file.
52A binary indexed file format should be available for fast access.