debian man page for jdresolve

JDRESOLVE(1)						User Contributed Perl Documentation					      JDRESOLVE(1)

NAME
       jdresolve - resolves IP addresses into hostnames

SYNOPSIS
       jdresolve  [-h]	 [-v]	[-n]   [-r]   [-a]  [-d  <level>] [-m	<mask>]   [-l  <line  cache>]  [-t  <timeout>]	[-p] [-s    <number   of
       sockets>]   [--database=<db   path>] <LOG FILE>

       jdresolve  [--help]  [--version] [--nostats] [--recursive] [--anywhere]	     [--debug=<level>]	     [--mask=<mask>] [--linecache=<line
       cache>]		 [--timeout=<timeout>] [--sockets=<number of sockets>]	   [--database=<db path>] [--dbfirst]	   [--dbonly]
       [--dumpdb]     [--mergedb] [--expiredb=<hours>]	    [--unresolved]	[--progress] <LOG FILE>

DESCRIPTION
       jdresolve  resolves  IP	addresses  to hostnames. Any file format  is  supported, including those where the line does not  begin  with  the
       IP  address.  One  of the strongest features  of  the program  is  the  support for recursion, which  can  drastically  reduce  the  number
       of unresolved hosts  by	faking a hostname based on the network that the IP  belongs  to.  DNS  queries are sent in parallel, which means
       that  you  can  decrease run time by increasing the number  of  simultaneous sockets used (given a fast enough machine and available
       bandwidth ).  By  using the database support,  performance  can	be  increased even further, by using cached data from previous runs.

OPTIONS
       -h, --help
	       produces a short help message

       -v, --version
	       display version information

       -n, --nostats
	       don't display stats after processing

       -r, --recursive
	       recurse	into  C, B and A classes when there is no PTR (default is no recursion)

       -d, --debug=<debug-level>
	       debug  mode  -  no  file  output,  just statistics during run (verbosity level range: 1-3)

       -t, --timeout=<seconds>
	       timeout	 in  seconds  for  each  host  resolution (default is 30 seconds)

       -l, --line-cache=<lines>
	       numbers	of  lines  to cache in memory (default is 10000

       -s, --sockets=<sockets>
	       maximum	number	of concurrent sockets (use ulimit -a  to  check  the  max allowed for your operating system - defaults to 64)

       -m, --mask=<mask>
	       <mask>  accepts	%i for IP and %c for class owner, e.g.	"somewhere.in.%c"  or "%i.in.%c" (default is "%i.%c")

       -a, --anywhere
	       resolves  IPs  found  anywhere  on  a  line  (will resolve all IPs if there is more than one)

       -p, --progress
	       prints  a  nice progress bar indicating the status of the resolve operations

       --database=<db path>
	       path to database that holds resolved hosts/classes

       --dbfirst
	       check  if we have resolved entries in the database before sending out DNS queries

       --dbonly
	       don't  send DNS queries, use only resolved data in the database

       --dumpdb
	       dumps a database to STDOUT

       --mergedb
	       merges  resolved IP/classes from a file (or STDIN) with a database

       --expiredb=<hours>
	       expires	entries  in  the  database that are older than <hours> hours

       --unresolved
	       won't  attempt  to  resolve  IPs, only lists those that were not resolved

       <LOG FILE>
	       the log filename or '-' for STDIN

EXAMPLES
	   jdresolve access_log > resolved_log
	   jdresolve -r -s 128 access_log > resolved_log
	   jdresolve -r --database hosts.db access_log > res_log

SEE ALSO
       rhost(1)

AUTHOR
       jdresolve was written by John D. Rowell <me@jdrowell.com>, and  is licensed under the terms of the GNU General Public License.

       The original version of this man page was written by Craig Sanders   <cas@taz.net.au>,	for   the  Debian  GNU/Linux package of jdresolve,
       and is also licensed under the terms of the GNU GPL.

3rd Berkeley Distribution				       perl 5.005, patch 03						      JDRESOLVE(1)