From: Nikos Mavrogiannopoulos <nmav@gnutls.org>
Date: Wed, 29 May 2013 15:26:14 +0000 (+0200)
Subject: doc update
X-Git-Tag: gnutls_3_2_2~114
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4df054e2ee8e38db92f75a846ce3d5c2d3871942;p=thirdparty%2Fgnutls.git

doc update
---

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 08ba53fa51..a8fc5caeb6 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1648,6 +1648,8 @@ FUNCS += functions/gnutls_session_resumption_requested
 FUNCS += functions/gnutls_session_resumption_requested.short
 FUNCS += functions/gnutls_session_set_data
 FUNCS += functions/gnutls_session_set_data.short
+FUNCS += functions/gnutls_session_set_id
+FUNCS += functions/gnutls_session_set_id.short
 FUNCS += functions/gnutls_session_set_premaster
 FUNCS += functions/gnutls_session_set_premaster.short
 FUNCS += functions/gnutls_session_set_ptr
diff --git a/doc/cha-support.texi b/doc/cha-support.texi
index dfb501aab1..e4138a31d9 100644
--- a/doc/cha-support.texi
+++ b/doc/cha-support.texi
@@ -6,6 +6,7 @@
 * Commercial Support::
 * Bug Reports::
 * Contributing::
+* Certification::
 @end menu
 
 @node Getting help
@@ -155,3 +156,17 @@ formatted, are extracted into Texinfo manuals and GTK-DOC web pages.
 
 @end itemize
 
+@node Certification
+@section Certification
+@cindex certification
+
+Many cryptographic libraries claim certifications from national or international bodies. These certifications are tied on a specific (and often restricted) version of the library or a 
+specific product using the library, and typically in the case of software they assure that the algorithms implemented are correct. The major certifications known are:
+@itemize
+@item USA's FIPS 140-2 at Level 1 which certifies that approved algorithms are used (see @url{http://en.wikipedia.org/wiki/FIPS_140-2});
+@item Common Criteria for Information Technology Security Evaluation (CC), an international standard for verification of elaborate security claims (see @url{http://en.wikipedia.org/wiki/Common_Criteria}).
+@end itemize
+
+Obtaining such a certification is an expensive and elaborate job that has no immediate value for a continuously developed free software library (as the certification is tied to the
+particular version tested), and in the case of algorithm verification of FIPS 140-2 it doesn't make much sense as the library is freely available and anyone can verify the correctness
+of algorithm implementation. As such we are not actively pursuing this kind of certification. If you are, nevertheless, interested, see @ref{Commercial Support}.
diff --git a/doc/manpages/Makefile.am b/doc/manpages/Makefile.am
index 2a202801c9..02ab51fa12 100644
--- a/doc/manpages/Makefile.am
+++ b/doc/manpages/Makefile.am
@@ -620,6 +620,7 @@ APIMANS += gnutls_session_get_random.3
 APIMANS += gnutls_session_is_resumed.3
 APIMANS += gnutls_session_resumption_requested.3
 APIMANS += gnutls_session_set_data.3
+APIMANS += gnutls_session_set_id.3
 APIMANS += gnutls_session_set_premaster.3
 APIMANS += gnutls_session_set_ptr.3
 APIMANS += gnutls_session_ticket_enable_client.3