=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/ssh/sftp.1,v retrieving revision 1.26 retrieving revision 1.26.2.2 diff -u -r1.26 -r1.26.2.2 --- src/usr.bin/ssh/sftp.1 2001/09/17 20:38:09 1.26 +++ src/usr.bin/ssh/sftp.1 2002/06/22 07:23:17 1.26.2.2 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sftp.1,v 1.26 2001/09/17 20:38:09 stevesk Exp $ +.\" $OpenBSD: sftp.1,v 1.26.2.2 2002/06/22 07:23:17 miod Exp $ .\" .\" Copyright (c) 2001 Damien Miller. All rights reserved. .\" @@ -30,11 +30,14 @@ .Nd Secure file transfer program .Sh SYNOPSIS .Nm sftp -.Op Fl 1Cv +.Op Fl vC1 .Op Fl b Ar batchfile -.Op Fl F Ar ssh_config .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 @@ -63,8 +66,6 @@ .Pp The options are as follows: .Bl -tag -width Ds -.It Fl 1 -Specify the use of protocol version 1. .It Fl b Ar batchfile Batch mode reads a series of commands from an input .Ar batchfile @@ -75,25 +76,16 @@ .Nm will abort if any of the following commands fail: -.Ic get , put , rename , ln , rm , mkdir , chdir , lchdir +.Ic get , put , rename , ln , +.Ic rm , mkdir , chdir , lchdir and .Ic lmkdir . -.It Fl C -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 -.Xr ssh 1 . .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 +in the format used in +.Xr ssh_config 5 . +This is useful for specifying options for which there is no separate .Nm sftp command-line flag. For example, to specify an alternate @@ -105,6 +97,33 @@ 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 +.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 +.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 @@ -112,8 +131,8 @@ The program must understand .Xr ssh 1 options. -.It Fl v -Raise logging level. This option is also passed to ssh. +.It Fl 1 +Specify the use of protocol version 1. .El .Sh INTERACTIVE COMMANDS Once in interactive mode, @@ -244,6 +263,7 @@ .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , +.Xr ssh_config 5 , .Xr sftp-server 8 , .Xr sshd 8 .Rs