DragonFly On-Line Manual Pages

hinfo.conf(5)            DragonFly File Formats Manual           hinfo.conf(5)

NAME
       ~/.hinforc
       /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
       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.

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
       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

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
              modify 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.
              Timeouts 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)

       @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$";

BLACKHOLE LISTS
       @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 SUBROUTINES
       \&explain_bitmask
              Use the least significant bits of the IP returned as binary
              flags for each of the entries the the list referenced by
              parameter.

       \&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.

SEE ALSO
       hinfo(1)

FILES
       /var/lib/hinfo/dnsbl.ins.pl
       /var/lib/hinfo/whois.ins.pl

                            Version 0.94: 10 Nov 02              hinfo.conf(5)