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