The command Line Options for GWFstats 1.1
Usage:
gwfstats
[-h] [-v] [-A] [-a N] [-B regex] [-C] [-c N] [-D] [-d N]
[-F] [-f N] [-g Statfile] [-i StatFileList] [-I regex]
[-L] [-N name] [-o StatFile] [-P URLpath] [-p path]
[-Q] [-q R] [-R regex] [-r regex] [-T regex] [-t type]
[-u regexList] [-X regex] [-x regex] [-Y] [-y] [-Z] [-z]
[LogFileList]
Options:
option
description
default
example
-h
Display this help message and quit.
do not
-h
-v
Display version and quit.
do not
-v
-A
Do not print Archive Sections report
do it
-A
-a N
Print Top N Archives
0
-a 10
-B regex
Blank out partial URLs matching the regex
-B '(^\/cgi-bin\/search.*)'
-C
Do not print full hosts listing
do it
-C
-c N
Print Top N Hosts
0
-c 10
-D
Do not print full top level domain report
do it
-D
-d N
Print Top N Top Level Domains
0
-d 10
-F
Do not print full file listing
do it
-F
-f N
Print Top N Files
0
-f 10
-g StatFile
Name of the file where graphic reports are stored
-g graphs.html
-I regex
Directory Index pages (see NCSA option: DirectoryIndex)
-I '([Ii]ndex.html|[Ww]elcome.html)'
-i StatFileList
Include Reports from old Files (assumed to be a prior output of
the same version of gwfstats).
-i /htdocs/stats/9701/c.html,/htdocs/stats/9702/c.html
-L
Do not perform hostname lookups of unresolved addresses
do it
-L
-N name
System name for report
www.dom.ain
-N irb.cs.uni-magdeburg.de
-O order
Order of include/exclude/replace functions to perform
uUxXrR
-o ru
-o StatFile
Name of the file where non-graphic reports are stored
-o stats.html
-p path
System Directory where the generated files are to be stored.
/htdocs/stats/current
-p /htdocs/stats/9701
-Q N
Volume Quota in bytes
0 (means no quota)
-Q 1048576
-q R
Quota Rate in US$/meg/day over volume quota
0
-q 0.15
-R regex
Do not include refs to files matching the perl regex
-R '^\/cgi-bin\/.*'
-r regex
Only include refs to files matching the perl regex
-r '((\/~elkner.*)|(\/~myfriend.*))'
-T regex
Filter top N file list to exclude regex
-T '(\.xbm$|\.gif$|\.png$|\.jpg$)'
-t logtype
Select whether log files are to be processed as FTP
xferlogs, Common Log format, NCSA Combined format, or
Apache multihomed server log format.
common
-t ftp
-U substExprList
A @@ separated List of Perl substitute expressions for
doing Hostname Substitutions/Replacements
-u '^wotan$@@wotan.cs.uni-magdeburg.de'
-u substExprList
A @@ separated List of Perl substitute expressions for
doing FileName Substitutions/Replacements
-u '^/((ATM)|(Architext)|(Mbone))$@@\/$1\/'
-X regex
Do not include any domain/host name matching the perl regex
-X virtual.website.com
-x regex
Only include any domain/host name matching the perl regex
-x cs.uni-magdeburg.de
-Y
Do not print Hourly stats
do it
-Y
-y
Do not print Daily stats
do it
-y
-Z
Do not print summary report
do it
-Z
-z
Do not print Status summary report
do it
-z
Terms:
N
Number of type Integer >= 0
R
Number of type Real
StatFile
regular file name where generated reports are stored
(path or URLpath are automatic. prefixed if necessary)
LogFileList
a whitespace separated list of httpd access log files
(compressed files like file.Z or file.gz are allowed)
StatFileList
a comma separated list of $Version generated files
containing reports from previous runs
logtype
What kind of log you want to analyze (default = common)
common = WWW common log format
ftp = FTPd log
combined = NCSA combined log format
apache = Apache multi-homed log
order
the same as include/exclude/replace switches - i.e.,
[[r][R][u][U][x][X]].
E.g. sometimes it might be necessary first to
execute the 'include only rule' submitted via -r option and than the 'replace
rule' submitted via option -u. In that case you would specify -O ru
regex
Perl regular expression
regexList
2 Perl regexs separated by @@ (i.e. regex@@regex)
Example:
Follow this link to see, how we generate statistics for our web server.