bbsdown のヘルプ

名前

bbsdown - MiniBBS-EX page down loader

コマンドラインの書式

bbsdown URL [Already_Exist_Count]

概要

bbs.cgi (MiniBBS-EX) で提供されている画像掲示板からコンテンツをダウンロードします。ダウンロードしたコンテンツはカレントディレクトリに格納されます。URL は bbs.cgi (サイトによっては違う)を参照する(起動する) 文字列を指定してください。例えば、 "http://www.sample-minibbs.com/page0000/www/cgi-bin/bbs.cgi" です。途中に特殊な記号を含む場合は引用符 "" で囲んでください。Already_Exist_Countは既にダウンロード済みのコンテンツを連続して発見した場合、何回目でページの追跡を中止するかを指定します。Already_Exist_Count は省略できます。省略した場合は 5 です。

環境変数

次に示す環境変数でより細かく動作を制御できます。特に REFERFROM, PAGEUSERNAME, PAGEPASSWORD, PROXYSERV, PROXYPORT はよく設定する環境変数です。bash を使用しているならば、シェルのプロンプトで $ export REFERFROM="http://www.sample-minibbs.com/index.html" の様に入力して環境変数を設定してください。

REFERFROM

URL で指定した CGI を参照しているページの URL を指定します。たとえば、 http://www.sample-minibbs.com/index.html のページから http://www.sample-minibbs.com/page0000/www/cgi-bin/bbs.cgi を参照している場合は http://www.sample-minibbs.com/index.html を指定します。ページの参照関係は URL 欄の表示を確認してください。 FRAME を使用したページの場合は、各 FRAME のプロパティを確認しフレームの URL を調べてください。

PROXYSERV

Proxy サーバのアドレスを指定します。例えば proxy.provider.com の様なアドレスまたは数値で表した IP アドレスを指定します。

PROXYPORT

Proxy サーバのポートを指定します。例えば 8080 の様な 10 進数の値です。

PAGEUSERNAME

ページを表示するために必要なユーザー名を指定します。ダウンロードが終わったならば、この環境変数を消去するか、無意味な値を入れておくことを推奨します。

PAGEPASSWORD

ページを表示するために必要パスワードを指定します。ダウンロードが終わったならば、この環境変数を消去するか、無意味な値を入れておくことを推奨します。

REMOVEHTML

ダウンロード後、HTML ページを削除する場合は文字列 yes を設定してください。

RETRYS

ダウンロードを再試行する回数を指定します。あまり多いと、サーバから接続拒否される場合も有るのでむやみに大きくしないほうが良いでしょう。

MONSPAN

コンテンツのファイル名が短い場合、自動的に "西暦.[a-z]." をファイル名に付加します。[a-z] の部分は月をこの環境変数で割った値を a-z に変換した文字です。例えば(bashを使っている場合に) export MONSPAN=4 とすると、月によって "西暦.[a-c]." をファイル名に付加します。
初期値は 3 です。"西暦.[a-d]." が付加されます。

RANDOMWAIT

コンテンツをダウンロードした後にランダムに待つ時間を秒で指定します。0 からこの環境変数に設定した値が待つ秒数です。サーバーが連続アクセスを拒絶しているようならば、この環境変数を設定してみてください。export RANDOMWAIT=4 とすると、ランダムに 0 秒から 4 秒まで待ちます。
初期値は 0 です。初期値の状態では待つことはありません。

終了コードの説明

0 成功しました。

0 以外失敗しました。

使用例

bash から次のようにして使用します。REFERFROM は必須ではないですが、サイトによっては正しく設定しないとアクセスを拒否されます。
$ export REFERFROM="http://www.sample-minibbs.com/index.html"
$ bbsdown "http://www.sample-minibbs.com/page0000/www/cgi-bin/bbs.cgi"
			
同一のコンテンツを発見しても掲示板を深く探索するようにするには、次のように同一コンテンツ発見回数の上限を指定します。
$ export REFERFROM="http://www.sample-minibbs.com/index.html"
$ bbsdown "http://www.sample-minibbs.com/page0000/www/cgi-bin/bbs.cgi" 20
			
proxy を経由する場合は次のようにします。上記同様 bash から使用する例です。
$ export PROXYSERV=proxy.your_provider.ne.jp
$ export PROXYPORT=10080
$ export REFERFROM="http://www.sample-minibbs.com/index.html"
$ bbsdown "http://www.sample-minibbs.com/page0000/www/cgi-bin/bbs.cgi"
			

Copyright

Copyright (C) [2003/8] by Akinori Furuta.
Mail:

scripts.htm へ移る readme.htm へ移る

0	成功しました。
0 以外	失敗しました。