summaryrefslogtreecommitdiff
path: root/sftp.1
diff options
context:
space:
mode:
Diffstat (limited to 'sftp.1')
-rw-r--r--sftp.143
1 files changed, 36 insertions, 7 deletions
diff --git a/sftp.1 b/sftp.1
index 2577fe875..a700c2adb 100644
--- a/sftp.1
+++ b/sftp.1
@@ -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.
107Forces 107Forces
108.Nm 108.Nm
109to use IPv6 addresses only. 109to use IPv6 addresses only.
110.It Fl a
111Attempt to continue interrupted downloads rather than overwriting existing
112partial or complete copies of files.
113If the remote file contents differ from the partial local copy then the
114resultant file is likely to be corrupt.
110.It Fl B Ar buffer_size 115.It Fl B Ar buffer_size
111Specify the size of the buffer that 116Specify 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 .
160This option is directly passed to 165This option is directly passed to
161.Xr ssh 1 . 166.Xr ssh 1 .
167.It Fl f
168Requests that files be flushed to disk immediately after transfer.
169When uploading files, this feature is only enabled if the server
170implements the "fsync@openssh.com" extension.
162.It Fl i Ar identity_file 171.It Fl i Ar identity_file
163Selects the file from which the identity (private key) for public key 172Selects the file from which the identity (private key) for public key
164authentication is read. 173authentication 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.
343Quit 357Quit
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
368flag is specified, then attempt to resume partial transfers of existing files. 382flag is specified, then attempt to resume partial transfers of existing files.
369Note that resumption assumes that any partial copy of the local file matches 383Note that resumption assumes that any partial copy of the local file matches
370the remote copy. 384the remote copy.
371If the remote file differs from the partial local copy then the resultant file 385If the remote file contents differ from the partial local copy then the
372is likely to be corrupt. 386resultant file is likely to be corrupt.
387.Pp
388If the
389.Fl f
390flag is specified, then
391.Xr fsync 2
392will be called after the file transfer has completed to flush the file
393to disk.
373.Pp 394.Pp
374If either the 395If 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
475Toggle display of progress meter. 496Toggle 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
494must specify a directory. 515must specify a directory.
495.Pp 516.Pp
517If the
518.Fl f
519flag is specified, then a request will be sent to the server to call
520.Xr fsync 2
521after the file has been transferred.
522Note that this is only supported by servers that implement
523the "fsync@openssh.com" extension.
524.Pp
496If either the 525If either the
497.Fl P 526.Fl P
498or 527or