CURLOPT_NEW_FILE_PERMS(3)

CURLOPT_NEW_FILE_PERMS(3curl_easy_setopt optionCURLOPT_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 per-
     missions that will be assigned to newly created files on the
     remote server.  The default value is  0644,  but  any  valid
     value can be used.  The only protocols that can use this are
     sftp://, scp://, and file://.

DEFAULT

     0644

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/file.txt");
       curl_easy_setopt(curl, CURLOPT_NEW_FILE_PERMS, 0664L);
       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_DIRECTORY_PERMS(3), CURLOPT_UPLOAD(3),

libcurl 7.58.0      Last change: May 31, 2017                   1