CURLOPT_INFILESIZE_LARGE(3)

CURLOPT_INFILESIZE_LARGE(3curl_easy_setopt optionCURLOPT_INFILESIZE_LARGE(3)

NAME

     CURLOPT_INFILESIZE_LARGE - set size of  the  input  file  to
     send off

SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INFILESIZE_LARGE,
                               curl_off_t filesize);

DESCRIPTION

     When uploading a file to a remote site, filesize  should  be
     used  to  tell  libcurl  what the expected size of the input
     file is. This value must be passed as a curl_off_t.

     For    uploading    using    SCP,     this     option     or
     CURLOPT_INFILESIZE(3) is mandatory.

     To unset this value again, set it to -1.

     When sending emails using SMTP, this command can be used  to
     specify  the  optional SIZE parameter for the MAIL FROM com-
     mand.

     This option does not limit how much data libcurl will  actu-
     ally  send,  as that is controlled entirely by what the read
     callback returns, but telling one value and sending  a  dif-
     ferent amount may lead to errors.

DEFAULT

     Unset

PROTOCOLS

     Many

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_off_t uploadsize = FILE_SIZE;

       curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/destination.tar.gz");

       curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);

       curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, uploadsize);

       curl_easy_perform(curl);
     }

AVAILABILITY

     SMTP support added in 7.23.0

libcurl 7.58.0   Last change: February 03, 2016                 1

CURLOPT_INFILESIZE_LARGE(3curl_easy_setopt optionCURLOPT_INFILESIZE_LARGE(3)

RETURN VALUE

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

SEE ALSO

     CURLOPT_INFILESIZE(3), CURLOPT_UPLOAD(3),

libcurl 7.58.0   Last change: February 03, 2016                 2