version 1.33.2.2, 2002/10/11 14:51:52 |
version 1.33.2.3, 2003/04/03 22:35:17 |
|
|
.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 , lchdir |
.Ic rm , mkdir , chdir , ls , |
|
.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 |
|
prefixing the command with a |
|
.Ic '-' |
|
character (For example, |
|
.Ic -rm /tmp/blah* |
|
). |
.It Fl o Ar ssh_option |
.It Fl o Ar ssh_option |
Can be used to pass options to |
Can be used to pass options to |
.Nm ssh |
.Nm ssh |
|
|
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. |
|
|
.It Ic mkdir Ar path |
.It Ic mkdir Ar path |
Create remote directory specified by |
Create remote directory specified by |
.Ar path . |
.Ar path . |
|
.It Ic progress |
|
Toggle display of progress meter. |
.It Xo Ic put |
.It Xo Ic put |
.Op Ar flags |
.Op Ar flags |
.Ar local-path |
.Ar local-path |
.Op Ar local-path |
.Op Ar remote-path |
.Xc |
.Xc |
Upload |
Upload |
.Ar local-path |
.Ar local-path |
|
|
.Ar oldpath |
.Ar oldpath |
to |
to |
.Ar newpath . |
.Ar newpath . |
|
.It Ic version |
|
Display the |
|
.Nm |
|
protocol version. |
.It Ic ! Ar command |
.It Ic ! Ar command |
Execute |
Execute |
.Ar command |
.Ar command |