version 1.36.2.1, 2003/04/01 00:12:14 |
version 1.36.2.2, 2003/04/03 23:27:12 |
|
|
.Nd Secure file transfer program |
.Nd Secure file transfer program |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm sftp |
.Nm sftp |
|
.Bk -words |
.Op Fl vC1 |
.Op Fl vC1 |
.Op Fl b Ar batchfile |
.Op Fl b Ar batchfile |
.Op Fl o Ar ssh_option |
.Op Fl o Ar ssh_option |
|
|
.Op Fl R Ar num_requests |
.Op Fl R Ar num_requests |
.Op Fl S Ar program |
.Op Fl S Ar program |
.Ar host |
.Ar host |
|
.Ek |
.Nm sftp |
.Nm sftp |
.Op [\fIuser\fR@]\fIhost\fR[:\fIfile\fR [\fIfile\fR]] |
.Oo Oo Ar user Ns No @ Oc Ns |
|
.Ar host Ns Oo : Ns Ar file Oo |
|
.Ar file Oc Oc Oc |
.Nm sftp |
.Nm sftp |
.Op [\fIuser\fR@]\fIhost\fR[:\fIdir\fR[\fI/\fR]] |
.Oo Oo Ar user Ns No @ Oc Ns |
|
.Ar host Ns Oo : Ns Ar dir Ns |
|
.Oo Ar / Oc Oc Oc |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
is an interactive file transfer program, similar to |
is an interactive file transfer program, similar to |
|
|
will abort if any of the following |
will abort if any of the following |
commands fail: |
commands fail: |
.Ic get , put , rename , ln , |
.Ic get , put , rename , ln , |
.Ic rm , mkdir , chdir , ls , |
.Ic rm , mkdir , chdir , ls , |
.Ic lchdir , chmod , chown , chgrp , lpwd |
.Ic lchdir , chmod , chown , chgrp , lpwd |
and |
and |
.Ic lmkdir . |
.Ic lmkdir . |
Termination on error can be suppressed on a command by command basis by |
Termination on error can be suppressed on a command by command basis by |
prefixing the command with a |
prefixing the command with a |
.Ic '-' |
.Ic '-' |
character (For example, |
character (For example, |
.Ic -rm /tmp/blah* |
.Ic -rm /tmp/blah* |
). |
). |
|
|
This is useful for specifying options |
This is useful for specifying options |
for which there is no separate |
for which there is no separate |
.Nm sftp |
.Nm sftp |
command-line flag. For example, to specify an alternate |
command-line flag. For example, to specify an alternate |
port use: |
port use: |
.Ic sftp -oPort=24 . |
.Ic sftp -oPort=24 . |
.It Fl s Ar subsystem | sftp_server |
.It Fl s Ar subsystem | sftp_server |
Specifies the SSH2 subsystem or the path for an sftp server |
Specifies the SSH2 subsystem or the path for an sftp server |
on the remote host. A path is useful for using sftp over |
on the remote host. A path is useful for using sftp over |
protocol version 1, or when the remote |
protocol version 1, or when the remote |
.Nm sshd |
.Nm sshd |
does not have an sftp subsystem configured. |
does not have an sftp subsystem configured. |
.It Fl v |
.It Fl v |
Raise logging level. This option is also passed to ssh. |
Raise logging level. This option is also passed to ssh. |
.It Fl B Ar buffer_size |
.It Fl B Ar buffer_size |
Specify the size of the buffer that |
Specify the size of the buffer that |
.Nm |
.Nm |
uses when transferring files. Larger buffers require fewer round trips at |
uses when transferring files. Larger buffers require fewer round trips at |
the cost of higher memory consumption. The default is 32768 bytes. |
the cost of higher memory consumption. The default is 32768 bytes. |