home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / INTERNET / GIGO0209.ZIP / FIXMAP.ZIP / FIXMAP.DOC < prev    next >
Text File  |  1993-12-20  |  3KB  |  71 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.
  42.  
  43.   Note that FIXMAP will ONLY modify "+ newsgroupname" lines; if there
  44.   are any extra parameters, or you are using different commands other
  45.   than the "+" command in your mapping, this program will ignore them.
  46.  
  47.   Upon the return to GIGO, GIGO will check to see if FUNCTION.REQ was
  48.   made.  This program does not make one; therefore GIGO will not send
  49.   back a message.
  50.  
  51.  
  52. ABOUT THE SOURCE:
  53.  
  54.   The source code is written in Spagetti-C (tm), and is a whole
  55.   whopping 7k big.  If you take out the comments, maybe a grand total 
  56.   of 4k...  It compiled fine under Borland 3.1 (16 bit) with the 
  57.   large memory model for me.  I'm not using anything fancy, this 
  58.   is a quick-n-dirty program.
  59.  
  60.   The source should be able to provide you with a shell for other
  61.   function requests.  A more suitable program may be the LISTSERV
  62.   program that was also written to take advantage of GIGO's function
  63.   requests.
  64.  
  65.  
  66.   This program and source code is Copyright 1993 by Jason Fesler.  All
  67.   rights reserved.  Use of this code is granted to the Public Domain.
  68.  
  69.  
  70.   jfesler@wmeonlin.sacbbx.com
  71.