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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_MAXFILESIZE(3)	   curl_easy_setopt options	CURLOPT_MAXFILESIZE(3)

NAME
       CURLOPT_MAXFILESIZE - maximum file size allowed to download

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	  curl_easy_setopt(CURL	  *handle,  CURLOPT_MAXFILESIZE,  long
       size);

DESCRIPTION
       Pass a long as parameter. This allows you to specify the	 maximum  size
       (in bytes) of a file to download. If the	file requested is found	larger
       than this value,	the transfer will  not	start  and  CURLE_FILESIZE_EX-
       CEEDED will be returned.

       The file	size is	not always known prior to download, and	for such files
       this option has no effect even if  the  file  transfer  ends  up	 being
       larger  than  this  given limit.	This concerns both FTP and HTTP	trans-
       fers.

       If you want a limit above 2GB, use CURLOPT_MAXFILESIZE_LARGE(3).

DEFAULT
       None

PROTOCOLS
       FTP and HTTP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 CURLcode ret;
	 curl_easy_setopt(curl,	CURLOPT_URL, "https://example.com/");
	 /* refuse to download if larger than 1000 bytes! */
	 curl_easy_setopt(curl,	CURLOPT_MAXFILESIZE, 1000L);
	 ret = curl_easy_perform(curl);
       }

AVAILABILITY
       Always

RETURN VALUE
       Returns CURLE_OK

SEE ALSO
       CURLOPT_MAXFILESIZE_LARGE(3), CURLOPT_MAX_RECV_SPEED_LARGE(3),

libcurl	7.54.1			 May 30, 2017		CURLOPT_MAXFILESIZE(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_MAXFILESIZE&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help