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