README or Readme Src or Readme Bin Frequently Asked Questions Javadoc index or Help Documentation Java Cryptography Extension Specification Utility scripts Copyright and License

Cryptix Development Team

Introduction

Included in the Compiled Classes distribution is:

• the IJCE and providers packaged in JARs
• test programs within the JARs
• useful scripts to get it going
• this release readme, the main readme and the FAQ etc.
• doco in guide

Installation

For this Compiled Classes also do the following:

1. Do not unJAR the archives (*.jar) within the classes directory.

Testing

This distribution was tested at make time, and the actions were recorded into platform scripts in the auto directory (see auto/testjar*).

No JARs failed their tests.

In order to repeat the distribution tests, do for Unix:

    ../auto/testjar.sh

    ; Note, this batch is untested - and written by a non-DOS person :-)
    ..\auto\testjar

If any of the above listed working tests fail, please send a bug report. Note that the automatic release script produces a list of working tests; non-working tests are commented out. The latter should not be present, as non-working code is dropped from formal releases.

New in Release 3.0.3

MD5, SHA-1, SHA-0 have a known bug using the update() method. With SHA-1 and SHA-0, this case is commented out in the Test*.java programs. It is used to add digest data in bulk, the relevant test is the million a's of the conformance set.

This release - 3.0.3 - is mostly a bug fix release. These features are now included:

• Tools: example programs demonstrating Cryptix:
  • Scar is an archiver that uses message digests and ciphers.
  • UnixCrypt is an emulation of the infamous Unix crypt(3) function.
  Tools are found in cryptix/tools.
• HMACs for all message digests have been added, according to RFC-2104 and RFC-2202.
• Cryptix 2.2 compatibility now includes:
  • message digests,
  • modes,
  • ancillary classes
  along with the ciphers.
• documentation:
  • Supported Algorithms shows all algorithms supported with useful details in colours.
• Bugs fixed in these areas:
  • RSA gave an occasional ArrayIndexOutOfBoundsException which is now fixed. ElGamal has the same bug, but that's not fixed yet.
  • Triple DES data has now been checked against at least one other implementation.

These features were included in the previous release:

• PK: ElGamal over GF(p) is now included.
• Symmetric key algorithms: DES-EDE3 - Triple DES with 3 keys.
• message digests SHA1, SHA0, MD5. These new MDs are using old code and are missing Cloneable, and the update method doesn't currently work.
• Cryptix 2.2 cipher compatibility.
• Documentation: The FAQ and Guides.

What's *not* here

• compatibility with Java 1.2
• IJCE:
  • test devoted to IJCE that can run independant of Cryptix (java.security.IJCE_test or some Sun standard name?)
• testing:
  • Some of the Test* programs do not correctly exit, so failures are not detected.
  • util/testjar.sh produces guess-code W95/NT batch scripts in auto/testjar.bat.
• Cryptix 2.2 compatibility:
  • RSA
  is still to be done.
• Native libraries are not currently included.
• PGP is not here at all
• Cryptix has only been compiled and run with Sun-sourced compilers and JVMs. Specifically, there is a compilation error with Guavac. Other non-Sun tools have not been tried yet.
• Javadoc is distributed without images.

Mail us with your priorities.

Bug Reports

Please include

• the Cryptix version number: 3.0.3,
• the type of distribution: bin,
• your JDK version / supplier,
• the platform

Note that if you are not subscribed, you should do so. Regardless, bugs will caught by the list manager and sent to an appropriate Cryptix Development Team member.

Copyright and License

This release of Cryptix is covered by the Cryptix General License .