home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / gigop806.zip / FIXMAP.DOC < prev    next >
Text File  |  1994-07-05  |  3KB  |  72 lines
  1. FIXMAP -
  2.  
  3.   Small kludge (with full source) to take an areafix message (in the
  4.   form of a GIGO function request), and update the mapping.cfg file
  5.   noting the addition or deletion of the new areas.
  6.  
  7.   If you are not using an Areafix-type program on your fidonet
  8.   software, this program will make no sense for you.
  9.  
  10.   Note, that there is no standard for forwarding requests to the usenet
  11.   host; this is implementation-defined for each site.  If you want that
  12.   ability, you're going to hack it out yourself :-)  Over here, I use
  13.   Harvey's Robot and a 4dos batch file to generate the netmail, that
  14.   contains the message formated as my particular host wants it.
  15.  
  16. HOW IT WORKS
  17.  
  18.   You need to set up two additional configuration entries in your
  19.   GATEWAY.CFG file.
  20.  
  21.     MAPFU area-fix@<yoursitehere> Areafix
  22.     USER  area-fix  FUNCTION  fixmap.exe mapping.cfg
  23.  
  24.   When GIGO gets a message to "Areafix", it will subsitute the email
  25.   address given (be sure to subsitute your site address!).  GIGO will
  26.   then be able to recognize that there is a USER definition for that
  27.   email address, and act on it.
  28.  
  29.   GIGO will generate FUNCTION.REQ, a simple text file.  At the top of
  30.   that text file will be two lines ("Apparently-To:  ..." and
  31.   "Apparently-From: ...").  Following those two lines, the entire email
  32.   message is written to disk, with all headers.  It will be up to the
  33.   external program if it wants to understand any of them.
  34.  
  35.   FIXMAP.EXE will then run, skipping over the headers.  When it comes
  36.   to the actual message body, it scans it for additions and
  37.   subtructions to the echos (newsgroups).  This message is expected to
  38.   be written by an areafix-type program and using the areafix-type
  39.   style.  (If you don't know what this is, then this actual program
  40.   will mean nothing to you).  FIXMAP will write the new additions at
  41.   the top, and write the remaining mapfile out to disk.  Any 
  42.   subtractions made by FIXMAP will be shown at the bottom of the file 
  43.   (most recent at the end, instead of the top), and will be commented 
  44.   out.
  45.  
  46.   Note that FIXMAP will ONLY modify "= newsgroupname NEWSGROUP" lines; 
  47.   if there are changes to the line, they will not be modified at 
  48.   all by fixmap. 
  49.  
  50.   Upon the return to GIGO, GIGO will check to see if FUNCTION.REQ was
  51.   made.  This program does not make one; therefore GIGO will not send
  52.   back a message.
  53.  
  54.  
  55. ABOUT THE SOURCE:
  56.  
  57.   The source code is written in Spagetti-C (tm), and is a whole
  58.   whopping 7k big.  If you take out the comments, maybe a grand total
  59.   of 4k...  It compiled fine under Borland 3.1 (16 bit) with the
  60.   large memory model for me.  I'm not using anything fancy, this
  61.   is a quick-n-dirty program.
  62.  
  63.   The source should be able to provide you with a shell for other
  64.   function requests.  A more suitable program may be the LISTSERV
  65.   program that was also written to take advantage of GIGO's function
  66.   requests.
  67.  
  68.   This program and source code is Copyright 1994 by Jason Fesler.  All
  69.   rights reserved.  Use of this code is granted to the Public Domain.
  70.  
  71.   jfesler@wmeonlin.sacbbx.com
  72.