README revision 272461
1220422Sgabor 2220422Sgabor libdes, Version 4.01 10-Jan-97 3210389Sgabor 4210389Sgabor Copyright (c) 1997, Eric Young 5210389Sgabor All rights reserved. 6211496Sdes 7210389Sgabor This program is free software; you can redistribute it and/or modify 8210389Sgabor it under the terms specified in COPYRIGHT. 9210389Sgabor 10210389Sgabor-- 11210389SgaborThe primary ftp site for this library is 12210389Sgaborftp://ftp.psy.uq.oz.au/pub/Crypto/DES/libdes-x.xx.tar.gz 13210389Sgaborlibdes is now also shipped with SSLeay. Primary ftp site of 14210389Sgaborftp://ftp.psy.uq.oz.au/pub/Crypto/SSL/SSLeay-x.x.x.tar.gz 15210389Sgabor 16210389SgaborThe best way to build this library is to build it as part of SSLeay. 17210389Sgabor 18210389SgaborThis kit builds a DES encryption library and a DES encryption program. 19210389SgaborIt supports ecb, cbc, ofb, cfb, triple ecb, triple cbc, triple ofb, 20210389Sgabortriple cfb, desx, and MIT's pcbc encryption modes and also has a fast 21210389Sgaborimplementation of crypt(3). 22210389SgaborIt contains support routines to read keys from a terminal, 23210389Sgaborgenerate a random key, generate a key from an arbitrary length string, 24210389Sgaborread/write encrypted data from/to a file descriptor. 25210389Sgabor 26210389SgaborThe implementation was written so as to conform with the manual entry 27210389Sgaborfor the des_crypt(3) library routines from MIT's project Athena. 28210389Sgabor 29210389Sgabordestest should be run after compilation to test the des routines. 30210389Sgaborrpw should be run after compilation to test the read password routines. 31210389SgaborThe des program is a replacement for the sun des command. I believe it 32210389Sgaborconforms to the sun version. 33210389Sgabor 34210389SgaborThe Imakefile is setup for use in the kerberos distribution. 35210389Sgabor 36210389SgaborThese routines are best compiled with gcc or any other good 37210389Sgaboroptimising compiler. 38210389SgaborJust turn you optimiser up to the highest settings and run destest 39210389Sgaborafter the build to make sure everything works. 40210389Sgabor 41226261SgaborI believe these routines are close to the fastest and most portable DES 42210389Sgaborroutines that use small lookup tables (4.5k) that are publicly available. 43210389SgaborThe fcrypt routine is faster than ufc's fcrypt (when compiling with 44210389Sgaborgcc2 -O2) on the sparc 2 (1410 vs 1270) but is not so good on other machines 45210389Sgabor(on a sun3/260 168 vs 336). It is a function of CPU on chip cache size. 46210389Sgabor[ 10-Jan-97 and a function of an incorrect speed testing program in 47210389Sgabor ufc which gave much better test figures that reality ]. 48210389Sgabor 49210389SgaborIt is worth noting that on sparc and Alpha CPUs, performance of the DES 50210389Sgaborlibrary can vary by upto %10 due to the positioning of files after application 51210389Sgaborlinkage. 52226261Sgabor 53210389SgaborEric Young (eay@cryptsoft.com) 54210389Sgabor 55210389Sgabor