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