summaryrefslogtreecommitdiff
path: root/sftp.1
diff options
context:
space:
mode:
authorDamien Miller <djm@mindrot.org>2014-05-15 13:47:15 +1000
committerDamien Miller <djm@mindrot.org>2014-05-15 13:47:15 +1000
commitd875ff78d2b8436807381051de112f0ebf9b9ae1 (patch)
tree6f5080117d6a585797010db5595d27957b1da24a /sftp.1
parentb15cd7bb097fd80dc99520f45290ef775da1ef19 (diff)
- logan@cvs.openbsd.org 2014/04/22 12:42:04
[sftp.1] Document sftp upload resume. OK from djm@, with feedback from okan@.
Diffstat (limited to 'sftp.1')
-rw-r--r--sftp.137
1 files changed, 29 insertions, 8 deletions
diff --git a/sftp.1 b/sftp.1
index a700c2ad..e73a480a 100644
--- a/sftp.1
+++ b/sftp.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: sftp.1,v 1.97 2013/10/20 09:51:26 djm Exp $
+.\" $OpenBSD: sftp.1,v 1.98 2014/04/22 12:42:04 logan Exp $
.\"
.\" Copyright (c) 2001 Damien Miller. All rights reserved.
.\"
@@ -22,7 +22,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 20 2013 $
+.Dd $Mdocdate: April 22 2014 $
.Dt SFTP 1
.Os
.Sh NAME
@@ -108,10 +108,10 @@ Forces
.Nm
to use IPv6 addresses only.
.It Fl a
-Attempt to continue interrupted downloads rather than overwriting existing
-partial or complete copies of files.
-If the remote file contents differ from the partial local copy then the
-resultant file is likely to be corrupt.
+Attempt to continue interrupted transfers rather than overwriting
+existing partial or complete copies of files.
+If the partial contents differ from those being transferred,
+then the resultant file is likely to be corrupt.
.It Fl B Ar buffer_size
Specify the size of the buffer that
.Nm
@@ -134,7 +134,7 @@ may be used to indicate standard input.
.Nm
will abort if any of the following
commands fail:
-.Ic get , put , reget , rename , ln ,
+.Ic get , put , reget , reput, rename , ln ,
.Ic rm , mkdir , chdir , ls ,
.Ic lchdir , chmod , chown ,
.Ic chgrp , lpwd , df , symlink ,
@@ -495,7 +495,7 @@ Create remote directory specified by
.It Ic progress
Toggle display of progress meter.
.It Xo Ic put
-.Op Fl fPpr
+.Op Fl afPpr
.Ar local-path
.Op Ar remote-path
.Xc
@@ -515,6 +515,15 @@ is specified, then
must specify a directory.
.Pp
If the
+.Fl a
+flag is specified, then attempt to resume partial
+transfers of existing files.
+Note that resumption assumes that any partial copy of the remote file
+matches the local copy.
+If the local file contents differ from the remote local copy then
+the resultant file is likely to be corrupt.
+.Pp
+If the
.Fl f
flag is specified, then a request will be sent to the server to call
.Xr fsync 2
@@ -552,6 +561,18 @@ Equivalent to
with the
.Fl a
flag set.
+.It Xo Ic reput
+.Op Fl Ppr
+.Op Ar local-path
+.Ar remote-path
+.Xc
+Resume upload of
+.Op Ar local-path .
+Equivalent to
+.Ic put
+with the
+.Fl a
+flag set.
.It Ic rename Ar oldpath Ar newpath
Rename remote file from
.Ar oldpath