Fix memory leak.
[gnutls.git] / NEWS
blob03ffd71fa574f84dedb0ccce6d59dd8fc9d37ced
1 GNU TLS NEWS -- History of user-visible changes.                -*- outline -*-
2 Copyright (C) 2004, 2005, 2006, 2007, 2008 Simon Josefsson
3 Copyright (C) 2000, 2001, 2002, 2003, 2004 Nikos Mavrogiannopoulos
4 See the end for copying conditions.
6 * Version 2.3.13 (unreleased)
8 ** libgnutls [OpenPGP]: Make OpenPGP handshakes work again.
10 ** doc/: Add psktool to info index.  Some minor cleanups.
12 ** tests/: New non-forking TLS handshake test.
14 ** tests/: Added libgcrypt.supp which can be used with valgrind.
15 The file suppresses the known libgcrypt memory leaks, so they aren't
16 printed when you run valgrind on the gnutls self-tests.
18 ** API and ABI modifications:
19 No changes since last version.
21 * Version 2.3.12 (released 2008-06-04)
23 ** Merge gnutls_with_netconf branch.
25 *** libgnutls [PSK]: New API to retrieve PSK identity hint in client.
26 The function is gnutls_psk_client_get_hint.
28 *** libgnutls [PSK]: New API to set PSK identity hint in server.
29 The function is gnutls_psk_set_server_credentials_hint.
31 *** libgnutls [PSK]: Support server key exchange with PSK identity hint.
32 In the client, the message is parsed and the application can use
33 gnutls_psk_client_get_hint to retrieve the hint.  In the server, the
34 message is sent if the application has specified a PSK identity hint
35 using gnutls_psk_set_server_credentials_hint.
37 *** libgnutls [PSK]: Support Netconf PSK key derivation.
38 The function gnutls_psk_netconf_derive_key supports the PSK key
39 derivation as specified in draft-ietf-netconf-tls-02.txt.  New self
40 test netconf-psk.c.
42 *** psktool: Support new --netconf-hint to generate PSK key from password.
43 Uses the Netconf algorithm to derive PSK key from password.
45 *** gnutls-serv: Support new --pskhint parameter to set PSK identity hint.
47 *** gnutls-cli: Always support PSK modes, through a callback.
48 The callback will derive a PSK key using Netconf algorithm.  It will
49 print the PSK identity hint to help the user.
51 *** New PSK example client and server.
52 See doc/examples/ex-client-psk.c and doc/examples/ex-serv-psk.c.
54 ** libgnutls: Fix gnutls_x509_crl_set_version on arm platforms.
55 The code didn't work properly on platforms where 'char' is unsigned,
56 when you set version 0.  Reported by Laurence Withers
57 <l@lwithers.me.uk> in
58 <http://permalink.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/2825>.
60 ** libgnutls-openssl: added RAND_pseudo_bytes API.
61 Patch from Robert Millan <rmh@aybabtu.com>.
63 ** API and ABI modifications:
64 RAND_pseudo_bytes: ADDED to libgnutls-openssl.
65 gnutls_psk_client_get_hint: ADDED.
66 gnutls_psk_set_server_credentials_hint: ADDED.
67 gnutls_psk_netconf_derive_key: ADDED
69 * Version 2.3.11 (released 2008-05-20)
71 ** Fix flaw in fix for GNUTLS-SA-2008-1-3.
72 The flaw would result in incorrectly terminated sessions with the
73 error "Decryption has failed" when the server sends a small packet
74 (typically when the session is closed).  Reported by Andreas Metzler
75 <ametzler@downhill.at.eu.org> in
76 <http://permalink.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/2807>.
78 ** Don't use gnulib headers when building C++ library.
79 Fixes builds under Windows.
81 ** Make umask a requirement.
82 We don't know of any system that lacks it, even GNU CoreUtils use it
83 unconditionally.
85 ** Update gnulib files.
86 Fixes a problem where it pulled in a replacement for memcmp under
87 MinGW, which caused the C++ example to fail to build.
89 ** API and ABI modifications:
90 No changes since last version.
92 * Version 2.3.10 (released 2008-05-19)
94 ** Added wide wildcard hostname matching.
95 Tiny patch by Jean-Philippe Garcia Ballester.
97 ** Fix three security vulnerabilities.  [GNUTLS-SA-2008-1]
98 Thanks to CERT-FI for finding the bugs and providing detailed reports,
99 which allowed the bugs to be reproduced and fixed easily.  Patches
100 developed by Simon Josefsson and Nikos Mavrogiannopoulos.  Any updates
101 with more details about these vulnerabilities will be added to
102 <http://www.gnu.org/software/gnutls/security.html>
104 *** [GNUTLS-SA-2008-1-1]
105 *** libgnutls: Fix crash when sending invalid server name.
106 The crash can be triggered remotely before authentication, which can
107 lead to a Daniel of Service attack to disable the server.  The bug
108 cause gnutls to store more session resumption data than what was
109 allocated for, thus overwriting unallocated memory.
111 *** [GNUTLS-SA-2008-1-2]
112 *** libgnutls: Fix crash when sending repeated client hellos.
113 The crash can be triggered remotely before authentication, which can
114 lead to a Daniel of Service attack to disable the server.  The bug
115 triggers a null-pointer dereference.
117 *** [GNUTLS-SA-2008-1-3]
118 *** libgnutls: Fix crash in cipher padding decoding for invalid record lengths.
119 The crash can be triggered remotely before authentication, which can
120 lead to a Daniel of Service attack to disable the server.  The bug
121 cause gnutls to read memory beyond the end of the received record.
123 ** libgnutlsxx: Updated API according to patches from Eduardo 
124 Villanueva Che (discussion at
125 <http://lists.gnu.org/archive/html/gnutls-devel/2007-02/msg00017.html>)
127 ** Use umask to restrict permissions to owner before creating a file.
129 ** API and ABI modifications:
130 No changes since last version.
132 * Version 2.3.9 (released 2008-05-16)
134 ** libgnutls: Fix build failures if SRP/OpenPGP is disabled.
135 Based on report and tiny patches from
136 <jared.jennings.ctr@eglin.af.mil>, see
137 <https://savannah.gnu.org/support/index.php?106342>.
139 ** libgnutls: Translation fixes.
141 ** gnutls-cli: Fix so that PSK authentication works.
142 Also improve manual to give example for gnutls-cli PSK authentication.
144 ** certtool: Encrypting a private key now require a confirmed password.
145 Before './certtool -k -8' would merely ask for a password once.
146 Reported by Daniel 'NebuchadnezzaR' Dehennin
147 <nebuchadnezzar@asgardr.info> see
148 <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=364287>.
150 ** certtool: When writing private keys to files, change permissions of file.
151 Now the file which the private key is saved to is chmod'ed 0600.
152 Reported by martin f krafft <madduck@debian.org> see
153 <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=373169>.
155 ** guile: Fix -fgnu89-inline test.
157 ** Removed --enable-profile-mode.
158 The code linked gnutls with the libfc project (Function Check) which
159 appears to have been stalled since around 2002.
161 ** Clean up header file checks by ./configure.
163 ** Update of gnulib files.
165 ** API and ABI modifications:
166 No changes since last version.
168 * Version 2.3.8 (released 2008-04-29)
170 ** libgnutls: Increase default handshake packet size limit to 48kb.
171 The old limit was 16kb and some servers send huge list of trusted CAs,
172 thus running into the limit.  FYI, applications can further increase
173 this limit using gnutls_handshake_set_max_packet_length.  Thanks to
174 Marc Haber <mh+debian-bugs@zugschlus.de> and "Marc F. Clemente"
175 <marc@mclemente.net> for reporting and providing test servers.
177 ** libgnutls: Add new error code: GNUTLS_E_HANDSHAKE_TOO_LARGE
178 Returned when the handshake data size is too large.  Before
179 GNUTLS_E_MEMORY_ERROR was used, which could be confused with other
180 error situations.
182 ** libgnutls: Hide definitions in crypto.h.
183 We have decided that the APIs defined in crypto.h are not stable
184 enough for v2.4, so don't use any of those functions.
186 ** gnutls-cli: exit when hostname doesn't match certificate.
187 Use --insecure to avoid hostname comparison.
189 ** certtool: --inder and --outder replaced by --inraw and --outraw.
190 The reason is to align terminology with OpenPGP, which doesn't use
191 DER.  The old parameters will continue to work for some time.
193 ** doc: Add section 'Index of new symbols in 2.4.0' to the GTK-DOC manual.
195 ** doc: Many cosmetic fixes, to silence (most) gtk-doc warnings.
197 ** Mingw32: Revert libgcrypt vasprintf work-around added in last release.
198 Use libgcrypt 1.4.1 or later when building on MinGW32, it removes the
199 vasprintf symbol from the libgcrypt library which caused problems.
201 ** Update of gnulib files.
203 ** tests: New self-test of crypto.h RNG code tests/crypto_rng.
205 ** API and ABI modifications:
206 GNUTLS_E_HANDSHAKE_TOO_LARGE: ADDED.
208 * Version 2.3.7 (released 2008-04-21)
210 ** opencdk now properly sets the key usage bits into openpgp keys.
212 ** gnutls-cli: Fix crash on TLS handshake failures.
213 Reported by "Marc F. Clemente" <marc@mclemente.net> in Debian BTS #466477.
214 This is similar to <http://bugs.debian.org/429183>.
216 ** certtool: with --generate-request and newly generated keys, print the key.
218 ** Build fixes for MinGW.
219 Missing rpl_fseeko symbol in lib/opencdk/.  Better checks for linking
220 with -lws2_32 when needed.  Use ASCII only isprint() when printing
221 X.509 certificate information, to avoid non-ASCII but printable
222 characters.  Thanks to Massimo Gaspari <massimo.gaspari@alice.it> for
223 reports.
225 ** Update internal copy of libtasn1 to version 1.4.
227 ** API and ABI modifications:
228 No changes since last version.
230 * Version 2.3.6 (released 2008-04-17)
232 ** Make gnutls_x509_crq_sign2 set certificate request version if not set.
233 ** Improve documentation for gnutls_x509_crq_sign2.
234 Based on report from "John Brooks" <aspecialj@gmail.com> in
235 <http://permalink.gmane.org/gmane.network.gnutls.general/1154>.
237 ** tests/pathlen: run diff without parameters to improve portability.
238 Based on HPUX build hints in
239 <http://hpux.cs.utah.edu/hppd/cgi-bin/wwwtar?/hpux/Gnu/gnutls-2.3.4/gnutls-2.3.4-src-11.11.tar.gz+gnutls-2.3.4/HPUX.Install+text>.
241 ** Don't use %e specifier with strftime, it doesn't work under Windows.
242 Reported by Massimo Gaspari <massimo.gaspari@alice.it> in
243 <http://permalink.gmane.org/gmane.network.gnutls.general/1170>.
245 ** Remove all uses of gnutls_alloca/gnutls_afree.
246 Use normal gnutls_malloc instead.  One reason is increased portability
247 to Windows, the other is that several of the uses may be unsafe
248 because the size of data allocated could be large.  Reported by
249 Massimo Gaspari <massimo.gaspari@alice.it> in
250 <http://permalink.gmane.org/gmane.network.gnutls.general/1170>.
252 ** Build Guile code with -fgnu89-inline only when supported.
253 Reported by Kris Karas <ktk@enterprise.bidmc.harvard.edu> in
254 <http://permalink.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/2708>.
256 ** Several GTK-DOC related fixes.
258 ** Clean up OpenCDK related code.
259 GnuTLS now requires its internal OpenCDK code rather than the external
260 GPL library OpenCDK.  Unfortunately, we don't have resources to
261 maintain an external library (help welcome).
263 ** API and ABI modifications:
264 No changes since last version.
266 * Version 2.3.5 (released 2008-04-14)
268 ** Build fix for MinGW and --disable-shared.
269 Reported by Massimo Gaspari <massimo.gaspari@alice.it> in
270 <http://permalink.gmane.org/gmane.network.gnutls.general/1145>.
272 ** Document how to generate CRLs.
273 Suggested by "Rainer Gerhards" <rgerhards@gmail.com>.
275 ** Documented the --priority option to gnutls-cli and gnutls-serv.
277 ** Several minor fixes in the OpenPGP interface.
278 Thanks to Daniel Kahn Gillmor.
280 ** Fix fopen file descriptor leak in PSK server code.
281 Thanks to Laurence Withers <l@lwithers.me.uk>, see
282 <http://lists.gnu.org/archive/html/gnutls-devel/2008-04/msg00002.html>.
284 ** Translations files not stored directly in git to avoid merge conflicts.
286 ** New APIs to let applications replace the RNG used.
287 Update all RNG callers in the code to use the new interface.
289 ** Guile code now built with -fgnu89-inline to fix inline semantic problem.
291 ** Update gnulib files.
293 ** API and ABI modifications:
294 gnutls_crypto_rnd_register: ADDED
295 gnutls_rnd_level_t: ADDED
296 GNUTLS_RND_KEY: ADDED, gnutls_rnd_level_t member
297 GNUTLS_RND_RANDOM: ADDED, gnutls_rnd_level_t member
298 GNUTLS_RND_NONCE: ADDED, gnutls_rnd_level_t member
299 gnutls_crypto_rnd_st: ADDED
300 GNUTLS_DIG_SHA224: ADDED
301 GNUTLS_SIGN_RSA_SHA224: ADDED
302 gnutls_openpgp_crt_get_auth_subkey: MODIFIED
304 * Version 2.3.4 (released 2008-03-19)
306 ** Finish renaming of gnutls_certificate_export_x509_cas etc.
307 They weren't renamed in the public header file.
309 ** Added functions to register a cipher/mac/digest. This allows to 
310 override the included ones.
312 ** Fix a bunch of compiler warnings.
314 ** API and ABI modifications:
315 gnutls_crypto_cipher_st: ADDED
316 gnutls_crypto_mac_st: ADDED
317 gnutls_crypto_digest_st: ADDED
318 gnutls_crypto_cipher_register: ADDED
319 gnutls_crypto_mac_register: ADDED
320 gnutls_crypto_digest_register: ADDED
321 GNUTLS_E_CRYPTO_ALREADY_REGISTERED: ADDED
323 * Version 2.3.3 (released 2008-03-10)
325 ** Fix build failure in libextra/gnutls_extra.c that needed opencdk.h.
326 Reported by Roman Bogorodskiy <novel@FreeBSD.org>.
328 ** No longer compiled using -D_REENTRANT -D_THREAD_SAFE.
329 We could not find any modern justification for enabling these flags by
330 default.  If you know of some platform that needs one of the flags to
331 work properly, please let us know.  (Actually introduced in v2.3.0 but
332 not documented until now.)
334 ** Importing many CA certificates are now considerably faster.
335 This affect gnutls_certificate_set_x509_trust_mem,
336 gnutls_certificate_set_x509_trust, and
337 gnutls_certificate_set_x509_trust_file.  The complexity was reduced
338 from O(2*n^2) to O(n).  When adding 206 files containing 408
339 certificates, using gnutls_certificate_set_x509_trust_file, the time
340 dropped from 40 seconds to 0.3 seconds.  Thanks to Edgar Fuß for code
341 to trigger the problem.  See also
342 <http://blog.josefsson.org/2008/02/27/real-world-performance-tuning-with-callgrind/>.
344 ** Clarify documentation for gnutls_x509_crt_set_subject_alternative_name
345 ** to be explicit that it takes zero terminated data.
347 ** gnutls-cli --print-cert now print PKCS#3 format Diffie-Hellman parameters.
349 ** Documentation fixes for the GTK-DOC manual.
351 ** Fix compilation error related to __FUNCTION__ on some systems.
352 Reported by Tim Mooney, see
353 <https://savannah.gnu.org/support/?106267>.
355 ** Updated translations.
357 ** Update gnulib files.
359 ** API and ABI modifications:
360 gnutls_hex2bin: MODIFIED, uses size_t instead of int for string length,
361                 and char* instead of void* for output buffer.
363 * Version 2.3.2 (released 2008-02-26)
365 ** Fix srcdir!=objdir failure in openpgpself test.
367 ** Improved API documentation output from GTK-DOC.
369 ** Added gnutls_x509_dn_export(). Patch by Joe Orton.
371 ** Renamed gnutls_certificate_export_x509_cas and friends.
372 See <http://lists.gnu.org/archive/html/gnutls-devel/2008-02/msg00043.html>.
374 ** Internal header files cleanup.
376 ** API and ABI modifications:
377 gnutls_certificate_export_x509_cas: RENAMED to gnutls_certificate_get_x509_cas
378 gnutls_certificate_export_x509_crls: RENAMED to gnutls_certificate_get_x509_crls
379 gnutls_certificate_export_openpgp_keyring: RENAMED to gnutls_certificate_get_openpgp_keyring
380 gnutls_x509_dn_export: ADDED
382 * Version 2.3.1 (released 2008-02-21)
384 ** OpenPGP support merged into libgnutls and is now licensed under LGPL.
385 The included copy of OpenCDK has been stripped down and re-licensed
386 under the LGPL.
388 ** Cipher priority string handling now handle strings that starts with NULL.
389 Thanks to Laurence Withers <l@lwithers.me.uk>.
391 ** gnutls-cli: When -d is used, also prints RNG information from libgcrypt.
393 ** Corrected memory leaks in session resuming and DHE ciphersuites. Reported
394 by Daniel Stenberg.
396 ** Increased the default certificate verification chain limits and allowed
397 for checks without limitation.
399 ** Corrected the behaviour of gnutls_x509_crt_get_subject_alt_name()
400 and gnutls_x509_crt_get_subject_alt_name() to not null terminate binary
401 strings and return the proper size.
403 ** Add section 'On Record Padding' to the manual.
404 This collects all problems related to record padding with
405 Nokia/Sony-Ericsson phones that we know about.
407 ** Several improvements in the OpenPGP authentication.
408 Now subkeys can be used for authentication, according to
409 draft-mavrogiannopoulos-rfc5081bis-00.txt.
411 ** certtool can print information on OpenPGP certificates and keys.
413 ** Added gnutls_x509_dn_import/init/deinit() to access raw DER DN.
414 Patch by Joe Orton.
416 ** Added gnutls_certificate_export_x509_cas and other functions to
417 export elements from the certificate credentials structure.  Based on
418 suggestion from Joe Orton.
420 ** Doc fixes.
421 Clarify that srp_base64 is not the same as normal base64.
423 ** Fix non-portable use of brace expansion in makefiles.
425 ** API and ABI modifications:
426 gnutls_certificate_export_x509_cas: ADDED
427 gnutls_certificate_export_x509_crls: ADDED
428 gnutls_certificate_export_openpgp_keyring: ADDED
429 gnutls_openpgp_keyid_t: ADDED, instead of hard-coded 'unsigned char[8]'.
430 gnutls_openpgp_crt_get_key_id: ADDED, obsoletes gnutls_openpgp_crt_get_id.
431 gnutls_openpgp_crt_get_revoked_status: ADDED
432 gnutls_openpgp_crt_get_subkey_count: ADDED
433 gnutls_openpgp_crt_get_subkey_idx: ADDED
434 gnutls_openpgp_crt_get_subkey_revoked_status: ADDED
435 gnutls_openpgp_crt_get_subkey_pk_algorithm: ADDED
436 gnutls_openpgp_crt_get_subkey_creation_time: ADDED
437 gnutls_openpgp_crt_get_subkey_expiration_time: ADDED
438 gnutls_openpgp_crt_get_subkey_id: ADDED
439 gnutls_openpgp_crt_get_subkey_usage: ADDED
440 gnutls_openpgp_privkey_get_fingerprint: ADDED
441 gnutls_openpgp_privkey_get_key_id: ADDED
442 gnutls_openpgp_privkey_get_subkey_count: ADDED
443 gnutls_openpgp_privkey_get_subkey_idx: ADDED
444 gnutls_openpgp_privkey_get_subkey_revoked_status: ADDED
445 gnutls_openpgp_privkey_get_revoked_status: ADDED
446 gnutls_openpgp_privkey_get_subkey_pk_algorithm: ADDED
447 gnutls_openpgp_privkey_get_subkey_expiration_time: ADDED
448 gnutls_openpgp_privkey_get_subkey_id: ADDED
449 gnutls_openpgp_privkey_get_subkey_creation_time: ADDED
450 gnutls_openpgp_crt_get_subkey_pk_dsa_raw: ADDED
451 gnutls_openpgp_crt_get_subkey_pk_rsa_raw: ADDED
452 gnutls_openpgp_crt_get_pk_dsa_raw: ADDED
453 gnutls_openpgp_crt_get_pk_rsa_raw: ADDED
454 gnutls_openpgp_privkey_export_subkey_dsa_raw: ADDED
455 gnutls_openpgp_privkey_export_subkey_rsa_raw: ADDED
456 gnutls_openpgp_privkey_export_dsa_raw: ADDED
457 gnutls_openpgp_privkey_export_rsa_raw: ADDED
458 gnutls_openpgp_privkey_export: ADDED
459 gnutls_certificate_set_openpgp_key_file2: ADDED
460 gnutls_certificate_set_openpgp_key_mem2: ADDED
461 gnutls_x509_dn_init: ADDED
462 gnutls_x509_dn_import: ADDED
463 gnutls_x509_dn_deinit: ADDED
464 GNUTLS_E_OPENPGP_SUBKEY_ERROR: ADDED
465 gnutls_hex2bin: ADDED
466 GNUTLS_CRT_PRINT_FULL: ADDED, same as old GNUTLS_X509_CRT_FULL.
467 GNUTLS_CRT_PRINT_ONELINE: ADDED, same as old GNUTLS_X509_CRT_ONELINE.
468 GNUTLS_CRT_PRINT_UNSIGNED_FULL: ADDED, same as
469                                 old GNUTLS_X509_CRT_UNSIGNED_FULL.
471 * Version 2.3.0 (released 2008-01-08)
473 ** LZO compression is now disabled by default.
474 The reason is that LZO compression is not standardized in TLS.  If you
475 wish to experiment with it, you will have to supply --with-lzo when
476 invoking ./configure.  The internal copy of minilzo is no longer
477 included with GnuTLS, so you will need to install liblzo or liblzo2 on
478 your system to have --with-lzo to be effective.
480 ** More than one server name field is now sent to the server properly.
481 Thanks to mark.phillips@virgin.net.
483 ** Fixes the post_client_hello_function(). The extensions are now parsed
484 in a callback friendly way.
486 ** Fix for certificate selection in servers with certificate callbacks.
488 ** Updated translations.
490 ** Update gnulib files.
492 ** API and ABI modifications:
493 No changes since last version.
495 * Version 2.2.5 (released 2008-05-19)
497 ** Fix flaw in fix for GNUTLS-SA-2008-1-3.
498 The flaw would result in incorrectly terminated sessions with the
499 error "Decryption has failed" when the server sends a small packet
500 (typically when the session is closed).  Reported by Andreas Metzler
501 <ametzler@downhill.at.eu.org> in
502 <http://permalink.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/2807>.
504 ** API and ABI modifications:
505 No changes since last version.
507 * Version 2.2.4 (released 2008-05-19)
509 ** Fix three security vulnerabilities.  [GNUTLS-SA-2008-1]
510 Thanks to CERT-FI for finding the bugs and providing detailed reports,
511 which allowed the bugs to be reproduced and fixed easily.  Patches
512 developed by Simon Josefsson and Nikos Mavrogiannopoulos.  Any updates
513 with more details about these vulnerabilities will be added to
514 <http://www.gnu.org/software/gnutls/security.html>
516 *** [GNUTLS-SA-2008-1-1]
517 *** libgnutls: Fix crash when sending invalid server name.
518 The crash can be triggered remotely before authentication, which can
519 lead to a Daniel of Service attack to disable the server.  The bug
520 cause gnutls to store more session resumption data than what was
521 allocated for, thus overwriting unallocated memory.
523 *** [GNUTLS-SA-2008-1-2]
524 *** libgnutls: Fix crash when sending repeated client hellos.
525 The crash can be triggered remotely before authentication, which can
526 lead to a Daniel of Service attack to disable the server.  The bug
527 triggers a null-pointer dereference.
529 *** [GNUTLS-SA-2008-1-3]
530 *** libgnutls: Fix crash in cipher padding decoding for invalid record lengths.
531 The crash can be triggered remotely before authentication, which can
532 lead to a Daniel of Service attack to disable the server.  The bug
533 cause gnutls to read memory beyond the end of the received record.
535 ** API and ABI modifications:
536 No changes since last version.
538 * Version 2.2.3 (released 2008-05-06)
540 ** Increase default handshake packet size limit to 48kb.
541 The old limit was 16kb and some servers send huge list of trusted CAs,
542 thus running into the limit.  FYI, applications can further increase
543 this limit using gnutls_handshake_set_max_packet_length.  Thanks to
544 Marc Haber <mh+debian-bugs@zugschlus.de> and "Marc F. Clemente"
545 <marc@mclemente.net> for reporting and providing test servers.
547 ** Fix compilation error related to __FUNCTION__ on some systems.
548 Reported by Tim Mooney, see
549 <https://savannah.gnu.org/support/?106267>.
551 ** Documented the --priority option to gnutls-cli and gnutls-serv.
553 ** Fix fopen file descriptor leak in PSK server code.
554 Thanks to Laurence Withers <l@lwithers.me.uk>, see
555 <http://lists.gnu.org/archive/html/gnutls-devel/2008-04/msg00002.html>.
557 ** Build Guile code with -fgnu89-inline only when supported.
558 Reported by Kris Karas <ktk@enterprise.bidmc.harvard.edu> in
559 <http://permalink.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/2708>.
561 ** Make Camellia encryption work.
562 Reported by Yoshisato YANAGISAWA <yanagisawa@csg.is.titech.ac.jp> in
563 <http://thread.gmane.org/gmane.comp.encryption.gpg.gnutls.devel/2746>.
565 ** API and ABI modifications:
566 No changes since last version.
568 * Version 2.2.2 (released 2008-02-21)
570 ** Cipher priority string handling now handle strings that starts with NULL.
571 Thanks to Laurence Withers <l@lwithers.me.uk>.
573 ** Corrected memory leaks in session resuming and DHE ciphersuites. Reported
574 by Daniel Stenberg.
576 ** Increased the default certificate verification chain limits and allowed
577 for checks without limitation.
579 ** Corrected the behaviour of gnutls_x509_crt_get_subject_alt_name()
580 and gnutls_x509_crt_get_subject_alt_name() to not null terminate binary
581 strings and return the proper size.
583 ** API and ABI modifications:
584 No changes since last version.
586 * Version 2.2.1 (released 2008-01-17)
588 ** Prevent linking libextra against previously installed libgnutls.
589 Tiny patch from "Alon Bar-Lev" <alon.barlev@gmail.com>, see
590 <http://bugs.gentoo.org/show_bug.cgi?id=202269>.
592 ** Fixes the post_client_hello_function(). The extensions are now parsed
593 in a callback friendly way.
595 ** Fix for certificate selection in servers with certificate callbacks.
597 ** API and ABI modifications:
598 No changes since last version.
600 * Version 2.2.0 (released 2007-12-14)
602 ** Update internal copy of libtasn1 to version 1.2.
604 ** Certtool --verify-chain now handle inputs larger than 64kb.
605 This fixes the self-test "rsa-md5-collision" under MinGW+Wine with
606 recent versions of libgcrypt.  The problem was that Wine with the
607 libgcrypt RNG generates huge amounts of debugging output.
609 ** Translation updates.
610 Added Dutch translation.  Updated Polish and Swedish translation.
612 ** Major changes compared to the v2.0 branch:
614 *** SRP support aligned with newly published RFC 5054.
616 *** OpenPGP support aligned with newly published RFC 5081.
618 *** Support for DSA2 keys.
620 *** Support for Camellia cipher.
622 *** Support for Opaque PRF Input extension.
624 *** PKCS#8 parser now handle DSA keys.
626 *** Change from GPLv2 to GPLv3 for command-line tools, libgnutls-extra, etc.
627 Notice that liblzo2 2.02 is licensed under GPLv2 only.  Earlier
628 versions, such as 2.01 which is included with GnuTLS, is available
629 under GPLv2 or later.  If this incompatibility causes problems, we
630 recommend you to disable LZO using --without-lzo.  LZO compression is
631 not a standard TLS compression algorithm, so the impact should be
632 minimal.
634 *** Functions for disabling record protocol padding.
635 Works around bugs on Nokia/Ericsson phones.
637 *** New functions gnutls_priority_set() for setting cipher priorities easily.
638 Priorities like "COMPAT" also enables other work arounds, such as
639 disabling padding.
641 *** Other minor improvements and bug fixes.
643 ** Backwards incompatible API/ABI changes in GnuTLS 2.2
644 To adapt to changes in the TLS extension specifications for OpenPGP
645 and SRP, the GnuTLS API had to be modified.  This means breaking the
646 API and ABI backwards compatibility.  That is something we try to
647 avoid unless it is necessary.  We decided to also remove the already
648 deprecated stub functions for X.509 to XML conversion and TLS
649 authorization (see below) when we had the opportunity.
651 Generally, most applications does not need to be modified.  Just
652 re-compile them against the latest GnuTLS release, and it should work
653 fine.
655 Applications that use the OpenPGP or SRP features needs to be
656 modified.  Below is a list of the modified APIs and discussion of what
657 the minimal things you need to modify in your application to make it
658 work with GnuTLS 2.2.
660 Note that GnuTLS 2.2 also introduces new APIs -- such as
661 gnutls_set_priority() that is superior to
662 gnutls_set_default_priority() -- that you may want to start using.
663 However, using those new APIs is not required to use GnuTLS 2.2 since
664 the old functions continue are still supported.  This text only
665 discuss what you minimally have to modify.
667 *** XML related changes
668 The function `gnutls_x509_crt_to_xml' has been removed.  It has been
669 deprecated and only returned an error code since GnuTLS version
670 1.2.11.  Nobody has complained, so users doesn't seem to miss the
671 functionality.  We don't know of any other library to convert X.509
672 certificates into XML format, but we decided (long ago) that GnuTLS
673 isn't the right place for this kind of functionality.  If you want
674 help to find some other library to use here, please explain and
675 discuss your use case on help-gnutls@gnu.org.
677 *** TLS Authorization related changes
678 Everything related to TLS authorizations have been removed, they were
679 only stub functions that returned an error code:
681  GNUTLS_SUPPLEMENTAL_AUTHZ_DATA
682  gnutls_authz_data_format_type_t
683  gnutls_authz_recv_callback_func
684  gnutls_authz_send_callback_func
685  gnutls_authz_enable
686  gnutls_authz_send_x509_attr_cert
687  gnutls_authz_send_saml_assertion
688  gnutls_authz_send_x509_attr_cert_url
689  gnutls_authz_send_saml_assertion_url
691 *** SRP related changes
692 The callback gnutls_srp_client_credentials_function has a new
693 prototype, and its semantic has changed.  You need to rewrite the
694 callback, see the updated function documentation and SRP example code
695 (doc/examples/ex-client-srp.c and doc/examples/ex-serv-srp.c) for more
696 information.
698 The alert codes GNUTLS_A_MISSING_SRP_USERNAME and
699 GNUTLS_A_UNKNOWN_SRP_USERNAME are no longer used by the SRP
700 specification, instead the GNUTLS_A_UNKNOWN_PSK_IDENTITY alert is
701 used.  There are #define's to map the old names to the new.  You may
702 run into problems if you have a switch-case with cases for both SRP
703 alerts, since they are now mapped to the same value.  The solution is
704 to drop the SRP alerts from such switch cases, as they are now
705 deprecated in favor of GNUTLS_A_UNKNOWN_PSK_IDENTITY.
707 *** OpenPGP related changes
708 The function `gnutls_certificate_set_openpgp_keyserver' have been
709 removed.  There is no replacement functionality inside GnuTLS.  If you
710 need keyserver functionality, consider using the GnuPG tools.
712 All functions, types, and error codes related to OpenPGP trustdb
713 format have been removed.  The trustdb format is a non-standard
714 GnuPG-specific format, and we recommend you to use key rings instead.
715 The following have been removed:
717  gnutls_certificate_set_openpgp_trustdb
718  gnutls_openpgp_trustdb_init
719  gnutls_openpgp_trustdb_deinit
720  gnutls_openpgp_trustdb_import
721  gnutls_openpgp_key_verify_trustdb
722  gnutls_openpgp_trustdb_t
723  GNUTLS_E_OPENPGP_TRUSTDB_VERSION_UNSUPPORTED
725 The following functions has an added parameter of the (new) type
726 `gnutls_openpgp_crt_fmt_t'.  The type specify the format of the data
727 (binary or base64).  The functions are:
728  gnutls_certificate_set_openpgp_key_file
729  gnutls_certificate_set_openpgp_key_mem
730  gnutls_certificate_set_openpgp_keyring_mem
731  gnutls_certificate_set_openpgp_keyring_file
733 To improve terminology and align with the X.509 interface, some
734 functions have been renamed.  Compatibility mappings exists.  The old
735 and new names of the affected functions and types are:
737         Old name                                New name
738  gnutls_openpgp_key_t                    gnutls_openpgp_crt_t
739  gnutls_openpgp_key_fmt_t                gnutls_openpgp_crt_fmt_t
740  gnutls_openpgp_key_status_t             gnutls_openpgp_crt_status_t
741  GNUTLS_OPENPGP_KEY                      GNUTLS_OPENPGP_CERT
742  GNUTLS_OPENPGP_KEY_FINGERPRINT          GNUTLS_OPENPGP_CERT_FINGERPRINT
743  gnutls_openpgp_key_init                 gnutls_openpgp_crt_init
744  gnutls_openpgp_key_deinit               gnutls_openpgp_crt_deinit
745  gnutls_openpgp_key_import               gnutls_openpgp_crt_import
746  gnutls_openpgp_key_export               gnutls_openpgp_crt_export
747  gnutls_openpgp_key_get_key_usage        gnutls_openpgp_crt_get_key_usage
748  gnutls_openpgp_key_get_fingerprint      gnutls_openpgp_crt_get_fingerprint
749  gnutls_openpgp_key_get_pk_algorithm     gnutls_openpgp_crt_get_pk_algorithm
750  gnutls_openpgp_key_get_name             gnutls_openpgp_crt_get_name
751  gnutls_openpgp_key_get_version          gnutls_openpgp_crt_get_version
752  gnutls_openpgp_key_get_creation_time    gnutls_openpgp_crt_get_creation_time
753  gnutls_openpgp_key_get_expiration_time  gnutls_openpgp_crt_get_expiration_time
754  gnutls_openpgp_key_get_id               gnutls_openpgp_crt_get_id
755  gnutls_openpgp_key_check_hostname       gnutls_openpgp_crt_check_hostname
756  gnutls_openpgp_send_key                 gnutls_openpgp_send_cert
758 ** API and ABI modifications:
759 No changes since last version.
761 * Version 2.1.8 (released 2007-12-10)
763 ** The GPL version has been changed from version 2 to version 3.
764 This affects the self-tests, command-line tools, the libgnutls-extra
765 library, the relevant guile parts, and the build environment.
767 ** Added gnutls_x509_crt_get_subject_alt_name2().
769 ** Corrected a segfault when setting an empty gnutls_priority_t
770 at gnutls_priority_set().
772 ** Use gettext 0.17 which updates m4/lib-*.m4 macros.
773 Fixes a problem with spurious -L/usr/lib additions.
775 ** API and ABI modifications:
776 gnutls_x509_crt_get_subject_alt_name2: ADD.
778 * Version 2.1.7 (released 2007-11-29)
780 ** PKCS #8 parser can now encode/decode DSA keys.
782 ** Updated gnutls_set_default_priority2() now renamed to
783 gnutls_priority_set() and gnutls_priority_set_direct() which
784 accept a string to indicate preferences of ciphersuite parameters.
786 ** gnutls-cli and gnutls-serv now have a --priority option to set
787 the priority string.
789 ** The gnutls_*_convert_priority() functions were deprecated by
790 the gnutls_priority_set() and gnutls_priority_set_direct().
792 ** Internal copy of OpenCDK upgraded to version 0.6.6.
794 ** API and ABI modifications:
795 gnutls_priority_init: ADD.
796 gnutls_priority_deinit: ADD.
797 gnutls_priority_set: ADD.
798 gnutls_priority_set_direct: ADD.
799 gnutls_set_default_priority2: RENAMED to gnutls_priority_set_direct()
800 gnutls_mac_convert_priority: REMOVED
801 gnutls_compression_convert_priority: REMOVED
802 gnutls_protocol_convert_priority: REMOVED
803 gnutls_kx_convert_priority: REMOVED
804 gnutls_cipher_convert_priority: REMOVED
805 gnutls_certificate_type_convert_priority: REMOVED
806 gnutls_set_default_priority: UNDEPRECATED
807 gnutls_set_default_priority_export: UNDEPRECATED
809 ** Undocumented API and ABI modifications earlier in the 2.1.x series:
810 GNUTLS_CIPHER_UNKNOWN: ADD.
811 GNUTLS_CIPHER_CAMELLIA_128_CBC: ADD.
812 GNUTLS_CIPHER_CAMELLIA_256_CBC: ADD.
813 GNUTLS_KX_UNKNOWN: ADD.
814 GNUTLS_COMP_UNKNOWN: ADD.
815 GNUTLS_CRT_UNKNOWN: ADD.
816 gnutls_mac_get_id: ADD.
817 gnutls_compression_get_id: ADD.
818 gnutls_cipher_get_id: ADD.
819 gnutls_kx_get_id: ADD.
820 gnutls_protocol_get_id: ADD.
821 gnutls_certificate_type_get_id: ADD.
822 gnutls_handshake_post_client_hello_func: ADD.
823 gnutls_certificate_send_x509_rdn_sequence: ADD prototype to gnutls.h.in.
825 * Version 2.1.6 (released 2007-11-15)
827 ** Corrected bug in decompression of expanded compression data.
829 ** Added the --to-p8 option to certtool to convert private keys
830 to PKCS #8 keys.
832 ** Introduced the GNUTLS_E_BASE64_UNEXPECTED_HEADER_ERROR error code.
834 ** gnutls_certificate_set_x509_key_* can now read PKCS #8 unencrypted
835 private keys.
837 ** Fixed GNUTLS_E_UNKNOWN_ALGORITHM vs GNUTLS_E_UNKNOWN_HASH_ALGORITHM.
838 During the 2.1.x series the GNUTLS_E_UNKNOWN_HASH_ALGORITHM error code
839 was renamed to GNUTLS_E_UNKNOWN_ALGORITHM, unfortunately without being
840 documented.  This caused some problems (e.g., debian #450854).  To
841 avoid backwards compatibility problems, this release revert this
842 change, so that GNUTLS_E_UNKNOWN_HASH_ALGORITHM works just like it has
843 done in GnuTLS 2.0.x and earlier, and add a new error code
844 GNUTLS_E_UNKNOWN_ALGORITHM.
846 ** Fixes several gtk-doc warnings.
848 ** API and ABI modifications:
849 GNUTLS_E_UNKNOWN_ALGORITHM: CHANGED.
850 GNUTLS_E_UNKNOWN_HASH_ALGORITHM: CHANGED.
851 GNUTLS_E_BASE64_UNEXPECTED_HEADER_ERROR: ADD.
853 * Version 2.1.5 (released 2007-11-01)
855 ** Fix PKCS#3 parameter export problem.
857 ** Improve certtool queries, they now print the default value.
859 ** Fix ABI version.
861 ** Update gnulib files.
863 ** API and ABI modifications:
864 No changes since last version.
866 * Version 2.1.4 (released 2007-10-27)
868 ** Added the --v1 option to certtool, to allow generating X.509
869 version 1 certificates. 
871 ** certtool: Add option --disable-quick-random to enable the old behaviour
872 of using /dev/random to generate keys.
874 ** Added priority functions that accept strings.
876 ** Added gnutls_set_default_priority2() which accepts a flag to indicate
877 priorities preferences.
879 ** Added gnutls_record_disable_padding() to allow servers talking to 
880 buggy clients that complain if the TLS 1.0 record protocol padding is
881 used.
883 ** Introduced gnutls_session_enable_compatibility_mode() to allow enabling
884 all supported compatibility options (like disabling padding).
886 ** The gnutls_certificate_set_openpgp_* functions were modified to include
887 the format. This makes the interface consistent with the x509 functions.
889 ** Internal copy of OpenCDK upgraded to version 0.6.5.
891 ** Update gnulib files.
893 ** API and ABI modifications:
894 gnutls_certificate_set_openpgp_key_mem: MODIFIED
895 gnutls_certificate_set_openpgp_key_file: MODIFIED
896 gnutls_certificate_set_openpgp_keyring_mem: MODIFIED
897 gnutls_certificate_set_openpgp_keyring_file: MODIFIED
898 gnutls_set_default_priority: DEPRECATED
899 gnutls_set_default_priority_export: DEPRECATED
900 gnutls_set_default_priority2: ADDED
901 gnutls_session_enable_compatibility_mode: ADDED
902 gnutls_record_disable_padding: ADDED
903 gnutls_mac_convert_priority: ADDED
904 gnutls_compression_convert_priority: ADDED
905 gnutls_protocol_convert_priority: ADDED
906 gnutls_kx_convert_priority: ADDED
907 gnutls_cipher_convert_priority: ADDED
908 gnutls_certificate_type_convert_priority: ADDED
909 gnutls_openpgp_key_t: RENAMED to gnutls_openpgp_crt_t
910 gnutls_openpgp_key_status_t: RENAMED to gnutls_openpgp_crt_status_t
911 gnutls_openpgp_send_key: RENAMED to gnutls_openpgp_send_cert
912 gnutls_openpgp_key_init: RENAMED to gnutls_openpgp_crt_init
913 gnutls_openpgp_key_import: RENAMED to gnutls_openpgp_crt_import
914 gnutls_openpgp_key_export: RENAMED to gnutls_openpgp_crt_export
915 gnutls_openpgp_key_check_hostname: RENAMED to gnutls_openpgp_crt_check_hostname
916 gnutls_openpgp_key_get_creation_time: RENAMED to gnutls_openpgp_crt_get_creation_time
917 gnutls_openpgp_key_get_expiration_time: RENAMED to gnutls_openpgp_crt_get_expiration_time
918 gnutls_openpgp_key_get_fingerprint: RENAMED to gnutls_openpgp_crt_get_fingerprint
919 gnutls_openpgp_key_get_version: RENAMED to gnutls_openpgp_crt_get_version
920 gnutls_openpgp_key_get_pk_algorithm: RENAMED to gnutls_openpgp_crt_get_pk_algorithm
921 gnutls_openpgp_key_get_name: RENAMED to gnutls_openpgp_crt_get_name
922 gnutls_openpgp_key_deinit: RENAMED to gnutls_openpgp_crt_deinit
923 gnutls_openpgp_key_get_id: RENAMED to gnutls_openpgp_crt_get_id
924 gnutls_openpgp_key_get_key_usage: RENAMED to gnutls_openpgp_crt_get_key_usage
925 gnutls_openpgp_key_verify_ring: RENAMED to gnutls_openpgp_crt_verify_ring
926 gnutls_openpgp_key_verify_self: RENAMED to gnutls_openpgp_crt_verify_self
928 * Version 2.1.3 (released 2007-10-17)
930 ** TLS authorization support removed.
931 This technique may be patented in the future, and it is not of crucial
932 importance for the Internet community.  After deliberation we have
933 concluded that the best thing we can do in this situation is to
934 encourage society not to adopt this technique.  We have decided to
935 lead the way with our own actions.
937 ** Re-enabled the 256 bit ciphers in the default priorities.
939 ** Corrected bugs in openpgp key verification using a keyring (both in
940 gnutls and opencdk)
942 ** API and ABI modifications:
943 gnutls_certificate_set_openpgp_keyserver: REMOVED
944 gnutls_authz_data_format_type_t,
945 gnutls_authz_recv_callback_func,
946 gnutls_authz_send_callback_func,
947 gnutls_authz_enable,
948 gnutls_authz_send_x509_attr_cert,
949 gnutls_authz_send_saml_assertion,
950 gnutls_authz_send_x509_attr_cert_url,
951 gnutls_authz_send_saml_assertion_url: REMOVED.
952 GNUTLS_SUPPLEMENTAL_USER_MAPPING_DATA: ADDED.  To avoid that the
953     gnutls_supplemental_data_format_type_t enum type becomes empty.
955 * Version 2.1.2 (released 2007-10-14)
957 ** Removed all the trustdb code from openpgp authentication.
958 We now use only the well-specified keyrings.
960 ** The 256 bit ciphers are not enabled in the default priorities.
962 ** Added support for DSA2 using libgcrypt 1.3.0.
964 ** certtool: Fixed data corruption when using --outder.
966 ** Removed all the xml related stubs and functions.
968 ** Added capability to set a callback after the client hello is received
969 by the server in order to adjust parameters before the handshake.
971 ** SRP was corrected to adhere to the latest draft (published soon as RFC)
973 ** Corrected bug which did not allow a server to run without supporting
974 certificates.
976 ** Updated the DN parser which now prints wrongly decoded values as hex
977 strings.
979 ** certtool: Add option --quick-random.
980 For generating low security test credentials.
982 ** API and ABI modifications:
983 gnutls_x509_crt_to_xml: REMOVED
984 gnutls_openpgp_key_to_xml: REMOVED
985 gnutls_openpgp_key_verify_trustdb: REMOVED
986 gnutls_openpgp_trustdb_init: REMOVED
987 gnutls_openpgp_trustdb_deinit: REMOVED
988 gnutls_openpgp_trustdb_import: REMOVED
989 gnutls_certificate_set_openpgp_trustdb: REMOVED
990 gnutls_srp_client_credentials_function: CHANGED
991 gnutls_handshake_set_post_client_hello_function: ADDED
992 gnutls_mac_get_key_size: ADDED
993 GNUTLS_E_OPENPGP_TRUSTDB_VERSION_UNSUPPORTED: DEPRECATED.
994 GNUTLS_A_MISSING_SRP_USERNAME: DEPRECATED
995 GNUTLS_A_UNKNOWN_SRP_USERNAME: DEPRECATED
997 * Version 2.1.1 (released 2007-09-24)
999 ** Added support for Camellia cipher, thanks to Yoshisato YANAGISAWA.
1000 Camellia is only enabled in GnuTLS if the installed libgcrypt has been
1001 compiled with Camellia support.  See the libgcrypt documentation on
1002 how to enable it.  Unconditionally disable it using the configure
1003 option --disable-camellia.  Fixes #1.
1005 ** Properly document in the NEWS file the API change in the last release.
1007 ** API and ABI modifications:
1008 No changes since last version.
1010 * Version 2.1.0 (released 2007-09-20)
1012 ** Support for draft-rescorla-tls-opaque-prf-input-00.txt.
1013 The support is disabled by default.  Since no value has been allocated
1014 by the IANA for this extension yet, you will need to provide one
1015 yourself by invoking './configure --enable-opaque-prf-input=42'.
1016 Fixes #2.
1018 ** Example code: Fix compilation flaw under MinGW.
1020 ** API and ABI modifications:
1021 gnutls_oprfi_callback_func: ADD, new typedef function prototype.
1022 gnutls_oprfi_enable_client: ADD, new function.
1023 gnutls_oprfi_enable_server: ADD, new function.
1025 * Version 2.0.4 (released 2007-11-16)
1027 ** Corrected bug in decompression of expanded compression data.           
1029 ** API and ABI modifications:
1030 No changes since last version.
1032 * Version 2.0.3 (released 2007-11-10)
1034 ** This version backports several fixes from the 2.1.x branch.
1036 ** Fixed PKCS #3 parameter export.
1038 ** Added gnutls_record_disable_padding() to allow servers talking to
1039 buggy clients that complain if the TLS 1.0 record protocol padding is
1040 used.
1042 ** Introduced gnutls_session_enable_compatibility_mode() to allow enabling
1043 all supported compatibility options (like disabling padding).
1045 ** Corrected bug which did not allow a server to run without supporting
1046 certificates.
1048 ** API and ABI modifications:
1049 gnutls_session_enable_compatibility_mode: ADDED
1050 gnutls_record_disable_padding: ADDED
1052 * Version 2.0.2 (released 2007-10-17)
1054 ** TLS authorization support removed.
1055 This technique may be patented in the future, and it is not of crucial
1056 importance for the Internet community.  After deliberation we have
1057 concluded that the best thing we can do in this situation is to
1058 encourage society not to adopt this technique.  We have decided to
1059 lead the way with our own actions.
1061 ** certtool: Fixed data corruption when using --outder.
1063 ** Fix configure-time Guile detection.
1065 ** API and ABI modifications:
1066 GNUTLS_SUPPLEMENTAL_USER_MAPPING_DATA: ADDED.  To avoid that the
1067     gnutls_supplemental_data_format_type_t enum type becomes empty.
1069 * Version 2.0.1 (released 2007-09-20)
1071 ** New directory doc/credentials/ with test credentials.
1072 This collects the test credentials from the web page and from src/.
1073 The script gnutls-http-serv has also been moved to that directory.
1075 ** Update SRP extension type and cipher suite with official IANA values.
1076 This breaks backwards compatibility with SRP in older versions of
1077 GnuTLS, but this is intentional to speed up the adoption of the
1078 official values.  The old values we used were incorrect.
1080 ** Guile: Fix `x509-certificate-dn-oid'
1082 ** API and ABI modifications:
1083 No changes since last version.
1085 * Version 2.0.0 (released 2007-09-04)
1087 ** Included copy of Libtasn1 upgraded to version 1.1.
1089 ** Disable building of some examples if anonymous ciphers are disabled.
1091 ** Don't build examples for disabled features.
1093 ** API and ABI modifications:
1094 No changes since last version.
1096 * Version 1.7.19 (released 2007-08-27)
1098 ** Fix gnutls_error_is_fatal so that positive "errors" are non-critical.
1099 This solves connection problems in mutt, see
1100 <http://bugs.debian.org/439640>.
1102 ** Update gnulib files.
1103 In particular, the getpass module -- with its dependencies on getline,
1104 getdelim, fseeko etc -- where moved from the lgl/ (used by the core
1105 library) directory to the gl/ directory (only used by the command line
1106 tools).  The reason is that getpass is now only used by the
1107 command-line tools, and reducing the number of gnulib modules linked
1108 to the core library helps portability and reduces size.
1110 ** Fix warnings.
1112 ** Disable building of PGP examples if PGP is disabled.
1114 ** Included copy of OpenCDK upgraded to version 0.6.4.
1116 ** API and ABI modifications:
1117 No changes since last version.
1119 * Version 1.7.18 (released 2007-08-16)
1121 ** Install images for the info manual.
1122 This has a side effect of renaming the images.  See
1123 <http://thread.gmane.org/gmane.comp.tex.texinfo.bugs/3533> for
1124 discussions on the approach chosen.
1126 ** Fix pointer mix to variables of different size.
1127 Patch extracted from
1128 <http://cvs.fedora.redhat.com/viewcvs/devel/gnutls/gnutls-1.6.3-incompat-pointers.patch?rev=1.1&view=auto>.
1130 ** Fix warnings during build.
1131 Thanks to Andreas Metzler <ametzler@downhill.at.eu.org>.
1133 ** API and ABI modifications:
1134 No changes since last version.
1136 * Version 1.7.17 (released 2007-08-15)
1138 ** New functions to perform external signing.
1139 Set the signing callback function (of the gnutls_sign_func prototype)
1140 using the gnutls_sign_callback_set function.  In the callback, you may
1141 find the new functions gnutls_x509_privkey_sign_hash and
1142 gnutls_openpgp_privkey_sign_hash useful.  A new function
1143 gnutls_sign_callback_get is also added, to retrieve the function
1144 pointer.  Thanks to "Alon Bar-Lev" <alon.barlev@gmail.com> for
1145 comments and testing.
1147 ** New self test of client and server authenticated X.509 TLS sessions.
1148 See tests/x509self.c and tests/x509signself.c.  The latter also tests
1149 the new external signing callback interface.
1151 ** New errors GNUTLS_E_APPLICATION_ERROR_MIN..GNUTLS_E_APPLICATION_ERROR_MAX.
1152 These two actually describe the outer limits of a range of error codes
1153 reserved to the application.  All of the errors are treated as fatal
1154 by the library (it has to since it doesn't know the semantics of the
1155 error codes).  This can be useful in callbacks, to signal some
1156 application-specific error condition, which will usually eventually
1157 cause some gnutls API to return the same error code as the callback,
1158 which then can be inspected by the application.  Note that error codes
1159 are negative.
1161 ** gnutls_set_default_priority now disable TLS 1.2 by default.
1162 The RFC is not released yet, and we're approaching a major release so
1163 let's not enable it just yet.
1165 ** Fix namespace so that gnutls_*_t is used consistently.
1166 Before, many places in the GnuTLS code used the old deprecated type
1167 names without the '_t' suffix.
1169 ** Build fixes for Guile code.
1170 Patch from Ludovic Courtes <ludovic.courtes@laas.fr>.
1172 ** More documentation fixes.
1173 In particular, the section headings were modified for casing.  By
1174 Ludovic Courtes <ludovic.courtes@laas.fr>.
1176 ** Updated Polish and Swedish translations.
1177 Thanks to Jakub Bogusz <qboosh@pld-linux.org> and Daniel Nylander
1178 <po@danielnylander.se>.
1180 ** API and ABI modifications:
1181 gnutls_sign_func: ADD, new type for sign callback.
1182 gnutls_sign_callback_set: ADD, new function to set sign callback.
1183 gnutls_sign_callback_get: ADD, new function to retrieve sign callback.
1184 gnutls_x509_privkey_sign_hash,
1185 gnutls_openpgp_privkey_sign_hash: ADD, new functions useful in sign callback.
1186 GNUTLS_E_APPLICATION_ERROR_MIN,
1187 GNUTLS_E_APPLICATION_ERROR_MAX: ADD, new CPP #defines for error codes.
1189 * Version 1.7.16 (released 2007-08-07)
1191 ** Fix sanity checks and return values in certificate selection.
1192 In some cases, GnuTLS omitted to report suitable error codes when no
1193 suitable certificate was found.
1195 ** Fix gnutls-cli starttls EOF on Mac OS X.
1196 Thanks to Hal Eden <n.mavrogiannopoulos@gmail.com>.
1198 ** Documentation fixes.
1199 In particular, the section headings were modified for casing.  By
1200 Ludovic Courtes <ludovic.courtes@laas.fr>.
1202 ** Update gnulib files.
1204 ** API and ABI modifications:
1205 No changes since last version.
1207 * Version 1.7.15 (released 2007-07-02)
1209 ** Fix self-tests key-id under mingw32.
1211 ** Test that the Guile header files are recent enough to work.
1212 Before we just tested that the command line tool 'guile' was recent
1213 enough, which may not be sufficient if you still have an old
1214 libguile.h header installed.
1216 ** Guile bindings are now installed under $prefix by default.
1217 Use --without-guile-site-dir to install it under $pkgdatadir/site/
1218 where $pkgdatadir is as returned by "guile-config info pkgdatadir".
1219 Use --with-guile-site-dir=/your/own/path to specify the path manually.
1220 The default, --with-guile-site-dir, will install the Guile bindings
1221 under $datadir/guile/site.  There is a new section 'Guile
1222 Preparations' in the manual that discuss these issues.
1224 ** Fix run-time library path ordering in linking the Guile bindings.
1226 ** Improved manual on downloading, installing, getting help, bug reports etc.
1227 Suggested by Ludovic Courtès <ludovic.courtes@laas.fr>.
1229 ** Add Malay message translations.
1230 Thanks to Sharuzzaman Ahmat Raslan <sharuzzaman@myrealbox.com>.
1232 ** API and ABI modifications:
1233 No changes since last version.
1235 * Version 1.7.14 (released 2007-06-26)
1237 ** Don't enable Guile bindings unless we have Guile 1.8 or later.
1238 Patch from Ludovic Courtès <ludovic.courtes@laas.fr>.
1240 ** Fix memory leak during DSA signature verification.
1241 Patch from Ludovic Courtès <ludovic.courtes@laas.fr>.
1243 ** Fix crash in gnutls-cli when TLS handshake fails.
1244 Reported by Marc Haber <mh+debian-bugs@zugschlus.de> and Andreas
1245 Metzler <ametzler@downhill.at.eu.org> via Debian BTS #429183, see
1246 <http://bugs.debian.org/429183>.
1248 ** Minor OpenPGP fixes in stream_to_datum.
1249 Patch from Timo Schulz <twoaday@freakmail.de> and Ludovic Courtès
1250 <ludovic.courtes@laas.fr>.
1252 ** Fix off-by-one in TLS 1.2 handshake.
1253 Patch from Ludovic Courtès <ludovic.courtes@laas.fr>.
1255 ** Minor Guile binding self-test cleanup.
1256 Patch from Ludovic Courtès <ludovic.courtes@laas.fr>.
1258 ** Update gnulib files.
1260 ** API and ABI modifications:
1261 No changes since last version.
1263 * Version 1.7.13 (released 2007-06-11)
1265 ** OpenCDK copy updated to version 0.6.3.
1267 ** Build fixes for GnuTLS Guile bindings.
1268 Patch from Ludovic Courtès <ludovic.courtes@laas.fr>.
1270 ** Build fix for GTK-DOC manual.
1272 ** Update gnulib files.
1274 ** API and ABI modifications:
1275 No changes since last version.
1277 * Version 1.7.12 (released 2007-06-08)
1279 ** Guile bindings for GnuTLS have been included.
1280 Contributed by Ludovic Courtès <ludovic.courtes@laas.fr>.  There is a
1281 new chapter 'Guile Bindings' in the manual.
1283 ** Have PKCS8 parser return better error codes.
1284 Reported by Nate Nielsen <nielsen-list@memberwebs.com>, see
1285 <http://lists.gnupg.org/pipermail/gnutls-dev/2007-May/001653.html> and
1286 <http://lists.gnupg.org/pipermail/gnutls-dev/2007-May/001654.html>.
1288 ** Fix mem leak for sessions with client authentication via certificates.
1289 Reported by Andrew W. Nosenko <andrew.w.nosenko@gmail.com>, see
1290 <http://lists.gnupg.org/pipermail/gnutls-dev/2007-April/001539.html>.
1292 ** Fix mem leaks.
1293 Reported by Dennis Vshivkov <walrus@amur.ru>, see
1294 <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=333050>.  Added
1295 self-test tests/parse_ca.c to test regressions.
1297 ** Fix build failures related to missing images in manual.
1298 Reported by Andreas Metzler <ametzler@downhill.at.eu.org>.
1300 ** Update gnulib files.
1302 ** API and ABI modifications:
1303 No changes since last version.
1305 * Version 1.7.11 (released 2007-05-26)
1307 ** Include opencdk.h in the release.
1308 Reported by Roman Bogorodskiy <novel@FreeBSD.org>.
1310 ** API and ABI modifications:
1311 No changes since last version.
1313 * Version 1.7.10 (released 2007-05-25)
1315 ** New API functions to extract DER encoded X.509 Subject/Issuer DN.
1316 Suggested by Nate Nielsen <nielsen-list@memberwebs.com>.
1318 ** Update of gnulib files.
1320 ** GnuTLS is now developed in GIT instead of CVS.
1321 See <http://repo.or.cz/w/gnutls.git> for a public repository.
1323 ** API and ABI modifications:
1324 gnutls_x509_crt_get_raw_issuer_dn: ADD.
1325 gnutls_x509_crt_get_raw_dn: ADD.
1327 * Version 1.7.9 (released 2007-05-12)
1329 ** X.509 certificates are preferred over OpenPGP keys.
1330 This is a change in the semantics of gnutls_set_default_priority.
1332 ** The included copy of OpenCDK has been updated to 0.6.1.
1333 There has been some API changes in OpenCDK, and the GnuTLS layer have
1334 been modified as well.  Note that while there are API/ABI incompatible
1335 changes in OpenCDK, this does not influence GnuTLS's API/ABI because
1336 its API/ABI have not changed.  From this version on, GnuTLS requires
1337 OpenCDK 0.6.0 or later.
1339 ** Fix build failure caused by missing doc/gnutls-logo.pdf.
1341 ** Change certtool's default serial number from 0 to a time-based value.
1343 ** Fix X.509 signing with RSA-PKCS#1 to set a NULL parameters fields.
1344 Before, we remove the parameters field, which resulted in a slightly
1345 different DER encoding which in turn caused signature verification
1346 failures of GnuTLS-generated RSA certificates in some other
1347 implementations (e.g., GnuPG 2.x's gpgsm).  Depending on which RFCs
1348 you read, this may or may not be correct, but our new behaviour appear
1349 to be consistent with other widely used implementations.
1351 ** Fix mem leaks in gnutls_x509_crt_print.
1353 ** API and ABI modifications:
1354 No changes since last version.
1356 * Version 1.7.8 (released 2007-04-16)
1358 ** Added examples for the authorization extension.
1359 See doc/examples/ex-client-authz.c and doc/examples/ex-serv-authz.c.
1361 ** The examples only use gnutls_set_default_priority().
1362 The exception is when DH_ANON is needed.
1364 ** Improve gnutls_set_default_priority() priorities.
1365 The new approach is for it to try and negotiate all secure and
1366 standard mechanisms available.  Currently, DH_ANON ciphersuites and
1367 LZO compressions are not enabled by default, because they are,
1368 respectively, insecure and non-standardized.  Note that TLS 1.2 will
1369 not be enabled by default in non-experimental release until it has
1370 been approved by the IETF.
1372 ** gnutls-cli and gnutls-serv now uses the library's default priorities.
1373 This means that to get DH_ANON and LZO compression, you'll need to
1374 specify that manually using '--kx anon' or '--comp lzo'.
1376 ** Minor fixes to the human display format of X.509 certificates.
1378 ** New APIs to extract Distinguished Name's from X.509 certificates.
1379 Based on patch from Howard Chu <hyc@symas.com>.
1381 ** Improved library searching for opencdk.
1382 It will now add the appropriate -R or -Wl,-rpath flags as necessary.
1383 The deprecated opencdk.m4 is no longer used.
1385 ** New APIs to list supported algorithms in the library.
1386 The APIs are gnutls_cipher_list, gnutls_mac_list,
1387 gnutls_compression_list, gnutls_protocol_list,
1388 gnutls_certificate_type_list, gnutls_kx_list, and
1389 gnutls_cipher_suite_info.  Suggested by Howard Chu <hyc@symas.com>.
1391 ** The gnutls_x509_crt_get_key_id API now handle non-RSA/DSA keys.
1393 ** New configure option --disable-tls-authorization to disable tls-authz.
1395 ** Fix prototype for `gnutls_psk_set_client_credentials'.
1396 The last parameter was renamed from 'flags' to 'format' and the type
1397 changed from 'unsigned int' to 'gnutls_psk_key_flags' (an enum type),
1398 which shouldn't cause any ABI changes.  Reported by ludo@chbouib.org
1399 (Ludovic Courtès).
1401 ** Fix allocation in gnutls_certificate_set_openpgp_key.
1402 Tiny patch from ludo@chbouib.org (Ludovic Courtès).
1404 ** API and ABI modifications:
1405 gnutls_x509_dn_t: ADD.
1406 gnutls_x509_ava_st: ADD.
1407 gnutls_x509_crt_get_subject,
1408 gnutls_x509_crt_get_issuer: ADD.
1409 gnutls_x509_dn_get_rdn_ava: ADD.
1410 gnutls_cipher_list: ADD.
1411 gnutls_mac_list: ADD.
1412 gnutls_compression_list: ADD.
1413 gnutls_protocol_list: ADD.
1414 gnutls_certificate_type_list: ADD.
1415 gnutls_kx_list: ADD.
1416 gnutls_cipher_suite_info: ADD.
1418 * Version 1.7.7 (released 2007-02-22)
1420 ** Support for supplemental handshake messages and authorization data.
1421 Supplemental data is described in RFC 4680 and the authorization
1422 extensions in draft-housley-tls-authz-extns-07.
1424 ** Support for authorization data in gnutls-cli and gnutls-serv.
1425 New parameters --authz-x509-attr-cert and --authz-saml-assertion.
1427 ** Fix for gnutls_x509_crt_check_hostname.
1428 Before it would have reported that the certificate matched a hostname
1429 when it did not have any dNSName or any CN field.  Report and tiny
1430 patch from "Richard W.M. Jones" <rjones@redhat.com>.
1432 ** New self test for RFC 2818 comparison in gnutls_x509_crt_check_hostname.
1433 Tests regressions of the bug, and several other features.
1435 ** GnuTLS now matches URI's with IP Addresses against iPAddress SAN's.
1436 Before there were no support for iPAddress SAN's during comparison.
1438 ** New API to print information about CRL's.
1439 The function is gnutls_x509_crl_print.
1441 ** New API to extract signature value from CRL's.
1442 The function is gnutls_x509_crl_get_signature.
1444 ** Support for directoryName Subject Alternative Name's.
1445 The gnutls_x509_crt_get_subject_alt_name function returns the DN as a
1446 string in the provided buffer.
1448 ** Internal improvements to certtool.
1449 It uses gnutls_x509_crl_print to print CRL information.  It uses some
1450 more gnulib modules to simplify error handling.
1452 ** API and ABI modifications:
1453 GNUTLS_HANDSHAKE_SUPPLEMENTAL: ADD, new gnutls_handshake_description_t element.
1454 gnutls_supplemental_data_format_type_t: ADD.
1455 gnutls_authz_data_format_type_t: ADD.
1456 gnutls_supplemental_get_name: ADD.
1457 gnutls_authz_recv_callback_func,
1458 gnutls_authz_send_callback_func: ADD, callback prototypes.
1459 gnutls_authz_enable: ADD.
1460 gnutls_authz_send_x509_attr_cert,
1461 gnutls_authz_send_saml_assertion,
1462 gnutls_authz_send_x509_attr_cert_url,
1463 gnutls_authz_send_saml_assertion_url: ADD.
1464 GNUTLS_SAN_DN: ADD, new gnutls_x509_subject_alt_name_t element.
1465 gnutls_x509_crl_print: ADD.
1466 gnutls_x509_crl_get_signature: ADD.
1468 * Version 1.7.6 (released 2007-02-12)
1470 ** Support for 'otherName' Subject Alternative Names.
1471 The existing API gnutls_x509_crt_get_subject_alt_name may now return
1472 the new type GNUTLS_SAN_OTHERNAME together with the otherName value.
1473 To find out the otherName OID (necessary for proper parsing of the
1474 value), use the new API gnutls_x509_crt_get_subject_alt_othername_oid.
1475 For known OIDs, gnutls_x509_crt_get_subject_alt_othername_oid will
1476 return "virtual" SAN values, e.g., GNUTLS_SAN_OTHERNAME_XMPP to
1477 simplify OID matching.  Suggested by Matthias Wimmer <m@tthias.eu>.
1479 ** Certtool can print otherName SAN values for certificates.
1480 For known otherName OIDs (currently only id-on-xmppAddr as defined by
1481 RFC 3920), it will also print the name.
1483 ** Fix TLS 1.2 RSA signing in servers.
1484 Before it used the old-style MD5+SHA1 signature, but the TLS
1485 signatures should be normal PKCS#1 signatures.  FYI, we use and
1486 require that DigestInfo parameters are present and NULL for TLS 1.2.
1488 ** Add APIs to access X.509 extensions sequentially.
1489 The existing APIs gnutls_x509_crt_get_extension_oid() and
1490 gnutls_x509_crt_get_extension_by_oid() does not permit callers to
1491 inspect the extensions in the order defined by the certificate.
1493 ** Add API to extract signature value from X.509 certificates.
1494 The function is gnutls_x509_crt_get_signature.
1496 ** Fix crash when generating proxy certificates in batch mode.
1497 If you don't specify a proxy policy in batch mode, it will use
1498 id-ppl-inheritALL.
1500 ** Add API to print information about X.509 certificates.
1501 The function is gnutls_x509_crt_print.
1503 ** Certtool uses the new API gnutls_x509_crt_print to print certificate info.
1504 One consequence of this is that the output syntax has changed
1505 slightly.  Some more fields are printed.
1507 ** Doc fixes.
1509 ** API and ABI modifications:
1510 gnutls_x509_crt_print: ADD
1511 gnutls_certificate_print_formats_t: ADD, new enum.
1512 gnutls_x509_crt_get_signature: ADD.
1513 gnutls_x509_crt_get_extension_data: ADD.
1514 gnutls_x509_crt_get_extension_info: ADD.
1515 gnutls_x509_crt_get_subject_alt_othername_oid: ADD.
1516 GNUTLS_SAN_OTHERNAME: ADD, new gnutls_x509_subject_alt_name_t element.
1517 GNUTLS_SAN_OTHERNAME_XMPP: ADD, new gnutls_x509_subject_alt_name_t element.
1519 * Version 1.7.5 (released 2007-02-06)
1521 ** Servers won't negotiate SRP RSA/DSS cipher suites if no SRP credential
1522 ** is set.
1524 ** Default behaviour for the gnutls-cli and gnutls-serv tools improved.
1526 ** Fix --list output for gnutls-cli and gnutls-serv.
1527 Mention TLS1.2, SHA512 etc.
1529 ** Manual contains new section on setting up a test HTTP server.
1530 A server set up following those descriptions are available online via
1531 <http://www.gnutls.org/server.html>.
1533 ** Update of gnulib files.
1535 ** API and ABI modifications:
1536 No changes since last version.
1538 * Version 1.7.4 (released 2007-02-05)
1540 ** Support for RSA signing using SHA-256/384/512.
1541 A new self test "sha2" tries to build a long X.509 certificate chain
1542 testing all new hashes.
1544 ** The gnutls-serv tool now use static DH parameters if none are supplied.
1546 ** Discuss proxy certificates in the manual.
1548 ** Improve bibliographical citations in the manual.
1550 ** Update of gnulib files.
1552 ** Fix certtool template handling of pathLenConstraints.
1553 It now defaults to -1 instead of 0, which causes the field to be
1554 missing unless the template specify it.
1556 ** API and ABI modifications:
1557 GNUTLS_MAC_SHA256,
1558 GNUTLS_MAC_SHA384,
1559 GNUTLS_MAC_SHA512: New gnutls_mac_algorithm_t values.
1560 GNUTLS_DIG_SHA256,
1561 GNUTLS_DIG_SHA384,
1562 GNUTLS_DIG_SHA512: New gnutls_digest_algorithm_t values.
1563 GNUTLS_SIGN_RSA_SHA256,
1564 GNUTLS_SIGN_RSA_SHA384,
1565 GNUTLS_SIGN_RSA_SHA512: New gnutls_sign_algorithm_t values.
1567 * Version 1.7.3 (released 2007-02-01)
1569 ** New option to certtool: --generate-proxy.
1570 This will generate a Proxy Certificate from an end entity certificate.
1571 Proxy Certificates are documented in RFC 3820.  You will need to
1572 specify the proxy certificate's private key with --load-privkey, the
1573 user certificate with --load-certificate and the private key used to
1574 sign the new proxy certificate with --load-ca-privkey.  Certtool will
1575 query for proxy path length and the policy language OID.  Currently
1576 only OIDs that have an empty policy are supported (which includes the
1577 two OIDs defined by RFC 3820).
1579 ** Certtool --certificate-info now prints information for Proxy Certificates.
1580 Before the proxy extension was just printed as DER encoded data.
1582 ** New APIs to set proxy subject names and get/set proxy cert extension.
1584 ** Fix parsing of pathLenConstraints in BasicConstraints with missing cA.
1586 ** Added self-test to test for regressions of pathLenConstraint bug.
1587 Incidentally, this also test (some) other regressions or changes in
1588 the output from certtool --certificate-info.
1590 ** When certtool generates CA certificates, pressing enter on the path
1591 ** length constraint query will now remove the field.
1592 Before it set the path length constraint to 0, which is a rather poor
1593 default.
1595 ** Certtool now print times in UTC when printing certificate/CRL info.
1597 ** Add better fix to work around C++ compiler bug on Mac OS X.
1598 Reported and tiny patch provided by Matthias Scheler <tron@NetBSD.org>.
1600 ** Fix import of ASCII armored OpenPGP keys.
1601 Patch by ludovic.courtes@laas.fr (Ludovic Courtès).
1603 ** Update of gnulib files.
1605 ** API and ABI modifications:
1606 gnutls_x509_crt_set_proxy_dn: ADD.
1607 gnutls_x509_crt_set_proxy: ADD.
1608 gnutls_x509_crt_get_proxy: ADD.
1610 * Version 1.7.2 (released 2007-01-14)
1612 ** Certtool now print the value of the pathLenConstraints field for certs.
1614 ** Certtool now query for path length constraints when generating CA certs.
1615 For batch uses, the certtool configuration name is "path_len".
1616 Suggested by Sascha Ziemann <sascha.ziemann@secunet.com>.
1618 ** Add new API to get/set pathLenConstraint in the Basic Constraints.
1619 The new functions gnutls_x509_crt_get_basic_constraints and
1620 gnutls_x509_crt_set_basic_constraints provide a superset of the
1621 functionality in the old gnutls_x509_crt_get_ca_status and
1622 gnutls_x509_crt_set_ca_status (respectively), but the old functions
1623 will continue to be supported.
1625 ** Add new API in OpenCDK to extract public/secret OpenPGP key to S-expr.
1626 The functions are cdk_pubkey_to_sexp and cdk_seckey_to_sexp.  A proper
1627 OpenCDK release with this patch will be made soon, which should bump
1628 the OpenCDK version number.  Patch by Mario Lenz <mario.lenz@gmx.net>.
1630 ** Certtool --to-p12 can now store more than one certificate in the blob.
1631 Before it could only store one certificate, but now it will read and
1632 store as many certificate there are from the --load-certificate file.
1633 Suggested by Sascha Ziemann <sascha.ziemann@secunet.com>.
1635 ** Clean up separation of gnutls and gnutls-extra for OpenPGP.
1636 In particular, the OpenPGP function variables are no longer part of
1637 the exported libgnutls interface, and no header files from
1638 libgnutls-extra (GPL) are needed by libgnutls (LGPL).  The variables
1639 were never intended for non-internal purposes, and thus this does not
1640 imply a change in the external API/ABI.
1642 ** Print URL to gaa when missing, and fix srcdir!=builddir for GAA files.
1643 Reported by ludovic.courtes@laas.fr (Ludovic Courtès).
1645 ** GnuTLS no longer uses -mms-bitfields --enable-runtime-pseudo-reloc.
1646 Before these parameters were set to make GnuTLS build under mingw32,
1647 however, they appear to no longer be necessary.
1649 ** A minor fix to the C++ library to make it build.
1650 Reported by Pavlov Konstantin <thresh@altlinux.ru>.
1652 ** Update of gnulib files.
1654 ** API and ABI modifications:
1655 gnutls_x509_crt_get_basic_constraints: ADD.
1656 gnutls_x509_crt_set_basic_constraints: ADD.
1657 cdk_pubkey_to_sexp: ADD (in opencdk).
1658 cdk_seckey_to_sexp: ADD (in opencdk).
1660 * Version 1.7.1 (released 2006-12-28)
1662 ** TLS 1.2 server side fix.
1663 The Certificate Request sent did not contain the list of supported
1664 hashes field, thus violating the protocol.  It will now contain an
1665 empty list.  Reported by ludovic.courtes@laas.fr (Ludovic Courtès).
1667 ** TLS 1.2 DSA signature verification fix.
1668 Reported by ludovic.courtes@laas.fr (Ludovic Courtès).
1670 ** Fix the list of trusted CAs that server's send to clients.
1671 Before, the list contained issuer DN's instead of subject DN's of the
1672 trusted CAs.  Reported by Max Kellermann <max@duempel.org>.
1674 ** Fix gnutls_certificate_set_x509_crl to initialize the CRL before using it.
1675 Also added a self-test in tests/certificate_set_x509_crl.c to test the
1676 function.  Reported by Max Kellermann <max@duempel.org>.
1678 ** Encode UID fields in DN's as DirectoryString.
1679 Before GnuTLS encoded and parsed UID fields as IA5String.  This was
1680 incorrect, it should have used DirectoryString.  Now it will use
1681 DirectoryString for the UID field, but for backwards compatibility it
1682 will also accept IA5String UID's.  Reported by Max Kellermann
1683 <max@duempel.org>.
1685 ** Improve out-of-sourcedir builds from CVS.
1686 Reported by ludovic.courtes@laas.fr (Ludovic Courtès).
1688 ** Bootstrap tools changed.
1689 We now require autoconf 2.61, automake 1.10, and gettext 0.16, when
1690 building GnuTLS from CVS.  Libtool 1.5.22 is used.
1692 ** Fixed a syntax error in lib/gnutls.asn.
1693 Reported by Paul Millar <p.millar@physics.gla.ac.uk>.
1695 ** Added German translation of GnuTLS messages.
1697 ** Update of gnulib files.
1699 ** API and ABI modifications:
1700 No changes since last version.
1702 * Version 1.7.0 (released 2006-11-29)
1704 ** The default protocol priority try TLS 1.1 and TLS 1.2 too.
1705 The details is that the protocol priority set by
1706 `gnutls_set_default_priority' has been changed from TLS 1.0 and SSL
1707 3.0 to TLS 1.2, TLS 1.1, TLS 1.0 and SSL 3.0.
1709 ** Preliminary support for TLS 1.2.
1710 The client has been successfully tested against
1711 https://www.mikestoolbox.org:4433/.
1713 ** Anonself test now print a lot of debugging info, including TLS version.
1715 ** Doc fixes in OpenCDK, to avoid some gtk-doc warnings.
1717 ** Update of gnulib files.
1719 ** API and ABI modifications:
1720 GNUTLS_TLS1_2: New gnutls_protocol_t enum member.
1722 *** Pulled up from stable 1.6.x branch:
1724 ** Fix ./configure failure with non-GCC compilers.
1725 This fixes the following error message:
1726 configure: error: conditional "HAVE_LD_OUTPUT_DEF" was never defined.
1727 Reported by "Michael C. Vergallen" <mvergall@telenet.be>.
1729 * Version 1.6.3 (released 2007-05-26)
1731 ** New API functions to extract DER encoded X.509 Subject/Issuer DN.
1732 Suggested by Nate Nielsen <nielsen-list@memberwebs.com>.  Backported
1733 from the 1.7.x branch, see
1734 <http://lists.gnu.org/archive/html/help-gnutls/2007-05/msg00029.html>.
1736 ** Have PKCS8 parser return better error codes.
1737 Reported by Nate Nielsen <nielsen-list@memberwebs.com>, see
1738 <http://lists.gnupg.org/pipermail/gnutls-dev/2007-May/001653.html> and
1739 <http://lists.gnupg.org/pipermail/gnutls-dev/2007-May/001654.html>.
1741 ** Fix mem leak for sessions with client authentication via certificates.
1742 Reported by Andrew W. Nosenko <andrew.w.nosenko@gmail.com>, see
1743 <http://lists.gnupg.org/pipermail/gnutls-dev/2007-April/001539.html>.
1745 ** Fix building of 'tlsia' self test.
1746 Earlier some gcc are known to build tlsia linking to
1747 $prefix/lib/libgnutls-extra.so rather than the libgnutls-extra.so in
1748 the build directory, even though command line parameters look OK.
1749 Changing order of some parameters fixes it.
1751 ** API and ABI modifications:
1752 gnutls_x509_crt_get_raw_issuer_dn: ADD.
1753 gnutls_x509_crt_get_raw_dn: ADD.
1755 * Version 1.6.2 (released 2007-04-18)
1757 ** Fix X.509 signing with RSA-PKCS#1 to set a NULL parameters fields.
1758 Before, we remove the parameters field, which resulted in a slightly
1759 different DER encoding which in turn caused signature verification
1760 failures of GnuTLS-generated RSA certificates in some other
1761 implementations (e.g., GnuPG 2.x's gpgsm).  Depending on which RFCs
1762 you read, this may or may not be correct, but our new behaviour appear
1763 to be consistent with other widely used implementations.
1765 ** Regenerate the PKIX ASN.1 syntax tree.
1766 For some reason, after changing the ASN.1 type of ldap-UID in the last
1767 release, the generated C file built from the ASN.1 schema was not
1768 refreshed.  This can cause problems when reading/writing UID
1769 components inside X.500 Distinguished Names.  Reported by devel
1770 <dev001@pas-world.com>.
1772 ** Updated translations.
1774 ** API and ABI modifications:
1775 No changes since last version.
1777 * Version 1.6.1 (released 2006-12-28)
1779 ** Fix the list of trusted CAs that server's send to clients.
1780 Before, the list contained issuer DN's instead of subject DN's of the
1781 trusted CAs.  Reported by Max Kellermann <max@duempel.org>.
1783 ** Fix gnutls_certificate_set_x509_crl to initialize the CRL before using it.
1784 Reported by Max Kellermann <max@duempel.org>.
1786 ** Encode UID fields in DN's as DirectoryString.
1787 Before GnuTLS encoded and parsed UID fields as IA5String.  This was
1788 incorrect, it should have used DirectoryString.  Now it will use
1789 DirectoryString for the UID field, but for backwards compatibility it
1790 will also accept IA5String UID's.  Reported by Max Kellermann
1791 <max@duempel.org>.
1793 ** Fix ./configure failure with non-GCC compilers.
1794 This fixes the following error message:
1795 configure: error: conditional "HAVE_LD_OUTPUT_DEF" was never defined.
1796 Reported by "Michael C. Vergallen" <mvergall@telenet.be>.
1798 ** API and ABI modifications:
1799 No changes since last version.
1801 * Version 1.6.0 (released 2006-11-17)
1803 ** No changes since 1.5.5.
1804 The major changes compared to the 1.4.x branch are:
1806 *** A GnuTLS C++ library is part of the official distribution.
1807 Currently there are no examples or documentation, but hopefully this
1808 will change.  See gnutlsxx.h for the API.
1810 *** Windows is a supported platform.
1811 There are, however, two know bugs.  One is related to select() in
1812 command line tools (not, nota bene, in the library), the other is a
1813 problem with libgcrypt that causes delays.  Help is needed to resolve
1814 those issues, so we feel we can't delay the release because of this.
1816 *** New APIs for custom push/pull function error reporting.
1817 The new APIs are gnutls_transport_set_errno and
1818 gnutls_transport_set_global_errno.  See the release notes for version
1819 1.5.4 for more information.
1821 *** Self tests are run under valgrind, if available.  See --disable-valgrind.
1823 * Version 1.5.5 (released 2006-11-16)
1825 ** Correctly bump shared library version after adding new APIs.
1826 This was forgotten in the last release.
1828 ** Fix unsigned vs signed problem in ex-x509-info.c example.
1829 Reported by Tim Kosse <tim.kosse@filezilla-project.org>.
1831 ** Fix the rsa-md5-collision self test to work for MinGW+Wine.
1833 ** Update of gnulib files.
1835 ** API and ABI modifications:
1836 No changes since last version.
1838 * Version 1.5.4 (released 2006-11-07)
1840 ** New API functions to set errno in push/pull functions.
1841 Under Windows, setting the errno variable in a push/pull replacement
1842 may end up setting the wrong errno variable, and GnuTLS send/recv
1843 functions become confused about the real errno returned from a failed
1844 push/pull function.  Therefor, we have added two APIs to set the errno
1845 variable used by GnuTLS.  The APIs can also help to keep things
1846 thread-safe, by avoiding potentially global variables.  Typically,
1847 instead of setting errno in your push/pull function, you will call one
1848 of these functions.  It is recommended to use
1849 gnutls_transport_set_errno, but if you don't have the session variable
1850 easily accessible in the push/pull replacement function, you can use
1851 gnutls_transport_set_global_errno.  Suggested by Tim Kosse
1852 <tim.kosse@filezilla-project.org>.
1854 void gnutls_transport_set_errno (gnutls_session_t session, int err);
1855 void gnutls_transport_set_global_errno (int err);
1857 ** When calling `recv' or `send' Windows errors are handled properly.
1858 The Windows recv/send functions doesn't use errno, and GnuTLS now use
1859 WSAGetLastError to access the error condition instead.
1861 ** Several OpenPGP API fixes.
1862 All suggested by ludovic.courtes@laas.fr (Ludovic Courtès).  The most
1863 important fix is to change the return value of
1864 gnutls_openpgp_privkey_get_pk_algorithm and
1865 gnutls_openpgp_key_get_pk_algorithm from 'int' to
1866 'gnutls_pk_algorithm_t', which is an enum type (and thus API/ABI
1867 compatible with 'int').
1869 ** When a GnuTLS server receive a SSLv2 Client Hello for an unknown TLS
1870 ** version, try to negotiate the highest version support by the GnuTLS server,
1871 ** instead of the lowest.
1872 Reported by <Pasi.Eronen@nokia.com>.
1874 ** Replace old constructs with use of gnulib modules.
1875 For example, we can now assume unistd.h, sys/stat.h, sys/socket.h in
1876 the code.  If the headers doesn't exist on the target system, gnulib
1877 will make sure its replacement header files are used instead.
1879 ** Fix SOVERSION computation for *.def files.
1880 This fixes build errors similar to "No rule to make target
1881 `libgnutls-`expr', needed by `all-am'." when building for Windows.
1883 ** gnutls_check-version uses strverscmp from gnulib.
1885 ** Update of gnulib files.
1887 ** API and ABI modifications:
1888 gnutls_transport_set_errno: ADD
1889 gnutls_transport_set_global_errno: ADD
1891 * Version 1.5.3 (released 2006-10-26)
1893 ** Add new self-test of RSA-MD5 signature chains.
1894 Note that we already, since GnuTLS 1.2.9, reject RSA-MD5 signatures
1895 when verifying X.509 chains.  The code is in tests/rsa-md5-collision/
1896 and is based on the work by Marc Stevens et al, see
1897 <http://www.win.tue.nl/hashclash/TargetCollidingCertificates/>.
1899 ** Re-factor self tests.
1901 ** The include copy of Libtasn1 is updated to version 0.3.7.
1903 ** The included copy of OpenCDK is updated to version 0.5.11.
1905 ** Fix the filename of the *.def file on Windows after library version bump.
1907 ** Separated the gnulib directory into one for LGPL modules and one for GPL.
1908 This allows the GPL'd part of GnuTLS to take advantage of the GPL'd
1909 gnulib modules.  Earlier we could only use the LGPL'ed module from
1910 gnulib, because two gnulib directories in the same project didn't
1911 work.
1913 ** API and ABI modifications:
1914 No changes since last version.
1916 * Version 1.5.2 (released 2006-10-03)
1918 ** Decrement the shared library version back to 13 (as in the 1.4.x branch).
1919 Note that if you installed 1.5.0 or 1.5.1, they will have a higher
1920 shared library version than this version, so you'll have to remove
1921 them and possibly relink your applications.  The reason for this is
1922 that no API/ABI changes have been made since the 1.4.x branch, and
1923 that incrementing the shared library version was a mistake.  Reported
1924 by Andreas Metzler <ametzler@downhill.at.eu.org>.
1926 ** Fix off-by-one error when computing length to malloc.
1927 The code is used by gnutls_openpgp_add_keyring_file and
1928 gnutls_openpgp_add_keyring_mem.  Reported by "Adam Langley"
1929 <agl@imperialviolet.org>.
1931 ** Add version script for the GnuTLS C++ library.
1932 Reported by Andreas Metzler <ametzler@downhill.at.eu.org>.
1934 ** Fix the C++ compiler detection logic.
1935 Reported by Andreas Metzler <ametzler@downhill.at.eu.org>.
1937 ** Update of gnulib files.
1939 ** API and ABI modifications:
1940 No changes since last version.
1942 * Version 1.5.1 (released 2006-09-21)
1944 ** Fix PKCS#1 verification to avoid a variant of Bleichenbacher's
1945 ** Crypto 06 rump session attack.
1946 In particular, we check that the digestAlgorithm.parameters field is
1947 missing or empty, to avoid that it can contain "garbage" that may be
1948 used to alter the numeric properties of the signature.  See
1949 <http://www.imc.org/ietf-openpgp/mail-archive/msg14307.html> (which is
1950 not exactly the same as the problem we fix here).  Reported by Yutaka
1951 OIWA <y.oiwa@aist.go.jp>.
1953 See GNUTLS-SA-2006-4 on http://www.gnutls.org/security.html for more
1954 up to date information.
1956 ** Add self test to test for above flaw.
1958 ** Fix gnutls-cli-debug regarding resume support detection.
1959 Earlier, if the session-id from the server had a length of 0, it would
1960 indicate the the server supports resumption, which isn't the case.
1961 Reported by Kataja Kai <kai.kataja@op.fi>.
1963 ** Fix building of examples on FreeBSD by including netinet/in.h.
1964 Reported by Roman Bogorodskiy <novel@FreeBSD.org>.
1966 ** Fix certtool bug that caused the private key to not be loaded when
1967 generating a certificate with --load-request, which in turn triggered
1968 another unrelated bug in gnutls_x509_crt_sign2 (also fixed).  Reported
1969 by Sascha Ziemann <sascha.ziemann@secunet.com>.
1971 ** gnutls-cli and gnutls-serv works on Windows.
1972 The problem was the select() call that doesn't work on file
1973 descriptors (stdin) on Windows.  We borrowed some code from plibc to
1974 solve this.  It appears to be somewhat unreliable though.
1976 ** Autoconf 2.60 is now used.
1978 ** API and ABI modifications:
1979 No changes since last version.
1981 * Version 1.5.0 (released 2006-08-13)
1983 ** Change SRP and Cert-Type extensions to match IANA registry.
1985 ** Fixed bug in OpenPGP authentication handshake.
1987 ** Improvements for building under MinGW.
1988 Provides internal inet_ntop and inet_pton functions and arpa/inet.h
1989 header.  Calls WSAStartup and WSACleanup in gnutls_global_init and
1990 gnutls_global_deinit, respectively.  Loads getaddrinfo and getnameinfo
1991 at run-time from ws2_32.dll, and falls back on a simple replacement if
1992 it is not available.  Builds the library with -mms-bitfields
1993 -Wl,--enable-runtime-pseudo-reloc.  Links with --output-def, to
1994 create *.def files, which are installed.
1996 ** The examples now (conditionally) include config.h and link to gnulib.
1997 No other source changes were necessary, so the examples should
1998 continue to be possible to use stand-alone without any autoconf or
1999 gnulib stuff.
2001 ** Added C++ header "gnutlsxx.h" and library "libgnutlsxx".
2002 You may unconditionally disable it with --disable-cxx.  See
2003 includes/gnutls/gnutlsxx.h and lib/gnutlsxx.cpp for the
2004 implementation.
2006 ** Made command line tool '--version' behave according to GNU Standards.
2007 This enables 'make distcheck' to succeed.
2009 ** OpenCDK updated to 0.5.9 to fix some problems with OpenPGP support.
2011 ** Make --without-included-libtasn1 work.
2012 Reported by Daniel Black <dragonheart@gentoo.org>.
2014 ** Fix a crash (strcmp() on a NULL value) in the certificate verification logic.
2015 See http://www.gnu.org/software/gnutls/security.html regardging
2016 GNUTLS-SA-2006-2 for more up to date information.  Reported by
2017 satyakumar <satyam_kkd@hyd.hellosoft.com>.
2019 ** API and ABI modifications:
2020 No changes since last version.
2022 * Version 1.4.5 (released 2006-11-06)
2024 ** When a GnuTLS server receive a SSLv2 Client Hello for an unknown TLS
2025 ** version, try to negotiate the highest version support by the GnuTLS server,
2026 ** instead of the lowest.
2027 Reported by <Pasi.Eronen@nokia.com>.
2029 ** Fix typo in doc/examples/ex-serv-pgp.c.
2030 Reported by Adam Langley" <agl@imperialviolet.org>.
2032 ** API and ABI modifications:
2033 No changes since last version.
2035 * Version 1.4.4 (released 2006-09-12)
2037 ** Relax the test that caught signatures that exploit the variant of
2038 ** Bleichenbacher's Crypto 06 rump session attack on our
2039 ** verification logic flaw.
2040 In particular, we now permit the digestAlgorithm.parameters field to
2041 be present but empty, whereas in 1.4.3 we actually checked that the
2042 field was absent.
2044 ** Revert the removal of debug information for the GNUTLS-SA-2006-3 problem.
2045 The messages are only printed in debug mode, which is not recommended
2046 for normal use, and thus logging this situation cannot be abused as an
2047 oracle in typical recommended situations.
2049 ** API and ABI modifications:
2050 No changes since last version.
2052 * Version 1.4.3 (released 2006-09-08)
2054 ** Fix PKCS#1 verification to avoid a variant of Bleichenbacher's
2055 ** Crypto 06 rump session attack.
2056 In particular, we check that the digestAlgorithm.parameters field is
2057 empty, to avoid that it can contain "garbage" that may be used to
2058 alter the numeric properties of the signature.  See
2059 <http://www.imc.org/ietf-openpgp/mail-archive/msg14307.html> (which is
2060 not exactly the same as the problem we fix here).  Reported by Yutaka
2061 OIWA <y.oiwa@aist.go.jp>.
2063 See GNUTLS-SA-2006-4 on http://www.gnutls.org/security.html for more
2064 up to date information.
2066 ** Fix PKCS#1 decryption to avoid Bleichenbacher's Crypto 98 attack.
2067 See <http://www.bell-labs.com/user/bleichen/papers/pkcs.ps.gz>.
2068 Reported by Werner Koch <wk@gnupg.org>.
2070 See GNUTLS-SA-2006-3 on http://www.gnutls.org/security.html for more
2071 up to date information.
2073 ** Fix crash in gnutls_x509_crt_sign2 if passed a NULL issuer_key.
2075 ** API and ABI modifications:
2076 No changes since last version.
2078 * Version 1.4.2 (released 2006-08-12)
2080 ** Fix a crash (strcmp() on a NULL value) in the certificate verification logic.
2081 This can happen if you call gnutls_certificate_verify_peers2 and have
2082 a certain mix of local CA certificates and the peer send special
2083 certificates, that together trigger certain behaviour.  It is not
2084 known at this point whether the crash can be triggered without the
2085 special local CA certificate, and thus turn this into a remote crash
2086 of clients that verify server certificates when they talk to a server
2087 with the special server certificate.  See GNUTLS-SA-2006-2 on
2088 http://www.gnu.org/software/gnutls/security.html for more up to date
2089 information.  Reported by satyakumar <satyam_kkd@hyd.hellosoft.com>.
2091 ** Change SRP and Cert-Type extensions to match IANA registry.
2093 ** OpenCDK updated to 0.5.9 to fix some problems with OpenPGP support.
2095 ** Make --without-included-libtasn1 work.
2096 Reported by Daniel Black <dragonheart@gentoo.org>.
2098 ** API and ABI modifications:
2099 No changes since last version.
2101 * Version 1.4.1 (released 2006-06-14)
2103 ** Replaced inactive ifdefs to enable openpgp support in test programs.
2105 ** Fixed bug in OpenPGP authentication handshake.
2107 ** Fixed typographical in man pages.
2109 ** Build fixes of the manual.
2111 ** Added Swedish translation.
2113 ** API and ABI modifications:
2114 No changes since last version.
2116 * Version 1.4.0 (released 2006-05-15)
2118 ** Remove GnuTLS 0.8.x compatibility functions.
2120 ** The libgcrypt RNG is initialized in gnutls_global_init().
2122 ** TLS/IA API changes from Emile van Bergen.
2123 A dummy credential structure is not needed now, if you wish to use the
2124 low-level TLS/IA API, simply call gnutls_ia_enable to enable TLS/IA on
2125 a session.
2127 ** The self-tests are now run under valgrind, if it is installed.
2129 ** Libtasn1 is updated to 0.3.4, and that version is now required.
2131 ** The command line tools now use getaddrinfo and support IPv6.
2133 ** API and ABI modifications:
2134 _gnutls_x509_get_raw_crt_activation_time,
2135 _gnutls_x509_get_raw_crt_expiration_time: Removed.
2136 gnutls_ia_require_inner_phase: Removed, replaced by gnutls_ia_enable.
2137 gnutls_ia_enable: Added.
2139 * Version 1.3.5 (released 2006-03-08)
2141 ** Error messages are now translated using GNU Gettext.
2143 ** The function gnutls_x509_crt_to_xml now return an internal error.
2144 This means that the code to convert X.509 certificates to XML format
2145 does not work any more.  The reason is that the function called
2146 libtasn1 internal functions.  It seems unclean for libtasn1 to export
2147 the APIs needed here.  Instead it would be better to implement XML
2148 support inside libtasn1 properly.  If you need this functionality
2149 strongly, please consider looking into implementing this suggested
2150 approach instead.  As a workaround, you may also modify lib/x509/xml.c
2151 (change '#if 1' to '#if 0') and build using --with-included-libtasn1.
2153 ** Libraries are now built with libtool's -no-undefined.
2154 This helps producing libraries for Windows using mingw32.
2156 ** Doc fixes to explain that gnutls_record_send can block.
2158 ** Libtasn1 0.3.1 or later is now required.
2159 The include copy has been updated too.
2161 ** gnutls-cli can now recognize services and port numbers with the -p option.
2163 ** API and ABI modifications:
2164 No changes since last version.
2166 * Version 1.3.4 (released 2006-02-09)
2168 ** Fix read of out bounds bug in DER parser.
2169 Reported by Evgeny Legerov <admin@gleg.net>, and debugging help from
2170 Protover SSL.  Libtasn1 0.2.18 is now required, which contains the
2171 previous bug fix.  The included libtasn1 version in GnuTLS has been
2172 updated.
2174 ** Fixed bug in non-blocking gnutls_bye(). gnutls_record_send() will no 
2175 longer invalidate a session if the underlying send fails, but it will 
2176 prevent future writes. That is to allow reading the already received data.
2177 Patches and bug reports by Yoann Vandoorselaere <yoann@prelude-ids.org>
2179 ** Corrected bugs in gnutls_certificate_set_x509_crl() and
2180 gnutls_certificate_set_x509_trust(), that caused memory corruption if 
2181 more than one certificates were added. Report and patch by Max Kellermann.
2183 ** Fix build problems of OpenCDK on AIX.
2184 Thanks to "Heiden, John" <JHeiden@UTNet.UToledo.Edu>.
2186 ** API and ABI modifications:
2187 No changes since last version.
2189 * Version 1.3.3 (released 2006-01-12)
2191 ** New API to access the TLS master secret.
2192 When possible, you should use the TLS PRF functions instead.
2193 Suggested by Jouni Malinen <jkmaline@cc.hut.fi>.
2195 ** Improved handling when multiple libraries use GnuTLS at the same time.
2196 Now gnutls_global_init() can be called multiple times, and
2197 gnutls_global_deinit() will only deallocate the structure when it has
2198 been called as many times as gnutls_global_init() was called.
2200 ** Added a self test of TLS resume functionality.
2202 ** Fix crash in TLS resume code, caused by TLS/IA changes.
2204 ** Documentation fixes about thread unsafety, prompted by
2205 ** discussion with bryanh@giraffe-data.com (Bryan Henderson).
2206 In particular, gnutls_global_init() and gnutls_global_deinit() are not
2207 thread safe.  Careful callers may want to protect the call using a
2208 mutex.  The problem could also be ignored, which would cause a memory
2209 leak under rare conditions when two threads invoke the function
2210 roughly at the same time.
2212 ** Add 'const' keywords in various places, from Frediano ZIGLIO.
2214 ** The code was indented again, including the external header files.
2216 ** API and ABI modifications:
2217 New functions to retrieve the master secret value:
2218   gnutls_session_get_master_secret
2220 Add a 'const' keyword to existing API:
2221   gnutls_x509_crq_get_challenge_password
2223 * Version 1.3.2 (released 2005-12-15)
2225 ** GnuTLS now support TLS Inner application (TLS/IA).
2226 This is per draft-funk-tls-inner-application-extension-01.  This
2227 functionality is added to libgnutls-extra, so it is licensed under the
2228 GNU General Public License.
2230 ** New APIs to access the TLS Pseudo-Random-Function (PRF).
2231 The PRF is used by some protocols building on TLS, such as EAP-PEAP
2232 and EAP-TTLS.  One function to access the raw PRF and one to access
2233 the PRF seeded with the client/server random fields are provided.
2234 Suggested by Jouni Malinen <jkmaline@cc.hut.fi>.
2236 ** New APIs to acceess the client and server random fields in a session.
2237 These fields can be useful by protocols using TLS.  Note that these
2238 fields are typically used as input to the TLS PRF, and if this is your
2239 intended use, you should use the TLS PRF API that use the
2240 client/server random field directly.  Suggested by Jouni Malinen
2241 <jkmaline@cc.hut.fi>.
2243 ** Internal type cleanups.
2244 The uint8, uint16, uint32 types have been replaced by uint8_t,
2245 uint16_t, uint32_t.  Gnulib is used to guarantee the presence of
2246 correct types on platforms that lack them.  The uint type have been
2247 replaced by unsigned.
2249 ** API and ABI modifications:
2250 New functions to invoke the TLS Pseudo-Random-Function (PRF):
2251   gnutls_prf
2252   gnutls_prf_raw
2254 New functions to retrieve the session's client and server random values:
2255   gnutls_session_get_server_random
2256   gnutls_session_get_client_random
2258 New function, to perform TLS/IA handshake:
2259   gnutls_ia_handshake
2261 New function to decide whether to do a TLS/IA handshake:
2262   gnutls_ia_handshake_p
2264 New functions to allocate a TLS/IA credential:
2265   gnutls_ia_allocate_client_credentials
2266   gnutls_ia_free_client_credentials
2267   gnutls_ia_allocate_server_credentials
2268   gnutls_ia_free_server_credentials
2270 New functions to handle the AVP callback:
2271   gnutls_ia_set_client_avp_function
2272   gnutls_ia_set_client_avp_ptr
2273   gnutls_ia_get_client_avp_ptr
2274   gnutls_ia_set_server_avp_function
2275   gnutls_ia_set_server_avp_ptr
2276   gnutls_ia_get_server_avp_ptr
2278 New functions, to toggle TLS/IA application phases:
2279   gnutls_ia_require_inner_phase
2281 New function to mix session keys with inner secret:
2282   gnutls_ia_permute_inner_secret
2284 Low-level API (used internally by gnutls_ia_handshake):
2285   gnutls_ia_endphase_send
2286   gnutls_ia_send
2287   gnutls_ia_recv
2289 New functions that can be used after successful TLS/IA negotiation:
2290   gnutls_ia_generate_challenge
2291   gnutls_ia_extract_inner_secret
2293 Enum type with TLS/IA modes:
2294   gnutls_ia_mode_t
2296 Enum type with TLS/IA packet types:
2297   gnutls_ia_apptype_t
2299 Enum values for TLS/IA alerts:
2300   GNUTLS_A_INNER_APPLICATION_FAILURE
2301   GNUTLS_A_INNER_APPLICATION_VERIFICATION
2303 New error codes, to signal when an application phase has finished:
2304   GNUTLS_E_WARNING_IA_IPHF_RECEIVED
2305   GNUTLS_E_WARNING_IA_FPHF_RECEIVED
2307 New error code to signal TLS/IA verify failure:
2308   GNUTLS_E_IA_VERIFY_FAILED
2310 * Version 1.3.1 (released 2005-12-08)
2312 ** Support for DHE-PSK cipher suites has been added.
2313 This method offers perfect forward secrecy.
2315 ** Fix gnutls-cli STARTTLS hang when SIGINT is sent too quickly, thanks to
2316 Otto Maddox <ottomaddox@fastmail.fm> and Nozomu Ando <nand@mac.com>.
2318 ** Corrected a bug in certtool for 64 bit machines. Reported
2319 by Max Kellermann <max@duempel.org>.
2321 ** New function to set a X.509 private key and certificate pairs, and/or
2322 CRLs, from an PKCS#12 file, suggested by Emile van Bergen
2323 <emile@e-advies.nl>.
2325 The integrity of the PKCS#12 file is protected through a password
2326 based MAC; public-key based signatures for integrity protection are
2327 not supported.  PKCS#12 bags may be encrypted using password derived
2328 symmetric keys, public-key based encryption is not supported.  The
2329 PKCS#8 keys may be encrypted using passwords.  The API use the same
2330 password for all operations.  We believe that any more flexibility
2331 create too much complexity that would hurt overall security, but may
2332 add more PKCS#12 related APIs if real-world experience indicate
2333 otherwise.
2335 ** gnutls_x509_privkey_import_pkcs8 now accept unencrypted PEM PKCS#8 keys,
2336 reported by Emile van Bergen <emile@e-advies.nl>.
2337 This will enable "certtool -k -8" to parse those keys.
2339 ** Certtool now generate keys in unencrypted PKCS#8 format for empty passwords.
2340 Use "certtool -p -8" and press press enter at the prompt.  Earlier,
2341 certtool would have encrypted the key using an empty password.
2343 ** Certtool now accept --password for --key-info and encrypted PKCS#8 keys.
2344 Earlier it would have prompted the user for it, even if --password was
2345 supplied.
2347 ** Added self test of PKCS#8 parsing.
2348 Unencrypted and encrypted (pbeWithSHAAnd3-KeyTripleDES-CBC and
2349 pbeWithSHAAnd40BitRC2-CBC) formats are tested.  The test is in
2350 tests/pkcs8.
2352 ** API and ABI modifications:
2353 New function to set X.509 credentials from a PKCS#12 file:
2354   gnutls_certificate_set_x509_simple_pkcs12_file
2356 New gnutls_kx_algorithm_t enum type:
2357   GNUTLS_KX_DHE_PSK
2359 New API to return session data (basically same as gnutls_session_get_data):
2360   gnutls_session_get_data2
2362 New API to set PSK Diffie-Hellman parameters:
2363   gnutls_psk_set_server_dh_params
2365 * Version 1.3.0 (2005-11-15)
2367 ** Support for TLS Pre-Shared Key (TLS-PSK) ciphersuites have been added.
2368 This add several new APIs, see below.  Read the updated manual for
2369 more information.  A new self test "pskself" has been added, that will
2370 test this functionality.
2372 ** The session resumption data are now system independent.
2374 ** The code has been re-indented to conform to the GNU coding style.
2376 ** Removed the RIPEMD ciphersuites.
2378 ** Added a discussion of the internals of gnutls in manual.
2380 ** Fixes for Tru64 UNIX 4.0D that lack MAP_FAILED, from Albert Chin.
2382 ** Remove trailing comma in enums, for IBM C v6, from Albert Chin.
2384 ** Make sure config.h is included first in a few files, from Albert Chin.
2386 ** Don't use C++ comments ("//") as they are invalid, from Albert Chin.
2388 ** Don't install SRP programs and man pages if --disable-srp-authentication,
2389 from Albert Chin.
2391 ** API and ABI modifications:
2392 New gnutls_kx_algorithm_t key exchange type: GNUTLS_KX_PSK
2394 New gnutls_credentials_type_t credential type:
2395   GNUTLS_CRD_PSK
2397 New credential types:
2398   gnutls_psk_server_credentials_t
2399   gnutls_psk_client_credentials_t
2401 New functions to allocate PSK credentials:
2402   gnutls_psk_allocate_client_credentials
2403   gnutls_psk_free_client_credentials
2404   gnutls_psk_free_server_credentials
2405   gnutls_psk_allocate_server_credentials
2407 New enum type for PSK key flags:
2408   gnutls_psk_key_flags
2410 New function prototypes for credential callback:
2411   gnutls_psk_client_credentials_function
2412   gnutls_psk_server_credentials_function
2414 New function to set PSK username and key:
2415   gnutls_psk_set_client_credentials
2417 New function to set PSK passwd file:
2418   gnutls_psk_set_server_credentials_file
2420 New function to extract PSK user in server:
2421   gnutls_psk_server_get_username
2423 New functions to set PSK callback:
2424   gnutls_psk_set_server_credentials_function
2425   gnutls_psk_set_client_credentials_function
2427 Use size_t instead of int for output size parameter:
2428   gnutls_srp_base64_encode
2429   gnutls_srp_base64_decode
2431 * Version 1.2.11 (2006-05-11)
2432 - The function gnutls_x509_crt_to_xml is not supported any more, and
2433   return an internal error.  The reason is that the function called
2434   internal libtasn1 functions which are no longer exported from
2435   libtasn1.
2436 - Updated libtasn1 requirement to 0.3.4 and refreshed internal mintiasn1.
2437 - Updated gnulib compatibility files.
2438 - Fixed _gnutls_x509_get_raw_crt_expiration_time and
2439   _gnutls_x509_get_raw_crt_activation_time to return (time_t)-1 on errors.
2440 - API and ABI modifications:
2441   No changes since last version.
2443 * Version 1.2.10 (2006-02-09)
2444 - Fix read out bounds bug in DER parser.  Reported by Evgeny Legerov
2445   <admin@gleg.net>, and debugging help from Protover SSL.
2446 - Libtasn1 0.2.18 is now required (contains the previous bug fix).
2447   The included version has been updated too.
2448 - Fix gnutls-cli STARTTLS hang when SIGINT is sent too quickly, thanks to
2449   Otto Maddox <ottomaddox@fastmail.fm> and Nozomu Ando <nand@mac.com>.
2450 - Corrected a bug in certtool for 64 bit machines. Reported
2451   by Max Kellermann <max@duempel.org>.
2452 - Corrected bugs in gnutls_certificate_set_x509_crl() and
2453   gnutls_certificate_set_x509_trust(), that caused memory corruption if
2454   more than one certificates were added. Report and patch by Max Kellermann.
2455 - Fixed bug in non-blocking gnutls_bye(). gnutls_record_send() will no 
2456   longer invalidate a session if the underlying send fails, but it will 
2457   prevent future writes. That is to allow reading the already received data.
2458   Patches and bug reports by Yoann Vandoorselaere <yoann@prelude-ids.org>
2460 * Version 1.2.9 (2005-11-07)
2461 - Documentation was updated and improved.
2462 - RSA-MD2 is now supported for verifying digital signatures.
2463 - Due to cryptographic advances, verifying untrusted X.509
2464   certificates signed with RSA-MD2 or RSA-MD5 will now fail with a
2465   GNUTLS_CERT_INSECURE_ALGORITHM verification output.  For
2466   applications that must remain interoperable, you can use the
2467   GNUTLS_VERIFY_ALLOW_SIGN_RSA_MD2 or GNUTLS_VERIFY_ALLOW_SIGN_RSA_MD5
2468   flags when verifying certificates.  Naturally, this is not
2469   recommended default behaviour for applications.  To enable the
2470   broken algorithms, call gnutls_certificate_set_verify_flags with the
2471   proper flag, to change the verification mode used by
2472   gnutls_certificate_verify_peers2.
2473 - Make it possible to send empty data through gnutls_record_send,
2474   to align with the send(2) API.
2475 - Some changes in the certificate receiving part of handshake to prevent
2476   some possible errors with non-blocking servers.
2477 - Added numeric version symbols to permit simple CPP-based feature
2478   tests, suggested by Daniel Stenberg <daniel@haxx.se>.
2479 - The (experimental) low-level crypto alternative to libgcrypt used
2480   earlier (Nettle) has been replaced with crypto code from gnulib.
2481   This leads to easier re-use of these components in other projects,
2482   leading to more review and simpler maintenance.  The new configure
2483   parameter --with-builtin-crypto replace the old --with-nettle, and
2484   must be used if you wish to enable this functionality.  See README
2485   under "Experimental" for more information.  Internally, GnuTLS has
2486   been updated to use the new "Generic Crypto" API in gl/gc.h.  The
2487   API is similar to the old crypto/gc.h, because the gnulib code were
2488   based on GnuTLS's gc.h.
2489 - Fix compiler warning in the "anonself" self test.
2490 - API and ABI modifications:
2491 gnutls_x509_crt_list_verify: Added 'const' to prototype in <gnutls/x509.h>.
2492                              This doesn't reflect a change in behaviour,
2493                              so we don't break backwards compatibility.
2494 GNUTLS_MAC_MD2: New gnutls_mac_algorithm_t value.
2495 GNUTLS_DIG_MD2: New gnutls_digest_algorithm_t value.
2496 GNUTLS_VERIFY_ALLOW_SIGN_RSA_MD2,
2497 GNUTLS_VERIFY_ALLOW_SIGN_RSA_MD5: New gnutls_certificate_verify_flags values.
2498                                   Use when calling
2499                                   gnutls_x509_crt_list_verify,
2500                                   gnutls_x509_crt_verify, or
2501                                   gnutls_certificate_set_verify_flags.
2502 GNUTLS_CERT_INSECURE_ALGORITHM: New gnutls_certificate_status_t value,
2503                                 used when broken signature algorithms
2504                                 is used (currently RSA-MD2/MD5).
2505 LIBGNUTLS_VERSION_MAJOR,
2506 LIBGNUTLS_VERSION_MINOR,
2507 LIBGNUTLS_VERSION_PATCH,
2508 LIBGNUTLS_VERSION_NUMBER: New CPP symbols, indicating the GnuTLS
2509                           version number, can be used for feature existence
2510                           tests.
2512 * Version 1.2.8 (2005-10-07)
2513 - Libgcrypt 1.2.2 is required to fix a bug for forking GnuTLS servers.
2514 - Don't install the auxilliary libexamples library used by the
2515   examples in doc/examples/ on "make install", report and tiny patch
2516   from Thomas Klausner <tk@giga.or.at>.
2517 - If you pass a X.509 CA or PGP trust database to the command line
2518   tool, it will now abort the connection if the server certificate
2519   validation fails.  Use the parameter --insecure to continue even
2520   after certificate validation failures.  Inspired from discussion
2521   with Alexander Kotelnikov <sacha@myxomop.com>.
2522 - The test for socklen_t has been moved to gnulib.
2523 - Link failures for duplicate or missing "program_name" symbol has been fixed,
2524   patch from Martin Lambers <marlam@marlam.de>.
2525 - The command line tool and the examples no longer uses mmap or bzero,
2526   to make them more portable, patch from Martin Lambers
2527   <marlam@marlam.de>.
2528 - Made the PKCS #12 API handle null passwords. Based on patch by
2529   Anton Altaparmakov <aia21@cam.ac.uk>.
2530 - The GTK-DOC manual should build with current released tools.
2531   (But a copy of the output is included, so the tools are not required.)
2532 - The inet_ntop function is now used through gnulib.
2533 - API and ABI modifications:
2534   No changes since last version.
2536 * Version 1.2.7 (2005-09-09)
2537 - The GNUTLS and GNUTLS-EXTRA libraries are now built with versioned symbols.
2538 - Certtool now complains when reading out-of-range X.509 serial
2539   numbers, suggested by Fran <e_agf@yahoo.es>.
2540 - Certtool now uses the readline library (when available) when reading
2541   X.509 serial numbers.
2542 - Fixed build problems in getpass on uClibc and Mingw32 platforms.
2543 - Fixed compile warning regarding socklen_t on Mingw32, reported by
2544   Martin Lambers <marlam@marlam.de>.
2545 - Fixed examples in doc/examples/, suggested by Fran <e_agf@yahoo.es>.
2546 - Gnulib is now used for the core library, enabling future code cleanups.
2547 - The gnutls-cli tool now use gnutls_certificate_verify_peers2,
2548   suggested by Daniel Stenberg <daniel@haxx.se>.
2549 - Doc fixes for gnutls_transport_set_push and gnutls_transport_set_pull.
2550 - Minilibtasn1 is now 0.2.17 (removed optional use of C99 macros).
2551 - Disable zlib support if zlib.h is not present.
2552 - A number of internal cleanups.
2553 - API and ABI modifications:
2554   No changes since last version.
2556 * Version 1.2.6 (2005-07-16)
2557 - MiniLZO updated to version 2.01 and moved to separate directory.
2558 - Collision between system LZO header files and MiniLZO header file
2559   fixed, reported by Matthias Urlichs <smurf@smurf.noris.de>.
2560 - Will now test for liblzo functionality in liblzo2 too, reported by
2561   Thomas Klausner <tk@giga.or.at>.
2562 - Minilibtasn1 is now 0.2.14 (no code changes).
2563 - Some code changes to avoid GTK-DOC warnings.
2564 - API and ABI modifications:
2565   No changes since last version.
2567 * Version 1.2.5 (2005-07-03)
2568 - More builddir != srcdir fixes, reported by Mike Castle
2569   <dalgoda@ix.netcom.com>.
2570 - Fixed off-by-one bug in the size parameter of gnutls_x509_crt_get*_dn,
2571   reported by Adam Langley <alangley@gmail.com>.
2572 - Corrected some stuff in minilzo detection. Pointed out by 
2573   Sergey Lipnevich.
2574 - MiniLZO updated to version 2.00.
2575 - gnutls_x509_crt_list_import now accept a DER formatted CRL.
2576 - API and ABI modifications:
2577   No changes since last version.
2579 * Version 1.2.4 (2005-05-28)
2580 - Corrected some bugs that could affect 64 bit systems.
2581 - Some corrections in the header files to include the prototype
2582   of memmem properly (affected 64 bit systems). Report and patch
2583   by Yoann Vandoorselaere <yoann@prelude-ids.org>.
2584 - Introduced the --fix-key option to certtool, which can be used to
2585   regenerate the (optional) parameters in a private key. It should
2586   be used together with --key-info.
2587 - Corrected a bug in certificate chain verification that could lead
2588   to marking a trusted chain as non trusted, if the last certificate in
2589   the chain was a self signed one.
2590 - Gnulib portability files were updated.
2591 - License were updated to reflect new FSF address.
2592 - API and ABI modifications:
2593   No changes since last version.
2595 * Version 1.2.3 (2005-04-28)
2596 - Corrected bug in record packet parsing that could lead
2597   to a denial of service attack.
2598 - Corrected bug in RSA key export. Previously exported keys
2599   can be fixed using certtool. Use certtool -k <infile >outfile
2600 - API and ABI modifications:
2601     gnutls_x509_privkey_fix(): Add.
2603 * Version 1.2.2 (2005-04-25)
2604 - gnutls_error_to_alert() now considers
2605   GNUTLS_E_UNEXPECTED_HANDSHAKE_PACKET.
2606 - Fixed error in session resuming that could cause a crash in a session.
2607 - Fixed pkcs12 friendly name and local key identifier decoding.
2608 - Internal cleanups, removed duplicate typedef/struct definitions,
2609   and made source code include external include file, to check
2610   function prototypes during compile time.
2611 - API and ABI modifications:
2612   No changes since last version.  At least not intentional, but due
2613   to the include header changes, there may be inadvertant changes,
2614   please let us know if you find any.
2616 * Version 1.2.1 (2005-04-04)
2617 - gnutls_bye() will no longer fail when RDWR is used and application
2618   data are available for reading.
2619 - Added more strict checks for the SRP parameters (g,n), when they
2620   are not in the included list.
2621 - Added warning to certtool when MD5 is being used for digital
2622   signatures.
2623 - Optimizations ("-O2 -finline-functions") are not enabled by default,
2624   instead the standard autoconf defaults are used.  Use `./configure
2625   CFLAGS="-O2 -finline-functions"' to get the old optimizations.
2626 - Added the option --get-dh-params to certtool, in order to get the
2627   parameters included in the library primes and generators.
2628 - Improved the semantics of GNUTLS_VERIFY_ALLOW_X509_V1_CA_CRT, to
2629   allow only trusted Version 1 CAs and introduced
2630   GNUTLS_VERIFY_ALLOW_ANY_X509_V1_CA_CRT which has the old semantics.
2631 - Nettle self tests now build properly, reported by Pierre
2632   <pierre42d@9online.fr>.
2633 - Eliminated some memory leaks in DHE and RSA-EXPORT cipher suites.
2634   Reported by Yoann Vandoorselaere <yoann@prelude-ids.org>.
2635 - If the library has been compiled with features disabled, a warning is 
2636   issued during the compilation of any program.
2637 - API and ABI modifications:
2638     gnutls_x509_crt_list_import(): Add
2639     gnutls_x509_crq_get_attribute_by_oid(): Add.
2640     gnutls_x509_crq_set_attribute_by_oid(): Add
2641     gnutls_x509_crt_set_extension_by_oid(): Add.
2642     GNUTLS_VERIFY_ALLOW_X509_V1_CA_CRT: Modify semantics.
2643     GNUTLS_VERIFY_ALLOW_ANY_X509_V1_CA_CRT: Add, old behaviour.
2645 * Version 1.2.0 (2005-01-27)
2646 - Added the definitions and OIDs for the RIPEMD-160 hash algorithm.
2647 - Introduced gnutls_x509_crt_sign2(), gnutls_x509_crq_sign2() and 
2648   gnutls_x509_crl_sign2().
2649 - Fixed license header in source code files.
2651 * Version 1.1.23 (2005-01-18)
2652 - It is now possible to generate PKCS#12 structures without private
2653   keys using "certtool --to-p12", suggested by Fabian Fagerholm
2654   <fabbe@paniq.net>.
2655 - Certtool now prints information for the RSA and DSA parameters of
2656   certificates and private keys.
2657 - Corrected the write of CRL distribution points.
2658 - The certificate chain verification function now checks certificates
2659   in the reverse order to minimize the spent resources.
2660 - Corrected several bugs found by Marcin Garski <mgarski@post.pl>
2661 - The functions gnutls_x509_crl_get_issuer_dn, gnutls_x509_crq_get_dn,
2662   gnutls_x509_crt_get_issuer_dn, gnutls_x509_crt_get_dn, and
2663   gnutls_x509_rdn_get now set *sizeof_buf to the buffer length that is
2664   required, instead of the string length.  That is, the value has been
2665   incremented by 1 to account for the terminating zero. Reported by
2666   Martin Lambers <marlam@web.de>.
2667 - Debug output shouldn't crash on platforms that doesn't handle NULL
2668   printf %s values.  Reported by Michael.Ringe@aachen.utimaco.de.
2669 - Sync included copy of libtasn1 with version 0.2.13.
2670 - Client X.509 authenticated connections via gnutls-cli should now work again.
2672 * Version 1.1.22 (2004-11-04)
2673 - Replace GNU LD version script with Libtool -export-symbols-regex,
2674   from Joe Orton <joe@manyfish.co.uk>.
2675 - Documentation improvements.
2676 - Code indented using 'indent -i4 -kr'.
2677 - The API manual is included in Devhelp format.  (Was in last release too,
2678   but the NEWS entry was forgotten.)
2679 - The OpenSSL compatibility code now use the internal crypto interface.
2680 - Added simple self test of OpenSSL compatibility library.
2681 - Internally, libtool convenience libraries are used.
2682 - Cleanups to configure.ac.
2684 * Version 1.1.21 (2004-10-27)
2685 - Print DN of certificates with unknown characters in them, but in hexform
2686   only.
2687 - Added second precision to the X.509 parsing and generation functions.
2688 - Corrected bug in _gnutls_x509_get_dn_oid(), and returns the
2689   actual OID.
2690 - Add parameter --la-file to libgnutls-config and libgnutls-extra-config,
2691   tiny patch contributed by Joe Orton <joe@manyfish.co.uk>.
2692 - Add pkg-config meta files, suggested by Stéphane LOEUILLET
2693   <stephane.loeuillet@tiscali.fr>.
2694 - Fix memory initializaion bug in gnutls_certificate_set_x509_trust,
2695   tiny patch by Aleix Conchillo Flaque <aleix@member.fsf.org>.
2696 - Add self test of PKCS#12 functionality in "certtool", based on test
2697   vectors from Joe Orton <joe@manyfish.co.uk>.
2698 - Fix library order in libgnutls*-config --libs output, to permit
2699   static linking, reported by Yoann Vandoorselaere
2700   <yoann@prelude-ids.org>.
2702 * Version 1.1.20 (2004-10-12)
2703 - Fix compile problem in gl/getpass.c on some systems.
2705 * Version 1.1.19 (2004-10-07)
2706 - Fix memory leak in gnutls_certificate_verify_peers and
2707   gnutls_certificate_free_credentials, report and patch by Simon
2708   Posnjak <simon.posnjak@cetrtapot.si>.
2709 - Fix crash in `certtool --to-p12 --load-privkey foo', i.e. exporting
2710   a key and no certificate to PKCS#12.
2711 - Fix objdir != srcdir builds, reported by "Gerrit P. Haase"
2712   <gp@familiehaase.de>.
2713 - Fixes faulty getpass implementation in libextra/opencdk/, reported
2714   by Yoann Vandoorselaere <yoann@prelude-ids.org>.
2715 - Uses memmem instead of strnstr in lib/.
2716 - Using more GNULib portability files, although not yet inside lib/.
2717 - Added gnutls_certificate_verify_peers to gnutls/compat.h.
2718   Nikos deprecated gnutls_certificate_verify_peers in favor of
2719   gnutls_certificate_verify_peers2 earlier in the 1.1 branch.
2720 - Improvements to the manual.
2721 - Add new example "ex-rfc2818" for certificate verification, from Nikos.
2722 - Known bug: the library require snprintf.  This has not yet been
2723   fixed, but will be handled via GNULib later on.
2725 * Version 1.1.18 (2004-08-24)
2726 - Corrected handling of certificate with dates after year 2038.
2727 - Corrected DER decoder which could incorrectly treat input as BER and fail.
2728 - Correct certtool --smime-to-p7 end of line character handling.
2729 - Added example client and server for anonymous authentication.
2730 - Added self test that tests anonymous TLS client and server.
2731 - Added self tests of Nettle and generic crypto layer.
2732 - Added API reference manual in HTML format in doc/reference/ using GTK-DOC.
2733   Online version at <http://www.gnu.org/software/gnutls/reference/>.
2734 - Assume C89 or better; removed checks for size_t, ptrdiff_t and time_t.
2735 - Man pages for API functions are included.
2737 * Version 1.1.17 (2004-08-18)
2738 - Bug fix of padding string in RSA PKCS#1 v1.5 type 2 encryption,
2739   reported by Robey Pointer <robey@danger.com>.
2740 - Generic crypto interface for secret key ciphers, hashes and randomness added.
2741   See section "Experimental" within section "COMPILATION ISSUES" in README.
2742 - Removed length limit on passwords read by 'certtool'.
2743 - Documentation fixes.
2745 * Version 1.1.16 (2004-08-15)
2746 - Fix missing gnulib linker parameter when building certtool.
2747 - Add gnulib module 'progname', needed by module 'error'.
2748 - Improve building with srcdir != objdir.
2750 * Version 1.1.15 (2004-08-15)
2751 - Certtool has simplistic --smime-to-p7 to translate RFC 2633 messages into
2752   PKCS #7 format.
2753 - Ported to Mac OS X / Darwin.
2754 - Ported to FreeBSD.
2756 * Version 1.1.14 (2004-08-09)
2757 - Documentation converted to Texinfo format.
2758 - Bug fix of test suite.
2759 - Configure now print build information, used by Autobuild.
2761 * Version 1.1.13 (2004-08-05)
2762 - Added simple self test suite.
2764 * Version 1.1.12 (2004-08-02)
2765 - Updated the SRP authentication to conform to the
2766   latest (yet unreleased) draft. Unfortunately this breaks
2767   compatibility with previous versions.
2768 - Changed the makefiles to be more portable.
2769 - SRP ciphersuites were moved to the gnutls library.
2770 - Added some default limits in the verification of certificate
2771   chains, to avoid denial of service attacks. Also added 
2772   gnutls_certificate_set_verify_limits() to override them.
2773   Issue pointed out by Patrik Hornik <patrik@hornik.sk>.
2774 - Added gnutls_certificate_verify_peers2().
2776 * Version 1.1.11 (2004-07-16)
2777 - Added the '_t' suffix to all exported symbols.
2778 - Fixed bug in RSA encryption, report and patch by Martijn Koster 
2779   <mak@greenhills.co.uk>.
2780 - Corrected a bug in certificate verification. Pointed out by
2781   Yoann Vandoorselaere <yoann@prelude-ids.org>
2782 - Added the GNUTLS_VERIFY_DO_NOT_ALLOW_SAME flags to the
2783   verification functions.
2784 - The ephemeral DH and RSA parameters are no longer stored in the
2785   session resume DB.
2786 - Do not free the SRP (prime and generator) parameters obtained from the 
2787   callback if they are the static ones defined in extra.h
2788 - Eliminated some memory leaks. Reported by Yoann Vandoorselaere.
2790 * Version 1.1.10 (2004-06-12)
2791 - Added gnutls_sign_algorithm_get_name() and gnutls_pk_algorithm_get_name()
2792 - Corrected bug in TLS renegotiation.
2793 - Corrected bug in OpenPGP key loading using a callback.
2794 - gnutls-srpcrypt was renamed to srptool
2795 - Allow handshake requests by the client.
2796 - Automatically disable certificate types that do not have corresponding
2797   certificates.
2798 - Added gnutls_auth_client_get_type() and gnutls_auth_server_get_type()
2799 - Opencdk library is being included if not found.
2800 - certtool can now add ip address SAN extension.
2801 - certtool has now support for more X.520 DN attribute types.
2802 - Better handling of EOF in gnutls_record_recv().
2803 - _gnutls_deinit() is no longer used. Sessions are not
2804   automatically removed any more, on abnormal termination.
2805 - Corrected session resuming in SRP ciphersuites.
2806 - Updated to conform to the latest srp draft (draft-ietf-tls-srp-07)
2807 - Added new functions to allow access to the ephemeral
2808   Diffie Hellman parameters.
2809 - Added the functions gnutls_x509_crt_get_pk_rsa_raw() and
2810   gnutls_x509_crt_get_pk_dsa_raw() to retrieve parameters from certificates.
2811 - Added the functions gnutls_dh_get_group(), gnutls_dh_get_pubkey() and
2812   gnutls_rsa_export_get_pubkey() to retrieve parameters of the DH or
2813   RSA-EXPORT key exchange.
2814 - Some fixes in the session resuming code.
2815 - Added gnutls_openpgp_keyring_check_id().
2817 * Version 1.1.9 (2004-04-14)
2818 - Added support for authority key identifier and the extended key usage
2819   X.509 extension fields. The certtoool was updated to support them.
2820 - The RC2 cipher is no more included. The one in libgcrypt is now used.
2821 - Added batch support to certtool. Now it can use templates.
2823 * Version 1.1.8 (2004-04-07)
2824 - Implemented all the tests for the SRP group parameters in
2825   client side. This may lead to incompatibility with very
2826   old gnutls servers.
2827 - Corrected bug in RSA parameters handling which could cause
2828   unexpected crashes.
2829 - Optimized the copying of rsa_params.
2831 * Version 1.1.7 (2004-03-29)
2832 - Added gnutls_certificate_set_params_function() and 
2833   gnutls_anon_set_params_function() that set the RSA or DH
2834   parameters using a callback.
2835 - Added functions gnutls_rsa_params_cpy(), gnutls_dh_params_cpy()
2836   and gnutls_x509_privkey_cpy().
2837 - Corrected a compilation issue when opencdk was installed in a
2838   non standard directory.
2839 - Deprecated: gnutls_srp_server_set_select_function(), 
2840   gnutls_certificate_client_set_select_function(), gnutls_srp_server_set_select_function().
2842 * Version 1.1.6 (2004-02-24)
2843 - Several bug fixes, by Arne Thomassen.
2844 - Fixed a bug where 'server name' extension was always sent.
2846 * Version 1.1.5 (2004-01-06)
2847 - Added the gnutls_sign_algorithm type.
2849 * Version 1.1.4 (2004-01-04)
2850 - Improved gnutls-cli's SRP behaviour in SRP ciphersuites.
2851   If they are of highest priority then the abbreviated handshake
2852   is used.
2853 - Removed all references of missing files.
2854 - Changed handshake behaviour to send the lowest TLS version
2855   when an unsupported version was advertized. The current behaviour
2856   is to send the maximum version we support.
2857 - Corrected problem printing the DC attributes in a DN.
2859 * Version 1.1.3 (2003-12-30)
2860 - Implemented TLS 1.1 (and also obsoleted the TLS 1.0 CBC protection
2861   hack).
2863 * Version 1.1.2 (2003-12-28)
2864 - Added CRL verification functionality to certtool.
2865 - Corrected the CRL distribution point extension handling.
2867 * Version 1.1.1 (2003-12-26)
2868 - Added PKCS #7 support to certtool utility.
2869 - Added support for reading and generating CRL distribution
2870   points extensions in certificates.
2871 - Added support for generating CRLs in the library and the
2872   certtool utility.
2873 - Added support for the Subject Key ID PKIX extension.
2875 * Version 1.1.0 (2003-12-21)
2876 - The error codes GNUTLS_E_NO_TEMPORARY_DH_PARAMS and GNUTLS_E_NO_TEMPORARY_RSA_PARAMS
2877   are no longer returned by the handshake function. Ciphersuites that
2878   require temporary parameters are removed when such parameters do not exist.
2879 - Added the callbacks gnutls_certificate_client_retrieve_function() and
2880   gnutls_certificate_server_retrieve_function(), to allow a client or a server
2881   to specify certificates for the handshake without storing them to the
2882   credentials structure.
2883 - Added support for generating and exporting DSA private keys.
2884 - Added gnutls_x509_crt_set_key_usage() and certtool can now set the
2885   certificate's key usage.
2886 - Added gnutls_openpgp_key_get_key_usage().
2888 * Version 1.0.25 (2005-04-27)
2889 - Corrected bug in record packet parsing that could lead
2890   to a denial of service attack.
2891 - Corrected bug in RSA key export.
2893 * Version 1.0.24 (2005-01-18)
2894 - Corrected several bugs found by Marcin Garski <mgarski@post.pl>
2896 * Version 1.0.23 (2004-11-13)
2897 - Replace GNU LD version script with Libtool -export-symbols-regex,
2898   from Joe Orton <joe@manyfish.co.uk>.
2899 - Copy libtasn1 has been updated to version 0.2.11.
2900 - Corrected the write of CRL distribution points.
2901 - It is now possible to generate PKCS#12 structures without private
2902   keys using "certtool --to-p12", suggested by Fabian Fagerholm
2903   <fabbe@paniq.net>.
2905 * Version 1.0.22 (2004-10-28)
2906 - Print DN of certificates with unknown characters in them, but in hexform
2907   only.
2908 - Corrected bug in _gnutls_x509_get_dn_oid(), and returns the
2909   actual OID.
2910 - Added second precision to the X.509 parsing functions.
2911 - Add parameter --la-file to libgnutls-config and libgnutls-extra-config,
2912   tiny patch contributed by Joe Orton <joe@manyfish.co.uk>.
2913 - Add pkg-config meta files, suggested by Stéphane LOEUILLET
2914   <stephane.loeuillet@tiscali.fr>.
2915 - Fix memory initializaion bug in gnutls_certificate_set_x509_trust,
2916   tiny patch by Aleix Conchillo Flaque <aleix@member.fsf.org>.
2917 - Fix certtool --password for PKCS #12, back ported from 1.1.x branch.
2918 - Fix library order in libgnutls*-config --libs output, to permit
2919   static linking, reported by Yoann Vandoorselaere
2920   <yoann@prelude-ids.org>.
2922 * Version 1.0.21 (2004-10-07)
2923 - Fix memory leak in gnutls_certificate_verify_peers and
2924   gnutls_certificate_free_credentials, report and patch by Simon
2925   Posnjak <simon.posnjak@cetrtapot.si>.
2926 - Fix crash in `certtool --to-p12 --load-privkey foo', i.e. exporting
2927   a key and no certificate to PKCS#12.
2928 - Fix objdir != srcdir builds, reported by "Gerrit P. Haase"
2929   <gp@familiehaase.de>.
2930 - Avoid redefining getpass if system already has it, reported by
2931   Yoann Vandoorselaere <yoann@prelude-ids.org>.
2932 - Add new example "ex-rfc2818" for certificate verification, from Nikos.
2933 - Known bug: the library require snprintf.
2935 * Version 1.0.20 (2004-08-18)
2936 - Bug fix of padding string in RSA PKCS#1 v1.5 type 2 encryption,
2937   reported by Robey Pointer <robey@danger.com>.
2939 * Version 1.0.19 (2004-08-09)
2940 - Bug fix of test suite.
2942 * Version 1.0.18 (2004-08-05)
2943 - Added simple self test suite.
2945 * Version 1.0.17 (2004-08-02)
2946 - Updated the SRP authentication to conform to the
2947   latest (yet unreleased) draft. Unfortunately this breaks
2948   compatibility with previous versions.
2949 - Changed the makefiles to be more portable.
2950 - Added some default limits in the verification of certificate
2951   chains, to avoid denial of service attacks. Also added 
2952   gnutls_certificate_set_verify_limits() to override them.
2953   Issue pointed out by Patrik Hornik <patrik@hornik.sk>.
2954 - Added gnutls_certificate_verify_peers2().
2956 * Version 1.0.16 (2004-07-10)
2957 - Do not free the SRP (prime and generator) parameters obtained from the 
2958   callback if they are the static ones defined in extra.h.
2959 - Eliminated some memory leaks. Reported by Yoann Vandoorselaere.
2960 - Some fixes in the makefiles.
2962 * Version 1.0.15 (2004-06-29)
2963 - Fixed bug in RSA encryption, report and patch by Martijn Koster 
2964   <mak@greenhills.co.uk>.
2965 - Corrected a bug in certificate verification. Pointed out by
2966   Yoann Vandoorselaere <yoann@prelude-ids.org>.
2968 * Version 1.0.14 (2004-06-12)
2969 - Automatically disable certificate types that do not have corresponding
2970   certificates.
2971 - Updates in the documentation.
2972 - certtool can now add ip address SAN extension.
2973 - certtool has now support for more X.520 DN attribute types.
2974 - Opencdk library is being included if not found.
2975 - Added gnutls_openpgp_keyring_check_id().
2976 - Corrected a serious bug in the included libtasn1 library.
2977 - Corrected session resuming in SRP ciphersuites.
2978 - Updated to conform to the latest srp draft (draft-ietf-tls-srp-07)
2979 - Added the functions gnutls_x509_crt_get_pk_rsa_raw() and
2980   gnutls_x509_crt_get_pk_dsa_raw() to retrieve parameters from certificates.
2981 - Some fixes in the session resuming code.
2983 * Version 1.0.13 (2004-04-29)
2984 - Some complilation fixes.
2985 - Added the --xml parameter to the certtool utility.
2987 * Version 1.0.12 (2004-04-23)
2988 - Corrected bug in OpenPGP key loading using a callback.
2989 - Renamed gnutls-srpcrypt to srptool
2990 - Allow handshake requests by the client.
2991 * Things backported from the development branch:
2992 - Added support for authority key identifier and the extended key usage
2993   X.509 extension fields. The certtoool was updated to support them.
2994 - Added batch support to certtool. Now it can use templates.
2995 - The RC2 cipher is no more included. The one in libgcrypt is now used.
2997 * Version 1.0.11 (2004-04-17)
2998 - Added gnutls_sign_algorithm_get_name() and gnutls_pk_algorithm_get_name()
2999 - Corrected bug in TLS renegotiation.
3001 * Version 1.0.10 (2004-04-03)
3002 - Corrected bug in RSA parameters handling which could cause
3003   unexpected crashes.
3004 - Corrected bug in SSL 3.0 authentication.
3006 * Version 1.0.9 (2004-03-29)
3007 - Added gnutls_certificate_set_params_function() and 
3008   gnutls_anon_set_params_function() that set the RSA or DH
3009   parameters using a callback.
3010 - Added functions gnutls_rsa_params_cpy(), gnutls_dh_params_cpy()
3011   and gnutls_x509_privkey_cpy().
3012 - Corrected a compilation issue when opencdk was installed in a
3013   non standard directory.
3014 - Documented the changes need in multi-threaded application due
3015   to the new libgcrypt.
3017 * Version 1.0.8 (2004-02-28)
3018 - Corrected bug in mutual certificate authentication in SSL 3.0.
3020 * Version 1.0.7 (2004-02-25)
3021 - Implemented TLS 1.1 (and also obsoleted the TLS 1.0 CBC protection
3022   hack).
3023 - Some updates in the documentation.
3025 * Version 1.0.6 (2004-02-12)
3026 * Backported things from the development branch (while maintaining
3027   backwards compatibility):
3028 - Improved gnutls-cli's SRP behaviour in SRP ciphersuites.
3029   If they are of highest priority then the abbreviated handshake
3030   is used.
3031 - The error codes GNUTLS_E_NO_TEMPORARY_DH_PARAMS and GNUTLS_E_NO_TEMPORARY_RSA_PARAMS
3032   are no longer returned by the handshake function. Ciphersuites that
3033   require temporary parameters are removed when such parameters do not exist.
3034 - Added the callbacks gnutls_certificate_client_retrieve_function() and
3035   gnutls_certificate_server_retrieve_function(), to allow a client or a server
3036   to specify certificates for the handshake without storing them to the
3037   credentials structure.
3038 - Added support for generating and exporting DSA private keys.
3040 * Version 1.0.5 (2004-02-11)
3041 - Fixed a bug where 'server name' extension was always sent.
3042 * Backported things from the development branch:
3043 - Added CRL verification functionality to certtool.
3044 - Corrected the CRL distribution point extension handling.
3045 - Added PKCS #7 support to certtool utility.
3046 - Added support for reading and generating CRL distribution
3047   points extensions in certificates.
3048 - Added support for generating CRLs in the library and the
3049   certtool utility.
3050 - Added support for the Subject Key ID PKIX extension.
3051 - Added the gnutls_sign_algorithm type.
3053 * Version 1.0.4 (2004-01-04)
3054 - Changed handshake behaviour to send the lowest TLS version
3055   when an unsupported version was advertized. The current behaviour
3056   is to send the maximum version we support.
3057 - certtool no longer asks the password in unencrypted private
3058   keys.
3059 - The source is now compiled to use the reentrant libc functions.
3061 * Version 1.0.3 (2003-12-21)
3062 - Corrected bug in gnutls_bye() which made it return an error code
3063   of INVALID_REQUEST instead of success.
3064 - Corrected a bug in the GNUTLS_KEY key usage definitions.
3066 * Version 1.0.2 (2003-12-18)
3067 - Corrected a bug in the RSA key generation. This was
3068   generating unusable RSA keys.
3070 * Version 1.0.1 (2003-12-10)
3071 - Some minor fixes in the makefiles. They now include CFLAGS
3072   from libgcrypt or opencdk if installed in a non standard directory.
3073 - Fixed the SRP detection test in gnutls-cli-debug.
3074 - Added gnutls_rsa_params_export_pkcs1() and gnutls_rsa_params_import_pkcs1().
3076 * Version 1.0.0 (2003-12-04)
3077 - Exported the static SRP group parameters.
3078 - Some fixes in the certificate authenticated SRP ciphersuites.
3079 - Improved the support for draft-ietf-tls-srp-05. The two-phase
3080   handshake is now fully supported without any interaction with
3081   the application layer (except for a callback).
3083 * Version 0.9.99 (2003-11-28)
3084 - Some fixes in the gnutls.h header for the gnutls_server_name_set()
3085   and gnutls_server_name_get() prototypes.
3086 - Exported the gnutls_x509_privkey_sign_data(), gnutls_x509_privkey_verify_data() 
3087   and gnutls_x509_crt_verify_data().
3088 - Some fixes in the openpgp authentication.
3089 - Removed the Twofish cipher.
3091 * Version 0.9.98 (2003-11-16)
3092 - The openssl compatibility layer was moved to gnutls-openssl
3093   library instead of being included in the gnutls-extra library.
3094 - Added the RIPEMD ciphersuites defined in draft-ietf-tls-openpgp-keys-04.
3095 - Building with openpgp support is now mandatory.
3096 - gnutls4 compatibility header is no longer included by default in
3097   gnutls.h.
3098 - gnutls8 function usage yelds a deprecation warning in gcc3.
3099 - gnutls_x509_*_set_dn_by_oid() and gnutls_x509_*_get_*_dn_by_oid()
3100   functions have a raw_flag parameter added.
3101 - Added gnutls_x509_*_get_dn_oid() and gnutls_x509_crt_get_extension_oid()
3102   functions which return the available OIDs.
3104 * Version 0.9.97 (2003-11-11)
3105 - The certtool utility can now generate PKCS #12 structures
3106   without specifying a certificate.
3107 - Added capability to read CRLs to certtool.
3108 - Corrected some functions which return GNUTLS_E_SHORT_MEMORY_BUFFER
3109   to properly set the required buffer size.
3110 - Corrected a bug in libgcrypt detection.
3112 * Version 0.9.96 (2003-11-09)
3113 - Some changes to allow compilation with mingw32.
3114 - Several code cleanups.
3116 * Version 0.9.95 (2003-11-02)
3117 - Improved the verification functions. Added new verification
3118   output flags and removed the unused and redundant ones.
3119 - Improved the OpenPGP key support.
3120 - The prime utility was removed, and its functionality was moved
3121   to certtool.
3123 * Version 0.9.94 (2003-10-30)
3124 - Added manpages for the included programs.
3125 - Documented and improved the certtool utility. 
3126 - Added PKCS #12 support to certtool utility.
3128 * Version 0.9.93 (2003-10-26)
3129 - Corrected some compilation issues.
3130 - Improved the certtool command line utility.
3132 * Version 0.9.92 (2003-10-25)
3133 - The RFC2818 hostname verification is now case insensitive.
3134 - Added support for generating X.509 certificates.
3135 - Added the certtool, a tool for generating X.509 certificates
3137 * Version 0.9.91 (2003-10-17)
3138 - Fixed a compilation issue in the openpgp authentication part.
3140 * Version 0.9.90 (2003-10-08)
3141 - Updated the openpgp key API (depends on the unreleased new
3142   opencdk).
3144 * Version 0.9.8 (2003-10-02)
3145 - Updated the SRP implementation to follow the latest draft
3146   (draft-ietf-tls-srp-05).
3147 - Improved the gnutls-cli behaviour in error handling,
3148   and added a check for the peer's hostname.
3149 - Use versioned symbols in the library (where available).
3150 - RIJNDAEL ciphersuites were renamed to AES.
3152 * Version 0.9.7 (2003-08-25)
3153 - The tex files are now included in the distribution.
3154 - The library can now decrypt PKCS #12 files encrypted with
3155   the RC2-40 cipher.
3156 - The missing rfc2818_hostname object is now included.
3157 - Several corrections and bug fixes in the library by 
3158   Arne Thomassen <arne@arne-thomassen.de>.
3159 - CR is now allowed in the base64 decoder.
3161 * Version 0.9.6 (2003-06-28)
3162 - Added gnutls_x509_privkey_get_key_id() and gnutls_x509_crt_get_key_id()
3163   functions which return a unique (per public key) ID. These can
3164   be used to check if the private key corresponds to a given certificate.
3165 - Corrections in the TLS layer openpgp certificate packet parser.
3166 - Corrected a bug in the record layer buffering, which affected
3167   the case where external pull function was used. Report and patch
3168   by Sergey Poznyakoff <gray@Mirddin.farlep.net>.
3169 - Corrected a bug in gnutls-srpcrypt where a non allocated variable
3170   was freed.
3171 - SRP programs are now built by default.
3172 - Added API to read and write to PKCS #12 structures. Prototypes
3173   in gnutls/pkcs12.h.
3174 - The gnutls_transport_ptr type was changed to a pointer type (void*).
3176 * Version 0.9.5 (2003-04-06)
3177 - Several improvements in the PKCS #7 handling
3178 - Eliminated several hard coded constants in MPI parameters.
3180 * Version 0.9.4 (2003-03-28)
3181 - Corrected a parsing error in the Certificate request message.
3182 - Corrected behaviour when a certificate request message is received.
3183   Now a certificate packet is always sent, and in SSL 3.0 cipher suites
3184   a no_certificate alert is sent instead.
3185 - Added functionality to generate PKCS #7 structures (with certificates).
3187 * Version 0.9.3 (2003-03-24)
3188 - Support for MD2 was dropped. 
3189 - Improved the error logging functions, by adding a level, and
3190   by allowing debugging messages just by increasing the level.
3191 - The diffie Hellman ciphersuites are now of higher priority than
3192   the plain RSA.
3193 - The RSA premaster secret version check can no longer be disabled.
3194 - Implemented the counter measure discussed in the paper "Attacking
3195   RSA-based Sessions in SSL/TLS", against the attack described in the
3196   same paper.
3197 - Added the functions: gnutls_handshake_get_last_in(), 
3198   gnutls_handshake_get_last_out().
3199 - The gnutls_certificate_set_rsa_params() was renamed to 
3200   gnutls_certificate_set_rsa_export_params().
3201 - Added the new functions: gnutls_certificate_set_x509_key()
3202   gnutls_certificate_set_x509_trust(), gnutls_certificate_set_x509_crl(),
3203   gnutls_x509_crt_export(), gnutls_x509_crl_export().
3204 - Added support for encoding and decoding PKCS #8 2.0 encrypted 
3205   RSA private keys.
3207 * Version 0.9.2 (2003-03-15)
3208 - Some corrections in the memory mapping code (file is unmapped after 
3209   it is read).
3210 - Added support for PKCS#10 certificate requests generation.
3212 * Version 0.9.1 (2003-03-12)
3213 - Corrected a bug in 64 bit architectures, which affected the
3214   serial number calculation in the record layer.
3215 - Added gnutls_certificate_free_keys() which deletes all the
3216   private keys and certificates from the credentials structure.
3217 - Corrected a broken buffer check in _gnutls_io_read_buffered(),
3218   which caused some unexpected packet length errors. Report and patch
3219   by Ian Peters <itp@ximian.com>.
3220 - Added ability to generate RSA keys.
3221 - Increased the maximum parameter size in order to read some large keys
3222   by some CAs. Patch by Ian Peters <itp@ximian.com>.
3223 - Added an strnstr() function and the requirement in some functions to
3224   use null terminated PEM structures is no more.
3225 - Use mmap() if available to read files.
3226 - Fixed a memory leak in SRP code reported by Rupert Kittinger 
3227   <r.kittinger@efkon.com>.
3229 * Version 0.9.0 (2003-03-03)
3230 - This version is not binary compatible with the previous ones.
3231 - The library notifies the application on empty and illegal SRP usernames, 
3232   so that proper notification (via an alert) is sent to the peer.
3233 - Added ability to send some messages back to the application using
3234   the gnutls_global_set_log_function().
3235 - gnutls_dh_params_generate() and gnutls_rsa_params_generate() now use 
3236   gnutls_malloc() to allocate the output parameters.
3237 - Added support for MD2 algorithm in certificate signature verification.
3238 - The RSA and DH parameter generation interface was changed. Added
3239   ability to import and export from and to PKCS3 structures. This 
3240   was needed to read parameters generated using the openssl dhparam tool.
3241 - Several changes in the temporary (DH/RSA) parameter codebase. No DH 
3242   parameters are now included in the library. Also the credentials structure 
3243   can now hold only one temporary parameter of a kind.
3244 - Added a new Certificate, CRL, Private key and PKCS7 structures handling 
3245   API, defined in gnutls/x509.h
3246 - Added gnutls_certificate_set_verify_flags() function to allow setting the 
3247   verification flags in the credentials structure. They will be used in the
3248   *verify_peers functions.
3249 - Added protection against the new TLS 1.0 record layer timing attack.
3250 - Added support for Certificate revocation lists. Functions defined
3251   in gnutls/x509.h
3252 - The only functions that were removed are:
3253   gnutls_x509_certificate_to_xml()
3254   gnutls_x509_extract_dn_string()
3255 - Ported to libtasn1 0.2.x
3257 * Version 0.8.1 (2003-01-22)
3258 - Improved the SRP support, to prevent attackers guessing the
3259   available usernames by brute force.
3260 - Improved the SRP detection in gnutls-cli-debug
3261 - Some fixes which now allow compilation.
3263 * Version 0.8.0 (2003-01-20)
3264 - Added gnutls_x509_extract_dn_string() which returns a 
3265   distinguished name in a single string.
3266 - Added gnutls_openpgp_extract_key_name_string() which returns
3267   an openpgp user ID in a single string.
3268 - Added gnutls_x509_extract_certificate_ca_status() which returns
3269   the CA status of the given certificate.
3270 - Added SRP-6 support. Follows draft-ietf-tls-srp-04.
3271 - If libtasn1 is not present in the system, it is included in 
3272   the main gnutls library.
3273 - If liblzo is present in the system, then the included minilzo
3274   will not be used, and libgnutls-extra will depend on liblzo.
3275 - GNUTLS_E_PARSING_ERROR error code was replaced by GNUTLS_E_BASE64_DECODING_ERROR, 
3276   and GNUTLS_E_SRP_PWD_PARSING_ERROR. GNUTLS_E_ASCII_ARMOR_ERROR was also 
3277   replaced by GNUTLS_E_BASE64_DECODING_ERROR.
3279 * Version 0.6.0 (2002-12-08)
3280 - Added "gnutls/compat4.h" header. This is included in gnutls.h
3281   to emulate the old 0.4.x API.
3282 - Example programs are now stored in doc/examples/
3283 - Several improvements and updates in the documentation.
3284 - Added the certificate authenticated SRP cipher suites.
3285 - gnutls_x509_extract_certificate_dn_string() was updated to return
3286   an RFC2253 conforming string.
3287 - Added the SRP related functions:
3288    gnutls_srp_verifier()
3289    gnutls_srp_base64_encode()
3290    gnutls_srp_base64_decode()
3291 - Added the function gnutls_srp_set_server_credentials_function()
3292   to allow retrieving SRP parameters from an external backend - other
3293   than password files.
3294 - Added the function gnutls_openpgp_set_recv_key_function()
3295   which can be used to set a callback, to get OpenPGP keys.
3296 - Exported the functions:
3297    gnutls_malloc()
3298    gnutls_free()
3299   which should be used by callback functions.
3300 - Changed the semantics of gnutls_pem_base64_encode_alloc()
3301   and gnutls_pem_base64_decode_alloc(). In the default case
3302   were the gnutls library is used with malloc/realloc/free,
3303   these are binary compatible.
3305 * Version 0.5.11 (2002-11-05)
3306 - Some fixes in 'gnutls-cli' client program to prevent some segmentation 
3307   faults at exit.
3308 - Example programs found in the documentation can now be generated by
3309   running "make examples" in doc/tex directory.
3310 - Added more descriptive error strings, to gnutls_strerror().
3311 - Documented error codes, and the function reference list is now sorted.
3312 - Optimized buffering code.
3313 - gnutls_x509_extract_certificate_dn_string() was rewritten.
3314 - Added GNUTLS_E_SHORT_MEMORY_BUFFER error code, which is returned in the
3315   case where the memory buffer provided is not long enough.
3316 - Depends on the new OpenCDK 0.3.2.
3318 * Version 0.5.10 (2002-10-13)
3319 - Updated documentation.
3320 - Added server name extension. This allows clients to specify the
3321   name of the server they connect to. Useful to HTTPS.
3322 - Several corrections in the code base, mostly in signed/unsigned,
3323   checkings.
3325 * Version 0.5.9 (2002-10-10)
3326 - Corrected some code which worked fine in gcc 3.2, but not with any
3327   other compiler.
3328 - Updated 'gnutls-cli' with the '--starttls' option, to allow testing
3329   starttls implementations.
3330 - Added gnutls_x509_extract_key_pk_algorithm() function which extracts
3331   the private key type, of a DER encoded key.
3332 - Added gnutls_x509_extract_certificate_dn_string() which returns the 
3333   certificate's distinguished name in a single string.
3334 - Added gnutls_set_default_priority() and gnutls_set_default_export_priority()
3335   functions, to avoid calling all the *_priority() functions if the defaults
3336   are acceptable.
3337 - Added int gnutls_x509_check_certificates_hostname() which check whether
3338   the given hostname matches the owner of the given X.509 certificate.
3340 * Version 0.5.8 (2002-09-25)
3341 - Updated documentation.
3342 - Added gnutls_record_get_direction() which replaces the obsolete
3343   gnutls_handshake_get_direction().
3344 - Added function to convert error codes to alert descriptions
3345 - Added LZO compression
3347 * Version 0.5.7 (2002-09-11)
3348 - Some fixes in the memory allocation functions (realloc).
3349 - Improved the string functions used in XML certificate generation.
3350 - Removed dependency on libgdbm.
3351 - Corrected bug in gnutls_dh_params_set() which affected
3352   gnutls_dh_params_deinit().
3353 - Corrected bug in session resuming code in server side.
3355 * Version 0.5.6 (2002-09-06)
3356 - Corrected bugs in SRP implementation, which prevented gnutls 
3357   to interoperate with other implementations. (interoperability testing
3358   was done by David Taylor)
3359 - Corrected bug in cert_type extension.
3360 - Corrected extension type checks which used an 8 bit extension size,
3361   instead of 16 bits.
3362 - Added versioning in the XML output of certificate functions.
3363 - Removed the X.509 test suite.
3365 * Version 0.5.5 (2002-09-03)
3366 - Updated the SRP implementation to the latest draft. The blowfish
3367   crypt implementation was removed, since the new draft does not allow
3368   other hash algorithms except for the srpsha. 
3369 - Renamed all the constructed types in order to have more consistent
3370   names. 
3371 - Improved the certificate and key read functions. Now they can read 
3372   the certificate and the private key from the same file.
3373 - Updated and corrected documentation.
3375 * Version 0.5.4 (2002-08-27)
3376 - Fixes in TLS 1.0 PRF and SSL3 random functions.
3377 - gnutls_handshake_set_exportable_detection() was obsoleted.
3378 - Added gnutls_openpgp_extract_key_id() which returns the key ID.
3379 - Corrected bug in DHE key exchange
3380 - Added support for temporary RSA keys which are needed for the
3381   export cipher suites.
3382 - Added the TLS_RSA_EXPORT_ARCFOUR_40_MD5 ciphersuite.
3384 * Version 0.5.3 (2002-08-23)
3385 - No changes. Replaces the tarball of 0.5.2 which accidentally contained
3386   code from the unstable branch.
3388 * Version 0.5.2 (2002-08-22)
3389 - Added an error code that is returned in clients which connect
3390   to export only servers. This must be enabled using the
3391   gnutls_handshake_set_exportable_detection() function.
3392 - Updated openssl compatibility layer.
3393 - Added gnutls_handshake_get_direction() function which returns
3394   the state of the handshake when interrupted.
3396 * Version 0.5.1 (2002-07-17)
3397 - Corrected the m4 macros which used <gnutls.h> instead of
3398   <gnutls/gnutls.h>
3399 - Documentation fixes
3400 - Added gnutls_transport_set_ptr2() function, which accepts two
3401   different pointers, to be used while receiving, and 
3402   while sending data.
3403 - Semantic changes in gnutls_record_set_max_size(). The requested
3404   size is now immediately enforced at the output buffers.
3405 - gnutls_global_init_extra() now fails if the library versions do
3406   not match.
3407 - Fixes in client and server example programs. Null encryption can
3408   be used in these programs, to assist in debuging.
3409 - Fixes in zlib compression code.
3411 * Version 0.5.0 (2002-07-06)
3412 - Added X.509 certificate tests in tests/ directory
3413 - Removed stubs for SRP and Anonymous authentication. They served
3414   no purpose since they are always included, unless it was requested
3415   not to do so.
3416 - Added gnutls_handshake_set_private_extensions() function. This
3417   function can be used to enable private (gnutls specific) cipher suites
3418   and compression algorithms.
3419 - Added check for C99 macro support by the compiler.
3420 - Added functions gnutls_b64_encode_fmt2() and gnutls_b64_decode_fmt2()
3421 - Added the new libtasn1 library.
3422 - Removed the gdbm backend. Applications are now responsible for the
3423   session resuming backend. The gnutls-serv application contains an
3424   simple example on how to use gdbm for resuming.
3425 - Headers for the gnutls library are now installed in $(includedir)/gnutls
3426 - Added an OpenSSL compatible interface (with some limitations).
3427 - Added functions to convert DER encoded certificates to XML format.
3429 * Version 0.4.4 (2002-06-24)
3430 - Corrected bug in PKCS-1 RSA encryption which prevented gnutls to encrypt
3431   using keys of some specific size.
3433 * Version 0.4.3 (2002-05-23)
3434 - The gnutls-extra library now compiles fine, if the opencdk library is
3435   not present.
3436 - Several bug fixes.
3437 - Added gnutls_global_set_mem_func() function, to set the memory allocation
3438   functions, if other than the defaults are to be used.
3439 - The default memory allocation functions are now the ones in libc.
3441 * Version 0.4.2 (2002-05-21)
3442 - Separated ASN.1 structures parser documentation and TLS library
3443   documentation.
3444 - Added gnutls_handshake_set_rsa_pms() function, which disables the
3445   version check in RSA premaster secret.
3446 - Added gnutls_session_is_resumed() function, which reports if a session
3447   is a resumed one.
3448 - Added gnutls_state_set_ptr() and gnutls_state_get_ptr() functions, to
3449   assist in callback functions.
3450 - Replaced the included 1024 bit prime for Diffie Hellman, with a new
3451   random one.
3452 - Relicensed the library under the GNU Lesser General Public License
3453 - Added gnutls-extra library which contains the GPL covered code of gnutls.
3455 * Version 0.4.1 (2002-04-07)
3456 - Now uses alloca() for temporary variables
3457 - Optimized RSA signing
3458 - Added functions to return the peer's certificate activation and
3459   expiration time.
3460 - Corrected time function's behaviour (the time value returned no longer
3461   relate to local timezone).
3463 * Version 0.4.0 (2002-04-01)
3464 - Added support for RFC2630 (PKCS7) X.509 certificate sets
3465 - Added new functions: gnutls_x509_extract_certificate_pk_algorithm(),
3466   gnutls_openpgp_extract_key_pk_algorithm().
3467 - Several optimizations in the Handshake protocol
3468 - Several optimizations in RSA algorithm
3469 - Unified the return values because of small buffers.
3471 * Version 0.3.92 (2002-03-23)
3472 - Updated documentation
3473 - Combined error codes of ASN.1 parser and gnutls
3474 - Removed GNUTLS_CERT_TRUSTED from the CertificateStatus enumeration
3475 - Added protection against CBC chosen plaintext attack (disabled by default)
3476 - Improved and optimized compression support
3478 * Version 0.3.91 (2002-03-03)
3479 - Added gnutls-cli-debug program
3480 - Corrections in session resumption
3481 - Rehandshake can now handle negotiation of different authentication
3482   type.
3483 - gnutls-cli, gnutls-serv, gnutls-srpcrypt and gnutls-cli-debug are 
3484   now being installed.
3486 * Version 0.3.90 (2002-02-24)
3487 - Handshake messages are not kept in memory any more. Now we use 
3488   less memory during a handshake
3489 - Added support for certificates with DSA parameters
3490 - Added DHE_DSS cipher suites
3491 - Key exchange methods changed so they do not depend on the 
3492   certificate type. Added certificate type negotiation TLS extension.
3493 - Added openpgp key support (EXPERIMENTAL)
3494 - Improved Diffie Hellman key exchange support.
3495 - Bug fixes in the RSA key exchange.
3496 - Added check for the requested TLS extensions
3497 - TLS extensions now use a 16 bit type field.
3498 - Added a minimal string library to assist in ASN.1 parsing
3499 - Changes in ASN.1 parser to work with the new bison
3500 - Added gnutls_x509_extract_subject_alt_name(), which deprecates 
3501   gnutls_x509_extract_subject_dns_name()
3502 - gnutls_x509_set_trust_(file/mem) can now be called multiple times
3503 - gnutls_srp_server_set_cred_file() can now be called multiple times
3505 * Version 0.3.5 (2002-01-25)
3506 - Corrected the RSA key exchange method, to avoid attacks against
3507   PKCS-1 formating.
3509 * Version 0.3.4 (2002-01-20)
3510 - Corrected bugs in DHE_RSA key exchange method
3512 * Version 0.3.3 (2002-01-19)
3513 - Added gnutls_x509pki_verify_certificate()
3514 - Added gnutls_x509pki_set_trust_mem() and gnutls_x509pki_set_key_mem()
3515 - Bug fixes in srpcrypt (based on patch by Marc Huber)
3516 - Bug fixes in the Handshake protocol (based on patch by Guillaume Morin)
3517 - Corrected library versioning
3519 * Version 0.3.2 (2002-01-05)
3520 - Corrected bug which did not allow a client to accept multiple CA names
3521 - Added gnutls_fingerprint()
3522 - Added gnutls_x509pki_extract_certificate_serial()
3523 - Added gnutls_b64_encode_fmt() and gnutls_b64_decode_fmt()
3524 - Corrected behaviour in version advertizing
3525 - Updated documentation
3526 - Prefixed all types in gnutls.h with 'GNUTLS_' to avoid namespace collisions
3528 * Version 0.3.1 (2001-12-21)
3529 - Corrections in the configuration files
3530 - Fixes a bug in anonymous authentication
3532 * Version 0.3.0 (2001-12-17)
3533 - Corrected bug in new integer formatting (now we use the old format again)
3534 - Several corrections and usual cleanups
3536 * Version 0.2.91 (2001-12-10)
3537 - Fixes in MPI handling (fixes possible bug with signed integers)
3538 - Removed name indication extension
3539 - Added gnutls_transport_get_ptr() and gnutls_db_get_ptr()
3540 - Optimizations in server certificate callback.
3541 - Fixes in anonymous authentication
3542 - Corrections in client ciphersuite selection
3544 * Version 0.2.90 (2001-12-07)
3545 - gnutls_handshake(), gnutls_read() etc. functions no longer require
3546   the 'SOCKET cd' argument. This argument is set using the function
3547   gnutls_set_transport_ptr().
3548 - introduced gnutls_x509pki_get_peer_certificate_list(). This function returns
3549   a list containing peer's certificate and issuers DER encoded.
3550 - Updated X.509 certificate handling API
3551 - Added callback to select the server certificate
3552 - More consistent function naming (changes in several function names)
3553 - Buffer overflow checking in ASN.1 structures parser
3554 - Updated documentation
3556 * Version 0.2.11 (2001-11-16)
3557 - Changed the meaning of GNUTLS_E_REHANDSHAKE value. If this value
3558   is returned, then the caller should perform a handshake or send
3559   an alert to the peer.
3560 - Made receive buffer dynamic. Normally if no large chunks are received
3561   it occupies less space.
3562 - Added max_record_size extension
3563 - Bugfixes in session handling
3564 - Improved non blocking IO support in the Handshake Protocol
3565 - Usual bugfixes and cleanups
3566 - Documentation updated (includes ASN.1 documentation)
3568 * Version 0.2.10 (2001-11-05)
3569 - Corrected bugs and improved non blocking IO
3570 - Added hooks to use external database to store sessions
3571 - Usual cleanups
3573 * Version 0.2.9 (2001-10-27)
3574 - AUTH_INFO types and structures were moved to library internals
3575 - AUTH_FAILED is no longer returned in SRP authentication
3576   (any fatal error in SRP means auth failed)
3577 - Introduced GNUTLS_E_INTERRUPTED
3578 - Added support for non blocking IO
3579 - gnutls_recv() and gnutls_send() are now obsolete
3580 - Changed semantics of gnutls_rehandshake()
3582 * Version 0.2.4 (2001-10-12)
3583 - Better handling of X.509 certificate extensions
3584 - Added DHE_RSA ciphersuites
3585 - Updated the Name Indication (dnsname) extension
3586 - Improvements in Diffie Hellman primes handling
3588 * Version 0.2.3 (2001-09-19)
3589 - Memory optimizations in gnutls_recv()
3590 - Fixed several memory leaks
3591 - Added ability to specify callback for x509 client certificate selection
3592 - Better documentation
3594 * Version 0.2.2 (2001-08-21)
3595 - Several bugfixes (library and documentation)
3597 * Version 0.2.1 (2001-08-07)
3598 - SRP fixes
3600 * Version 0.2.0 (2001-08-07)
3601 - Partial support for X.509v3 Certificate extensions.
3602 - Added Internal memory handlers
3603 - Removed gnutls_x509_set_cn()
3604 - Added X.509 client authentication
3605 - Several bug fixes and protocol fixes
3607 * Version 0.1.9 (2001-07-30)
3608 - Corrected bug(s) in ChangeCipherSpec packet (fixes renegotiate)
3609 - SRP is updated to conform to the newest draft.
3610 - Added support for DNSNAME extension.
3611 - Reentracy fixes in ASN.1 Parsing.
3612 - Optimizations in hash/hmac functions
3613 - (Error) message handling has changed
3614 - Better Protocol Version handling
3615 - Added X.509 Certificate Verification
3616 - gnutls_read() semantics are now closer to read(2) - added EOF
3617 - Documented some part of gnutls in doc/tex/ using Latex
3619 * Version 0.1.4 (2001-06-22)
3620 - Corrected (srp) base64 encoding.
3621 - Changed bcrypt algorithm to include username.
3622 - Added RSA Ciphersuites (no certificate checking).
3623 - Fixes in SSL 2.0 client hello parsing.
3624 - Added ASN.1 and DER parsers.
3625 - Bugfixes in session resuming
3626 - Updated Ciphersuite selection algorithm
3627 - Added internal representation of X.509 structures.
3628 - Added global state
3630 * Version 0.1.3 (2001-06-01)
3631 - Updated API (and the way it is documented - we use inline documentation)
3632 - Added function to access alert messages.
3633 - Added support for renegotiating parameters.
3634 - Better and Faster Resume Database handling.
3635 - Several bugfixes
3637 * Version 0.1.2 (2001-05-14)
3638 - Updated API
3639 - Fixes in extension handling
3641 * Version 0.1.1 (2001-05-13)
3642 - Added compatibility with Stanford's libsrp library
3644 * Version 0.1.0 (2001-05-09)
3645 - Added SSL 2.0 client hello support
3646 - GNUTLS is a gnu library
3647 - Added support for TLS extensions.
3648 - Added support for SRP
3650 * Version 0.0.7 (2001-01-11)
3651 - Added server side session resuming (using gdbm)
3652 - Added twofish algorithm
3654 * Version 0.0.6 (2000-12-20)
3655 - Added client side session resuming
3656 - Better documentation (check doc/API)
3657 - Better socket handling (gnutls can be used with select())
3658 - Some primitive support for non blocking IO and socket options has been added.
3660 * Version 0.0.5 (2000-12-07)
3661 - Added Compression (using ZLIB)
3662 - Added SSL 3.0 support
3664 ----------------------------------------------------------------------
3665 Copying and distribution of this file, with or without modification,
3666 are permitted in any medium without royalty provided the copyright
3667 notice and this notice are preserved.