diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2006-02-11 22:35:16 +0000 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2006-02-11 22:35:16 +0000 |
| commit | 87bcb6f3775a437579c7526d0972c714c2e5d31d (patch) | |
| tree | e3b1729ce92ff0ab994b7e904f0bca5bd018a060 /docs/libcurl | |
| parent | b0bc2f00d2ef005b6322123799af78528f66b713 (diff) | |
Karl M added the CURLOPT_CONNECT_ONLY and CURLINFO_LASTSOCKET options that
an app can use to let libcurl only connect to a remote host and then extract
the socket from libcurl. libcurl will then not attempt to do any transfer at
all after the connect is done.
Diffstat (limited to 'docs/libcurl')
| -rw-r--r-- | docs/libcurl/curl_easy_getinfo.3 | 6 | ||||
| -rw-r--r-- | docs/libcurl/curl_easy_setopt.3 | 8 |
2 files changed, 14 insertions, 0 deletions
diff --git a/docs/libcurl/curl_easy_getinfo.3 b/docs/libcurl/curl_easy_getinfo.3 index bc4f2063b..2119ea211 100644 --- a/docs/libcurl/curl_easy_getinfo.3 +++ b/docs/libcurl/curl_easy_getinfo.3 @@ -141,6 +141,12 @@ cookies cURL knows (expired ones, too). Don't forget to cookies (cookies for the handle have not been enabled or simply none have been received) 'struct curl_slist *' will be set to point to NULL. (Added in 7.14.1) +.IP CURLINFO_LASTSOCKET +Pass a pointer to a long to receive the last socket used by this curl +session. If the socket is no longer valid, -1 is returned. When you finish +working with the socket, you must call curl_easy_cleanup() as usual and let +libcurl close the socket and cleanup other resources associated with the +handle. (Added in 7.15.2) .SH TIMES .NF An overview of the six time values available from curl_easy_getinfo() diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index 25e7e7707..8a152947c 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -1044,6 +1044,14 @@ Resolve to ipv4 addresses. .IP CURL_IPRESOLVE_V6 Resolve to ipv6 addresses. .RE +.SH CURLOPT_CONNECT_ONLY +Pass a long. A non-zero parameter tells the library to perform any required +proxy authentication and connection setup, but no data transfer. + +This option is useful with the \fICURLINFO_LASTSOCKET\fP option to +\fIcurl_easy_getinfo(3)\fP. 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) .SH SSL and SECURITY OPTIONS .IP CURLOPT_SSLCERT Pass a pointer to a zero terminated string as parameter. The string should be |