ファイル転送後に転送元ファイルを削除します。

サーバでストリーミングがサポートされている場合、ファイル転送にストリーミングを使用します。buffer_size_bytes よりもサイズが小さいファイルについては、ストリーミングを使用した転送を行いません。サイズの小さいファイルに対しては force を使用してください。デフォルトは no です。

z/OS ホストで MVS データセットへの直接アクセスを有効にするには、ext を使用します。他の環境ではサイズの小さいファイルの転送が低速になる可能性があるため、このオプションは、ファイル転送が主としてメインフレームのデータセット転送に使用されるときにのみ使用してください。

チェックサムが計算される場合、ファイル転送ではステージングが使用され、ストリーミングは使用されないため、--streaming=ext オプションを指定する場合は --checksum=no オプションも指定する必要があります。

拡張ストリーミングを有効にする別の方法は、環境変数として SSH_SFTP_STREAMING_MODE=ext および SSH_SFTP_CHECKSUM_MODE=no を定義することです。

転送先ファイル名を小文字に変換します。

現在の改行規則のみを表示します。転送モードをアスキーに設定しません。

リモートおよびローカルの改行規則のヒントを設定します。local_nl_conv オプションはローカル側で機能しますが、通常は正しいローカル改行規則がすでにコンパイルされています。

これらのオプションは下位の転送レイヤに対するヒントにすぎません。このレイヤは、可能であれば常に、サーバによって指定された実際の改行規則の使用を試みます。これらのオプションのいずれかを ask に設定できます。この設定では、sftpg3 は必要なときに新しい改行規則をユーザに問い合わせます。利用可能な規則は dos、unix、および mac で、それぞれ \r\n、\n、および \r を改行として使用します。

このコマンドは転送モードをアスキーに設定しません。

ファイルおよびディレクトリを再帰的に変更します。

サイレント モードを使用します (エラー メッセージを表示しません)。

詳細モードを使用します (処理されたすべてのファイルを一覧表示します)。

md5 または sha1 ハッシュ アルゴリズムを使用します (デフォルトは md5)。

OFFSET で指定されたファイル オフセットから読み取りを開始します。

LENGTH バイトのファイル データを読み取ります。

sftpg3 クライアントは、現在のディレクトリとそのすべてのサブディレクトリのファイルを再帰的に転送します。

get コマンドは sget として実行されます。この場合、このコマンドは単一のファイルを転送し、サブディレクトリはコピーされません。

指定したディレクトリから通常ファイルとシンボリック リンクのみがコピーされ、サブディレクトリはコピーされません。それ以外に get コマンドの動作に変更はありません。

転送元と転送先の両方が UNIX ファイルシステム (z/OS USS を含む) の場合に、ファイルの許可属性とタイムスタンプを保持します。転送元と転送先のいずれかが Windows の場合、タイムスタンプは保持しますが許可属性は保持しません。転送先が z/OS MVS の場合は、どちらも保持しません。

ファイル転送後に転送元ファイルを削除します。ディレクトリが空になった場合、ディレクトリも削除されます (移動モード)。

既存の転送先ファイルを上書きするかどうかをユーザに確認します (バッチ モードでは使用できません)。

既存の転送先ファイルを上書きするかどうかを決定します (デフォルトは yes)。

ファイル転送を再開できるファイル内のポイントを特定するために、MD5 または SHA-1 チェックサム、あるいは独立したチェックポイント データベースを使用します。buffer_size_bytes よりもサイズが小さいファイルはチェックされません。サイズの小さいファイルに対しては md5-force または sha1-force を使用します (デフォルトは yes で、MD5 チェックサムを使用します)。チェックポイント設定は、サイズの大きなファイルを 1 つずつ転送するときに使用します。

インクリメンタル チェックを試行しません。デフォルトでは (このオプションを指定しない場合)、インクリメンタル チェックが試行されます。このオプションは --checksum オプションとの組み合わせでのみ使用できます。

チェックポイント更新が発生するまでの時間間隔 (デフォルトは 10 秒)。このオプションは --checksum=checkpoint のときにのみ使用できます。

チェックポイント更新が発生するまでのバイト間隔 (デフォルトは 10 MB)。このオプションは --checksum=checkpoint のときにのみ使用できます。

サーバでストリーミングがサポートされている場合、ファイル転送にストリーミングを使用します。buffer_size_bytes よりもサイズが小さいファイルについては、ストリーミングを使用した転送を行いません。サイズの小さいファイルに対しては force を使用してください。デフォルトは yes です。

z/OS ホストで MVS データセットへの直接アクセスを有効にするには、ext を使用します。他の環境ではサイズの小さいファイルの転送が低速になる可能性があるため、このオプションは、ファイル転送が主としてメインフレームのデータセット転送に使用されるときにのみ使用してください。

チェックサムが計算される場合、ファイル転送ではステージングが使用され、ストリーミングは使用されないため、--streaming=ext オプションを指定する場合は --checksum=no オプションも指定する必要があります。

拡張ストリーミングを有効にする別の方法は、環境変数として SSH_SFTP_STREAMING_MODE=ext および SSH_SFTP_CHECKSUM_MODE=no を定義することです。

転送先ファイル名を小文字に変換します。

ディレクトリを再帰的にコピーするかどうかを定義します。以下の値を指定できます。

0 - 無制限の再帰。ディレクトリとその内容は再帰的にコピーされます。

1 - 指定したディレクトリだけからファイルをコピーし、サブディレクトリからはコピーしません。

2 ～ n - 指定した階層数のディレクトリからファイルを再帰的にコピーします。n はシステム固有の最大値を意味します。

このコマンドライン オプションは、Connection Broker 構成の sftpg3-mode エレメントで設定された再帰の深さや、環境変数 SSH_SFTP_CMD_GETPUT_MODE を使用して行われた設定よりも優先します。

ファイル転送の間に、PREFIX で指定された接頭辞をファイル名に付加します。ファイルが正常に転送された後で接頭辞は削除されます。

ファイル転送操作の後で表示する統計の形式を選択します。各オプションの意味は以下の通りです。

no - 統計を作成しません。これはデフォルトの設定です。

yes - 詳細な統計を作成します。statistics-format オプションで内容を設定できます。デフォルトの統計内容は以下の通りです。

"Source: %c:%g\r\n"
"Source parameters: %e\r\n"
"Destination: %C:%G\r\n"
"Destination parameters: %E\r\n"
"File size: %s bytes\r\n"
"Transferred: %t bytes\r\n"
"Rate: %RB/s\r\n"
"Start: %xy-%xt-%xd %xh:%xm:%xs\r\n"
"Stop: %Xy-%Xt-%Xd %Xh:%Xm:%Xs\r\n"
"Time: %y\r\n"

simple - 簡潔な 1 行の統計を作成します。statistics-format オプションで内容を設定できます。デフォルトの統計内容は以下の通りです。

"Transferred %t bytes, file: '%f' -> '%F'\r\n"

bytes - 転送済みバイト数を報告する基本的な統計を作成します。statistics-format オプションで内容を設定できます。デフォルトの統計内容は以下の通りです。

"Transferred %t bytes, file: '%f' -> '%F'\r\n"

統計の形式と内容を選択します。このオプションは --statistics=yes|simple|bytes のときに使用します。以下の定義を使用して、統計の内容を選択します。

%c  - source connection: user@host#port or profile
%g  - /path/to/source/file
%f  - source file name
%e  - source parameters (file transfer and dataset parameters)
%C  - destination connection: user@host#port or profile
%G  - /path/to/destination/file
%F  - destination file name
%E  - destination parameters (file transfer and dataset parameters)
%s  - file size in bytes
%S  - file size as "XXyB" (B, kiB, MiB or GiB)
%t  - transfer size in bytes
%T  - transfer size as "XXyB" (B, kiB, MiB or GiB)
%p  - transfer percentage
%q  - transfer rate in bit/s
%Q  - transfer rate as "XXyb/s" (b/s, kib/s, Mib/s, Gib/s)
%r  - transfer rate in bytes/s
%R  - transfer rate as "XXyB/s" (B/s, kiB/s, MiB/s, GiB/s)
%D* - current date
%x* - start date
%X* - end date
%y  - elapsed time
%Y  - time remaining
%z  - ETA or TOC, if transfer has finished
%Z  - string "ETA" or "TOC", if transfer has finished

Where * is one of the following:

h - hours (00-23)
m - minutes (00-59)
s - seconds (00-59)
f - milliseconds (0-999)
d - day of the month (1-31)
t - month (1-12)
y - year (1970-)

Other special characters in format strings are:

\n - line feed
\r - carriage return
\t - horizontal tab
\\ - backslash

ファイル転送操作中に進行状況を表示する際のモードを選択します。デフォルトは bar で、進行状況バーを表示します。オプション line は、--progress-line-format オプションで行われた設定に従って進行状況の情報を表示します。

進行状況の行に表示する情報を選択します。このオプションは --progress-display=line のときに使用します。以下の定義を使用して、進行状況の行の内容を選択します。

%c  - source connection: user@host#port or profile
%g  - /path/to/source/file
%f  - source file name
%e  - source parameters (file transfer and dataset parameters)
%C  - destination connection: user@host#port or profile
%G  - /path/to/destination/file
%F  - destination file name
%E  - destination parameters (file transfer and dataset parameters)
%s  - file size in bytes
%S  - file size as "XXyB" (B, kiB, MiB or GiB)
%t  - transfer size in bytes
%T  - transfer size as "XXyB" (B, kiB, MiB or GiB)
%p  - transfer percentage
%q  - transfer rate in bit/s
%Q  - transfer rate as "XXyb/s" (b/s, kib/s, Mib/s, Gib/s)
%r  - transfer rate in bytes/s
%R  - transfer rate as "XXyB/s" (B/s, kiB/s, MiB/s, GiB/s)
%D* - current date
%x* - start date
%X* - end date
%y  - elapsed time
%Y  - time remaining
%z  - ETA or TOC, if transfer has finished
%Z  - string "ETA" or "TOC", if transfer has finished

Where * is one of the following:

h - hours (00-23)
m - minutes (00-59)
s - seconds (00-59)
f - milliseconds (0-999)
d - day of the month (1-31)
t - month (1-12)
y - year (1970-)

Other special characters in format strings are:

\n - line feed
\r - carriage return
\t - horizontal tab
\\ - backslash

行モードで進行状況の情報を更新する頻度を定義します。間隔は秒単位で指定します。デフォルトは 60 秒です。

ローカル側をローカル ファイルシステムに接続します (サーバを必要としません)。

ディレクトリ ツリーを再帰的に一覧表示します。デフォルトでは、引数で指定されたディレクトリのサブディレクトリにはアクセスしません。

許可属性、所有者、サイズ、および変更日時も表示します (詳細形式)。

ファイル サイズに基づいて並べ替えを行います (デフォルトはアルファベット順の並べ替え)。

並べ替え順を逆にします。

一度に 1 ページ分のリストだけを表示します。

クライアントは詳細形式の出力を生成します (オプション -l のエイリアス)。

利用可能な場合は、サーバによって提供される詳細形式の出力が使用されます。

リモート側をローカル ファイルシステムに接続します (サーバを必要としません)。

ファイルまたはディレクトリを削除するかどうかをユーザに確認します (バッチ モードでは機能しません)。

ディレクトリは再帰的に削除されます。

パラメータをシステムのデフォルトに設定します。

ファイル転送を再開できるファイル内のポイントを特定するために、MD5 または SHA-1 チェックサム、あるいは独立したチェックポイント データベースを使用します。buffer_size_bytes よりもサイズが小さいファイルはチェックされません。サイズの小さいファイルに対しては md5-force または sha1-force を使用します (デフォルトは yes で、MD5 チェックサムを使用します)。チェックポイント設定は、サイズの大きなファイルを 1 つずつ転送するときに使用します。

ファイル転送で使用する再帰モードを定義します。

既存の転送先ファイルを上書きするかどうかを決定します (デフォルトは yes)。

ファイル転送操作中に進行状況を表示する際のモードを選択します。デフォルトは bar で、進行状況バーを表示します。オプション line は、progress-line-format オプションで行われた設定に従って進行状況の情報を表示します。

進行状況の行に表示する情報を選択します。このオプションは --progress-display=line のときに使用します。コマンド get --progress-line-format の内容オプションの定義を参照してください。

行モードで進行状況情報を更新する頻度を定義します。間隔は秒単位で指定します。デフォルトは 60 秒です。

ファイル転送操作の後で表示する統計の形式を選択します (デフォルトは no)。コマンド get --statistics のオプションの説明を参照してください。

統計の形式と内容を選択します。このコマンドは statistics-display=yes|simple|bytes のときに使用します。コマンド get --statistics-format の内容オプションの定義を参照してください。

サーバでストリーミングがサポートされている場合、ファイル転送にストリーミングを使用します。buffer_size_bytes よりもサイズが小さいファイルについては、ストリーミングを使用した転送を行いません。サイズの小さいファイルに対しては force を使用してください。デフォルトは no です。

z/OS ホストで MVS データセットへの直接アクセスを有効にするには、ext を使用します。他の環境ではサイズの小さいファイルの転送が低速になる可能性があるため、このオプションは、ファイル転送が主としてメインフレームのデータセット転送に使用されるときにのみ使用してください。

チェックサムが計算される場合、ファイル転送ではステージングが使用され、ストリーミングは使用されないため、streaming=ext オプションを指定する場合は checksum=no オプションも指定する必要があります。

拡張ストリーミングを有効にする別の方法は、環境変数として SSH_SFTP_STREAMING_MODE=ext および SSH_SFTP_CHECKSUM_MODE=no を定義することです。