DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_NEW_DIRECTORY_PERMS(3)





CURLOPT_NEW_DIRECTORY_PERMS(3curl_easy_setopt optionCURLOPT_NEW_DIRECTORY_PERMS(3)



NAME

     CURLOPT_NEW_DIRECTORY_PERMS  -  permissions   for   remotely
     created directories


SYNOPSIS

     #include <curl/curl.h>

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


DESCRIPTION

     Pass a long as a parameter, containing the value of the per-
     missions  that will be assigned to newly created directories
     on the remote server.  The default value is  0755,  but  any
     valid  value  can  be used.  The only protocols that can use
     this are sftp://, scp://, and file://.


DEFAULT

     0755


PROTOCOLS

     SFTP, SCP and FILE


EXAMPLE

     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);
     }


AVAILABILITY

     Added in 7.16.4


RETURN VALUE

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


SEE ALSO

     CURLOPT_NEW_FILE_PERMS(3), CURLOPT_UPLOAD(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html