CURLOPT_APPEND(3)

1CURLOPT_APPEND(3)          curl_easy_setopt options          CURLOPT_APPEND(3)
2
3
4

NAME

6       CURLOPT_APPEND - enable appending to the remote file
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append);
12

DESCRIPTION

14       A  long  parameter  set  to 1 tells the library to append to the remote
15       file instead of overwrite it. This is only useful when uploading to  an
16       FTP site.
17

DEFAULT

19       0 (disabled)
20

PROTOCOLS

22       FTP
23

EXAMPLE

25       CURL *curl = curl_easy_init();
26       if(curl) {
27
28         curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/to/newfile");
29         curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
30         curl_easy_setopt(curl, CURLOPT_APPEND, 1L);
31
32         curl_easy_perform(curl);
33       }
34

AVAILABILITY

36       This option was known as CURLOPT_FTPAPPEND up to 7.16.4
37

RETURN VALUE

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