README revision 256281
1156230Smux 2156230Smux libdes, Version 4.01 10-Jan-97 3156230Smux 4156230Smux Copyright (c) 1997, Eric Young 5156230Smux All rights reserved. 6156230Smux 7156230Smux This program is free software; you can redistribute it and/or modify 8156230Smux it under the terms specified in COPYRIGHT. 9156230Smux 10156230Smux-- 11156230SmuxThe primary ftp site for this library is 12156230Smuxftp://ftp.psy.uq.oz.au/pub/Crypto/DES/libdes-x.xx.tar.gz 13156230Smuxlibdes is now also shipped with SSLeay. Primary ftp site of 14156230Smuxftp://ftp.psy.uq.oz.au/pub/Crypto/SSL/SSLeay-x.x.x.tar.gz 15156230Smux 16156230SmuxThe best way to build this library is to build it as part of SSLeay. 17156230Smux 18156230SmuxThis kit builds a DES encryption library and a DES encryption program. 19156230SmuxIt supports ecb, cbc, ofb, cfb, triple ecb, triple cbc, triple ofb, 20156230Smuxtriple cfb, desx, and MIT's pcbc encryption modes and also has a fast 21156230Smuximplementation of crypt(3). 22156230SmuxIt contains support routines to read keys from a terminal, 23156230Smuxgenerate a random key, generate a key from an arbitrary length string, 24156230Smuxread/write encrypted data from/to a file descriptor. 25156230Smux 26156230SmuxThe implementation was written so as to conform with the manual entry 27156230Smuxfor the des_crypt(3) library routines from MIT's project Athena. 28156230Smux 29156230Smuxdestest should be run after compilation to test the des routines. 30156230Smuxrpw should be run after compilation to test the read password routines. 31156230SmuxThe des program is a replacement for the sun des command. I believe it 32156230Smuxconforms to the sun version. 33156230Smux 34156230SmuxThe Imakefile is setup for use in the kerberos distribution. 35156230Smux 36156230SmuxThese routines are best compiled with gcc or any other good 37156230Smuxoptimising compiler. 38156230SmuxJust turn you optimiser up to the highest settings and run destest 39156230Smuxafter the build to make sure everything works. 40156230Smux 41156230SmuxI believe these routines are close to the fastest and most portable DES 42156230Smuxroutines that use small lookup tables (4.5k) that are publicly available. 43156230SmuxThe fcrypt routine is faster than ufc's fcrypt (when compiling with 44156230Smuxgcc2 -O2) on the sparc 2 (1410 vs 1270) but is not so good on other machines 45156230Smux(on a sun3/260 168 vs 336). It is a function of CPU on chip cache size. 46156230Smux[ 10-Jan-97 and a function of an incorrect speed testing program in 47156230Smux ufc which gave much better test figures that reality ]. 48156230Smux 49156230SmuxIt is worth noting that on sparc and Alpha CPUs, performance of the DES 50156230Smuxlibrary can vary by upto %10 due to the positioning of files after application 51156230Smuxlinkage. 52156230Smux 53156230SmuxEric Young (eay@cryptsoft.com) 54156230Smux 55156230Smux