mac/libdes/src/README

   1 \r               libdes, Version 4.01 13-Jan-97\r\r                Copyright (c) 1997, Eric Young\r                   All rights reserved.\r\r    This program is free software; you can redistribute it and/or modify\r    it under the terms specified in COPYRIGHT.\r    \r--\rThe primary ftp site for this library is\rftp://ftp.psy.uq.oz.au/pub/Crypto/DES/libdes-x.xx.tar.gz\rlibdes is now also shipped with SSLeay.  Primary ftp site of\rftp://ftp.psy.uq.oz.au/pub/Crypto/SSL/SSLeay-x.x.x.tar.gz\r\rThe best way to build this library is to build it as part of SSLeay.\r\rThis kit builds a DES encryption library and a DES encryption program.\rIt supports ecb, cbc, ofb, cfb, triple ecb, triple cbc, triple ofb,\rtriple cfb, desx, and MIT's pcbc encryption modes and also has a fast\rimplementation of crypt(3).\rIt contains support routines to read keys from a terminal,\rgenerate a random key, generate a key from an arbitrary length string,\rread/write encrypted data from/to a file descriptor.\r\rThe implementation was written so as to conform with the manual entry\rfor the des_crypt(3) library routines from MIT's project Athena.\r\rdestest should be run after compilation to test the des routines.\rrpw should be run after compilation to test the read password routines.\rThe des program is a replacement for the sun des command.  I believe it\rconforms to the sun version.\r\rThe Imakefile is setup for use in the kerberos distribution.\r\rThese routines are best compiled with gcc or any other good\roptimising compiler.\rJust turn you optimiser up to the highest settings and run destest\rafter the build to make sure everything works.\r\rI believe these routines are close to the fastest and most portable DES\rroutines that use small lookup tables (4.5k) that are publicly available.\rThe fcrypt routine is faster than ufc's fcrypt (when compiling with\rgcc2 -O2) on the sparc 2 (1410 vs 1270) but is not so good on other machines\r(on a sun3/260 168 vs 336).  It is a function of CPU on chip cache size.\r[ 10-Jan-97 and a function of an incorrect speed testing program in\r  ufc which gave much better test figures that reality ].\r\rIt is worth noting that on sparc and Alpha CPUs, performance of the DES\rlibrary can vary by upto %10 due to the positioning of files after application\rlinkage.\r\rEric Young (eay@mincom.oz.au)\r\r