FETCH

Section: User Commands (1)
索引 jman

BSD mandoc

名称

fetch - URL (Uniform Resource Locator) 形式でのファイルの取得

書式

[-146AFMPRUadlmnpqrsv ] [-B bytes ] [-S bytes ] [-T seconds ] [-N file ] [-o file ] [-w seconds ] [-h host ] [-c dir ] [-f file ] [URL ... ]

索引

解説

ユーティリティは fetch(3) ライブラリへのコマンド行インタフェースを提供します。目的は、コマンド行の URL (複数可) に示されるファイル (複数可) を取得することです。

以下のオプションが使用可能です。

-1: 最初にファイルの取得に成功したときに、終了値 0 を返して停止します。
-4: が IPv4 アドレスのみを使用することを強制します。
-6: が IPv6 アドレスのみを使用することを強制します。
-A: ``一時的な'' (302) リダイレクトを自動的には追跡しません。要求したオブジェクトが存在しない場合に、発見できないというエラーではなくリダイレクトを返すという、壊れたウェブサイトが存在します。
-a: ソフト上での失敗の場合に自動的に転送を再試行します。
-B bytes: 読み込みバッファの大きさをバイト単位で指定します。デフォルトは 4096 バイトです。バッファの大きさを小さくしようとしても、黙って無視されます。実際に実行された読み込み回数は、冗長レベル 2 以上で報告されます ( -v フラグを参照してください)。
-c dir: 遠隔ホストの dir ディレクトリのファイルを取得します。本オプションは、価値が低下しており、後方互換性のためだけに提供されています。
-d: プロキシが設定されていても、直接接続します。
-F: -r フラグと組み合わせると、ローカルファイルとリモートファイルの修正時刻が異なったとしても、強制的に再開します。 -R を暗黙的に指定します。
-f file: 遠隔ホストの file という名前のファイルを取得します。本オプションは、価値が低下しており、後方互換性のためだけに提供されています。
-h host: ホスト名が host にあるファイルを取得します。本オプションは、価値が低下しており、後方互換性のためだけに提供されています。
-l: 目標が、ファイル形式の URL の場合、目標を複製しようとするのではなく、リンクを作成します。
-M
-m: ミラーモード: ローカルホストにファイルが既に存在し、サイズと変更時間がリモートファイル同じである場合、転送は行われません。 -m と -r のフラグは、あいいれないことに注意してください。
-N file: ~/.netrc の代りに file を使用し、FTP サイト用のログイン名とパスワードを見付けます。ファイルの書式については ftp(1) を参照してください。この機能は実験的です。
-n: 転送されるファイルの変更時間を保存しません。
-o file: 出力ファイル名を file にします。デフォルトでは、``パス名'' が指定された URI から取り出され、そのベースネームが出力ファイルの名前として使われます。 file 引数として `- ' を与えると、結果は標準出力に出力されます。 file 引数がディレクトリである場合、取得したファイルはそのディレクトリに置かれます。ファイル名はデフォルトの動作の場合と同じように選択されます。
-P
-p: FTP プロトコルをパッシブモードで使います。これは、入力接続をブロックするファイアウォール (firewall) の背後にいる場合に有用です。 FTP URL を取得するときにがハングするように見える場合に使用してみてください。
-q: 沈黙モード。
-R: 出力ファイルは大事にされ、どんな状況下でもファイルは消去されません。それは、転送が失敗もしくは不完全であった時でさえ、あてはまります。
-r: 以前に中断された転送を再開します。 -m と -r のフラグは、あいいれないことに注意してください。
-S bytes: サーバが報告するファイルサイズが、指定値に合致することを要求します。合致しない場合、メッセージが表示され、ファイルは取得されません。サーバがファイルサイズの報告をサポートしていない場合、本オプションは無視され、無条件にファイルが取得されます。
-s: 各要求ファイルごとに、取得せずに、バイト数単位の大きさを表示します。
-T seconds: タイムアウト時間を seconds 秒に設定します。 FTP での転送に対しては FTP_TIMEOUT 環境変数が、HTTP での転送に関しては HTTP_TIMEOUT 環境変数が、設定されていた場合は、それを上書きします。
-U: パッシブな FTP を使用しているとき、データ接続用に低位 (デフォルト) ポートを割り当てます。どのポート範囲が対応するかの指定方法の詳細については、 ip(4) を参照してください。
-v: 冗長レベルを増やします。
-w seconds: -a が指定された場合、次のリトライの前に指定した秒数だけ待ちます。

が SIGINFO シグナルを受け取ると ( stty(1) への status 引数を参照して下さい)、現在の転送レートの統計情報が、標準の完了メッセージと同じ書式で標準エラー出力に書き込まれます。

索引

診断

コマンドは、成功時には 0 を返し、失敗時には 1 を返します。コマンド行上に複数の URL を指定した場合、は、それぞれを順番に取得しようとし、すべての取得に成功した場合のみに 0 を返します。

索引

環境変数

FTP_TIMEOUT: FTP 接続を中断するまでの最大時間を秒で指定します。
HTTP_TIMEOUT: HTTP 接続を中断するまでの最大時間を秒で指定します。

fetch(3) ライブラリの文書に記述されている環境変数は、すべてサポートされています。これらの環境変数の多くは、を正しく操作するために非常に重要なものです。一緒に fetch(3) も読む事を強くお勧めします。

索引

歴史

コマンドは Fx 2.1.5 から導入されました。本実装が最初に登場したのは Fx 4.1 です。

索引

作者

An -nosplit のオリジナル実装は An Jean-Marc Zucconi Aq jmz@FreeBSD.org が行いました。 Fx 2.2 のために、拡張を行ったのは An Garrett Wollman Aq wollman@FreeBSD.org であり、後に fetch(3) を使用するように An Dag-Erling Sm/orgrav Aq des@FreeBSD.org が完全に書き直しました。

索引