|
man page for scp |
|---|
| man page for ssh |
|
(full manual page for sftp, below) |
| overview |
USAGE:
sftp [username@]hostname
sftp is a program for transferring files to and from a remote computer. It is interactive, just like ftp used to be, but uses the secure encryption of ssh.
Once you connect with the remote computer, giving a password if necessary, you can type the following interactive commands to change directories and to transfer files between your local computer and the remote computer:
| get filename | retrieves remote file and stores it to local computer |
| put filename | upload local file to store on remote computer |
| cd path | change remote directory to path |
| ls | list remote files |
| pwd | print remote working directory |
| chmod mode path | change permission mode of remote file/directory |
| rename oldfilename newfilename | rename remote file |
| rm filename | remove remote file |
| mkdir path | create remote directory |
| rmdir dirname | remove remote directory |
| lcd path | change local directory to path |
| lpwd | print local working directory |
| lls | list local files |
| help | display help text |
| quit | quit sftp |
newton> sftp euclid
Connect with euclid using your newton username
newton> sftp smithjz@euclid.ucla.edu
Connect with euclid.ucla.edu using username smithjz
| go to TOP |
|---|
NAME
sftp - Secure file transfer program
SYNOPSIS
sftp [-vC1] [-b batchfile] [-o ssh_option] [-s subsystem |
sftp_server] [-B buffer_size] [-F ssh_config] [-P
sftp_server path] [-R num_requests] [-S program] host
sftp [[user@]host[:file [file]]]
sftp [[user@]host[:dir[/]]]
DESCRIPTION
sftp is an interactive file transfer program, similar to
ftp(1), which performs all operations over an encrypted
ssh(1) transport. It may also use many features of ssh,
such as public key authentication and compression. sftp
connects and logs into the specified host, then enters an
interactive command mode.
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.
The last usage format allows the sftp client to start in a
remote directory.
The options are as follows:
-b batchfile
Batch mode reads a series of commands from an input
batchfile instead of stdin. Since it lacks user
interaction it should be used in conjunction with non-
interactive authentication. sftp will abort if any of
the following commands fail: get, rm, and lmkdir.
-o ssh_option
Can be used to pass options to ssh in the format used
in ssh_config(5). This is useful for specifying
options for which there is no separate sftp command-
line flag. For example, to specify an alternate port
use: sftp -oPort=24.
-s 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 sshd
does not have an sftp subsystem configured.
-v Raise logging level. This option is also passed to ssh.
-B buffer_size
Specify the size of the buffer that sftp uses when
transferring files. Larger buffers require fewer round
trips at the cost of higher memory consumption. The
default is 32768 bytes.
-C Enables compression (via ssh's -C flag).
-F ssh_config
Specifies an alternative per-user configuration file
for ssh. This option is directly passed to ssh(1).
-P sftp_server path
Connect directly to a local sftp-server (rather than
via ssh ) This option may be useful in debugging the
client and server.
-R 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.
-S program
Name of the program to use for the encrypted connec-
tion. The program must understand ssh(1) options.
-1 Specify the use of protocol version 1.
INTERACTIVE COMMANDS
Once in interactive mode, sftp understands a set of commands
similar to those of ftp(1). Commands are case insensitive
and pathnames may be enclosed in quotes if they contain
spaces.
bye
Quit sftp.
cd path
Change remote directory to path.
lcd path
Change local directory to path.
chgrp grp path
Change group of file path to grp. grp must be a
numeric GID.
chmod mode path
Change permissions of file path to mode.
chown own path
Change owner of file path to own. own must be a
numeric UID.
exit
Quit sftp.
get [flags] remote-path [local-path]
Retrieve the remote-path and store it on the local
machine. If the local path name is not specified, it
is given the same name it has on the remote machine. If
the -P flag is specified, then the file's full permis-
sion and access time are copied too.
help
Display help text.
lls [ls-options [path]]
Display local directory listing of either path or
current directory if path is not specified.
lmkdir path
Create local directory specified by path.
ln oldpath newpath
Create a symbolic link from oldpath to newpath.
lpwd Print local working directory.
ls [flags] [path]
Display remote directory listing of either path or
current directory if path is not specified. If the -l
flag is specified, then display additional details
including permissions and ownership information.
lumask umask
Set local umask to umask.
mkdir path
Create remote directory specified by path.
put [flags] local-path [local-path]
Upload local-path and store it on the remote machine.
If the remote path name is not specified, it is given
the same name it has on the local machine. If the -P
flag is specified, then the file's full permission and
access time are copied too.
pwd
Display remote working directory.
quit
Quit sftp.
rename oldpath newpath
Rename remote file from oldpath to newpath.
rmdir path
Remove remote directory specified by path.
rm path
Delete remote file specified by path.
symlink oldpath newpath
Create a symbolic link from oldpath to newpath.
! command
Execute command in local shell.
!
Escape to local shell.
?
Synonym for help.
SEE ALSO
scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5),
sftp-server(8), sshd(8)