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