Provided by: hinfo_1.02-3.1_all bug




       These  are configuration files used by hinfo.  Only the first one found
       (in order) is used.  The use statement  may  be  used  to  chain  hinfo
       configuration files.

       The  syntax is a small perl subset.  Comments begin with # as the first
       non-space character on  a  line  and  continue  to  the  end  of  line.
       Newlines  are  not  treated specially otherwise, but should be used for
       readability.  Whitespace between tokens is ignored.


       use FILENAME;
              The use statement will process another file as if its lines were
              in  the configuration file.  FILENAME should be a quoted (single
              or double) string.


       $SCALAR = VAL;
       @ARRAY = ( [VAL,]... );
       %HASH = ( [VAL1 => VAL2,]... );

       In array and hash assignment, the  comma  before  the  close  paren  is

       VAL may be any of:

       Number (decimal integers only)

       Quoted  string (With single quotes, \\ is treated as a single backslash
       and \ยด  is  a  single  quote.   With  double  quotes,  other  backslash
       expansions are done.)

       Array reference [ [VAL,]... ]

       Hash reference { [VAL1 => VAL2,] }

       Subroutine reference \&SUB (only a few subroutine names are supported)

       Variable contents $VAR

       Array contents (in array and array reference definitions only) @ARRAY


       The following variables are defined: (options that effect values are in

       $html  (-u) nonzero indicates html mode

       $pager (-p, -n) Pager used

              (-v) values -3 through 3 specify how many messages are displayed





              Regular expression of what to ignore in whois output.

              Regular expression of multi-line ignores in whois output.

              Regular  expression  of  blackhole  lists  to  not use.  Used to
              modify both @bhlists and @domainbased.

              (-e) Negative to never expand NIC handles Zero to  expand  first
              NIC handle only Positive to expand all NIC handles

              (-t)  Number  of  seconds  to  wait  for  DNS and whois servers.
              Timeouts only occur when there have been  no  results  from  any
              request for this amount of time.

              Timeout parameter to IO::Socket::INET->new call.


       $mx    (-m)

              IP based blackhole lists to use.

              Domain based blackhole lists to use.

              Displayed by --version

              Hash mapping most significant IP octet to whois server

              Hash  containing  information  about  whois servers referring to
              other whois servers.


       # use system defaults
       use "/etc/hinfo.conf";
       # set verbose mode
       $verbose = 3;
       # exclude DNSBLs
       $exclude = "\.blackholes\.us$";


       @bhlists and @domainbased are lists of DNSBL lists to check.  Each list
       entry is a list reference.

       DNS domain
              Domain to be postfixed to the reversed IP or domain name.

       List name
              Name of the DNSBL

       URL    URL of the DNSBL.  (Not including the leading http://)

       explain subroutine
              Subroutine to explain the DNSBL results.

       explain subroutine parameter
              Used by explain subroutine


              Use  the  least  significant  bits  of the IP returned as binary
              flags for each  of  the  entries  the  the  list  referenced  by

              Use  the  least  significant bits of the IP returned as an index
              into the list referenced by parameter.

              Fetch the TXT record from the DNSBL.

              Perform actions of both \&explain_iterate and \&explain_txt.


       Examples     of     @bhlists     and      @domainbased      are      in
       /var/lib/hinfo/,  which  is  normally included with the use

       Examples of %registries, %refer, $whoistrash, and $whoismltrash are  in
       /var/lib/hinfo/,  which is also normally included with use.





                           Version 1.01: 10 Aug 2003             hinfo.conf(5)