プロセルピナ
Top Internet
Mail 		Private
Proxy 		Capture
Device 		Download Config
and
Words 		Online
Help 		Online
Home
[BACK]
☞ Top > PrivateProxy > AntiAd > AntiAdFilter > Format > OnLoad(ページ編集系)
 
■ AntiAdフィルタ書式 (ページ編集系)
OnLoad.Updateコマンド
AntiAd Filter


OnLoadコマンドは、 「サイト個別フィルタ」 がプロセルピナにロードされるときに実行されるコマンドです。

 

書式と概要


 OnLoad.Update: のコマンド名部、 [Target-URL]、 [AntiAdFilter] のパラメータ部から構成され、 これらはそれぞれ 半角スペース で区切られます。

[Target-URL] のＵＲＬにhttp-getでアクセスし、取得した内容を [AntiAdFilter] のAntiAd個別フィルタと比較して、変更がある場合に置き換えます。
[AntiAdFilter]には google.com.txt のようなAntiAdサイト個別フィルタのファイル名部分のみで指定します、 AntiAdサイト個別フィルタをフルパスで指定するのではありません。

このコマンドは、このコマンドが記述されている 「サイト個別フィルタ」 がプロセルピナにロードされるときに１回だけ実行されます (ロード時にOnLoadコマンドの有無がチェックされます)。
「サイト個別フィルタ」がアンロード(開放)された後に、 再び同じ 「サイト個別フィルタ」 がロードされることがありますが、この場合、 改めてOnLoadコマンドが含まれているかがチェックされ、 存在する場合には実行されます。

 

このコマンドが実行されるタイミング


 「OnLoadコマンドが実行されるタイミング 」 を参照してください。

 

許容マーカ


 このOnLoad.Updateコマンドでアップデートできるのは、 許容マーカ がある場合のみです。
許容マーカは、フィルタ内のコメント行に記述される、 「このファイルをOnLoad.Updateコマンドで自動更新してもよい」 という印です。
許容マーカは、アップデートするフィルタ(サーバにあるフィルタ)と、 されるフィルタ(antiAdListフォルダにあるフィルタ)の 両方に記述されている必要があります。

マーカはコメント行として記述されるので、先頭は #記号 です。
許容マーカは、
  #OnLoad.Update.[UPDATE-URL]:allow
という書式で、 [UPDATE-URL] の部分はサーバにあるAntiAdサイト個別フィルタを示すURLです。
次に例を示します。

   #OnLoad.Update.http://ex.com/file/google.com.txt:allow

 これは、 http://ex.com/file/google.com.txt のファイルでアップデートする場合の許容マーカです。
OnLoad.Updateコマンドによるアップデートを一時的に止めたい場合は、 allow の部分を他の文字列(no など)に変えておきます。

OnLoad.Updateコマンドでサーバから取得したAntiAdサイト個別フィルタに、 許容マーカが含まれていなかった場合は、 そのアップデートは無効になります。 アップデートの対象となった フィルタ(antiAdListフォルダにあるフィルタ) は更新されません。
antiAdListフォルダにあるAntiAdサイト個別フィルタを編集して許容マーカを削った場合は、 そのフィルタに対して行われようとしたOnLoad.Updateコマンドによるアップデートは 無効になります。 サーバから取得したAntiAdサイト個別フィルタに許容マーカがあっても、フィルタは更新されません。

マーカは、わかりやすいように、OnLoad.Updateコマンドとペアで記述するとよいでしょう。
例えば、 google.com.txt のAntiAdサイト個別フィルタなら、次のように記述しておきます。
自己更新の機能をもつAntiAdサイト個別フィルタ

【注】 OnLoad.Updateコマンドは、コマンドが記述されているフィルタとは違う 他のフィルタをアップデートすることもできるので、 必ずペアで記述されるわけではありません。

 

自動更新によるアップデート


 複数のAntiAdフィルタを公開している場合は、 自動更新機能(Live Update) によるアップデートを利用したほうが便利になります。
→ AntiAdフィルタの自動アップデート

自動更新機能によるアップデートは、 『プロセルピナ』View部 で行われます。 アップデートの有無は、 View部 で周期的にチェックされます。

 一方、OnLoad.Updateコマンドによるアップデートは 『プロセルピナ』サービス部 の機能です。

 

OnLoad.Updateコマンドのログ


 OnLoad.Updateコマンドが実行されると、 HTTPアクセス禁止ログ(アク禁ログ) に実行結果が記録されます。
2008/11/02 16:19:48 [OnLoad.Update] Filter C:\GTMAIL_HOME\ctrl\antiAdList\google.com.txt is UPDATED (http://www.example.com/filter/google.com.txt)
google.com.txtのアップデートが行われたログ

2008/11/02 16:13:05 [OnLoad.Update] Keyword #OnLoad.Update.http://ex.com/test/google.com.txt:allow NotFound in http://ex.com/test/google.com.txt
許容マーカがなかったときのログ
[BACK]
プロセルピナ