[dragonfly.git] / share / man / man5 / host.conf.5

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