xref: /netbsd/share/man/man5/hesiod.conf.5 (revision bf9ec67e)
1.\"	$NetBSD: hesiod.conf.5,v 1.4 2001/09/08 01:29:05 wiz Exp $
2.\"
3.\" from: #Id: hesiod.conf.5,v 1.1 1996/12/08 21:36:38 ghudson Exp #
4.\"
5.\" Copyright 1996 by the Massachusetts Institute of Technology.
6.\"
7.\" Permission to use, copy, modify, and distribute this
8.\" software and its documentation for any purpose and without
9.\" fee is hereby granted, provided that the above copyright
10.\" notice appear in all copies and that both that copyright
11.\" notice and this permission notice appear in supporting
12.\" documentation, and that the name of M.I.T. not be used in
13.\" advertising or publicity pertaining to distribution of the
14.\" software without specific, written prior permission.
15.\" M.I.T. makes no representations about the suitability of
16.\" this software for any purpose.  It is provided "as is"
17.\" without express or implied warranty.
18.\"
19.Dd November 30, 1996
20.Dt HESIOD.CONF 5
21.Os
22.Sh NAME
23.Nm hesiod.conf
24.Nd configuration file for the Hesiod library
25.Sh DESCRIPTION
26The file
27.Nm
28determines the behavior of the Hesiod library.
29Blank lines and lines beginning with a
30.Sq #
31character are ignored.  All other lines should be of the form
32.Em variable
33=
34.Ar value ,
35where the value should be a single word.  Possible variables and
36values are:
37.Bl -tag -width classes
38.It Em lhs
39Specifies the domain prefix used for Hesiod queries.  In almost all
40cases, you should specify
41.Dq Em lhs Ns = Ns Ar .ns .
42The default value if you do
43not specify an lhs value is no domain prefix, which is not compatible
44with most Hesiod domains.
45.It Em rhs
46Specifies the default Hesiod domain; this value may be overridden by
47the
48.Ev HES_DOMAIN
49environment variable.  You must specify an
50.Em rhs
51line for the Hesiod
52library to work properly.
53.It Em classes
54Specifies which DNS classes Hesiod should do lookups in.  Possible
55values are
56.Ar IN
57(the preferred class) and
58.Ar HS
59(the deprecated class,
60still used by some sites).  You may specify both classes separated by
61a comma to try one class first and then the other if no entry is
62available in the first class.  The default value of the classes
63variable is
64.Dq Ar IN,HS .
65.El
66.Sh SEE ALSO
67.Xr hesiod 3
68.Sh BUGS
69There default value for
70.Dq lhs
71should probably be more reasonable.
72