CURLOPT_POSTQUOTE(3)

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

NAME

6       CURLOPT_POSTQUOTE - (S)FTP commands to run after the transfer
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode   curl_easy_setopt(CURL   *handle,  CURLOPT_POSTQUOTE,  struct
12       curl_slist *cmds);
13

DESCRIPTION

15       Pass a pointer to a linked list of FTP or SFTP commands to pass to  the
16       server  after  your FTP transfer request. The commands will only be run
17       if no error occurred. The linked list should be a fully valid  list  of
18       struct  curl_slist  structs  properly  filled  in as described for CUR‐
19       LOPT_QUOTE(3).
20
21       Disable this operation again by setting a NULL to this option.
22

DEFAULT

24       NULL
25

PROTOCOLS

27       SFTP and FTP
28

EXAMPLE

30       struct curl_slist *cmdlist = NULL;
31       cmdlist = curl_slist_append(cmdlist, "RNFR source-name");
32       cmdlist = curl_slist_append(cmdlist, "RNTO new-name");
33
34       curl = curl_easy_init();
35       if(curl) {
36         curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
37
38         /* pass in the FTP commands to run after the transfer */
39         curl_easy_setopt(curl, CURLOPT_POSTQUOTE, cmdlist);
40
41         ret = curl_easy_perform(curl);
42
43         curl_easy_cleanup(curl);
44       }
45

AVAILABILITY

47       If support for the protocols are built-in.
48

RETURN VALUE

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