home *** CD-ROM | disk | FTP | other *** search
/ ftp.uni-stuttgart.de/pub/systems/acorn/ / Acorn.tar / Acorn / riscos / crypto / PGPwimp.spk / !PGPwimp / !Help < prev    next >
Text File  |  1993-04-07  |  7KB  |  186 lines
  1.  
  2.                              ============
  3.                                PGP wimp
  4.                              Version 0.12
  5.                              ============
  6.                          ⌐ Peter Gaunt, 1993
  7.  
  8.                      ----------------------------
  9.     This application is in the Public Domain and may be freely
  10.     distributed provided
  11.  
  12.       a) no charge is made other than to cover the cost of the medium
  13.       b) all files, including this !Help file, are included
  14.  
  15.     If you run a Public Domain software library please obtain my permission
  16.     before including this program in your lists or distributing it.
  17.  
  18.                 Copyright remains with me at all times.
  19.                      ----------------------------
  20.  
  21. This application provides a wimp front end to the PGP program converted for
  22. the Archimedes by Chris Gransden. Access is provided to what are probably
  23. the most commonly used aspects of the program. Commands which cannot be
  24. explicitly set up by the program can also be entered.
  25.  
  26. Once PGP issues a command PGP will run it in either a command window or in
  27. a task window (you decide which). Until someone converts PGP for the
  28. wimp properly then this sort of program will have to suffice...
  29.  
  30. PGPwimp has been tested with PGP version 2.2 (Archimedes version 1.12).
  31. All options should also work with PGP 2.1 (Archimedes version 1.02a) with
  32. the possible exception of the "text" output option for signing files which
  33. has only been tested with PGP 2.2
  34.  
  35.     **** This program can only be run under RISC OS 3.10 or later. ****
  36.  
  37.  
  38. Setting up the computer
  39. =======================
  40.  
  41. Before the program can be used the following situation must apply -
  42.  
  43.   (i)  the original !PGP application must have been "seen" by the wimp
  44.  
  45.   (ii) the PGP file from within !PGP must be either somewhere on the
  46.        computer's Run$Path, in the current library or in the current
  47.        directory. This is so that !PGPwimp can run PGP simply by issuing
  48.        a *PGP <command> command. !PGPwimp will not attempt to run PGP from
  49.        directly within !PGP (unless that happens to be on Run$Path.
  50.  
  51. On my own machine I have !PGPwimp stored in the same directory as !PGP so
  52. that both are "seen" at the same time. The PGP file has been moved from
  53. within !PGP to a directory called Utils within !System (this is apparently
  54. very naughty) which is where I store all files I need to be able to access
  55. with *-commands. My Run$Path is set up in !System's !Boot file with the
  56. line "SETMACRO Run$Path ,%.,<System$Path>Utils.,<System$Path>Modules."
  57.  
  58. This documentation is a quick scribble (sorry!) and assumes that you already
  59. know the sort of thing which PGP does and the precautions you should use. Read
  60. the PGP docs!!
  61.  
  62. Using PGP wimp
  63. ==============
  64.  
  65. Running !PGPwimp opens a window containing a number of buttons.
  66.  
  67. All commands are issued to PGP wimp via an intermediate file containing
  68. a PGP command. This is store within !PGPwimp and deleted when it's finished
  69. with.
  70.  
  71. The command can be run either within a command window or withing a task
  72. window. Running in a command window is quicker but doesn't multitask and
  73. sometimes text scrolls off the top before it can be read. Which one to use
  74. can be set via the "Task" option button at the top right of the window.
  75.  
  76. We'll deal with the window first.
  77.  
  78. Dropping a file into the window enters its leaf name into the "file" icon.
  79.  
  80. The "Action" icon determines what will be done with the file. Click the arrow
  81. icon next to the Action icon to open a small menu of options -
  82.  
  83. "Encrypt" - the file will be encrypted. The other options in the window
  84. determine the recipient's user ID (as stored in your public key file), whether
  85. the file will be signed, whether it will be signed with one of your secret
  86. keys, whether it will be converted into an "ASCII Armour" file and its file
  87. name.
  88.  
  89. "Decrypt" - the program will ask PGP to attempt to decrypt the file.
  90.  
  91. "Sign" - allows you to sign an existing file. You can choose whether the
  92. output file will be binary, an "ASCII Armour" file or a "Text file". If
  93. "Text file" is selected then the output file will be unchanged except for
  94. the addition of the signature and a header provided the input file is pure
  95. text. If the input file is not pure text when "Text file" is selected then
  96. PGP notices this and saves an ASCII Armour file instead.
  97.  
  98. "Armour" - allows you to convert an existing file to ASCII Armour format.
  99. Note that if you wish to both sign an existing file and convert it to ASCII
  100. Armour format you should choose the "Sign" option and set the output file
  101. type to "Armour"
  102.  
  103. "Add keys" - asks PGP to add any keys contained in the file to your keyring.
  104.  
  105. Menu options
  106. ============
  107.  
  108. Click "menu" anywhere over the window to open the menu.
  109.  
  110. File action
  111. -----------
  112. This option leads to a menu which simply duplicates the menu available via
  113. the arrow icon next to the Action icon.
  114.  
  115.  
  116. Edit
  117. ----
  118. Edit key    - type the name of the key you want to edit into the writeable icon.
  119.               This option is useful both for editing your own keys and the trust
  120.               parameters of the keys in your public keyring.
  121.  
  122. Remove key  - type the name of the key you want to delete into the writeable
  123.               icon.
  124.  
  125. Certify key - Use this option to certify one of the keys on your public key
  126.               ring. Type the name of the key you want to certify into the
  127.               User ID icon. If you want to certify the key with anything
  128.               other than your default signature, select the radio button next
  129.               to the writeable icon in the Signature box and type in the
  130.               signature name.
  131.  
  132. Make key    - Allows you to generate a new key.
  133.  
  134.  
  135. View
  136. ----
  137. View key    - Type the name of the key you want to look at into the box
  138.  
  139. View all keys-Lists all the keys on your keyring
  140.  
  141. Fingerprint - To look at a key's fingerprint, type the ID into the box
  142.  
  143. All fingerprints - List the fingerprints of all the keys on your keyring
  144.  
  145.  
  146. Extract
  147. -------
  148. Allows you to extract a key as either a binary or ASCII Armour file, so that
  149. it can be given to someone else. Type the Key ID into the Key ID box and a file
  150. name into the filename box.
  151.  
  152.  
  153. Command
  154. -------
  155. Allows you to issue any PGP command not available elsewhere in the program.
  156. Type the command into the box. There is no need to start the command with
  157. "PGP" (though it doesn't matter if you do).
  158.  
  159.  
  160. Help
  161. ----
  162. Runs PGP's "Help" file listing all the commands.
  163.  
  164.  
  165.  
  166. The program can be set up so that it always defaults to either "command window"
  167. or "task window" mode. This is done by altering a parameter in the !Run file.
  168. The line which runs "!RunImage" can take a final parameter of "-Task" or
  169. "-Command". Like this ----
  170.  
  171. either
  172.   RUN <PGPFE$Dir>.!RunImage -Task
  173. or
  174.   RUN <PGPFE$Dir>.!RunImage -Command
  175.  
  176. If the parameter is missing then PGPwimp starts up in command window mode.
  177.  
  178.  
  179.  
  180. If you experience any problems with this application please feel free
  181. to contact me via email
  182.  
  183.                Prestel (014511332) Note - this is NOT my phone number!
  184.                Telecom Gold (84:MAG10849)
  185.                Arcade BBS (Tel. 081 654 2212, user #617)
  186.