From 1fc237371f98672854331e5855de4d9af2586a51 Mon Sep 17 00:00:00 2001 From: David Boddie Date: Mon, 31 Aug 2009 14:05:17 +0200 Subject: Doc: Updated the requirements information about OpenSSL. Task-number: 158631 Reviewed-by: Andreas Aardal Hanssen --- doc/src/getting-started/installation.qdoc | 4 +++- doc/src/network-programming/ssl.qdoc | 26 ++++++++++++++++++++++++++ 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/doc/src/getting-started/installation.qdoc b/doc/src/getting-started/installation.qdoc index ec50060..4fb3792 100644 --- a/doc/src/getting-started/installation.qdoc +++ b/doc/src/getting-started/installation.qdoc @@ -652,7 +652,9 @@ If you are using pre-built binaries, follow the instructions \section1 OpenSSL (version 0.9.7 or later) Support for \l{SSL}{Secure Sockets Layer (SSL)} communication is provided by the - \l{OpenSSL Toolkit}, which must be obtained separately. + \l{OpenSSL Toolkit}, which must be obtained separately. More information about + enabling SSL support can be found in the \l{Secure Sockets Layer (SSL) Classes} + document. \section1 Platform-Specific Requirements diff --git a/doc/src/network-programming/ssl.qdoc b/doc/src/network-programming/ssl.qdoc index 44d4196..e66216a 100644 --- a/doc/src/network-programming/ssl.qdoc +++ b/doc/src/network-programming/ssl.qdoc @@ -54,6 +54,32 @@ See the \l{General Qt Requirements} page for information about the versions of OpenSSL that are known to work with Qt. + \section1 Enabling and Disabling SSL Support + + When building Qt from source, the configuration system checks for the presence + of the \c{openssl/opensslv.h} header provided by source or developer packages + of OpenSSL. + + By default, an SSL-enabled Qt library dynamically loads any installed OpenSSL + library at run-time. However, it is possible to link against the library at + compile-time by configuring Qt with the \c{-openssl-linked} option. + + When building a version of Qt linked against OpenSSL, the build system will + attempt to link with libssl and libcrypt libraries located in the default + location on the developer's system. This location is configurable: + set the \c OPENSSL_LIBS environment variable to contain the linker options + required to link Qt against the installed library. For example, on a Unix/Linux + system: + + \code + ./configure -openssl-linked OPENSSL_LIBS='-L/opt/ssl/lib -lssl -lcrypto' + \endcode + + To disable SSL support in a Qt build, configure Qt with the \c{-no-openssl} + option. + + \section1 Licensing Information + \note Due to import and export restrictions in some parts of the world, we are unable to supply the OpenSSL Toolkit with Qt packages. Developers wishing to use SSL communication in their deployed applications should either ensure -- cgit v0.12