2
0
mirror of https://codeberg.org/kiss-community/repo synced 2024-09-11 23:30:13 +00:00
repo/core/curl/files/CURLOPT_POSTQUOTE.3

52 lines
1.4 KiB
Groff
Raw Normal View History

.\" generated by cd2nroff 0.1 from CURLOPT_POSTQUOTE.md
2024-06-01 20:49:19 +00:00
.TH CURLOPT_POSTQUOTE 3 "2024-06-01" libcurl
.SH NAME
CURLOPT_POSTQUOTE \- (S)FTP commands to run after the transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTQUOTE,
struct curl_slist *cmds);
.fi
.SH DESCRIPTION
Pass a pointer to a linked list of FTP or SFTP commands to pass to the server
2024-03-30 18:28:04 +00:00
after your FTP transfer request. The commands are only issued if no error
occur. The linked list should be a fully valid list of struct curl_slist
structs properly filled in as described for \fICURLOPT_QUOTE(3)\fP.
Disable this operation again by setting a NULL to this option.
.SH DEFAULT
NULL
.SH PROTOCOLS
2024-03-30 18:28:04 +00:00
FTP and SFTP
.SH EXAMPLE
.nf
int main(void)
{
struct curl_slist *cmdlist = NULL;
cmdlist = curl_slist_append(cmdlist, "RNFR source-name");
cmdlist = curl_slist_append(cmdlist, "RNTO new-name");
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
/* pass in the FTP commands to run after the transfer */
curl_easy_setopt(curl, CURLOPT_POSTQUOTE, cmdlist);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
}
.fi
.SH AVAILABILITY
If support for the protocols are built\-in.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH SEE ALSO
.BR CURLOPT_PREQUOTE (3),
.BR CURLOPT_QUOTE (3)