diff options
author | Daniel Stenberg <daniel@haxx.se> | 2005-07-13 09:37:22 +0000 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2005-07-13 09:37:22 +0000 |
commit | a8a8ae2e92b4c8e824295839408e568c7dc1c6fc (patch) | |
tree | 97a2ee008f9cb709d89f70ada61912eb9234de09 | |
parent | fd1148a72834b0d4fb257909c049b67833088dea (diff) |
elaborate a bit on how to deal with chunked-encoded trailers that now are
passed to the app using the header callback
-rw-r--r-- | docs/libcurl/curl_easy_setopt.3 | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index e7995e55a..d5ad5c673 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -21,7 +21,7 @@ .\" * $Id$ .\" ************************************************************************** .\" -.TH curl_easy_setopt 3 "24 Jun 2005" "libcurl 7.14.1" "libcurl Manual" +.TH curl_easy_setopt 3 "13 Jul 2005" "libcurl 7.14.1" "libcurl Manual" .SH NAME curl_easy_setopt - set options for a curl easy handle .SH SYNOPSIS @@ -180,6 +180,14 @@ you passed to libcurl with the \fICURLOPT_WRITEHEADER\fP option. Return the number of bytes actually written or return -1 to signal error to the library (it will cause it to abort the transfer with a \fICURLE_WRITE_ERROR\fP return code). + +Since 7.14.1: When a server sends a chunked encoded transfer, it may contain a +trailer. That trailer is identical to a HTTP header and if such a trailer is +received it is passed to the application using this callback as well. There +are several ways to detect it being a trailer and not an ordinary header: 1) +it comes after the response-body. 2) it comes after the final header line (CR +LF) 3) a Trailer: header among the response-headers mention what header to +expect in the trailer. .IP CURLOPT_WRITEHEADER Pass a pointer to be used to write the header part of the received data to. If you don't use your own callback to take care of the writing, this must be a |