Command Line Options

The wusage program supports the following command line options:

-c config_file_name: The -c option should be followed by the name of the configuration file (typically wusage.conf or wusage.con under DOS). This is the only required command line option.
-u (always used with -l): The -u option is used to specify that wusage should analyze a stand-alone user agent log. This option is always used in conjunction with the -l filename option, which indicates where the user agent log file is located. This option produces a report called agents.html in the report directory. This special filename is used to avoid overwriting the normal output of wusage. It is better to configure your web server to log this information in the regular server log so it can be analyzed as part of your normal reports.
-r (always used with -l): The -r option is used to specify that wusage should analyze a stand-alone referrer log. This option is always used in conjunction with the -l filename option, which indicates where the referrer log file is located. This option produces a report called referrers.html (note the spelling) in the report directory. This special filename is used to avoid overwriting the normal output of wusage. It is better to configure your web server to log this information in the regular server log so it can be analyzed as part of your normal reports.
-b MM/DD or MM/DD/YY or MM/DD/YYYY: The -b option is used to specify the date from which wusage should begin producing reports. If the -b option is not specified, wusage generates reports beginning with the day or week immediately following the last day or week generated on a previous run, or from the first date in the log file if wusage has not been run before. If the -b option is specified, wusage will produce reports from that date forward to the present day, or another ending date specified by the -e option. Three date formats are supported: MM/DD (example: 9/29), MM/DD/YY (example: 9/29/1980), and MM/DD/YYYY (example: 9/29/1980). This option is useful if you have accidentally run wusage on a partial log file and wish to run it again to re-generate the reports for the missing days using data in another log file.
-e MM/DD or MM/DD/YY or MM/DD/YYYY: The -e option is used to specify the date on which wusage should stop producing reports. If the -e option is specified, wusage will produce reports up to and including that date. Otherwise, wusage will produce reports through the most recent complete day or week. Three date formats are supported: MM/DD (example: 9/29), MM/DD/YY (example: 9/29/1980), and MM/DD/YYYY (example: 9/29/1980). This option is useful if you wish to run wusage on only a certain time period found in a large log file, especially if you are generating a summary report.
-s: The -s option specifies that wusage should generate a summary report. This option overrides the frequency configuration file option.
-v: The -v option displays the version number of wusage.
-l log_file_or_directory or -: The -l option is used to override the logfile or logdir configuration file option. If the -l option is given, the specified log file or directory of log files will be analyzed instead. If the special log file name - (a single dash) is given, wusage will expect to read its input from standard input. This is particularly useful when working with pipelines of several commands such as the Unix cat and zcat commands.

Note: because wusage has so many useful options, it is primarily controlled by configuration file options rather than command line options.

Table of Contents

Boutell.Com, Inc - PO Box 63767, Seattle WA, 98102, USA
Phone/Fax +1 206. 658. 8176