diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2013-12-26 23:50:34 +0100 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2013-12-26 23:50:34 +0100 |
| commit | 2a4ee0d221555686b4a8eae87e54a19e128f7271 (patch) | |
| tree | c9cdcd266a6c999397445d58df149bf8f3db87fc /docs/libcurl/curl_easy_pause.3 | |
| parent | f88f9bed008b15d488810cd5e6bea2e5efcaff6b (diff) | |
FILE: we don't support paused transfers using this protocol
Make sure that we detect such attempts and return a proper error code
instead of silently handling this in problematic ways.
Updated the documentation to mention this limitation.
Bug: http://curl.haxx.se/bug/view.cgi?id=1286
Diffstat (limited to 'docs/libcurl/curl_easy_pause.3')
| -rw-r--r-- | docs/libcurl/curl_easy_pause.3 | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/libcurl/curl_easy_pause.3 b/docs/libcurl/curl_easy_pause.3 index 402bb0546..1e53477f7 100644 --- a/docs/libcurl/curl_easy_pause.3 +++ b/docs/libcurl/curl_easy_pause.3 @@ -31,8 +31,8 @@ curl_easy_pause - pause and unpause a connection Using this function, you can explicitly mark a running connection to get paused, and you can unpause a connection that was previously paused. -A connection can be paused by using this function or by letting the read -or the write callbacks return the proper magic return code +A connection can be paused by using this function or by letting the read or +the write callbacks return the proper magic return code (\fICURL_READFUNC_PAUSE\fP and \fICURL_WRITEFUNC_PAUSE\fP). A write callback that returns pause signals to the library that it couldn't take care of any data at all, and that data will then be delivered again to the callback when @@ -68,6 +68,10 @@ Convenience define that unpauses both directions CURLE_OK (zero) means that the option was set properly, and a non-zero return code means something wrong occurred after the new state was set. See the \fIlibcurl-errors(3)\fP man page for the full list with descriptions. +.SH LIMITATIONS +The pausing of transfers does not work with protocols that work without +network connectivity, like FILE://. Trying to pause such a transfer, in any +direction, will cause problems in the worst case or an error in the best case. .SH AVAILABILITY This function was added in libcurl 7.18.0. Before this version, there was no explicit support for pausing transfers. |