GNURLOPT_INFILESIZE(3)

GNURLOPT_INFILESIZE(3) 💅

okay bestie, welcome to the GNURLOPT_INFILESIZE(3) page from the curl_easy_setopt options manual — gnurl edition, group-chat style. this is all about telling libcurl how big ur upload is gonna be 🫶✨

💖 NAME 💖

CURLOPT_INFILESIZE — set size of the input file to send off 💅

📜 SYNOPSIS 📜

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INFILESIZE, long
filesize);

🦋 DESCRIPTION 🦋

okay so when ur uploading a file to a remote site, filesize should be used to tell libcurl what the expected size of the input file is. it must be passed as a long, no cap. if ur file is bigger than 2GB, see CURLOPT_INFILESIZE_LARGE(3) — she's the one for the big girlie files 💖

for uploading using SCP, this option or CURLOPT_INFILESIZE_LARGE(3) is mandatory — like, u literally need one of them, bestie.

wanna unset this value again? set it to -1. periodt.

when sending emails using SMTP, this command can be used to specify the optional SIZE parameter for the MAIL FROM command 📧✨

vibe check / important caveat: this option does not limit how much data libcurl will actually send, because that is controlled entirely by what the read callback returns. but telling one value and sending a different amount may lead to errors 😭

🎀 DEFAULT 🎀

Unset — she's just unset 💀

🌈 PROTOCOLS 🌈

Many ✨

💻 EXAMPLE 💻

CURL *curl = curl_easy_init();
if(curl) {
  long uploadsize = FILE_SIZE;

  curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/destination.tar.gz");

  curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);

  curl_easy_setopt(curl, CURLOPT_INFILESIZE, uploadsize);

  curl_easy_perform(curl);
}

⭐ AVAILABILITY ⭐

SMTP support added in 7.23.0 🎉

🔥 RETURN VALUE 🔥

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. that's the tea ☕

👑 SEE ALSO 👑

• CURLOPT_INFILESIZE_LARGE(3)
• CURLOPT_UPLOAD(3)

🎀 xoxo, this page is from libcurl 7.37.0, dated 17 Jun 2014, and it's the GNURLOPT_INFILESIZE(3) manual signing off — mwah 💖