home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / menu / 006 / pgpshell.doc < prev    next >
Text File  |  1993-05-21  |  15KB  |  355 lines
  1.  
  2.  
  3.                               -= PGPShell =-
  4.  
  5.  
  6.  
  7.              Official Menu-Driven Shell of the 1996 Olympics!
  8.  
  9.            Endorsed by the Saddam Hussein Downhill Ski Team, the
  10.             National Security Agency, and the Captain Midnight
  11.                      "Secret Decoder Ring" Fan Club
  12.  
  13.  
  14.                     (c) copyright by James Still 1993
  15.                   of the Hieroglyphic Voodoo Machine BBS 
  16.                     in snowy Boulder, Colorado, U.S.A. 
  17.                             All Rights Reserved
  18.  
  19.  
  20.           PGPShell v 2.1 is released as freeware on May 21, 1993
  21.  
  22.  
  23.           Pretty Good Privacy (PGP) is (c) copyrighted 1990-1992
  24.                            by Philip Zimmermann
  25.  
  26.  
  27.  
  28.  
  29. WHAT'S WITH VER 2.1?
  30. ------------------------------------------------------------------------
  31.  
  32. A nifty little routine that created a first name list of all your public 
  33. key UserID's turned out to be not so nifty for a dozen or so people that 
  34. e-mailed me.  Version 2.0 created its own output file by piping to a text 
  35. file using PGP's -kv argument.  However it did cause some headaches for
  36. the dozen or so people I mentioned, and they couldn't get PGPShell to run
  37. on their machines at all.  So for now (and since this is freeware!) I 
  38. pulled the routine out until I have time to implement a better list function
  39. with a future version.  For 99% of you, this bug never manifested itself
  40. but now you know why the 2.1.  Also thank you Professor Salmi of University
  41. of Vaasa for keeping me honest and pointing out a few bugs that kept version
  42. 2.0 from being completely "idiot-proof."  PGPShell 2.1 will give you a 
  43. warning message (instead of bombing) if you select something other than
  44. an executable text editor when creating the PGPSHELL.CFG file.  
  45.  
  46. Okay, on with the show...
  47.  
  48.  
  49.  
  50.  
  51. WARRANTY
  52. -------------------------------------------------------------------------
  53.  
  54. Nope!  Use at your own risk.  James Still (and his evil twin Johannes 
  55. Kepler) disclaim all warranties, expressed or implied, including without
  56. limitation, the warranties of use and/or fitness of PGPShell for any
  57. purpose.  James Still assumes no liabilities for damages, direct or
  58. consequential, which may result from the use or misuse of PGPShell.
  59. PGPShell is FREEWARE which means you may use it without charge for as 
  60. long as you want to, even on Mars, and 53 miles west of Venus if you
  61. should so desire.  However, James Still retains all rights to the 
  62. copyright of PGPShell versions 1.0, 2.0, and 2.1.  When they make a 
  63. movie of it someday, I want to be there to say "No, no, the menu 
  64. structure didn't look like that at all!"
  65.  
  66.  
  67.  
  68.  
  69. QUICK START
  70. --------------------------------------------------------------------------
  71.  
  72. Create a C:\PGPSHELL directory and copy PGPSHELL.EXE into that directory.
  73. Run PGPSHELL.  Use the ESC, ENTER, arrow keys, and TAB key to manually
  74. navigate around PGPShell, or use your mouse if it is installed.
  75.  
  76.  
  77.  
  78.  
  79. INTRODUCTION
  80. --------------------------------------------------------------------------
  81.  
  82. PGPShell version 2.0 is a menu-driven front-end that makes Phil
  83. Zimmermann's excellent program Pretty Good Privacy (PGP) easier to manage
  84. and use.  Use it instead of PGP to make your encryption life easier!
  85. Improvements over the first version are too numerous to go into fully as
  86. 2.0 is practically a complete rewrite, but the biggies are:  GUI and
  87. mouse driver, full support of all PGP commands, expanded sub-menu for key
  88. management with logically arranged "drop-down" menus, plaintext file
  89. viewer, and a text editor interface.
  90.  
  91. For the public key encryption novice, PGPShell should be a perfect
  92. introduction to the exciting and wacky world of (what Andy Hawks coined
  93. in a recent Future Culture FAQ) "Cypherpunk."  (Kinda catchy ain't it?  
  94. What'll they think of next...<g>)
  95.  
  96. You should make sure that the executable file is a good one by looking at
  97. the date and time stamp.  From the DOS prompt type "dir PGPSHELL.EXE" and
  98. you should see this:
  99.  
  100.              PGPSHELL EXE       120432   05-21-93    8:15p
  101.  
  102. If it says anything else I didn't compile it!  Granted some ex-KGB agent
  103. could set his computers date and time, and the file size, but hey who's
  104. that paranoid?  Nevertheless if you don't trust it, call up the 
  105. Hieroglyphic Voodoo Machine BBS at 1.303.443.2457 and download yourself a 
  106. fresh, clean copy.  On the Internet ftp from the soda.berkeley.edu site in
  107. directory \pub\cypherpunks\pgp.
  108.  
  109.  
  110.  
  111. GETTING STARTED
  112. --------------------------------------------------------------------------
  113.  
  114. These title heads are starting to look like an old WordPerfect manual eh?  
  115. PGPShell is DOS-only which means that I don't know how to port this to 
  116. UNIX.  UNIX-guru's can write their own scripts in PERL and abhor the 
  117. heresy's of mouse drivers so I think its safe to assume that they won't 
  118. be joining us anyway.  Okay to get things set up, from the root directory
  119. (C:\) of DOS enter these commands:
  120.  
  121.                           md pgpshell
  122.                           cd pgpshell
  123.  
  124. Then copy the PGPSHELL.EXE file and any other related docs, into the
  125. PGPSHELL directory.
  126.  
  127. Type PGPSHELL at the DOS prompt to execute the program.  If you have NOT 
  128. previously installed PGP on your system, PGPShell will bug you with some 
  129. questions.  If you have never set the environment variables for PGP in 
  130. your AUTOEXEC.BAT file, PGPShell will not know where PGP is and get real 
  131. confused!  PGPShell will ask you to point out your PGP directory so that 
  132. it can run correctly.  If you want, PGPShell will even add those 
  133. environment variable lines to your AUTOEXEC.BAT file for you (first 
  134. creating a backup of your AUTOEXEC.BAT file and calling it AUTOEXEC.PGP).
  135.  
  136. See the PGP documentation for more information about setting up the PGP
  137. environment variables.
  138.  
  139.  
  140.  
  141. MAIN MENU
  142. --------------------------------------------------------------------------
  143.  
  144. In the wonderful world of cryptography, text files or "messages" are of 
  145. two types:  plaintexts and ciphertexts.  Plaintexts are unencrypted and,
  146. you guessed it, ciphertexts are encrypted.
  147.  
  148. The main menu consists of these options in handling plain/ciphertexts:
  149.  
  150.  
  151.              ■  Compose a Plaintext for Encryption
  152.              ■  View a Plaintext on Screen
  153.              ■  Encrypt a Previously Written Plaintext
  154.              ■  Decrypt a Ciphertext
  155.              ■  Archive a File
  156.              ■  Key Ring Menu
  157.  
  158.  
  159.     COMPOSE A PLAINTEXT
  160.     ~~~~~~~~~~~~~~~~~~~
  161.     To write a message for encryption to someone, choose this option.
  162.     Assuming you have not deleted or moved your text editor, PGPShell
  163.     will bring up your text editor for use.  By default it names your
  164.     message "MESSAGE.TXT" but it is likely you will want to save it by
  165.     another file name.
  166.  
  167.  
  168.     VIEW A PLAINTEXT
  169.     ~~~~~~~~~~~~~~~~
  170.     PGPShell contains a built-in viewer to allow you to read your
  171.     decrypted messages as long as they are less than 30K in size.  The
  172.     reason for this is that bugaboo called 'memory.'  PGP is a memory hog
  173.     (needs at least 300K of conventional mem) and PGPShell is another 
  174.     memory hog with its new GUI facelift.  I'm not sure just how large a 
  175.     text file you can cram in there, but 30K seemed a nifty ceiling.  
  176.     
  177.     Besides if you sent a love letter that was over 30K, you'd bore him or 
  178.     her to tears and they'd never speak to you again.
  179.  
  180.  
  181.     ENCRYPT A PREVIOUSLY WRITTEN PLAINTEXT
  182.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  183.     There are five options in an Encryption Dialogue box for you to choose
  184.     from when encrypting a plaintext file.  I'll list them and the PGP 
  185.     argument in parenthesis after:
  186.  
  187.         1) Radix-64 ASCII e-mail format                  (-a)
  188.         2) Sign the plaintext with your secret key       (-s)
  189.         3) Wipe or "shred" the original after encrytion  (-w)
  190.         4) Convert plaintext to canonical text           (-t)
  191.         5) Force recipient to view "on-screen" only      (-m)
  192.  
  193.     Consult the PGP documentation for more details on what these parameters
  194.     are used for when encrypting plaintexts from within the P