SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Trustix openssh-clients-3.6.1p2-5tr.i586.rpm

SFTP

Section: User Commands (1)
Index
BSD mandoc
 

NAME

sftp - Secure file transfer program 

SYNOPSIS

sftp-words[-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

sftpis an interactive file transfer program, similar toftp(1),which performs all operations over an encryptedssh(1)transport.It may also use many features of ssh, such as public key authentication andcompression.sftpconnects and logs into the specifiedhost then enters an interactive command mode.

The second usage format will retrieve files automatically if a non-interactiveauthentication method is used; otherwise it will do so aftersuccessful 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 inputbatchfileinstead ofstdin Since it lacks user interaction it should be used in conjunction withnon-interactive authentication.sftpwill abort if any of the followingcommands fail:get , put , rename , ln rm , mkdir , chdir , ls lchdir , chmod , chown , chgrp , lpwdandlmkdir Termination on error can be suppressed on a command by command basis byprefixing the command with a'-'character (For example,-rm /tmp/blah*).
-o ssh_option
Can be used to pass options tosshin the format used inssh_config5.This is useful for specifying optionsfor which there is no separatesftpcommand-line flag. For example, to specify an alternateport use:sftp -oPort=24
-s subsystem | sftp_server
Specifies the SSH2 subsystem or the path for an sftp serveron the remote host. A path is useful for using sftp overprotocol version 1, or when the remotesshddoes 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 thatsftpuses when transferring files. Larger buffers require fewer round trips atthe cost of higher memory consumption. The default is 32768 bytes.
-C
Enables compression (via ssh's-Cflag).
-F ssh_config
Specifies an alternativeper-user configuration file forssh This option is directly passed tossh(1).
-P sftp_server path
Connect directly to a localsftp-server(rather than viassh 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. Increasingthis may slightly improve file transfer speed but will increase memoryusage. The default is 16 outstanding requests.
-S program
Name of theprogramto use for the encrypted connection.The program must understandssh(1)options.
-1
Specify the use of protocol version 1.

 

INTERACTIVE COMMANDS

Once in interactive mode,sftpunderstands a set of commands similar to those offtp(1).Commands are case insensitive and pathnames may be enclosed in quotes if theycontain spaces.

bye
Quit sftp.
cd path
Change remote directory topath
lcd path
Change local directory topath
chgrp grp path
Change group of filepathtogrp grpmust be a numeric GID.
chmod mode path
Change permissions of filepathtomode
chown own path
Change owner of filepathtoown ownmust be a numeric UID.
exit
Quit sftp.
get[flags]remote-path[local-path]
Retrieve theremote-pathand store it on the local machine.If the localpath name is not specified, it is given the same name it has on theremote machine. If the-Pflag is specified, then the file's full permission and access time arecopied too.
help
Display help text.
lls [ls-options [path]]
Display local directory listing of eitherpathor current directory ifpathis not specified.
lmkdir path
Create local directory specified bypath
ln oldpath newpath
Create a symbolic link fromoldpathtonewpath
lpwd
Print local working directory.
ls[flags][path]
Display remote directory listing of eitherpathor current directory ifpathis not specified. If the-lflag is specified, then display additional details including permissionsand ownership information.
lumask umask
Set local umask toumask
mkdir path
Create remote directory specified bypath
progress
Toggle display of progress meter.
put[flags]local-path[remote-path]
Uploadlocal-pathand store it on the remote machine. If the remote path name is notspecified, it is given the same name it has on the local machine. If the-Pflag is specified, then the file's full permission and access time arecopied too.
pwd
Display remote working directory.
quit
Quit sftp.
rename oldpath newpath
Rename remote file fromoldpathtonewpath
rmdir path
Remove remote directory specified bypath
rm path
Delete remote file specified bypath
symlink oldpath newpath
Create a symbolic link fromoldpathtonewpath
version
Display thesftpprotocol version.
! command
Executecommandin local shell.
!
Escape to local shell.
?
Synonym for help.

 

AUTHORS

Damien Miller <djmAATTmindrot.org> 

SEE ALSO

scp(1),ssh(1),ssh-add1,ssh-keygen1,ssh_config5,sftp-server8,sshd(8)
T. YlonenS. Lehtinen"SSH File Transfer Protocol"draft-ietf-secsh-filexfer-00.txtJanuary 2001work in progress material


 

Index

NAME
SYNOPSIS
DESCRIPTION
INTERACTIVE COMMANDS
AUTHORS
SEE ALSO

This document was created byman2html,using the manual pages.