Commit 87bcb6f3 authored by Daniel Stenberg's avatar Daniel Stenberg
Browse files

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.
parent b0bc2f00
Loading
Loading
Loading
Loading
+5 −0
Original line number Diff line number Diff line
@@ -7,6 +7,11 @@
                                  Changelog

Daniel (11 February 2006)
- 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.

- Kent Boortz improved the configure check for GnuTLS to properly set LIBS
  instead of LDFLAGS.

+8 −7
Original line number Diff line number Diff line
@@ -2,21 +2,22 @@ Curl and libcurl 7.15.2

 Public curl release number:               92
 Releases counted from the very beginning: 119
 Available command line options:           109
 Available curl_easy_setopt() options:     125
 Available command line options:           111
 Available curl_easy_setopt() options:     129
 Number of public functions in libcurl:    46
 Amount of public web site mirrors:        30
 Amount of public web site mirrors:        31
 Number of known libcurl bindings:         32
 Number of contributors:                   474

This release includes the following changes:

 o CURLOPT_CONNECT_ONLY and CURLINFO_LASTSOCKET added
 o CURLOPT_LOCALPORT and CURLOPT_LOCALPORTRANGE (--local-port) added
 o Dropped support for the LPRT ftp command
 o Gopher is now officially abandoned as a protocol (lib)curl tries to support.
 o Gopher is now officially abandoned as a protocol (lib)curl tries to support
 o curl_global_init() and curl_global_cleanup() are now using a refcount so
   that it is now legal to call them multiple times. See updated info for
   details.
   details

This release includes the following bugfixes:

@@ -60,7 +61,7 @@ advice from friends like these:

 Dov Murik, Jean Jacques Drouin, Andres Garcia, Yang Tse, Gisle Vanem, Dan
 Fandrich, Alexander Lazic, Michael Jahn, Andrew Benham, Bryan Henderson,
 David Shaw, Jon Turner, Duane Cathey, Michal Marek, Philippe Vaucher,
 Kent Boortz
 David Shaw, Jon Turner, Duane Cathey, Michal Marek, Philippe Vaucher, Kent
 Boortz, Karl M
 
        Thanks! (and sorry if I forgot to mention someone)
+6 −0
Original line number Diff line number Diff line
@@ -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()
+8 −0
Original line number Diff line number Diff line
@@ -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
+6 −1
Original line number Diff line number Diff line
@@ -923,6 +923,10 @@ typedef enum {
  */
  CINIT(LOCALPORTRANGE, LONG, 140),

  /* no transfer, set up connection and let application use the socket by
     extracting it with CURLINFO_LASTSOCKET */
  CINIT(CONNECT_ONLY, LONG, 141),

  CURLOPT_LASTENTRY /* the last unused */
} CURLoption;

@@ -1277,9 +1281,10 @@ typedef enum {
  CURLINFO_NUM_CONNECTS     = CURLINFO_LONG   + 26,
  CURLINFO_SSL_ENGINES      = CURLINFO_SLIST  + 27,
  CURLINFO_COOKIELIST       = CURLINFO_SLIST  + 28,
  CURLINFO_LASTSOCKET       = CURLINFO_LONG   + 29,
  /* Fill in new entries below here! */

  CURLINFO_LASTONE          = 28
  CURLINFO_LASTONE          = 29
} CURLINFO;

/* CURLINFO_RESPONSE_CODE is the new name for the option previously known as
Loading