From d1cd5e62ac3f8c0ce6cc8d59057d1d21e52ed22a Mon Sep 17 00:00:00 2001 From: Benjamin Sergeant Date: Sat, 4 Apr 2020 17:54:15 -0700 Subject: [PATCH] update doc --- docs/design.md | 10 +++++++++- docs/usage.md | 2 ++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/design.md b/docs/design.md index 06da968e..4fc728d0 100644 --- a/docs/design.md +++ b/docs/design.md @@ -8,6 +8,8 @@ The per message deflate compression option is supported. It can lead to very nic Connections can be optionally secured and encrypted with TLS/SSL when using a wss:// endpoint, or using normal un-encrypted socket with ws:// endpoints. AppleSSL is used on iOS and macOS, OpenSSL and mbedTLS can be used on Android, Linux and Windows. +If you are using OpenSSL, try to be on a version higher than 1.1.x as there there are thread safety problems with 1.0.x. + ### Polling and background thread work No manual polling to fetch data is required. Data is sent and received instantly by using a background thread for receiving data and the select [system](http://man7.org/linux/man-pages/man2/select.2.html) call to be notified by the OS of incoming data. No timeout is used for select so that the background thread is only woken up when data is available, to optimize battery life. This is also the recommended way of using select according to the select tutorial, section [select law](https://linux.die.net/man/2/select_tut). Read and Writes to the socket are non blocking. Data is sent right away and not enqueued by writing directly to the socket, which is [possible](https://stackoverflow.com/questions/1981372/are-parallel-calls-to-send-recv-on-the-same-socket-valid) since system socket implementations allow concurrent read/writes. However concurrent writes need to be protected with mutex. @@ -26,7 +28,13 @@ The library has an interactive tool which is handy for testing compatibility ith The unittest tries to be comprehensive, and has been running on multiple platforms, with different sanitizers such as a thread sanitizer to catch data races or the undefined behavior sanitizer. -The regression test is running after each commit on travis. +The regression test is running after each commit on github actions for multiple configurations. + +* Linux +* macOS with thread sanitizer +* macOS, with OpenSSL, with thread sanitizer +* macOS, with MbedTLS, with thread sanitizer +* Windows, with MbedTLS (the unittest is not run yet) ## Limitations diff --git a/docs/usage.md b/docs/usage.md index c9d4d564..6daa4507 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -436,6 +436,8 @@ setOnConnectionCallback( To leverage TLS features, the library must be compiled with the option `USE_TLS=1`. +If you are using OpenSSL, try to be on a version higher than 1.1.x as there there are thread safety problems with 1.0.x. + Then, secure sockets are automatically used when connecting to a `wss://*` url. Additional TLS options can be configured by passing a `ix::SocketTLSOptions` instance to the