← Back to branch summary

~ubuntu-branches/ubuntu/vivid/curl/vivid

« back to all changes in this revision

Viewing changes to docs/libcurl/opts/CURLOPT_FTP_CREATE_MISSING_DIRS.html

  • Committer: Package Import Robot
  • Author(s): Gianfranco Costamagna
  • Date: 2014-07-25 12:03:28 UTC
  • mfrom: (3.4.49 sid)
  • Revision ID: package-import@ubuntu.com-20140725120328-pcipulguoki2iabo
Tags: 7.37.1-1ubuntu1
https://launchpad.net/bugs/1348564
* Merge from Debian unstable (LP: #1348564). Remaining changes:
  - Drop dependencies not in main:
    + Build-Depends: Drop stunnel4 and libssh2-1-dev.
    + Drop libssh2-1-dev from binary package Depends.
  - Add new libcurl3-udeb package.
  - Add new curl-udeb package.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/libcurl/opts/CURLOPT_FTP_CREATE_MISSING_DIRS.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 
2
 "http://www.w3.org/TR/html4/loose.dtd">
 
3
<html><head>
 
4
<title>CURLOPT_FTP_CREATE_MISSING_DIRS man page</title>
 
5
<meta name="generator" content="roffit">
 
6
<STYLE type="text/css">
 
7
P.level0 {
 
8
 padding-left: 2em;
 
9
}
 
10
 
 
11
P.level1 {
 
12
 padding-left: 4em;
 
13
}
 
14
 
 
15
P.level2 {
 
16
 padding-left: 6em;
 
17
}
 
18
 
 
19
span.emphasis {
 
20
 font-style: italic;
 
21
}
 
22
 
 
23
span.bold {
 
24
 font-weight: bold;
 
25
}
 
26
 
 
27
span.manpage {
 
28
 font-weight: bold;
 
29
}
 
30
 
 
31
h2.nroffsh {
 
32
 background-color: #e0e0e0;
 
33
}
 
34
 
 
35
span.nroffip {
 
36
 font-weight: bold;
 
37
 font-size: 120%;
 
38
 font-family: monospace;
 
39
}
 
40
 
 
41
p.roffit {
 
42
 text-align: center;
 
43
 font-size: 80%;
 
44
}
 
45
</STYLE>
 
46
</head><body>
 
47
 
 
48
<p class="level0"><a name="NAME"></a><h2 class="nroffsh">NAME</h2>
 
49
<p class="level0">CURLOPT_FTP_CREATE_MISSING_DIRS - create missing dirs for FTP and SFTP <a name="SYNOPSIS"></a><h2 class="nroffsh">SYNOPSIS</h2>
 
50
<p class="level0"><pre>
 
51
<p class="level0">#include &lt;curl/curl.h&gt;
 
52
 <p class="level0">typedef enum {
 
53
 &nbsp; CURLFTP_CREATE_DIR_NONE,
 
54
 &nbsp; CURLFTP_CREATE_DIR,
 
55
 &nbsp; CURLFTP_CREATE_DIR_RETRY
 
56
 } curl_ftpcreatedir;
 
57
 <p class="level0">CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_CREATE_MISSING_DIRS,
 
58
 &nbsp;                         long create);
 
59
 </pre>
 
60
<a name="DESCRIPTION"></a><h2 class="nroffsh">DESCRIPTION</h2>
 
61
<p class="level0">Pass a long telling libcurl to <span Class="emphasis">create</span> the dir. If the value is <span Class="emphasis">CURLFTP_CREATE_DIR</span> (1), libcurl will attempt to create any remote directory that it fails to "move" into. 
 
62
<p class="level0">For FTP requests, that means a CWD command fails. CWD being the command that changes working directory. 
 
63
<p class="level0">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. 
 
64
<p class="level0">Setting <span Class="emphasis">create</span> to <span Class="emphasis">CURLFTP_CREATE_DIR_RETRY</span> (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! <a name="DEFAULT"></a><h2 class="nroffsh">DEFAULT</h2>
 
65
<p class="level0">CURLFTP_CREATE_DIR_NONE (0) <a name="PROTOCOLS"></a><h2 class="nroffsh">PROTOCOLS</h2>
 
66
<p class="level0">FTP and SFTP <a name="EXAMPLE"></a><h2 class="nroffsh">EXAMPLE</h2>
 
67
<p class="level0">TODO <a name="AVAILABILITY"></a><h2 class="nroffsh">AVAILABILITY</h2>
 
68
<p class="level0">Added in 7.10.7. SFTP support added in 7.16.3. The retry option was added in 7.19.4. <a name="RETURN"></a><h2 class="nroffsh">RETURN VALUE</h2>
 
69
<p class="level0">Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if the create value is not. <a name="SEE"></a><h2 class="nroffsh">SEE ALSO</h2>
 
70
<p class="level0"><a Class="manpage" href="./CURLOPT_FTP_FILEMETHOD.html">CURLOPT_FTP_FILEMETHOD</a> <a Class="manpage" href="./CURLOPT_FTP_USE_EPSV.html">CURLOPT_FTP_USE_EPSV</a> <span Class="manpage"> </span> <p class="roffit">
 
71
 This HTML page was made with <a href="http://daniel.haxx.se/projects/roffit/">roffit</a>.
 
72
</body></html>