e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
60 lines
1.0 KiB
Markdown
60 lines
1.0 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_APPEND
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_DIRLISTONLY (3)
|
|
- CURLOPT_RESUME_FROM (3)
|
|
- CURLOPT_UPLOAD (3)
|
|
Protocol:
|
|
- FTP
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_APPEND - append to the remote file
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
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.
|
|
|
|
# DEFAULT
|
|
|
|
0 (disabled)
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
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);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
This option was known as CURLOPT_FTPAPPEND up to 7.16.4
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
|