GNURLOPT_POSTQUOTE(3)

💅 GNURLOPT_POSTQUOTE(3) 💅

okay bestie, quick vibe check: this page lives in the curl_easy_setopt options manual, and it's all about CURLOPT_POSTQUOTE. buckle up, it's giving “post-transfer FTP commands” energy 🦋✨

🌸 NAME 🌸

CURLOPT_POSTQUOTE — (S)FTP commands to run after the transfer 💖

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTQUOTE, struct
curl_slist *cmds);

🎀 DESCRIPTION 🎀

So you pass a pointer to a linked list of FTP or SFTP commands, and those get passed to the server after your FTP transfer request. The commands will only be run if no error occurred — like, no error, no after-party 🎉. The linked list should be a fully valid list of struct curl_slist structs properly filled in as described for CURLOPT_QUOTE(3).

Want to turn it off again? Disable this operation by setting a NULL to this option. bye 👋

🍓 DEFAULT 🍓

NULL — iconically empty, and that's the default, periodt 💅

🌈 PROTOCOLS 🌈

SFTP and FTP. that's the whole guest list 🫶

🦋 EXAMPLE 🦋

Here's the example, copied with love and zero edits — code is sacred, fr fr 😌:

       struct curl_slist *cmdlist = NULL;
       cmdlist = curl_slist_append(cmdlist, "RNFR source-name");
       cmdlist = curl_slist_append(cmdlist, "RNTO new-name");

       curl = curl_easy_init();
       if(curl) {
         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);

         ret = curl_easy_perform(curl);

         curl_easy_cleanup(curl);
       }

⭐ AVAILABILITY ⭐

If support for the protocols are built-in. yes, that's the condition, bestie 💫

👑 RETURN VALUE 👑

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. slay if supported, sad little CURLE_UNKNOWN_OPTION if not 😭

🔥 SEE ALSO 🔥

• CURLOPT_QUOTE(3), CURLOPT_PREQUOTE(3), — go click these next, bestie, they're in the same quote-y family 💜

✨ source/version check: libcurl 7.37.0, dated 17 Jun 2014 — mwah, and that's the GNURLOPT_POSTQUOTE(3) tea 💋✨