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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_I...ENT_LENGTH(3)  Library Functions Manual  CURLOPT_I...ENT_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 doing	HTTP transfers with ancient web	servers	 which
       report incorrect	content	length for files over 2	gigabytes. If this op-
       tion  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.

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				  2025-06-03	     CURLOPT_I...ENT_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+14.3.quarterly>

home | help