home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pgpfk004.zip / PGPFAKE.DOC < prev    next >
Text File  |  1999-06-10  |  4KB  |  100 lines
  1. PGPFAKE, Version 0.04             PGP 5.0 Shell for OS/2
  2.  
  3. This shell allows programs that are designed touse PGP 2.6.3 to use PGP 5.0 instead.
  4. It was originally written as an interface between PMMail 1.96 and its old 
  5. support for PGP 2.6.3. However, the new support with v0.04 allows most 2.6.3
  6. calls to work with PGP 5.0. It is designed to work with the OS/2 port of PGP 5.0,
  7. available from http://www.openpgp.net or http://www.pgpi.com
  8.  
  9.  
  10. What's new?
  11. -----------
  12.  
  13. 0.04:
  14. NEW: Allows PGPFAKE.EXE to be called as if it were PGP.EXE, and passes
  15.      the request on to PGP5.EXE (seamless use of PGPFAKE.EXE in other words)
  16. NEW: Support for most of the 2.6.x command line structure, including passing
  17.      to PGPK.EXE and PGP5.EXE
  18. NEW: Support to always encript to the senders ID.
  19.  
  20.         project handed over to Nick Burch <Nick@Horton-Vineyard.com>
  21.  
  22. 0.03:
  23. NEW: Thanks to Walter Schmidt <wschmi@ibm.net> for giving me a hint how to
  24.      realize batchmode with PGP 5.0.
  25. NEW: Thanks to Dieter Werner <e8726172@student.tuwien.ac.at> for adding
  26.      support for "sign & encrypt".
  27. NEW: Support for adding public keys to keyring
  28. FIX: Signing a document did not always include the message text
  29. FIX: Doubly spaced text files no longer occur
  30.  
  31. 0.02:
  32. FIX: Non-initialized variable.
  33.  
  34.  
  35. Features
  36. --------
  37.  
  38. This was originally only written as a quick shell to allow PGP 5 support
  39. with PMMail, as a stop-gap until PMMail 2.0 came along with PGP 5 support.
  40. With that in mind, only the following features seem to work:
  41.  
  42. - sign a message
  43. - verify a signature
  44. - encrypt a message to 1 recipient
  45. - sign and encrypt a message to 1, 2 or 3 recipients
  46. - decrypt a message
  47. - include public key in message
  48. - add public key to keyring
  49. - seamless PGP 5 useage
  50. - PGP 2.6.x commandline usage
  51.  
  52. The following features are not implemented
  53.  
  54. - add 2.6.x public key fingerprint
  55.   PGP 5.0 needs a passphrase to generate a public key fingerprint, and since
  56.   2.6.x didn't, the passphrase isn't supplied, so there's not a lot we can do!
  57.  
  58.  
  59. How do I use this thing?
  60. ------------------------
  61.  
  62. Copy pgpfake.exe to the directory pointed to by PGPPATH. Rename your pgp.exe 
  63. to pgp5.exe and pgpfake.exe to pgp.exe. That's all. Note that this "shell" is
  64. only designed to handle calls by PMMail. It may not work with other programs.
  65. If you would like to know what the program did, set PGPFAKE_DEBUG=1 in your
  66. config.sys and reboot. pgpfake will then write a logfile to %TMP%\pgpfake.log.
  67. The result of the signature tests will be in %TMP%\signok.txt.
  68.  
  69. The program needs the emx-runtime libraries to run. If you have installed
  70. PGP 5.0, these should already be on your system. If not, you can get them
  71. from most BBS's and OS/2 ftp sites (you know the list)
  72.  
  73. If you care to comment about this program, your opinions are very much
  74. appreciated. The program and its source are Freeware. Don't blame me if
  75. something doesn't work. Fix it and send the source back to me. Thats how
  76. things get implimented!
  77.  
  78.  
  79. Known Bugs:
  80. -----------
  81. * When encripting, the last line of the message isn't encripted and so isn't sent
  82. * The 2.6.x Decript assumes that if the first argument passed to the program ends
  83.   in .pgp or .asc, then it's supposed to decode it
  84. * Some long command line arguments may be mistaken for being a PMMail call, and be
  85.   handled totally incorrectly. In this case, you'll just have to call PGP5.EXE 
  86.   yourself
  87. * You can only send encripted mail to 1 person, and signed and encripted to 1 to 3
  88.   If you want to sign and encript to more, open the source code, and see what I've
  89.   done for case 17 and 18. Modify this for case 18 (3 people) and so on. I can't 
  90.   see the need so I havn't coded for more recipients.
  91.  
  92.  
  93. Who's hehind all this?
  94. ----------------------
  95.  
  96. Versions up to 0.03
  97. Thomas Vandahl <thomas.vandahl@contec-dt.de>
  98.  
  99. Version 0.04 (and probably future ones)
  100. Nick Burch <nick@horton-vineyard.com>