Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

CURLOPT_IGNORE_CONTENT_LENGTH (3)

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

curl_easy_setopt options                      CURLOPT_IGNORE_CONTENT_LENGTH(3)



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 HTTP with Apache 1.x  (and  similar  servers)  which
       will  report  incorrect  content  length for files over 2 gigabytes. If
       this option is used,  curl  will  not  be  able  to  accurately  report
       progress,  and  will  simply stop 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 will unconditionally cause
       libcurl to report error.

       Only use this option if strictly necessary.

DEFAULT
       0

PROTOCOLS
       HTTP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

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

         curl_easy_perform(curl);
       }

AVAILABILITY
       Added in 7.14.1. Support for FTP added in 7.46.0.

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       CURLOPT_HTTP_VERSION(3), CURLOPT_MAXFILESIZE_LARGE(3),



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded    from    https://github.com/curl/curl/ar-
       chive/curl-7_64_0.zip

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.37.0                    19 Jun 2014
                                              CURLOPT_IGNORE_CONTENT_LENGTH(3)