CURLOPT_APPEND.3: added example

.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2016, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" *

.\" * This software is licensed as described in the file COPYING, which

.\" * you should have received as part of this distribution. The terms

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append);

.SH DESCRIPTION

A parameter set to 1 tells the library to append to the remote file instead of

overwrite it. This is only useful when uploading to an FTP site.

A long parameter set to 1 tells the library to append to the remote file

instead of overwrite it. This is only useful when uploading to an FTP site.

.SH DEFAULT

0

0 (disabled)

.SH PROTOCOLS

FTP

.SH EXAMPLE

TODO

.nf

CURL *curl = curl_easy_init();

if(curl) {

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

  curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);

  curl_easy_setopt(curl, CURLOPT_APPEND, 1L);

  curl_easy_perform(curl);

}

.fi

.SH AVAILABILITY

This option was known as CURLOPT_FTPAPPEND up to 7.16.4

.SH RETURN VALUE

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

.SH "SEE ALSO"

.BR CURLOPT_DIRLISTONLY "(3), " CURLOPT_RESUME_FROM "(3), "

.BR CURLOPT_UPLOAD "(3), "