mvmf: dnsblc man page

mvmf: dnsblc man page


DNSBLC(1)                   General Commands Manual                   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 blocklist/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:

       -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 blocklist may have  one  or  more
       kinds  of results defined.  Typically 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 mywhitelist/std:  positive
         127.0.0.2 against mybl/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 mywhitelist/std:  positive
         127.0.0.2 against mybl/std:  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
         %

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

CREDITS TO
       M. Mallett  (mem@mvmf.org)    2005-2007,2024-2025

BUGS
       You tell me..

                                                                      DNSBLC(1)