Provided by: libcurl4-doc_8.9.1-2ubuntu2.1_all bug

NAME

       CURLOPT_IGNORE_CONTENT_LENGTH - ignore content length

SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IGNORE_CONTENT_LENGTH,
                                 long ignore);

DESCRIPTION

       If  ignore  is set to 1L, ignore the Content-Length header in the HTTP response and ignore
       asking for or relying on it for FTP transfers.

       This is useful for doing HTTP transfers with ancient web servers  which  report  incorrect
       content  length for files over 2 gigabytes. If this option is used, curl cannot accurately
       report progress, and it instead stops the download when the server ends the connection.

       It is also useful with FTP when for example the file is growing while the transfer  is  in
       progress which otherwise unconditionally causes libcurl to report error.

       Only use this option if strictly necessary.

DEFAULT

       0

PROTOCOLS

       This functionality affects ftp and http

EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

           /* we know the server is silly, ignore content-length */
           curl_easy_setopt(curl, CURLOPT_IGNORE_CONTENT_LENGTH, 1L);

           curl_easy_perform(curl);
         }
       }

HISTORY

       Support for FTP added in 7.46.0.

NOTES

       This option is not working for HTTP when libcurl is built to use the hyper backend.

AVAILABILITY

       Added in curl 7.14.1

RETURN VALUE

       Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.

SEE ALSO

       CURLOPT_HTTP_VERSION(3), CURLOPT_MAXFILESIZE_LARGE(3)