wcmgr - Webalizer (DNS) Cache file Manager
wcmgr [ option ... ] cache-file
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.
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.
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.
Please report bugs to the author.
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.
Bradford L. Barrett <brad at mrunix dot net>