-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.

-n

The -n option prevents Wusage 6.0 and later from attempting to resume log file analysis where it "left off" on the previous run. Instead the program assumes it must begin at the beginning of the appropriate day, week, or month. This matches the behavior of Wusage 5.0 and earlier.

-ac

The -ac option is used to specify that wusage should analyze a stand-alone Apache cookie log. These logs are produced by the Apache web server, versions prior to 1.2, if and only if the server was compiled with the "mod_cookies" module. See also the CookieLog directive in the Apache server documentation. This option produces useful reports of user activity as determined by cookies. You should use a SEPARATE report directory to avoid conflict with your regular statistics! For better reports, use Apache 1.2 or better and configure your server to log cookies as part of the regular access log. You can then use the apachecookies configuration file option, which is greatly superior because the users report is generated side by side with the regular reports.

-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. Please send the output of this option, along with a description of your operating system and web server software, when writing to Boutell.Com, Inc.

-p portnumber

The -p option causes the web interface of Wusage 6.0 Patchlevel 13 and later to listen on an alternate port instead of the standard Wusage port number, which is 2396.

-ps proxyserverhost

The -ps option is used to specify a proxy server host name to be used for HTTP and FTP log file fetches. See also -pp.

-pp proxyserverport

The -pp option is used to specify a proxy server port number to be used for HTTP and FTP log file fetches. See also -ps.

-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.

-t minutes

The -t option is used to specify an idle timeout for the Wusage web-based user interface. PRIOR to wusage 6.0 P23, all versions of Wusage "timed out" and shut down after 20 idle minutes. In Wusage 6.0 P23 and later, this is still the default under Unix. However, the Macintosh and Windows 95/98/NT versions do not time out by default. This change was made to accommodate the built-in scheduling feature of Wusage 6.0 P23 and above.

-t should be followed by the number of idle minutes after which the web interface should automatically shut down. To shut off the idle timeout under Unix, use the value 0.

-remote

The -remote option is used to instruct Wusage for Windows 95, 98 and NT to offer the same web-browser-based user interface that is used under other operating systems. Normally, Wusage 6.0 P25 and up for Windows 95, 98 and NT uses its own graphical interface, which is similar but takes full advantage of conveniences such as file selection dialog boxes. Also, the built-in interface does not run into problems when a browser is configured to rely entirely on a proxy server. However, if you prefer the web-based remote administration facility, just use this option to bring it back.

Copyright 1998, 1999, Boutell.Com, Inc.
Contact Us

Boutell.Com, Inc - PO Box 63767, Philadelphia PA, 19147, USA
Phone/Fax +1 206. 658. 8176