share/man/man5/hesiod.conf.5

   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: src/share/man/man5/hesiod.conf.5,v 1.3 2005/02/09 18:07:16 ru Exp $
  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
  28 The file
  29 .Nm
  30 determines the behavior of the Hesiod library.
  31 Blank lines and lines beginning with a
  32 .Ql #
  33 character are ignored.
  34 All
  35 other lines should be of the form
  36 .Ar variable
  37 =
  38 .Ar value ,
  39 where the
  40 .Ar value
  41 should be a single word.
  42 Possible
  43 .Ar variables
  44 and
  45 .Ar values
  46 are:
  47 .Bl -tag -width classes
  48 .It Ic lhs
  49 Specifies the domain prefix used for Hesiod queries.
  50 In almost all cases, you should specify
  51 .Dq Li lhs=.ns .
  52 The default value if you do
  53 not specify an lhs value is no domain prefix, which is not compatible
  54 with most Hesiod domains.
  55 .It Ic rhs
  56 Specifies the default Hesiod domain; this value may be overridden by
  57 the
  58 .Ev HES_DOMAIN
  59 environment variable.
  60 You must specify an rhs line for the Hesiod
  61 library to work properly.
  62 .It Ic classes
  63 Specifies which DNS classes Hesiod should do lookups in.
  64 Possible values are
  65 .Cm IN
  66 (the preferred class) and
  67 .Cm HS
  68 (the deprecated class, still used by some sites).
  69 You may specify both classes separated by
  70 a comma to try one class first and then the other if no entry is
  71 available in the first class.
  72 The 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
  78 The default value for
  79 .Ic lhs
  80 should probably be more reasonable.