summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2018-11-23 16:55:33 +0100
committerDaniel Stenberg <daniel@haxx.se>2018-11-23 16:55:33 +0100
commitae7a09db20081672242cbf69bb871f3ab1c5a24c (patch)
tree5ed99369a34727fad46769a123bb17984fc064b0
parenta52e46f3900fb02fd45423c35d970703978fe6ff (diff)
downloadcurl-ae7a09db20081672242cbf69bb871f3ab1c5a24c.tar.gz
CURLOPT_WRITEFUNCTION.3: spell out that it gets called many times
-rw-r--r--docs/libcurl/opts/CURLOPT_WRITEFUNCTION.38
1 files changed, 5 insertions, 3 deletions
diff --git a/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3 b/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3
index b6cdabf70..11edeb2e9 100644
--- a/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3
+++ b/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3
@@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
-.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
+.\" * Copyright (C) 1998 - 2018, 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
@@ -35,8 +35,10 @@ Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl as soon as there is data
-received that needs to be saved. \fIptr\fP points to the delivered data, and
-the size of that data is \fInmemb\fP; \fIsize\fP is always 1.
+received that needs to be saved. For most transfers, this callback gets called
+many times and each invoke delivers another chunk of data. \fIptr\fP points to
+the delivered data, and the size of that data is \fInmemb\fP; \fIsize\fP is
+always 1.
The callback function will be passed as much data as possible in all invokes,
but you must not make any assumptions. It may be one byte, it may be