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

FreeBSD Manual Pages

  
 
  

home | help 
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 facil-
     itates 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 com-
     mand  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  oc-
	     cur 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  dis-
	     played  unless  verbose  mode  is enabled, in which case a more de-
	     tailed 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  al-
	     ready  present in the cache file, those records will be overwritten
	     by the imported data.  The cache file must exist unless the -c  op-
	     tion  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 ver-
	     bose 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 calcu-
	     late how many records are older than num days, otherwise,	the  de-
	     fault 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)  op-
	     tion,  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
     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  distribu-
     tions for additional information.

AUTHOR
     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:
<https://man.freebsd.org/cgi/man.cgi?query=pl-wcmgr&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help