NAME

SYNOPSIS

DESCRIPTION

RUNNING WCMGR

COMMAND LINE OPTIONS

-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

COPYRIGHT

AUTHOR