総合説明書

この説明書では efStat の概要やインストールについての説明をします。

• はじめに
  • 古いefStatを新しいefStatに差し替える際のポイント
• 概要
  • efCount(fcount.cgi)の特徴
  • efStat(fstat.cgi)の特徴
• 動作環境
• 導入
• プログラム側の設定・使用法
• 宣言
• 多謝/関連資料
• 最後に

このソフトウェア^(※1)はリンクウェア^(※2)です。
リンクウェアとは、貴方が本プログラムを使い始めて有用だと感じ使用し続ける場合に、貴方のウェブサイトから「有限工房」へ必ず何らかの形でリンクしていただくという契約を持ったソフトウェアです。
堅苦しさ抜きに書きますと、便利さの見返りにウチのページを宣伝してチョ☆、という事です(笑)

プログラムの性格上、efStat の存在を明らかにする必要はありませんが、せめて「ここにはお世話になってます」みたいな感じで上手く誤魔化してリンクを張ってあげて下さい。
(まあ、別に説明文を書く必要もありませんが)
カウンタに<A>要素でリンクを張るという方法もよく見かけます。

企業サイトに採用する場合などで、どうしてもそれだけは勘弁してくれ、という場合はメールにて個別に相談下さい。
何の断りもなくリンクせずに使っている会社さんがよくおられますが、私にはそれが企業の質量にものを言わせた横暴に感じられます。
お互いにそれはマイナスだと思いますので、出来れば一言知らせていただきたい。
お金は一切頂きませんし、そのことを口外することは決してありませんので。

(※1…私の書く説明書では「CGI/SSI スクリプト」の事を「プログラム」「ソフトウェア」と呼びます)
(※2…私が勝手に作った造語です(^^；　シェアウェアの「リンク張らなきゃいけない版」と思って下さい)

このスクリプトは、CGI/SSI設置の知識がある程度ある方を対象にしています。
申し訳ありませんが、この説明書を読んでもチンプンカンプンだった方は使用をご遠慮下さい。

■古いefStatを新しいefStatに差し替える際のポイント

特に注意書き(!!caution!!.txt)などがなければ、基本的に：

1. ログファイル・旧fstat.cgi,fcount.cgiのバックアップを取っておく。
   (後者は今までの設定内容を忘れないようにするため)
2. efStatをインストールしたディレクトリに新しいefStatを全て上書きする
   (いったん中身を全て消してしまってからコピーするとなお良し)
3. バックアップを取っておいたログファイルを元に戻す。
4. 前バージョンの設定を新バージョンに移植する。
   (設定方法が変更されていたりするので、説明書と照らし合わせて注意しながら行うこと)

このようにして下さい。　つまり、中身を総入れ替えしてからログと設定を引っ越しさせます。
これが一番安全・確実な方法です。

efCount(fcount.cgi)の特徴

カウンターの機能とアクセスロガーの機能を併せ持っている

ページ毎にログを記録することができる

きめ細かな記録

プロバイダを選ばない、SSI・CGI両用の柔軟設計

同じ人が再読込してもカウントしない

アクセスが何日無かろうと、カウント値が反映される

その他特徴

• カウントアップしたくないホスト・IPアドレスを指定可能
• カウントアップしたくないブラウザを指定可能
• flock を使った強固なファイルロック機構
• 時計表示
  (単純なので役に立たないとは思いますが、まあ、ページの飾りにでも使って下さい(^^；)
• 表示のみを行い、カウントアップをしないようにも指定可能

efStat(fstat.cgi)の特徴

強力なログ分析・解析機能

全て・本日・昨日と範囲を指定して表示できます

練られたユーザ・インターフェース

UNIX系OSなら多分なんでも行けると思います。
厳密には truncate 関数と flock 関数をサポートしたPerl 5以上が必要です。
動作確認は FreeBSD 2.2.7R + Apache/1.2.6 + jperl5.004_04-980303 にて行いました。

Windows系/MacOS系とPerlの組み合わせでも動作する筈ですが、サポート外とさせていただきます。
(腕に自信のある人は勝手に弄って下さい)
私の元にはUNIX以外のOS環境がないので動作確認ができないのです。
少なくとも Win9x + MS IIS + ActivePerl の組み合わせでは修正なしには動きません。

CGI、又はSSIが使用可能になっているかどうかもご確認下さい。
プロバイダ側サーバに Perl がインストールされているかもご確認下さい。

efCount(カウンタ部)はSSI , CGIのどちらでも使えるように作られていますが、efStat(ログ解析部)はCGIでしか使えません。
つまり、efCountを SSI として使う場合は、サーバがSSI だけでなく、 CGI にも対応している必要があります。

☆解凍☆

fstat.lzh を解凍します。
こんな感じでファイルが詰まっているはずです。

<docディレクトリ>	[説明書が格納されています]
readme.html	総合説明書。これ
fcount.html	efCount 取扱説明書
fstat.html	efStat 取扱説明書
history_fc.html	efCount バージョンアップ履歴
history_fs.html	efStat バージョンアップ履歴
makehtml.html	fcount.cgi を呼び出すためのタグを生成するツール。 タグがややこしすぎてワカラン！　という人はどうぞ。
format.csv	ログの仕様。　CSV形式に対応した表計算ソフトでご覧下さい。
default.css	説明書の表示スタイルを定義したファイル(あってもなくても無害)
fstat.gif	バナーです。宜しければお使い下さい。

※ 所々にヒョッコリある index.html ファイルは、ディレクトリを覗こうとする人を弾くためのダミーです ※

これらのファイルが出てきましたか？
ちょっと説明書が多いですけど、中身はほとんど同じです。
CGI 設置を経験済みの方なら、いつも CGI を設置しているのと同じ要領で行けますので挫けないで下さい(^^；

☆パーミッションの設定・ディレクトリ構成☆

出てきたファイルをサーバ側の任意のディレクトリ(※)へコピーします。
そのとき、ディレクトリ名は fstat が適当でしょう。
(※…WindowsやMacで言うところの「フォルダ」です。　以後、UNIXでの呼び方に合わせ「ディレクトリ」とします)

プロバイダから「CGI スクリプトは cgi-bin 以下に置きなさい」など、スクリプトの置き場所を指定されているときは、そのディレクトリの下に fstat ディレクトリを作って下さい。

最終的には、次の様になるようにします。

＜標準のディレクトリ構成＞

                                      (パーミッション)
/cgi-bin                              (705) drwx---r-x  [CGIスクリプト格納ディレクトリ]
   |--/fstat                          (705) drwx---r-x  [efStat格納ディレクトリ]
         |-- fcount.cgi               (705) -rwx---r-x  (カウンタ部)
         |-- fstat.cgi                (705) -rwx---r-x  (ログ表示部)
         |-- /lib                     (705) drwx---r-x  [ライブラリ用ディレクトリ]
         |     |-- start.pl
         |     |-- func.pl
         |     |-- main.pl
         |     |-- menu.pl
         |     |-- jcode.pl
         |     |-- gifcat.pl
         |     |-- e.gif
         |     |-- 0.gif
         |     |-- 1.gif
         |     |-- d.gif
         |     |-- w.jpg
         |     |-- b.gif
         |     +-- /table
         |            |-- agent.tbl
         |            |-- cctld.tbl
         |            |-- gtld.tbl
         |            |-- jpdomain.tbl
         |            +-- tinami.tbl
         |
         |-- /log                     (705) drwx---r-x  [ログ用ディレクトリ]
         |     |-- index.log          (606) -rw----rw-  (ログファイル(テスト用))
         |     |       ：
         |
         +-- /image                   (705) drwx---r-x  [カウンタ画像用ディレクトリ]
               |-- /fuksan            (705) drwx---r-x  [フォントごとのディレクトリ]
               |      |-- 0fuksan.gif
               |      |       ：
               |      +-- 9fuksan.gif
               |
               |-- /fuksan_
               |      ：

()内はパーミッションの数値

冗長になりますので説明書を分けました。
設定の仕方、使用法などについては各プログラム説明書をご覧下さい。

カウンタ部 efCount については fcount.html をご覧下さい。
ログ表示部 efStat については fstat.html をご覧下さい。

このプログラムはフリーソフトです。　(ただし、「はじめに」でも書いたように「リンクウェア」です)
著作権は放棄しません。 プログラム中のコピーライト表記を削除したり、改変しないで下さい。

画面のレイアウトを変えたりだとか、メッセージを変更したくらいで名前を変更されると、作者としては非常に寂しいです(笑)
が、あなたが efStat に原形をとどめない程の大幅な改造を施した場合は問題ありません。
その辺は常識的なさじ加減ということで…(^_^；

正規版の第三者による配布は禁止します。
これは、普及に伴いバージョン管理が困難になってきた実状を踏まえてこうなっています。
CD-ROMなど、私のページ以外の場所で掲載する場合は必ずご一報下さい。
(ただし、Vectorなど、私が自ら登録した物は除外します)

自由に改造して使用して下さい。　 改造したものを再配布する事も制限しません。
当然、 efCount のログ形式を利用した互換品を開発することもOKです。
ただし、改造版のサポートは改造した方が各自責任を持って行って下さい。

営利目的の使用・個人向けサイト以外の利用を制限しません。
煮るなり焼くなり好きに使って下さい。

このプログラムを用いた事による一切の損害について、作者は責任を負わないものとします。
あなたの責任の範囲において使用して下さい。

本プログラムを構成しているファイルのうち、

• 日本語コード変換ライブラリ jperl.pl は 歌代和正 氏
• GIF画像連結ライブラリ gifcat.pl は s-hasei 氏

に著作権があります。
これらの有用なプログラムを開発して下さった方々に深く感謝いたします。

■参考資料(著者敬称略/参照頻度順)

• プログラミングPerl 改訂版 / Larry Wall, Tom Christiansen, Randal L. Schwarts
• 「すぐに使える Perl スクリプト CGI & SSI 快適活用ライブラリ」 / ドッシー秋山・キャメル桜田
• 68user's page内「User Agent統計」 / 68user
• Some Gripes on User-Agent / Kabe
• DNS & BIND 第3版 / Paul Albitz, Cricket Liu
• RFC1945 - HTTP/1.0 / T. Berners-Lee他
• RFC2068 - HTTP/1.1 / R. Fielding他
• 「とほほのWWW入門」 / s-hasei

本ソフトはフリーソフトではありますが、沢山の労力と時間を割いて作られております。
だからといって物質的な見返りはこれっぽっちも期待しておりませんが、皆さんに使ってもらいたい、沢山の反響が欲しい、という自己満足がプログラム製作の原動力になっております。　宣言にもありますとおり、必ず私のサイトへリンクを張って下さい。　(お客が増える　＞　反響も増える　＞　サイトが盛り上がる　＞　私嬉しい☆)

もしよろしければ不可思議絵の具まで「efStat使ってるよ〜」とメールでも掲示板でも何でも構いませんので教えてあげて下さい。
大抵の場合、返事をお返しすることは出来ないと思いますが、送っていただいたメールには全て目を通しております。
そんな皆様の温かいご声援メールは私の元気の源になっています。　ありがとうございます(^^)
ただ、質問は掲示板にお願いします。　近頃捌ききれないので…(^_^;

カウンターGIF作家の皆様、カウンタ用画像を自分用に作ってそのままだったり、一応公開する目的で作ってはみたけれど公開する場所・チャンスがない…そんなデータをお持ちではないですか？
そのまま終わりじゃもったいないですよ☆　皆さんの自慢の作品を efStat のページに置いてみませんか？
もしかしたら、誰かが使ってくれるかも知れません。
カウンタ用画像を提供して下さる方を募集しています。　もしよかったらメール下さい。