diff options
Diffstat (limited to 'sftp.1')
-rw-r--r-- | sftp.1 | 43 |
1 files changed, 36 insertions, 7 deletions
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: sftp.1,v 1.92 2013/07/25 00:56:51 djm Exp $ | 1 | .\" $OpenBSD: sftp.1,v 1.97 2013/10/20 09:51:26 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: July 25 2013 $ | 25 | .Dd $Mdocdate: October 20 2013 $ |
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 1246Cpqrv | 34 | .Op Fl 1246aCfpqrv |
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 |
@@ -107,6 +107,11 @@ to use IPv4 addresses only. | |||
107 | Forces | 107 | Forces |
108 | .Nm | 108 | .Nm |
109 | to use IPv6 addresses only. | 109 | to use IPv6 addresses only. |
110 | .It Fl a | ||
111 | Attempt to continue interrupted downloads rather than overwriting existing | ||
112 | partial or complete copies of files. | ||
113 | If the remote file contents differ from the partial local copy then the | ||
114 | resultant file is likely to be corrupt. | ||
110 | .It Fl B Ar buffer_size | 115 | .It Fl B Ar buffer_size |
111 | Specify the size of the buffer that | 116 | Specify the size of the buffer that |
112 | .Nm | 117 | .Nm |
@@ -159,6 +164,10 @@ per-user configuration file for | |||
159 | .Xr ssh 1 . | 164 | .Xr ssh 1 . |
160 | This option is directly passed to | 165 | This option is directly passed to |
161 | .Xr ssh 1 . | 166 | .Xr ssh 1 . |
167 | .It Fl f | ||
168 | Requests that files be flushed to disk immediately after transfer. | ||
169 | When uploading files, this feature is only enabled if the server | ||
170 | implements the "fsync@openssh.com" extension. | ||
162 | .It Fl i Ar identity_file | 171 | .It Fl i Ar identity_file |
163 | Selects the file from which the identity (private key) for public key | 172 | Selects the file from which the identity (private key) for public key |
164 | authentication is read. | 173 | authentication is read. |
@@ -184,6 +193,11 @@ For full details of the options listed below, and their possible values, see | |||
184 | .It AddressFamily | 193 | .It AddressFamily |
185 | .It BatchMode | 194 | .It BatchMode |
186 | .It BindAddress | 195 | .It BindAddress |
196 | .It CanonicalDomains | ||
197 | .It CanonicalizeFallbackLocal | ||
198 | .It CanonicalizeHostname | ||
199 | .It CanonicalizeMaxDots | ||
200 | .It CanonicalizePermittedCNAMEs | ||
187 | .It ChallengeResponseAuthentication | 201 | .It ChallengeResponseAuthentication |
188 | .It CheckHostIP | 202 | .It CheckHostIP |
189 | .It Cipher | 203 | .It Cipher |
@@ -343,7 +357,7 @@ extension. | |||
343 | Quit | 357 | Quit |
344 | .Nm sftp . | 358 | .Nm sftp . |
345 | .It Xo Ic get | 359 | .It Xo Ic get |
346 | .Op Fl aPpr | 360 | .Op Fl afPpr |
347 | .Ar remote-path | 361 | .Ar remote-path |
348 | .Op Ar local-path | 362 | .Op Ar local-path |
349 | .Xc | 363 | .Xc |
@@ -368,8 +382,15 @@ If the | |||
368 | flag is specified, then attempt to resume partial transfers of existing files. | 382 | flag is specified, then attempt to resume partial transfers of existing files. |
369 | Note that resumption assumes that any partial copy of the local file matches | 383 | Note that resumption assumes that any partial copy of the local file matches |
370 | the remote copy. | 384 | the remote copy. |
371 | If the remote file differs from the partial local copy then the resultant file | 385 | If the remote file contents differ from the partial local copy then the |
372 | is likely to be corrupt. | 386 | resultant file is likely to be corrupt. |
387 | .Pp | ||
388 | If the | ||
389 | .Fl f | ||
390 | flag is specified, then | ||
391 | .Xr fsync 2 | ||
392 | will be called after the file transfer has completed to flush the file | ||
393 | to disk. | ||
373 | .Pp | 394 | .Pp |
374 | If either the | 395 | If either the |
375 | .Fl P | 396 | .Fl P |
@@ -474,7 +495,7 @@ Create remote directory specified by | |||
474 | .It Ic progress | 495 | .It Ic progress |
475 | Toggle display of progress meter. | 496 | Toggle display of progress meter. |
476 | .It Xo Ic put | 497 | .It Xo Ic put |
477 | .Op Fl Ppr | 498 | .Op Fl fPpr |
478 | .Ar local-path | 499 | .Ar local-path |
479 | .Op Ar remote-path | 500 | .Op Ar remote-path |
480 | .Xc | 501 | .Xc |
@@ -493,6 +514,14 @@ is specified, then | |||
493 | .Ar remote-path | 514 | .Ar remote-path |
494 | must specify a directory. | 515 | must specify a directory. |
495 | .Pp | 516 | .Pp |
517 | If the | ||
518 | .Fl f | ||
519 | flag is specified, then a request will be sent to the server to call | ||
520 | .Xr fsync 2 | ||
521 | after the file has been transferred. | ||
522 | Note that this is only supported by servers that implement | ||
523 | the "fsync@openssh.com" extension. | ||
524 | .Pp | ||
496 | If either the | 525 | If either the |
497 | .Fl P | 526 | .Fl P |
498 | or | 527 | or |