xref: /freebsd/share/man/man5/hesiod.conf.5 (revision 2008043f386721d58158e37e0d7e50df8095942d)
1.\"	$NetBSD: hesiod.conf.5,v 1.2 1999/01/25 22:37:06 lukem 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.Ql #
31character are ignored.
32All
33other lines should be of the form
34.Ar variable
35=
36.Ar value ,
37where the
38.Ar value
39should be a single word.
40Possible
41.Ar variables
42and
43.Ar values
44are:
45.Bl -tag -width classes
46.It Ic lhs
47Specifies the domain prefix used for Hesiod queries.
48In almost all cases, you should specify
49.Dq Li lhs=.ns .
50The default value if you do
51not specify an lhs value is no domain prefix, which is not compatible
52with most Hesiod domains.
53.It Ic rhs
54Specifies the default Hesiod domain; this value may be overridden by
55the
56.Ev HES_DOMAIN
57environment variable.
58You must specify an rhs line for the Hesiod
59library to work properly.
60.It Ic classes
61Specifies which DNS classes Hesiod should do lookups in.
62Possible values are
63.Cm IN
64(the preferred class) and
65.Cm HS
66(the deprecated class, still used by some sites).
67You may specify both classes separated by
68a comma to try one class first and then the other if no entry is
69available in the first class.
70The default value of the classes variable is
71.Dq Li IN,HS .
72.El
73.Sh SEE ALSO
74.Xr hesiod 3
75.Sh BUGS
76The default value for
77.Ic lhs
78should probably be more reasonable.
79