Information Technology Division

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.