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 Windows). If you prefer not to use the user interface, this option is required.

-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. The use of this feature is not recommended.

-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 the Server Configuration Tips section to log cookies as part of the regular access log. This 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 in a subdirectory called agents 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 in a subdirectory called referrers (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. See the Server Configuration Tips section for more information.

-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 picks up exactly where it left off the last time it was run without -b. 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. In Wusage 7.0 and above, only those reporting time periods which are completely within the time range specified by -b and -e will be updated. The cumulative summary report cannot be updated in this manner. 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. In Wusage 7.0 and above, only those reporting time periods which are completely within the time range specified by -b and -e will be updated. The cumulative summary report cannot be updated in this manner. 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 only update the cumulative summary report. The use of this option is not recommended in Wusage 7.0. This option overrides the Daily Reports ^(daily), Weekly Reports ^(weekly), Monthly Reports ^(monthly), Quarterly Reports ^(quarterly), Annual Reports ^(annual), Summary Reports ^(summary), and frequency ^(frequency) options.

-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 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 Log Files and Directories (logfiles) option, specifying a single log file to be analyzed. 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. See the Analyzing Many Log Files section for more information.

-t minutes

The -t option is used to specify an idle timeout for the Wusage web-based user interface. Under Unix, Wusage will "time out" and shut down after 20 minutes, if it has not been used during that time. However, the Macintosh and Windows 95/98/NT versions do not time out by default, unless the program is running in a CGI environment. This change was made to accommodate the built-in scheduling feature. See the Running Wusage Automatically section for more information.

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

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

---

---

---