Imported Upstream version 7.50.2
[platform/upstream/curl.git] / docs / libcurl / opts / CURLINFO_TLS_SSL_PTR.html
index 31c327e..05e7bd7 100644 (file)
@@ -92,9 +92,9 @@ struct curl_tlssessioninfo {
 <p class="level0"><a name="axTLS"></a><span class="nroffip">axTLS</span> 
 <p class="level1">SSL * 
 <p class="level0"><a name="mbedTLS"></a><span class="nroffip">mbedTLS</span> 
-<p class="level1">mbedtls_ssl_session * 
+<p class="level1">mbedtls_ssl_context * 
 <p class="level0"><a name="PolarSSL"></a><span class="nroffip">PolarSSL</span> 
-<p class="level1">ssl_session * 
+<p class="level1">ssl_context * 
 <p class="level0"><a name="Secure"></a><span class="nroffip">Secure Channel (WinSSL)</span> 
 <p class="level1">CtxtHandle * 
 <p class="level0"><a name="Secure"></a><span class="nroffip">Secure Transport (DarwinSSL)</span> 
@@ -102,7 +102,7 @@ struct curl_tlssessioninfo {
 <p class="level0"><a name="WolfSSL"></a><span class="nroffip">WolfSSL (formerly CyaSSL)</span> 
 <p class="level1">SSL * 
 <p class="level0">
-<p class="level0">If the <span Class="emphasis">internals</span> pointer is NULL then either the SSL backend is not supported or an SSL session has not yet been established. <a name="LIMITATIONS"></a><h2 class="nroffsh">LIMITATIONS</h2>
+<p class="level0">If the <span Class="emphasis">internals</span> pointer is NULL then either the SSL backend is not supported, an SSL session has not yet been established or the connection is no longer associated with the easy handle (eg curl_easy_perform has returned). <a name="LIMITATIONS"></a><h2 class="nroffsh">LIMITATIONS</h2>
 <p class="level0"><span class="bold">This option has some limitations that could make it unsafe when it comes to the manual verification of certificates.</span> 
 <p class="level0">This option only retrieves the first in-use SSL session pointer for your easy handle, however your easy handle may have more than one in-use SSL session if using FTP over SSL. That is because the FTP protocol has a control channel and a data channel and one or both may be over SSL. <span class="bold">Currently there is no way to retrieve a second in-use SSL session associated with an easy handle.</span> 
 <p class="level0">This option has not been thoroughly tested with plaintext protocols that can be upgraded/downgraded to/from SSL: FTP, SMTP, POP3, IMAP when used with <a Class="emphasis" href="./CURLOPT_USE_SSL.html">CURLOPT_USE_SSL</a>. Though you will be able to retrieve the SSL pointer, it's possible that before you can do that <span class="bold">data (including auth) may have already been sent over a connection after it was upgraded.</span>