man pages for sftp
SSH2 Last change: March 22, 2000
NAME
sftp2 - secure ftp client
SYNOPSIS
sftp2 [-D debug_level_spec] [-b batchfile] [-S path] [-h]
[-V] host
DESCRIPTION
sftp2 (Secure FTP) is a ftp-like client that can be used to
transfer files over a network. sftp2 transfers the files
through ssh2 connections, so that the confidentiality and
integrity of the files are guaranteed. The remote host must
be running a sshd2 server (ftpd is not needed.)
OPTIONS
-D debug_level_spec
Debug mode. Makes sftp2 send more or less 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 stan-
dard input. Passwords and other user interaction 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 display
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 direc-
tory.
lpwd Prints the name of the current local working directory.
ls [ -R ] [ -l
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 directory trees
are listed recursively. (By default, the subdirectories
of the argument directories are not visited.) When the
-l option is specified, permissions, 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 incompatible.
lls [ -R ] [ -l
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 directory.
lmkdir directory
Same as mkdir, but operates on local files.
rmdir directory
Tries to delete the directory specified in directory.
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 backslashes
themselves. Quotation marks can be used for specifying
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 Ltd
For more information, see http://www.ssh.fi.
SEE ALSO
sshregex(1), ssh2(1), sshd2(8), ssh-keygen2(1), ssh-
agent2(1), ssh-add2(1), scp2(1)