home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Security / Security.zip / blowfish.zip / README < prev    next >
Text File  |  1994-08-29  |  3KB  |  59 lines
  1.                                   README File
  2.                                   -----------
  3.  
  4. Blowfish is an encryption and decryption utility that uses Bruce Schneier's
  5. public domain Blowfish algorithm.  I've just structured an application around 
  6. it.  It still has a few deficiencies (see TODO) that I might get around to 
  7. removing some day after I've finished my thesis.
  8.  
  9. Blowfish is postcardware.  If you like what I've done send me a postcard with
  10. your home town on it.
  11.  
  12. Oh yeah.  I, nor ECU (nor anybody in fact) assume responsibility for anything 
  13. blowfish has done, is doing, or will do at an point in time in all dimensions 
  14. blah blah blah legalese blah gurgle...  Basically you're responsible for
  15. whatever blowfish does or doesn't do to anything when you use it.
  16.  
  17. ─── Man Page ───────────────────────────────────────────────────────────────────
  18.  
  19. Name:
  20.    blowfish v1.0 - Encrypt and decrypt files
  21.  
  22. Syntax:
  23.    blowfish <file>[ <output>]
  24.  
  25. Synopsis:
  26.    blowfish gets a password from the keyboard and either encrypts or
  27.    decrypts the given file depending on the number of arguments
  28.    passed to it.  When blowfish receives two arguments the file named
  29.    by the first argument is encrypted; when blowfish receives a single
  30.    argument the file identified by the only argument is decrypted.
  31.    In all cases blowfish reads a password from the keyboard without
  32.    echoing it.  This password may be up from 0 to 56 characters long.
  33.  
  34.    When encrypting, blowfish stores the size, a magic number, name, and
  35.    contents of the file named by the first argument and encrypts it
  36.    using the supplied password.  This information is then written to
  37.    the file named by the second argument.
  38.  
  39.    When decrypting, blowfish loads the file named by the first argument
  40.    and decrypts it using the supplied password.  The contents are
  41.    then written to the file named in the decrypted file.
  42.  
  43. Arguments:
  44.    <file>     The name of the file to encrypt or decrypt.
  45.    <output>   The name of the file in which the encrypted file is
  46.               stored.
  47.  
  48. Author:
  49.    Stephan Bettermann (S.Bettermann@cowan.edu.au)
  50.    Department of Computer Science,
  51.    Edith Cowan University, Perth, Western Australia.
  52.  
  53. ─── Manifest ───────────────────────────────────────────────────────────────────
  54.  
  55. README       │ You're reading it
  56. TODO         │ What I'd like to do with blowfish if I had the time and the
  57.              │ inclination
  58. blowfish.exe │ The one and only executable.
  59.