Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
rblckeck(1)		     General Commands Manual		     rblckeck(1)

NAME
     rblckeck - DNSBL lookup utility

SYNOPSYS
     rblcheck [-s zone] [-S zone-file] [-c] [-tmvq] [-n nsaddr] address...

DESCRIPTION
     rblcheck  is  a simple command-line to perform DNSBL (DNS-based blocklists)
     lookups.  For every IP address (or a name, in which case  it  will  be  re-
     solved  to an address first), the utility verifies whenever it is listed in
     a (list of) DNS blocklists specified with -s or -S options, optionally  ob-
     tains  text associated with the listing (usually it is either some descrip-
     tion about the reason of the listing or an URL referring to such a descrip-
     tion), and displays results on standard output.

     The program is implemented on top of udns(3) library.

OPTIONS
     The following options are recognized by rblcheck:

     -s zone
	    add the given zone DNSBL name to the list of active zones.

     -S zone-file
	    add list of zones from the named zone-file to  the	list  of  active
	    zones  (the  file  specifies  one  zone as the first word on a line,
	    empty lines and lines starting with `#' character are ignored).

     -c     reset active zone list.

     -v     be more verbose, produce more detailed output.

     -q     the opposite for -v -- produce less detailed output.

     -t     obtain text for listed addresses.

     -n nsaddr
	    Use the given nameserver (given as IPv4 or IPv6 address) instead  of
	    the  default.  The same effect may be achieved by setting $NSCACHEIP
	    environment variable.

     -m     stop after first hit, ie after the first address which is  found  to
	    be listed.

     -h     print short help and exit.

     If  no -s, -S and -c options are given, rblcheck will try to obtain list of
     zones using $RBLCHECK_ZONES  environment  variable,  or  ~/.rblcheckrc,  or
     /etc/rblckechrc  files, in that order.  If no zones are found, it will exit
     unsuccessefully.

RETURN VALUE
     When no addresses given are listed and no errors occurred,  rblcheck  exits
     with  code 0.  If at least one address is listed, rblcheck returns 100.  In
     case of DNS errors, rblcheck returns 2.

ENVIRONMENT
     $RBLCHECK_ZONES
	    if no -s, -S or -c option is given, rblcheck tries this variable  to
	    obtain list of DNSBL zones to check against.

FILES
     $HOME/.rblcheckrc and /etc/rblcheckrc
	    if	no -s, -S or -c option is given, and no $RBLCHECK_ZONES environ-
	    ment variable is set, rblcheck will try the two files (the first one
	    that exists) to obtain list of DNSBL zones to check  against.   Each
	    line  specifies  one  zone	(only  first word in each line is used).
	    Empty lines and lines starting with `#' character are ignored.

SEE ALSO
     dnsget(1) resolv.conf(5) udns(3).

AUTHOR
     This program and manual pages are written by Michael Tokarev.

User Utilities			    Apr 2005			     rblckeck(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rblcheck&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help