version 1.7.2.6, 2002/03/08 17:04:43 |
version 1.8, 2001/02/17 15:24:40 |
|
|
.\" $OpenBSD$ |
.\" $OpenBSD$ |
.\" |
.\" |
.\" Copyright (c) 2001 Damien Miller. All rights reserved. |
.\" Copyright (c) 2001 Damien Miller. All rights reserved. |
.\" |
.\" |
.\" Redistribution and use in source and binary forms, with or without |
.\" Redistribution and use in source and binary forms, with or without |
.\" modification, are permitted provided that the following conditions |
.\" modification, are permitted provided that the following conditions |
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
.\" |
.\" |
.Dd February 4, 2001 |
.Dd Febuary 4, 2001 |
.Dt SFTP 1 |
.Dt SFTP 1 |
.Os |
.Os |
.Sh NAME |
.Sh NAME |
|
|
.Nd Secure file transfer program |
.Nd Secure file transfer program |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm sftp |
.Nm sftp |
.Op Fl vC1 |
.Op Fl vC |
.Op Fl b Ar batchfile |
|
.Op Fl o Ar ssh_option |
.Op Fl o Ar ssh_option |
.Op Fl s Ar subsystem | sftp_server |
.Op Ar hostname | user@hostname |
.Op Fl B Ar buffer_size |
|
.Op Fl F Ar ssh_config |
|
.Op Fl P Ar sftp_server path |
|
.Op Fl R Ar num_requests |
|
.Op Fl S Ar program |
|
.Ar host |
|
.Nm sftp |
|
.Op [\fIuser\fR@]\fIhost\fR[:\fIfile\fR [\fIfile\fR]] |
|
.Nm sftp |
|
.Op [\fIuser\fR@]\fIhost\fR[:\fIdir\fR[\fI/\fR]] |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
is an interactive file transfer program, similar to |
is an interactive file transfer program, similar to |
|
|
compression. |
compression. |
.Nm |
.Nm |
connects and logs into the specified |
connects and logs into the specified |
.Ar host , |
.Ar hostname , |
then enters an interactive command mode. |
then enters an interactive command mode. |
.Pp |
.Pp |
The second usage format will retrieve files automatically if a non-interactive |
|
authentication method is used; otherwise it will do so after |
|
successful interactive authentication. |
|
.Pp |
|
The last usage format allows the sftp client to start in a remote directory. |
|
.Pp |
|
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl b Ar batchfile |
|
Batch mode reads a series of commands from an input |
|
.Ar batchfile |
|
instead of |
|
.Em stdin . |
|
Since it lacks user interaction it should be used in conjunction with |
|
non-interactive authentication. |
|
.Nm |
|
will abort if any of the following |
|
commands fail: |
|
.Ic get , put , rename , ln , |
|
.Ic rm , mkdir , chdir , lchdir |
|
and |
|
.Ic lmkdir . |
|
.It Fl o Ar ssh_option |
|
Can be used to pass options to |
|
.Nm ssh |
|
in the format used in the |
|
.Xr ssh 1 |
|
configuration file. This is useful for specifying options |
|
for which there is no separate |
|
.Nm sftp |
|
command-line flag. For example, to specify an alternate |
|
port use: |
|
.Ic sftp -oPort=24 . |
|
.It Fl s Ar subsystem | 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 |
|
protocol version 1, or when the remote |
|
.Nm sshd |
|
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 |
|
Specify the size of the buffer that |
|
.Nm |
|
uses when transferring files. Larger buffers require fewer round trips at |
|
the cost of higher memory consumption. The default is 32768 bytes. |
|
.It Fl C |
.It Fl C |
Enables compression (via ssh's |
Enables compression (via ssh's |
.Fl C |
.Fl C |
flag). |
flag) |
.It Fl F Ar ssh_config |
.It Fl o Ar ssh_option |
Specifies an alternative |
Specify an option to be directly passed to |
per-user configuration file for |
|
.Nm ssh . |
|
This option is directly passed to |
|
.Xr ssh 1 . |
.Xr ssh 1 . |
.It Fl P Ar sftp_server path |
|
Connect directly to a local |
|
.Nm sftp-server |
|
(rather than via |
|
.Nm ssh ) |
|
This option may be useful in debugging the client and server. |
|
.It Fl R Ar num_requests |
|
Specify how many requests may be outstanding at any one time. Increasing |
|
this may slightly improve file transfer speed but will increase memory |
|
usage. The default is 16 outstanding requests. |
|
.It Fl S Ar program |
|
Name of the |
|
.Ar program |
|
to use for the encrypted connection. |
|
The program must understand |
|
.Xr ssh 1 |
|
options. |
|
.It Fl 1 |
|
Specify the use of protocol version 1. |
|
.El |
.El |
.Sh INTERACTIVE COMMANDS |
.Sh INTERACTIVE COMMANDS |
Once in interactive mode, |
Once in interactive mode, |
.Nm |
.Nm |
understands a set of commands similar to those of |
understands a set of commands similar to those of |
.Xr ftp 1 . |
.Xr ftp 1 . |
Commands are case insensitive and pathnames may be enclosed in quotes if they |
Commands are case insensitive and pathnames may be enclosed in quotes if they |
contain spaces. |
contain spaces. |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Ic bye |
|
Quit sftp. |
|
.It Ic cd Ar path |
.It Ic cd Ar path |
Change remote directory to |
Change remote directory to |
.Ar path . |
.Ar path . |
.It Ic lcd Ar path |
.It Ic lcd Ar path |
Change local directory to |
Change local directory to |
.Ar path . |
.Ar path . |
.It Ic chgrp Ar grp Ar path |
.It Ic chgrp Ar grp Ar path |
Change group of file |
Change group of file |
.Ar path |
.Ar path |
to |
to |
.Ar grp . |
.Ar grp . |
.Ar grp |
.Ar grp |
must be a numeric GID. |
must be a numeric GID. |
.It Ic chmod Ar mode Ar path |
.It Ic chmod Ar mode Ar path |
Change permissions of file |
Change permissions of file |
.Ar path |
.Ar path |
to |
to |
.Ar mode . |
.Ar mode . |
.It Ic chown Ar own Ar path |
.It Ic chown Ar own Ar path |
Change owner of file |
Change owner of file |
.Ar path |
.Ar path |
to |
to |
.Ar own . |
.Ar own . |
.Ar own |
.Ar own |
must be a numeric UID. |
must be a numeric UID. |
.It Ic exit |
.It Ic help |
Quit sftp. |
Display help text. |
.It Xo Ic get |
.It Xo Ic get |
.Op Ar flags |
.Op Ar flags |
.Ar remote-path |
.Ar remote-path |
|
|
.Ar remote-path |
.Ar remote-path |
and store it on the local machine. |
and store it on the local machine. |
If the local |
If the local |
path name is not specified, it is given the same name it has on the |
path name is not specified, it is given the same name it has on the |
remote machine. If the |
remote machine. If the |
.Fl P |
.Fl P |
flag is specified, then the file's full permission and access time are |
flag is specified, then the file's full permission and access time are |
copied too. |
copied too. |
.It Ic help |
|
Display help text. |
|
.It Ic lls Op Ar ls-options Op Ar path |
.It Ic lls Op Ar ls-options Op Ar path |
Display local directory listing of either |
Display local directory listing of either |
.Ar path |
.Ar path |
or current directory if |
or current directory if |
.Ar path |
.Ar path |
|
|
.It Ic lmkdir Ar path |
.It Ic lmkdir Ar path |
Create local directory specified by |
Create local directory specified by |
.Ar path . |
.Ar path . |
.It Ic ln Ar oldpath Ar newpath |
|
Create a symbolic link from |
|
.Ar oldpath |
|
to |
|
.Ar newpath . |
|
.It Ic lpwd |
.It Ic lpwd |
Print local working directory. |
Print local working directory. |
.It Ic ls Op Ar path |
.It Ic ls Op Ar path |
|
|
.Ar path |
.Ar path |
is not specified. |
is not specified. |
.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 |
|
|
.Xc |
.Xc |
Upload |
Upload |
.Ar local-path |
.Ar local-path |
and store it on the remote machine. If the remote path name is not |
and store it on the remote machine. If the remote path name is not specified, |
specified, it is given the same name it has on the local machine. If the |
it is given the same name it has on the local machine. If the |
.Fl P |
.Fl P |
flag is specified, then the file's full permission and access time are |
flag is specified, then the file's full permission and access time are |
copied too. |
copied too. |
.It Ic pwd |
.It Ic pwd |
Display remote working directory. |
Display remote working directory. |
|
.It Ic exit |
|
Quit sftp. |
.It Ic quit |
.It Ic quit |
Quit sftp. |
Quit sftp. |
.It Ic rename Ar oldpath Ar newpath |
.It Ic rename Ar oldpath Ar newpath |
|
|
.It Ic rm Ar path |
.It Ic rm Ar path |
Delete remote file specified by |
Delete remote file specified by |
.Ar path . |
.Ar path . |
.It Ic symlink Ar oldpath Ar newpath |
|
Create a symbolic link from |
|
.Ar oldpath |
|
to |
|
.Ar newpath . |
|
.It Ic ! Ar command |
.It Ic ! Ar command |
Execute |
Execute |
.Ar command |
.Ar command |
in local shell. |
in local shell. |
.It Ic ! |
.It Ic ! |
|
|
.Sh AUTHORS |
.Sh AUTHORS |
Damien Miller <djm@mindrot.org> |
Damien Miller <djm@mindrot.org> |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr scp 1 , |
|
.Xr ssh 1 , |
.Xr ssh 1 , |
.Xr ssh-add 1 , |
.Xr ssh-add 1 , |
.Xr ssh-keygen 1 , |
.Xr ssh-keygen 1 , |
.Xr sftp-server 8 , |
.Xr sshd 8 , |
.Xr sshd 8 |
.Xr scp 1 |
.Rs |
|
.%A T. Ylonen |
|
.%A S. Lehtinen |
|
.%T "SSH File Transfer Protocol" |
|
.%N draft-ietf-secsh-filexfer-00.txt |
|
.%D January 2001 |
|
.%O work in progress material |
|
.Re |
|