NAME

       wcmgr - Webalizer (DNS) Cache file Manager

SYNOPSIS

       wcmgr [ option ... ] cache-file

DESCRIPTION

       wcmgr  is  a  utility  program  which allows manipulation of the DNS cache files used and produced by The
       Webalizer.  Each record in the cache file contains an IP address (either IPv4 or IPv6),  a  timestamp  of
       when  the entry was added to the cache, a flag to indicate if the record contains a resolved name or not,
       and either the same IP address or a resolved host name.  All records are accessed by their IP address.

RUNNING WCMGR

       wcmgr was designed to be run from the Unix shell command line.  This facilitates its use in shell scripts
       and other automated processes.  A valid DNS cache file must  be  specified.   Command  line  options  are
       optional, and if none are given, the default action is to list the contents of the specified cache file.

COMMAND LINE OPTIONS

       Different  functions  are  selected  by  using  one or more of the following command line options.  If no
       options are given, the default is to display the contents of the cache file to the screen (stdout).

       -h      Display all available command line options and exit.

       -v      Be verbose.

       -V      Display the program version and exit.  Additional program specific information will be  displayed
               if verbose mode is also used (e.g. '-vV'), which can be useful when submitting bug reports.

       -a address [-n hostname] [-t0]
               Add  a  new  record  to the cache file.  The IP address will be added to the cache file using the
               current time as the timestamp and with a resolved name hostname.  If -t0 is specified, the record
               will be considered permanent, and will not be removed (during a purge) or expired.  If a hostname
               is not specified with the -n option, then the address will be used instead, and the  record  will
               be flagged as unresolved.

       -c      Create  a  new  cache  file.  If used alone, this option will create a new, empty cache file.  If
               used with the import option, a new cache file will be created  before  importing  the  data.   An
               error will occur if the file cache-file already exists.

       -d address
               Delete a record from the cache file using the specified address.

       -f address
               Find  and  display  information  for  address from the cache file.  A single line similar to that
               produced by the -l option will be displayed unless verbose mode is enabled, in which case a  more
               detailed listing will be produced.

       -i name [-c]
               Import  data  into  the  cache  file  from  the  file  name.  The import file must be a valid tab
               delimited text file, such as that created by the export option.  If the  imported  data  contains
               records  already  present  in  the  cache file, those records will be overwritten by the imported
               data.  The cache file must exist unless the -c option is specified, in which case,  a  new  cache
               file will be created for the imported data.

       -l      List  the  contents  of  the  cache file.  This is the default action of the program, so does not
               necessarily need to be specified.  If verbose mode is enabled, a report title, column headers and
               summary totals will also be displayed.

       -p num  Purge the cache file of entries older than num days.  If num is not specified, then a default  of
               7  days  will  be  used.   if verbose mode is enabled, each purged record will be printed and the
               total number of purged records will be displayed.

       -s [-t num]
               Display cache file information/statistics.  If a TTL value (in days) is specified  using  the  -t
               option,  it  will  be  used to calculate how many records are older than num days, otherwise, the
               default value of 7 days will be used.

       -n name Specify the name to use as the resolved hostname when adding records to the cache.

       -t num  Time to live (TTL) value.  If used along with the -p (purge) option, it specifies how many days a
               record will remain valid.  Any record that is older than num days is considered expired and  will
               be purged.  If used with the -a (add) option, a zero value will cause the record to be considered
               permanent.

       -x name Export  data  from  a  cache file to a tab delimited text file named name.  If the text file name
               exists, it will be overwritten.

BUGS

       Please report bugs to the author.

COPYRIGHT

       Copyright (C) 1997-2013 by Bradford L. Barrett.  Distributed under the GNU GPL.  See the files  "COPYING"
       and "Copyright", supplied with all distributions for additional information.

AUTHOR

       Bradford L. Barrett <brad at mrunix dot net>

Version 1.00                                       12-Jul-2008                                          wcmgr(1)