CURLOPT_APPEND.3: added example

This commit is contained in:
Daniel Stenberg 2016-03-06 23:28:35 +01:00
parent 4ce153c62c
commit c13a54a2fb
1 changed files with 16 additions and 5 deletions

View File

@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * 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 .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@ -28,17 +28,28 @@ CURLOPT_APPEND \- enable appending to the remote file
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append);
.SH DESCRIPTION .SH DESCRIPTION
A parameter set to 1 tells the library to append to the remote file instead of A long parameter set to 1 tells the library to append to the remote file
overwrite it. This is only useful when uploading to an FTP site. instead of overwrite it. This is only useful when uploading to an FTP site.
.SH DEFAULT .SH DEFAULT
0 0 (disabled)
.SH PROTOCOLS .SH PROTOCOLS
FTP FTP
.SH EXAMPLE .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 .SH AVAILABILITY
This option was known as CURLOPT_FTPAPPEND up to 7.16.4 This option was known as CURLOPT_FTPAPPEND up to 7.16.4
.SH RETURN VALUE .SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR CURLOPT_DIRLISTONLY "(3), " CURLOPT_RESUME_FROM "(3), " .BR CURLOPT_DIRLISTONLY "(3), " CURLOPT_RESUME_FROM "(3), "
.BR CURLOPT_UPLOAD "(3), "