2. 呼び出し

[ ? ]

2.1 URLの書式

URLは，Uniform Resource Locatorの略語です．uniform resource locatorはインターネットで利用可能なリソースに対するコンパクトな文字列表示です．WgetはURL構文をRFC1738に従って理解します．これは，最も広く使用されている形式です(角カッコはオプション部分を意味します)．

http://host[:port]/directory/file
ftp://host[:port]/directory/file

ユーザ名とパスワードをURL内部に符号化できます．

ftp://user:password@host/path
http://user:password@host/path

userまたはpasswordのどちらか，または両方とも無くても構いません．HTTPユーザ名やパスワードのどちらか一方を省いている場合，認証は送られません．FTPユーザ名を省いている場合，‘anonymous’が使用されます．FTPパスワードを省いている場合，電子メールのアドレスがデフォルトパスワードとして提供されます．(1)

重要な注意：コマンドラインでパスワードを含むURLを指定した場合，ユーザ名とパスワードは，psを使用することで，システム上のすべてのユーザがそのまま見えることになります．複数のユーザのシステムでは，これは大きなセキュリティ上の問題になります．それを回避するために wget -i -を使用し，それぞれを別の行にしてC-dで終わりにした URLをWgetの標準入力に与えて下さい

URLでの安全ではない符号化は‘%xy’で可能で，xyは文字の ASCII値の16進数の表現です．一般的な安全でない文字は，‘%’ (‘%25’として引用されます)，‘:’ (‘%3A’として引用されます)，そして‘@’ (‘%40’として引用されます)が含まれます．安全でない文字の包括的なリストは，RFC1738を参照してください．

Wgetは，FTP URLに対するtypeの機能もサポートします．デフォルトで，FTPドキュメントはバイナリモードで回収(type ‘i’) し，それはダウンロードで変更されないことを意味します．その他の役に立つモードは‘a’ (ASCII)モードで，それは異なるオペレーティングシステムの間で行の分離文字を変換し，そのためそれはテキストファイルで役に立ちます．例は以下のようになります．

ftp://host/directory/file;type=a

歴史的(ヒステリック?)な理由と広範囲で使用されていることから，URL 指定の代替となる変種もサポートされています．

FTP-only syntax (NcFTPでサポートされました):

host:/dir/file

HTTP-only syntax (Netscapeで導入されました):

host[:port]/dir/file

これら二つの代替形式は推奨されず，将来のサポートはやめるかもしれません．

これらの表記の違いを理解できなかったり，その使い方を知らない場合， LynxやNetscapeのような好みのブラウザで使用するプレーンな普通の書式を使用してください．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.2 オプションの構文

Wgetは，コマンドライン引数の処理にGNU getoptを使用しているので，全てのオプションには，短い形式に対応する長い形式があります．長いオプションは覚え易いのですが入力に時間がかかります．異なるオプションスタイルを自由に混ぜて使用したり，コマンドライン引数の後にオプションを指定したりしてもかまいません．このため，以下のように書くことができます．

wget -r --tries=10 http://fly.srk.fer.hr/ -o log

オプションを受け入れる引数とその引数の間のスペースは省略してもかまいません．‘-o log’の代わりに‘-olog’と書くことができます．

引数が不要な複数のオプションを，以下のようにまとめて書き込んでもかまいません．

wget -drc URL

これは，以下と完全に等価です．

wget -d -r -c URL

オプションは引数の後に指定できるので，それらは‘--’で終端することができます．そのため，以下ではURL ‘-x’をダウンロードしようとし， ‘log’に失敗を報告します．

wget -o log -- -x

カンマで分離されているリストを受け入れるすべてのオプションは，空のリストの指定がその値をクリアするという規則に従います．これは， ‘.wgetrc’の設定をクリアにするとき役に立つはずです．例えば， ‘.wgetrc’がexclude_directoriesを‘/cgi-bin’に設定する場合，以下の例では最初にリセットし，除外するものとして‘/~nobody’ と ‘/~somebody’を設定します．‘.wgetrc’ (see section Wgetrcの構文)のリストをクリアにすることも可能です．

wget -X '' -X /~nobody,/~somebody

引数を受け入れないオプションは，ほとんどが真偽(boolean)のオプションで，yesまたはno (“boolean”)の値を状態に反映させるような名前が付いています．例えば，‘--follow-ftp’はWgetにHTMLファイルのFTPへのリンクをたどるように伝えますが，一方‘--no-glob’では，FTPのURLでのファイルのグラブを実行しないように伝えます．真偽のオプションは，肯定 (affirmative)または否定(negative) (‘--no’ではじまります)．そのようなオプションは全て幾つかの属性を共有します．

例外はありますが，デフォルトの動作がオプションの目的と反対であると仮定されています．例えば，‘--follow-ftp’が存在するということは，デフォルトがHTMLページからFTPへのリンクをたどらないことを仮定して説明されています．

肯定のオプションは，オプション名に‘--no-’を前置することで否定することができます．否定オプションは，‘--no-’接頭辞を省略することで意味を反転することができます．これで，必要十分だと思われます—肯定オプションのデフォルトは何もしないのに，なぜ明示的にそれをオフにする方法が提供されているのでしょうか？それは，スタートアップファイルでデフォルトが変更されている可能性があるためです．例えば，‘.wgetrc’で follow_ftp = offを使用すると，WgetはデフォルトでFTPへのリンクをたどりませんし，‘--no-follow-ftp’を使用することが，コマンドラインからデフォルトに戻す唯一の方法になります．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.3 基本的なスタートアップオプション

‘-V’
‘--version’: Wgetのバージョンを表示します．
‘-h’
‘--help’: Wgetのすべてのコマンドラインオプションを記述するヘルプメッセージを出力します．
‘-b’
‘--background’: 開始直後にバックグラウンドに移行します．出力ファイルを‘-o’で指定していない場合，出力は‘wget-log’にリダイレクトされます．
‘-e command’
‘--execute command’: ‘.wgetrc’ (see section スタートアップファイル)の一部のように，commandを実行します．このようなコマンドは‘.wgetrc’のコマンドの後に実行されるので，それらに優先します．一つ以上のwgetrcコマンドを指定する必要がある場合，‘-e’で複数実行して下さい．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.4 ログと入力ファイルオプション

‘-o logfile’

‘--output-file=logfile’

全てのメッセージをlogfileにログを取ります．メッセージは通常，標準エラー出力に報告されます．

‘-a logfile’

‘--append-output=logfile’

logfileに追加します．古いログファイルを上書きする代わりに logfileに追加する以外，これは‘-o’と同じです．logfile が無い場合は，新しいファイルを作成します．

‘-d’

‘--debug’

デバッグ出力を開始し，それは，Wgetが正確に動作しない場合，Wgetの開発に様々な重要な情報として意味があります．システム管理者が，デバッグサポート無しでWgetのコンパイルを選択している可能性もあり，その場合‘-d’ は動作しません．デバッグサポートでのコンパイルは常に安全だということに注意してください—デバッグサポートでコンパイルされたWgetは，‘-d’ が要求されるまでデバッグ情報を決して出力しません．バグレポートを送るために‘-d’を使用する方法の詳細は，See section バグの報告.

‘-q’

‘--quiet’

Wgetの出力を停止します．

‘-v’

‘--verbose’

利用可能な全てのデータを用いた冗長な出力を開始します．デフォルトの出力は冗長です．

‘-nv’

‘--non-verbose’

冗長でない出力です—完全に静かにするのではなく(そうするには‘-q’ を使用してください)冗長を停止するということで，エラーメッセージと基本的な情報は，まだ出力されることを意味します．

‘-i file’

‘--input-file=file’

fileからURLを読み込みます．‘-’がfileとして指定されている場合，URLは標準入力から読み込まれます．(‘-’という名前のファイルから読むときは，‘./-’を使用して下さい．

この機能が使用されている場合，URLをコマンドラインに書く必要はありません．コマンド行と入力ファイルの両方にURLがある場合，コマンド行のものが最初に回収されます．fileはHTMLドキュメントにする必要はありません(しかし，害が無い場合です)—URLだけ順番にリストアップされている場合はそれで十分です．

しかし，‘--force-html’を指定した場合，ドキュメントは‘html’と見なされます．この状況では相対的なリンクに問題がある可能性もあり，それは，<base href="url">をドキュメントに加えたり，コマンドラインで‘--base=url’を指定することで解決できます．

‘-F’

‘--force-html’

ファイルから入力を読み込むとき，HTMLファイルとして扱うことを強制します．これで，ローカルディスクの既存のHTMLファイルからの相対的なリンクを，HTMLに<base href="url">を加えたり， ‘--base’コマンドラインオプションを使用することで回収できるようになります．

‘-B URL’

‘--base=URL’

‘-F’と結合して使用されるとき，‘-i’で指定されるファイル内の相対リンクにURLを前置します．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.5 ダウンロード・オプション

‘--bind-address=ADDRESS’

クライアントのTCP/IP接続を作成するとき，ローカルマシンのADDRESS にbindします．ADDRESSはホスト名またはIPアドレスとして指定してもかまいません．このオプションはマシンが複数のIPに連結されている場合，役に立つはずです．

‘-t number’

‘--tries=number’

再試行の回数をnumberに設定します．無限の再試行のため，0や ‘inf’を指定してください．デフォルトの再試行は20回で，例外として “connection refused”や“not found” (404)のような致命的なエラーでは再試行しません．

‘-O file’

‘--output-document=file’

ドキュメントは適切なファイルに書かれず，全て一緒に連結されてfile に書き込まれます．fileとして‘-’が使用されている場合，ドキュメントは標準出力に書き込まれ，リンクの変換は利用不可能になります． (‘-’という名前のファイルに出力するために‘./-’を使用して下さい．)

‘-k’との組み合わせは，単一のドキュメントだけに限定されています．

‘-nc’

‘--no-clobber’

同じディレクトリに一回以上ファイルがダウンロードされる場合，Wgetの動作は，‘-nc’を含むいくつかのオプションに依存します．繰り返しのダウンロードで，ローカルファイルは破壊される(clobbered)こともあれば，上書きされることもあります．それ以外ではそのまま残ります．

‘-N’，‘-nc’，または‘-r’を用いずにWgetを実行するとき，同じディレクトリにダウンロードされる同じファイルは，オリジナルがそのまま fileのコピーとなり，二番目のコピーは‘file.1’と命名されます．ファイルが再びダウンロードされた場合は，三番目のコピーは ‘file.2’となり，以下同様になります．‘-nc’が指定された場合はこの動作が抑制され，Wgetはより新しい‘file’のコピーのダウンロードを拒否します．このため，“no-clobber”は実際にこのモードの間違った名称です—(数字の接尾子で既に破壊を妨げているので)それは破壊を妨げるのではなく，むしろ保存の複数のバージョンを持たないということです．

‘-r’を用い，‘-N’や‘-nc’を用いずにWgetを実行したとき，ファイルの再度のダウンロードは，古いものを単純に新しいコピーで上書きします． ‘-nc’を加えた場合はこの動作は妨げられ，オリジナルのバージョン保存し，サーバ上のあらゆるより新しいコピーを無視します．

‘-N’を用い，‘-r’を用いるまたは用いないで，Wgetを実行するとき，ローカルとリモートのファイルのタイムスタンプとサイズに依存して，より新しいファイルのダウンロードを実行するかどうかを決定します (see section タイムスタンプ)．‘-nc’は‘-N’と同時に指定できません．

‘-nc’が指定されている場合，‘.html’または‘.htm’の接尾子を持つファイルは，Webから回収されているかのようにローカルディスクからロードされて解析されることに注意して下さい．

‘-c’

‘--continue’

部分的にダウンロードされたファイルの取得を続けます．これは，前回のWget のインスタンスや，他のプログラムで開始したダウンロードを完了したいとき便利です．例えば以下のようにします．

wget -c ftp://sunsite.doc.ic.ac.uk/ls-lR.Z

現在のディレクトリに‘ls-lR.Z’という名前のファイルがある場合，Wget は，それがリモートファイルの最初の位置だと考え，ローカルファイルと同じ長さのオフセットから回収を続けるようサーバに依頼します．

接続が中断されたファイルのダウンロードを再試行するために，現在のWget呼び出しを行いたいだけの場合は，このオプションを指定する必要がないことに注意してください．これはデフォルトの動作です．‘-c’は，Wgetの今回の呼び出しの前に開始したダウンロードの再開で，そのローカルファイルがまだ完全ではないものにのみに効果があります．

‘-c’を用いない場合，前の例では，リモートファイルを ‘ls-lR.Z.1’ にダウンロードし，途中で切られた‘ls-lR.Z’ファイルはそのまま残ります．

Wget 1.7以降を用いて‘-c’を空でないファイルで使用する場合，サーバが継続ダウンロードをサポートしていないことが判明した場合は，Wgetは最初からのダウンロードの開始を拒否するので，その影響で既存の内容がだめになります．本当に最初からダウンロードを開始したい場合は，ファイルを削除してください．

また，Wget 1.7以降を用いて‘-c’をサーバのファイルと同じ大きさでないファイルで使用する場合，Wgetはファイルのダウンロードを拒否し，そのことを説明メッセージを出力します．サーバのファイルがローカルのものより小さいときも同じことが生じます—“続けること”に意味がなく，ダウンロードを行わないためです．

反対に，‘-c’を使用しているときは，ローカルより大きいサーバのファイルは不完全なダウンロードとみなされ，((リモートの)長さ - (ローカルの)長さ)バイトのみダウンロードされ，ローカルファイルの終りにくっつけられます．この動作は場合によっては望ましくないものです—例えば，データコレクションやログファイルに追加された新しい部分をダウンロードするために， ‘wget -c’を使用することが可能です．

しかし，ファイルが，追加されているのではなく，変更されて いてサーバのものより大きい場合，おかしなファイルになります．Wgetには，ローカルのファイルがリモートファイルの前段が本当に有効だということを検証する方法がありません．‘-r’と組合せて‘-c’を使用するとき，すべてのファイルが"不完全なダウンロード"の候補と考慮されるので，このことに特に注意する必要があります．

‘-c’を使用してみた場合におかしなファイルを得るもう一つの例は，ローカルファイルに“transfer interrupted”文字列を挿入する，不完全な HTTPプロキシを使用している場合です．将来は，“rollback”オプションがこの状況を扱うために追加されるかもしれません．

‘-c’は，FTPサーバとRangeヘッダをサポートするHTTP サーバのみで動作することに注意してください．

‘--progress=type’

使用したい進行状況表示の形式を選択します．正当な表示は“ドット”と “バー” です．

“バー”の表示がデフォルトで使用されます．それは，回収の状態を表示するためASCIIのプログレスバー表示(別名“温度計”の表示)を描画します．出力がTTYではない場合，“ドット”のバーがデフォルトで使用されます．

“ドット”表示に切替えるためには‘--progress=dot’を使用してください．それは，画面上にドットを出力することで回収を追跡し，それぞれのドットはダウンロードされたデータの固定量を表現しています．

ドットでの回収を使用している時，‘dot:style’のような形式で スタイル(style)を指定することもできます．異なるスタイルは一つのドットに異なる意味を割り当てます．defaultスタイルでは，それぞれのドットは1Kを表現し，1クラスタに10ドットがあり，一行に50ドットあります． binaryスタイルでは，より“コンピュータ”ライクの方針になっています—ドットは8K，クラスタは16ドット，そして一行は48ドットになります(一行が384Kです)．megaスタイルは非常に大きなファイルのダウンロードに適しています—それぞれのドットは64Kの回収を表現していて，1クラスタに 8ドットあり，それぞれの行には48ドットになります(そのため，それぞれの行は3M含まれています)．

‘.wgetrc’のprogressコマンドで，デフォルトの形式を設定することが可能であることに注意して下さい．その設定は，コマンドラインで上書きされるかもしれません．例外として，出力がTTYではないとき，“ドット” のプログレスバーが“バー”に優先されます．バーの表示を強制したい場合は ‘--progress=bar:force’を使用してください．

‘-N’

‘--timestamping’

タイムスタンプを開始します．詳細は，See section タイムスタンプ.

‘-S’

‘--server-response’

HTTPサーバが送るヘッダを出力したり，FTPサーバに返事を送ったりします．

‘--spider’

このオプションで呼び出された場合，Wgetはウェブスパイダー(spider) として動作し，それにはページをダウンロードせずに存在を調査するという意味があります．例えば，ブックマークの調査にWgetを使用することが可能です．

wget --spider --force-html -i bookmarks.html

この機能には，Wgetを真のウェブスパイダーの能力に近づけるため，非常に多くの仕事がさらに必要です．

‘-T seconds’

‘--timeout=seconds’

ネットワークのタイムアウトをseconds秒に設定します．これは， ‘--dns-timeout’，‘--connect-timeout’，そして ‘--read-timeout’を同時に指定することと同じです．

ネットワークとの通信時に，タイムアウトを調査し，時間が超過した場合は処理を中止します．これで，中途半端な読み込みや無限接続を避けることになります．デフォルトで利用可能なタイムアウトは，読み込みのタイムアウトの 900秒だけです．タイムアウトを0に設定することで，タイムアウトの調査を完全に利用不可能にします．何を行っているか分からない場合，タイムアウトに関連するオプションを設定しないのが最善でしょう．

タイムアウトに関聯するすべてのオプションは，10進数の値を受け入れ，小数の値も同様に受け入れます．例えば，‘0.1’秒は，タイムアウトの選択としては(無意味ですが)正当なものです．小数のタイムアウトは，サーバの応答時間の調査や，ネットワークの待ち時間のテストで役に立ちます．

‘--dns-timeout=seconds’

DNSのルックアップタイムアウトをseconds秒に設定します．指定された時間内に完了しないDNSのルックアップは異常終了になります．デフォルトでは，システムライブラリで実装されていない限り，DNSのルックアップにタイムアウトは存在しません．

‘--connect-timeout=seconds’

接続タイムアウトをseconds秒に設定します．確立に時間がかかるTCP接続は中止されます．デフォルトでは，システムライブラリで実装されていない限り，接続タイムアウトは存在しません．

‘--read-timeout=seconds’

読み込み(と書き出し)のタイムアウトをseconds秒に設定します．ここでのタイムアウトの“タイム”とはアイドルタイム(idle time)を意味します．つまり，ダウンロード時に指定した秒数以上データを全く受信していない場合，読み込みに失敗し，ダウンロードが再び開始されます．このオプションは，ダウンロード時には直接影響しません．

もちろん，リモートのサーバがこのオプションの要求より短い接続終了時間を設定している可能性もあります．読み込みタイムアウトのデフォルト値は900秒です．

‘--limit-rate=amount’

ダウンロードの速度をamountバイト毎秒に制限します．amountはバイト表現に，‘k’の接尾子を付けたキロバイトや，‘m’の接尾子を付けたメガバイトでもかまいません．例えば，‘--limit-rate=20k’で回収のレートを20KB/sに制限します．理由があってWgetに利用可能な帯域をすべて使用されたくないとき便利です．

このオプションでは，10進数が利用可能で，通常は乗数の接尾辞を追記します．例えば，‘--limit-rate=2.5k’は正当な設定値になります．

Wgetは，指定したレート以上の時間をかけないよう，ネットワークの読み込み後に適切な時間スリープすることで制限を実装していることに注意して下さい．結局こうすることで，TCPの転送を指定したレートにだいたい落ち着きます．しかし，このバランスを達成するまで時間がかかるかもしれないので，制限されたレートが非常に小さなファイルでうまく動作しない場合でも驚かないでください．

‘-w seconds’

‘--wait=seconds’

回収の間に指定した秒数待ちます．要求の生成を少なくすることでサーバの負荷を軽くするので，このオプションの使用を推奨します．秒の代わりに時間を mで後置した分，hを後置した時間，dを後置した一日で指定可能です．

このオプションに大きな値を指定すると，ネットワークや接続先のホストが落ちた場合，Wgetは再試行する前にネットワークエラーの修復が期待される程度の妥当な時間待つことができるので役に立ちます．

‘--waitretry=seconds’

すべての回収の間ではなく，ダウンロードに失敗したときのみWgetを待たせたい場合，このオプションを使用することが可能です．Wgetは linear backoffを使用していて，与えられたファイルでの最初の失敗の後に一秒待ち，そのファイルで二番目に失敗した後に二秒待つようにして，指定された最大secondsまで増加するようになっています．このため，10 の値は，(1 + 2 + ... + 10) = 55 秒まで，Wgetは一つのファイルにつき実際に待つことになります．

このオプションは，大域的な‘wgetrc’ファイルでデフォルトで開始していることに注意してください．

‘--random-wait’

ウェブサイトによっては，Wgetのような回収プログラムを識別するために，要求と要求の間の時間による統計的に重要な類似を検索するため，ログ解析を実行する可能性があります．このオプションは，‘--wait’オプションを使用して指定したwaitを用いて，0から2の間にwait秒を掛けて変化させ，要求と要求の間の時間を変動させ，そのような解析からWgetの存在を隠すようになっています．

有名なコンシュマープラットフォームでの開発に捧げられている出版物の最近の論文では，これをこっそりと解析するコードを提供しています．その著者は，自動的な回収プログラムでDHCPで提供するアドレスを悪意を持って変更するものをブロックすることを確実にするため，クラスCのアドレスレベルをブロックすることを提案しています．

‘--random-wait’オプションは，その動作を行なうウェブサイトから多くの無関係なユーザをブロックするような無差別な推奨があることを示唆しています．

‘--no-proxy’

たとえ適切な*_proxy環境変数が定義されている場合でも，プロキシを使用しません．

Wgetでプロキシを使用する際の詳細は，プロキシ.

‘-Q quota’

‘--quota=quota’

自動回収に対するダウンロードクォータを指定します．値は(デフォルトで)バイト，(‘k’の後置で)キロバイト，(‘m’の後置で)メガバイトで指定可能です．

クォータは単一ファイルのダウンロードで効果が無いことに注意してください．そのため，‘wget -Q10k ftp://wuarchive.wustl.edu/ls-lR.gz’のように指定した場合，‘ls-lR.gz’全体がダウンロードされます．複数の URLがコマンドラインで指定されたときも，同様なことが生じます．しかし，回収が再帰的なときや入力ファイルからのときにクォータは尊重されます．このため，安全に‘wget -Q2m -i sites’と入力ことができます—ダウンロードはクォータ以上になったとき中止します．

クォータを0や‘inf’に設定すると，ダウンロードクォータは無制限になります．

‘--no-dns-cache’

DNSルックアップのキャッシュを停止します．通常，WgetはDNSから検索したIP アドレスを記憶しているので，回収している同じホスト群(通常は小さい)に対してDNSサーバに何度も問い合わせる必要はありません．このキャッシュは，メモリだけに存在します．新たにWgetを実行すると，再びDNSに問い合わせします．

しかし，Wgetのようなちょっとしたアプリケーションの実行の間でも，ホスト名のキャッシュが好ましくない状況があることが報告されています．このオプションを用いると，Wgetは新たな接続を作成するたびに新たにDNSを検索します (より正確には，新たにgethostbynameやgetaddrinfoを呼び出します)．このオプションは，名前解決ライブラリやNSCDのような外部キャッシュのレイヤーによって実行されるキャッシュに影響しないことに注意して下さい．

このオプションの動作を正確に理解していない場合，おそらくこのオプションは不要でしょう．

‘--restrict-file-names=mode’

リモートのURLで見つかった文字で，そのURLから生成されるローカルファイル名が存在する可能性がある文字を変更します．このオプションで制限される(restricted)文字はエスケープされます．すなわち，‘%HH’で置換され， ‘HH’は制限された文字に対応する16進数です．

デフォルトで，通常は出力不可能な制御文字同様，オペレーティングシステム上のファイル名の一部として有効ではない文字を，Wgetはエスケープします．このオプションは，ネイティブなパーティションではないところにダウンロードしたり，制御文字のエスケープを利用不可能にしたいなどの理由で，これらのデフォルトを変更するときに役に立ちます．

モードが“unix”に設定されているとき，Wgetは，文字‘/’と0–31の範囲と128–159の範囲の制御文字をエスケープします．これはUnixに似たOS上でのデフォルトです．

モードが“windows”に設定されているとき，Wgetは，文字‘\’， ‘|’，‘/’，‘:’，‘?’，‘"’，‘*’，‘<’， ‘>’と0–31の範囲と128–159の範囲の制御文字をエスケープします．これに加え，windowsモードでのWgetは，ローカルファイル名でのホストとポートの分離に‘:’の代わりに‘+’を使用し，残りのファイル名のクエリ部分の分離に‘?’の代わりに‘@’を使用します．このため，unixモードで ‘www.xemacs.org:4300/search.pl?input=blah’として保存されるURL は windowsモードでは‘www.xemacs.org+4300/search.pl@input=blah’として保存されます．このモードはWindowsではデフォルトです．

‘unix,nocontrol’のように，モードに‘,nocontrol’を追加した場合，制御文字のエスケープも停止します．ファイル名の制限モードとして使用する OSの選択に影響を与えないまま，制御文字のエスケープを停止するために， ‘--restrict-file-names=nocontrol’を使用することが可能です．

‘-4’

‘--inet4-only’

‘-6’

‘--inet6-only’

IPv4またはIPv6のアドレスに強制的に接続します．‘--inet4-only’または ‘-4’を用いると，WgetはIPv4のホストだけに接続し，DNSのAAAAレコードは無視し，URLで指定されているIPv6のアドレスへの接続は拒絶します．反対に， ‘--inet6-only’または‘-6’を用いると，IPv6のホストだけに接続し， AレコードとIPv4のアドレスを無視します．

いずれのオプションも一般的に必要とされるべきです．デフォルトで，IPv6対応のWgetはホストのDNSレコードで指定されているアドレスファミリを使用します．DNSがAレコードとAAAAレコードを指定しているWgetは接続可能なものが見つかるまで，順番に試していきます．

これらのオプションは，両方のファミリを使用しているシステム上で，意識的にIPv4またはIPv6のアドレスファミリに強制させるために使用することが可能で，通常はデバッグの目的やおかしくなったネットワーク構成を処理するために使用します．‘--inet6-only’と‘--inet4-only’は，同じコマンドで一つだけしか指定できません．IPv6のサポート無しでコンパイルされたWget では，何れのオプションも利用できません．

‘--prefer-family=IPv4/IPv6/none’

選択可能なアドレスがあたえられるとき，最初に指定されているアドレスファミリのアドレスに接続します．IPv4アドレスがデフォルトで選択されます．

IPv4のネットワークで，IPv6とIPv4の両方のアドレス解決されたホストにアクセスするとき，こうすることで，偽のエラーを避けて接続を試みます．例えば， ‘www.kame.net’が‘2001:200:0:8002:203:47ff:fea5:3085’と ‘203.178.141.194’だと分かったときそうなります．好ましいアドレスファミリーがIPv4のときIPv4アドレスが最初に使用されます．好ましいアドレスファミリーがIPv6のときIPv6アドレスが最初に使用されます． noneの値を指定する場合，DNSが返したアドレスの順序を変更せずに使用します．

‘-4’と‘-6’とは異なり，このオプションでは特定のアドレスファミリへのアクセスを禁止せず，アクセスするアドレスの順序だけを変更します．また，このオプションで実行される順序変更が安定している (stable)ことに注意してください—同じアドレスファミリの順序には影響しません．つまり，すべてのIPv4関連の順番とすべてのIPv6アドレスの順番は，いずれの状況でも，元のまま残っています．

‘--retry-connrefused’

“connection refused”が一時的なエラーだと想定し，再び接続を試みます．通常，サイトに接続できないURLについてWgetは諦め，それは接続の失敗はサーバが完全に動作していないので，再挑戦に意味が無いからです．このオプションはあてにならないサイトのミラーリングのためで，そのようなサーバはちょっとの時間だけ見えなくなってしまいがちです．

‘--user=user’

‘--password=password’

FTPとHTTPの両方でのファイルの回収で，ユーザ名をuserに，パスワードをpasswordに指定します．これらのパラメータは，FTP 接続に対しては‘--ftp-user’と‘--ftp-password’オプションを， HTTP接続に対しては‘--http-user’と‘--http-password’オプションを使用することで，それに優先させることが可能です．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.6 ディレクトリオプション

‘-nd’

‘--no-directories’

再帰的に回収するときにディレクトリの階層を作成しません．このオプションを開始すると，全てのファイルは現在のディレクトリに上書き無しで保存されます(名前が一度以上現れる場合，ファイル名は拡張子‘.n’が付きます)．

‘-x’

‘--force-directories’

‘-nd’の反対です—階層無しで作成されていても，ディレクトリ階層を作成します．例えば，‘wget -x http://fly.srk.fer.hr/robots.txt’はファイルを‘fly.srk.fer.hr/robots.txt’にダウンロードします．

‘-nH’

‘--no-host-directories’

ホストを前置したディレクトリの生成を不可にします．デフォルトで，Wgetを ‘-r http://fly.srk.fer.hr/’を用いて呼び出した場合， ‘fly.srk.fer.hr/’で始まるディレクトリ構造を作成します．このオプションはそのような動作を不可にします．

‘--protocol-directories’

ローカルファイル名のディレクトリとしてプロトコル名を使用します．例えば，このオプションを用いることで，‘wget -r http://host’は ‘host/...’ではなく‘http/host/...’に保存されます．

‘--cut-dirs=number’

ディレクトリコンポーネントのnumberを無視します．再帰的回収で保存されたディレクトリ上の，きめ細かい制御でこれは役に立ちます．

例えば，‘ftp://ftp.xemacs.org/pub/xemacs/’ディレクトリの取得するとします．‘-r’で回収した場合，‘ftp.xemacs.org/pub/xemacs/’以下にローカル保存されます．一方，‘-nH’オプションは ‘ftp.xemacs.org/’の部分を削除し，‘pub/xemacs’で保存します．これが‘--cut-dirs’が役に立つところです．それで，Wgetはリモートディレクトリコンポーネントのnumber(数)を“見”ないようなります． ‘--cut-dirs’オプションがどのように動作するかを示す例は以下のようになります．

No options        -> ftp.xemacs.org/pub/xemacs/
-nH               -> pub/xemacs/
-nH --cut-dirs=1  -> xemacs/
-nH --cut-dirs=2  -> .

--cut-dirs=1      -> ftp.xemacs.org/xemacs/
...

ディレクトリ構造を取り除きたいだけの場合，このオプションは‘-nd’と ‘-P’の組合せに似ています．しかし，‘-nd’とは異なり， ‘--cut-dirs’はサブディレクトリを失いません—例えば，‘-nH --cut-dirs=1’を用いた場合，‘beta/’サブディレクトリは，期待通りに ‘xemacs/beta’に配置されます．

‘-P prefix’

‘--directory-prefix=prefix’

ディレクトリプレフィクスをprefixに設定します．ディレクトリプレフィクス(directory prefix)は，他の全てのファイルとサブディレクトリが保存されるディレクトリで，すなわち回収ツリーのトップになります．デフォルトは‘.’ (カレントディレクトリ)です．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.7 HTTPオプション

‘-E’

‘--html-extension’

‘application/xhtml+xml’や‘text/html’形式のファイルがダウンロードされ，URLが正規表現の‘\.[Hh][Tt][Mm][Ll]?’で終わらない場合，このオプションは接尾子‘.html’をローカルのファイル名に後置します．例えば，‘.asp’ページを使用したリモートサイトをミラーし，手元のApach サーバで閲覧可能なミラーにしたい場合，これは役に立ちます．もう一つのこの優れた利用方法は，CGIが生成したものをダウンロードするときです． ‘http://site.com/article.cgi?25’のようなURLは， ‘article.cgi?25.html’として保存されます．

この方法で変更されたファイル名は，Wgetはローカルの‘X.html’ ファイルとリモートのURL ‘X’と一致するかどうか分からないため (それは，URLが生成する‘text/html’形式や ‘application/xhtml+xml’形式の出力が分からないためです．)，再びダウンロードするたびにサイトをミラーリングすることに注意してください．この再ダウンロードを避けるため，ファイルのオリジナルバージョンが ‘X.orig’として保存されるように，‘-k’と‘-K’を使用する必要があります(see section 再帰的な回収オプション)．

‘--http-user=user’

‘--http-password=password’

HTTPサーバでのユーザ名をuserに，そしてパスワードを passwordに指定します．試みる形式によって，Wgetはbasic (安全でない)，またはdigest認証手法のいずれかを用いて符号化します．

もう一つの方法は，ユーザ名とパスワードをURL自身に書く方法です (see section URLの書式)．いずれの手法でも，psを実行することで，パスワードがばれてしまいます．パスワードが見えないようにするため．それらを ‘.wgetrc’や‘.netrc’に保存し，それらのファイルをchmodを使用して他のユーザから確実に保護してください．パスワードが本当に重要な場合，それらのファイルにも残さないようにして下さい—ファイルを編集し， Wgetがダウンロードを開始した後で削除して下さい．

‘--no-cache’

サーバサイドのキャッシュを不可にします．この場合Wget は，リモートサービスからファイルを得るため，キャッシュバージョンを返す代わりにリモートサーバに適切なディレクティブ(‘Pragma: no-cache’) を送ります．これは，プロキシサーバの時代遅れのドキュメントを回収し，クリアするときに特に役立ちます．

キャッシュはデフォルトで可能になっています．

‘--no-cookies’

クッキーを使用不可能にします．クッキーはサーバ側の状態を管理するメカニズムです．サーバはSet-Cookieヘッダを使用してクライアントにクッキーを送り，クライアントはそれ以降の要求で同じクッキーを使用して応答します．クッキーはサーバの所有者が訪問者の追跡を保存し，サイトがこの情報を交換することを可能にするので，それらをプライバシーの侵害と考える人もいます．デフォルトはクッキーの使用です．しかし，クッキーの保存はデフォルトではありません．

‘--load-cookies file’

最初のHTTPの回収の前にfileからクッキーをロードします．file の書式は，少なくともUnixバージョンのNetscapeとMozillaで使用されているものです．

サイトの内容にアクセスするためにログインすることを要求するサイトをミラーリングする時，通常，このオプションを使用します．ログインのプロセスは，通常，ウェブサーバがHTTPクッキーを発行し，回収し，証明書を検証することで動作します．クッキーは，サイトの一部にアクセスしたときブラウザが再送信し，個人識別情報を提供します．

サイトのミラーリングで，サイトと通信する時にウェブブラウザが送るものと同じクッキーをWgetに送るよう要求します．これは，‘--load-cookies’ で達成されます—単純にWgetに‘cookies.txt’ファイルがある場所を示し，そうすることでブラウザが同じ状況で送るものと同じクッキーを送ります．異なるブラウザはテキストのクッキーファイルを異なる場所に保存します．

Netscape 4.x.: クッキーは‘~/.netscape/cookies.txt’になります．
Mozilla and Netscape 6.x.: Mozillaのクッキーファイルも‘cookies.txt’という名前で，プロファイルのディレクトリの‘~/.mozilla’の下のどこかにあります．フルパスは ‘~/.mozilla/default/some-weird-string/cookies.txt’のような場所で見つかります．
Internet Explorer.: ファイルメニューの，インポートとエクスポートの，エクスポートクッキーを使用することで，Wgetが使用可能なクッキーファイルを生成可能です．これは， Internet Explorer 5でテストしました．それより前のバージョンでの動作は保証しません．
その他のブラウザ: クッキーを作成したものと異なるブラウザを使用している場合，場所を指定可能，またはWgetが期待するNetscapeのフォーマットのクッキーファイルを生成することが可能な場合のみ動作します．

‘--load-cookies’が使用不可能な場合，代替方法もあります．ブラウザが “クッキーマネージャ”をサポートしている場合，ミラーしているサイトにアクセスする時，使用されているクッキーを見るためにそれを使用することが可能です．名前とクッキー名を書き下ろし，手動でこれらのクッキーを送るよう Wgetに命令し，“公式の”クッキーサポートを回避してください．

wget --no-cookies --header "Cookie: name=value"

‘--save-cookies file’

修了する前にfileにクッキーを保存します．つまり，既に期限切れのクッキーや破棄する時間が指定されていないクッキー(“セッション・クッキー”と呼ばれるもの)は保存されません．‘--keep-session-cookies’も参照してください．

‘--keep-session-cookies’

指定されているとき，‘--save-cookies’でセッションクッキーも保存します．セッションクッキーは，メモリに保存されブラウザを修了したときに消すものなので，通常は保存されません．それを保存すると，ログを必要とするサイトや，ページアクセスが可能になる前にホームページを訪問するとき便利です．このオプションを用いると，複数回Wgetを実行しても，サイトが単一のブラウザセッションだと思っている限り，単一セッションだと想定します．

クッキーファイルのフォーマットには，通常のセッションクッキーを書き込めないため，Wgetはタイムスタンプの有効期限を0で印を付けます．Wgetは ‘--load-cookies’で，それらをセッションクッキーとして認識しますが，それ以外のブラウザは混乱する可能性があります．また，そのようにロードされたクッキーは他のセッションクッキーとして扱われ，もう一度保存するために‘--save-cookies’を指定したい場合は， ‘--keep-session-cookies’を再び使用する必要があるということを意味するので，注意して下さい．

‘--ignore-length’

残念ながら，HTTPサーバ(より正確にはCGIプログラム)には，偽の Content-Lengthヘッダを送るものもあり，それではドキュメント全てが回収されないので，Wgetがおかしくなります．Wgetが同じドキュメントを何度も何度も回収し，そのたびに(通常でない)接続が同じバイト数で閉じている報告を得る場合，この症状を見付けることが可能です．

このオプションを用いた場合，WgetはContent-Lengthヘッダを—まるで存在しないかのように—無視します．

‘--header=header-line’

HTTPリクエストのたびに，ヘッダの残りにheader-lineを追加して送ります．提供するヘッダはそのまま送られます．つまり，コロンで分離された名前と値をふくめる必要があり，改行を含めてはならないことを意味します．

一つ以上の追加ヘッダを，一回以上‘--header’を指定することで定義してもかまいません．

wget --header='Accept-Charset: iso-8859-2' \
     --header='Accept-Language: hr'        \
       http://fly.srk.fer.hr/

ヘッダ値として空の文字列を指定すると，以前ユーザが定義した全てのヘッダをクリアします．

Wget 1.10では，このオプションは，通常自動的に生成されるヘッダに優先させるために使用することが可能です．以下の例は，Wgetにローカルホストに接続させる命令ですが，Hostヘッダに‘foo.bar’を指定します．

wget --header="Host: foo.bar" http://localhost/

1.10以前のWgetのバージョンでは，‘--header’の使用で重複するヘッダを送信します．

‘--proxy-user=user’

‘--proxy-password=password’

プロキシサーバの認証のため，ユーザ名userとパスワード passwordを指定します．Wgetはこれらをbasic認証手法で符号化します．

セキュリティへ考慮は，‘--http-password’に関連するものによく似ています．

‘--referer=url’

HTTPの要求に‘Referer: url’ヘッダを含めます．常に対話的なウェブブラウザでの回収を期待していて，Refererがそれを示すページの一つに設定されているときのみ正しく出力するサーバサイドプロセスを用いたドキュメントの回収で役に立ちます．

‘--save-headers’

HTTPサーバがファイルにつけて送ったヘッダを空白行で分けて，実際の内容の前につけて保存します．

‘-U agent-string’

‘--user-agent=agent-string’

agent-stringとしてHTTPサーバを識別します．

HTTPプロトコルは，クライアントがUser-Agentヘッダフィールドを用いた自分自身の識別を許可しています．これでWWWソフトウェアの区別が可能となり，通常のプロトコル違反の追跡目的には十分です．Wgetは通常 ‘Wget/version’として識別され，versionはWgetの現在のバージョンナンバーです．

しかし，サイトによってはUser-Agentが供給する情報によって出力を調整するポリシーを課すことが知られています．理論上，これはそんなに悪い考えではないのですが，(歴史的に)Netscapeや，更に頻繁にMicrosoft Internet Explorer以外のクライアントに情報の提供を拒否するように乱用されてもいました．このオプションで，Wgetが発行するUser-Agentを変更できます．このオプションの使用は，行っていることを本当に知らない場合は思い留まってください．

‘--user-agent=""’で空のユーザエージェントを指定すると，Wget は HTTPリクエストでUser-Agentヘッダを送りません．

‘--post-data=string’

‘--post-file=file’

すべてのHTTPリクエストと，リクエストの本文に指定されたデータを送信する手段としてPOSTを使用します．--post-dataはstringをデータとして送信し，--post-fileはfileの内容を送信します．それ以外では，同じように動作します．

Wgetは，POSTするデータの大きさを前もって知っておく必要があることに注意して下さい．このため，--post-fileの引数は通常のファイルにする必要があります．FIFOや‘/dev/stdin’のようなものを指定すると動作しません．HTTP/1.0に起因するこの制限を，回避する方法は全く分かりません． HTTP/1.1ではリクエストの長さを前もって知る必要が無いchunked転送が導入されましたが，クライアントはHTTP/1.1サーバと通信していることが分かるまで，chunkedを使用することはできません．また，レスポンスを受信するまでそれは分からないので，完了するまでリクエストを順次送信する必要があります–鶏と卵の問題です．

注意：POSTリクエストが完了した後に，Wgetがリダイレクトされる場合，POST データをリダイレクトされたURLに送信しません．これは，POSTを処理するURL が通常のページにリダイレクトを用いて応答するためで，それはPOSTを要求したり受け入れたりしません．この動作が最適かどうかは完全に明確ではありません．うまく動作しなければ，将来変更されるかもしれません．

以下の例は，POSTを使用しているサーバのログをとらせ，要求されている，おそらく認証されたユーザだけがアクセス可能なページをダウンロードを行なう方法を示します．

# Log in to the server.  This can be done only once.
wget --save-cookies cookies.txt \
     --post-data 'user=foo&password=bar' \
     http://server.com/auth.php

# Now grab the page or pages we care about.
wget --load-cookies cookies.txt \
     -p http://server.com/interesting/article.php

ユーザ認証をそれ以降ずっと利用する，サーバがセッションクッキーを使用している場合，上記の例では‘--save-cookies’では(ブラウザでも)保存されず，‘cookies.txt’が空になるため，うまく動作しないでしょう．この状況では，セッションクッキーの保存を強制的に行うため， ‘--save-cookies’と共に‘--keep-session-cookies’も使用して下さい．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.8 HTTPS (SSL/TLS) オプション

暗号化されたHTTP (HTTPS)のダウンロードをサポートするために，外部のSSLライブラリ，現在はOpenSSLを使用してWgetをコンパイルする必要があります． WgetがSSLサポート無しでコンパイルされている場合，以下のオプションはすべて利用できません．

‘--secure-protocol=protocol’

セキュアプロトコルの使用を選択します．正当な値は，‘auto’， ‘SSLv2’，‘SSLv3’，そして‘TLSv1’です．‘auto’が使用されている場合，SSLライブラリは，適切なプロトコルを自動的に自由に選択でき， SSLv2のあいさつを送って，SSLv3とTLSv1のサポートを公表することで達成します．これはデフォルトです．

‘SSLv2’，‘SSLv3’，または‘TLSv1’を使用した場合，対応するプロトコルを強制的に使用します．これは，古かったりバグがあったりする SSLサーバの実装と通信するとき，OpenSSLが正しいプロトコルのバージョンを確実に選択するので役に立ちます．幸いにも，そのようなサーバは滅多にありません．

‘--no-check-certificate’

利用可能な認証局に対する証明書サーバを調査しません．また，証明書に記載されている共通の名前にマッチするホスト名のURLを要求しません．

Wget 1.10では，デフォルトはサーバの認証局を照合し，認証局を認識し，SSL のハンドシェークを破棄し，照合に失敗した場合はダウンロードを中止します．これでより安全なダウンロードを提供しますが，以前のWgetのバージョンで動作さしていたサイトでの互換性が壊れ，特に自己署名，期限切れ，または，その他の無効な証明書を使用しているものです．このオプションで，“不安全” な処理モードを強制し，証明書の照合エラーを警告に変換し，処理の続行を可能とします．

“certificate verification”エラーになったり，“common name doesn’t match requested host name”と言われる場合，このオプションを使用して照合をとばして，ダウンロードを続行することが可能です．別の方法でサイトの認証を確信している場合や，認証の照合を本当に気にしない場合だけ，このオプションを使用してください．秘密や重要なデータを送信するとき，認証調査を行わないのは，ほとんどいつも悪い発想です．

‘--certificate=file’

fileにあるクライアントの証明書を使用します．これは，サーバに接続しようとしているクライアントから証明書を要求するように構成されているサーバで必要です．通常，証明書は要求されないのでこのスイッチはオプションです．

‘--certificate-type=type’

クライアントの証明書の形式を指定します．正当な値は‘PEM’ (デフォルトで想定されます)と‘DER’で，それは‘ASN1’としても知られています．

‘--private-key=file’

秘密鍵をfileから読み込みます．これで証明書から取り出したファイルにある秘密鍵を提供することが可能になります．

‘--private-key-type=type’

秘密鍵の形式を指定します．受け入れられる値は‘PEM’ (デフォルト)と ‘DER’です．

‘--ca-certificate=file’

fileを，照合の対となる認証局(“CA”)にバンドルされているファイルとして使用します．証明書はPEM書式にする必要があります．

このオプションを使用しないと，WgetはCA証明書をシステム指定の場所で探し，それはOpenSSLのインストール時に選択された場所です．

‘--ca-directory=directory’

PEM書式のCA証明書が含まれるディレクトリを指定します．それぞれのファイルには一つのCA証明書が含まれていて，ファイル名は証明書から得られるハッシュ値が基になっています．これは，証明書ディレクトリを，OpenSSLで提供される c_rehashユーティリティで処理することで実施されます．たくさんの証明書がインストールされているとき，Wgetは要求に応じて証明書を取ってくるので，‘--ca-certificate’より‘--ca-directory’の使用がより効果的です．

このオプションを使用しないと，WgetはCA証明書をシステム指定の場所で探し，それはOpenSSLのインストール時に選択された場所です．

‘--random-file=file’

‘/dev/random’が無いシステムで，疑似乱数を生成する種となる乱数データのソースとしてfileを使用します．

そのようなシステムでは，SSLライブラリが外部の乱数初期化ソースを必要します．ランダムさはEGD (後述の‘--egd-file’を参照)で提供されたり，ユーザが指定した外部ソースから読み込んでもかまいません．このオプションが指定されていない場合，ランダムデータを$RANDFILEで探し，それも設定されていない場合，‘$HOME/.rnd’で探します．これら全てが利用不可能な場合，SSLの暗号化は，まず使用できないでしょう．

“Could not seed OpenSSL PRNG; disabling SSL.”というエラーになった場合，上記の手法などを利用して乱数データを提供すべきです．

‘--egd-file=file’

EGDソケットとしてfileを使用します．EGDはEntropy Gathering Daemonを意味し，様々な予想不可能なシステムソースからデータを収集し，それを必要とする外部プログラムで利用可能にするユーザ空間のプログラムです． SSLライブラリのような暗号化ソフトウェアは，暗号的に強い鍵を生成するために使用する乱数生成器の種として，繰り返しの無いランダムさをもつソースが必要です．

OpenSSLで，RAND_FILE環境変数を使用したエントロピーの独自ソースを指定することが可能となります．この変数が設定されていない場合や，指定されたファイルでは十分なランダムさが得られない場合は，OpenSSLは乱数データをこのオプションで指定されているEGDソケットから読み込みます．

このオプションが指定されていない(そして，等価なスタートアップコマンドが使用されていない)場合，EGDを使用しません．EGDは，‘/dev/random’をサポートする最近のUnixでは不用です．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.9 FTPオプション

‘--ftp-user=user’

‘--ftp-password=password’

FTPサーバのユーザ名userとパスワードpasswordを指定します．これや対応するスタートアップオプションをを用いないと，パスワードのデフォルトは‘-wget@’になり，通常は匿名FTPで使用されるものになります．

ユーザ名とパスワードを指定するもう一つの方法は，URL自身に書く方法です(see section URLの書式)．いずれの手法でも，パスワードはpsを実行することで，誰でも見れるようになってしまいます．パスワードを見られることを避けるため，‘.wgetrc’や‘.netrc’に保存し，chmodで他のユーザから確実にこれらのファイルを保護してください．パスワードが本当に重要な場合，これらのファイルに書くことも止めてください—Wgetがダウンロードを開始した後で，ファイルを編修し削除してください．

‘--no-remove-listing’

FTPの回収で生成された，一時的な‘.listing’を削除しません．通常，これらのフィルは，FTPサーバから得た生のディレクトリリストを含んでいます．それを削除しないことで，デバッグが目的のときや，リモートサーバのディレクトリの内容について簡単な調査を可能にしたい時に役に立つはずです(例えば，実行しているミラーが完全なことを検証します)．

Wgetが既知のファイル名にこのファイルを書いたとしても，ユーザが ‘.listing’のシンボリックリンクを‘/etc/passwd’に作成したり， rootにWgetをそのホームディレクトリで実行するように頼むといったシナリオでも，これはセキュリティホールにはならないことに注意してください．使用するオプションに依存して，Wgetは‘.listing’への書き込みを拒否したり，glob/再帰/タイムスタンプの処理を失敗させたり，シンボリックリンクが削除されたり実際の‘.listing’ファイルに置換されたり，リストが ‘.listing.number’ファイルに書き込まれたりします．

この状況に問題があっても，rootは決してWgetを信頼できないユーザのディレクトリで実行しません．ユーザは‘index.html’を ‘/etc/passwd’にリンクしたり，ファイルが上書きされるように rootに‘-N’や‘-r’を用いてWgetを実行するように頼むような，簡単なことしかできません．

‘--no-glob’

FTPのglobをオフにします．globはシェルのような特別文字(ワイルドカード(wildcards))，つまり，同じディレクトリから一度に一つ以上のファイルを回収するための‘*’，‘?’，‘[’と‘]’のようなものの利用を意味します．以下のようにします．

wget ftp://gnjilux.srk.fer.hr/*.msg

デフォルトで，URLがglob文字を含む場合，globはオンです．このオプションで永久的にglobのオン/オフに使用できます．

シェルによる展開から保護するため，URLを引用符で囲む必要があるかもしれません．globでWgetにディレクトリリストを探し，それはシステム指定のものになっています．これは，現在の仕事がFTPサーバでのみ動作するからです(そしてそれは，Unix ls出力をエミュレートします)．

‘--no-passive-ftp’

パッシブ(passive) FTP転送モードを利用不可能にします．パッシブFTPでは，通常とは反対に，データ接続を確立するためサーバに接続するクライアントに命令します．

マシンがインターネットに直接つながっている場合は，パッシブでもアクティブでもFTPは同じようにうまく動作します．ほとんどのファイアー・ウォールや NAT経由で接続しているパッシブFTPでは，うまく動作することでしょう．しかし，ファイアー・ウォール経由の接続で，パッシブFTPが動作しないときでもアクティブFTPが動作することもあります．このような状況だと疑われる場合は，このオプションを使用するか，入力ファイルでpassive_ftp=offを設定してください．

‘--retr-symlinks’

通常，FTPディレクトリを再帰的にダウンロードしていて，シンボリックリンクに遭遇したとき，リンクされているファイルはダウンロードされません．その代わりに，マッチしたシンボリックリンクはローカルファイルシステムに作成されます．指し示されているファイルは，この再帰的な回収でバラバラになり，それを何とかしてダウンロードしようとしない限り，ダウンロードされません．

しかし，‘--retr-symlinks’が指定されている場合，シンボリックリンクは切断され，指定されたファイルが回収されます．この時，このオプションで， Wgetはディレクトリに対するシンボリックリンクを切断して再帰的に回収しませんが，将来はそうするように拡張されるでしょう．

ファイル(ディレクトリではない)の回収時には，それが再帰されているためではなく，それがコマンドラインで指定されているために，このオプションの効果がなくなります．シンボリックリンクは，この場合は常に切断されます．

‘--no-http-keep-alive’

HTTPダウンロードでの“keep-alive”の機能を停止します．通常，同じサーバから一つ以上の文書をダウンロードするとき，同じTCP接続を利用して転送するため，Wgetはサーバにそのまま接続し続けるかどうか尋ねます．これは時間を無駄にせず，同時にサーバの負荷を低減します．

このオプションは，なんらかの理由があり，永続的な(keep-alive)接続がうまく動作しないときに役に立ち，例えば，サーバのバグや接続に対処するサーバ・サイド・スクリプトが利用できないときです．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]

[ ? ]

2.10 再帰的な回収オプション

‘-r’

‘--recursive’

再帰的な回収を開始します．詳細はSee section 再帰的なダウンロード.

‘-l depth’

‘--level=depth’

再帰的な最大深度の階層をdepthに設定します．(see section 再帰的なダウンロード)．デフォルト最大深度は5です．

‘--delete-after’

このオプションは，ダウンロードした後に全ての単一ファイルを削除するようWgetに伝えます．それはプロキシから取得した一般的なページに対し便利で，例えば以下のようにします．

wget -r -nd --delete-after http://whatever.com/~popular/page/

‘-r’オプションは再帰的に回収し，‘-nd’はディレクトリを作成しません．

‘--delete-after’がローカルマシンのファイルを削除することに注意してください．例えばそれは，リモートのFTPサイトに‘DELE’コマンドを発行しません．また‘--delete-after’が指定されたとき，‘.orig’ファイルが単純に最初の位置に作成されないため，‘--convert-links’が無視されることにも注意してください．

‘-k’

‘--convert-links’

ダウンロードが完了した後，ドキュメント内のリンクをローカルでの閲覧に適したものに変換します．これは目に見えるハイパーリンクのみならず，埋め込み画像，スタイルシートへのリンク，HTMLでない内容へのハイパーリンク等のように，外部の内容にリンクしているドキュメントの，あらゆる部分にも影響があります．

それぞれのリンクは二つの方法のうちの一つで変換されます．

Wgetでダウンロードされたファイルへのリンクは，相対的なリンクとしてそれが示すファイルへの参照を変更します．
例：ダウンロードされたファイル‘/foo/doc.html’が ‘/bar/img.gif’にリンクしていて，それもダウンロードされている場合， ‘doc.html’内のリンクは‘../bar/img.gif’を示すものに変更されます．この種の変換は，ディレクトリの任意の組合せで信頼できるように動作します．
Wgetがダウンロードしていないファイルへのリンクは，ホスト名とそれが示す場所の絶対パスに変更されます．
例：ダウンロードされたファイル‘/foo/doc.html’が， ‘/bar/img.gif’ (または‘../bar/img.gif’)へリンクしている場合， ‘doc.html’内のリンクは‘http://hostname/bar/img.gif’を示すものに変更されます．

このため，ローカルでの閲覧が信頼できるように動作します．リンクされているファイルがダウンロードされている場合，リンクはそのローカル名を参照します．それがダウンロードされていない場合は，リンクは存在する壊れたリンクではなく，その完全なインターネットアドレスを参照します．前のリンクが相対リンクに変換されるという事実は，ダウンロードされた階層を別のものに移動することを確実に可能にします．

ダウンロード後のみ，Wgetはリンクがダウンロードされたことを知ることができます．そのため，‘-k’が行う仕事は，すべてのダウンロード終りに実行されます．

‘-K’

‘--backup-converted’

ファイルの変換時に，オリジナルバージョンのファイルを‘.orig’接尾子を用いてバックアップします．‘-N’の動作に効果があります (see section HTTPタイムスタンプの内部)．

‘-m’

‘--mirror’

ミラーに適したオプションを開始します．このオプションは回収とタイムスタンプを開始し，無限の再帰深度を設定し，FTPディレクトリリストを保ちます．現在は，‘-r -N -l inf --no-remove-listing’と同じです．

‘-p’

‘--page-requisites’

このオプションで，Wgetは与えられたHTMLページを適切に表示するのに必要なすべてのファイルをダウンロードします．これは，画像，音声，そして参照されるスタイルシートのようなものを含みます．

通常は，単一のHTMLページをダウンロードするとき，正しく表示するのに要求される可能性のある，必要なドキュメントも全くダウンロードされません． ‘-l’を用いた‘-r’オプションの使用は役に立つはずですが，Wgetは外部とインラインドキュメントを通常区別するので，通常は失われた必要なものとなる“leaf documents”として残ったままです．

例えば，‘1.gif’を参照する<IMG>タグと，外部ドキュメント ‘2.html’を指し示す<A>タグを含む，ドキュメントを考えます． ‘2.html’は似ていますが，その画像‘2.gif’でそのリンクは ‘3.html’とします．この繰り返しは，任意の，より大きい数字まであるとします．

以下のコマンドを実行したとします．

wget -r -l 2 http://site/1.html

すると，‘1.html’，‘1.gif’，‘2.html’，‘2.gif’，そして‘3.html’はダウンロードされます．見てお分かりのように，再帰を停止する場所を決定するために，Wgetは，‘1.html’からのホップの数(を2 まで) しか数えないので，‘3.html’にはそれが必要とする‘3.gif’ がありません．しかし，以下のコマンドを用いたとします．

wget -r -l 2 -p http://site/1.html

それは，上記のすべてのファイルおよび‘3.html’が必要とする ‘3.gif’がダウンロードされます．同様に，以下のようにします．

wget -r -l 1 -p http://site/1.html

これで，‘1.html’，‘1.gif’，‘2.html’，そして‘2.gif’ がダウンロードされます．このように考えることもできます．

wget -r -l 0 -p http://site/1.html

これは，‘1.html’と‘1.gif’のみをダウンロードすると思われますが， ‘-l 0’は‘-l inf’—すなわち無限再帰—と等価なので，残念ながらそうなりません．単一のHTMLページ(または，コマンドラインや ‘-i’ URL入力ファイルで指定された少数のもの)とその(またはそれらの)必需品をダウンロードするために，単に‘-p’と‘-l’のみ残してください．

wget -p http://site/1.html

Wgetは，‘-r’が指定されたかのように動作しますが，単一のページとその必需品のみダウンロードされることに注意してください．外部ドキュメントへのリンクはだとりません．実際，単一のページとその必需品を(たとえ別のウェブサイトに存在していても)ダウンロードするためと，ひとまとまりで正しくローカルに表示することを保証するために，この作者は，‘-p’に加えていくつかのオプションを使用することを好みます．

wget -E -H -k -K -p http://site/document

このトピックの終りになりますが，外部ドキュメントへのリンクだとWgetが考える方法は，<A>タグ，<AREA>タグ，または，<LINK REL="stylesheet">以外の<LINK>タグで指定されているあらゆるURLがそうであると考えるという方法です．

‘--strict-comments’

HTMLのコメントの厳密な字句解析を開始します．デフォルトは，最初に ‘-->’が見つかったときにコメントを終了します．

仕様書によると，HTMLのコメントは，SGMLの宣言 (declarations)として表現されています．宣言は‘<!’で始まり‘>’ で終る‘<!DOCTYPE ...>’のような特別なマークアップで，それには ‘--’分離子の組の間にコメントを含めてもかまいません．HTMLのコメントは“’空の宣言”で，それはコメントのテキストが無いSGMLの宣言です．このため，‘’は有効なコメントで，‘’もそうですが，‘’はそうではありません．

一方，ほとんどのHTML作者は，コメントの理解として‘’で分離されたテキストとして以上のものはなく，それは同じものではありません．例えば，‘’のようなものはダッシュの数が四の倍数になっている限り有効なコメントとして動作します(!)．そうでない場合，コメントは技術的には，次の‘--’がない限り最後まで続き，それはドキュメントの最後まで行ってしまうかもしれません．このため，多くの有名なブラウザは，仕様書を無視し，ユーザが期待したように実装されています．コメントは‘’で分離されています．

バージョン1.9までのWgetはコメントを厳密に解釈していて，結果として多くの洗練されているブラウザでは表示される，多くのWebページへのリンクが失われていて，準拠していないコメントを含むものが不幸にも残っていました．バージョン1.9からは，“ネイティブ”のコメント，つまりそれぞれのコメントは最初に‘-->’が見つかると終端されたものとして実装されたクライアントの仲間入りを成し遂げました．

何らかの理由があって，厳密なコメントとする字句解析を行ないたい場合，このオプションを使用して，それを開始して下さい．

[ < ]

[ > ]

[ << ]

[上]

[ >> ]