CURLOPT_MAXFILESIZE_LARGE(3)

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_FILESIZE_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 transfers.

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.58.0      Last change: May 30, 2017                   1