DragonFly On-Line Manual Pages

Search: Section:  

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, --no-stats
               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)

Search: Section: