.\" generated by cd2nroff 0.1 from CURLOPT_NEW_DIRECTORY_PERMS.md .TH CURLOPT_NEW_DIRECTORY_PERMS 3 "2025-02-13" libcurl .SH NAME CURLOPT_NEW_DIRECTORY_PERMS \- permissions for remotely created directories .SH SYNOPSIS .nf #include CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NEW_DIRECTORY_PERMS, long mode); .fi .SH DESCRIPTION Pass a long as a parameter, containing the value of the permissions that is set on newly created directories on the remote server. The default value is \fI0755\fP, but any valid value can be used. The only protocols that can use this are \fIsftp://\fP, \fIscp://\fP, and \fIfile://\fP. .SH DEFAULT 0755 .SH PROTOCOLS This functionality affects file, scp and sftp .SH EXAMPLE .nf int main(void) { CURL *curl = curl_easy_init(); if(curl) { CURLcode ret; curl_easy_setopt(curl, CURLOPT_URL, "sftp://upload.example.com/newdir/file.zip"); curl_easy_setopt(curl, CURLOPT_FTP_CREATE_MISSING_DIRS, 1L); curl_easy_setopt(curl, CURLOPT_NEW_DIRECTORY_PERMS, 0644L); ret = curl_easy_perform(curl); } } .fi .SH AVAILABILITY Added in curl 7.16.4 .SH RETURN VALUE \fIcurl_easy_setopt(3)\fP returns a CURLcode indicating success or error. CURLE_OK (0) means everything was OK, non\-zero means an error occurred, see \fIlibcurl\-errors(3)\fP. .SH SEE ALSO .BR CURLOPT_FTP_CREATE_MISSING_DIRS (3), .BR CURLOPT_NEW_FILE_PERMS (3), .BR CURLOPT_UPLOAD (3)