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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_RE..._FROM_LARGE(3) Library Functions Manual CURLOPT_RE..._FROM_LARGE(3)

NAME
     CURLOPT_RESUME_FROM_LARGE - offset to resume transfer from

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RESUME_FROM_LARGE,
			       curl_off_t from);

DESCRIPTION
     Pass  a  curl_off_t as parameter. It contains the offset in number of bytes
     that you want the transfer to start from. Set this option to 0 to make  the
     transfer  start from the beginning (effectively disabling resume). For FTP,
     set this option to -1 to make the transfer start from the end of the target
     file (useful to continue an interrupted upload).

     When doing uploads with FTP, the  resume  position  is  where  in	the  lo-
     cal/source file libcurl should try to resume the upload from and it appends
     the source file to the remote target file.

DEFAULT
     0, not used

PROTOCOLS
     This functionality affects all supported protocols

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_off_t resume_position = 1234; /* get it somehow */
	 curl_off_t file_size = 9876; /* get it somehow as well */

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

	 /* resuming upload at this position, possibly beyond 2GB */
	 curl_easy_setopt(curl, CURLOPT_RESUME_FROM_LARGE, resume_position);

	 /* ask for upload */
	 curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);

	 /* set total data amount to expect */
	 curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, file_size);

	 /* Perform the request */
	 result = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }
     }

AVAILABILITY
     Added in curl 7.11.0

RETURN VALUE
     curl_easy_setopt(3) returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3).

SEE ALSO
     CURLOPT_INFILESIZE_LARGE(3), CURLOPT_RANGE(3), CURLOPT_RESUME_FROM(3)

libcurl 			   2026-06-11	     CURLOPT_RE..._FROM_LARGE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_RESUME_FROM_LARGE&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help