From: Daniel Stenberg <daniel@haxx.se>
Date: Sat, 6 Aug 2022 22:25:30 +0000 (+0200)
Subject: CURLOPT_CONNECT_ONLY.3: clarify multi API use
X-Git-Tag: curl-7_85_0~106
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=ba670b318c56f185278a5654fa592e294cf8f58f;p=thirdparty%2Fcurl.git

CURLOPT_CONNECT_ONLY.3: clarify multi API use

Reported-by: Maxim Ivanov
Fixes #9244
Closes #9262
---

diff --git a/docs/libcurl/opts/CURLOPT_CONNECT_ONLY.3 b/docs/libcurl/opts/CURLOPT_CONNECT_ONLY.3
index 5f0413f29f..8429e37d90 100644
--- a/docs/libcurl/opts/CURLOPT_CONNECT_ONLY.3
+++ b/docs/libcurl/opts/CURLOPT_CONNECT_ONLY.3
@@ -44,6 +44,12 @@ transfers.
 
 Transfers marked connect only will not reuse any existing connections and
 connections marked connect only will not be allowed to get reused.
+
+If the connect only transfer is done using the multi interface, the particular
+easy handle must remain added to the multi handle for as long as the
+application wants to use it. Once it has been removed with
+\fIcurl_multi_remove_handle(3)\fP, \fIcurl_easy_send(3)\fP and
+\fIcurl_easy_recv(3)\fP do not function.
 .SH DEFAULT
 0
 .SH PROTOCOLS