Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_IG...TENT_LENGTH(3) Library Functions Manual CURLOPT_IG...TENT_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 re-
     sponse and ignore asking for or relying on it for FTP transfers.

     This is useful for doing HTTP transfers with ancient web servers which  re-
     port 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) {
	 CURLcode result;
	 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);

	 result = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }
     }

HISTORY
     Support for FTP added in 7.46.0.

AVAILABILITY
     Added in curl 7.14.1

RETURN VALUE
     curl_easy_setopt(3) returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3).

SEE ALSO
     CURLOPT_HTTP_VERSION(3), CURLOPT_MAXFILESIZE_LARGE(3)

libcurl 			   2026-06-11	     CURLOPT_IG...TENT_LENGTH(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_IGNORE_CONTENT_LENGTH&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help