Man Pages

wcmgr(1) - phpMan wcmgr(1) - phpMan

Command: man perldoc info search(apropos)  


wcmgr(1)                         The Webalizer                        wcmgr(1)



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 con-
               sidered 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 unre-
               solved.

       -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 list-
               ing 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  necessar-
               ily  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  perma-
               nent.

       -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)