FTP(1)

名称
ftp, pftp, gate-ftp - ARPANET ファイル転送プログラム

書式
ftp [-46adeginptUvV] [-P port] [-s src_addr] [host [port]] ftp ftp://[user:password@]host[:port]/file[/] ftp http://host[:port]/file ftp host:[/path/]file[/]

解説
ftp は、 ARPANET 標準のファイル転送プロトコルを用いてファイル転送を実現するためのコマンドです。 本コマンドは、ネットワークを介して接続されているコンピュータ間で ファイルを転送する手段をユーザに提供します。 本バージョンは、 IPv4 と共に、 IPv6 (インターネットプロトコルバージョン 6) をサポートします。

書式の後ろから 3 つの使用例の形式では HTTP または FTP プロトコルの いずれかを使ってファイルをカレントディレクトリに取得します。 これはスクリプト用に理想的です。 より詳しい情報については ファイルの自動的な取得 を参照して下さい。

オプションは、コマンドライン上か、コマンドインタプリタで指定できます。

-4  ftp に IPv4 アドレスのみを使用するよう強制します。

-6  ftp に IPv6 アドレスのみを使用するよう強制します。

-a  ftp は通常のログイン手続きを飛ばして、かわりに anonymous ログインを 使います。

-d  デバッグを有効にします。

-e  コマンドラインでの編集を無効にします。

-g  ファイル名展開を無効にします。

-i  複数ファイル転送を行っている間の対話的プロンプトモードを オフにします。

-n  ftp が最初に接続する際の “自動ログイン” を行いません。 自動ログインが許可された場合は、 ftp は起動したユーザのホームディレクトリの .netrc (下記参照) ファイルに、リモートマシンのアカウントを記述している エントリがあるかどうかを調べます。 そのファイルにエントリがない場合には、 ftp はリモートマシン上のログイン名 (デフォルトはローカルマシンでのユーザ ID) を要求します。 そして、もし必要があればログイン用のパスワードと アカウントの入力も促します。

-p  防火壁を越える接続のためのパッシブモード操作を有効にします。 pftp コマンドを使うのと同じです。

-P port
    ポート番号を port に設定します。

-s src_addr
    すべての接続に使用するローカル側の IP アドレスを src_addr に設定します。IP アドレスとホスト名のどちらでも指定できます。

-t  パケットのトレースを有効にします。

-U  データポートの範囲制限を無効にします。

-v  饒舌モードを有効にします。 入力が端末からの場合はこれがデフォルトです。 ftp はデータ転送状況と、 リモートサーバからのすべてのレスポンスを表示します。

-V  入力が端末からの場合に、デフォルトで有効になっているのを無視して 饒舌モードを無効にします。

ftp は、通信相手をコマンドラインで指定することが出来ます。通信相手を コマンドラインで指定した場合、 ftp は指定したリモートマシンの FTP サーバプログラムとの接続を試みます。それ以外の場合、 ftp は内部のコマンドインタプリタに入り、ユーザからの コマンド入力を待ちます。このとき ftp は、 ‘ftp>’ というプロンプトを出力します。 本状態の時には、 ftp は以下のコマンドを受け付けます。

! [command [args]]
    ローカルマシン上でシェルを起動します。 引数が指定された場合、最初の引数をコマンドとして実行し、 それ以降の引数はそのコマンドに対する引数として処理されます。

$ macro-name [args]
    macro-name で定義されたマクロを実行します。マクロは、 macdef コマンドで定義出来ます。 args で指定された文字列は、展開されずにマクロに対して引き渡されます。

account [passwd]
    一旦ログインに成功したユーザが、資源を扱うためにリモートマシンから 要求された追加のパスワードを入力します。 引数が指定されない場合、ユーザに対してパスワード入力を促す表示がされます。 この場合はパスワードはエコーバックされません。

append local-file [remote-file]
    ローカルファイルをリモートマシン上のファイルに追加書き込みします。 もし、 remote-file が指定されていなければ、ローカルファイルの名前を ntrans や nmap で修正した名前をリモートファイル名として使います。 ファイル転送では type, format, mode, structure の現在の設定が使われます。

ascii
    転送ファイルの type をネットワーク ASCII 形式にします。 これはデフォルト時の設定です。

bell
    各ファイル転送コマンド終了時にベルを鳴らすかどうかを指定します。

binary
    転送ファイルの type をバイナリ形式にします。 イメージファイルなど、バイナリファイルを転送する時には本指定は必須です。

bye リモートサーバとの FTP セッションを終了し、 ftp を終了します。 EOF を入力した場合も同様です。

case
    mget コマンドで連続してファイルを取得する場合、リモートマシン上の ファイル名の大文字小文字の対応を切り替えます。 デフォルトでは case はオフですが、オンの場合にはリモートマシンファイル名の すべての大文字が小文字に変換されて、ローカル マシンのディレクトリに 書き込まれます。

cd remote-directory
    リモートマシン上での作業ディレクトリを remote-directory へ変更します。

cdup
    リモートマシン上での作業ディレクトリを一つ上に変更させます。

chmod mode file-name
    file-name で指定したリモートマシン上のファイルの属性を、 mode で指定したものに変更します。

close
    リモートサーバとの FTP セッションを終了します。そしてコマンド入力待ちのプロンプトを表示します。 すでに定義されたマクロはすべて無効になります。

cr  ASCII 形式ファイルの転送を行なう場合に、 復帰コードの除去を行なうかどうかを変更します。 ASCII 形式のファイル転送時には、 復帰/改行 の文字列によってレコードが認識されます。 cr がオン (デフォルト) の時には、改行コードのみでレコードを区切る UNIX に適合するように、 復帰コードが文字列から除去されます。 UNIX 以外のリモートのシステムのレコードは 単独の改行コードを含む可能性があります。 ASCII 形式で転送を行った時には、そういった改行コードは cr がオフの場合にだけレコード区切り記号と区別して扱われます。

delete remote-file
    リモートマシン上のファイル remote-file を削除します。

debug [debug-value]
    デバッグモードを切り替えます。 debug-value が指定されるとデバッグレベルとして設定されます。 デバッグモードが有効になると、 ftp はリモートマシンに送信されたコマンドを ‘-->’ に続けて表示します。

dir [remote-directory [local-file]]
    リモートマシン上のディレクトリの内容を表示します。 表示内容にはサーバが選択したシステム依存の情報を含みます。 例えば大部分の UNIX システムは ‘ls -l’ コマンドから得られる出力を表示します。 ( ls も参照して下さい) もし remote-directory が指定されなければ、リモートマシン上のカレントディレクトリの内容が 表示されます。 もしプロンプトがオンだったら、 ftp は、最後の引数が本当に dir の出力を書き込むローカルファイルかどうか問い合わせます。 ローカルファイルの指定が無い場合、または local-file の指定が ‘-’ だった場合は出力は画面に表示されます。

    本コマンドはシステム依存の追加情報を提供しますので、 単なるファイルリストが欲しい場合には、 nlist を使ってください。

disconnect
    close と同じです。

edit
    コマンドラインの編集機能、そして文脈に応じたコマンドとファイルの 補完機能を切り替えます。 これは入力が端末の場合は自動的に有効になり、そして そうでなければ無効になります。

exit
    bye と同じです。

ftp host [port]
    open と同じです。

form format
    ファイル転送様式を format と指定します。 デフォルトでは、様式は file となります。

get remote-file [local-file]
    リモートマシン上のファイル remote-file を取得してローカルマシン上に格納します。 ローカルファイル名 local file が指定されない場合、 ローカルファイル名は取得したファイルの リモートマシン上の名前と同じになります。 ただし、その名前は case, ntrans, nmap の設定により変更される事があります。 ファイル転送の時には現在の type, form, mode, structure の設定が使用されます。

gate [host [port]]
    gate-ftp モードを切り替えます。 これは gate-ftp サーバが設定されていないと有効になりません (ユーザによって明示的に、または FTPSERVER 環境変数によって)。 host が与えられると、 gate-ftp モードが有効になり、そして gate-ftp サーバが host に設定されます。 port も同時に与えられると、それが gate-ftp サーバへ接続する際のポートとして使用されます。

glob
    mdelete, mget, mput を行なう場合のファイル名の展開のオン/オフを切り替えます。 glob がオフの場合には、ファイル名は展開されずにそのままになります。 mput でのファイル名展開の規則は csh(1) のファイル名展開規則と同様です。 mdelete と mget の場合には、 各々のリモートファイル名はリモートマシン上で別々に展開され、 リストはマージされません。 ディレクトリ名の展開は普通のファイル名の展開と異なる事があります。 つまり、展開の結果はリモートの OS と FTP サーバに依存しています。 これは ‘mls remote-files -’ を実行する事によってあらかじめ知ることができます。 注: mget と mput はファイルのディレクトリ・サブツリーを全て転送する物ではありません。 そのようにしたい時はサブツリーの tar(1) のアーカイブを作成してバイナリモードで転送します。

hash [size]
    1 データブロック転送するごとに ハッシュサイン (``#'') を出力するかどうかを切り替えます。 デフォルトでは 1 データブロックは 1024byte です。 これは size でバイト単位で指定する事で変更できます。

help [command]
    引数 command で指定したコマンドのヘルプメッセージを出力します。 引数が与えられない場合、 ftp は使用可能なコマンドの一覧を出力します。

idle [seconds]
    リモートサーバ上のアイドルタイマを seconds 秒に設定します。 seconds が与えられない場合は現在のアイドルタイマ値を表示します。

lcd [directory]
    ローカルマシン上の作業ディレクトリを変更します。 directory 名が与えられない場合はユーザのホームディレクトリに移動します。

less file
    page と同じです。

lpwd
    ローカルマシン上の作業ディレクトリを表示します。

ls [remote-directory [local-file]]
    dir と同じです。

macdef macro-name
    マクロ定義を行ないます。 後続の行がマクロ macro-name として格納されます。 空行 (1 つのファイル内での連続した改行文字や端末からの連続した 復帰文字) は マクロの入力モードを終了させます。 マクロの数の制限は 16 個で、定義されたマクロ全部で 4096 文字までがゆるされています。マクロは close コマンドが実行されるまで持続します。 マクロプロセッサは `$' と `\' を特別な文字として解釈します。 1つ以上の数字が続く `$' は、コマンドラインで呼び出したマクロの 対応する引数によって置き換えられます。 後ろに `i' が続く `$' は、マクロプロセッサに対して実行している マクロのループを指示します。 最初のパスで `$i' はマクロを呼び出したコマンドラインの最初の引数に 置き換えられ、2 回目のパスで 2 つ目の引数に置き換えられ、それ以降も 同様に置き換えられます。 後ろに任意の文字が続いている `\' はその文字に置き換えられます。 `\' は `$' の特別な扱いを避けるために使用します。

mdelete [remote-files]
    リモートマシンの remote-files を削除します。

mdir remote-files local-file
    複数のリモートファイルを指定出来る点を除くと dir と同様です。 プロンプトがオンの時には、 ftp は最後の引数が mdir の出力を受け取るローカルファイルであるかをユーザに問い合わせます。

mget remote-files
    リモートマシンで remote-files で指定されたファイルを展開し、展開後の各ファイル名のファイルに対して get を実行します。 ファイル名の展開の詳細は glob を参照してください。 生成されたファイル名は case, ntrans, nmap の設定に従い処理されます。 ファイルはローカルの作業ディレクトリに転送されます。 そのディレクトリは ‘lcd directory’ で変更できます。 ローカルの新しいディレクトリは ‘! mkdir directory’ で作成できます。

mkdir directory-name
    リモートマシンにディレクトリを作ります。

mls remote-files local-file
    複数のリモートファイル名を指定できる点と local-file を必ず指定しなければならない点を除くと ls と同様です。 プロンプトがオンの時には、 ftp は最後の引数が mls の出力を受け取る目標のローカルファイルであるかをユーザに確認します。

mode [mode-name]
    ファイル転送モード mode を mode-name で指定したものに設定します。 デフォルトは stream です。

modtime file-name
    リモートマシン上の指定ファイルの最終更新日時を参照します。

more file
    page と同じです。

mput local-files
    引数として与えられたローカルファイルのリスト中の ワイルドカードを展開し、 展開後の各ファイル名のファイルに対して put を実行します。 ファイル名の展開の詳細については glob を参照してください。 生成されたファイル名は ntrans と nmap の設定に従って処理されます。

msend local-files
    mput と同じです。

newer file-name
    リモートマシンのファイルの最終更新日時の方が ローカルマシンのファイルより新しい場合にのみファイルを取得します。 現在のシステムにファイルが無いときには、リモートファイルの方が 新しい ものとして扱われます。 その他については get と同じです。

nlist [remote-directory [local-file]]
    リモートマシンのディレクトリの内容のリストを表示します。 remote-directory の指定が無い場合には、 代わりに現在の作業ディレクトリが使われます。 もしプロンプトモードになっているならば、 ftp は、最後の引数が ls の出力を受け取るローカルのファイルであるかをユーザに問い合わせます。 local-file の指定がない場合や - が指定されている場合には、 出力は画面に表示されます。

    本コマンドがリモートディレクトリ中のファイル一覧を返すだけであることに 注意してください。 ファイルについての更なる情報 (大概は大きさや修正時刻など) が欲しい場合、 dir を使ってください。

nmap [inpattern outpattern]
    ファイル名のマッピング機能を設定したり解除したりします。 引数が無い場合にはマッピング機能が解除されます。 引数がある場合には、出力先のリモートファイル名の指定されていない mput コマンドと put コマンドの実行時に、リモートファイル名がマップされます。 同様な事が mget コマンドと get コマンドのローカルファイル名についても行われます。 このコマンドはファイルの命名規則が異なる UNIX ではないリモートマシンとの接続時に便利です。 マッピングは inpattern と outpattern によって設定されたパターンに従って行われます。 [inpattern] は (すでに ntrans と case によって処理されているかもしれない) 入力ファイル名のためのテンプレートです。 inpattern に `$1', `$2', ..., `$9' の文字列を含むことによって、 変数を使用したテンプレートも使えます。 `$' を特別扱いしたくない時には `\' を使ってください。 他の文字はそのままその文字として扱われ、 nmap の [inpattern] 変数の値を決めるのに用いられます。 例えば、 inpattern として $1.$2 が、 リモートファイルの名前として "mydata.data" が 与えられた時に、$1 は "mydata" という値となり， $2 は "data" という値になります。 outpattern は生成されるマッピング後のファイル名を決定します。 文字列の `$1', `$2', ...., `$9' は inpattern のテンプレートから生成される値に置き換えられます。 文字列の `$0' は元のファイル名で置き換えられます。 さらに、文字列の ‘[seq1, seq2]’ は seq1 が空文字列でない時には [seq1] に、 空文字列の時には [seq2] に置き換えられます。 例えばコマンド

        nmap $1.$2.$3 [$1,$2].[$2,file]

    は、 入力ファイル名 "myfile.data" と "myfile.data.old" に対して出力ファイル名が "myfile.data" になり、 入力ファイル名 "myfile" に対して出力ファイル名が "myfile.file" になり、 入力ファイル名 ".myfile" に対して 出力ファイル名が "myfile.myfile"になります。 例えば、`nmap $1 sed "s/ *$//" > $1' のように、 outpattern にはスペースが入っていても構いません。 文字 `$', `[', `]', `,' を特別扱いしたくない時には `\' を使ってください。

ntrans [inchars [outchars]]
    ファイル名の文字変換機能を設定したり解除したりします。 引数が無い場合には文字変換機能が解除されます。 引数がある場合には、出力先のリモートファイル名の指定されていない mput コマンドと put コマンドの実行時にリモートファイル名が変換されます。 同様な事が mget コマンドと get コマンドでもローカルファイルに対して行われます。 このコマンドは、 UNIX とは異なるファイル命名規則のリモートマシンとの接続時に有効です。 ファイル名中の文字で、 inchars の中の文字に一致するものが outchars の対応する文字に置き換えられます。 inchars の中での文字の位置が outchars の長さを越えている時には、その文字はファイル名から削除されます。

open host [port]
    指定した host の FTP サーバとのコネクションを確立します。 ポート番号 port を指定した場合、 ftp は指定したポート番号を用いて FTP サーバとのコネクションの確立を試みます。 自動ログイン オプションがオン (デフォルト時) の場合には、 ftp は自動的に FTP サーバに対してログインを行ないます (以下を参照)。

page file
    file を取得して、 PAGER で指定されたプログラム (デフォルトは more(1) ) を使って表示します。

passive
    パッシブモードを切り替えます。パッシブモードがオン (デフォルトはオフ) なら、ftp クライアントは すべてのデータコネクションにおいて、通常の PORT コマンドの代わりに PASV コマンドを送ります。 PASV コマンドはリモートのサーバにデータコネクションのためのポートを 開いて、そのポートのアドレスを返すよう要求します。 リモートサーバはそのポートで待ち、クライアントはそこに接続します。 より伝統的な PORT コマンドを使う場合は、クライアントがポートで待ち、そしてそのアドレスを リモートサーバに送ってリモートサーバはそこに接続して来ます。 パッシブモードは ゲートウェイ・ルータやトラフィックの方向を制御しているホストを 経由して ftp を使う場合に有用です。 (注: ftp サーバが RFC 1123 の PASV コマンドをサポートしている必要がありますが、サポートしていない 場合もあります。 IPv6 サーバに接続している場合、 EPSV/EPRT ペアと LPSV/LPRT ペアを使い、 PASV と PORT は使わないことに注意してください。 他は同じです。)

preserve
    受け取ったファイルの更新日時を保存するかどうかを切り替えます。

progress
    転送の進行状況を表す棒グラフ表示を切り替えます。 この棒グラフは、 ローカルファイル として ‘-’ か ‘|’ で始まるコマンドが指定された転送では表示されません。 詳しくは ファイル名の規則 を参照して下さい。

prompt
    対話的プロンプトモードを切り替えます。 対話的プロンプトモードをオンにすることで、 複数ファイル転送時に転送ファイルの選択を行なえます。 対話的プロンプトモードをオフにすると (デフォルトはオン)、 mget や mput で指定したファイルはすべて転送され、 mdelete で指定したファイルはすべて削除されます。

    プロンプトモードがオンの時には、プロンプトにおいて以下の コマンドが使用できます:

    n   ファイルを転送しません。

    a   現在のファイルについて ‘yes’ とし、自動的に現在のコマンドに対する残りのすべての ファイルに対しても ‘yes’ とします。

    p   現在のファイルについて ‘yes’ とし、プロンプトモードをオフにします (あたかも “prompt off” が指定されたかのように)。

    これ以外の応答は現在のファイルに対する ‘yes’ として扱われます。

proxy ftp-command
    ftp コマンドを 2 次制御接続上で実行します。 本コマンドを用いることで、同時に 2 つのリモートマシンとコネクションを確立し、 2 つのサーバ間でファイル転送を行なうようにすることができるようになります。 最初の proxy コマンドは open コマンドである必要があります。 これは、2 次的な制御コネクションを確立するために必要な操作です。 "proxy ?" とコマンドを実行することで、 2 次接続下で使用可能なコマンド一覧が表示されます。 以下のコマンドは proxy の後におかれた時には異なった働きをします。 open は自動ログイン処理中には新しいマクロの定義を行いません。 close はマクロの削除を行いません。 get と mget は 1次制御接続のホストから 2次制御接続のホストにファイルの転送を行います。 put と mput と append は 2次制御接続のホストから 1次制御接続のホストにファイルの転送を行います。 第三者のファイル転送は、2次制御接続のサーバが FTP プロトコルの PASV コマンドをサポートしているかどうかに依存します。

put local-file [remote-file]
    ローカルマシン上の指定ファイルをリモートマシンに転送します。 remote-file が指定されない場合には、転送先でのファイル名は、 ntrans か nmap の設定に基づく処理を行ったローカルファイルの名前が用いられます。 ファイル転送には type, format, mode, structure の現在の設定が用いられます。

pwd 現在のリモートマシン上での作業ディレクトリを表示します。

quit
    bye と同じです。

quote arg1 arg2 ...
    引数で指定した文字列を、そのままリモート FTP サーバに送信します。

recv remote-file [local-file]
    get と同じです。

reget remote-file [local-file]
    getと似ていますが、 local-file が存在しており remote-file よりサイズが小さい場合には、 local-file がリモートファイルの一部であるとみなして続きをコピーする点が異なります。 本コマンドは、大きいファイルの転送中にコネクションが 切断されてしまった場合の続きを受信しなおす場合などに有用です。

remotehelp [command-name]
    リモート FTP サーバのヘルプメッセージを要求します。 command-name が指定された場合にはそのコマンドのヘルプが表示されます。

rstatus [file-name]
    引数がない場合にはリモートマシンのステータスが表示されます。 file-name が指定されている場合には、 リモートマシン上の指定ファイルのステータスが表示されます。

rename [from [to]]
    リモートマシン上のファイル from が、 to というファイル名にリネームされます。

reset
    リプライキューをクリアします。 本コマンドはコマンド/リプライのシーケンスの再同期をとるのに使われます。 再同期を取ることは ftp プロトコル上の障害が発生した時に必要な操作です。

restart marker
    get や put を指定した marker 位置から再開します。 UNIX システムにおいては、通常 marker はファイルのバイトオフセットで指定します。

restrict
    データポートの幅を制限するかをオン/オフします。 パッシブモードでない時に、 ftp クライアントはリモートサーバに対して、独立したデータポートで クライアントホストに接続してくることを要求します。 前のバージョンでは、そのリモートポートは 1024 から 4999 までの幅に 収まっていました。 しかしほとんどの防火壁 (fire wall) では、その範囲に他のサービスが あるために TCPポートをフィルタリングしています。 現在のデフォルトの動作では、ポート番号が 49152 から 65535 の間で、 サーバがクライアントに対して接続してくることを要求します。 もしセキュリティ上の危険性がないと考えるならば、防火壁管理者は その幅での TCP 接続に対して許可を行うという選択ができます。

rmdir directory-name
    リモートマシン上のディレクトリを消去します。

runique
    ローカルマシンに保存されるファイルに対して ユニークな名前を付加するかどうかを切り替えます。 get や mget コマンドで目的のローカルファイルと同じ名前のファイルが既に存在する時には、 ".1" が名前に付加されます。 その名前も既に存在する時には ".2" が付加されます。 このように順番に処理をし、 ".99" になっても存在する時には エラーメッセージが表示され、転送は行われません。 生成されたユニークなファイル名は報告されます。 注: runique はシェルコマンドで生成されるファイル名には効果がありません (下記参照)。 デフォルトではオフになっています。

send local-file [remote-file]
    put と同じです。

sendport
    PORT コマンドを使用するかどうか切り替えます。 デフォルトでは、 ftp は各データ転送用のコネクションの確立の際に PORT コマンドの使用を試みます。 PORT を使うことで複数ファイル転送を行なう場合の遅延を避けることが出来ます。 PORT コマンドが失敗した場合、 ftp はデフォルトのデータ・ポートを使用します。 PORT コマンドが無効になった場合、データ転送時に PORT コマンドは使われません。 これはある種の FTP の実装で PORT コマンドは無視するが、誤っていて、受け入れたと返事を返すような 物に対して有効です。

site arg1 arg2 ...
    引数で指定した文字列を、 SITE コマンドの引数としてそのまま FTP サーバに送信します。

size file-name
    リモートマシン上の file-name で指定したファイルのサイズを表示します。

status
    ftp の現在の状態を表示します。

struct [struct-name]
    ファイル転送の structure を struct-name に設定します。 デフォルトでは、stream に設定されています。

sunique
    リモートマシン上に転送するファイルのファイル名に対して、 一意な名前を付与するかどうかを切り替えます。 この機能が使えるためには、 リモートの FTP サーバが FTP のプロトコルの STOU コマンドをサポートしていなければなりません。 リモートサーバがユニークな名前を報告します。 デフォルトではこの機能はオフになっています。

system
    リモートマシンで稼働している OS のタイプを表示します。

tenex
    TENEX マシンと 通信するために必要なファイル転送モードを設定します。

trace
    パケットトレースをするかどうかを切り替えます。

type [type-name]
    ファイル転送の type を type-name に変更します。引数が指定されない場合には 現在のファイル転送タイプを表示します。 デフォルトタイプはネットワーク ASCII です。

umask [newmask]
    リモートサーバのデフォルトの umask 値を newmask で指定した値に変更します。 newmask が指定されていない場合は現在の umask 値を表示します。

    user user-name [password [account]] ユーザをリモート FTP サーバに認識させます。 password が指定されていなくて、 FTP サーバが必要とする場合は (ローカルエコーをオフにしてから) ftp がユーザに問い合わせます。 account が指定されていなくて、 FTP サーバが必要とする場合には、 ftp がユーザに問い合わせます。 リモートサーバがログイン時にアカウントを必要としないのに account フィールドが指定された場合には、ログイン処理の完了後に account コマンドがリモートサーバに渡されます。 「自動ログイン」を無効にした状態で ftp が呼び出されない限り、 この処理は FTP サーバに最初につながった時に自動的に行われます。

verbose
    饒舌モードの切り替えをします。 饒舌モードの時には FTP サーバからの全ての応答が表示されます。 さらにこのモードがオンの時には、ファイル転送が終了した時に 転送効率に関する統計が報告されます。 デフォルトではオンになっています。

? [command]
    help コマンドと同じです。

スペースを含むコマンドの引数は、`"' マークで括って下さい。

設定を切り替えるコマンドでは、設定を指定するために明示的に on か off を引数として指定できます。

ftp が転送中に SIGINFO ( stty(1) の引数 “status” を参照) シグナルを受けると、その時点での転送レートの統計情報が 終了時の標準的なフォーマットと同じ形式で標準エラー出力に書き出されます。

ファイルの自動取得
標準的なコマンドに加えて、 このバージョンの ftp は自動取得の機能をサポートします。 単にホスト名/ファイルのリストをコマンドラインで渡すと 自動取得が有効になります。

自動取得の指定では以下の形式を認識します:

host:/file
    “古典的な” ftp の形式

ftp://[user:password@]host[:port]/file
    ftp URL 形式で、 ftp_proxy が定義されていなければ ftp プロトコルで取得します。 そうでなければ ftp_proxy で指定されたプロキシを経由した http を使って転送します。 user:password@ が指定されていて ftp_proxy が定義されていない場合は、 パスワードに password を使って user でログインします。

http://host[:port]/file
    HTTP URL 形式、http プロトコルで取得します。 http_proxy が定義されている場合は、その内容が HTTP プロキシサーバの URL として使用されます。

古典的な形式または ftp URL形式で最後に ‘/’ がある場合は、 ftp はサイトに接続して与えられたパスのディレクトリに cd し、以降の入力を受け付けるために対話モードに入ります。

自動取得の対象が複数指定されていて、連続しているものが同じホストを 参照している時は、接続の確立と切断によるオーバヘッドを避けるために 複数の転送にわたって接続が維持されます。

ファイル名の展開がオンで file が展開の対象となる文字を含んでいるなら ( glob 参照) mget file と同じ事を行います。

file のディレクトリ部分が展開の対象となる文字を含まなければ、 ファイルは file から basename(1) で得られる名前で現在のディレクトリに置かれます。 そうでなければリモートの名前をローカルでの名前として使います。

ファイル転送の中止
ファイル転送を中断するためには、 端末のインタラプトキー (通常は Ctrl-C) を打鍵してください。 データ送信はただちに停止します。 データ受信は、ftp プロトコルの ABOR コマンドをリモートサーバに送ることでサーバからのデータ送信がとまります。 そしてそれ以降の受信データは捨てられます。 これが行われる速度は、リモートサーバが ABOR コマンドをサポートする方式に依存します。 リモートサーバが ABOR コマンドをサポートしていない時には、 リモートサーバが要求したファイルを送り終るまで ‘ftp>’ というプロンプトは現れません。

端末からの割り込みキー入力は、 ftp が何かローカルの処理をすでに完了していて リモートサーバからの応答を待っている時には無視されます。 このモードでの長い遅延は上でも述べたように ABOR 処理の結果に よるものか、 ftp のプロトコル違反を含めたリモートサーバによる 予期せぬ動作のどちらかによるものです。 もしリモートサーバの予期せぬ動作の結果による遅延であるならば、 ローカルの ftp プログラムは手動で終了 (kill) しなければなりません。

ファイル名の規則
ftp コマンドの引数として指定されたファイル名は、以下の規則で処理されます。

1.  ファイル名として ‘-’ が指定された場合、 入力ファイル名の場合には標準入力 stdin が、 出力ファイル名の場合には標準出力 stdout が使用されます。

2.  ファイル名の先頭の文字が ‘|’ の場合には、その後に指定された文字列はすべてシェルコマンドと解釈されます。 ftp は与えられた引数をつけて popen(3) を用いてシェルを呼び出し、標準入力から (標準出力へ) 読み出し (書き込み) ます。 シェルコマンドにスペースが含まれている時には 引数は引用符で囲まれなければなりません。 (例： " ls -lt" ) 特に有用な例としては dir |more があります。

3.  上記のチェックにひっかからず、 “globbing” が許可されている場合、 ローカルファイル名は csh(1) のファイル名展開規則にしたがって展開されます。 (詳細は glob コマンドを参照) ただし、 ftp のコマンドが 1 つのファイル名しか必要としない場合 (例えば put ) は、ファイル名が展開された後の最初のファイル名だけが使用されます。

4.  mget コマンドと get コマンドにおいてローカルファイル名が指定されない場合、 ローカルファイル名はリモートファイル名と同一になります。 ただし、これらのファイル名は case, ntrans, nmap の設定によって変わることもあります。 結果として得られたファイル名は、 runique が設定されていればさらに変わるかもしれません。

5.  mput コマンドと put コマンドにおいてリモートファイル名が指定されない場合、 リモートファイル名はローカルファイル名と同一になります。 ただし、これらのファイル名は ntrans, nmap の設定によって変わることもあります。 結果として得られたファイル名は、 sunique が設定されていればリモートサーバによって さらに変えられるかも知れません。

ファイル転送パラメータ
FTPの仕様にはファイル転送時に影響を及ぼす多くのパラメータがあります。 type は、ascii, image (binary), ebcdic, local byte size ( PDP-10 および PDP-20 でよく使われます) が指定可能です。 ftp は、ascii と image のタイプを指定可能なのに加えて、 tenex モードの転送を指定することにより ローカルバイトサイズ 8 を指定することが可能です。

ftp では、他の mode, form, struct のパラメータではデフォルト値だけが使用可能です。

.netrc ファイル
.netrc ファイルは、自動ログイン処理においてのログインおよび初期設定情報を記述します。 .netrc ファイルは、ユーザのホームディレクトリに置きます。 .netrc では以下の予約語が解釈されます。これらはスペース、タブそして new-line によって分割されます。

machine name
    リモートマシン名 name を定義します。 自動ログイン処理は .netrc ファイル中に machine トークンがあるかどうか探し、そのエントリが ftp のコマンドラインもしくは open コマンドの引数と一致するかどうかチェックします。 一致するエントリがあった場合は後に続く .netrc トークンが処理され、その処理はファイル最後尾に行き着くか他の machine トークンまたは default トークンに出くわすまで続きます。

default
    いろんな名前と一致するワイルドカード的な働きがあることを除けば machine name と同様です。 default トークンは、 .netrc ファイル中に 1 エントリだけが許され、 しかも他の全ての machine トークンより後ろでなければなりません。 通常は

        default login anonymous password user@site

    のように使用されます。 本エントリによって .netrc に指定の無い ftp サイトに自動で anonymous ログインを試みるようになります。 -n フラグを付加して ftp を起動することで .netrc ファイルを無視することが出来ます。

login name
    リモートマシンにおけるログイン名を指定します。 本トークンが与えられている場合、自動ログイン処理は name をログイン名としてログインしようとします。

password string
    パスワードを指定します。 本トークンが指定されている場合でリモートサーバがログイン処理中に パスワードを要求する場合は、自動ログイン処理は指定した文字列を 送ります。 .netrc ファイルにおいて、 anonymous 以外のユーザエントリにおいて本トークンが登録されており、なおかつ .netrc がユーザ以外から読める属性である場合には ftp は自動ログイン処理を中断します。

account string
    追加のアカウントパスワードを登録します。 このトークンがあると、 もし追加のアカウントパスワードをリモートホストが必要とする時に 自動ログインプロセスが指定された文字列を与えます。 そうでない場合には、自動ログインプロセスは ACCT コマンドを与えます。

macdef name
    マクロを定義します。 このトークンの機能は ftp macdef コマンドの機能に似ています。 マクロは指定された名前を用いて定義されます。 その内容は .netrc の次の行から始まり、空行 (改行文字の連続) が現れるまで続きます。 init というマクロが定義されているならば、 自動ログイン処理の中での最後の段階で自動的に実行されます。

コマンドラインの編集機能
ftp は editline(3) ライブラリを使った対話的なコマンドラインの編集をサポートします。 これは edit コマンドによって有効になり、そして入力が tty からの場合は デフォルトで有効になっています。 カーソルキーで以前の行を呼び出して編集できます。 そして他にも GNU Emacs スタイルの編集用のキーが使えます。

editline(3) ライブラリは .editrc ファイルで設定できます - より詳しくは editrc(5) を参照して下さい。

ftp には、文脈に依存したコマンドとファイル名の補完 (リモートファイルの補完を含む) 機能を提供するための 追加のキー割り当てが用意されています。 これを使うためには editline(3) の ftp-complete コマンドにキーを割り当てて下さい。 これはデフォルトで TAB キーに割り当てられています。

環境変数
ftp は、以下の環境変数を使用します。

FTP_PASSIVE_MODE
    この変数を ‘NO’ 以外に設定すると、 パッシブモードの FTP をデフォルトで使用します。

FTPSERVER
    gate が有効な時に gate-ftp サーバとして使用するホスト。

FTPSERVERPORT
    gate が有効な時に gate-ftp サーバに接続するのに使うポート。 デフォルトは “ftpgate/tcp” で getservbyname() を呼び出して返って来たポート。

HOME
    定義されていれば .netrc ファイルのデフォルトの置き場所となります。

PAGER
    page でファイルを表示する際に使われます。

SHELL
    デフォルトで起動するシェルを定義します。

ftp_proxy
    FTP URL リクエストを発行する時に使う FTP プロキシの URL (定義されていなければ標準の ftp プロトコルを使います)。

http_proxy
    HTTP URL リクエストを発行する時に使う HTTP プロキシの URL。

関連項目
getservbyname(3), editrc(5), services(5), ftpd(8)

注
pftp(1) と gate-ftp(1) コマンドは ftp にリンクされています。

歴史
ftp コマンドは 4.2BSD から実装されました。

コマンドラインの編集、文脈に依存したコマンドとファイルの補完、 進行状況を表す棒グラフ、ファイルの自動的な取得、 ftp と http 形式の URL、更新時刻の保存といった各種の機能は NetBSD 1.3 で Luke Mewburn によって、Jason Thorpe のアシスタントを得て実装されました。

IPv6 サポートは WIDE/KAME プロジェクトが追加しました。

バグ
多くのコマンドの正しい動作は、リモートサーバの適切な動作に依存します。

4.2BSD の ascii モードでの転送時の復帰文字の取り扱いのエラーは訂正されています。 この訂正の結果として、 4.2BSD のサーバとの間でバイナリファイルを ascii タイプを使用して転送した時に 不正転送をひき起こすことが あります。この問題を回避するためにはバイナリモードを用いて ファイル転送をして下さい。

ftp_proxy 等のプロキシ機能は、IPv6 接続では動作しないかもしれません。