diff options
author | Michael Kaufmann <mail@michael-kaufmann.ch> | 2015-01-29 22:34:21 +0100 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2015-01-29 22:34:21 +0100 |
commit | 04f246f8c7630877c19ebebf2e5dc2c6e63fe185 (patch) | |
tree | b8ae76eb20fbe4cfd6f942e85d5ab44650760f81 | |
parent | 8ca3b05624981654e3a89d32084cf003bd8240a1 (diff) |
CURLOPT_SEEKFUNCTION.3: also when server closes a connection
-rw-r--r-- | docs/libcurl/opts/CURLOPT_SEEKFUNCTION.3 | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/docs/libcurl/opts/CURLOPT_SEEKFUNCTION.3 b/docs/libcurl/opts/CURLOPT_SEEKFUNCTION.3 index 8747a1784..bf7e3045e 100644 --- a/docs/libcurl/opts/CURLOPT_SEEKFUNCTION.3 +++ b/docs/libcurl/opts/CURLOPT_SEEKFUNCTION.3 @@ -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 .\" * 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 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 -function/callback). It is also called to rewind a stream when doing a HTTP PUT -or POST with a multi-pass authentication method. 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. +function/callback). It is also called to rewind a stream when data has already +been sent to the server and needs to be sent again. This may happen when doing +a HTTP PUT or POST with a multi-pass authentication method, or when an +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. |