Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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, "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);
       }

AVAILABILITY
       Added in 7.14.1. Support for FTP added in 7.46.0. This  option  is  not
       working for HTTP when libcurl is built to use the hyper backend.

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
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source      was      downloaded       from        https://curl.se/down-
       load/curl-7.83.1.tar.bz2.

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



libcurl 7.83.1                  August 23, 2021
                                              CURLOPT_IGNORE_CONTENT_LENGTH(3)