aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRodrigo Arias Mallo <rodarima@gmail.com>2024-05-20 21:04:04 +0200
committerRodrigo Arias Mallo <rodarima@gmail.com>2024-05-20 21:23:12 +0200
commit4bf29248f2f5777ea8b310bc84f18d77024a2e03 (patch)
treea3e75a94b5187b24953e183db9fec5de135cb6c8 /doc
parentea2263231abc770d5d87fcdb95fddd80679c5906 (diff)
Add workaround for OpenSSL in Cygwin
Cygwin doesn't seem to support detached threads used by the threaded DNS resolver at the same time the dynamic OpenSSL library is used. As a workaround we suggest disabling the threaded DNS (will use the same thread) if building with OpenSSL on Cygwin. Fixes: https://github.com/dillo-browser/dillo/issues/172
Diffstat (limited to 'doc')
-rw-r--r--doc/install.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/install.md b/doc/install.md
index 344cff01..8823ae7c 100644
--- a/doc/install.md
+++ b/doc/install.md
@@ -166,13 +166,18 @@ $ ./configure LDFLAGS="-L`brew --prefix openssl`/lib" CPPFLAGS="-I`brew --prefix
Dillo can be built for Windows (tested on Windows 11) by using the
[Cygwin](https://www.cygwin.com/) POSIX portability layer and run with Xorg. You
-will need the following dependencies to build Dillo (with mbedTLS):
+will need the following dependencies to build Dillo with mbedTLS:
```
gcc-core gcc-g++ autoconf automake make zlib-devel mbedtls-devel libfltk-devel
libiconv-devel libpng-devel libjpeg-devel
```
+**Note**: Dillo can also be built with OpenSSL (libssl-devel) but there is a
+[known problem with detached threads](https://github.com/dillo-browser/dillo/issues/172)
+used by the DNS resolver and OpenSSL that causes a crash. If you use OpenSSL,
+disable the threaded resolver with `--disable-threaded-dns`.
+
You will also need [Xorg](https://x.cygwin.com/docs/ug/cygwin-x-ug.html) to run
Dillo graphically: