Provided by: hinfo_1.02-4_all bug
 

NAME

        ~/.hinforc - hinfo configuration file
        /etc/hinfo.conf
        /usr/local/etc/hinfo.conf
 

DESCRIPTION

        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  con‐
        figuration 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.   New‐
        lines are not treated specially otherwise, but should be used for read‐
        ability.  Whitespace between tokens is ignored.
 

STATEMENTS

        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.
 

ASSIGNMENTS

        $SCALAR = VAL;
        @ARRAY = ( [VAL,]... );
        %HASH = ( [VAL1 => VAL2,]... );
 
        In array and hash assignment, the  comma  before  the  close  paren  is
        optional.
 
        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  expan‐
        sions 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
 

VARIABLES

        The following variables are defined: (options that effect values are in
        parens.)
 
        $html  (-u) nonzero indicates html mode
 
        $pager (-p, -n) Pager used
 
        $verbose
               (-v) values -3 through 3 specify how many messages are displayed
 
        $no_abuse
               (-a)
 
        $no_blackhole
               (-b)
 
        $no_whois
               (-w)
 
        $no_domain
               (-d)
 
        $whoistrash
               Regular expression of what to ignore in whois output.
 
        $whoismltrash
               Regular expression of multi-line ignores in whois output.
 
        $exclude
               Regular  expression of blackhole lists to not use.  Used to mod‐
               ify both @bhlists and @domainbased.
 
        $expand_handles
               (-e) Negative to never expand NIC handles Zero to  expand  first
               NIC handle only Positive to expand all NIC handles
 
        $timeout
               (-t) Number of seconds to wait for DNS and whois servers.  Time‐
               outs only occur when there have been no results from any request
               for this amount of time.
 
        $whoistimeout
               Timeout parameter to IO::Socket::INET->new call.
 
        $nameserver
               (-s)
 
        $mx    (-m)
 
        @bhlists
               IP based blackhole lists to use.
 
        @domainbased
               Domain based blackhole lists to use.
 
        @version
               Displayed by --version
 
        %registrys
               Hash mapping most significant IP octet to whois server
 
        %refer
               Hash  containing  information  about  whois servers referring to
               other whois servers.
 

EXAMPLE

        # use system defaults
        use "/etc/hinfo.conf";
        # set verbose mode
        $verbose = 3;
        # exclude .blackholes.us 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
        \&explain_bitmask
               Use  the  least  significant  bits  of the IP returned as binary
               flags for each of the entries the the list referenced by parame‐
               ter.
 
        \&explain_iterate
               Use  the  least  significant bits of the IP returned as an index
               into the list referenced by parameter.
 
        \&explain_txt
               Fetch the TXT record from the DNSBL.
 
        \&explain_iterate_txt
               Perform actions of both \&explain_iterate and \&explain_txt.
 

USAGE

        Examples     of     @bhlists     and      @domainbased      are      in
        /var/lib/hinfo/dnsbl.ins.pl,  which  is  normally included with the use
        statement.
 
        Examples of %registries, %refer, $whoistrash, and $whoismltrash are  in
        /var/lib/hinfo/whois.ins.pl,  which is also normally included with use.
        hinfo(1)
 

FILES

        /var/lib/hinfo/dnsbl.ins.pl
        /var/lib/hinfo/whois.ins.pl
 
                            Version 1.01: 10 Aug 2003             hinfo.conf(5)