1wcmgr(1) The Webalizer wcmgr(1)
2
6 wcmgr - Webalizer (DNS) Cache file Manager
7
9 wcmgr [ option ... ] cache-file
10
12 wcmgr is a utility program which allows manipulation of the DNS cache
13 files used and produced by The Webalizer. Each record in the cache
14 file contains an IP address (either IPv4 or IPv6), a timestamp of when
15 the entry was added to the cache, a flag to indicate if the record con‐
16 tains a resolved name or not, and either the same IP address or a
17 resolved host name. All records are accessed by their IP address.
18
20 wcmgr was designed to be run from the Unix shell command line. This
21 facilitates its use in shell scripts and other automated processes. A
22 valid DNS cache file must be specified. Command line options are
23 optional, and if none are given, the default action is to list the con‐
24 tents of the specified cache file.
25
27 Different functions are selected by using one or more of the following
28 command line options. If no options are given, the default is to dis‐
29 play the contents of the cache file to the screen (stdout).
30 -h Display all available command line options and exit.
32 -v Be verbose.
34 -V Display the program version and exit. Additional program spe‐
37 cific information will be displayed if verbose mode is also
38 used (e.g. '-vV'), which can be useful when submitting bug
39 reports.
40 -a address [-n hostname] [-t0]
42 Add a new record to the cache file. The IP address will be
43 added to the cache file using the current time as the timestamp
44 and with a resolved name hostname. If -t0 is specified, the
45 record will be considered permanent, and will not be removed
46 (during a purge) or expired. If a hostname is not specified
47 with the -n option, then the address will be used instead, and
48 the record will be flagged as unresolved.
49 -c Create a new cache file. If used alone, this option will cre‐
51 ate a new, empty cache file. If used with the import option, a
52 new cache file will be created before importing the data. An
53 error will occur if the file cache-file already exists.
54 -d address
56 Delete a record from the cache file using the specified
57 address.
58 -f address
60 Find and display information for address from the cache file.
61 A single line similar to that produced by the -l option will be
62 displayed unless verbose mode is enabled, in which case a more
63 detailed listing will be produced.
64 -i name [-c]
66 Import data into the cache file from the file name. The import
67 file must be a valid tab delimited text file, such as that cre‐
68 ated by the export option. If the imported data contains
69 records already present in the cache file, those records will
70 be overwritten by the imported data. The cache file must exist
71 unless the -c option is specified, in which case, a new cache
72 file will be created for the imported data.
73 -l List the contents of the cache file. This is the default
75 action of the program, so does not necessarily need to be spec‐
76 ified. If verbose mode is enabled, a report title, column
77 headers and summary totals will also be displayed.
78 -p num Purge the cache file of entries older than num days. If num is
80 not specified, then a default of 7 days will be used. if ver‐
81 bose mode is enabled, each purged record will be printed and
82 the total number of purged records will be displayed.
83 -s [-t num]
85 Display cache file information/statistics. If a TTL value (in
86 days) is specified using the -t option, it will be used to cal‐
87 culate how many records are older than num days, otherwise, the
88 default value of 7 days will be used.
89 -n name Specify the name to use as the resolved hostname when adding
91 records to the cache.
92 -t num Time to live (TTL) value. If used along with the -p (purge)
94 option, it specifies how many days a record will remain valid.
95 Any record that is older than num days is considered expired
96 and will be purged. If used with the -a (add) option, a zero
97 value will cause the record to be considered permanent.
98 -x name Export data from a cache file to a tab delimited text file
100 named name. If the text file name exists, it will be overwrit‐
101 ten.
102
104 Please report bugs to the author.
105
107 Copyright (C) 1997-2013 by Bradford L. Barrett. Distributed under the
108 GNU GPL. See the files "COPYING" and "Copyright", supplied with all
109 distributions for additional information.
110
112 Bradford L. Barrett <brad at mrunix dot net>
113Version 1.00 12-Jul-2008 wcmgr(1)