CHANGES

   1
   2  OpenSSL CHANGES
   3  _______________
   4
   5
   6  Changes between 0.9.1c and 0.9.2
   7
   8   *) Add OAEP encryption for the OpenSSL crypto library. OAEP is the improved
   9      padding method for RSA, which is recommended for new applications in PKCS
  10      #1 v2.0 (RFC 2437, October 1998).
  11      OAEP (Optimal Asymmetric Encryption Padding) has better theoretical
  12      foundations than the ad-hoc padding used in PKCS #1 v1.5. It is secure
  13      against Bleichbacher's attack on RSA.
  14      [Ulf Moeller <ulf@fitug.de>, reformatted, corrected and integrated by
  15       Ben Laurie]
  16
  17   *) Updates to the new SSL compression code
  18      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
  19
  20   *) Fix so that the version number in the master secret, when passed
  21      via RSA, checks that if TLS was proposed, but we roll back to SSLv3
  22      (because the server will not accept higher), that the version number
  23      is 0x03,0x01, not 0x03,0x00
  24      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
  25
  26   *) Run extensive memory leak checks on SSL apps. Fixed *lots* of memory
  27      leaks in ssl/ relating to new X509_get_pubkey() behaviour. Also fixes
  28      in apps/ and an unrellated leak in crypto/dsa/dsa_vrf.c
  29      [Steve Henson]
  30
  31   *) Support for RAW extensions where an arbitrary extension can be
  32      created by including its DER encoding. See apps/openssl.cnf for
  33      an example.
  34      [Steve Henson]
  35
  36   *) Make sure latest Perl versions don't interpret some generated C array
  37      code as Perl array code in the crypto/err/err_genc.pl script.
  38      [Lars Weber <3weber@informatik.uni-hamburg.de>]
  39
  40   *) Modify ms/do_ms.bat to not generate assembly language makefiles since
  41      not many people have the assembler. Various Win32 compilation fixes and
  42      update to the INSTALL.W32 file with (hopefully) more accurate Win32
  43      build instructions.
  44      [Steve Henson]
  45
  46   *) Modify configure script 'Configure' to automatically create crypto/date.h
  47      file under Win32 and also build pem.h from pem.org. New script
  48      util/mkfiles.pl to create the MINFO file on environments that can't do a
  49      'make files': perl util/mkfiles.pl >MINFO should work.
  50      [Steve Henson]
  51
  52   *) Major rework of DES function declarations, in the pursuit of correctness
  53      and purity. As a result, many evil casts evaporated, and some weirdness,
  54      too. You may find this causes warnings in your code. Zapping your evil
  55      casts will probably fix them. Mostly.
  56      [Ben Laurie]
  57
  58   *) Fix for a typo in asn1.h. Bug fix to object creation script
  59      obj_dat.pl. It considered a zero in an object definition to mean
  60      "end of object": none of the objects in objects.h have any zeros
  61      so it wasn't spotted.
  62      [Steve Henson, reported by Erwann ABALEA <eabalea@certplus.com>]
  63
  64   *) Add support for Triple DES Cipher Block Chaining with Output Feedback
  65      Masking (CBCM). In the absence of test vectors, the best I have been able
  66      to do is check that the decrypt undoes the encrypt, so far. Send me test
  67      vectors if you have them.
  68      [Ben Laurie]
  69
  70   *) Correct caclulation of key length for export ciphers (too much space was
  71      allocated for null ciphers). This has not been tested!
  72      [Ben Laurie]
  73
  74   *) Modifications to the mkdef.pl for Win32 DEF file creation. The usage
  75      message is now correct (it understands "crypto" and "ssl" on its
  76      command line). There is also now an "update" option. This will update
  77      the util/ssleay.num and util/libeay.num files with any new functions.
  78      If you do a:
  79      perl util/mkdef.pl crypto ssl update
  80      it will update them.
  81      [Steve Henson]
  82
  83   *) Overhauled the Perl interface (perl/*):
  84      - ported BN stuff to OpenSSL's different BN library
  85      - made the perl/ source tree CVS-aware
  86      - renamed the package from SSLeay to OpenSSL (the files still contain
  87        their history because I've copied them in the repository)
  88      - removed obsolete files (the test scripts will be replaced
  89        by better Test::Harness variants in the future)
  90      [Ralf S. Engelschall]
  91
  92   *) First cut for a very conservative source tree cleanup:
  93      1. merge various obsolete readme texts into doc/ssleay.txt
  94      where we collect the old documents and readme texts.
  95      2. remove the first part of files where I'm already sure that we no
  96      longer need them because of three reasons: either they are just temporary
  97      files which were left by Eric or they are preserved original files where
  98      I've verified that the diff is also available in the CVS via "cvs diff
  99      -rSSLeay_0_8_1b" or they were renamed (as it was definitely the case for
 100      the crypto/md/ stuff).
 101      [Ralf S. Engelschall]
 102
 103   *) More extension code. Incomplete support for subject and issuer alt
 104      name, issuer and authority key id. Change the i2v function parameters
 105      and add an extra 'crl' parameter in the X509V3_CTX structure: guess
 106      what that's for :-) Fix to ASN1 macro which messed up
 107      IMPLICIT tag and add f_enum.c which adds a2i, i2a for ENUMERATED.
 108      [Steve Henson]
 109
 110   *) Preliminary support for ENUMERATED type. This is largely copied from the
 111      INTEGER code.
 112      [Steve Henson]
 113
 114   *) Add new function, EVP_MD_CTX_copy() to replace frequent use of memcpy.
 115      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
 116
 117   *) Make sure `make rehash' target really finds the `openssl' program.
 118      [Ralf S. Engelschall, Matthias Loepfe <Matthias.Loepfe@adnovum.ch>]
 119
 120   *) Squeeze another 7% of speed out of MD5 assembler, at least on a P2. I'd
 121      like to hear about it if this slows down other processors.
 122      [Ben Laurie]
 123
 124   *) Add CygWin32 platform information to Configure script.
 125      [Alan Batie <batie@aahz.jf.intel.com>]
 126
 127   *) Fixed ms/32all.bat script: `no_asm' -> `no-asm'
 128      [Rainer W. Gerling <gerling@mpg-gv.mpg.de>]
 129
 130   *) New program nseq to manipulate netscape certificate sequences
 131      [Steve Henson]
 132
 133   *) Modify crl2pkcs7 so it supports multiple -certfile arguments. Fix a
 134      few typos.
 135      [Steve Henson]
 136
 137   *) Fixes to BN code.  Previously the default was to define BN_RECURSION
 138      but the BN code had some problems that would cause failures when
 139      doing certificate verification and some other functions.
 140      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
 141
 142   *) Add ASN1 and PEM code to support netscape certificate sequences.
 143      [Steve Henson]
 144
 145   *) Add ASN1 and PEM code to support netscape certificate sequences.
 146      [Steve Henson]
 147
 148   *) Add several PKIX and private extended key usage OIDs.
 149      [Steve Henson]
 150
 151   *) Modify the 'ca' program to handle the new extension code. Modify
 152      openssl.cnf for new extension format, add comments.
 153      [Steve Henson]
 154
 155   *) More X509 V3 changes. Fix typo in v3_bitstr.c. Add support to 'req'
 156      and add a sample to openssl.cnf so req -x509 now adds appropriate
 157      CA extensions.
 158      [Steve Henson]
 159
 160   *) Continued X509 V3 changes. Add to other makefiles, integrate with the
 161      error code, add initial support to X509_print() and x509 application.
 162      [Steve Henson]
 163
 164   *) Takes a deep breath and start addding X509 V3 extension support code. Add
 165      files in crypto/x509v3. Move original stuff to crypto/x509v3/old. All this
 166      stuff is currently isolated and isn't even compiled yet.
 167      [Steve Henson]
 168
 169   *) Continuing patches for GeneralizedTime. Fix up certificate and CRL
 170      ASN1 to use ASN1_TIME and modify print routines to use ASN1_TIME_print.
 171      Removed the versions check from X509 routines when loading extensions:
 172      this allows certain broken certificates that don't set the version
 173      properly to be processed.
 174      [Steve Henson]
 175
 176   *) Deal with irritating shit to do with dependencies, in YAAHW (Yet Another
 177      Ad Hoc Way) - Makefile.ssls now all contain local dependencies, which
 178      can still be regenerated with "make depend".
 179      [Ben Laurie]
 180
 181   *) Spelling mistake in C version of CAST-128.
 182      [Ben Laurie, reported by Jeremy Hylton <jeremy@cnri.reston.va.us>]
 183
 184   *) Changes to the error generation code. The perl script err-code.pl
 185      now reads in the old error codes and retains the old numbers, only
 186      adding new ones if necessary. It also only changes the .err files if new
 187      codes are added. The makefiles have been modified to only insert errors
 188      when needed (to avoid needlessly modifying header files). This is done
 189      by only inserting errors if the .err file is newer than the auto generated
 190      C file. To rebuild all the error codes from scratch (the old behaviour)
 191      either modify crypto/Makefile.ssl to pass the -regen flag to err_code.pl
 192      or delete all the .err files.
 193      [Steve Henson]
 194
 195   *) CAST-128 was incorrectly implemented for short keys. The C version has
 196      been fixed, but is untested. The assembler versions are also fixed, but
 197      new assembler HAS NOT BEEN GENERATED FOR WIN32 - the Makefile needs fixing
 198      to regenerate it if needed.
 199      [Ben Laurie, reported (with fix for C version) by Jun-ichiro itojun
 200       Hagino <itojun@kame.net>]
 201
 202   *) File was opened incorrectly in randfile.c.
 203      [Ulf Möller <ulf@fitug.de>]
 204
 205   *) Beginning of support for GeneralizedTime. d2i, i2d, check and print
 206      functions. Also ASN1_TIME suite which is a CHOICE of UTCTime or
 207      GeneralizedTime. ASN1_TIME is the proper type used in certificates et
 208      al: it's just almost always a UTCTime. Note this patch adds new error
 209      codes so do a "make errors" if there are problems.
 210      [Steve Henson]
 211
 212   *) Correct Linux 1 recognition in config.
 213      [Ulf Möller <ulf@fitug.de>]
 214
 215   *) Remove pointless MD5 hash when using DSA keys in ca.
 216      [Anonymous <nobody@replay.com>]
 217
 218   *) Generate an error if given an empty string as a cert directory. Also
 219      generate an error if handed NULL (previously returned 0 to indicate an
 220      error, but didn't set one).
 221      [Ben Laurie, reported by Anonymous <nobody@replay.com>]
 222
 223   *) Add prototypes to SSL methods. Make SSL_write's buffer const, at last.
 224      [Ben Laurie]
 225
 226   *) Fix the dummy function BN_ref_mod_exp() in rsaref.c to have the correct
 227      parameters. This was causing a warning which killed off the Win32 compile.
 228      [Steve Henson]
 229
 230   *) Remove C++ style comments from crypto/bn/bn_local.h.
 231      [Neil Costigan <neil.costigan@celocom.com>]
 232
 233   *) The function OBJ_txt2nid was broken. It was supposed to return a nid
 234      based on a text string, looking up short and long names and finally
 235      "dot" format. The "dot" format stuff didn't work. Added new function
 236      OBJ_txt2obj to do the same but return an ASN1_OBJECT and rewrote
 237      OBJ_txt2nid to use it. OBJ_txt2obj can also return objects even if the
 238      OID is not part of the table.
 239      [Steve Henson]
 240
 241   *) Add prototypes to X509 lookup/verify methods, fixing a bug in
 242      X509_LOOKUP_by_alias().
 243      [Ben Laurie]
 244
 245   *) Sort openssl functions by name.
 246      [Ben Laurie]
 247
 248   *) Get the gendsa program working (hopefully) and add it to app list. Remove
 249      encryption from sample DSA keys (in case anyone is interested the password
 250      was "1234").
 251      [Steve Henson]
 252
 253   *) Make _all_ *_free functions accept a NULL pointer.
 254      [Frans Heymans <fheymans@isaserver.be>]
 255
 256   *) If a DH key is generated in s3_srvr.c, don't blow it by trying to use
 257      NULL pointers.
 258      [Anonymous <nobody@replay.com>]
 259
 260   *) s_server should send the CAfile as acceptable CAs, not its own cert.
 261      [Bodo Moeller <3moeller@informatik.uni-hamburg.de>]
 262
 263   *) Don't blow it for numeric -newkey arguments to apps/req.
 264      [Bodo Moeller <3moeller@informatik.uni-hamburg.de>]
 265
 266   *) Temp key "for export" tests were wrong in s3_srvr.c.
 267      [Anonymous <nobody@replay.com>]
 268
 269   *) Add prototype for temp key callback functions
 270      SSL_CTX_set_tmp_{rsa,dh}_callback().
 271      [Ben Laurie]
 272
 273   *) Make DH_free() tolerate being passed a NULL pointer (like RSA_free() and
 274      DSA_free()). Make X509_PUBKEY_set() check for errors in d2i_PublicKey().
 275      [Steve Henson]
 276
 277   *) X509_name_add_entry() freed the wrong thing after an error.
 278      [Arne Ansper <arne@ats.cyber.ee>]
 279
 280   *) rsa_eay.c would attempt to free a NULL context.
 281      [Arne Ansper <arne@ats.cyber.ee>]
 282
 283   *) BIO_s_socket() had a broken should_retry() on Windoze.
 284      [Arne Ansper <arne@ats.cyber.ee>]
 285
 286   *) BIO_f_buffer() didn't pass on BIO_CTRL_FLUSH.
 287      [Arne Ansper <arne@ats.cyber.ee>]
 288
 289   *) Make sure the already existing X509_STORE->depth variable is initialized
 290      in X509_STORE_new(), but document the fact that this variable is still
 291      unused in the certificate verification process.
 292      [Ralf S. Engelschall]
 293
 294   *) Fix the various library and apps files to free up pkeys obtained from
 295      X509_PUBKEY_get() et al. Also allow x509.c to handle netscape extensions.
 296      [Steve Henson]
 297
 298   *) Fix reference counting in X509_PUBKEY_get(). This makes
 299      demos/maurice/example2.c work, amongst others, probably.
 300      [Steve Henson and Ben Laurie]
 301
 302   *) First cut of a cleanup for apps/. First the `ssleay' program is now named
 303      `openssl' and second, the shortcut symlinks for the `openssl <command>'
 304      are no longer created. This way we have a single and consistent command
 305      line interface `openssl <command>', similar to `cvs <command>'.
 306      [Ralf S. Engelschall, Paul Sutton and Ben Laurie]
 307
 308   *) ca.c: move test for DSA keys inside #ifndef NO_DSA. Make pubkey
 309      BIT STRING wrapper always have zero unused bits.
 310      [Steve Henson]
 311
 312   *) Add CA.pl, perl version of CA.sh, add extended key usage OID.
 313      [Steve Henson]
 314
 315   *) Make the top-level INSTALL documentation easier to understand.
 316      [Paul Sutton]
 317
 318   *) Makefiles updated to exit if an error occurs in a sub-directory
 319      make (including if user presses ^C) [Paul Sutton]
 320
 321   *) Make Montgomery context stuff explicit in RSA data structure.
 322      [Ben Laurie]
 323
 324   *) Fix build order of pem and err to allow for generated pem.h.
 325      [Ben Laurie]
 326
 327   *) Fix renumbering bug in X509_NAME_delete_entry().
 328      [Ben Laurie]
 329
 330   *) Enhanced the err-ins.pl script so it makes the error library number
 331      global and can add a library name. This is needed for external ASN1 and
 332      other error libraries.
 333      [Steve Henson]
 334
 335   *) Fixed sk_insert which never worked properly.
 336      [Steve Henson]
 337
 338   *) Fix ASN1 macros so they can handle indefinite length construted
 339      EXPLICIT tags. Some non standard certificates use these: they can now
 340      be read in.
 341      [Steve Henson]
 342
 343   *) Merged the various old/obsolete SSLeay documentation files (doc/xxx.doc)
 344      into a single doc/ssleay.txt bundle. This way the information is still
 345      preserved but no longer messes up this directory. Now it's new room for
 346      the new set of documenation files.
 347      [Ralf S. Engelschall]
 348
 349   *) SETs were incorrectly DER encoded. This was a major pain, because they
 350      shared code with SEQUENCEs, which aren't coded the same. This means that
 351      almost everything to do with SETs or SEQUENCEs has either changed name or
 352      number of arguments.
 353      [Ben Laurie, based on a partial fix by GP Jayan <gp@nsj.co.jp>]
 354
 355   *) Fix test data to work with the above.
 356      [Ben Laurie]
 357
 358   *) Fix the RSA header declarations that hid a bug I fixed in 0.9.0b but
 359      was already fixed by Eric for 0.9.1 it seems.
 360      [Ben Laurie - pointed out by Ulf Möller <ulf@fitug.de>]
 361
 362   *) Autodetect FreeBSD3.
 363      [Ben Laurie]
 364
 365   *) Fix various bugs in Configure. This affects the following platforms:
 366      nextstep
 367      ncr-scde
 368      unixware-2.0
 369      unixware-2.0-pentium
 370      sco5-cc.
 371      [Ben Laurie]
 372
 373   *) Eliminate generated files from CVS. Reorder tests to regenerate files
 374      before they are needed.
 375      [Ben Laurie]
 376
 377   *) Generate Makefile.ssl from Makefile.org (to keep CVS happy).
 378      [Ben Laurie]
 379
 380  Changes between 0.9.1b and 0.9.1c
 381
 382   *) Added OPENSSL_VERSION_NUMBER to crypto/crypto.h and
 383      changed SSLeay to OpenSSL in version strings.
 384      [Ralf S. Engelschall]
 385
 386   *) Some fixups to the top-level documents.
 387      [Paul Sutton]
 388
 389   *) Fixed the nasty bug where rsaref.h was not found under compile-time
 390      because the symlink to include/ was missing.
 391      [Ralf S. Engelschall]
 392
 393   *) Incorporated the popular no-RSA/DSA-only patches
 394      which allow to compile a RSA-free SSLeay.
 395      [Andrew Cooke / Interrader Ldt., Ralf S. Engelschall]
 396
 397   *) Fixed nasty rehash problem under `make -f Makefile.ssl links'
 398      when "ssleay" is still not found.
 399      [Ralf S. Engelschall]
 400
 401   *) Added more platforms to Configure: Cray T3E, HPUX 11,
 402      [Ralf S. Engelschall, Beckmann <beckman@acl.lanl.gov>]
 403
 404   *) Updated the README file.
 405      [Ralf S. Engelschall]
 406
 407   *) Added various .cvsignore files in the CVS repository subdirs
 408      to make a "cvs update" really silent.
 409      [Ralf S. Engelschall]
 410
 411   *) Recompiled the error-definition header files and added
 412      missing symbols to the Win32 linker tables.
 413      [Ralf S. Engelschall]
 414
 415   *) Cleaned up the top-level documents;
 416      o new files: CHANGES and LICENSE
 417      o merged VERSION, HISTORY* and README* files a CHANGES.SSLeay
 418      o merged COPYRIGHT into LICENSE
 419      o removed obsolete TODO file
 420      o renamed MICROSOFT to INSTALL.W32
 421      [Ralf S. Engelschall]
 422
 423   *) Removed dummy files from the 0.9.1b source tree:
 424      crypto/asn1/x crypto/bio/cd crypto/bio/fg crypto/bio/grep crypto/bio/vi
 425      crypto/bn/asm/......add.c crypto/bn/asm/a.out crypto/dsa/f crypto/md5/f
 426      crypto/pem/gmon.out crypto/perlasm/f crypto/pkcs7/build crypto/rsa/f
 427      crypto/sha/asm/f crypto/threads/f ms/zzz ssl/f ssl/f.mak test/f
 428      util/f.mak util/pl/f util/pl/f.mak crypto/bf/bf_locl.old apps/f
 429      [Ralf S. Engelschall]
 430
 431   *) Added various platform portability fixes.
 432      [Mark J. Cox]
 433
 434   *) The Genesis of the OpenSSL rpject:
 435      We start with the latest (unreleased) SSLeay version 0.9.1b which Eric A.
 436      Young and Tim J. Hudson created while they were working for C2Net until
 437      summer 1998.
 438      [The OpenSSL Project]
 439
 440  Changes between 0.9.0b and 0.9.1b
 441
 442   *) Updated a few CA certificates under certs/
 443      [Eric A. Young]
 444
 445   *) Changed some BIGNUM api stuff.
 446      [Eric A. Young]
 447
 448   *) Various platform ports: OpenBSD, Ultrix, IRIX 64bit, NetBSD,
 449      DGUX x86, Linux Alpha, etc.
 450      [Eric A. Young]
 451
 452   *) New COMP library [crypto/comp/] for SSL Record Layer Compression:
 453      RLE (dummy implemented) and ZLIB (really implemented when ZLIB is
 454      available).
 455      [Eric A. Young]
 456
 457   *) Add -strparse option to asn1pars program which parses nested
 458      binary structures
 459      [Dr Stephen Henson <shenson@bigfoot.com>]
 460
 461   *) Added "oid_file" to ssleay.cnf for "ca" and "req" programs.
 462      [Eric A. Young]
 463
 464   *) DSA fix for "ca" program.
 465      [Eric A. Young]
 466
 467   *) Added "-genkey" option to "dsaparam" program.
 468      [Eric A. Young]
 469
 470   *) Added RIPE MD160 (rmd160) message digest.
 471      [Eric A. Young]
 472
 473   *) Added -a (all) option to "ssleay version" command.
 474      [Eric A. Young]
 475
 476   *) Added PLATFORM define which is the id given to Configure.
 477      [Eric A. Young]
 478
 479   *) Added MemCheck_XXXX functions to crypto/mem.c for memory checking.
 480      [Eric A. Young]
 481
 482   *) Extended the ASN.1 parser routines.
 483      [Eric A. Young]
 484
 485   *) Extended BIO routines to support REUSEADDR, seek, tell, etc.
 486      [Eric A. Young]
 487
 488   *) Added a BN_CTX to the BN library.
 489      [Eric A. Young]
 490
 491   *) Fixed the weak key values in DES library
 492      [Eric A. Young]
 493
 494   *) Changed API in EVP library for cipher aliases.
 495      [Eric A. Young]
 496
 497   *) Added support for RC2/64bit cipher.
 498      [Eric A. Young]
 499
 500   *) Converted the lhash library to the crypto/mem.c functions.
 501      [Eric A. Young]
 502
 503   *) Added more recognized ASN.1 object ids.
 504      [Eric A. Young]
 505
 506   *) Added more RSA padding checks for SSL/TLS.
 507      [Eric A. Young]
 508
 509   *) Added BIO proxy/filter functionality.
 510      [Eric A. Young]
 511
 512   *) Added extra_certs to SSL_CTX which can be used
 513      send extra CA certificates to the client in the CA cert chain sending
 514      process. It can be configured with SSL_CTX_add_extra_chain_cert().
 515      [Eric A. Young]
 516
 517   *) Now Fortezza is denied in the authentication phase because
 518      this is key exchange mechanism is not supported by SSLeay at all.
 519      [Eric A. Young]
 520
 521   *) Additional PKCS1 checks.
 522      [Eric A. Young]
 523
 524   *) Support the string "TLSv1" for all TLS v1 ciphers.
 525      [Eric A. Young]
 526
 527   *) Added function SSL_get_ex_data_X509_STORE_CTX_idx() which gives the
 528      ex_data index of the SSL context in the X509_STORE_CTX ex_data.
 529      [Eric A. Young]
 530
 531   *) Fixed a few memory leaks.
 532      [Eric A. Young]
 533
 534   *) Fixed various code and comment typos.
 535      [Eric A. Young]
 536
 537   *) A minor bug in ssl/s3_clnt.c where there would always be 4 0
 538      bytes sent in the client random.
 539      [Edward Bishop <ebishop@spyglass.com>]
 540