home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / network / resolv_1 / 8 / resolv+
Text File  |  1994-06-08  |  4KB  |  137 lines
  1.     RESOLV+(8)                    August 19, 1992
  2.  
  3.  
  4. NAME
  5.     resolv+ - enhanced DNS resolver library
  6.  
  7. DESCRIPTION
  8.     Resolv+ is a modified version of the standard Berkeley BIND host
  9. resolver library.
  10. Enhancements include support for host lookups via the Internet Domain
  11. Name System (DNS), the /etc/hosts file, and Sun's Network Information Service
  12. (NIS).
  13.  
  14.     The programmer interface to the resolv+ routines is identical to that
  15. of the standard resolver library.  For further information see the 
  16. appropriate manual pages.
  17.  
  18. CONFIGURATION
  19.     As with the standard resolver library, the file /etc/resolv.conf
  20. must be set up before the resolver can function. In addition, the file
  21. /etc/host.conf contains configuration information specific to resolv+.
  22.  
  23.     The host.conf file should contain one configuration keyword per line,
  24. followed by appropriate configuration information.  The keywords recognized
  25. are:
  26.     order,
  27.     trim,
  28.     multi,
  29.     nospoof,
  30. and
  31.     reorder.
  32.  
  33. Each keyword is described seperately below.
  34.  
  35. • order
  36.   This keyword specifies how host lookups are to be performed. It should be
  37.   followed by one or more lookup methods, seperated by commas. Valid methods
  38.   are:
  39.     bind, (use nameserver to find the address/name)
  40.     hosts, (use /etc/hosts to find the address/name)
  41.   and
  42.     nis. (use NIS to find the address/name)
  43.  
  44. • trim
  45.   This keyword may be listed more than once. Each time it should be followed
  46.   by a single domain name, with the leading dot. When set, the resolv+
  47.   library will automatically trim the given domain name from the end of any
  48.   hostname resolved via DNS. This is intended for use with local hosts and
  49.   domains. (Related note: trim will not affect hostnames gathered via NIS or
  50.   the hosts file. Care should be taken to insure that the first hostname for
  51.   each entry in the hosts file is fully qualified or non-qualified, as
  52.   appropriate for the local installation.)
  53.  
  54. • multi
  55.   Valid values are:
  56.     on
  57.   and
  58.     off.
  59.   If set to "on," the resolv+ library will return all valid addresses for a
  60.   host that appears in the /etc/hosts file, instead of only the first. This
  61.   is off by default, as it may cause a substantial performance loss at sites
  62.   with large hosts files.
  63.  
  64. • nospoof
  65.   Valid values are:
  66.     on
  67.   and
  68.     off.
  69.   If set to "on," the resolv+ library will attempt to prevent hostname
  70.   spoofing to enhance the security of rlogin and rsh.
  71.   It works as follows: after performing a host address lookup, resolv+ will
  72.   perform a hostname lookup for that address.  If the two hostnames do not
  73.   match, the query will fail.
  74.  
  75. • alert
  76.   If this option is set to "on" and the nospoof option is also set, resolv+
  77.   will log a warning of the error via the syslog facility. The default value
  78.   is off.
  79.  
  80. • reorder
  81.   Valid values are
  82.     on
  83.   and
  84.     off.
  85.   If set to "on," resolv+ will attempt to reorder host addresses so that
  86.   local addresses (i.e., on the same subnet) are listed first when a
  87.   gethostbyname() is performed. Reordering is done for all lookup methods.
  88.   The default value is off.
  89.  
  90. ENVIRONMENT VARIABLES
  91.     The following environment variables may be set to override resolv+'s
  92. configured behavior:
  93.  
  94.     RESOLV_HOST_CONF
  95.     If set, it will override the default filename ("/etc/host.conf") for
  96. the resolv+ configuration file.
  97.  
  98.     RESOLV_SERV_ORDER
  99.     If set, will override the "order" keyword in the host.conf file.
  100.  
  101.     RESOLV_SPOOF_CHECK
  102.     If set, will override the spoof check flag.  Valid values are "off"
  103. to disable checking, "warn" to enable checking and warning, and "warn off"
  104. to enable checking but not warning.
  105.  
  106.     RESOLV_ADD_TRIM_DOMAINS
  107.     If set, contains a list of domains to trim that will augment, not
  108. supersede, the list in the host.conf file.
  109.  
  110.     RESOLV_OVERRIDE_TRIM_DOMAINS
  111.     If set, contains a list of domains to trim that will override those
  112. in the host.conf file.
  113.  
  114.     RESOLV_MULTI
  115.     If set, overrides the "multi" keyword in the host.conf file.
  116.  
  117.     RESOLV_REORDER
  118.     If set, overrides the "reorder" keyword in the host.conf file.
  119.  
  120. FILES
  121.     /etc/host.conf,
  122.     /etc/hosts
  123.  
  124. BUGS
  125.     Quite possibly.
  126.  
  127. AUTHOR
  128.     The original BIND resolver library comes from the University of
  129. California at Berkeley's Computer Science Research Group. The original
  130. resolv+ modifications were made by Bill Wisner <wisner@uunet.UU.NET>. Bug
  131. fixes and enhancements were contributed by Patrick Gosling, Chris Metcalf,
  132. John DiMarco and J. Porter Clark, John P. Rouillard, Dan O'Neill and
  133. Tom Limoncelli.
  134.  
  135. SEE ALSO
  136.     resolver(3), resolver(5), hosts(5), hostname(7), named(8)
  137.