=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/ssh/sftp.1,v retrieving revision 1.7.2.6 retrieving revision 1.8 diff -u -r1.7.2.6 -r1.8 --- src/usr.bin/ssh/sftp.1 2002/03/08 17:04:43 1.7.2.6 +++ src/usr.bin/ssh/sftp.1 2001/02/17 15:24:40 1.8 @@ -1,6 +1,6 @@ -.\" $OpenBSD: sftp.1,v 1.7.2.6 2002/03/08 17:04:43 brad Exp $ +.\" $OpenBSD: sftp.1,v 1.8 2001/02/17 15:24:40 reinhard Exp $ .\" -.\" Copyright (c) 2001 Damien Miller. All rights reserved. +.\" Copyright (c) 2001 Damien Miller. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -22,7 +22,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd February 4, 2001 +.Dd Febuary 4, 2001 .Dt SFTP 1 .Os .Sh NAME @@ -30,20 +30,9 @@ .Nd Secure file transfer program .Sh SYNOPSIS .Nm sftp -.Op Fl vC1 -.Op Fl b Ar batchfile +.Op Fl vC .Op Fl o Ar ssh_option -.Op Fl s Ar subsystem | sftp_server -.Op Fl B Ar buffer_size -.Op Fl F Ar ssh_config -.Op Fl P Ar sftp_server path -.Op Fl R Ar num_requests -.Op Fl S Ar program -.Ar host -.Nm sftp -.Op [\fIuser\fR@]\fIhost\fR[:\fIfile\fR [\fIfile\fR]] -.Nm sftp -.Op [\fIuser\fR@]\fIhost\fR[:\fIdir\fR[\fI/\fR]] +.Op Ar hostname | user@hostname .Sh DESCRIPTION .Nm is an interactive file transfer program, similar to @@ -55,122 +44,56 @@ compression. .Nm connects and logs into the specified -.Ar host , +.Ar hostname , then enters an interactive command mode. .Pp -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. -.Pp -The last usage format allows the sftp client to start in a remote directory. -.Pp The options are as follows: .Bl -tag -width Ds -.It Fl b Ar batchfile -Batch mode reads a series of commands from an input -.Ar batchfile -instead of -.Em stdin . -Since it lacks user interaction it should be used in conjunction with -non-interactive authentication. -.Nm -will abort if any of the following -commands fail: -.Ic get , put , rename , ln , -.Ic rm , mkdir , chdir , lchdir -and -.Ic lmkdir . -.It Fl o Ar ssh_option -Can be used to pass options to -.Nm ssh -in the format used in the -.Xr ssh 1 -configuration file. This is useful for specifying options -for which there is no separate -.Nm sftp -command-line flag. For example, to specify an alternate -port use: -.Ic sftp -oPort=24 . -.It Fl s Ar 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 -.Nm sshd -does not have an sftp subsystem configured. .It Fl v Raise logging level. This option is also passed to ssh. -.It Fl B Ar buffer_size -Specify the size of the buffer that -.Nm -uses when transferring files. Larger buffers require fewer round trips at -the cost of higher memory consumption. The default is 32768 bytes. .It Fl C -Enables compression (via ssh's +Enables compression (via ssh's .Fl C -flag). -.It Fl F Ar ssh_config -Specifies an alternative -per-user configuration file for -.Nm ssh . -This option is directly passed to +flag) +.It Fl o Ar ssh_option +Specify an option to be directly passed to .Xr ssh 1 . -.It Fl P Ar sftp_server path -Connect directly to a local -.Nm sftp-server -(rather than via -.Nm ssh ) -This option may be useful in debugging the client and server. -.It Fl R Ar 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. -.It Fl S Ar program -Name of the -.Ar program -to use for the encrypted connection. -The program must understand -.Xr ssh 1 -options. -.It Fl 1 -Specify the use of protocol version 1. .El .Sh INTERACTIVE COMMANDS Once in interactive mode, .Nm -understands a set of commands similar to those of +understands a set of commands similar to those of .Xr ftp 1 . Commands are case insensitive and pathnames may be enclosed in quotes if they contain spaces. .Bl -tag -width Ds -.It Ic bye -Quit sftp. .It Ic cd Ar path -Change remote directory to +Change remote directory to .Ar path . .It Ic lcd Ar path -Change local directory to +Change local directory to .Ar path . .It Ic chgrp Ar grp Ar path -Change group of file +Change group of file .Ar path to .Ar grp . .Ar grp must be a numeric GID. .It Ic chmod Ar mode Ar path -Change permissions of file +Change permissions of file .Ar path to .Ar mode . .It Ic chown Ar own Ar path -Change owner of file +Change owner of file .Ar path to .Ar own . .Ar own must be a numeric UID. -.It Ic exit -Quit sftp. +.It Ic help +Display help text. .It Xo Ic get .Op Ar flags .Ar remote-path @@ -180,15 +103,13 @@ .Ar 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 +path name is not specified, it is given the same name it has on the +remote machine. If the .Fl P flag is specified, then the file's full permission and access time are copied too. -.It Ic help -Display help text. .It Ic lls Op Ar ls-options Op Ar path -Display local directory listing of either +Display local directory listing of either .Ar path or current directory if .Ar path @@ -196,11 +117,6 @@ .It Ic lmkdir Ar path Create local directory specified by .Ar path . -.It Ic ln Ar oldpath Ar newpath -Create a symbolic link from -.Ar oldpath -to -.Ar newpath . .It Ic lpwd Print local working directory. .It Ic ls Op Ar path @@ -210,7 +126,7 @@ .Ar path is not specified. .It Ic lumask Ar umask -Set local umask to +Set local umask to .Ar umask . .It Ic mkdir Ar path Create remote directory specified by @@ -222,13 +138,15 @@ .Xc Upload .Ar 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 +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 .Fl P flag is specified, then the file's full permission and access time are copied too. .It Ic pwd Display remote working directory. +.It Ic exit +Quit sftp. .It Ic quit Quit sftp. .It Ic rename Ar oldpath Ar newpath @@ -242,13 +160,8 @@ .It Ic rm Ar path Delete remote file specified by .Ar path . -.It Ic symlink Ar oldpath Ar newpath -Create a symbolic link from -.Ar oldpath -to -.Ar newpath . .It Ic ! Ar command -Execute +Execute .Ar command in local shell. .It Ic ! @@ -259,17 +172,9 @@ .Sh AUTHORS Damien Miller .Sh SEE ALSO -.Xr scp 1 , .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , -.Xr sftp-server 8 , -.Xr sshd 8 -.Rs -.%A T. Ylonen -.%A S. Lehtinen -.%T "SSH File Transfer Protocol" -.%N draft-ietf-secsh-filexfer-00.txt -.%D January 2001 -.%O work in progress material -.Re +.Xr sshd 8 , +.Xr scp 1 +