xref: /netbsd-src/share/man/man5/hesiod.conf.5 (revision e84dcc6980c13ecef5f691b667e05dddebe6a347)
1*e84dcc69Swiz.\"	$NetBSD: hesiod.conf.5,v 1.4 2001/09/08 01:29:05 wiz Exp $
2177a852aSlukem.\"
3177a852aSlukem.\" from: #Id: hesiod.conf.5,v 1.1 1996/12/08 21:36:38 ghudson Exp #
4177a852aSlukem.\"
5177a852aSlukem.\" Copyright 1996 by the Massachusetts Institute of Technology.
6177a852aSlukem.\"
7177a852aSlukem.\" Permission to use, copy, modify, and distribute this
8177a852aSlukem.\" software and its documentation for any purpose and without
9177a852aSlukem.\" fee is hereby granted, provided that the above copyright
10177a852aSlukem.\" notice appear in all copies and that both that copyright
11177a852aSlukem.\" notice and this permission notice appear in supporting
12177a852aSlukem.\" documentation, and that the name of M.I.T. not be used in
13177a852aSlukem.\" advertising or publicity pertaining to distribution of the
14177a852aSlukem.\" software without specific, written prior permission.
15177a852aSlukem.\" M.I.T. makes no representations about the suitability of
16177a852aSlukem.\" this software for any purpose.  It is provided "as is"
17177a852aSlukem.\" without express or implied warranty.
18177a852aSlukem.\"
19b181f25bSwiz.Dd November 30, 1996
20b181f25bSwiz.Dt HESIOD.CONF 5
21b181f25bSwiz.Os
22b181f25bSwiz.Sh NAME
23b181f25bSwiz.Nm hesiod.conf
24b181f25bSwiz.Nd configuration file for the Hesiod library
25b181f25bSwiz.Sh DESCRIPTION
26b181f25bSwizThe file
27b181f25bSwiz.Nm
28b181f25bSwizdetermines the behavior of the Hesiod library.
29b181f25bSwizBlank lines and lines beginning with a
30b181f25bSwiz.Sq #
31b181f25bSwizcharacter are ignored.  All other lines should be of the form
32b181f25bSwiz.Em variable
33177a852aSlukem=
34b181f25bSwiz.Ar value ,
35177a852aSlukemwhere the value should be a single word.  Possible variables and
36177a852aSlukemvalues are:
37b181f25bSwiz.Bl -tag -width classes
38b181f25bSwiz.It Em lhs
39177a852aSlukemSpecifies the domain prefix used for Hesiod queries.  In almost all
40b181f25bSwizcases, you should specify
41b181f25bSwiz.Dq Em lhs Ns = Ns Ar .ns .
42b181f25bSwizThe default value if you do
43177a852aSlukemnot specify an lhs value is no domain prefix, which is not compatible
44177a852aSlukemwith most Hesiod domains.
45b181f25bSwiz.It Em rhs
46177a852aSlukemSpecifies the default Hesiod domain; this value may be overridden by
47177a852aSlukemthe
48b181f25bSwiz.Ev HES_DOMAIN
49b181f25bSwizenvironment variable.  You must specify an
50b181f25bSwiz.Em rhs
51b181f25bSwizline for the Hesiod
52177a852aSlukemlibrary to work properly.
53b181f25bSwiz.It Em classes
54177a852aSlukemSpecifies which DNS classes Hesiod should do lookups in.  Possible
55b181f25bSwizvalues are
56b181f25bSwiz.Ar IN
57b181f25bSwiz(the preferred class) and
58b181f25bSwiz.Ar HS
59b181f25bSwiz(the deprecated class,
60177a852aSlukemstill used by some sites).  You may specify both classes separated by
61177a852aSlukema comma to try one class first and then the other if no entry is
62177a852aSlukemavailable in the first class.  The default value of the classes
63b181f25bSwizvariable is
64b181f25bSwiz.Dq Ar IN,HS .
65b181f25bSwiz.El
66b181f25bSwiz.Sh SEE ALSO
67b181f25bSwiz.Xr hesiod 3
68b181f25bSwiz.Sh BUGS
69b181f25bSwizThere default value for
70b181f25bSwiz.Dq lhs
71b181f25bSwizshould probably be more reasonable.
72