diff --git a/topics/building/README.md b/topics/building/README.md index 69fe9a89f..fd45b2237 100644 --- a/topics/building/README.md +++ b/topics/building/README.md @@ -27,7 +27,7 @@ The C/C++ driver depends on the following software: * [CMake] v2.8.12+ * [libuv] 1.x * Kerberos v5 ([Heimdal] or [MIT]) \* -* [OpenSSL] v1.0.x or v1.1.x \*\* +* [OpenSSL] v1.0.x, v1.1.x or v3.x \*\* * [zlib] v1.x \*\*\* __\*__ Use the `CASS_USE_KERBEROS` CMake option to enable/disable Kerberos @@ -42,6 +42,13 @@ __\*\*\*__ Use the `CASS_USE_ZLIB` CMake option to enable/disable zlib support. Disabling this option will disable DataStax Astra support within the driver; defaults to `On`. +### A Brief Note on OpenSSL 3.x + +Migrating from OpenSSL 1.1.x to 3.x largely involves avoiding the use of many functions which are now deprecated (consult +the [migration guide] for details). The driver does not use any of these functions so we expect the transition to OpenSSL +3.x to be relatively painless. Note that two officially supported platforms (Ubuntu 22.04 and Rocky Linux 9.2) come with +OpenSSL 3.x by default and the unit and integration tests all pass on these platforms. + ## Linux/Mac OS The driver is known to build on CentOS/RHEL 6/7/8, Mac OS X 10.10/10.11 (Yosemite @@ -335,3 +342,4 @@ cmake -G "Visual Studio 16 2019" -A x64 -DCASS_BUILD_UNIT_TESTS=On .. [MIT]: https://web.mit.edu/kerberos [OpenSSL]: https://www.openssl.org [zlib]: https://www.zlib.net +[migration guide]: https://www.openssl.org/docs/man3.0/man7/migration_guide.html \ No newline at end of file