GNURLOPT_APPEND(3)

💖 NAME 💖

Okay bestie, welcome to the GNURLOPT_APPEND(3) page — it's one of the curl_easy_setopt options manual pages, and today's main character is CURLOPT_APPEND: enable appending to the remote file. Not me being obsessed with FTP uploads, but here we are 💅.

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append);

🦋 DESCRIPTION 🦋

Lowkey simple: you pass a long parameter set to 1, and that tells the library to append to the remote file instead of overwrite it. The way that this is only useful when uploading to an FTP site? Fr fr, that's the whole vibe.

🎀 DEFAULT 🎀

0 (disabled) — so by default the append behavior is not on, no cap.

🌈 PROTOCOLS 🌈

The one and only protocol here is FTP.

🍓 EXAMPLE 🍓

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 — so if you're time-traveling through curl history, iykyk.

💜 RETURN VALUE 💜

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Periodt.

🔥 SEE ALSO 🔥

• CURLOPT_DIRLISTONLY(3)
• CURLOPT_RESUME_FROM(3)
• CURLOPT_UPLOAD(3)

Signed off with the very cute combo of libcurl 7.37.0 and the date 17 Jun 2014 — this GNURLOPT_APPEND(3) page ate and left no crumbs 🫶✨