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