summaryrefslogtreecommitdiff
path: root/doc/cha-gtls-app.texi
diff options
context:
space:
mode:
authorNikos Mavrogiannopoulos <nmav@redhat.com>2017-04-20 16:34:56 +0200
committerNikos Mavrogiannopoulos <nmav@redhat.com>2017-04-20 16:34:56 +0200
commit89d4aeb37f7028a033334361eb14f2bef095dc75 (patch)
tree4733a37aefccd3da1f68501112d4f65431e67689 /doc/cha-gtls-app.texi
parentdd7dd9d1382bf4ceda56ec57f8572a005b89acea (diff)
downloadgnutls-89d4aeb37f7028a033334361eb14f2bef095dc75.tar.gz
doc: clarifications on custom thread override [ci skip]
Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
Diffstat (limited to 'doc/cha-gtls-app.texi')
-rw-r--r--doc/cha-gtls-app.texi7
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/cha-gtls-app.texi b/doc/cha-gtls-app.texi
index fb4a5aa2f5..fc5e7acbab 100644
--- a/doc/cha-gtls-app.texi
+++ b/doc/cha-gtls-app.texi
@@ -352,15 +352,16 @@ library.
The GnuTLS library is initialized on load; prior to 3.3.0 was initialized by calling @funcref{gnutls_global_init}@footnote{
The original behavior of requiring explicit initialization can obtained by setting the
GNUTLS_NO_EXPLICIT_INIT environment variable to 1, or by using the macro GNUTLS_SKIP_GLOBAL_INIT
-in a global section of your program.}.
+in a global section of your program --the latter works in systems with
+support for weak symbols only.}.
The initialization typically enables CPU-specific acceleration, performs any required
precalculations needed, opens any required system devices (e.g., /dev/urandom on Linux)
and initializes subsystems that could be used later.
The resources allocated by the initialization process will be released
-on library deinitialization, or explicitly by calling @funcref{gnutls_global_deinit}.
+on library deinitialization.
-Note that during initialization file descriptors may be kept open by
+Note that on certain systems file descriptors may be kept open by
GnuTLS (e.g. /dev/urandom) on library load. Applications closing all unknown file
descriptors must immediately call @funcref{gnutls_global_init}, after that, to
ensure they don't disrupt GnuTLS' operation.