deploy openssl/openssl@4e50a83 to 3.4

Author: openssl-machine

3.4/man3/SSL_CIPHER_get_name/index.html

@@ -25,7 +25,7 @@
 int SSL_CIPHER_is_aead(const SSL_CIPHER *c);
 const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr);
 uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *c);
-uint32_t SSL_CIPHER_get_protocol_id(const SSL_CIPHER *c);
+uint16_t SSL_CIPHER_get_protocol_id(const SSL_CIPHER *c);
 </code></pre></div><h2 id=description>DESCRIPTION<a class=headerlink href=#description title="Permanent link">&para;</a></h2><p>SSL_CIPHER_get_name() returns a pointer to the name of <strong>cipher</strong>. If the <strong>cipher</strong> is NULL, it returns &quot;(NONE)&quot;.</p><p>SSL_CIPHER_standard_name() returns a pointer to the standard RFC name of <strong>cipher</strong>. If the <strong>cipher</strong> is NULL, it returns &quot;(NONE)&quot;. If the <strong>cipher</strong> has no standard name, it returns <strong>NULL</strong>. If <strong>cipher</strong> was defined in both SSLv3 and TLS, it returns the TLS name.</p><p>OPENSSL_cipher_name() returns a pointer to the OpenSSL name of <strong>stdname</strong>. If the <strong>stdname</strong> is NULL, or <strong>stdname</strong> has no corresponding OpenSSL name, it returns &quot;(NONE)&quot;. Where both exist, <strong>stdname</strong> should be the TLS name rather than the SSLv3 name.</p><p>SSL_CIPHER_get_bits() returns the number of secret bits used for <strong>cipher</strong>. If <strong>cipher</strong> is NULL, 0 is returned.</p><p>SSL_CIPHER_get_version() returns string which indicates the SSL/TLS protocol version that first defined the cipher. It returns &quot;(NONE)&quot; if <strong>cipher</strong> is NULL.</p><p>SSL_CIPHER_get_cipher_nid() returns the cipher NID corresponding to <strong>c</strong>. If there is no cipher (e.g. for cipher suites with no encryption) then <strong>NID_undef</strong> is returned.</p><p>SSL_CIPHER_get_digest_nid() returns the digest NID corresponding to the MAC used by <strong>c</strong> during record encryption/decryption. If there is no digest (e.g. for AEAD cipher suites) then <strong>NID_undef</strong> is returned.</p><p>SSL_CIPHER_get_handshake_digest() returns an EVP_MD for the digest used during the SSL/TLS handshake when using the SSL_CIPHER <strong>c</strong>. Note that this may be different to the digest used to calculate the MAC for encrypted records.</p><p>SSL_CIPHER_get_kx_nid() returns the key exchange NID corresponding to the method used by <strong>c</strong>. If there is no key exchange, then <strong>NID_undef</strong> is returned. If any appropriate key exchange algorithm can be used (as in the case of TLS 1.3 cipher suites) <strong>NID_kx_any</strong> is returned. Examples (not comprehensive):</p><div class=highlight><pre><span></span><code>NID_kx_rsa
 NID_kx_ecdhe
 NID_kx_dhe

3.4/man3/SSL_SESSION_get0_hostname/index.html

@@ -19,4 +19,4 @@
                                     size_t *len);
 int SSL_SESSION_set1_alpn_selected(SSL_SESSION *s, const unsigned char *alpn,
                                    size_t len);
-</code></pre></div><h2 id=description>DESCRIPTION<a class=headerlink href=#description title="Permanent link">&para;</a></h2><p>SSL_SESSION_get0_hostname() retrieves the SNI value that was sent by the client when the session was created if it was accepted by the server. Otherwise NULL is returned.</p><p>The value returned is a pointer to memory maintained within <strong>s</strong> and should not be free&#39;d.</p><p>SSL_SESSION_set1_hostname() sets the SNI value for the hostname to a copy of the string provided in hostname.</p><p>SSL_SESSION_get0_alpn_selected() retrieves the selected ALPN protocol for this session and its associated length in bytes. The returned value of <strong>*alpn</strong> is a pointer to memory maintained within <strong>s</strong> and should not be free&#39;d.</p><p>SSL_SESSION_set1_alpn_selected() sets the ALPN protocol for this session to the value in <strong>alpn</strong> which should be of length <strong>len</strong> bytes. A copy of the input value is made, and the caller retains ownership of the memory pointed to by <strong>alpn</strong>.</p><h2 id=return-values>RETURN VALUES<a class=headerlink href=#return-values title="Permanent link">&para;</a></h2><p>SSL_SESSION_get0_hostname() returns either a string or NULL based on if there is the SNI value sent by client.</p><p>SSL_SESSION_set1_hostname() returns 1 on success or 0 on error.</p><p>SSL_SESSION_set1_alpn_selected() returns 1 on success or 0 on error.</p><h2 id=see-also>SEE ALSO<a class=headerlink href=#see-also title="Permanent link">&para;</a></h2><p><a href=../../man7/ossl-guide-libssl-introduction/ >ssl(7)</a>, <a href=../d2i_SSL_SESSION/ >d2i_SSL_SESSION(3)</a>, <a href=../SSL_SESSION_get_time/ >SSL_SESSION_get_time(3)</a>, <a href=../SSL_SESSION_free/ >SSL_SESSION_free(3)</a></p><h2 id=history>HISTORY<a class=headerlink href=#history title="Permanent link">&para;</a></h2><p>The SSL_SESSION_set1_hostname(), SSL_SESSION_get0_alpn_selected() and SSL_SESSION_set1_alpn_selected() functions were added in OpenSSL 1.1.1.</p><h2 id=copyright>COPYRIGHT<a class=headerlink href=#copyright title="Permanent link">&para;</a></h2><p>Copyright 2016-2025 The OpenSSL Project Authors. All Rights Reserved.</p><p>Licensed under the Apache License 2.0 (the &quot;License&quot;). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <a href=https://www.openssl.org/source/license.html>https://www.openssl.org/source/license.html</a>.</p></article></div><script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script></div></main><footer class=md-footer><div class="md-footer-meta md-typeset"><div class="md-footer-meta__inner md-grid"><div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a></div></div></div></footer></div><div class=md-dialog data-md-component=dialog><div class="md-dialog__inner md-typeset"></div></div><script id=__config type=application/json>{"base": "../..", "features": ["navigation.indexes", "navigation.instant", "navigation.path", "navigation.prune", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "master", "provider": "mike"}}</script><script src=../../assets/javascripts/bundle.ad660dcc.min.js></script></body></html>
+</code></pre></div><h2 id=description>DESCRIPTION<a class=headerlink href=#description title="Permanent link">&para;</a></h2><p>SSL_SESSION_get0_hostname() retrieves the Server Name Indication (SNI) value that was sent by the client when the session was created if the server acknowledged the client&#39;s SNI extension by including an empty SNI extension in response. Otherwise NULL is returned.</p><p>The value returned is a pointer to memory maintained within <strong>s</strong> and should not be free&#39;d.</p><p>SSL_SESSION_set1_hostname() sets the SNI value for the hostname to a copy of the string provided in hostname.</p><p>SSL_SESSION_get0_alpn_selected() retrieves the selected ALPN protocol for this session and its associated length in bytes. The returned value of <strong>*alpn</strong> is a pointer to memory maintained within <strong>s</strong> and should not be free&#39;d.</p><p>SSL_SESSION_set1_alpn_selected() sets the ALPN protocol for this session to the value in <strong>alpn</strong> which should be of length <strong>len</strong> bytes. A copy of the input value is made, and the caller retains ownership of the memory pointed to by <strong>alpn</strong>.</p><h2 id=return-values>RETURN VALUES<a class=headerlink href=#return-values title="Permanent link">&para;</a></h2><p>SSL_SESSION_get0_hostname() returns the SNI string if available, or NULL if not.</p><p>SSL_SESSION_set1_hostname() returns 1 on success or 0 on error.</p><p>SSL_SESSION_set1_alpn_selected() returns 1 on success or 0 on error.</p><h2 id=see-also>SEE ALSO<a class=headerlink href=#see-also title="Permanent link">&para;</a></h2><p><a href=../../man7/ossl-guide-libssl-introduction/ >ssl(7)</a>, <a href=../d2i_SSL_SESSION/ >d2i_SSL_SESSION(3)</a>, <a href=../SSL_SESSION_get_time/ >SSL_SESSION_get_time(3)</a>, <a href=../SSL_SESSION_free/ >SSL_SESSION_free(3)</a></p><h2 id=history>HISTORY<a class=headerlink href=#history title="Permanent link">&para;</a></h2><p>The SSL_SESSION_set1_hostname(), SSL_SESSION_get0_alpn_selected() and SSL_SESSION_set1_alpn_selected() functions were added in OpenSSL 1.1.1.</p><h2 id=copyright>COPYRIGHT<a class=headerlink href=#copyright title="Permanent link">&para;</a></h2><p>Copyright 2016-2025 The OpenSSL Project Authors. All Rights Reserved.</p><p>Licensed under the Apache License 2.0 (the &quot;License&quot;). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <a href=https://www.openssl.org/source/license.html>https://www.openssl.org/source/license.html</a>.</p></article></div><script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script></div></main><footer class=md-footer><div class="md-footer-meta md-typeset"><div class="md-footer-meta__inner md-grid"><div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a></div></div></div></footer></div><div class=md-dialog data-md-component=dialog><div class="md-dialog__inner md-typeset"></div></div><script id=__config type=application/json>{"base": "../..", "features": ["navigation.indexes", "navigation.instant", "navigation.path", "navigation.prune", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "master", "provider": "mike"}}</script><script src=../../assets/javascripts/bundle.ad660dcc.min.js></script></body></html>