SFTP2(1) SSH2 SFTP2(1)
NAME
sftp2 - secure ftp client
SYNOPSIS
sftp2 [-D debug_level_spec] [-b batchfile] [-S path] [-h]
[-V] host
DESCRIPTION
Sftp (Secure File Transfer) is a ftp-like client that can
be used in file transfer over the network. Sftp uses ssh2
in data connections, so the file transport is secure. Even
though sftp functions like ftp , it does not use the FTP
daemon ( ftpd or wu-ftpd ) for connections.
In order to connect using sftp , you need to make sure
that sshd2 is running on the remote machine you're con
necting to. Sftp uses a "sub-system" from sshd2 to trans
fer files securely.
OPTIONS
-D debug_level_spec
Debug mode. Makes sftp send verbose debug output
to stderr. The debugging level is either a number
(0-99), or a comma-separated list of assignments
ModulePattern=debug_level. ModulePattern is Sftp2
for the main sftp2 application.
-b batchfile
Batch mode. Reads commands from a file instead of
standard input. Passwords and other user interac
tion with ssh2 is still done with the standard
input/output. In batchmode, a failure to change the
current working directory will cause the sftp2 to
abort. Other errors are ignored.
-S path
Specifies the path to the ssh2 binary.
-h Prints the usage and exits.
-V Prints the version and exits.
host Specify the host to connect to.
COMMANDS
When the sftp2 is ready to accept commands, it will dis
play a prompt: 'sftp> '. The user can then enter any of
the following commands.
open hostname
Tries to connect to a host specified in hostname.
localopen
Opens a local connection (the connection is created
without connecting to an sshd2 daemon). This is
mostly useful for debugging and testing.
close Closes the current session.
quit Quits from the application.
cd directory
Changes the current remote working directory.
lcd directory
Changes the current local working directory.
pwd Prints the name of the current remote working
directory.
lpwd Prints the name of the current local working direc
tory.
ls [ -R ] [ -l ] [ file ... ]
Lists the names of the files on the remote server.
For directories, the contents of the directory are
listed. When the -R option is specified, the direc
tory trees are listed recursively. (By default,
the subdirectories of the argument directories are
not visited.) When the -l option is specified, per
missions, owners, sizes and modification times are
also shown. When no arguments are given, it is
assumed that the contents of . are being listed.
Currently the options -R and -l are mutually incom
patible.
lls [ -R ] [ -l ] [ file ... ]
Same as ls, but operates on the local files.
get [ file ... ]
Transfers the specified files from the remote end
to the local end. Directories are recursively
copied with their contents.
mget [ file ... ]
Synonymous to get.
put [ file ... ]
Transfers the specified files from the local end to
the remote end. Directories are recursively copied
with their contents.
mput [ file ... ]
Synonymous to put.
rm file
Tries to delete the file specified in file.
lrm file
Same as rm, but operates on local files.
mkdir directory
Tries to create the directory specified in direc
tory.
lmkdir directory
Same as mkdir, but operates on local files.
rmdir directory
Tries to delete the directory specified in direc
tory.
lrmdir directory
Same as rmdir, but operates on local files.
help [ topic ]
If topic is not given, lists the available topics.
If topic is given, outputs the available online
help about the topic.
COMMAND INTERPRETATION
sftp2 understands both backslashes and quotation marks on
the command line. Backslashes can be used for ignoring
the special meaning of spaces, quotation marks and back
slashes themselves. Quotation marks can be used for speci
fying filenames with spaces.
GLOB PATTERNS
sftp2 supports glob patterns (wildcards) given to commands
ls, lls, get, and put. The format is described in the man
page sshregex(1).
COMMAND LINE EDITING
The following key sequences can be used for command line
editing:
Ctrl-Space
Set the mark.
Ctrl-A Go to the beginning of the line.
Ctrl-B Move the cursor one character left.
Ctrl-D Erase the character on the right of the cursor, or
exit the program if the command line is empty.
Ctrl-E Go to the end of the line.
Ctrl-F Move the cursor one character right.
Ctrl-H Same as Backspace.
Ctrl-I Same as Tab.
Ctrl-J Same as Enter.
Ctrl-K Delete to the end of the line.
Ctrl-L Redraw the line.
Ctrl-M Same as Enter.
Ctrl-N Move to the next line.
Ctrl-P Move to the previous line.
Ctrl-T Toggle two characters.
Ctrl-U Deletes the line.
Ctrl-W Deletes a region (the region's other end is marked
with Ctrl-Space).
Ctrl-X Begins an extended command.
Ctrl-Y Yanks the deleted line.
Ctrl-_ Undo.
Ctrl-X Ctrl-L
Downcase the region.
Ctrl-X Ctrl-U
Upcase the region.
Ctrl-X Ctrl-X
Exchange the cursor and the mark.
Ctrl-X H
Mark the whole buffer.
Ctrl-X U
Undo.
Esc Ctrl-H
Backwards word-delete.
Esc Delete
Backwards word-delete.
Esc Space
Delete extra spaces (leaves only one space).
Esc Delete extra spaces (leaves only one space).
Esc < Go to the beginning of the line.
Esc > Go to the end of the line.
Esc @ Mark the current word.
Esc A Go one sentence backward.
Esc B Go one word backwards.
Esc C Capitalize the current word.
Esc D Delete the current word.
Esc E Go one sentence forward.
Esc F Go one word forward.
Esc K Delete the current sentence.
Esc L Lowercase the current word.
Esc T Transpose words.
Esc U Upcase the current word.
Delete Same as Backspace.
AUTHORS
SSH Communications Security Corp
For more information, see http://www.ssh.com.
SEE ALSO
sshregex(1), ssh2(1), sshd2(8), ssh-keygen2(1), ssh-
agent2(1), ssh-add2(1), scp2(1)