Reformat, fix typos and clarify CMS API docs.
[openssl.git] / NEWS
1
2   NEWS
3   ====
4
5   This file gives a brief overview of the major changes between each OpenSSL
6   release. For more details please read the CHANGES file.
7
8   Major changes between OpenSSL 0.9.8f and OpenSSL 0.9.8g:
9
10       o Fixes for bugs introduced with 0.9.8f.
11
12   Major changes between OpenSSL 0.9.8e and OpenSSL 0.9.8f:
13
14       o Add gcc 4.2 support.
15       o Add support for AES and SSE2 assembly lanugauge optimization
16         for VC++ build.
17       o Support for RFC4507bis and server name extensions if explicitly 
18         selected at compile time.
19       o DTLS improvements.
20       o RFC4507bis support.
21       o TLS Extensions support.
22
23   Major changes between OpenSSL 0.9.8d and OpenSSL 0.9.8e:
24
25       o Various ciphersuite selection fixes.
26       o RFC3779 support.
27
28   Major changes between OpenSSL 0.9.8c and OpenSSL 0.9.8d:
29
30       o Introduce limits to prevent malicious key DoS  (CVE-2006-2940)
31       o Fix security issues (CVE-2006-2937, CVE-2006-3737, CVE-2006-4343)
32       o Changes to ciphersuite selection algorithm
33
34   Major changes between OpenSSL 0.9.8b and OpenSSL 0.9.8c:
35
36       o Fix Daniel Bleichenbacher forged signature attack, CVE-2006-4339
37       o New cipher Camellia
38
39   Major changes between OpenSSL 0.9.8a and OpenSSL 0.9.8b:
40
41       o Cipher string fixes.
42       o Fixes for VC++ 2005.
43       o Updated ECC cipher suite support.
44       o New functions EVP_CIPHER_CTX_new() and EVP_CIPHER_CTX_free().
45       o Zlib compression usage fixes.
46       o Built in dynamic engine compilation support on Win32.
47       o Fixes auto dynamic engine loading in Win32.
48
49   Major changes between OpenSSL 0.9.8 and OpenSSL 0.9.8a:
50
51       o Fix potential SSL 2.0 rollback, CVE-2005-2969
52       o Extended Windows CE support
53
54   Major changes between OpenSSL 0.9.7g and OpenSSL 0.9.8:
55
56       o Major work on the BIGNUM library for higher efficiency and to
57         make operations more streamlined and less contradictory.  This
58         is the result of a major audit of the BIGNUM library.
59       o Addition of BIGNUM functions for fields GF(2^m) and NIST
60         curves, to support the Elliptic Crypto functions.
61       o Major work on Elliptic Crypto; ECDH and ECDSA added, including
62         the use through EVP, X509 and ENGINE.
63       o New ASN.1 mini-compiler that's usable through the OpenSSL
64         configuration file.
65       o Added support for ASN.1 indefinite length constructed encoding.
66       o New PKCS#12 'medium level' API to manipulate PKCS#12 files.
67       o Complete rework of shared library construction and linking
68         programs with shared or static libraries, through a separate
69         Makefile.shared.
70       o Rework of the passing of parameters from one Makefile to another.
71       o Changed ENGINE framework to load dynamic engine modules
72         automatically from specifically given directories.
73       o New structure and ASN.1 functions for CertificatePair.
74       o Changed the ZLIB compression method to be stateful.
75       o Changed the key-generation and primality testing "progress"
76         mechanism to take a structure that contains the ticker
77         function and an argument.
78       o New engine module: GMP (performs private key exponentiation).
79       o New engine module: VIA PadLOck ACE extension in VIA C3
80         Nehemiah processors.
81       o Added support for IPv6 addresses in certificate extensions.
82         See RFC 1884, section 2.2.
83       o Added support for certificate policy mappings, policy
84         constraints and name constraints.
85       o Added support for multi-valued AVAs in the OpenSSL
86         configuration file.
87       o Added support for multiple certificates with the same subject
88         in the 'openssl ca' index file.
89       o Make it possible to create self-signed certificates using
90         'openssl ca -selfsign'.
91       o Make it possible to generate a serial number file with
92         'openssl ca -create_serial'.
93       o New binary search functions with extended functionality.
94       o New BUF functions.
95       o New STORE structure and library to provide an interface to all
96         sorts of data repositories.  Supports storage of public and
97         private keys, certificates, CRLs, numbers and arbitrary blobs.
98         This library is unfortunately unfinished and unused withing
99         OpenSSL.
100       o New control functions for the error stack.
101       o Changed the PKCS#7 library to support one-pass S/MIME
102         processing.
103       o Added the possibility to compile without old deprecated
104         functionality with the OPENSSL_NO_DEPRECATED macro or the
105         'no-deprecated' argument to the config and Configure scripts.
106       o Constification of all ASN.1 conversion functions, and other
107         affected functions.
108       o Improved platform support for PowerPC.
109       o New FIPS 180-2 algorithms (SHA-224, -256, -384 and -512).
110       o New X509_VERIFY_PARAM structure to support parametrisation
111         of X.509 path validation.
112       o Major overhaul of RC4 performance on Intel P4, IA-64 and
113         AMD64.
114       o Changed the Configure script to have some algorithms disabled
115         by default.  Those can be explicitely enabled with the new
116         argument form 'enable-xxx'.
117       o Change the default digest in 'openssl' commands from MD5 to
118         SHA-1.
119       o Added support for DTLS.
120       o New BIGNUM blinding.
121       o Added support for the RSA-PSS encryption scheme
122       o Added support for the RSA X.931 padding.
123       o Added support for BSD sockets on NetWare.
124       o Added support for files larger than 2GB.
125       o Added initial support for Win64.
126       o Added alternate pkg-config files.
127
128   Major changes between OpenSSL 0.9.7l and OpenSSL 0.9.7m:
129
130       o FIPS 1.1.1 module linking.
131       o Various ciphersuite selection fixes.
132
133   Major changes between OpenSSL 0.9.7k and OpenSSL 0.9.7l:
134
135       o Introduce limits to prevent malicious key DoS  (CVE-2006-2940)
136       o Fix security issues (CVE-2006-2937, CVE-2006-3737, CVE-2006-4343)
137
138   Major changes between OpenSSL 0.9.7j and OpenSSL 0.9.7k:
139
140       o Fix Daniel Bleichenbacher forged signature attack, CVE-2006-4339
141
142   Major changes between OpenSSL 0.9.7i and OpenSSL 0.9.7j:
143
144       o Visual C++ 2005 fixes.
145       o Update Windows build system for FIPS.
146
147   Major changes between OpenSSL 0.9.7h and OpenSSL 0.9.7i:
148
149       o Give EVP_MAX_MD_SIZE it's old value, except for a FIPS build.
150
151   Major changes between OpenSSL 0.9.7g and OpenSSL 0.9.7h:
152
153       o Fix SSL 2.0 Rollback, CVE-2005-2969
154       o Allow use of fixed-length exponent on DSA signing
155       o Default fixed-window RSA, DSA, DH private-key operations
156
157   Major changes between OpenSSL 0.9.7f and OpenSSL 0.9.7g:
158
159       o More compilation issues fixed.
160       o Adaptation to more modern Kerberos API.
161       o Enhanced or corrected configuration for Solaris64, Mingw and Cygwin.
162       o Enhanced x86_64 assembler BIGNUM module.
163       o More constification.
164       o Added processing of proxy certificates (RFC 3820).
165
166   Major changes between OpenSSL 0.9.7e and OpenSSL 0.9.7f:
167
168       o Several compilation issues fixed.
169       o Many memory allocation failure checks added.
170       o Improved comparison of X509 Name type.
171       o Mandatory basic checks on certificates.
172       o Performance improvements.
173
174   Major changes between OpenSSL 0.9.7d and OpenSSL 0.9.7e:
175
176       o Fix race condition in CRL checking code.
177       o Fixes to PKCS#7 (S/MIME) code.
178
179   Major changes between OpenSSL 0.9.7c and OpenSSL 0.9.7d:
180
181       o Security: Fix Kerberos ciphersuite SSL/TLS handshaking bug
182       o Security: Fix null-pointer assignment in do_change_cipher_spec()
183       o Allow multiple active certificates with same subject in CA index
184       o Multiple X509 verification fixes
185       o Speed up HMAC and other operations
186
187   Major changes between OpenSSL 0.9.7b and OpenSSL 0.9.7c:
188
189       o Security: fix various ASN1 parsing bugs.
190       o New -ignore_err option to OCSP utility.
191       o Various interop and bug fixes in S/MIME code.
192       o SSL/TLS protocol fix for unrequested client certificates.
193
194   Major changes between OpenSSL 0.9.7a and OpenSSL 0.9.7b:
195
196       o Security: counter the Klima-Pokorny-Rosa extension of
197         Bleichbacher's attack 
198       o Security: make RSA blinding default.
199       o Configuration: Irix fixes, AIX fixes, better mingw support.
200       o Support for new platforms: linux-ia64-ecc.
201       o Build: shared library support fixes.
202       o ASN.1: treat domainComponent correctly.
203       o Documentation: fixes and additions.
204
205   Major changes between OpenSSL 0.9.7 and OpenSSL 0.9.7a:
206
207       o Security: Important security related bugfixes.
208       o Enhanced compatibility with MIT Kerberos.
209       o Can be built without the ENGINE framework.
210       o IA32 assembler enhancements.
211       o Support for new platforms: FreeBSD/IA64 and FreeBSD/Sparc64.
212       o Configuration: the no-err option now works properly.
213       o SSL/TLS: now handles manual certificate chain building.
214       o SSL/TLS: certain session ID malfunctions corrected.
215
216   Major changes between OpenSSL 0.9.6 and OpenSSL 0.9.7:
217
218       o New library section OCSP.
219       o Complete rewrite of ASN1 code.
220       o CRL checking in verify code and openssl utility.
221       o Extension copying in 'ca' utility.
222       o Flexible display options in 'ca' utility.
223       o Provisional support for international characters with UTF8.
224       o Support for external crypto devices ('engine') is no longer
225         a separate distribution.
226       o New elliptic curve library section.
227       o New AES (Rijndael) library section.
228       o Support for new platforms: Windows CE, Tandem OSS, A/UX, AIX 64-bit,
229         Linux x86_64, Linux 64-bit on Sparc v9
230       o Extended support for some platforms: VxWorks
231       o Enhanced support for shared libraries.
232       o Now only builds PIC code when shared library support is requested.
233       o Support for pkg-config.
234       o Lots of new manuals.
235       o Makes symbolic links to or copies of manuals to cover all described
236         functions.
237       o Change DES API to clean up the namespace (some applications link also
238         against libdes providing similar functions having the same name).
239         Provide macros for backward compatibility (will be removed in the
240         future).
241       o Unify handling of cryptographic algorithms (software and engine)
242         to be available via EVP routines for asymmetric and symmetric ciphers.
243       o NCONF: new configuration handling routines.
244       o Change API to use more 'const' modifiers to improve error checking
245         and help optimizers.
246       o Finally remove references to RSAref.
247       o Reworked parts of the BIGNUM code.
248       o Support for new engines: Broadcom ubsec, Accelerated Encryption
249         Processing, IBM 4758.
250       o A few new engines added in the demos area.
251       o Extended and corrected OID (object identifier) table.
252       o PRNG: query at more locations for a random device, automatic query for
253         EGD style random sources at several locations.
254       o SSL/TLS: allow optional cipher choice according to server's preference.
255       o SSL/TLS: allow server to explicitly set new session ids.
256       o SSL/TLS: support Kerberos cipher suites (RFC2712).
257         Only supports MIT Kerberos for now.
258       o SSL/TLS: allow more precise control of renegotiations and sessions.
259       o SSL/TLS: add callback to retrieve SSL/TLS messages.
260       o SSL/TLS: support AES cipher suites (RFC3268).
261
262   Major changes between OpenSSL 0.9.6j and OpenSSL 0.9.6k:
263
264       o Security: fix various ASN1 parsing bugs.
265       o SSL/TLS protocol fix for unrequested client certificates.
266
267   Major changes between OpenSSL 0.9.6i and OpenSSL 0.9.6j:
268
269       o Security: counter the Klima-Pokorny-Rosa extension of
270         Bleichbacher's attack 
271       o Security: make RSA blinding default.
272       o Build: shared library support fixes.
273
274   Major changes between OpenSSL 0.9.6h and OpenSSL 0.9.6i:
275
276       o Important security related bugfixes.
277
278   Major changes between OpenSSL 0.9.6g and OpenSSL 0.9.6h:
279
280       o New configuration targets for Tandem OSS and A/UX.
281       o New OIDs for Microsoft attributes.
282       o Better handling of SSL session caching.
283       o Better comparison of distinguished names.
284       o Better handling of shared libraries in a mixed GNU/non-GNU environment.
285       o Support assembler code with Borland C.
286       o Fixes for length problems.
287       o Fixes for uninitialised variables.
288       o Fixes for memory leaks, some unusual crashes and some race conditions.
289       o Fixes for smaller building problems.
290       o Updates of manuals, FAQ and other instructive documents.
291
292   Major changes between OpenSSL 0.9.6f and OpenSSL 0.9.6g:
293
294       o Important building fixes on Unix.
295
296   Major changes between OpenSSL 0.9.6e and OpenSSL 0.9.6f:
297
298       o Various important bugfixes.
299
300   Major changes between OpenSSL 0.9.6d and OpenSSL 0.9.6e:
301
302       o Important security related bugfixes.
303       o Various SSL/TLS library bugfixes.
304
305   Major changes between OpenSSL 0.9.6c and OpenSSL 0.9.6d:
306
307       o Various SSL/TLS library bugfixes.
308       o Fix DH parameter generation for 'non-standard' generators.
309
310   Major changes between OpenSSL 0.9.6b and OpenSSL 0.9.6c:
311
312       o Various SSL/TLS library bugfixes.
313       o BIGNUM library fixes.
314       o RSA OAEP and random number generation fixes.
315       o Object identifiers corrected and added.
316       o Add assembler BN routines for IA64.
317       o Add support for OS/390 Unix, UnixWare with gcc, OpenUNIX 8,
318         MIPS Linux; shared library support for Irix, HP-UX.
319       o Add crypto accelerator support for AEP, Baltimore SureWare,
320         Broadcom and Cryptographic Appliance's keyserver
321         [in 0.9.6c-engine release].
322
323   Major changes between OpenSSL 0.9.6a and OpenSSL 0.9.6b:
324
325       o Security fix: PRNG improvements.
326       o Security fix: RSA OAEP check.
327       o Security fix: Reinsert and fix countermeasure to Bleichbacher's
328         attack.
329       o MIPS bug fix in BIGNUM.
330       o Bug fix in "openssl enc".
331       o Bug fix in X.509 printing routine.
332       o Bug fix in DSA verification routine and DSA S/MIME verification.
333       o Bug fix to make PRNG thread-safe.
334       o Bug fix in RAND_file_name().
335       o Bug fix in compatibility mode trust settings.
336       o Bug fix in blowfish EVP.
337       o Increase default size for BIO buffering filter.
338       o Compatibility fixes in some scripts.
339
340   Major changes between OpenSSL 0.9.6 and OpenSSL 0.9.6a:
341
342       o Security fix: change behavior of OpenSSL to avoid using
343         environment variables when running as root.
344       o Security fix: check the result of RSA-CRT to reduce the
345         possibility of deducing the private key from an incorrectly
346         calculated signature.
347       o Security fix: prevent Bleichenbacher's DSA attack.
348       o Security fix: Zero the premaster secret after deriving the
349         master secret in DH ciphersuites.
350       o Reimplement SSL_peek(), which had various problems.
351       o Compatibility fix: the function des_encrypt() renamed to
352         des_encrypt1() to avoid clashes with some Unixen libc.
353       o Bug fixes for Win32, HP/UX and Irix.
354       o Bug fixes in BIGNUM, SSL, PKCS#7, PKCS#12, X.509, CONF and
355         memory checking routines.
356       o Bug fixes for RSA operations in threaded environments.
357       o Bug fixes in misc. openssl applications.
358       o Remove a few potential memory leaks.
359       o Add tighter checks of BIGNUM routines.
360       o Shared library support has been reworked for generality.
361       o More documentation.
362       o New function BN_rand_range().
363       o Add "-rand" option to openssl s_client and s_server.
364
365   Major changes between OpenSSL 0.9.5a and OpenSSL 0.9.6:
366
367       o Some documentation for BIO and SSL libraries.
368       o Enhanced chain verification using key identifiers.
369       o New sign and verify options to 'dgst' application.
370       o Support for DER and PEM encoded messages in 'smime' application.
371       o New 'rsautl' application, low level RSA utility.
372       o MD4 now included.
373       o Bugfix for SSL rollback padding check.
374       o Support for external crypto devices [1].
375       o Enhanced EVP interface.
376
377     [1] The support for external crypto devices is currently a separate
378         distribution.  See the file README.ENGINE.
379
380   Major changes between OpenSSL 0.9.5 and OpenSSL 0.9.5a:
381
382       o Bug fixes for Win32, SuSE Linux, NeXTSTEP and FreeBSD 2.2.8 
383       o Shared library support for HPUX and Solaris-gcc
384       o Support of Linux/IA64
385       o Assembler support for Mingw32
386       o New 'rand' application
387       o New way to check for existence of algorithms from scripts
388
389   Major changes between OpenSSL 0.9.4 and OpenSSL 0.9.5:
390
391       o S/MIME support in new 'smime' command
392       o Documentation for the OpenSSL command line application
393       o Automation of 'req' application
394       o Fixes to make s_client, s_server work under Windows
395       o Support for multiple fieldnames in SPKACs
396       o New SPKAC command line utilty and associated library functions
397       o Options to allow passwords to be obtained from various sources
398       o New public key PEM format and options to handle it
399       o Many other fixes and enhancements to command line utilities
400       o Usable certificate chain verification
401       o Certificate purpose checking
402       o Certificate trust settings
403       o Support of authority information access extension
404       o Extensions in certificate requests
405       o Simplified X509 name and attribute routines
406       o Initial (incomplete) support for international character sets
407       o New DH_METHOD, DSA_METHOD and enhanced RSA_METHOD
408       o Read only memory BIOs and simplified creation function
409       o TLS/SSL protocol bugfixes: Accept TLS 'client hello' in SSL 3.0
410         record; allow fragmentation and interleaving of handshake and other
411         data
412       o TLS/SSL code now "tolerates" MS SGC
413       o Work around for Netscape client certificate hang bug
414       o RSA_NULL option that removes RSA patent code but keeps other
415         RSA functionality
416       o Memory leak detection now allows applications to add extra information
417         via a per-thread stack
418       o PRNG robustness improved
419       o EGD support
420       o BIGNUM library bug fixes
421       o Faster DSA parameter generation
422       o Enhanced support for Alpha Linux
423       o Experimental MacOS support
424
425   Major changes between OpenSSL 0.9.3 and OpenSSL 0.9.4:
426
427       o Transparent support for PKCS#8 format private keys: these are used
428         by several software packages and are more secure than the standard
429         form
430       o PKCS#5 v2.0 implementation
431       o Password callbacks have a new void * argument for application data
432       o Avoid various memory leaks
433       o New pipe-like BIO that allows using the SSL library when actual I/O
434         must be handled by the application (BIO pair)
435
436   Major changes between OpenSSL 0.9.2b and OpenSSL 0.9.3:
437       o Lots of enhancements and cleanups to the Configuration mechanism
438       o RSA OEAP related fixes
439       o Added `openssl ca -revoke' option for revoking a certificate
440       o Source cleanups: const correctness, type-safe stacks and ASN.1 SETs
441       o Source tree cleanups: removed lots of obsolete files
442       o Thawte SXNet, certificate policies and CRL distribution points
443         extension support
444       o Preliminary (experimental) S/MIME support
445       o Support for ASN.1 UTF8String and VisibleString
446       o Full integration of PKCS#12 code
447       o Sparc assembler bignum implementation, optimized hash functions
448       o Option to disable selected ciphers
449
450   Major changes between OpenSSL 0.9.1c and OpenSSL 0.9.2b:
451       o Fixed a security hole related to session resumption
452       o Fixed RSA encryption routines for the p < q case
453       o "ALL" in cipher lists now means "everything except NULL ciphers"
454       o Support for Triple-DES CBCM cipher
455       o Support of Optimal Asymmetric Encryption Padding (OAEP) for RSA
456       o First support for new TLSv1 ciphers
457       o Added a few new BIOs (syslog BIO, reliable BIO)
458       o Extended support for DSA certificate/keys.
459       o Extended support for Certificate Signing Requests (CSR)
460       o Initial support for X.509v3 extensions
461       o Extended support for compression inside the SSL record layer
462       o Overhauled Win32 builds
463       o Cleanups and fixes to the Big Number (BN) library
464       o Support for ASN.1 GeneralizedTime
465       o Splitted ASN.1 SETs from SEQUENCEs
466       o ASN1 and PEM support for Netscape Certificate Sequences
467       o Overhauled Perl interface
468       o Lots of source tree cleanups.
469       o Lots of memory leak fixes.
470       o Lots of bug fixes.
471
472   Major changes between SSLeay 0.9.0b and OpenSSL 0.9.1c:
473       o Integration of the popular NO_RSA/NO_DSA patches
474       o Initial support for compression inside the SSL record layer
475       o Added BIO proxy and filtering functionality
476       o Extended Big Number (BN) library
477       o Added RIPE MD160 message digest
478       o Addeed support for RC2/64bit cipher
479       o Extended ASN.1 parser routines
480       o Adjustations of the source tree for CVS
481       o Support for various new platforms
482