CURLOPT_FTP_CREATE_MISSING_DIRS(3) on macos

Usage

CURLFTP_CREATE_DIR_RETRY

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_CREATE_MISSING_DIRS,

long create);

Overview

Pass a long telling libcurl to create the dir. If the value is CURLFTP_CREATE_DIR (1), libcurl may 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 may create the remote directory if it cannot obtain a handle to the target-location. The creation fails 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 are 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

Examples

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    curl_easy_setopt(curl, CURLOPT_URL,
                     "ftp://example.com/non-existing/new.txt");
    curl_easy_setopt(curl, CURLOPT_FTP_CREATE_MISSING_DIRS,
                     (long)CURLFTP_CREATE_DIR_RETRY);
    res = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

Return value

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

History

macOS 26.5 to macOS 14.5: the text shown here
macOS 14.4 to macOS 14.2
macOS 14.1 to macOS 13.5
macOS 13.4
macOS 13.3
macOS 13.2
macOS 13.1
macOS 13.0
macOS 12.5 to macOS 12.3
macOS 12.2 to macOS 12.0.1
macOS 11.5 to macOS 10.15
macOS 10.14.6 to macOS 10.12.6
macOS 10.12.5 to macOS 10.12
OS X 10.11.6 to OS X 10.10