CURLOPT_NEW_FILE_PERMS(3)

💅 CURLOPT_NEW_FILE_PERMS ✨

bestie, literally welcome to the CURLOPT_NEW_FILE_PERMS page, straight out of the Library Functions Manual 🎀 ok so pull up a chair, we're talking permissions today and it's gonna be iconic.

---

🌸 NAME 🌸

CURLOPT_NEW_FILE_PERMS — the permissions for files you create remotely, no cap 🔥

---

✨ SYNOPSIS ✨

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NEW_FILE_PERMS,
                          long mode);

---

🦋 DESCRIPTION 🦋

okay so you pass a long as the parameter, and that value is literally the permissions that get set on newly created files on the remote server. that's it, that's the whole vibe 💅

the default value is 0644, which is giving sensible-and-chill.

the only protocols that can use this are sftp://, scp://, and file:// — everyone else can sit this one out, iykyk 🙈

---

🎀 DEFAULT 🎀

0644

---

🌈 PROTOCOLS 🌈

this functionality affects file, scp and sftp 🫶

---

🍓 EXAMPLE 🍓

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "sftp://upload.example.com/file.txt");
    curl_easy_setopt(curl, CURLOPT_NEW_FILE_PERMS, 0664L);
    result = curl_easy_perform(curl);
  }
}

look at her go 😭✨ setting 0664L before the upload, main character energy fr fr.

---

⭐ AVAILABILITY ⭐

added in curl 7.16.4 — vintage but still slaying 👑

---

💜 RETURN VALUE 💜

curl_easy_setopt(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK 🥳 — and non-zero means an error occurred, so go check libcurl-errors(3) to find out what went wrong 💀

---

👑 SEE ALSO 👑

• CURLOPT_NEW_DIRECTORY_PERMS(3)
• CURLOPT_UPLOAD(3)

---

and that's the whole page bestie, go forth and chmod your remote uploads 💖

this has been libcurl, dated 2026-10-12 — CURLOPT_NEW_FILE_PERMS(3), signing off 🧚✨🦋