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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_RESUME_FROM(3)	   curl_easy_setopt options	CURLOPT_RESUME_FROM(3)

NAME
       CURLOPT_RESUME_FROM - set a point to resume transfer from

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	  curl_easy_setopt(CURL	  *handle,  CURLOPT_RESUME_FROM,  long
       from);

DESCRIPTION
       Pass a long 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
       will then append	the source file	to the remote target file.

       If you need to resume a transfer	beyond the 2GB limit, use  CURLOPT_RE-
       SUME_FROM_LARGE(3) instead.

DEFAULT
       0, not used

PROTOCOLS
       HTTP, FTP, SFTP,	FILE

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 curl_easy_setopt(curl,	CURLOPT_URL, "ftp://example.com");

	 /* resume upload at byte index	200 */
	 curl_easy_setopt(curl,	CURLOPT_RESUME_FROM, 200L);

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

	 /* set	total data amount to expect */
	 curl_easy_setopt(curl,	CURLOPT_INFILESIZE, size_of_file);

	 /* Perform the	request	*/
	 curl_easy_perform(curl);
       }

AVAILABILITY
       Always

RETURN VALUE
       Returns CURLE_OK

SEE ALSO
       CURLOPT_RESUME_FROM_LARGE(3), CURLOPT_RANGE(3), CURLOPT_INFILESIZE(3),

libcurl	7.72.0			March 23, 2020		CURLOPT_RESUME_FROM(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_RESUME_FROM&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help