[openssl] openssl-3.0 update

matthias.st.pierre at ncp-e.com matthias.st.pierre at ncp-e.com
Thu Sep 30 12:09:00 UTC 2021


The branch openssl-3.0 has been updated
       via  d31e951aa496abbc88770e226ec46d8eb77dedad (commit)
      from  1257c2047455a84956946963bf31cdb7336b3bad (commit)


- Log -----------------------------------------------------------------
commit d31e951aa496abbc88770e226ec46d8eb77dedad
Author: Dr. Matthias St. Pierre <matthias.st.pierre at ncp-e.com>
Date:   Tue Sep 28 16:12:32 2021 +0200

    doc/man3/SSL_set_fd.pod: add note about Windows compiler warning
    
    According to an old stackoverflow thread [1], citing an even older comment by
    Andy Polyakov (1875e6db29, Pull up Win64 support from 0.9.8., 2005-07-05),
    a cast of 'SOCKET' (UINT_PTR) to 'int' does not create a problem, because although
    the documentation [2] claims that the upper limit is INVALID_SOCKET-1 (2^64 - 2),
    in practice the socket() implementation on Windows returns an index into the kernel
    handle table, the size of which is limited to 2^24 [3].
    
    Add this note to the manual page to avoid unnecessary roundtrips to StackOverflow.
    
    [1] https://stackoverflow.com/questions/1953639/is-it-safe-to-cast-socket-to-int-under-win64
    [2] https://docs.microsoft.com/en-us/windows/win32/winsock/socket-data-type-2
    [3] https://docs.microsoft.com/en-us/windows/win32/sysinfo/kernel-objects
    
    Reviewed-by: Paul Dale <pauli at openssl.org>
    (Merged from https://github.com/openssl/openssl/pull/16699)
    
    (cherry picked from commit f8dd5869bca047a23599ac925aace70efcf487ad)

-----------------------------------------------------------------------

Summary of changes:
 doc/man3/SSL_set_fd.pod | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/man3/SSL_set_fd.pod b/doc/man3/SSL_set_fd.pod
index 0b474eb99b..f519630752 100644
--- a/doc/man3/SSL_set_fd.pod
+++ b/doc/man3/SSL_set_fd.pod
@@ -45,6 +45,17 @@ The operation succeeded.
 
 =back
 
+=head1 NOTES
+
+On Windows, a socket handle is a 64-bit data type (UINT_PTR), which leads to a
+compiler warning (conversion from 'SOCKET' to 'int', possible loss of data) when
+passing the socket handle to SSL_set_*fd(). For the time being, this warning can
+safely be ignored, because although the Microsoft documentation claims that the
+upper limit is INVALID_SOCKET-1 (2^64 - 2), in practice the current socket()
+implementation returns an index into the kernel handle table, the size of which
+is limited to 2^24.
+
+
 =head1 SEE ALSO
 
 L<SSL_get_fd(3)>, L<SSL_set_bio(3)>,


More information about the openssl-commits mailing list