Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
wcmgr(1)			 The Webalizer			      wcmgr(1)

       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 con-
       tains  a	 resolved name or not, and either the same IP address or a re-
       solved 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  op-
       tional,	and  if	none are given,	the default action is to list the con-
       tents 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 dis-
       play 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  spe-
	       cific  information  will	 be  displayed if verbose mode is also
	       used (e.g. '-vV'), which	can be useful when submitting bug  re-

       -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 cre-
	       ate 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  ad-

       -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 cre-
	       ated 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  ac-
	       tion  of	the program, so	does not necessarily need to be	speci-
	       fied.  If verbose mode is enabled, a report title, column head-
	       ers 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  ver-
	       bose  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 cal-
	       culate 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 overwrit-

       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>

Version	1.00			  12-Jul-2008			      wcmgr(1)


Want to link to this manual page? Use this URL:

home | help