ugensa(4): Fix handling of Huawei modems.
[dragonfly.git] / share / man / man5 / host.conf.5
CommitLineData
984263bc
MD
1.\" Copyright (c) 2001 Giorgos Keramidas <keramida@freebsd.org>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD: src/share/man/man5/host.conf.5,v 1.1.2.2 2002/02/12 10:12:13 ru Exp $
3f5e28f4 26.\" $DragonFly: src/share/man/man5/host.conf.5,v 1.4 2007/05/17 08:19:01 swildner Exp $
984263bc
MD
27.\"
28.\" Note: The date here should be updated whenever a non-trivial
29.\" change is made to the manual page.
30.Dd December 6, 2001
31.Dt HOST.CONF 5
32.Os
33.Sh NAME
34.Nm host.conf
35.Nd resolver services configuration file
36.Sh SYNOPSIS
37.Pa /etc/host.conf
38.Sh DESCRIPTION
39The
40.Nm
41file holds part of the configuration for the resolver of
9bb2a92d 42.Dx .
984263bc
MD
43It describes what services (eg. DNS or
44.Xr yp 8 )
45the C library resolving routines
46(like
47.Xr gethostbyname 3 )
48will use, and their order of use, when resolving host names or addresses.
49.Pp
50The format of this file is human readable, and easy to modify with the
3f5e28f4 51text editor of your choice.
984263bc
MD
52Lines with
53.Ql #
54in the first column are comments and are ignored.
55The rest of the lines may contain any number of service names,
56separated by any number of colons
57.Pq Ql \&: ,
58semicolons
59.Pq Ql \&; ,
60commas
61.Pq Ql \&, ,
62or whitespace (tab, space and newline characters).
63.Ss Valid Service Names
64Service names that are recognized as valid in
65.Nm
66are:
67.Bl -tag -width ".Li yellowpages"
68.It Li /etc/hosts
69An alias for
70.Ql hosts .
71.It Li bind
72This service makes the resolver use Internet Domain System (DNS) for
73resolving hostnames and addresses.
74The DNS resolver configuration is
75described in
76.Xr resolver 5 .
77.It Li dns
78An alias for
79.Ql bind .
80.It Li domain
81An alias for
82.Ql bind .
83.It Li hosts
84When this service name is used in
85.Nm ,
86name and address lookups are done by using the local hosts database.
87The local hosts database is described in
88.Xr hosts 5 .
89.It Li hosttable
90An alias for
91.Ql hosts .
92.It Li htable
93An alias for
94.Ql hosts .
95.It Li nis
96When service name is used in
97.Nm ,
98the resolver uses YP/NIS for making lookups of hostnames and
99addresses.
100The YP/NIS system is described in
101.Xr yp 8 .
102.It Li yellowpages
103An alias for
104.Ql nis .
105.It Li yp
106An alias for
107.Ql nis .
108.El
109.Sh FILES
110.Bl -tag -width ".Pa host.conf"
111.It Pa host.conf
112The services configuration file resides in
113.Pa /etc .
114.El
115.Sh SEE ALSO
116.Xr gethostbyname 3 ,
117.Xr hosts 5 ,
118.Xr resolver 5 ,
119.Xr yp 8