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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_MAXFILESIZE_LARGE(3curl_easy_setopt optionCURLOPT_MAXFILESIZE_LARGE(3)

NAME
       CURLOPT_MAXFILESIZE_LARGE - maximum file	size allowed to	download

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_setopt(CURL *handle, CURLOPT_MAXFILESIZE_LARGE,
				 curl_off_t size);

DESCRIPTION
       Pass  a curl_off_t 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_FILE-
       SIZE_EXCEEDED 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.

DEFAULT
       None

PROTOCOLS
       FTP and HTTP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 CURLcode ret;
	 curl_off_t ridiculous = 1 << 48;
	 curl_easy_setopt(curl,	CURLOPT_URL, "https://example.com/");
	 /* refuse to download if larger than ridiculous */
	 curl_easy_setopt(curl,	CURLOPT_MAXFILESIZE_LARGE, ridiculous);
	 ret = curl_easy_perform(curl);
       }

AVAILABILITY
       Added in	7.11.0

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

SEE ALSO
       CURLOPT_MAXFILESIZE(3), CURLOPT_MAX_RECV_SPEED_LARGE(3),

libcurl	7.54.1			 May 30, 2017	  CURLOPT_MAXFILESIZE_LARGE(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_LARGE&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help