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>