From: Michael Kaufmann <mail@michael-kaufmann.ch>
Date: Thu, 19 May 2016 22:06:40 +0000 (+0200)
Subject: CURLOPT_CONNECT_TO.3: user must not free the list prematurely
X-Git-Tag: curl-7_49_1~22
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=53ae37088c25099cd538b1ccaab929d3c5f8d9b4;p=curl

CURLOPT_CONNECT_TO.3: user must not free the list prematurely

The connect-to list isn't copied so as long as the handle may be used
for a transfer the list must be valid.

Bug: https://github.com/curl/curl/pull/819
Reported-by: Michael Kaufmann
---

diff --git a/docs/libcurl/opts/CURLOPT_CONNECT_TO.3 b/docs/libcurl/opts/CURLOPT_CONNECT_TO.3
index 8c59cfbd4..302502143 100644
--- a/docs/libcurl/opts/CURLOPT_CONNECT_TO.3
+++ b/docs/libcurl/opts/CURLOPT_CONNECT_TO.3
@@ -75,6 +75,11 @@ port, the HTTP proxy is automatically switched to tunnel mode for this
 specific request. This is necessary because it is not possible to connect to a
 specific host or port in normal (non-tunnel) mode.
 
+When this option is passed to \fIcurl_easy_setopt(3)\fP, libcurl will not copy
+the entire list so you \fBmust\fP keep it around until you no longer use this
+\fIhandle\fP for a transfer before you call \fIcurl_slist_free_all(3)\fP on
+the list.
+
 .SH DEFAULT
 NULL
 .SH PROTOCOLS