CHANGES

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