#@(#)$Id: elmrc-resolv-info,v 1.10 2022/11/06 13:51:44 hurtta Exp $
# Elm Version ME+ 2.5
#
#$HDR
#-----------------------------------------------------------------------
#
# Settings for libelmme-resolv.so shared library
#
# Shared library libelmme-resolv.so provides interface to resolver routines.
#

interface-change
# Specifies actions when interface addresses as changed (if getifaddrs()
# is available)
# 
# Possible values:
#
#               none		Nothing specified
#
#		clear-cache	Clear cached DNS records

query-address-type
# Specifies what address record types are queried on DNS-lookup.
#
# If command line option -4 (use IPv4) or -6 (use IPv6) or, some
# combination of these is used, these override "query-address-type"
# setting.
#
# Possible values:
#   
#    default           Query A (IPv4) and AAAA (IPv6) records.
#                      If only IPv4 or IPv6 addresses are 
#                      seen on interface list, then query
#                      only A (IPv4) or AAAA (IPv6) records.
#                      Mail domain verify queries both
#                      A (IPv4) and AAAA (IPv6) records if
#                      IP-addresses are queried.
#    IPv4              Query A (IPv4) record. 
#    IPv6              Query AAAA (IPv6) record.
#    IPv6-IPv4         Query AAAA (IPv6) record and then A (IPv4) record.
#    IPv4-IPv6         Query A (IPv4) record and then AAAA (IPv6) record.

query-mode
# Specifies how  DNS-lookup is implemented
#
# Possible values:
#   
#    blocking         This uses res_query() or res_search()
#
#    non-blocking     This uses res_mkquery() and runs res_send() on
#                     separate process. In that case resolv -module
#                     implements internally res_search() like search
#                     algorithm.
#
#  After that parameter there can be following additional options:
#    helper=          Value "allow-interrupt" tells that
#                     interrupt character (Ctrl-C) is allowed kill
#                     res_send() helper processes.
#
#    helper=          Value "ignore-interrupt" tells that
#                     interrupt character (Ctrl-C) is ignored (does
#                     not kill process).
#
#    helper=          Numeric value  parameter tells how many helper
#                     processes is considered for query.
#
#    helper-skip-limit=         Parameter tells how  many busy helper
#                               processes are skipped and not 
#                               considered for query.
#
#    parallel-lookup-max-time=     Gives  maximum time (seconds or
#                                  minutes) what is used to resolve DNS
#                                  lookup when non-blocking mode is used.

query-domain-blacklist
# List of domains which are not  queried with libelmme-resolv.so
# but instead fallback is used.
#
# If domain name is given as ".domain" then it blacklists names under that 
# domain. If name is given as "domain" then also "domain" itself (and names 
# under it) are blacklisted. 
#
# This options is NOT considered when CNAMEs are followed. If
# CNAME points to blacklisted domain, it is still DNS looked up. 
#
# See also RFC 6761: Special-Use Domain Names

search-mail-domain
# Specifies how mail domains are are verified. 
#
# Possible values:
#   
#    query-exact       Uses res_query() for DNS lookup. This does not use 
#                      "domain" and "search" from /etc/resolv.conf but 
#                      instead does DNS lookup for given name.
#    search-name       Uses res_search() for DNS lookup. This uses default 
#                      search rules.
#    search-dotless    Uses res_query() if name includes dot (.). Single 
#                      component names are queried with res_search().
#
#  NOTE:  res_query() or res_search()  is used only when "query-mode"
#         is "blocking". Otherwise resolv -module implements internally
#         res_search() like search algorithm.
#
# See also: query-mode

search-mail-service
# Specifies how names are searched for addresses. 
#
# Possible values:
#   
#    query-exact                       Uses res_query() for DNS lookup. This 
#                                      does not use "domain" and "search" from 
#                                      /etc/resolv.conf but instead does DNS 
#                                      lookup for given name.
#    search-name                       Uses res_search() for DNS lookup. 
#                                      This uses default search rules.
#    search-dotless                    Uses res_query() if name includes 
#                                      dot (.). Single component names are 
#                                      queried with res_search().
#    fallback-dotless                  Uses res_query() if name includes 
#                                      dot (.). For single component names 
#                                      fallback is used.
#    fallback-dotless-search-name      Uses  res_search() if name includes 
#                                      dot (.). For single component names 
#                                      fallback is used.
#    static-hosts-dotless              Search /etc/hosts first if name does
#                                      not include dot (.), then query
#                                      exact name from DNS (res_query()).
#                                      If name not found from DNS and
#                                      name includes dot (.), then
#                                      search  /etc/hosts.
#    static-hosts-dotless-search-name  Search /etc/hosts first if name does
#                                      not include dot (.), then lookup
#                                      name from DNS with default search
#                                      rules (res_search()). If name not
#                                      found from DNS and name includes dot (.), then
#                                      search  /etc/hosts. 
#                                       
#
#  NOTE:  res_query() or res_search()  is used only when "query-mode"
#         is "blocking". Otherwise resolv -module implements internally
#         res_search() like search algorithm.
#
#         Search form /etc/hosts ignores query-address-type
#
# See also: query-mode, query-address-type
