=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/ssh/sftp.1,v retrieving revision 1.26.2.3 retrieving revision 1.27 diff -u -r1.26.2.3 -r1.27 --- src/usr.bin/ssh/sftp.1 2002/10/11 14:53:07 1.26.2.3 +++ src/usr.bin/ssh/sftp.1 2002/02/04 21:53:11 1.27 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sftp.1,v 1.26.2.3 2002/10/11 14:53:07 miod Exp $ +.\" $OpenBSD: sftp.1,v 1.27 2002/02/04 21:53:11 djm Exp $ .\" .\" Copyright (c) 2001 Damien Miller. All rights reserved. .\" @@ -30,14 +30,12 @@ .Nd Secure file transfer program .Sh SYNOPSIS .Nm sftp -.Op Fl vC1 +.Op Fl 1Cv .Op Fl b Ar batchfile -.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 o Ar ssh_option .Op Fl P Ar sftp_server path -.Op Fl R Ar num_requests +.Op Fl s Ar subsystem | sftp_server .Op Fl S Ar program .Ar host .Nm sftp @@ -66,6 +64,14 @@ .Pp The options are as follows: .Bl -tag -width Ds +.It Fl 1 +Specify the use of protocol version 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 b Ar batchfile Batch mode reads a series of commands from an input .Ar batchfile @@ -76,16 +82,25 @@ .Nm will abort if any of the following commands fail: -.Ic get , put , rename , ln , -.Ic rm , mkdir , chdir , lchdir +.Ic get , put , rename , ln , 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 -.Xr ssh_config 5 . -This is useful for specifying options +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 @@ -97,33 +112,6 @@ 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 @@ -131,8 +119,8 @@ The program must understand .Xr ssh 1 options. -.It Fl 1 -Specify the use of protocol version 1. +.It Fl v +Raise logging level. This option is also passed to ssh. .El .Sh INTERACTIVE COMMANDS Once in interactive mode, @@ -203,18 +191,12 @@ .Ar newpath . .It Ic lpwd Print local working directory. -.It Xo Ic ls -.Op Ar flags -.Op Ar path -.Xc +.It Ic ls Op Ar path Display remote directory listing of either .Ar path or current directory if .Ar path -is not specified. If the -.Fl l -flag is specified, then display additional details including permissions -and ownership information. +is not specified. .It Ic lumask Ar umask Set local umask to .Ar umask . @@ -269,7 +251,6 @@ .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , -.Xr ssh_config 5 , .Xr sftp-server 8 , .Xr sshd 8 .Rs