/*
 *  libdes - Version 3.06 (30/08/94)
 *  Ported by Neil Harvey & Associates (http://nha.co.za/)
 *  September 1997
 *
 */

*** Description

This kit builds a DES encryption library and a DES encryption program.
It suports ecb, cbc, ofb, cfb, triple ecb, triple cbc and MIT's pcbc
encryption modes and also has a fast implementation of crypt(3).
It contains support routines to read keys from a terminal,
generate a random key, generate a key from an arbitary length string,
read/write encrypted data from/to a file descriptor.

The implementation was written so as to conform with the manual entry
for the des_crypt(3) library routines from MIT's project Athena.

*** Download

ftp://ftp.nha.co.za/hp3000/libdes
				
  Size:         Name            Description
  -------       -------------   ------------------
  388,758	libdes.m.Z	compressed mover archive (binaries/documentation)
  268,988       libdes.m.gz     gzip'ed mover archive (binaries/documentation)
  348,313       libdes.tar.Z    compressed tar archive (binaries/documentation)
  253,285       libdes.tar.gz   gzip'ed tar archive (binaries/documentation)

  72,609        libdes.source.tar.gz

*** Installation

  1)  transfer the archive to your hp3000 (ftp, samba, reflection)
  2)  uncompress the archive (uncompress, gzip)
  3)  extract the archive (mover, tar)

  *** NOTE ***
  i)   The archive contains absolute file names, if this is not what you want
       you are on your own.
  ii)  All the binaries have been linked to hpbin.sys.
       eg:  des.hpbin.sys = /usr/local/bin/des
  iiI) read the documentaion in /usr/local/doc/libdes


*** Configuration

  1)  modify your PATH variable to include /usr/local/bin
  2)  modify your MANPATH variable to include /usr/local/man

  *** NOTE ***
  i)  Both of these variables can be modified in /etc/profile.
  ii) The default /etc/profile does not include a MANPATH variable.
      To correctly add the variable add the following line
        MANPATH=/usr/man:/usr/local/man
        export MANPATH


*** Testing

  1)  run /usr/local/bin/rpw, check for any errors (check the read password routine)
  2)  run /usr/local/bin/destest, check for any errors
  3)  run /usr/local/bin/speed.
      On our 959/400 we get the following performance figures.
        set_key       per sec =    232426.51 (  4.3uS)
        DES ecb bytes per sec =   3019144.41 (  2.6uS)
        DES cbc bytes per sec =   3119040.32 (  2.6uS)
        crypt         per sec =     14914.06 ( 67.1uS)
  4)  run /usr/local/bin/des and encrypt and decrypt a file



Have fun and good luck,

Jens von Bulow
jens@nha.co.za