- CURLOPT_FTP_CREATE_MISSING_DIRS can now be set to 2 in addition to 1 for

                                  Changelog

Daniel Stenberg (17 Feb 2009)

- CURLOPT_FTP_CREATE_MISSING_DIRS can now be set to 2 in addition to 1 for

  plain FTP connections, and it will then allow MKD to fail once and retry the

  CWD afterwards. This is especially useful if you're doing many simultanoes

  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! The numbers can

  (should?) now be set with the convenience enums now called

  CURLFTP_CREATE_DIR and CURLFTP_CREATE_DIR_RETRY.

  Tests has proven that if you're making an application that uploads a set of

  files to an ftp server, you will get a noticable gain in speed if you're

  using multiple connections and this option will be then be very useful.

Daniel Stenberg (14 Feb 2009)

- Andre Guibert de Bruet found and fixed a memory leak in the content encoding

  code, which could happen on libz errors.

 o Added docs/libcurl/symbols-in-versions

 o Added CURLINFO_CONDITION_UNMET

 o Added support for Digest and NTLM authentication using GnuTLS

 o CURLOPT_FTP_CREATE_MISSING_DIRS can now be set to 2 to retry the CWD even

   when MKD fails

This release includes the following bugfixes:

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. (Added in 7.16.3)

Starting with 7.19.4, you can also set this value to 2, which will make

libcurl retry the CWD command again if the subsequent MKD command fails. This

is especially useful if you're doing many simultanoes 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! 7.19.4 also introduced the \fICURLFTP_CREATE_DIR\fP and

\fICURLFTP_CREATE_DIR_RETRY\fP enum names for these arguments.

Before version 7.19.4, libcurl will simply ignore arguments set to 2 and act

as if 1 was selected.

.IP CURLOPT_FTP_RESPONSE_TIMEOUT

Pass a long.  Causes curl to set a timeout period (in seconds) on the amount

of time that the server is allowed to take in order to generate a response

  CURLFTPAUTH_LAST /* not an option, never use */

} curl_ftpauth;

/* parameter for the CURLOPT_FTP_CREATE_MISSING_DIRS option */

typedef enum {

  CURLFTP_CREATE_DIR_NONE,  /* do NOT create missing dirs! */

  CURLFTP_CREATE_DIR,       /* (FTP/SFTP) if CWD fails, try MKD and then CWD

                               again if MKD succeeded, for SFTP this does

                               similar magic */

  CURLFTP_CREATE_DIR_RETRY, /* (FTP only) if CWD fails, try MKD and then CWD

                               again even if MKD failed! */

  CURLFTP_CREATE_DIR_LAST   /* not an option, never use */

} curl_ftpcreatedir;

/* parameter for the CURLOPT_FTP_FILEMETHOD option */

typedef enum {

  CURLFTPMETHOD_DEFAULT,   /* let libcurl pick */

     argument */

  CINIT(SSL_CTX_DATA, OBJECTPOINT, 109),

  /* FTP Option that causes missing dirs to be created on the remote server */

  /* FTP Option that causes missing dirs to be created on the remote server.

     In 7.19.4 we introduced the convenience enums for this option using the

     CURLFTP_CREATE_DIR prefix.

  */

  CINIT(FTP_CREATE_MISSING_DIRS, LONG, 110),

  /* Set this to a bitmask value to enable the particular authentications

    /* already done and fine */

    result = ftp_state_post_cwd(conn);

  else {

    ftpc->count2 = 0;

    ftpc->count2 = 0; /* count2 counts failed CWDs */

    /* count3 is set to allow a MKD to fail once. In the case when first CWD

       fails and then MKD fails (due to another session raced it to create the

       dir) this then allows for a second try to CWD to it */

    ftpc->count3 = (conn->data->set.ftp_create_missing_dirs==2)?1:0;

    if(conn->bits.reuse && ftpc->entrypath) {

      /* This is a re-used connection. Since we change directory to where the

         transfer is taking place, we must first get back to the original dir

      break;

    case FTP_MKD:

      if(ftpcode/100 != 2) {

      if((ftpcode/100 != 2) && !ftpc->count3--) {

        /* failure to MKD the dir */

        failf(data, "Failed to MKD dir: %03d", ftpcode);

        return CURLE_REMOTE_ACCESS_DENIED;