'\" te
.\" To view license terms, attribution, and copyright for OpenSSH, the default path is /var/sadm/pkg/SUNWsshdr/install/copyright.If the Solaris operating environment has been installed anywhere other than the default, modify the specified path to access the file at the installed location.
.\" Portions Copyright (c) 2007, 2012, Oracle and/or its affiliates. All rights reserved.
.TH sftp 1 "2012 年 8 月 7 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
sftp \- セキュリティー保護されたファイル転送プログラム
.SH 形式
.LP
.nf
\fBsftp\fR [\fB-1Cv\fR] [\fB-B\fR \fIbuffer_size\fR] [\fB-b\fR \fIbatchfile\fR] [\fB-F\fR \fIssh_config\fR] 
      [\fB-o\fR \fIssh_option\fR] [\fB-P\fR \fIsftp_server_path\fR] [\fB-R\fR \fInum_requests\fR] 
      [\fB-S\fR \fIprogram\fR] [\fB-s\fR \fIsubsystem\fR | \fIsftp_server\fR] \fIhost\fR
.fi

.LP
.nf
\fBsftp\fR [[\fIuser\fR\fB@\fR]\fIhost\fR[\fB:\fR\fIfile\fR [\fIfile\fR]]]
.fi

.LP
.nf
\fBsftp\fR [[\fIuser\fR\fB@\fR]\fIhost\fR[:\fIdir\fR[\fB/\fR]]]
.fi

.LP
.nf
\fBsftp\fR \fB-b\fR \fIbatchfile\fR [\fIuser\fR\fB@\fR]\fIhost\fR
.fi

.SH 機能説明
.sp
.LP
\fBsftp\fR ユーティリティーは、\fBftp\fR(1) に似たユーザーインタフェースを持つ対話型のファイル転送プログラムであり、\fBssh\fR(1) コマンドを使用してサーバーへのセキュリティー保護された接続を確立します。
.sp
.LP
\fBsftp\fR は、IETF \fBdraft-ietf-secsh-filexfer\fR に定義されている SSH ファイル転送プロトコルを実装します。\fBsftp\fR によって使用されるプロトコルと、\fBftp\fR(1) が提供する FTP プロトコル (\fIRFC 959\fR) は関係はありません。
.sp
.LP
最初の書式では、\fBsftp\fR は指定されたホストに接続し、対話型モードに入ります。ユーザー名を指定した場合、\fBsftp\fR は指定されたユーザーとしてログインしようとします。ディレクトリを指定した場合、\fBsftp\fR はサーバーの現在のディレクトリを指定されたディレクトリに変更してから、対話型モードに入ろうとします。
.sp
.LP
2 番目の書式では、指定されたファイルをサーバーから取り出し、それをクライアント上の指定されたターゲットファイルまたはディレクトリにコピーします。ユーザー名を指定した場合、\fBsftp\fR は指定されたユーザーとしてログインしようとします。
.SH オプション
.sp
.LP
サポートしているオプションは、次のとおりです。
.sp
.ne 2
.mk
.na
\fB\fB-b\fR \fIbatchfile\fR\fR
.ad
.sp .6
.RS 4n
バッチモードでは、一連のコマンドを標準入力ではなく入力 \fIbatchfile\fR から読み取ります。\fB\fRこのモードにはユーザーによる介入がないため、対話型でない認証と組み合わせて使用するようにしてください。\fB-\fR のバッチファイルを使用すると、標準入力を指定できます。\fBget\fR、\fBput\fR、\fBrm\fR、\fBrename\fR、\fBln\fR、\fBrm\fR、\fBmkdir\fR、\fBchdir\fR、\fBls\fR、\fBlchdir\fR、\fBchmod\fR、\fBchown\fR、\fBchgrp\fR、\fBlpwd\fR、および \fBlmkdir\fR コマンドのいずれかでエラーが発生すると、\fBsftp\fR は異常終了します。コマンドに接頭辞として \fB-\fR 文字を付けると (例: \fB-rm /tmp/blah*\fR)、エラー時の終了をコマンドごとに抑制できます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-B\fR \fIbuffer_size\fR\fR
.ad
.sp .6
.RS 4n
\fBsftp\fR がファイルの転送時に使用するバッファーのサイズを指定します。バッファーのサイズを大きくすると、必要な往復回数が少なくなりますが、メモリーが余分に消費されます。デフォルトは 32768 バイトです。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-C\fR\fR
.ad
.sp .6
.RS 4n
圧縮機能を有効にします (\fBssh\fR(1) の \fB-C\fR フラグを使用)。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-F\fR \fIssh_config\fR\fR
.ad
.sp .6
.RS 4n
\fBssh\fR のユーザーごとの構成ファイルに別のファイルを指定します。このオプションは、\fBssh\fR(1) に直接渡されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-o\fR \fIssh_option\fR\fR
.ad
.sp .6
.RS 4n
\fBssh\fR(1) に直接渡されるオプションを指定します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-P\fR \fIsftp_server path\fR\fR
.ad
.sp .6
.RS 4n
指定されたパスを \fIsftp-server\fR として実行し、\fBssh\fR 接続ではなくパイプを使ってそのサーバーと通信します。このオプションは、\fBsftp\fR クライアントおよびサーバーのデバッグに役立つことがあります。\fB-P\fR が指定された場合、\fB-S\fR オプションは無視されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-R\fR \fInum_requests\fR\fR
.ad
.sp .6
.RS 4n
未処理の要求を同時にいくつまで受け付けられるかを指定します。この値を大きくすると、ファイル転送速度がわずかに向上することがありますが、メモリー使用量が増加します。デフォルトは、未処理の要求 64 個です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-s\fR \fIsubsystem\fR | \fIsftp_server\fR\fR
.ad
.sp .6
.RS 4n
\fBSSH2\fR サブシステム、またはリモートホスト上の \fBsftp\fR サーバーのパスを指定します。パスは、プロトコルバージョン 1 を介して \fBsftp\fR を使用する場合や、リモートの \fBsshd\fR に \fBsftp\fR サブシステムが構成されていない場合に便利です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-S\fR \fIssh_program\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
\fBssh\fR(1) ではなく、指定されたプログラムを使用して、\fBsftp\fR サーバーに接続します。\fB-P\fR オプションが指定された場合、\fB-S\fR オプションは無視されます。このプログラムは、\fBssh\fR(1) のオプションを認識する必要があります。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-v\fR\fR
.ad
.sp .6
.RS 4n
ログレベルを上げます。このオプションは \fBssh\fR(1) にも渡されます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-1\fR\fR
.ad
.sp .6
.RS 4n
プロトコルバージョン 1 を使用することを指定します。
.RE

.SH オペランド
.sp
.LP
次のオペランドがサポートされています。
.sp
.ne 2
.mk
.na
\fB\fIhostname\fR | \fIuser@hostname\fR\fR
.ad
.sp .6
.RS 4n
\fBsftp\fR が接続して、ログインするホストの名前。
.RE

.SH 対話型コマンド
.sp
.LP
対話型モードに入ると、\fBsftp\fR は \fBftp\fR(1) に似た一連のコマンドを解釈できます。これらのコマンドは大文字と小文字の区別がなく、スペースが含まれているパス名は引用符で囲むことができます。
.sp
.ne 2
.mk
.na
\fB\fBbye\fR\fR
.ad
.sp .6
.RS 4n
\fBsftp\fR を終了します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBcd\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
リモート側のディレクトリを \fIpath\fR に変更します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBchgrp\fR \fIgrp path\fR\fR
.ad
.sp .6
.RS 4n
ファイル \fIpath\fR のグループを \fIgrp\fR に変更します。\fIgrp\fR には数値の \fBGID\fR を指定する必要があります。
.RE

.sp
.ne 2
.mk
.na
\fB\fBchmod\fR \fImode path\fR\fR
.ad
.sp .6
.RS 4n
ファイル \fIpath\fR のアクセス権を \fImode\fR に変更します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBchown\fR \fIown path\fR\fR
.ad
.sp .6
.RS 4n
ファイル \fIpath\fR の所有者を \fIown\fR に変更します。\fIown\fR には数値の \fBUID\fR を指定する必要があります。
.RE

.sp
.ne 2
.mk
.na
\fB\fBexit\fR\fR
.ad
.sp .6
.RS 4n
\fBsftp\fR を終了します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBget\fR [\fIflags\fR] \fIremote-path\fR [\fIlocal-path\fR]\fR
.ad
.sp .6
.RS 4n
\fIremote-path\fR を取り出し、ローカルマシン上に格納します。ローカルパス名を指定しない場合は、リモートマシン上にあるものと同じ名前になります。\fB-P\fR フラグを指定した場合は、ファイルのアクセス権およびアクセス時間もすべてコピーされます。
.RE

.sp
.ne 2
.mk
.na
\fB\fBhelp\fR\fR
.ad
.sp .6
.RS 4n
ヘルプテキストを表示します。
.sp
\fB?\fR コマンドと同じです。
.RE

.sp
.ne 2
.mk
.na
\fB\fBlcd\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
ローカルディレクトリを \fIpath\fR に変更します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBlls\fR [\fIls-options\fR [\fIpath\fR]]\fR
.ad
.sp .6
.RS 4n
\fIpath\fR のローカルディレクトリの一覧を表示します。\fIpath\fR を指定しない場合は、現在のディレクトリの一覧を表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBlmkdir\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
\fIpath\fR によって指定されたローカルディレクトリを作成します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBln\fR \fIoldpath\fR \fInewpath\fR\fR
.ad
.sp .6
.RS 4n
\fIoldpath\fR から \fInewpath\fR へのリンクを作成します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBlpwd\fR\fR
.ad
.sp .6
.RS 4n
ローカル側の作業用ディレクトリを表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBls\fR [\fB-1aflnrSt\fR] [\fIpath\fR]\fR
.ad
.sp .6
.RS 4n
\fIpath\fR のリモートディレクトリの一覧を表示します。\fIpath\fR を指定しない場合は、現在のディレクトリの一覧を表示します。\fIpath\fR には、ワイルドカードを使用できます。
.sp
\fBls\fR コマンドは、次のオプションをサポートします。
.sp
.ne 2
.mk
.na
\fB\fB-a\fR\fR
.ad
.sp .6
.RS 4n
ドット (\fB\&.\fR) で始まるファイルを一覧表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-f\fR\fR
.ad
.sp .6
.RS 4n
リストをソートしません。デフォルトのソート順序は辞書編集方式の順です。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-l\fR\fR
.ad
.sp .6
.RS 4n
アクセス権や所有権の情報を含む、追加の詳細情報を表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-n\fR\fR
.ad
.sp .6
.RS 4n
ユーザーおよびグループの情報を数値で示した長い形式のリストを生成します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-r\fR\fR
.ad
.sp .6
.RS 4n
リストのソート順序を逆にします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-S\fR\fR
.ad
.sp .6
.RS 4n
ファイルサイズでリストをソートします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-t\fR\fR
.ad
.sp .6
.RS 4n
最終変更時間でリストをソートします。
.RE

.sp
.ne 2
.mk
.na
\fB\fB-1\fR\fR
.ad
.sp .6
.RS 4n
1 カラムの出力を生成します。
.RE

.RE

.sp
.ne 2
.mk
.na
\fB\fBlumask\fR \fIumask\fR\fR
.ad
.sp .6
.RS 4n
ローカル側の \fBumask\fR を \fIumask\fR に設定します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBmkdir\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
\fIpath\fR によって指定されたリモートディレクトリを作成します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBput\fR [\fIflags\fR] \fIlocal-path\fR [\fIlocal-path\fR]\fR
.ad
.sp .6
.RS 4n
\fIlocal-path\fR をアップロードし、リモートマシン上に格納します。リモートパス名を指定しない場合は、ローカルマシン上にあるものと同じ名前になります。\fB-P\fR フラグを指定した場合は、ファイルのアクセス権およびアクセス時間もすべてコピーされます。
.RE

.sp
.ne 2
.mk
.na
\fB\fBpwd\fR\fR
.ad
.sp .6
.RS 4n
リモート側の作業用ディレクトリを表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBquit\fR\fR
.ad
.sp .6
.RS 4n
\fBsftp\fR を終了します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBrename\fR \fIoldpath newpath\fR\fR
.ad
.sp .6
.RS 4n
リモートファイルの名前を \fIoldpath\fR から \fInewpath\fR に変更します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBrm\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
\fIpath\fR によって指定されたリモートファイルを削除します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBrmdir\fR \fIpath\fR\fR
.ad
.sp .6
.RS 4n
\fIpath\fR によって指定されたリモートディレクトリを削除します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBsymlink\fR \fIoldpath\fR \fInewpath\fR\fR
.ad
.sp .6
.RS 4n
\fIoldpath\fR から \fInewpath\fR へのシンボリックリンクを作成します。
.RE

.sp
.ne 2
.mk
.na
\fB\fBversion\fR\fR
.ad
.sp .6
.RS 4n
\fBsftp\fR のプロトコルバージョンを表示します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB#\fR [\fIcomment\fR]\fR
.ad
.sp .6
.RS 4n
コメントを組み込みます。これはバッチファイルに役立ちます。
.RE

.sp
.ne 2
.mk
.na
\fB\fB!\fR [\fIcommand\fR]\fR
.ad
.sp .6
.RS 4n
\fIcommand\fR を指定しない場合は、ローカル側のシェルにエスケープします。 
.sp
\fIcommand\fR を指定した場合は、ローカル側のシェルで \fIcommand\fR を実行します。
.RE

.sp
.ne 2
.mk
.na
\fB\fB?\fR\fR
.ad
.sp .6
.RS 4n
ヘルプテキストを表示します。
.sp
\fBhelp\fR コマンドと同じです。
.RE

.SH 終了ステータス
.sp
.LP
次の終了ステータスが返されます。
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.sp .6
.RS 4n
正常終了。
.RE

.sp
.ne 2
.mk
.na
\fB>\fB0\fR\fR
.ad
.sp .6
.RS 4n
エラーが発生した。
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件network/ssh
_
インタフェースの安定性確実
.TE

.SH 関連項目
.sp
.LP
\fBftp\fR(1), \fBscp\fR(1), \fBssh\fR(1), \fBssh-add\fR(1), \fBssh-keygen\fR(1), \fBsshd\fR(1M), \fBattributes\fR(5)