~ubuntu-branches/ubuntu/hardy/curl/hardy-updates

Pass a pointer that will be untouched by libcurl and passed as the 3rd argument in the ioctl callback set with <a class="emphasis" href="#CURLOPTIOCTLFUNCTION">CURLOPT_IOCTLFUNCTION</a>. (Option added in 7.12.3)

<a name="CURLOPTPROGRESSFUNCTION"></a>CURLOPT_PROGRESSFUNCTION

Function pointer that should match the curl_progress_callback prototype found in <curl/curl.h>. This function gets called by libcurl instead of its internal equivalent with a frequent interval during data transfer (roughly once per second). Unknown/unused argument values pass to the callback will be set to zero (like if you only download data, the upload size will remain 0). Returning a non-zero value from this callback will cause libcurl to abort the transfer and return CURLE_ABORTED_BY_CALLBACK.

Function pointer that should match the curl_progress_callback prototype found in <curl/curl.h>. This function gets called by libcurl instead of its internal equivalent with a frequent interval during operation (roughly once per second) no matter if data is being transfered or not. Unknown/unused argument values passed to the callback will be set to zero (like if you only download data, the upload size will remain 0). Returning a non-zero value from this callback will cause libcurl to abort the transfer and return CURLE_ABORTED_BY_CALLBACK.

If you transfer data with the multi interface, this function will not be called during periods of idleness unless you call the appropriate libcurl function that performs transfers. Usage of the <a class="bold" href="#CURLOPTPROGRESSFUNCTION">CURLOPT_PROGRESSFUNCTION</a> callback is not recommended when using the multi interface.

<a class="emphasis" href="#CURLOPTNOPROGRESS">CURLOPT_NOPROGRESS</a> must be set to FALSE to make this function actually get called.

<a name="CURLOPTPROGRESSDATA"></a>CURLOPT_PROGRESSDATA

336

Pass a long. If the value is non-zero, curl will attempt to create any remote directory that it fails to CWD into. CWD is the command that changes working directory. (Added in 7.10.7)

337

<a name="CURLOPTFTPRESPONSETIMEOUT"></a>CURLOPT_FTP_RESPONSE_TIMEOUT

338

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 message for a command before the session is considered hung. While curl is waiting for a response, this value overrides <a class="emphasis" href="#CURLOPTTIMEOUT">CURLOPT_TIMEOUT</a>. It is recommended that if used in conjunction with <a class="emphasis" href="#CURLOPTTIMEOUT">CURLOPT_TIMEOUT</a>, you set <a class="emphasis" href="#CURLOPTFTPRESPONSETIMEOUT">CURLOPT_FTP_RESPONSE_TIMEOUT</a> to a value smaller than <a class="emphasis" href="#CURLOPTTIMEOUT">CURLOPT_TIMEOUT</a>. (Added in 7.10.8)

339

<a name="CURLOPTFTPALTERNATIVETOUSER"></a>CURLOPT_FTP_ALTERNATIVE_TO_USER

340

Pass a char * as parameter, pointing to a string which will be used to authenticate if the usual FTP "USER user" and "PASS password" negotiation fails. This is currently only known to be required when connecting to Tumbleweed's Secure Transport FTPS server using client certificates for authentication. (Added in 7.15.5)

339

341

<a name="CURLOPTFTPSKIPPASVIP"></a>CURLOPT_FTP_SKIP_PASV_IP

340

342

Pass a long. If set to a non-zero value, it instructs libcurl to not use the IP address the server suggests in its 227-response to libcurl's PASV command when libcurl connects the data connection. Instead libcurl will re-use the same IP address it already uses for the control connection. But it will use the port number from the 227-response. (Added in 7.14.2)

341

343

This option has no effect if PORT, EPRT or EPSV is used instead of PASV.

431

433

Pass a long as parameter. It contains the transfer speed in bytes per second that the transfer should be below during <a class="emphasis" href="#CURLOPTLOWSPEEDTIME">CURLOPT_LOW_SPEED_TIME</a> seconds for the library to consider it too slow and abort.

432

434

<a name="CURLOPTLOWSPEEDTIME"></a>CURLOPT_LOW_SPEED_TIME

433

435

Pass a long as parameter. It contains the time in seconds that the transfer should be below the <a class="emphasis" href="#CURLOPTLOWSPEEDLIMIT">CURLOPT_LOW_SPEED_LIMIT</a> for the library to consider it too slow and abort.

436

<a name="CURLOPTMAXSENDSPEEDLARGE"></a>CURLOPT_MAX_SEND_SPEED_LARGE

437

Pass a curl_off_t as parameter. If an upload exceeds this speed on cumulative average during the transfer, the transfer will pause to keep the average rate less than or equal to the parameter value. (default: 0, unlimited)

438

<a name="CURLOPTMAXRECVSPEEDLARGE"></a>CURLOPT_MAX_RECV_SPEED_LARGE

439

434

440

<a name="CURLOPTMAXCONNECTS"></a>CURLOPT_MAXCONNECTS

435

441

Pass a long. The set number will be the persistent connection cache size. The set amount will be the maximum amount of simultaneously open connections that libcurl may cache. Default is 5, and there isn't much point in changing this value unless you are perfectly aware of how this work and changes libcurl's behaviour. This concerns connection using any of the protocols that support persistent connections.

436

442

When reaching the maximum limit, curl uses the <a class="emphasis" href="#CURLOPTCLOSEPOLICY">CURLOPT_CLOSEPOLICY</a> to figure out which of the existing connections to close to prevent the number of open connections to increase.

453

459

Resolve to ipv4 addresses.

454

460

<a name="CURLIPRESOLVEV6"></a>CURL_IPRESOLVE_V6

455

461

Resolve to ipv6 addresses.

456

<a name="CURLOPTCONNECTONLY"></a><h2 class="nroffsh">CURLOPT_CONNECT_ONLY</h2>

457

Pass a long. A non-zero parameter tells the library to perform any required proxy authentication and connection setup, but no data transfer.

458

This option is useful with the CURLINFO_LASTSOCKET option to <a class="emphasis" href="./curl_easy_getinfo.html">curl_easy_getinfo(3)</a>. The library can set up the connection and then the application can obtain the most recently used socket for special data transfers. (Added in 7.15.2) <a name="SSL"></a><h2 class="nroffsh">SSL and SECURITY OPTIONS</h2>

462

463

<a name="CURLOPTCONNECTONLY"></a>CURLOPT_CONNECT_ONLY

464

Pass a long. A non-zero parameter tells the library to perform any required proxy authentication and connection setup, but no data transfer.

465

This option is useful with the CURLINFO_LASTSOCKET option to <a class="emphasis" href="./curl_easy_getinfo.html">curl_easy_getinfo(3)</a>. The library can set up the connection and then the application can obtain the most recently used socket for special data transfers. (Added in 7.15.2) <a name="SSL"></a><h2 class="nroffsh">SSL and SECURITY OPTIONS</h2>

459

466

460

467

<a name="CURLOPTSSLCERT"></a>CURLOPT_SSLCERT

461

468

Pass a pointer to a zero terminated string as parameter. The string should be the file name of your certificate. The default format is "PEM" and can be changed with <a class="emphasis" href="#CURLOPTSSLCERTTYPE">CURLOPT_SSLCERTTYPE</a>.

Older »