FreeBSD Manual Pages
CURLOPT_NEW_FILE_PERMS(3) Library Functions Manual CURLOPT_NEW_FILE_PERMS(3) NAME CURLOPT_NEW_FILE_PERMS - permissions for remotely created files SYNOPSIS #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NEW_FILE_PERMS, long mode); DESCRIPTION Pass a long as a parameter, containing the value of the permissions that are set on newly created files on the remote server. The default value is 0644. The only protocols that can use this are sftp://, scp://, and file://. 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); } } AVAILABILITY Added in curl 7.16.4 RETURN VALUE curl_easy_setopt(3) returns a CURLcode indicating success or error. CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3). SEE ALSO CURLOPT_NEW_DIRECTORY_PERMS(3), CURLOPT_UPLOAD(3) libcurl 2026-06-11 CURLOPT_NEW_FILE_PERMS(3)
NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_NEW_FILE_PERMS&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>