summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2020-06-25 09:54:40 +0200
committerDaniel Stenberg <daniel@haxx.se>2020-06-26 15:12:21 +0200
commit43f7ffb6c4c1d63815ed2fcc5799bed9f7d96033 (patch)
tree4841e34b23add79d832623cd43b4ca6e23e71c7c
parent1529838a14e72fc7b1f2bcb561ea1b1a785975e4 (diff)
downloadcurl-43f7ffb6c4c1d63815ed2fcc5799bed9f7d96033.tar.gz
CURLOPT_READFUNCTION.3: provide the upload data size up front
Assisted-by: Jay Satiro Closes #5607
-rw-r--r--docs/libcurl/opts/CURLOPT_READFUNCTION.37
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/libcurl/opts/CURLOPT_READFUNCTION.3 b/docs/libcurl/opts/CURLOPT_READFUNCTION.3
index d70a31450..73daeff18 100644
--- a/docs/libcurl/opts/CURLOPT_READFUNCTION.3
+++ b/docs/libcurl/opts/CURLOPT_READFUNCTION.3
@@ -20,7 +20,7 @@
.\" *
.\" **************************************************************************
.\"
-.TH CURLOPT_READFUNCTION 3 "16 Jun 2014" "libcurl 7.37.0" "curl_easy_setopt options"
+.TH CURLOPT_READFUNCTION 3 "25 Jun 2020" "libcurl 7.71.0" "curl_easy_setopt options"
.SH NAME
CURLOPT_READFUNCTION \- read callback for data uploads
.SH SYNOPSIS
@@ -64,6 +64,11 @@ server end and the transfer will end there.
If you set this callback pointer to NULL, or don't set it at all, the default
internal read function will be used. It is doing an fread() on the FILE *
userdata set with \fICURLOPT_READDATA(3)\fP.
+
+You can set the total size of the data you are sending by using
+\fICURLOPT_INFILESIZE_LARGE(3)\fP or \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP,
+depending on the type of transfer. For some transfer types it may be required
+and it allows for better error checking.
.SH DEFAULT
The default internal read callback is fread().
.SH PROTOCOLS