summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNikos Mavrogiannopoulos <nmav@gnutls.org>2002-09-14 06:30:11 +0000
committerNikos Mavrogiannopoulos <nmav@gnutls.org>2002-09-14 06:30:11 +0000
commit076ca73caf2a5bcb316261a711f6c27bb375afdc (patch)
tree4545b6e456bad5aa4a6dcb0d5d0d8227850b4fd5
parent0e662f64c0ee81411aae27345d1ec990ed8dc4e1 (diff)
downloadgnutls-076ca73caf2a5bcb316261a711f6c27bb375afdc.tar.gz
*** empty log message ***
-rw-r--r--doc/tex/library.tex24
1 files changed, 11 insertions, 13 deletions
diff --git a/doc/tex/library.tex b/doc/tex/library.tex
index 6cac2e6687..d0a40d6c2f 100644
--- a/doc/tex/library.tex
+++ b/doc/tex/library.tex
@@ -59,28 +59,26 @@ after having seen the examples on page \pageref{examples}.
\par
As shown in the figure, there is a read-only global state that
-is initialized by \printfunc{gnutls_global_init}{gnutls\_global\_init}.
+is initialized once by the global initialization function.
This global structure, among others, contains the memory allocation
functions used, and some structures needed for the ASN.1 parser.
This structure is never modified by any \gnutls{} function, except
-for \printfunc{gnutls_global_deinit}{gnutls\_global\_deinit} which frees
-all memory allocated within the global structure.
+for the deinitialization function which frees all memory allocated in
+the global structure and is called after the program has permanently finished
+using \gnutls{}.
\par
The credentials structure is used within some authentication methods,
such as certificate authentication\footnote{see section \ref{certificate} on \pageref{certificate}}.
+A credentials structure may contain certificates, private keys, temporary parameters
+for diffie hellman or RSA key exchange, and other stuff that may be shared
+by several TLS sessions.
+
This structure should be initialized using the appropriate initialization
functions. For example an application which uses certificate authentication
-would probably call:
-\printfunc{gnutls_certificate_allocate_credentials}{gnutls\_certificate\_allocate\_credentials},
-\printfunc{gnutls_certificate_set_x509_trust_file}{gnutls\_certificate\_set\_x509\_trust\_file}
-and
-\printfunc{gnutls_credentials_set}{gnutls\_credentials\_set},
-to set the trusted certificates.
-
-\par The credentials structures may contain certificates, temporary parameters for
-diffie hellman or RSA key exchange, and other stuff that may be shared
-by several TLS sessions.
+would probably initialize the credentials, using the appropriate functions,
+and put it's trusted certificates in this structure. The next step is to
+associate the credentials structure with each \tls{} session.
\par A \gnutls{} session contains all the required stuff for a
session to handle one secure connection. This session calls directly