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 09:28:25 +0200
commit1b5cb81bcb8439ac5e28d3e9a18ea0b2c13d12ea (patch)
tree4ab2b8567010a95c785fd0789181e494dcb50953
parent7de2a4ce35dee7a9409ab78962ae12894a073d60 (diff)
downloadcurl-bagder/readfunc-uploadsize.tar.gz
CURLOPT_READFUNCTION.3: provide the upload data size up frontbagder/readfunc-uploadsize
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