From d984a3c6658e950881edcfb2aae464add93f68d4 Mon Sep 17 00:00:00 2001 From: Colin Watson Date: Mon, 1 Sep 2003 00:45:47 +0000 Subject: Import OpenSSH 3.4p1. --- sftp.0 | 169 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 sftp.0 (limited to 'sftp.0') diff --git a/sftp.0 b/sftp.0 new file mode 100644 index 000000000..562b685e4 --- /dev/null +++ b/sftp.0 @@ -0,0 +1,169 @@ +SFTP(1) System General Commands Manual SFTP(1) + +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 compresM-- + sion. 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-interM-- + active authentication method is used; otherwise it will do so after sucM-- + cessful interactive authentication. + + The last usage format allows the sftp client to start in a remote direcM-- + tory. + + 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, put, + rename, ln, rm, mkdir, chdir, lchdir 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 subsysM-- + tem 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 connection. 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 permission and access time are copied too. + + help Display help text. + + lls [ls-options [path]] + Display local directory listing of either path or current direcM-- + tory 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 [path] + Display remote directory listing of either path or current direcM-- + tory if path is not specified. + + 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. + +AUTHORS + Damien Miller + +SEE ALSO + scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5), sftp-server(8), + sshd(8) + + T. Ylonen and S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh- + filexfer-00.txt, January 2001, work in progress material. + +BSD February 4, 2001 BSD -- cgit v1.2.3