mvmf: dnsblc man page

mvmf: dnsblc man page


DNSBLC(1)                                               DNSBLC(1)


NAME
       dnsblc - command line interface to DNSBL

SYNOPSIS
       dnsblc [-q] [-v] ip-addr [blname [rcode]]

DESCRIPTION
       dnsblc  queries  one  or  more  DNSBLs  (DNS-based  block-
       list/blacklist) for a particular IP address.   It  uses  a
       DNSBL  registry in a file "dnsbl.conf" typically installed
       in a mvmf public area.  (A sample is included with  mvmf.)

       Options which may be given are as follows:

       -q     quiet mode.  Does not print any output.

       -v     verbose  mode.   Normally,  dnsblc will only report
              hits against DNSBL(s).  When this option is  given,
              dnsblc  prints  a  line  for  each  DNSBL and rcode
              tested.

       ip-addr is the IP address to be tested.

       blname, if given, is the name of a blocklist  (as  defined
       in  dnsbl.conf)  to  test.   If  omitted,  all  blocklists
       defined in dnsbl.conf are queried.

       rcode, if given, is the specific code  for  the  specified
       blocklist to test, as defined in dnsbl.conf .  Each block-
       list may have one or more kinds of results defined.  Typi-
       cally  the  primary  result  code  is defined as "std" and
       alternate result types are given other names.

OPERATION
       dnsblc will print a line for every blname/rcode for  which
       there is a "hit" on the ip-address.  This behaviour may be
       modified by the "-q" and "-v" flags as described above.

       On exit, dnsblc will give a status code of 0 if any of the
       blocklists  were  hit, and will give a status code of 1 if
       there were no hits.

       Examples (some results omitted for brevity):

         % dnsblc 127.0.0.2
         127.0.0.2 against sorbs/spam:  positive
         127.0.0.2 against sorbs/zombie:  positive
         127.0.0.2 against spamcop/std:  positive
         127.0.0.2 against spamhaus/sbl:  positive
         127.0.0.2 against spamhaus/xbl:  positive
         127.0.0.2 against spamhaus/std:  positive

         % dnsblc -q 127.0.0.2
         %

         % dnsblc -v 127.0.0.2
         127.0.0.2 against sorbs/http:  negative
         127.0.0.2 against sorbs/socks:  negative
         127.0.0.2 against sorbs/misc:  negative
         127.0.0.2 against sorbs/relay:  negative
         127.0.0.2 against sorbs/spam:  negative
         127.0.0.2 against sorbs/web:  positive
         127.0.0.2 against sorbs/block:  negative
         127.0.0.2 against sorbs/zombie:  negative
         127.0.0.2 against sorbs/dul:  positive
         127.0.0.2 against spamcop/std:  positive
         127.0.0.2 against spamcop/ext:  negative
         127.0.0.2 against spamhaus/sbl:  positive
         127.0.0.2 against spamhaus/xbl:  positive
         127.0.0.2 against spamhaus/std:  positive
         127.0.0.2 against visi.relays/std:  negative
         %



SEE ALSO
       http://www.mvmf.org/ -- the mvmf web site.

CREDITS TO
       M. Mallett  (mem@mv.mv.com)   2005,2006,2007

BUGS
       You tell me..