Tech note FS1444
Specifying file locations on the Macintosh.
The FlashStats.ini configuration file has several parameters which require you to specify a filename. This tech note explains how to specify filenames on the Macintosh.
You can use either relative filenames or absolute filenames. A relative filename is interpreted relative to the folder which contains the FlashStats.acgi application. An absolute filename starts with the name of your hard disk, then lists the folders in nested order.
If the target file is in the same folder as the FlashStats.acgi, then you can specify just the filename. For example:
If the file is in a folder which is nested within the folder which contains FlashStats.acgi, then start with a colon (:) and follow with the intervening folder names and file name, each separated by a comma. For example:
If the file is in a folder which is not nested within the folder which contains FlashStats.acgi, then you may want to specify an Absolute Filename (described below). Alternately, you can specify a Relative Filename by starting with a colon (:), followed by an extra colon for each parent folder for as far "up" as you need to go in order to reach a common folder, followed by all intervening folders and then the file name, each separated by a comma. For example, let's assume that you have a folder named "WebSTAR Folder" which contains two folders, "Archived Logs" and "cgi-bin", and that the FlashStats.acgi file is in the "cgi-bin" folder. In this case, you could specify the archived logs like this:
This works because the first colon means "this is a relative filename," the second colon means "move up to the parent (WebSTAR) folder," then move down into the "Archived Logs" folder, and then specifies "*.log" (which means all files ending with .log). Note that if you had only used one leading colon instead of two then FlashStats would not work because you would be trying to look for the "Archived Logs" folder in the starting (cgi-bin) folder. The second colon fixes this problem by moving up to the parent folder before looking for the "Archived Logs" folder.
Keep in mind that if you have moved FlashStats.acgi into the "cgi-bin" folder then you will probably need to edit both the logs= and accesslog= parameter. They should probably end up looking something like:
Absolute Filenames are easier to specify, but are longer to type. But the end result is the same as using Relative Filenames; FlashStats will work with either.
To specify an absolute filename, start with the name of the disk which contains the target file, followed by all intervening folders that you have to go through to get to the target file, finally followed by the name of the target file. Each name should be separated by a colon (:), but do not start with a colon.
For example, let's assume that your hard disk is named My Hard Disk. At the top level it contains a folder named WebSTAR Folder, which contains a subfolder named Archived Logs, which contains all of your rotated log files. You could set the logs= parameter like this:
logs=My Hard Disk:WebSTAR Folder:Archived Logs:*.log
As mentioned above, you may also need to set the accesslog= parameter:
logs=My Hard Disk:WebSTAR Folder:Archived Logs:*.log;accesslog=My Hard Disk:WebSTAR Folder:WebSTAR.log
Of course, if you ever rename your hard disk to another name, then the specified absolute filename(s) will no longer be valid, and therefore FlashStats would not work.
These rules apply to all parameters which take filenames: