diff options
author | Nikos Mavrogiannopoulos <nmav@redhat.com> | 2014-10-22 16:35:42 +0200 |
---|---|---|
committer | Nikos Mavrogiannopoulos <nmav@redhat.com> | 2014-10-22 16:39:02 +0200 |
commit | ca1d1efdf6767a00ccefd4e0c7d573d27e563592 (patch) | |
tree | 532454be6d50748c0d6993c894b46446e9e21d4f /doc | |
parent | fe3e4112a0d71374e8908401dd14293a80227e00 (diff) | |
download | gnutls-ca1d1efdf6767a00ccefd4e0c7d573d27e563592.tar.gz |
document gnutls_fd_in_use()
Diffstat (limited to 'doc')
-rw-r--r-- | doc/cha-gtls-app.texi | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/doc/cha-gtls-app.texi b/doc/cha-gtls-app.texi index 2dd5c853a0..55d0879d51 100644 --- a/doc/cha-gtls-app.texi +++ b/doc/cha-gtls-app.texi @@ -271,8 +271,7 @@ library. @node Initialization @subsection Initialization -GnuTLS must be initialized before it can be used. The library is -initialized on load; prior to 3.3.0 was initialized by calling @funcref{gnutls_global_init}. +The GnuTLS library is initialized on load; prior to 3.3.0 was initialized by calling @funcref{gnutls_global_init}. 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. @@ -280,6 +279,11 @@ and initializes subsystems that could be used later. The resources allocated by the initialization process will be released on library deinitialization, or explictly by calling @funcref{gnutls_global_deinit}. +Note that during initialization file descriptors may be kept open by +GnuTLS (e.g. /dev/urandom). The helper function @funcref{gnutls_fd_in_use} +is given to assist applications closing all unknown file descriptors +on initialization. + @c In order to take advantage of the internationalization features in @c GnuTLS, such as translated error messages, the application must set @c the current locale using @code{setlocale} before initializing GnuTLS. |