diff options
Diffstat (limited to 'docs/libcurl/opts/CURLOPT_HEADERFUNCTION.3')
-rw-r--r-- | docs/libcurl/opts/CURLOPT_HEADERFUNCTION.3 | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.3 b/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.3 index 94d4ed7b..433f99fc 100644 --- a/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.3 +++ b/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.3 @@ -20,7 +20,7 @@ .\" * .\" ************************************************************************** .\" -.TH CURLOPT_HEADERFUNCTION 3 "April 17, 2018" "libcurl 7.61.0" "curl_easy_setopt options" +.TH CURLOPT_HEADERFUNCTION 3 "August 11, 2018" "libcurl 7.61.1" "curl_easy_setopt options" .SH NAME CURLOPT_HEADERFUNCTION \- callback that receives header data @@ -42,12 +42,15 @@ data. The header callback will be called once for each header and only complete header lines are passed on to the callback. Parsing headers is very easy using this. The size of the data pointed to by \fIbuffer\fP is \fIsize\fP multiplied with \fInmemb\fP. Do not assume that the header line is zero -terminated! The pointer named \fIuserdata\fP is the one you set with the -\fICURLOPT_HEADERDATA(3)\fP option. This callback function must return the -number of bytes actually taken care of. If that amount differs from the amount -passed in to your function, it'll signal an error to the library. This will -cause the transfer to get aborted and the libcurl function in progress will -return \fICURLE_WRITE_ERROR\fP. +terminated! + +The pointer named \fIuserdata\fP is the one you set with the +\fICURLOPT_HEADERDATA(3)\fP option. + +This callback function must return the number of bytes actually taken care of. +If that amount differs from the amount passed in to your function, it'll signal +an error to the library. This will cause the transfer to get aborted and the +libcurl function in progress will return \fICURLE_WRITE_ERROR\fP. A complete HTTP header that is passed to this function can be up to \fICURL_MAX_HTTP_HEADER\fP (100K) bytes. |