manpagez: man pages & more
man CURLOPT_FTP_CREATE_MISSING_DIRS(3)
Home | html | info | man
CURLOPT_FTP_CREATE_MISSING_DIRS(3)



NAME

       CURLOPT_FTP_CREATE_MISSING_DIRS - create missing dirs for FTP and SFTP


SYNOPSIS

       #include <curl/curl.h>

       typedef enum {
         CURLFTP_CREATE_DIR_NONE,
         CURLFTP_CREATE_DIR,
         CURLFTP_CREATE_DIR_RETRY
       } curl_ftpcreatedir;

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_CREATE_MISSING_DIRS,
                                 long create);


DESCRIPTION

       Pass  a  long  telling  libcurl  to  create  the  dir.  If the value is
       CURLFTP_CREATE_DIR (1), libcurl  will  attempt  to  create  any  remote
       directory that it fails to "move" into.

       For FTP requests, that means a CWD command fails. CWD being the command
       that changes working directory.

       For SFTP requests, libcurl will attempt to create the remote  directory
       if  it  can't obtain a handle to the target-location. The creation will
       fail if a file of the same name as  the  directory  to  create  already
       exists or lack of permissions prevents creation.

       Setting  create to CURLFTP_CREATE_DIR_RETRY (2), tells libcurl to retry
       the CWD command again if the subsequent  MKD  command  fails.  This  is
       especially useful if you're doing many simultaneous connections against
       the same server and they all have this option enabled, as then CWD  may
       first  fail but then another connection does MKD before this connection
       and thus MKD fails but trying CWD works!


DEFAULT

       CURLFTP_CREATE_DIR_NONE (0)


PROTOCOLS

       FTP and SFTP


EXAMPLE

       TODO


AVAILABILITY

       Added in 7.10.7. SFTP support added in 7.16.3.  The  retry  option  was
       added in 7.19.4.


RETURN VALUE

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


SEE ALSO

       CURLOPT_FTP_FILEMETHOD(3), CURLOPT_FTP_USE_EPSV(3),



libcurl 7.37.0                    19 Jun CURLOPT_FTP_CREATE_MISSING_DIRS(3)

curl 7.37.1 - Generated Sat Aug 23 15:47:09 CDT 2014
© manpagez.com 2000-2018
Individual documents may contain additional copyright information.