<strong><!--StartFragment-->Viewing "home.config"</strong>
<p class="bodyText">The samples on this page refer to the file "home.config," which is located in your "public_html/counter" directory.</p>
<p class="bodyText">To view and edit "home.config," move to your "public_html/counter" directory and open the file with pico:</p>
<p class="bodyText"><code>frank $ pico home.config</code></p>
<h4 class="bodyText">Basic Setup</h4>
<p class="bodyText"><code>CountFile = /users/</code><var>yourgroup/username/</var><code>public_html/counter/home.count</code></p>
<h4 class="bodyText">Using One of the Alternate Digit Sets</h4>
<p class="bodyText"><a href="http://www.mtsu.edu/Counter/DigitSets.html">>>> View alternate digit sets</a></p>
<p class="bodyText"><code>CountFile = /users/</code><var>yourgroup/username</var><code>/public_html/counter/home.count<br /> DigitSet = 3</code></p>
<h4 class="bodyText">Using the Access Logging Feature</h4>
<p class="bodyText"><code>CountFile = /users/</code><var>yourgroup/username</var><code>/public_html/counter/home.count<br /> AccessLog = /users/</code><var>yourgroup/username</var><code>/public_html/counter/access.log<br /> ErrorLog = /users/</code><var>yourgroup/username</var><code>/public_html/counter/error.log<br /> UseLogging = 1<br /> Title =</code> <var>Stats/For/My/Page</var><br clear="all" /><br clear="all" /></p>
<table border="1" cellpadding="4" cellspacing="0" align="left">
<tbody>
<tr>
<th bgcolor="#ffffcc" colspan="2" align="center">
<p class="bodyText"><span style="color:#000000;">Configuration Options</span></p>
</th>
</tr>
<tr>
<td>
<p class="bodyText"><strong>CountFile</strong></p>
</td>
<td>
<p class="bodyText"><em>Path to the data file that stores the number of hits</em><br /> <small>This file must be world-writeable. See <a href="#note">note</a> on world-writeable files.</small></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>DigitPath</strong></p>
</td>
<td>
<p class="bodyText"><em>Location of an <a href="http://www.mtsu.edu/Counter/DigitSets.html">alternative set</a> of digits</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>SizeX</strong></p>
</td>
<td>
<p class="bodyText"><em>Width in pixels of one of the alternative digits</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>SizeY</strong></p>
</td>
<td>
<p class="bodyText"><em>Height in pixels of one of the alternative digits</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>AccessLog</strong></p>
</td>
<td>
<p class="bodyText"><em>Path to the data file that stores the stats</em><br /> <small>This file must be world-writeable.</small><br /> Use the command <code>touch access.log</code> to create the file.</p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>ErrorLog</strong></p>
</td>
<td>
<p class="bodyText"><em>Path to the data file that stores error messages that may be generated</em><br /> <small>This file must be world writeable.</small><br /> Use the command <code>touch error.log</code> to create the file.</p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>UseLogging</strong></p>
</td>
<td>
<p class="bodyText"><em>Either 1 to use the logging feature or 0 to not</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>TransColor</strong></p>
</td>
<td>
<p class="bodyText"><em>The RGB Value of a color you want to make transparent</em><br /> <small>Use a / to separate the numbers</small></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>FrameColor</strong></p>
</td>
<td>
<p class="bodyText"><em>The RGB value you want the frame to be</em><br /> <small>Use a / to separate the numbers</small></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>FrameWidth</strong></p>
</td>
<td>
<p class="bodyText"><em>Size in pixels you want the frame to be</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong><a href="http://www.mtsu.edu/Counter/DigitSets.html">DigitSet</a></strong></p>
</td>
<td>
<p class="bodyText"><em>Specifies which of the character sets you wish to use for the generated image.</em><br /> <small>Valid sets are 1-10</small></p>
</td>
</tr>
<tr>
<th bgcolor="#ffffcc" colspan="2" align="center">
<p class="bodyText"><span style="color:#000000;">Access Logging Configuration Options</span></p>
</th>
</tr>
<tr>
<td>
<p class="bodyText"><strong>Title</strong></p>
</td>
<td>
<p class="bodyText"><em>The title you want to appear in the stats page</em><br /> <small>Use a / instead of a space to separate words</small></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>MinRef</strong></p>
</td>
<td>
<p class="bodyText"><em>Sets the number of times a web page must access the counter to make it into the stats display</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>MinRemote</strong></p>
</td>
<td>
<p class="bodyText"><em>Sets the number of times a remote machine must access the counter to make it into the stats display</em></p>
</td>
</tr>
<tr>
<td>
<p class="bodyText"><strong>MinAgent</strong></p>
</td>
<td>
<p class="bodyText"><em>Sets the number of times a browser must access the counter to make it into the stats display</em></p>
</td>
</tr>
</tbody>
</table>
<br clear="all" />
<h3 class="bodyText" align="left"><br /> <a name="note" id="note"></a>World-Writeable Files</h3>
<p class="bodyText" align="left">There is some degree of risk in having a world writeable file.</p>
<p class="bodyText" align="left">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.</p>
<p class="bodyText" align="left">The counter requires one world-writeable file; using the logging feature requires a total of three (03) world-writeable files.</p>
<h4 class="bodyText" align="left">How can you protect yourself?</h4>
<div align="left">
<ul class="list">
<li><em>Have as few of these world-writeable files as possible.</em></li>
<li><em>Consider how much you want to use the logging feature.</em></li>
<li><em>Examine your data files periodically.<br clear="all" /></em> The "count.dat" file size should <strong>never</strong> exceed 10 bytes or so. If someone tampers with the "access_log" file, your stats<br clear="all" /> page would contain unfamiliar or odd entries.</li>
<li><em>Read the "error_log" file</em>.<br clear="all" /> This file keeps track of any error messages generated by the counter; it can tell you if something was misconfigured or<br clear="all" /> tampered with.</li>
</ul>
</div>
Sample Configuration Files