home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / email / gmsg306.zip / GENMSG.DOC < prev    next >
Text File  |  1993-08-16  |  11KB  |  225 lines
  1.                           GenMsg Copyright (c) 1992
  2.                                  G. K. Pace
  3.                                 Version 3.06
  4.                               August  16, 1993
  5.  
  6.  DESCRIPTION:
  7.      GenMsg is a FidoNet compatable message  viewer/editing system  designed 
  8.  for systems using the *.msg format  of message  storage.  It  is a  "shell" 
  9.  type system. There isn't a text-editor  built in,  you use  GenMsg to  call 
  10.  your favorite Ascii Text editor (I use VDE a very good editor) to edit  the 
  11.  text - GenMsg then formats it  to FidoNet  specifications for  the type  of 
  12.  message it is.  GenMsg can also  shell to  other utilities...   Pretty Good 
  13.  Privacy (PGP) a "free-ware" Public Key encryption system  can be  called by 
  14.  GenMsg for  decoding encrypted  messages, and  for encrypting,  signing, or 
  15.  clear-text signing of messages, and List a popular file viewing utility can 
  16.  be called to view the message text and toggled to HEX mode etc...
  17.  
  18.      GenMsg  was  the  first  FidoNet message  editor available  which would 
  19.  interface PGP  to Fidonet  messages.  Today  it is  the most  up-to-date of 
  20.  those which have come since... <grin>
  21.  
  22.  FEATURES:
  23.      GenMsg supports the D'Bridge mailer, and  can be  setup to  replace the 
  24.  Internal Editor, or as an alternet Editor to be used as needed.
  25.  
  26.      GenMsg  supports  the SecureMail  principal, and  can be  configured to 
  27.  refuse to show the  contents of  in-transit messages...   for you  "snoopy" 
  28.  types, you can disable this and view anything on your system... <grin>
  29.  
  30.      GenMsg  supports  the  use  of  Pretty  Good Privacy  (PGP) for  use in 
  31.  handling  encrypted,  ascii-armor,  and  clear-text  signatures  in FidoNet 
  32.  messages.
  33.  
  34.      GenMsg is designed to utilize the Ascii-text editor of your  choice, so 
  35.  that the editing commands can be as you prefer.  I  suggest use  of VDE,  a 
  36.  fully configurable editor which is very one of the best I've seen  for this 
  37.  purpose!
  38.  
  39.      GenMsg can handle messages of upto 64K in length.
  40.  
  41.      GenMsg provides  full INTL  and POINT  addressing.  Default  addressing 
  42.  style allows shortcuts in address entry.
  43.  
  44.      GenMsg  provides  for  a  Configurable  "default"  ORIGIN line,  and/or 
  45.  configure each area differently thru use  of a  file named  ORIGIN in  each 
  46.  directory.
  47.  
  48.      GenMsg supports the use of UTC message dating.
  49.  
  50.      GenMsg provides "Auto Formatting" of messages destined to  the Internet 
  51.  via a gate-way.
  52.  
  53.  SETUP:
  54.      GenMsg requires that you  have a  GenMsg.Ini file  and a  Message-Areas 
  55.  list file. You will also have to have  a Text  Editor which  can be  called 
  56.  from GenMsg,  and for  the encryption  features you  will need  Pretty Good 
  57.  Privacy (PGP).
  58.  
  59.      GenMsg.ini:
  60.      The  configuration  file  GENMSG.INI  must  be  in  the  same directory 
  61.  GENMSG.EXE  is  in.   If  you rename  GENMSG.EXE, you  will have  to rename 
  62.  GENMSG.INI  to  match.   (example:  if GENMSG.EXE  is renamed  to GMSG.EXE, 
  63.  GENMSG.INI must be renamed GMSG.INI)
  64.  
  65.      GENMSG.INI must contain setup  information specifying  your name,  INTL 
  66.  address, the  Ascii-text Editor  to call,  and the  directory path  to your 
  67.  NetMail.  There are many other optional  parameters that  can or  should be 
  68.  set  for  your  apprication.   Refer  to  the  accompanying  GENMSG.INI for 
  69.  information on how to configure GenMsg.
  70.  
  71.  
  72.      Message Areas List:
  73.      Unless you are only going to use GenMsg for your NETMAIL, you will need 
  74.  to have a list of other message areas  GenMsg can  access.  GenMsg  can use 
  75.  the "standard" AREAS.BBS, or  can be  configured to  use another  list that 
  76.  you've created.   Since the  standard AREAS.BBS  does not  normally include 
  77.  LOCAL message areas, the method of having a separate list for GenMsg to use 
  78.  is generally prefered.  The name of such file can be any legal DOS name and 
  79.  must be specified in GENMSG.INI.
  80.  
  81.      The  format  of  this  list  is  explained  more  fully  in   the  file 
  82.  MSGAREAS.BBS which has been included as an example  of how  to create  this 
  83.  list.
  84.  
  85.  
  86.      ENVIRONMENT:
  87.      GenMsg calculates the UTC date and time based  upon your  system clock, 
  88.  and expects to find the environment variable TZ  to be  set indicating  the 
  89.  time shift between your local time, and Greenwich  Mean time.   To set  the 
  90.  variable use the DOS command Set in your Autoexec.bat file as:
  91.  
  92.  SET TZ=EST5      (Eastern Standard time)
  93.  SET TZ=EST5EDT   (Eastern Daylight savings time)
  94.  
  95.      The first three alpha  characters should  be the  abreviation for  your 
  96.  standard time zone. the (next) single digit should be the  offset in  hours 
  97.  from Greenwich  Mean time  for your  standard time  zone.
  98.      When Daylight  Saving time  is active,  you should  add the  last three 
  99.  alpha characters, which automatically compensate for daylight savings  when 
  100.  calculating UTC...
  101.  
  102.  
  103.      You SHOULD also have the PGP environment variable  PGPPATH=pgpstuff set 
  104.  for PGP to act properly.  Refer to the PGP Docs for this information!
  105.  
  106.  
  107.      SETUP of PGP PASS-PHRASE:
  108.      GenMsg  provides for the  installation of  your pass-phrase  to enhance 
  109.  the ease of use of PGP.  When installed, GenMsg secures the pass-phrase  in 
  110.  an encrypted form inside of the GenMsg.EXE file.  It will then decrypt  it, 
  111.  and  pass  it to  PGP when  ever it  calls PGP,  upon return  from PGP  the 
  112.  decrypted pass-phrase is  distroyed.  GenMsg  will only  accept your  pass- 
  113.  phrase for  storage if  it can  obtain the  required information  from your 
  114.  system that it needs to store it in a secure manner. Not  all systems  will 
  115.  have  the  required information  available -  thus this  option may  not be 
  116.  available to all Users of GenMsg.
  117.  
  118.      Once  the  pass-phrase  is  installed  GenMsg  will  check  the  system 
  119.  information each time it is envoked, if it doesn't match the information it 
  120.  has  stored,  it will  immediatly distroy  the copy  of the  pass-phrase it 
  121.  contains to keep it secure.  GenMsg will distroy the stored  pass-phrase if 
  122.  the GenMsg.EXE is copied  to another  Disk and  envoked, or  if envoked  on 
  123.  another system.
  124.  
  125.      To  install  your  pass-phrase  envoke  GenMsg  with  the  command-line 
  126.  argument "SET" (i/e GenMsg SET). GenMsg will ask  you for  your pass-phrase 
  127.  and if it can obtain all  of the  system information  it requires,  it will 
  128.  store the pass-phrase.  If you do not enter anything when prompted to enter 
  129.  your  pass-phrase,  GenMsg  will  delete  any  pass-phrase  it  might  have 
  130.  previously contained.  (a useful  way to  insure that  your pass-phrase  is 
  131.  erased from any copies of GenMsg  you may  copy for  a friend)  Once setup, 
  132.  GenMsg will keep the pass-phrase for use until you change  it, or  any part 
  133.  of the system information it monitors changes causing GenMsg to distroy the 
  134.  pass-phrase.
  135.  
  136.  
  137.  
  138.      ORIGIN:
  139.      GenMsg will use the string you setup in  GENMSG.INI as  the ORIGIN  for 
  140.  messages you create (NOT NetMail messages) unless it finds a file named 
  141.  ORIGIN in the message directory.  This feature provides the ability for you 
  142.  to customize the origin line you use for each Echo message area.   The file 
  143.  ORIGIN is an Ascii-Text file with  one string  in it.   The string  will be 
  144.  trunicated if it is too long... Origin lines must not exceed 79 characters.
  145.  
  146.      D'Bridge:
  147.      GenMsg can fit in with D'Bridge nicely.  To  use it  with D'Bridge  you 
  148.  must enable  D'Bridge mode  in your  GENMSG.INI, and  have the  ENVIRONMENT 
  149.  variable of DB=path_to_DBridge or DBRIDGE=path_to_DBridge set.
  150.  
  151.      GenMsg can function as a replacement for the D'Bridge Internal  Editor.  
  152.  Refer  to  the  accompanying  DBRIDGE.TXT  file  for  further   information 
  153.  concerning setup.
  154.  
  155.  
  156.  
  157.      PGP USE:
  158.      GenMsg (if setup to emplement this feature) will call PGP to Encrypt, 
  159. Ascii-Armor Sign, Clear-Text Sign, or Decrypt a message.  Assuming you Have 
  160. PGP setup properly, and enabled in GenMsg...
  161.  
  162.      Decode Function:
  163.      This function will call PGP to decode the message-text of the message 
  164. you are viewing.  If the text contains a Public Key, PGP will process it, 
  165. and allow you to add it to your Key-Ring.  If the text contains a Signed 
  166. Public Key (some people do this??? !!!) The first Decode Function will 
  167. remove the Clear-Text Signature, envoking the Decode Function again will 
  168. allow PGP access to the Public Key...
  169.  
  170.      Note that when decoding a signed message, PGP will alert you if it 
  171. fails the verification process... other-wise the message will just be 
  172. stripped of the signature.
  173.  
  174.      Encrypt Function:
  175.      PGP provides for the ability to encrypt for multiple recipients... 
  176. GenMsg uses this ability to allow you the ability to Decode a message you've 
  177. encrypted to someone else, by encrypting it for the designated person(s) AND 
  178. you.
  179.      When GenMsg passes the "encrypt-to" name to PGP, it is enclosed in 
  180. quotation marks (" ").  If you wish to encrypt for multiple recipients, you 
  181. MUST enter their names (when GenMsg asks for this info) in this manner:
  182.  
  183. first name","second name","third name","etc...
  184.  
  185.      NOTE that the begining and ending quotation marks are NOT added!  This 
  186. string cannot exceed 256 charaters in length.
  187.  
  188.      Signing Messages:
  189.      GenMsg can call PGP to sign a message in one of two modes: Clear-Text 
  190. Mode, and Ascii-Armor Mode.
  191.  
  192.      Clear-Text mode is the most used, as the text of the message can be 
  193. read without the use of PGP.  Calling PGP to Decode a Clear-Text message is 
  194. done to VERIFY that the message-text has not been altered, and was signed by 
  195. the person who owns the Public Key used for verification.
  196.  
  197.      Ascii-Armor signatures appear to be encrypted, and cannot be read 
  198. without proccessing them with PGP.  Altho they appear to be encrypted, they 
  199. are not... anyone using PGP can process it for viewing, the Decode function 
  200. verifies that the text has not been altered, and that it was signed by the 
  201. person owning the Public Key used for verification.
  202.  
  203.  
  204.  
  205.      PLEASE NOTICE THIS!
  206.  
  207.       GenMsg would not be what it is, were it not for the input recieved  by 
  208.  those  who   are  thoughtful   enough  to   provide  suggestions   for  its 
  209.  improvement...  I appreciate ALL who have assisted in this manner.
  210.  
  211.       Special thanks are due to those who not only provided suggestions, but 
  212.  incentive, encouragement, and other  types of  assistance... without  which 
  213.  GenMsg would have stopped progressing long  ago. (I  personally don't  mind 
  214.  programs without  "glit 'an  glitter" features...  ) Those  who have  had a 
  215.  significant impact upon GenMsg include:
  216.  
  217.      - Christopher Baker at 1:374/14
  218.      - Barry Kapke at 1:125/33
  219.  
  220.       And last  but not  least, Tom  Jennings... without  whom none  of this 
  221.  would have ever been necessary...
  222.  
  223.                                      -gk
  224.  
  225.