diff options
author | Darren Tucker <dtucker@zip.com.au> | 2009-10-07 08:37:48 +1100 |
---|---|---|
committer | Darren Tucker <dtucker@zip.com.au> | 2009-10-07 08:37:48 +1100 |
commit | 1b0dd175377c86abb7f3a3da2e9b1a89f36c7a1a (patch) | |
tree | d6b5f501c4c9890ed91ce4fd86be583213d7e8e6 /sftp.1 | |
parent | 1477ea162c05c09b4b5ebc19ac588fbf469349dc (diff) |
- djm@cvs.openbsd.org 2009/08/18 18:36:21
[sftp-client.h sftp.1 sftp-client.c sftp.c]
recursive transfer support for get/put and on the commandline
work mostly by carlosvsilvapt@gmail.com for the Google Summer of Code
with some tweaks by me; "go for it" deraadt@
Diffstat (limited to 'sftp.1')
-rw-r--r-- | sftp.1 | 44 |
1 files changed, 36 insertions, 8 deletions
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: sftp.1,v 1.73 2009/08/13 13:39:54 jmc Exp $ | 1 | .\" $OpenBSD: sftp.1,v 1.74 2009/08/18 18:36:20 djm Exp $ |
2 | .\" | 2 | .\" |
3 | .\" Copyright (c) 2001 Damien Miller. All rights reserved. | 3 | .\" Copyright (c) 2001 Damien Miller. All rights reserved. |
4 | .\" | 4 | .\" |
@@ -22,7 +22,7 @@ | |||
22 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 22 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
23 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 23 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
24 | .\" | 24 | .\" |
25 | .Dd $Mdocdate: August 13 2009 $ | 25 | .Dd $Mdocdate: August 18 2009 $ |
26 | .Dt SFTP 1 | 26 | .Dt SFTP 1 |
27 | .Os | 27 | .Os |
28 | .Sh NAME | 28 | .Sh NAME |
@@ -31,7 +31,7 @@ | |||
31 | .Sh SYNOPSIS | 31 | .Sh SYNOPSIS |
32 | .Nm sftp | 32 | .Nm sftp |
33 | .Bk -words | 33 | .Bk -words |
34 | .Op Fl 1246Cqv | 34 | .Op Fl 1246Cpqrv |
35 | .Op Fl B Ar buffer_size | 35 | .Op Fl B Ar buffer_size |
36 | .Op Fl b Ar batchfile | 36 | .Op Fl b Ar batchfile |
37 | .Op Fl c Ar cipher | 37 | .Op Fl c Ar cipher |
@@ -223,6 +223,9 @@ For full details of the options listed below, and their possible values, see | |||
223 | .El | 223 | .El |
224 | .It Fl P Ar port | 224 | .It Fl P Ar port |
225 | Specifies the port to connect to on the remote host. | 225 | Specifies the port to connect to on the remote host. |
226 | .It Fl p | ||
227 | Preserves modification times, access times, and modes from the | ||
228 | original files transferred. | ||
226 | .It Fl q | 229 | .It Fl q |
227 | Quiet mode: disables the progress meter as well as warning and | 230 | Quiet mode: disables the progress meter as well as warning and |
228 | diagnostic messages from | 231 | diagnostic messages from |
@@ -232,6 +235,11 @@ Specify how many requests may be outstanding at any one time. | |||
232 | Increasing this may slightly improve file transfer speed | 235 | Increasing this may slightly improve file transfer speed |
233 | but will increase memory usage. | 236 | but will increase memory usage. |
234 | The default is 64 outstanding requests. | 237 | The default is 64 outstanding requests. |
238 | .It Fl r | ||
239 | Recursively copy entire directories when uploading and downloading. | ||
240 | Note that | ||
241 | .Nm | ||
242 | does not follow symbolic links encountered in the tree traversal. | ||
235 | .It Fl S Ar program | 243 | .It Fl S Ar program |
236 | Name of the | 244 | Name of the |
237 | .Ar program | 245 | .Ar program |
@@ -322,7 +330,7 @@ extension. | |||
322 | Quit | 330 | Quit |
323 | .Nm sftp . | 331 | .Nm sftp . |
324 | .It Xo Ic get | 332 | .It Xo Ic get |
325 | .Op Fl P | 333 | .Op Fl Ppr |
326 | .Ar remote-path | 334 | .Ar remote-path |
327 | .Op Ar local-path | 335 | .Op Ar local-path |
328 | .Xc | 336 | .Xc |
@@ -341,10 +349,20 @@ If it does and | |||
341 | is specified, then | 349 | is specified, then |
342 | .Ar local-path | 350 | .Ar local-path |
343 | must specify a directory. | 351 | must specify a directory. |
344 | If the | 352 | .Pp |
345 | .Fl P | 353 | If ether the |
354 | .Fl Ppr | ||
355 | or | ||
356 | .Fl p | ||
346 | flag is specified, then full file permissions and access times are | 357 | flag is specified, then full file permissions and access times are |
347 | copied too. | 358 | copied too. |
359 | .Pp | ||
360 | If the | ||
361 | .Fl r | ||
362 | flag is specified then directories will be copied recursively. | ||
363 | Note that | ||
364 | .Nm | ||
365 | does not follow symbolic links when performing recursive transfers. | ||
348 | .It Ic help | 366 | .It Ic help |
349 | Display help text. | 367 | Display help text. |
350 | .It Ic lcd Ar path | 368 | .It Ic lcd Ar path |
@@ -440,10 +458,20 @@ If it does and | |||
440 | is specified, then | 458 | is specified, then |
441 | .Ar remote-path | 459 | .Ar remote-path |
442 | must specify a directory. | 460 | must specify a directory. |
443 | If the | 461 | .Pp |
462 | If ether the | ||
444 | .Fl P | 463 | .Fl P |
445 | flag is specified, then the file's full permission and access time are | 464 | or |
465 | .Fl p | ||
466 | flag is specified, then full file permissions and access times are | ||
446 | copied too. | 467 | copied too. |
468 | .Pp | ||
469 | If the | ||
470 | .Fl r | ||
471 | flag is specified then directories will be copied recursively. | ||
472 | Note that | ||
473 | .Nm | ||
474 | does not follow symbolic links when performing recursive transfers. | ||
447 | .It Ic pwd | 475 | .It Ic pwd |
448 | Display remote working directory. | 476 | Display remote working directory. |
449 | .It Ic quit | 477 | .It Ic quit |