CURLOPT_MAXFILESIZE(3)

CURLOPT_MAXFILESIZE(3curl_easy_setopt optionCURLOPT_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_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.

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