Commit 04f246f8 authored by Michael Kaufmann's avatar Michael Kaufmann Committed by Daniel Stenberg
Browse files

CURLOPT_SEEKFUNCTION.3: also when server closes a connection

parent 8ca3b056
Loading
Loading
Loading
Loading
+8 −5
Original line number Original line Diff line number Diff line
@@ -5,7 +5,7 @@
.\" *                            | (__| |_| |  _ <| |___
.\" *                            | (__| |_| |  _ <| |___
.\" *                             \___|\___/|_| \_\_____|
.\" *                             \___|\___/|_| \_\_____|
.\" *
.\" *
.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * Copyright (C) 1998 - 2015, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * you should have received as part of this distribution. The terms
@@ -43,10 +43,13 @@ shown above.
This function gets called by libcurl to seek to a certain position in the
This function gets called by libcurl to seek to a certain position in the
input stream and can be used to fast forward a file in a resumed upload
input stream and can be used to fast forward a file in a resumed upload
(instead of reading all uploaded bytes with the normal read
(instead of reading all uploaded bytes with the normal read
function/callback). It is also called to rewind a stream when doing a HTTP PUT
function/callback). It is also called to rewind a stream when data has already
or POST with a multi-pass authentication method. The function shall work like
been sent to the server and needs to be sent again. This may happen when doing
fseek(3) or lseek(3) and it gets SEEK_SET, SEEK_CUR or SEEK_END as argument
a HTTP PUT or POST with a multi-pass authentication method, or when an
for \fIorigin\fP, although libcurl currently only passes SEEK_SET.
existing HTTP connection is reused too late and the server closes the
connection. The function shall work like fseek(3) or lseek(3) and it gets
SEEK_SET, SEEK_CUR or SEEK_END as argument for \fIorigin\fP, although libcurl
currently only passes SEEK_SET.


\fIuserp\fP is the pointer you set with \fICURLOPT_SEEKDATA(3)\fP.
\fIuserp\fP is the pointer you set with \fICURLOPT_SEEKDATA(3)\fP.