The wusage program supports the following command line options:

-a account_name

The -a option should be followed by the name of the ISP mode account to be updated. Wusage uses this option internally when launching updates, in conjunction with the -l option and the -truncate option.

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

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

-bps XXXXX

The -bps option should be followed by the rated speed of your Internet connection, in bits per second. For instance, for a 56K modem, this value is 56000. Specify the incoming or outgoing speed, whichever is LEAST. This option ensures that Wusage can take best advantage of its new fast DNS query capabilities.

-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). This option causes an update of the specified "advanced mode" configuration (not associated with any ISP mode account).

-compressed

The -compressed option forces Wusage to produce compressed reports. See the Optimization section of the manual for more information.

-d

The -d option MUST be preceded by the -c option and a configuration file name, or the -a option and an account name. When the -d option is present, Wusage removes all existing reports and work-in-progress information, except for the DNS cache. This option must follow, not precede, the -c or -a option and its argument.

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

-id identifier

The -id option is used to specify a unique identifier for use in terminating the program gracefully, and in reporting the current status of the program. This option is used internally.

-l log_file_or_directory or -

The -l option is used to override the ^(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.

-memory

The -memory option forces Wusage to optimize for lowest memory use, at the potential expense of longer total analysis time.

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

-noinstall

Unix users: the -noinstall option allows Wusage to be started without the automatic installation of crontab entries for scheduled updates and automatic restart of the program. This option can be combined with other options. the -c option implies noinstall.

-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. When -p or any other option is present, -server is not assumed. If you wish the program to run in the background and accept logins for more than one ISP mode account, also specify -server.

-pp proxyserverport

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

-ps proxyserverhost

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

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

-remote

The -remote option is present for backwards compatibility only. Recent releases of Wusage for Windows 95/98/2000/NT provide two binaries: wusageg.exe and wusage.exe. wusageg.exe is the version with a built-in graphical user interface; wusage.exe behaves exactly like the Unix version. In earlier releases the -remote option was used to turn off the graphical interface, as in the Unix version. This is no longer necessary and wusage.exe should be used instead when such behavior is desired.

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

-server

The -server option instructs Wusage to run permanently in the background and accept connections from one or more Wusage accounts. This behavior is also automatically invoked by running the NT service or Unix version of Wusage with no command line options, as of version 8.0 P8.

-speed

The -speed option forces Wusage to optimize for fastest analysis, at the potential expense of higher memory use.

-t minutes

The -t option is used to specify an idle timeout for the Wusage web-based user interface. Individual user sessions, logged into Wusage, will "time out" and shut down after 20 minutes by default if the program has not been used by that time. The main Wusage server process continues to run in any case once it is launched and will start new user sessions as needed. To shut off the idle timeout for individual user sessions, use -t 0. However, the use of a timeout is recommended.

-truncate

The -truncate option causes Wusage to truncate log files after analysis. Filenames ending in .gz or .zip are not truncated, as they are assumed to be archival information. If analysis is not completely successful, truncation is not performed. Truncation reduces the size of each log file to zero. This is preferable to deletion because certain web servers will not automatically recognize a deleted log file and begin logging again.

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

-uncompressed

The -uncompressed option forces Wusage NOT to produce compressed reports. See the Optimization section of the manual for more information.

-uninstall

Unix users: the -uninstall option removes any crontab entries made to automatically start Wusage for scheduled updates and/or automatic startup of the program. This option does not delete any other files and can be safely used.

-update-all-accounts

The -update-all-accounts option causes a complete update of all Wusage ISP mode accounts, including log rotation and archiving if they have been turned on, regardless of the schedule settings. This option does NOT update individual advanced mode configuration files or the simple mode account. This option is useful for testing purposes. See Configuring the Program in ISP Mode for more information.

-v

The -v option displays the version number and patchlevel of wusage. Please send the output of this option, along with a description of your operating system and web server software, when writing to This information can also be found at the top of each page of the web interface or Windows GUI.

-wusage-check-server

The -wusage-check-server option causes Wusage to check to see whether it is currently installed on port 2396 to talk to web-based clients. If the program is not already running, it is launched in the background to accept such connections. This is very similar to the behavior of the program with no command line arguments, except that no error message is produced if the port is already in use; the program assumes that it is already running properly in another process. Wusage 8.0 P8 and above for Unix automatically install a scheduled cron job which causes the program to be launched with this option every 5 minutes (terminating instantly if it has no work to do, of course). This removes the need for manual installation in Unix startup scripts and provides a "watchdog" in case the program shuts down for any reason.

-wusage-scheduled-update

The -wusage-scheduled-update option causes a complete update of all Wusage accounts and configuration files, including log rotation and archiving if they have been turned on, if it is time to do so according to the current built-in scheduler settings. Beginning in Wusage 7.0, the Unix versions of Wusage automatically request that the Unix cron service run the program at the top of the hour with this option. The Windows version runs such scheduled updates via its NT service. An actual update takes place only at the top of the appropriate hour on appropriate days, as indicated through the Schedule Updates button on the Account Administration Page. See Configuring the Program in ISP Mode for more information.

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

---

---

---