xref: /freebsd/share/man/man5/hosts.5 (revision c22076b5283970908e74b3abece53efc4670e87d)
1afe61c15SRodney W. Grimes.\" Copyright (c) 1983, 1991, 1993
2afe61c15SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
3afe61c15SRodney W. Grimes.\"
4afe61c15SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
5afe61c15SRodney W. Grimes.\" modification, are permitted provided that the following conditions
6afe61c15SRodney W. Grimes.\" are met:
7afe61c15SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
8afe61c15SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
9afe61c15SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
10afe61c15SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
11afe61c15SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
12dda5b397SEitan Adler.\" 3. Neither the name of the University nor the names of its contributors
13afe61c15SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
14afe61c15SRodney W. Grimes.\"    without specific prior written permission.
15afe61c15SRodney W. Grimes.\"
16afe61c15SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17afe61c15SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18afe61c15SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19afe61c15SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20afe61c15SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21afe61c15SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22afe61c15SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23afe61c15SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24afe61c15SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25afe61c15SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26afe61c15SRodney W. Grimes.\" SUCH DAMAGE.
27afe61c15SRodney W. Grimes.\"
28afe61c15SRodney W. Grimes.\"     @(#)hosts.5	8.2 (Berkeley) 12/11/93
297f3dea24SPeter Wemm.\" $FreeBSD$
30afe61c15SRodney W. Grimes.\"
3154c22eeaSSergey Kandaurov.Dd December 25, 2013
32afe61c15SRodney W. Grimes.Dt HOSTS 5
333d45e180SRuslan Ermilov.Os
34afe61c15SRodney W. Grimes.Sh NAME
35afe61c15SRodney W. Grimes.Nm hosts
36afe61c15SRodney W. Grimes.Nd host name data base
37afe61c15SRodney W. Grimes.Sh DESCRIPTION
38afe61c15SRodney W. GrimesThe
394b66483fSRuslan Ermilov.Nm
40afe61c15SRodney W. Grimesfile contains information regarding
41afe61c15SRodney W. Grimesthe known hosts on the network.
42248aee62SJacques VidrineIt can be used in conjunction with DNS, and the NIS
43248aee62SJacques Vidrinemaps `hosts.byaddr' and `hosts.byname', as controlled by
44248aee62SJacques Vidrine.Xr nsswitch.conf 5 .
45afe61c15SRodney W. GrimesFor each host a single line should be present
46afe61c15SRodney W. Grimeswith the following information:
47afe61c15SRodney W. Grimes.Bd -unfilled -offset indent
48afe61c15SRodney W. GrimesInternet address
497b3eb001SNate Williamsofficial host name
50afe61c15SRodney W. Grimesaliases
51afe61c15SRodney W. Grimes.Ed
52afe61c15SRodney W. Grimes.Pp
53afe61c15SRodney W. GrimesItems are separated by any number of blanks and/or
545203edcdSRuslan Ermilovtab characters.
555203edcdSRuslan ErmilovA ``#'' indicates the beginning of
56afe61c15SRodney W. Grimesa comment; characters up to the end of the line are
57afe61c15SRodney W. Grimesnot interpreted by routines which search the file.
58afe61c15SRodney W. Grimes.Pp
5954c22eeaSSergey KandaurovThis file provides a backup used when the name server
60afe61c15SRodney W. Grimesis not running.
61afe61c15SRodney W. GrimesFor the name server, it is suggested that only a few addresses
62afe61c15SRodney W. Grimesbe included in this file.
634043c58eSTim VanderhoekThese include addresses for the local interfaces that
64afe61c15SRodney W. Grimes.Xr ifconfig 8
65afe61c15SRodney W. Grimesneeds at boot time and a few machines on the local network.
66afe61c15SRodney W. Grimes.Pp
67afe61c15SRodney W. GrimesNetwork addresses are specified in the conventional
68afe61c15SRodney W. Grimes``.'' (dot) notation using the
69afe61c15SRodney W. Grimes.Xr inet_addr 3
70afe61c15SRodney W. Grimesroutine
71afe61c15SRodney W. Grimesfrom the Internet address manipulation library,
72afe61c15SRodney W. Grimes.Xr inet 3 .
73afe61c15SRodney W. GrimesHost names may contain any printable
74afe61c15SRodney W. Grimescharacter other than a field delimiter, newline,
75afe61c15SRodney W. Grimesor comment character.
76afe61c15SRodney W. Grimes.Sh FILES
77afe61c15SRodney W. Grimes.Bl -tag -width /etc/hosts -compact
78afe61c15SRodney W. Grimes.It Pa /etc/hosts
79afe61c15SRodney W. GrimesThe
804b66483fSRuslan Ermilov.Nm
81afe61c15SRodney W. Grimesfile resides in
82afe61c15SRodney W. Grimes.Pa /etc .
83afe61c15SRodney W. Grimes.El
84afe61c15SRodney W. Grimes.Sh SEE ALSO
85afe61c15SRodney W. Grimes.Xr gethostbyname 3 ,
86248aee62SJacques Vidrine.Xr nsswitch.conf 5 ,
8754c22eeaSSergey Kandaurov.Xr ifconfig 8
88afe61c15SRodney W. Grimes.Rs
89afe61c15SRodney W. Grimes.%T "Name Server Operations Guide for BIND"
90afe61c15SRodney W. Grimes.Re
91afe61c15SRodney W. Grimes.Sh HISTORY
92afe61c15SRodney W. GrimesThe
93afe61c15SRodney W. Grimes.Nm
94afe61c15SRodney W. Grimesfile format appeared in
95*c22076b5SWarner Losh.Bx 4.1c .
96