version 1.33.2.3, 2003/04/03 22:35:17 |
version 1.34, 2002/06/19 00:27:55 |
|
|
.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 |
.Oo Oo Ar user Ns No @ Oc Ns |
.Op [\fIuser\fR@]\fIhost\fR[:\fIfile\fR [\fIfile\fR]] |
.Ar host Ns Oo : Ns Ar file Oo |
|
.Ar file Oc Oc Oc |
|
.Nm sftp |
.Nm sftp |
.Oo Oo Ar user Ns No @ Oc Ns |
.Op [\fIuser\fR@]\fIhost\fR[:\fIdir\fR[\fI/\fR]] |
.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 , lchdir |
.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 |
in the format used in |
in the format used in the |
.Xr ssh_config 5 . |
.Xr ssh 1 |
This is useful for specifying options |
configuration file. 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. |
|
|
.Ar newpath . |
.Ar newpath . |
.It Ic lpwd |
.It Ic lpwd |
Print local working directory. |
Print local working directory. |
.It Xo Ic ls |
.It Ic ls Op Ar path |
.Op Ar flags |
|
.Op Ar path |
|
.Xc |
|
Display remote directory listing of either |
Display remote directory listing of either |
.Ar path |
.Ar path |
or current directory if |
or current directory if |
.Ar path |
.Ar path |
is not specified. If the |
is not specified. |
.Fl l |
|
flag is specified, then display additional details including permissions |
|
and ownership information. |
|
.It Ic lumask Ar umask |
.It Ic lumask Ar umask |
Set local umask to |
Set local umask to |
.Ar umask . |
.Ar umask . |
.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 remote-path |
.Op Ar local-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 |
|
|
.Xr ssh 1 , |
.Xr ssh 1 , |
.Xr ssh-add 1 , |
.Xr ssh-add 1 , |
.Xr ssh-keygen 1 , |
.Xr ssh-keygen 1 , |
.Xr ssh_config 5 , |
|
.Xr sftp-server 8 , |
.Xr sftp-server 8 , |
.Xr sshd 8 |
.Xr sshd 8 |
.Rs |
.Rs |