Avoid "incomprehensible" errors when required definitions are missing.
[openssl.git] / CHANGES
1
2  OpenSSL CHANGES
3  _______________
4
5
6  Changes between 0.9.2b and 0.9.3
7
8   *) Complete rewrite of the error code script(s). It is all now handled
9      by one script at the top level which handles error code gathering,
10      header rewriting and C source file generation. It should be much better
11      than the old method: it now uses a modified version of Ulf's parser to
12      read the ANSI prototypes in all header files (thus the old K&R definitions
13      aren't needed for error creation any more) and do a better job of
14      translating function codes into names. The old 'ASN1 error code imbedded
15      in a comment' is no longer necessary and it doesn't use .err files which
16      have now been deleted. Also the error code call doesn't have to appear all
17      on one line (which resulted in some large lines...).
18      [Steve Henson]
19
20   *) Change #include filenames from <foo.h> to <openssl/foo.h>.
21      [Bodo Moeller]
22
23   *) Change behaviour of ssl2_read when facing length-0 packets: Don't return
24      0 (which usually indicates a closed connection), but continue reading.
25      [Bodo Moeller]
26
27   *) Fix some race conditions.
28      [Bodo Moeller]
29
30   *) Add support for CRL distribution points extension. Add Certificate
31      Policies and CRL distribution points documentation.
32      [Steve Henson]
33
34   *) Move the autogenerated header file parts to crypto/opensslconf.h.
35      [Ulf Möller]
36
37   *) Fix new 56-bit DES export ciphersuites: they were using 7 bytes instead of
38      8 of keying material. Merlin has also confirmed interop with this fix
39      between OpenSSL and Baltimore C/SSL 2.0 and J/SSL 2.0.
40      [Merlin Hughes <merlin@baltimore.ie>]
41
42   *) Fix lots of warnings.
43      [Richard Levitte <levitte@stacken.kth.se>]
44  
45   *) In add_cert_dir() in crypto/x509/by_dir.c, break out of the loop if
46      the directory spec didn't end with a LIST_SEPARATOR_CHAR.
47      [Richard Levitte <levitte@stacken.kth.se>]
48  
49   *) Fix problems with sizeof(long) == 8.
50      [Andy Polyakov <appro@fy.chalmers.se>]
51
52   *) Change functions to ANSI C.
53      [Ulf Möller]
54
55   *) Fix typos in error codes.
56      [Martin Kraemer <Martin.Kraemer@MchP.Siemens.De>, Ulf Möller]
57
58   *) Remove defunct assembler files from Configure.
59      [Ulf Möller]
60
61   *) SPARC v8 assembler BIGNUM implementation.
62      [Andy Polyakov <appro@fy.chalmers.se>]
63
64   *) Support for Certificate Policies extension: both print and set.
65      Various additions to support the r2i method this uses.
66      [Steve Henson]
67
68   *) A lot of constification, and fix a bug in X509_NAME_oneline() that could
69      return a const string when you are expecting an allocated buffer.
70      [Ben Laurie]
71
72   *) Add support for ASN1 types UTF8String and VISIBLESTRING, also the CHOICE
73      types DirectoryString and DisplayText.
74      [Steve Henson]
75
76   *) Add code to allow r2i extensions to access the configuration database,
77      add an LHASH database driver and add several ctx helper functions.
78      [Steve Henson]
79
80   *) Fix an evil bug in bn_expand2() which caused various BN functions to
81      fail when they extended the size of a BIGNUM.
82      [Steve Henson]
83
84   *) Various utility functions to handle SXNet extension. Modify mkdef.pl to
85      support typesafe stack.
86      [Steve Henson]
87
88   *) Fix typo in SSL_[gs]et_options().
89      [Nils Frostberg <nils@medcom.se>]
90
91   *) Delete various functions and files that belonged to the (now obsolete)
92      old X509V3 handling code.
93      [Steve Henson]
94
95   *) New Configure option "rsaref".
96      [Ulf Möller]
97
98   *) Don't auto-generate pem.h.
99      [Bodo Moeller]
100
101   *) Introduce type-safe ASN.1 SETs.
102      [Ben Laurie]
103
104   *) Introduce type-safe STACKs. This will almost certainly break lots of code
105      that links with OpenSSL (well at least cause lots of warnings), but fear
106      not: the conversion is trivial, and it eliminates loads of evil casts. A
107      few STACKed things have been converted already. Feel free to convert more.
108      In the fullness of time, I'll do away with the STACK type altogether.
109      [Ben Laurie]
110
111   *) Add `openssl ca -revoke <certfile>' facility which revokes a certificate
112      specified in <certfile> by updating the entry in the index.txt file.
113      This way one no longer has to edit the index.txt file manually for
114      revoking a certificate. The -revoke option does the gory details now.
115      [Massimiliano Pala <madwolf@openca.org>, Ralf S. Engelschall]
116
117   *) Fix `openssl crl -noout -text' combination where `-noout' killed the
118      `-text' option at all and this way the `-noout -text' combination was
119      inconsistent in `openssl crl' with the friends in `openssl x509|rsa|dsa'.
120      [Ralf S. Engelschall]
121
122   *) Make sure a corresponding plain text error message exists for the
123      X509_V_ERR_CERT_REVOKED/23 error number which can occur when a
124      verify callback function determined that a certificate was revoked.
125      [Ralf S. Engelschall]
126
127   *) Bugfix: In test/testenc, don't test "openssl <cipher>" for
128      ciphers that were excluded, e.g. by -DNO_IDEA.  Also, test
129      all available cipers including rc5, which was forgotten until now.
130      In order to let the testing shell script know which algorithms
131      are available, a new (up to now undocumented) command
132      "openssl list-cipher-commands" is used.
133      [Bodo Moeller]
134
135   *) Bugfix: s_client occasionally would sleep in select() when
136      it should have checked SSL_pending() first.
137      [Bodo Moeller]
138
139   *) New functions DSA_do_sign and DSA_do_verify to provide access to
140      the raw DSA values prior to ASN.1 encoding.
141      [Ulf Möller]
142
143   *) Tweaks to Configure
144      Niels Poppe <niels@netbox.org>
145
146   *) Add support for PKCS#5 v2.0 ASN1 PBES2 structures. No other support,
147      yet...
148      [Steve Henson]
149
150   *) New variables $(RANLIB) and $(PERL) in the Makefiles.
151      [Ulf Möller]
152
153   *) New config option to avoid instructions that are illegal on the 80386.
154      The default code is faster, but requires at least a 486.
155      [Ulf Möller]
156   
157   *) Got rid of old SSL2_CLIENT_VERSION (inconsistently used) and
158      SSL2_SERVER_VERSION (not used at all) macros, which are now the
159      same as SSL2_VERSION anyway.
160      [Bodo Moeller]
161
162   *) New "-showcerts" option for s_client.
163      [Bodo Moeller]
164
165   *) Still more PKCS#12 integration. Add pkcs12 application to openssl
166      application. Various cleanups and fixes.
167      [Steve Henson]
168
169   *) More PKCS#12 integration. Add new pkcs12 directory with Makefile.ssl and
170      modify error routines to work internally. Add error codes and PBE init
171      to library startup routines.
172      [Steve Henson]
173
174   *) Further PKCS#12 integration. Added password based encryption, PKCS#8 and
175      packing functions to asn1 and evp. Changed function names and error
176      codes along the way.
177      [Steve Henson]
178
179   *) PKCS12 integration: and so it begins... First of several patches to
180      slowly integrate PKCS#12 functionality into OpenSSL. Add PKCS#12
181      objects to objects.h
182      [Steve Henson]
183
184   *) Add a new 'indent' option to some X509V3 extension code. Initial ASN1
185      and display support for Thawte strong extranet extension.
186      [Steve Henson]
187
188   *) Add LinuxPPC support.
189      [Jeff Dubrule <igor@pobox.org>]
190
191   *) Get rid of redundant BN file bn_mulw.c, and rename bn_div64 to
192      bn_div_words in alpha.s.
193      [Hannes Reinecke <H.Reinecke@hw.ac.uk> and Ben Laurie]
194
195   *) Make sure the RSA OAEP test is skipped under -DRSAref because
196      OAEP isn't supported when OpenSSL is built with RSAref.
197      [Ulf Moeller <ulf@fitug.de>]
198
199   *) Move definitions of IS_SET/IS_SEQUENCE inside crypto/asn1/asn1.h 
200      so they no longer are missing under -DNOPROTO. 
201      [Soren S. Jorvang <soren@t.dk>]
202
203  Changes between 0.9.1c and 0.9.2b
204
205   *) Make SSL_get_peer_cert_chain() work in servers. Unfortunately, it still
206      doesn't work when the session is reused. Coming soon!
207      [Ben Laurie]
208
209   *) Fix a security hole, that allows sessions to be reused in the wrong
210      context thus bypassing client cert protection! All software that uses
211      client certs and session caches in multiple contexts NEEDS PATCHING to
212      allow session reuse! A fuller solution is in the works.
213      [Ben Laurie, problem pointed out by Holger Reif, Bodo Moeller (and ???)]
214
215   *) Some more source tree cleanups (removed obsolete files
216      crypto/bf/asm/bf586.pl, test/test.txt and crypto/sha/asm/f.s; changed
217      permission on "config" script to be executable) and a fix for the INSTALL
218      document.
219      [Ulf Moeller <ulf@fitug.de>]
220
221   *) Remove some legacy and erroneous uses of malloc, free instead of
222      Malloc, Free.
223      [Lennart Bang <lob@netstream.se>, with minor changes by Steve]
224
225   *) Make rsa_oaep_test return non-zero on error.
226      [Ulf Moeller <ulf@fitug.de>]
227
228   *) Add support for native Solaris shared libraries. Configure
229      solaris-sparc-sc4-pic, make, then run shlib/solaris-sc4.sh. It'd be nice
230      if someone would make that last step automatic.
231      [Matthias Loepfe <Matthias.Loepfe@AdNovum.CH>]
232
233   *) ctx_size was not built with the right compiler during "make links". Fixed.
234      [Ben Laurie]
235
236   *) Change the meaning of 'ALL' in the cipher list. It now means "everything
237      except NULL ciphers". This means the default cipher list will no longer
238      enable NULL ciphers. They need to be specifically enabled e.g. with
239      the string "DEFAULT:eNULL".
240      [Steve Henson]
241
242   *) Fix to RSA private encryption routines: if p < q then it would
243      occasionally produce an invalid result. This will only happen with
244      externally generated keys because OpenSSL (and SSLeay) ensure p > q.
245      [Steve Henson]
246
247   *) Be less restrictive and allow also `perl util/perlpath.pl
248      /path/to/bin/perl' in addition to `perl util/perlpath.pl /path/to/bin',
249      because this way one can also use an interpreter named `perl5' (which is
250      usually the name of Perl 5.xxx on platforms where an Perl 4.x is still
251      installed as `perl').
252      [Matthias Loepfe <Matthias.Loepfe@adnovum.ch>]
253
254   *) Let util/clean-depend.pl work also with older Perl 5.00x versions.
255      [Matthias Loepfe <Matthias.Loepfe@adnovum.ch>]
256
257   *) Fix Makefile.org so CC,CFLAG etc are passed to 'make links' add
258      advapi32.lib to Win32 build and change the pem test comparision
259      to fc.exe (thanks to Ulrich Kroener <kroneru@yahoo.com> for the
260      suggestion). Fix misplaced ASNI prototypes and declarations in evp.h
261      and crypto/des/ede_cbcm_enc.c.
262      [Steve Henson]
263
264   *) DES quad checksum was broken on big-endian architectures. Fixed.
265      [Ben Laurie]
266
267   *) Comment out two functions in bio.h that aren't implemented. Fix up the
268      Win32 test batch file so it (might) work again. The Win32 test batch file
269      is horrible: I feel ill....
270      [Steve Henson]
271
272   *) Move various #ifdefs around so NO_SYSLOG, NO_DIRENT etc are now selected
273      in e_os.h. Audit of header files to check ANSI and non ANSI
274      sections: 10 functions were absent from non ANSI section and not exported
275      from Windows DLLs. Fixed up libeay.num for new functions.
276      [Steve Henson]
277
278   *) Make `openssl version' output lines consistent.
279      [Ralf S. Engelschall]
280
281   *) Fix Win32 symbol export lists for BIO functions: Added
282      BIO_get_ex_new_index, BIO_get_ex_num, BIO_get_ex_data and BIO_set_ex_data
283      to ms/libeay{16,32}.def.
284      [Ralf S. Engelschall]
285
286   *) Second round of fixing the OpenSSL perl/ stuff. It now at least compiled
287      fine under Unix and passes some trivial tests I've now added. But the
288      whole stuff is horribly incomplete, so a README.1ST with a disclaimer was
289      added to make sure no one expects that this stuff really works in the
290      OpenSSL 0.9.2 release.  Additionally I've started to clean the XS sources
291      up and fixed a few little bugs and inconsistencies in OpenSSL.{pm,xs} and
292      openssl_bio.xs.
293      [Ralf S. Engelschall]
294
295   *) Fix the generation of two part addresses in perl.
296      [Kenji Miyake <kenji@miyake.org>, integrated by Ben Laurie]
297
298   *) Add config entry for Linux on MIPS.
299      [John Tobey <jtobey@channel1.com>]
300
301   *) Make links whenever Configure is run, unless we are on Windoze.
302      [Ben Laurie]
303
304   *) Permit extensions to be added to CRLs using crl_section in openssl.cnf.
305      Currently only issuerAltName and AuthorityKeyIdentifier make any sense
306      in CRLs.
307      [Steve Henson]
308
309   *) Add a useful kludge to allow package maintainers to specify compiler and
310      other platforms details on the command line without having to patch the
311      Configure script everytime: One now can use ``perl Configure
312      <id>:<details>'', i.e. platform ids are allowed to have details appended
313      to them (seperated by colons). This is treated as there would be a static
314      pre-configured entry in Configure's %table under key <id> with value
315      <details> and ``perl Configure <id>'' is called.  So, when you want to
316      perform a quick test-compile under FreeBSD 3.1 with pgcc and without
317      assembler stuff you can use ``perl Configure "FreeBSD-elf:pgcc:-O6:::"''
318      now, which overrides the FreeBSD-elf entry on-the-fly.
319      [Ralf S. Engelschall]
320
321   *) Disable new TLS1 ciphersuites by default: they aren't official yet.
322      [Ben Laurie]
323
324   *) Allow DSO flags like -fpic, -fPIC, -KPIC etc. to be specified
325      on the `perl Configure ...' command line. This way one can compile
326      OpenSSL libraries with Position Independent Code (PIC) which is needed
327      for linking it into DSOs.
328      [Ralf S. Engelschall]
329
330   *) Remarkably, export ciphers were totally broken and no-one had noticed!
331      Fixed.
332      [Ben Laurie]
333
334   *) Cleaned up the LICENSE document: The official contact for any license
335      questions now is the OpenSSL core team under openssl-core@openssl.org.
336      And add a paragraph about the dual-license situation to make sure people
337      recognize that _BOTH_ the OpenSSL license _AND_ the SSLeay license apply
338      to the OpenSSL toolkit.
339      [Ralf S. Engelschall]
340
341   *) General source tree makefile cleanups: Made `making xxx in yyy...'
342      display consistent in the source tree and replaced `/bin/rm' by `rm'.
343      Additonally cleaned up the `make links' target: Remove unnecessary
344      semicolons, subsequent redundant removes, inline point.sh into mklink.sh
345      to speed processing and no longer clutter the display with confusing
346      stuff. Instead only the actually done links are displayed.
347      [Ralf S. Engelschall]
348
349   *) Permit null encryption ciphersuites, used for authentication only. It used
350      to be necessary to set the preprocessor define SSL_ALLOW_ENULL to do this.
351      It is now necessary to set SSL_FORBID_ENULL to prevent the use of null
352      encryption.
353      [Ben Laurie]
354
355   *) Add a bunch of fixes to the PKCS#7 stuff. It used to sometimes reorder
356      signed attributes when verifying signatures (this would break them), 
357      the detached data encoding was wrong and public keys obtained using
358      X509_get_pubkey() weren't freed.
359      [Steve Henson]
360
361   *) Add text documentation for the BUFFER functions. Also added a work around
362      to a Win95 console bug. This was triggered by the password read stuff: the
363      last character typed gets carried over to the next fread(). If you were 
364      generating a new cert request using 'req' for example then the last
365      character of the passphrase would be CR which would then enter the first
366      field as blank.
367      [Steve Henson]
368
369   *) Added the new `Includes OpenSSL Cryptography Software' button as
370      doc/openssl_button.{gif,html} which is similar in style to the old SSLeay
371      button and can be used by applications based on OpenSSL to show the
372      relationship to the OpenSSL project.  
373      [Ralf S. Engelschall]
374
375   *) Remove confusing variables in function signatures in files
376      ssl/ssl_lib.c and ssl/ssl.h.
377      [Lennart Bong <lob@kulthea.stacken.kth.se>]
378
379   *) Don't install bss_file.c under PREFIX/include/
380      [Lennart Bong <lob@kulthea.stacken.kth.se>]
381
382   *) Get the Win32 compile working again. Modify mkdef.pl so it can handle
383      functions that return function pointers and has support for NT specific
384      stuff. Fix mk1mf.pl and VC-32.pl to support NT differences also. Various
385      #ifdef WIN32 and WINNTs sprinkled about the place and some changes from
386      unsigned to signed types: this was killing the Win32 compile.
387      [Steve Henson]
388
389   *) Add new certificate file to stack functions,
390      SSL_add_dir_cert_subjects_to_stack() and
391      SSL_add_file_cert_subjects_to_stack().  These largely supplant
392      SSL_load_client_CA_file(), and can be used to add multiple certs easily
393      to a stack (usually this is then handed to SSL_CTX_set_client_CA_list()).
394      This means that Apache-SSL and similar packages don't have to mess around
395      to add as many CAs as they want to the preferred list.
396      [Ben Laurie]
397
398   *) Experiment with doxygen documentation. Currently only partially applied to
399      ssl/ssl_lib.c.
400      See http://www.stack.nl/~dimitri/doxygen/index.html, and run doxygen with
401      openssl.doxy as the configuration file.
402      [Ben Laurie]
403   
404   *) Get rid of remaining C++-style comments which strict C compilers hate.
405      [Ralf S. Engelschall, pointed out by Carlos Amengual]
406
407   *) Changed BN_RECURSION in bn_mont.c to BN_RECURSION_MONT so it is not
408      compiled in by default: it has problems with large keys.
409      [Steve Henson]
410
411   *) Add a bunch of SSL_xxx() functions for configuring the temporary RSA and
412      DH private keys and/or callback functions which directly correspond to
413      their SSL_CTX_xxx() counterparts but work on a per-connection basis. This
414      is needed for applications which have to configure certificates on a
415      per-connection basis (e.g. Apache+mod_ssl) instead of a per-context basis
416      (e.g. s_server). 
417         For the RSA certificate situation is makes no difference, but
418      for the DSA certificate situation this fixes the "no shared cipher"
419      problem where the OpenSSL cipher selection procedure failed because the
420      temporary keys were not overtaken from the context and the API provided
421      no way to reconfigure them. 
422         The new functions now let applications reconfigure the stuff and they
423      are in detail: SSL_need_tmp_RSA, SSL_set_tmp_rsa, SSL_set_tmp_dh,
424      SSL_set_tmp_rsa_callback and SSL_set_tmp_dh_callback.  Additionally a new
425      non-public-API function ssl_cert_instantiate() is used as a helper
426      function and also to reduce code redundancy inside ssl_rsa.c.
427      [Ralf S. Engelschall]
428
429   *) Move s_server -dcert and -dkey options out of the undocumented feature
430      area because they are useful for the DSA situation and should be
431      recognized by the users.
432      [Ralf S. Engelschall]
433
434   *) Fix the cipher decision scheme for export ciphers: the export bits are
435      *not* within SSL_MKEY_MASK or SSL_AUTH_MASK, they are within
436      SSL_EXP_MASK.  So, the original variable has to be used instead of the
437      already masked variable.
438      [Richard Levitte <levitte@stacken.kth.se>]
439
440   *) Fix 'port' variable from `int' to `unsigned int' in crypto/bio/b_sock.c
441      [Richard Levitte <levitte@stacken.kth.se>]
442
443   *) Change type of another md_len variable in pk7_doit.c:PKCS7_dataFinal()
444      from `int' to `unsigned int' because it's a length and initialized by
445      EVP_DigestFinal() which expects an `unsigned int *'.
446      [Richard Levitte <levitte@stacken.kth.se>]
447
448   *) Don't hard-code path to Perl interpreter on shebang line of Configure
449      script. Instead use the usual Shell->Perl transition trick.
450      [Ralf S. Engelschall]
451
452   *) Make `openssl x509 -noout -modulus' functional also for DSA certificates
453      (in addition to RSA certificates) to match the behaviour of `openssl dsa
454      -noout -modulus' as it's already the case for `openssl rsa -noout
455      -modulus'.  For RSA the -modulus is the real "modulus" while for DSA
456      currently the public key is printed (a decision which was already done by
457      `openssl dsa -modulus' in the past) which serves a similar purpose.
458      Additionally the NO_RSA no longer completely removes the whole -modulus
459      option; it now only avoids using the RSA stuff. Same applies to NO_DSA
460      now, too.
461      [Ralf S.  Engelschall]
462
463   *) Add Arne Ansper's reliable BIO - this is an encrypted, block-digested
464      BIO. See the source (crypto/evp/bio_ok.c) for more info.
465      [Arne Ansper <arne@ats.cyber.ee>]
466
467   *) Dump the old yucky req code that tried (and failed) to allow raw OIDs
468      to be added. Now both 'req' and 'ca' can use new objects defined in the
469      config file.
470      [Steve Henson]
471
472   *) Add cool BIO that does syslog (or event log on NT).
473      [Arne Ansper <arne@ats.cyber.ee>, integrated by Ben Laurie]
474
475   *) Add support for new TLS ciphersuites, TLS_RSA_EXPORT56_WITH_RC4_56_MD5,
476      TLS_RSA_EXPORT56_WITH_RC2_CBC_56_MD5 and
477      TLS_RSA_EXPORT56_WITH_DES_CBC_SHA, as specified in "56-bit Export Cipher
478      Suites For TLS", draft-ietf-tls-56-bit-ciphersuites-00.txt.
479      [Ben Laurie]
480
481   *) Add preliminary config info for new extension code.
482      [Steve Henson]
483
484   *) Make RSA_NO_PADDING really use no padding.
485      [Ulf Moeller <ulf@fitug.de>]
486
487   *) Generate errors when private/public key check is done.
488      [Ben Laurie]
489
490   *) Overhaul for 'crl' utility. New function X509_CRL_print. Partial support
491      for some CRL extensions and new objects added.
492      [Steve Henson]
493
494   *) Really fix the ASN1 IMPLICIT bug this time... Partial support for private
495      key usage extension and fuller support for authority key id.
496      [Steve Henson]
497
498   *) Add OAEP encryption for the OpenSSL crypto library. OAEP is the improved
499      padding method for RSA, which is recommended for new applications in PKCS
500      #1 v2.0 (RFC 2437, October 1998).
501      OAEP (Optimal Asymmetric Encryption Padding) has better theoretical
502      foundations than the ad-hoc padding used in PKCS #1 v1.5. It is secure
503      against Bleichbacher's attack on RSA.
504      [Ulf Moeller <ulf@fitug.de>, reformatted, corrected and integrated by
505       Ben Laurie]
506
507   *) Updates to the new SSL compression code
508      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
509
510   *) Fix so that the version number in the master secret, when passed
511      via RSA, checks that if TLS was proposed, but we roll back to SSLv3
512      (because the server will not accept higher), that the version number
513      is 0x03,0x01, not 0x03,0x00
514      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
515
516   *) Run extensive memory leak checks on SSL apps. Fixed *lots* of memory
517      leaks in ssl/ relating to new X509_get_pubkey() behaviour. Also fixes
518      in apps/ and an unrelated leak in crypto/dsa/dsa_vrf.c
519      [Steve Henson]
520
521   *) Support for RAW extensions where an arbitrary extension can be
522      created by including its DER encoding. See apps/openssl.cnf for
523      an example.
524      [Steve Henson]
525
526   *) Make sure latest Perl versions don't interpret some generated C array
527      code as Perl array code in the crypto/err/err_genc.pl script.
528      [Lars Weber <3weber@informatik.uni-hamburg.de>]
529
530   *) Modify ms/do_ms.bat to not generate assembly language makefiles since
531      not many people have the assembler. Various Win32 compilation fixes and
532      update to the INSTALL.W32 file with (hopefully) more accurate Win32
533      build instructions.
534      [Steve Henson]
535
536   *) Modify configure script 'Configure' to automatically create crypto/date.h
537      file under Win32 and also build pem.h from pem.org. New script
538      util/mkfiles.pl to create the MINFO file on environments that can't do a
539      'make files': perl util/mkfiles.pl >MINFO should work.
540      [Steve Henson]
541
542   *) Major rework of DES function declarations, in the pursuit of correctness
543      and purity. As a result, many evil casts evaporated, and some weirdness,
544      too. You may find this causes warnings in your code. Zapping your evil
545      casts will probably fix them. Mostly.
546      [Ben Laurie]
547
548   *) Fix for a typo in asn1.h. Bug fix to object creation script
549      obj_dat.pl. It considered a zero in an object definition to mean
550      "end of object": none of the objects in objects.h have any zeros
551      so it wasn't spotted.
552      [Steve Henson, reported by Erwann ABALEA <eabalea@certplus.com>]
553
554   *) Add support for Triple DES Cipher Block Chaining with Output Feedback
555      Masking (CBCM). In the absence of test vectors, the best I have been able
556      to do is check that the decrypt undoes the encrypt, so far. Send me test
557      vectors if you have them.
558      [Ben Laurie]
559
560   *) Correct calculation of key length for export ciphers (too much space was
561      allocated for null ciphers). This has not been tested!
562      [Ben Laurie]
563
564   *) Modifications to the mkdef.pl for Win32 DEF file creation. The usage
565      message is now correct (it understands "crypto" and "ssl" on its
566      command line). There is also now an "update" option. This will update
567      the util/ssleay.num and util/libeay.num files with any new functions.
568      If you do a: 
569      perl util/mkdef.pl crypto ssl update
570      it will update them.
571      [Steve Henson]
572
573   *) Overhauled the Perl interface (perl/*):
574      - ported BN stuff to OpenSSL's different BN library
575      - made the perl/ source tree CVS-aware
576      - renamed the package from SSLeay to OpenSSL (the files still contain
577        their history because I've copied them in the repository)
578      - removed obsolete files (the test scripts will be replaced
579        by better Test::Harness variants in the future)
580      [Ralf S. Engelschall]
581
582   *) First cut for a very conservative source tree cleanup:
583      1. merge various obsolete readme texts into doc/ssleay.txt
584      where we collect the old documents and readme texts.
585      2. remove the first part of files where I'm already sure that we no
586      longer need them because of three reasons: either they are just temporary
587      files which were left by Eric or they are preserved original files where
588      I've verified that the diff is also available in the CVS via "cvs diff
589      -rSSLeay_0_8_1b" or they were renamed (as it was definitely the case for
590      the crypto/md/ stuff).
591      [Ralf S. Engelschall]
592
593   *) More extension code. Incomplete support for subject and issuer alt
594      name, issuer and authority key id. Change the i2v function parameters
595      and add an extra 'crl' parameter in the X509V3_CTX structure: guess
596      what that's for :-) Fix to ASN1 macro which messed up
597      IMPLICIT tag and add f_enum.c which adds a2i, i2a for ENUMERATED.
598      [Steve Henson]
599
600   *) Preliminary support for ENUMERATED type. This is largely copied from the
601      INTEGER code.
602      [Steve Henson]
603
604   *) Add new function, EVP_MD_CTX_copy() to replace frequent use of memcpy.
605      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
606
607   *) Make sure `make rehash' target really finds the `openssl' program.
608      [Ralf S. Engelschall, Matthias Loepfe <Matthias.Loepfe@adnovum.ch>]
609
610   *) Squeeze another 7% of speed out of MD5 assembler, at least on a P2. I'd
611      like to hear about it if this slows down other processors.
612      [Ben Laurie]
613
614   *) Add CygWin32 platform information to Configure script.
615      [Alan Batie <batie@aahz.jf.intel.com>]
616
617   *) Fixed ms/32all.bat script: `no_asm' -> `no-asm'
618      [Rainer W. Gerling <gerling@mpg-gv.mpg.de>]
619   
620   *) New program nseq to manipulate netscape certificate sequences
621      [Steve Henson]
622
623   *) Modify crl2pkcs7 so it supports multiple -certfile arguments. Fix a
624      few typos.
625      [Steve Henson]
626
627   *) Fixes to BN code.  Previously the default was to define BN_RECURSION
628      but the BN code had some problems that would cause failures when
629      doing certificate verification and some other functions.
630      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
631
632   *) Add ASN1 and PEM code to support netscape certificate sequences.
633      [Steve Henson]
634
635   *) Add ASN1 and PEM code to support netscape certificate sequences.
636      [Steve Henson]
637
638   *) Add several PKIX and private extended key usage OIDs.
639      [Steve Henson]
640
641   *) Modify the 'ca' program to handle the new extension code. Modify
642      openssl.cnf for new extension format, add comments.
643      [Steve Henson]
644
645   *) More X509 V3 changes. Fix typo in v3_bitstr.c. Add support to 'req'
646      and add a sample to openssl.cnf so req -x509 now adds appropriate
647      CA extensions.
648      [Steve Henson]
649
650   *) Continued X509 V3 changes. Add to other makefiles, integrate with the
651      error code, add initial support to X509_print() and x509 application.
652      [Steve Henson]
653
654   *) Takes a deep breath and start addding X509 V3 extension support code. Add
655      files in crypto/x509v3. Move original stuff to crypto/x509v3/old. All this
656      stuff is currently isolated and isn't even compiled yet.
657      [Steve Henson]
658
659   *) Continuing patches for GeneralizedTime. Fix up certificate and CRL
660      ASN1 to use ASN1_TIME and modify print routines to use ASN1_TIME_print.
661      Removed the versions check from X509 routines when loading extensions:
662      this allows certain broken certificates that don't set the version
663      properly to be processed.
664      [Steve Henson]
665
666   *) Deal with irritating shit to do with dependencies, in YAAHW (Yet Another
667      Ad Hoc Way) - Makefile.ssls now all contain local dependencies, which
668      can still be regenerated with "make depend".
669      [Ben Laurie]
670
671   *) Spelling mistake in C version of CAST-128.
672      [Ben Laurie, reported by Jeremy Hylton <jeremy@cnri.reston.va.us>]
673
674   *) Changes to the error generation code. The perl script err-code.pl 
675      now reads in the old error codes and retains the old numbers, only
676      adding new ones if necessary. It also only changes the .err files if new
677      codes are added. The makefiles have been modified to only insert errors
678      when needed (to avoid needlessly modifying header files). This is done
679      by only inserting errors if the .err file is newer than the auto generated
680      C file. To rebuild all the error codes from scratch (the old behaviour)
681      either modify crypto/Makefile.ssl to pass the -regen flag to err_code.pl
682      or delete all the .err files.
683      [Steve Henson]
684
685   *) CAST-128 was incorrectly implemented for short keys. The C version has
686      been fixed, but is untested. The assembler versions are also fixed, but
687      new assembler HAS NOT BEEN GENERATED FOR WIN32 - the Makefile needs fixing
688      to regenerate it if needed.
689      [Ben Laurie, reported (with fix for C version) by Jun-ichiro itojun
690       Hagino <itojun@kame.net>]
691
692   *) File was opened incorrectly in randfile.c.
693      [Ulf Möller <ulf@fitug.de>]
694
695   *) Beginning of support for GeneralizedTime. d2i, i2d, check and print
696      functions. Also ASN1_TIME suite which is a CHOICE of UTCTime or
697      GeneralizedTime. ASN1_TIME is the proper type used in certificates et
698      al: it's just almost always a UTCTime. Note this patch adds new error
699      codes so do a "make errors" if there are problems.
700      [Steve Henson]
701
702   *) Correct Linux 1 recognition in config.
703      [Ulf Möller <ulf@fitug.de>]
704
705   *) Remove pointless MD5 hash when using DSA keys in ca.
706      [Anonymous <nobody@replay.com>]
707
708   *) Generate an error if given an empty string as a cert directory. Also
709      generate an error if handed NULL (previously returned 0 to indicate an
710      error, but didn't set one).
711      [Ben Laurie, reported by Anonymous <nobody@replay.com>]
712
713   *) Add prototypes to SSL methods. Make SSL_write's buffer const, at last.
714      [Ben Laurie]
715
716   *) Fix the dummy function BN_ref_mod_exp() in rsaref.c to have the correct
717      parameters. This was causing a warning which killed off the Win32 compile.
718      [Steve Henson]
719
720   *) Remove C++ style comments from crypto/bn/bn_local.h.
721      [Neil Costigan <neil.costigan@celocom.com>]
722
723   *) The function OBJ_txt2nid was broken. It was supposed to return a nid
724      based on a text string, looking up short and long names and finally
725      "dot" format. The "dot" format stuff didn't work. Added new function
726      OBJ_txt2obj to do the same but return an ASN1_OBJECT and rewrote 
727      OBJ_txt2nid to use it. OBJ_txt2obj can also return objects even if the
728      OID is not part of the table.
729      [Steve Henson]
730
731   *) Add prototypes to X509 lookup/verify methods, fixing a bug in
732      X509_LOOKUP_by_alias().
733      [Ben Laurie]
734
735   *) Sort openssl functions by name.
736      [Ben Laurie]
737
738   *) Get the gendsa program working (hopefully) and add it to app list. Remove
739      encryption from sample DSA keys (in case anyone is interested the password
740      was "1234").
741      [Steve Henson]
742
743   *) Make _all_ *_free functions accept a NULL pointer.
744      [Frans Heymans <fheymans@isaserver.be>]
745
746   *) If a DH key is generated in s3_srvr.c, don't blow it by trying to use
747      NULL pointers.
748      [Anonymous <nobody@replay.com>]
749
750   *) s_server should send the CAfile as acceptable CAs, not its own cert.
751      [Bodo Moeller <3moeller@informatik.uni-hamburg.de>]
752
753   *) Don't blow it for numeric -newkey arguments to apps/req.
754      [Bodo Moeller <3moeller@informatik.uni-hamburg.de>]
755
756   *) Temp key "for export" tests were wrong in s3_srvr.c.
757      [Anonymous <nobody@replay.com>]
758
759   *) Add prototype for temp key callback functions
760      SSL_CTX_set_tmp_{rsa,dh}_callback().
761      [Ben Laurie]
762
763   *) Make DH_free() tolerate being passed a NULL pointer (like RSA_free() and
764      DSA_free()). Make X509_PUBKEY_set() check for errors in d2i_PublicKey().
765      [Steve Henson]
766
767   *) X509_name_add_entry() freed the wrong thing after an error.
768      [Arne Ansper <arne@ats.cyber.ee>]
769
770   *) rsa_eay.c would attempt to free a NULL context.
771      [Arne Ansper <arne@ats.cyber.ee>]
772
773   *) BIO_s_socket() had a broken should_retry() on Windoze.
774      [Arne Ansper <arne@ats.cyber.ee>]
775
776   *) BIO_f_buffer() didn't pass on BIO_CTRL_FLUSH.
777      [Arne Ansper <arne@ats.cyber.ee>]
778
779   *) Make sure the already existing X509_STORE->depth variable is initialized
780      in X509_STORE_new(), but document the fact that this variable is still
781      unused in the certificate verification process.
782      [Ralf S. Engelschall]
783
784   *) Fix the various library and apps files to free up pkeys obtained from
785      X509_PUBKEY_get() et al. Also allow x509.c to handle netscape extensions.
786      [Steve Henson]
787
788   *) Fix reference counting in X509_PUBKEY_get(). This makes
789      demos/maurice/example2.c work, amongst others, probably.
790      [Steve Henson and Ben Laurie]
791
792   *) First cut of a cleanup for apps/. First the `ssleay' program is now named
793      `openssl' and second, the shortcut symlinks for the `openssl <command>'
794      are no longer created. This way we have a single and consistent command
795      line interface `openssl <command>', similar to `cvs <command>'.
796      [Ralf S. Engelschall, Paul Sutton and Ben Laurie]
797
798   *) ca.c: move test for DSA keys inside #ifndef NO_DSA. Make pubkey
799      BIT STRING wrapper always have zero unused bits.
800      [Steve Henson]
801
802   *) Add CA.pl, perl version of CA.sh, add extended key usage OID.
803      [Steve Henson]
804
805   *) Make the top-level INSTALL documentation easier to understand.
806      [Paul Sutton]
807
808   *) Makefiles updated to exit if an error occurs in a sub-directory
809      make (including if user presses ^C) [Paul Sutton]
810
811   *) Make Montgomery context stuff explicit in RSA data structure.
812      [Ben Laurie]
813
814   *) Fix build order of pem and err to allow for generated pem.h.
815      [Ben Laurie]
816
817   *) Fix renumbering bug in X509_NAME_delete_entry().
818      [Ben Laurie]
819
820   *) Enhanced the err-ins.pl script so it makes the error library number 
821      global and can add a library name. This is needed for external ASN1 and
822      other error libraries.
823      [Steve Henson]
824
825   *) Fixed sk_insert which never worked properly.
826      [Steve Henson]
827
828   *) Fix ASN1 macros so they can handle indefinite length construted 
829      EXPLICIT tags. Some non standard certificates use these: they can now
830      be read in.
831      [Steve Henson]
832
833   *) Merged the various old/obsolete SSLeay documentation files (doc/xxx.doc)
834      into a single doc/ssleay.txt bundle. This way the information is still
835      preserved but no longer messes up this directory. Now it's new room for
836      the new set of documenation files.
837      [Ralf S. Engelschall]
838
839   *) SETs were incorrectly DER encoded. This was a major pain, because they
840      shared code with SEQUENCEs, which aren't coded the same. This means that
841      almost everything to do with SETs or SEQUENCEs has either changed name or
842      number of arguments.
843      [Ben Laurie, based on a partial fix by GP Jayan <gp@nsj.co.jp>]
844
845   *) Fix test data to work with the above.
846      [Ben Laurie]
847
848   *) Fix the RSA header declarations that hid a bug I fixed in 0.9.0b but
849      was already fixed by Eric for 0.9.1 it seems.
850      [Ben Laurie - pointed out by Ulf Möller <ulf@fitug.de>]
851
852   *) Autodetect FreeBSD3.
853      [Ben Laurie]
854
855   *) Fix various bugs in Configure. This affects the following platforms:
856      nextstep
857      ncr-scde
858      unixware-2.0
859      unixware-2.0-pentium
860      sco5-cc.
861      [Ben Laurie]
862
863   *) Eliminate generated files from CVS. Reorder tests to regenerate files
864      before they are needed.
865      [Ben Laurie]
866
867   *) Generate Makefile.ssl from Makefile.org (to keep CVS happy).
868      [Ben Laurie]
869
870  Changes between 0.9.1b and 0.9.1c
871
872   *) Added OPENSSL_VERSION_NUMBER to crypto/crypto.h and 
873      changed SSLeay to OpenSSL in version strings.
874      [Ralf S. Engelschall]
875   
876   *) Some fixups to the top-level documents.
877      [Paul Sutton]
878
879   *) Fixed the nasty bug where rsaref.h was not found under compile-time
880      because the symlink to include/ was missing.
881      [Ralf S. Engelschall]
882
883   *) Incorporated the popular no-RSA/DSA-only patches 
884      which allow to compile a RSA-free SSLeay.
885      [Andrew Cooke / Interrader Ldt., Ralf S. Engelschall]
886
887   *) Fixed nasty rehash problem under `make -f Makefile.ssl links'
888      when "ssleay" is still not found.
889      [Ralf S. Engelschall]
890
891   *) Added more platforms to Configure: Cray T3E, HPUX 11, 
892      [Ralf S. Engelschall, Beckmann <beckman@acl.lanl.gov>]
893
894   *) Updated the README file.
895      [Ralf S. Engelschall]
896
897   *) Added various .cvsignore files in the CVS repository subdirs
898      to make a "cvs update" really silent.
899      [Ralf S. Engelschall]
900
901   *) Recompiled the error-definition header files and added
902      missing symbols to the Win32 linker tables.
903      [Ralf S. Engelschall]
904
905   *) Cleaned up the top-level documents;
906      o new files: CHANGES and LICENSE
907      o merged VERSION, HISTORY* and README* files a CHANGES.SSLeay 
908      o merged COPYRIGHT into LICENSE
909      o removed obsolete TODO file
910      o renamed MICROSOFT to INSTALL.W32
911      [Ralf S. Engelschall]
912
913   *) Removed dummy files from the 0.9.1b source tree: 
914      crypto/asn1/x crypto/bio/cd crypto/bio/fg crypto/bio/grep crypto/bio/vi
915      crypto/bn/asm/......add.c crypto/bn/asm/a.out crypto/dsa/f crypto/md5/f
916      crypto/pem/gmon.out crypto/perlasm/f crypto/pkcs7/build crypto/rsa/f
917      crypto/sha/asm/f crypto/threads/f ms/zzz ssl/f ssl/f.mak test/f
918      util/f.mak util/pl/f util/pl/f.mak crypto/bf/bf_locl.old apps/f
919      [Ralf S. Engelschall]
920
921   *) Added various platform portability fixes.
922      [Mark J. Cox]
923
924   *) The Genesis of the OpenSSL rpject:
925      We start with the latest (unreleased) SSLeay version 0.9.1b which Eric A.
926      Young and Tim J. Hudson created while they were working for C2Net until
927      summer 1998.
928      [The OpenSSL Project]
929  
930  Changes between 0.9.0b and 0.9.1b
931
932   *) Updated a few CA certificates under certs/
933      [Eric A. Young]
934
935   *) Changed some BIGNUM api stuff.
936      [Eric A. Young]
937
938   *) Various platform ports: OpenBSD, Ultrix, IRIX 64bit, NetBSD, 
939      DGUX x86, Linux Alpha, etc.
940      [Eric A. Young]
941
942   *) New COMP library [crypto/comp/] for SSL Record Layer Compression: 
943      RLE (dummy implemented) and ZLIB (really implemented when ZLIB is
944      available).
945      [Eric A. Young]
946
947   *) Add -strparse option to asn1pars program which parses nested 
948      binary structures 
949      [Dr Stephen Henson <shenson@bigfoot.com>]
950
951   *) Added "oid_file" to ssleay.cnf for "ca" and "req" programs.
952      [Eric A. Young]
953
954   *) DSA fix for "ca" program.
955      [Eric A. Young]
956
957   *) Added "-genkey" option to "dsaparam" program.
958      [Eric A. Young]
959
960   *) Added RIPE MD160 (rmd160) message digest.
961      [Eric A. Young]
962
963   *) Added -a (all) option to "ssleay version" command.
964      [Eric A. Young]
965
966   *) Added PLATFORM define which is the id given to Configure.
967      [Eric A. Young]
968
969   *) Added MemCheck_XXXX functions to crypto/mem.c for memory checking.
970      [Eric A. Young]
971
972   *) Extended the ASN.1 parser routines.
973      [Eric A. Young]
974
975   *) Extended BIO routines to support REUSEADDR, seek, tell, etc.
976      [Eric A. Young]
977
978   *) Added a BN_CTX to the BN library.
979      [Eric A. Young]
980
981   *) Fixed the weak key values in DES library
982      [Eric A. Young]
983
984   *) Changed API in EVP library for cipher aliases.
985      [Eric A. Young]
986
987   *) Added support for RC2/64bit cipher.
988      [Eric A. Young]
989
990   *) Converted the lhash library to the crypto/mem.c functions.
991      [Eric A. Young]
992
993   *) Added more recognized ASN.1 object ids.
994      [Eric A. Young]
995
996   *) Added more RSA padding checks for SSL/TLS.
997      [Eric A. Young]
998
999   *) Added BIO proxy/filter functionality.
1000      [Eric A. Young]
1001
1002   *) Added extra_certs to SSL_CTX which can be used
1003      send extra CA certificates to the client in the CA cert chain sending
1004      process. It can be configured with SSL_CTX_add_extra_chain_cert().
1005      [Eric A. Young]
1006
1007   *) Now Fortezza is denied in the authentication phase because
1008      this is key exchange mechanism is not supported by SSLeay at all.
1009      [Eric A. Young]
1010
1011   *) Additional PKCS1 checks.
1012      [Eric A. Young]
1013
1014   *) Support the string "TLSv1" for all TLS v1 ciphers.
1015      [Eric A. Young]
1016
1017   *) Added function SSL_get_ex_data_X509_STORE_CTX_idx() which gives the
1018      ex_data index of the SSL context in the X509_STORE_CTX ex_data.
1019      [Eric A. Young]
1020
1021   *) Fixed a few memory leaks.
1022      [Eric A. Young]
1023
1024   *) Fixed various code and comment typos.
1025      [Eric A. Young]
1026
1027   *) A minor bug in ssl/s3_clnt.c where there would always be 4 0 
1028      bytes sent in the client random.
1029      [Edward Bishop <ebishop@spyglass.com>]
1030