Middle Tennessee State University | Middle Tennessee State University

Sample Configuration Files

Viewing "home.config"

The samples on this page refer to the file "home.config," which is located in your "public_html/counter" directory.

To view and edit "home.config," move to your "public_html/counter" directory and open the file with pico:

frank $ pico home.config

Basic Setup

CountFile = /users/ yourgroup/username/ public_html/counter/home.count

Using One of the Alternate Digit Sets

>>> View alternate digit sets

CountFile = /users/ yourgroup/username /public_html/counter/home.count DigitSet = 3

Using the Access Logging Feature

CountFile = /users/ yourgroup/username /public_html/counter/home.count AccessLog = /users/ yourgroup/username /public_html/counter/access.log ErrorLog = /users/ yourgroup/username /public_html/counter/error.log UseLogging = 1 Title = Stats/For/My/Page

Configuration Options
CountFile	Path to the data file that stores the number of hits This file must be world-writeable. See note on world-writeable files.
DigitPath	Location of an alternative set of digits
SizeX	Width in pixels of one of the alternative digits
SizeY	Height in pixels of one of the alternative digits
AccessLog	Path to the data file that stores the stats This file must be world-writeable. Use the command `touch access.log` to create the file.
ErrorLog	Path to the data file that stores error messages that may be generated This file must be world writeable. Use the command `touch error.log` to create the file.
UseLogging	Either 1 to use the logging feature or 0 to not
TransColor	The RGB Value of a color you want to make transparent Use a / to separate the numbers
FrameColor	The RGB value you want the frame to be Use a / to separate the numbers
FrameWidth	Size in pixels you want the frame to be
DigitSet	Specifies which of the character sets you wish to use for the generated image. Valid sets are 1-10
Access Logging Configuration Options
Title	The title you want to appear in the stats page Use a / instead of a space to separate words
MinRef	Sets the number of times a web page must access the counter to make it into the stats display
MinRemote	Sets the number of times a remote machine must access the counter to make it into the stats display
MinAgent	Sets the number of times a browser must access the counter to make it into the stats display

World-Writeable Files

There is some degree of risk in having a world writeable file.

A world-writeable file is one that ANYONE, ANYWHERE has the ability to change. And we all know that there are people out there who can and will do mean things. The fact that you have a world-writeable file could allow someone to deposit a large amount of data in one of your files, alter the count on your page, or mess up your stats file.

The counter requires one world-writeable file; using the logging feature requires a total of three (03) world-writeable files.

How can you protect yourself?

Have as few of these world-writeable files as possible.
Consider how much you want to use the logging feature.
Examine your data files periodically.
The "count.dat" file size should never exceed 10 bytes or so. If someone tampers with the "access_log" file, your stats
page would contain unfamiliar or odd entries.
Read the "error_log" file.
This file keeps track of any error messages generated by the counter; it can tell you if something was misconfigured or
tampered with.