Skip to content

Commit 2f08597

Browse files
committed
add rand engine override doc
1 parent 6bbc2ae commit 2f08597

File tree

2 files changed

+10
-1
lines changed

2 files changed

+10
-1
lines changed

docs/OpenSSLRand.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# OpenSSL RAND Engine override and S2N
2+
3+
One of our dependencies [s2n](https://github.com/aws/s2n-tls) overrides the openssl RAND engine, For reasons elaborated on in [their documentation](https://github.com/aws/s2n-tls/blob/main/docs/BUILD.md#rand-engine-override). this functionally means that `RAND_poll` is not implemented on the override and using the function after initializing the SDK will result in error. You can disable this behavior completely by specifying
4+
5+
`-DS2N_OVERRIDE_LIBCRYPTO_RAND_ENGINE=OFF`
6+
7+
as part of the SDK build. This will continue to use the RAND Engine from the detected OpenSSL dependency.
8+

docs/README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,5 @@ Here you can find some helpful information on usage of the SDK.
1010
* [Memory Management](./Memory_Management.md)
1111
* [Advanced Topics](./Advanced_topics.md)
1212
* [Coding Standards](./CODING_STANDARDS.md)
13-
* [Add as CMake external project](./CMake_External_Project.md)
13+
* [Add as CMake external project](./CMake_External_Project.md)
14+
* [OpenSSL RAND Engine override and S2N](./OpenSSLRand.md)

0 commit comments

Comments
 (0)