home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / sqfm110.zip / sqfrom.doc < prev    next >
Text File  |  1996-07-15  |  5KB  |  167 lines
  1.           SqFrom 1.10 (c) Copyright 1995-1996 Alberto Pasquale
  2.  
  3.                             F R E E W A R E
  4.         
  5.                                 LICENSE
  6.  
  7.     You may copy, distribute and use this program freely, provided you
  8.     do not modify the original archive and Copyrights.
  9.         
  10.         
  11.                                DISCLAIMER
  12.         
  13.     You are entitled to use this freeware program "as is". No guarantee
  14.     can be given on the performance of the program. The author will not
  15.     be liable for any damage or loss related to the use of this program.
  16.         
  17.         
  18.                                 OVERVIEW
  19.  
  20.  
  21.     This program allows to change the "from address" in outgoing PKTs
  22.     and contained echomail messages.
  23.  
  24.     This is to solve a problem that fidonet(*) coordinators have with
  25.     Squish (**).
  26.  
  27.     Coordinators frequently have to deal with their uplinks using the
  28.     administrative address while they usually would like to continue
  29.     using their primary address with pre-existing links.
  30.  
  31.     Squish does not allow to use different "from addresses" in the same
  32.     echo area depending on the destination address.
  33.  
  34.     SqFrom allows to change the "from address" of an outbound packet,
  35.     both in its header and in the headers of all echomail messages it
  36.     contains (obviously netmail and routed echomail messages are
  37.     skipped).
  38.  
  39.     You can use SqFrom on the .?ut files in Squish's temporary outbound
  40.     (usually "<path>\<domain>.sq") before they are packed for the
  41.     destination.
  42.  
  43.     For that purpose you can use the "DOS" command in Squish's
  44.     Route.cfg.
  45.  
  46.  
  47.     Command line:
  48.  
  49.     SqFrom [-l<log>] [-o<out.sq>] <from-adr> <to-adr-list>
  50.  
  51.     <log> is an optional log filename; overrides the "StatusLog" cfg
  52.             statement.
  53.  
  54.     Please note that SqFrom _cannot_ share the same log file with
  55.     Squish, since it does not close it when shelling to DOS commands.
  56.  
  57.     <out.sq> is the temporary outbound directory where SqFrom must look
  58.             for .?ut files to be modified; overrides the "OutSq" cfg
  59.             statement.
  60.  
  61.     <from-adr> is a fully specified 4D address.
  62.  
  63.     <to-adr-list> is a list of (possibly abbreviated) addresses, just as in
  64.             Squish's route.cfg (Including support for "World" and "All"
  65.             wildcards).
  66.  
  67.  
  68.     The configuration file:
  69.  
  70.     SqFrom can be used without a configuration file, provided the "-o"
  71.     switch is used on the command line.
  72.  
  73.     For convenience, you can specify <out.sq> and possibly <log> in a
  74.     configuration file, which must be named SqFrom.Cfg and reside in the
  75.     current directory.
  76.  
  77.     The available cfg statements are:
  78.  
  79.     OutSq <out.sq>
  80.     StatusLog <log>
  81.  
  82.  
  83.     Operation:
  84.  
  85.     All packets addressed to an address matching <to-adr-list> will be
  86.     modified so that they seem to come from <from-adr>.
  87.  
  88.     If an address is specified with no point or ".0", all packets
  89.     addressed to its points are processed too, just as Squish does.
  90.  
  91.  
  92.     Example:
  93.  
  94.     Let's suppose you are (order is meaningful):
  95.  
  96.     Address 2:332/504  ; FidoNet Node
  97.     Address 2:332/500  ; FidoNet Hub
  98.     Address 81:439/501 ; OS2Net  Node
  99.  
  100.     and you are required to use the Hub aka for Hub task.
  101.  
  102.     An example of Route.Cfg for Squish follows:
  103.  
  104.     ===========================================================
  105.  
  106.     DEFINE FidoNet   1:All 2:All 3:All 4:All 5:All 6:All
  107.     DEFINE BackBone  2:332/2
  108.     DEFINE Downlinks 2:442/617 2454/169 2490/3045 3:633/260
  109.     DEFINE Down500   2:332/502 507 510 521
  110.     DEFINE Points    2:332/504.All 81:439/501.All
  111.  
  112.     DEFINE OS2Net    81:All
  113.     DEFINE OS2Downs  81:439/503 504
  114.     DEFINE OS2BBone  81:439/1
  115.  
  116.  
  117.     SCHED NRM
  118.  
  119.         SEND   hold   Points Downlinks
  120.  
  121.         DOS    sqfrom 2:332/500 FidoNet
  122.         SEND   hold   Down500
  123.         ROUTE  direct BackBone FidoNet
  124.         DOS    sqfrom 2:332/504 FidoNet
  125.  
  126.         SEND   hold   OS2Downs
  127.         ROUTE  direct OS2BBone OS2Net
  128.  
  129.         SEND   hold   World
  130.  
  131.     ===========================================================
  132.  
  133.     Notes:
  134.  
  135.     - It is advisable to always change not only pkts directly addressed
  136.       to nodes that require your aka, but also those that will be routed
  137.       via them; otherwise netmail pkts may be sent with the wrong
  138.       address in their header.
  139.  
  140.     - It is advisable to change back to the original addresses before
  141.       the SCHED terminates; otherwise some pkts that have been left in
  142.       the temporary outbound due to .BSY files may end up with a wrong
  143.       address.
  144.  
  145.  
  146.     How to contact the author:
  147.  
  148.     Alberto Pasquale
  149.     Viale Verdi 106
  150.     41100 Modena
  151.     Italy
  152.  
  153.     alberto.pasquale@mo.nettuno.it (might change after 1/1/1997)
  154.  
  155.     2:332/504@fidonet 2:332/524@fidonet
  156.     81:439/501@OS2Net 81:439/502@OS2Net
  157.     +39-59-246112/3 V34, ISDN X75
  158.     +39-59-246113 FAX
  159.  
  160.  
  161.     Credits
  162.  
  163.     * Fidonet and Fido are registered marks of Tom Jennings and Fido
  164.       Software
  165.  
  166.     ** Squish is a trademark of Lanius Corporation
  167.