home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / wizfix.lha / WiZFix.doc < prev   
Text File  |  1993-07-05  |  41KB  |  1,019 lines

  1.  
  2.      Page 1             WiZFix's Fantastic Manual              Page 1
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                  WiZFix
  21.                      A TrapToss specific AreaManager
  22.                               Version 1.00
  23.                            Copyright (c) 1993
  24.                                Andy Wilson
  25.                            All rights reserved
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                   This manual is intended to be read from
  33.                   front to back but you already knew that.
  34.  
  35.  
  36.      Page 2             WiZFix's Fantastic Manual              Page 2
  37.  
  38.  
  39. 1. Introduction
  40.  
  41.         This manual describes the function, installation,
  42.       configuration and operation of WiZFix, a new mail topology
  43.       management programme written specifically for TrapToss.
  44.  
  45.         Please read the manual before installing WiZFix lest great
  46.       harm may fall upon your TrapToss configuration file.
  47.  
  48.  
  49. 2. Overview
  50.  
  51.         WiZFix is a CLI based application only, which is why it comes
  52.       without a fancy icon.  The final release of WiZFix will accept
  53.       a range of CLI arguments which will be designed to allow easy
  54.       configuration during runtime.
  55.  
  56.         WiZFix is a utility which allows nodes and points connected
  57.       to your system and who communicate via messages processed by
  58.       TrapToss, to automatically link in or out of message areas
  59.       according to SysOp defined security and access barriers.  The
  60.       main advantage of WiZFix is that changes in the topology of
  61.       calling node/points can be made without the SysOp having to
  62.       do anything.
  63.  
  64.         WiZFix not only supports the global configuration file (GCF),
  65.       hereinafter referred to as 'Fido.Cfg', as supported by TrapToss
  66.       and TrapList (and perhaps one day TrapDoor?), it actually
  67.       requires it in order to function.  This therefore does away with
  68.       the normal convention of having to re-enter your node, aka, mail
  69.       directories etc..  WiZFix will not work unless your TrapToss
  70.       and TrapList data are in the MAIL: assigned directory and stored
  71.       under the file name of Fido.Cfg.  Please refer to the software
  72.       manuals for TrapToss and TrapList if you need to convert your
  73.       current configuration files.
  74.  
  75.         Please note that no keywords are case sensitive, but some of
  76.       them are position dependant.  Additionally, at this time WiZFix
  77.       does not fully support the strict GCF specifications in that all
  78.       configuration statements and parameters must be contained on a
  79.       single line (no continuing to the next line by adding a trailing
  80.       '\').
  81.  
  82.         Finally, by the very nature of WiZFix, this programme not
  83.       only reads data from the normally private TrapToss and TrapList
  84.       sections of the GCF, it actually modifies the export lines of
  85.       the AREA statements within the TrapToss section.
  86.  
  87.  
  88.      Page 3             WiZFix's Fantastic Manual              Page 3
  89.  
  90.  
  91. 3. Installation
  92.  
  93.         In order to install WiZFix, you must have the following minimum
  94.       files as listed below:
  95.  
  96.         WiZFix         -       executable file
  97.         WiZFix.doc     -       so you know what to do!
  98.         AF.cfg         -       example configuration file (SEE BELOW)
  99.         MAIL:          -       logical assignment to your mail base
  100.         MAIL:Fido.Cfg  -       GCF file as described by TrapToss et al.
  101.  
  102.         Additional files will also most likely be required, such as:
  103.      
  104.         AreaFix.hlp     -       Help file for your users
  105.         Hub.txt         -       List of your Hub's echoes
  106.         Host.txt        -       Formatted list of your echoes etc.
  107.  
  108.         Copy the executable 'WiZFix' to a directory in your normal
  109.       path (MAIL:Bin/ is a good place, and is also the assumed
  110.       directory).
  111.  
  112.         Edit your 'MAIL:Fido.Cfg' file and append (paste) the file
  113.       AF.Cfg (which file is included in the distribution archive). 
  114.       Now save your updated MAIL:Fido.Cfg file.
  115.  
  116.         Now you have just one change to make: if you are a node, you
  117.       must alter any/all of your AKA addresses that you have listed in
  118.       your Fido.Cfg so that they do NOT show a point. e.g. my address
  119.       is 2:255/171 and NOT 2:255/171.0 which is how some people
  120.       incorrectly write there address Ditto 39:136/1 and NOT
  121.       39:136/1.0
  122.  
  123.         (I only make you do this (a) because I'm an annoying sort of
  124.       person, and (b) in the hope that others may learn as I myself
  125.       have..:-)
  126.  
  127.         The installation is complete.
  128.  
  129.  
  130. 4. Configuration
  131.  
  132.         WiZFix is designed to work in harmony with TrapToss, and to
  133.       try to take advantage of some of the features of TrapToss which
  134.       might not be considered by other inferior packages.  WiZFix can
  135.       be configured using a series of keywords which are stored in the
  136.       private AreaFix section of the MAIL:Fido.Cfg file.
  137.  
  138.         The WiZFix private section is preceeded with a '[AreaFix]'
  139.       statement, in the same way that the TrapToss section is defined
  140.       using a '[TrapToss]' keyword etc., refer to your TrapToss
  141.       manual for further information.
  142.     
  143.         Please note that the keywords and/or there parameters are NOT
  144.       case sensitive, but that most of them look nicer when the
  145.       keyword is in upper case.  It's your choice however.
  146.  
  147.      Page 4             WiZFix's Fantastic Manual              Page 4
  148.  
  149.  
  150.         Where possible, default values for the configuration keyword
  151.       parameters have been made for you (listed in parenthesis after
  152.       the keyword function description).
  153.  
  154.  
  155. 4.1  Configuration Keywords
  156.  
  157.  
  158. 4.1.1  LOGFILE
  159.  
  160.         This is where WiZFix logs its activity - you can quickly tell
  161.       who has linked into/outof what area by reading the logfile.
  162.  
  163.         Currently, the log file is flushed after each line entry, but
  164.       this may change in the future.
  165.  
  166.       (Default - LOGS:AreaFix.Log)
  167.  
  168.  
  169. 4.1.2  USETRAPLISTPW
  170.  
  171.         If this keyword is specified then WiZFix will use passwords
  172.       listed in the normally private TrapList section of the Fido.Cfg
  173.       area in order to security check incoming AreaFix requests.
  174.  
  175.         Many nodes (inc. myself) use the same password for both mail
  176.       and AreaFix sessions.  The use of this keyword enables you to do
  177.       the same without having to laboriously copy your Traplist listed
  178.       passwords into a seperate configuration file.
  179.  
  180.         To disable this feature, simply do not use the keyword.
  181.  
  182.       (Default - disabled)
  183.  
  184.  
  185. 4.1.3  PASSWORD
  186.  
  187.         This keyword is used to define the password to be used for
  188.       security checking incoming AreaFix requests.  The format of the
  189.       PASSWORD statement is as per the TrapList method. i.e.:-
  190.  
  191.       PASSWORD "mypvtpw"  2:255/171 39:136/1 39:136/0 2:2424/0
  192.  
  193.         The above would assign the password 'mypvtpw' to the nodes
  194.       2:255/171, 39:136/1, 39:136/0, and 2:2424/0.  There is no limit
  195.       on the number of nodes which can be stored on the one line, but
  196.       there is a limit to the length of each line in the Fido.Cfg
  197.       configuration file (currently 2k per line max.).
  198.  
  199.      Page 5             WiZFix's Fantastic Manual              Page 5
  200.  
  201.  
  202. 4.1.4  ALLOWCREATE
  203.  
  204.         Currently not implemented.
  205.  
  206.  
  207. 4.1.5  PREADCONFIG
  208.  
  209.         Currently not implemented.
  210.  
  211.  
  212. 4.1.6  HELPFILE
  213.  
  214.         This is the file sent to a calling node/point that's requested
  215.       an AreaFix session (using the '-h' switch - see later).  This
  216.       file would usually contain instructions on how to use WiZFix,
  217.       and what to expect from it.  You can edit this to suit your
  218.       needs.
  219.  
  220.  
  221. 4.1.7  ZONE
  222.  
  223.         It is often useful to be able to send certain data only to
  224.       certain nodes. e.g. if you run a multi-network setup, and a
  225.       point/node requests a list of areas then you might not wish to
  226.       send a list of all areas available on your system in case they
  227.       include areas from a different network.  Also, if you allow
  228.       requests to be FORWARDED (see later) then it may well be that
  229.       you wish to send an AreaFix message to one node for some mail
  230.       e.g. in 'fidonet', and another in say 'amiganet'.  
  231.  
  232.         WiZFix solves these difficulties by allowing you to send
  233.       certain files to calling nodes depending on their ZONE address,
  234.       and to forward AreaFix requests that can't be handled by your
  235.       system to the correct upstream node.
  236.  
  237.         The configuration parameters are:-
  238.  
  239.       ZONE    HOSTLIST   HUBLIST   HUBADDRESS   HUBPASSWORD
  240.  
  241.         Where:
  242.             ZONE        = calling sites ZONE address (e.g. '2' or '39')
  243.             HOSTLIST    = text file that can be sent to the requestor.
  244.                           (e.g. a formatted list of available areas
  245.                           available from you?)
  246.             HUBLIST     = text file e.g. of echoes available from your HUB.
  247.                           (This file can be sent to a user if they request
  248.                           an echo list using the '-f' flag.  It's also
  249.                           scanned for area TAGS to see if an AreaFix msg
  250.                           can be forwarded to your hub (see below)
  251.             HUBADDRESS  = full 4d address of your hub (e.g. 2:255/1)
  252.             HUBPASSWORD = YOUR AreaFix session password for your hub (used
  253.                           for the forwarding of AreaFix requests).
  254.  
  255.      Page 6             WiZFix's Fantastic Manual              Page 6
  256.  
  257.  
  258.       e.g.:-
  259.  
  260.       ZONE 2  MAIL:Fidonet.txt  MAIL:HubFido.txt   2:255/1 MAGIC
  261.       ZONE 39 MAIL:Amiganet.txt MAIL:HubAmiga.txt 39:138/1 MORE_MAGIC
  262.  
  263.         If a node with an address of 2:255/1234 (i.e. ZONE 2) calls
  264.       and requests a list of available areas using the '-f' keyword,
  265.       he will receive a standard AreaFix reply, plus a copy of the file
  266.       'MAIL:Fidonet.txt' and 'MAIL:HubFido.txt'. 
  267.  
  268.         Additionally, If a request to link into an area fails
  269.       because the area isn't listed, and you have allowed him to
  270.       forward requests (see (NO)ALLOWFORWARDING keyword descriptions)
  271.       then the file 'MAIL:HubFido.txt' will be searched in order to
  272.       find a matching TAG name.  If the TAG name is found, then
  273.       an AreaFix message will be sent to 2:255/1 using the AREAFIX
  274.       password of 'MAGIC' together with a request for a link
  275.       into the area of interest.  The area will then be created in
  276.       your Fido.Cfg ('passthrough' for you) and the requesting node
  277.       and Hub will be added to the export line.
  278.  
  279.         If the TAG name cannot be found in the 'Mail:HubFido.txt' file
  280.       then the request is NOT forwarded (saves your hub receiving
  281.       loads of messages with incorrectly spelt TAG names!).
  282.  
  283.         Similarly, a '-f' request from 39:123/456 would cause the lists
  284.       'MAIL:Amiganet.txt' and 'MAIL:HubAmiga.txt' to be sent, and
  285.       forwarded requests to be sent to 39:138/1 using the AreaFix
  286.       password 'MORE_MAGIC' (again, subject to a matching TAG name in
  287.       the file 'MAIL:Amiganet.txt').
  288.  
  289.         Each ZONE statement MUST have 5 parameters otherwise WiZFix
  290.       will complain.  Use the character '*' in place of the filenames
  291.       if you don't want to send any files (over and above the standard
  292.       reply) when a request for an ECHOLIST is received.
  293.  
  294.         Please note that if you use the '*' char in place of the name
  295.       for the HUBLIST then AreaFix requests cannot be forwarded to that
  296.       hub.
  297.  
  298.         The forwarding of AreaFix requests from nodes and/or points is
  299.       configurable (see below).
  300.  
  301.       (Default - no ZONE statements)
  302.  
  303.  
  304. 4.1.8  (NO)ALLOWFORWARDINGPOINTS
  305.  
  306.         Gosh, what a big keyword?  Perhaps I should make it smaller..
  307.  
  308.         This statement allows you to specify whether requests from
  309.       points can be forwarded to the appropriate hub in order to try
  310.       and obtain a message area that you currently do not carry.
  311.  
  312.       (Default - NOALLOWFORWARDINGPOINTS)
  313.  
  314.      Page 7             WiZFix's Fantastic Manual              Page 7
  315.  
  316.  
  317. 4.1.9  (NO)ALLOWFORWARDINGNODES
  318.  
  319.         The same thing as per (NO)ALLOWFORWARDINGPOINTS except that
  320.       this applies to nodes.
  321.  
  322.       (Default - NOALLOWFORWARDINGNODES)
  323.  
  324.  
  325. 4.1.10  DEFAULTLEVEL
  326.  
  327.         This is the first of several keywords which can be used to
  328.       control the security of your system by allowing certain
  329.       nodes/points to have increased or decreased access.
  330.  
  331.         The DEFAULTLEVEL is the access level assigned to any node or
  332.       point which has a PASSWORD PROTECTED AreaFix session with your
  333.       system (this will become a little clearer after reading the
  334.       (NO)SECURE keyword descriptor).
  335.  
  336.         It is recommended that this be given a reasonably high value,
  337.       say 100.  Any number from 0 to (2^32-1) can be used.
  338.  
  339.       (Default - 100)
  340.  
  341.  
  342. 4.1.11  LEVEL
  343.  
  344.         This is the second access level keyword.  You can use this to
  345.       increase or decrease the access level of specified nodes/points.
  346.       The keyword takes the form: 'LEVEL FQFA  <level>  [Q] (or [-])'
  347.       e.g.:
  348.  
  349.       LEVEL 39:138/1          65535 [-]   ;High level access for him.
  350.       LEVEL 2:255/171.33      500   [Q]   ;Increased access for him.
  351.       LEVEL 2:255/171.172     005   [Q]   ;Decreased for this twit.
  352.       LEVEL 2:123/456.789     000   [-]   ;I don't like him - BANNED!
  353.       LEVEL 2:250/320         500   [Q]   ;etc.
  354.  
  355.         The '[Q]' or '[-]' allows you to send (not send) a QUERY list
  356.       of areas to which the node/point is attached by using the CLI
  357.       argument ECHOLIST.
  358.  
  359.      Page 8             WiZFix's Fantastic Manual              Page 8
  360.  
  361.       
  362.         The above assigns a high access level to 39:138/1 but will not
  363.       send him an echolist unless he requests one (using the '-l'
  364.       option on the subject line of an AreaFix msg - see Chapter 5). 
  365.       Point 2:255/171.33 gets increased access, whilst the twit point
  366.       2:255/171.172 has his lowered; both will receive an echolist
  367.       when I want to send them one, as well as when they want one.
  368.  
  369.         Note that it is possible to assign a different access level
  370.       for different AKA's of the same system.  e.g. the UK Amiganet RC
  371.       (as of May 1993) has at least two addresses: 39:138/1 and also
  372.       2:253/404 (fidonet address).  I can allow 39:138/1 increased
  373.       access on my system, while at the same time keeping the fidonet
  374.       address at a relatively low level:
  375.  
  376.       LEVEL 39:138/1    65535 [-]
  377.       LEVEL 2:253/404   150   [Q]
  378.  
  379.         i.e. only slightly increased access for 2:253/404, and he'll
  380.       receive an echolist (of fidonet areas only) when I want him to,
  381.       but his amiganet address is given high access, and he won't be
  382.       sent a list of amiganet areas unless he requests one.
  383.       
  384.  
  385. 4.1.12  ECHOLEVEL
  386.  
  387.         This is the third keyword which, in conjunction with
  388.       DEFAULTLEVEL and LEVEL (see above) will enable you to restrict
  389.       who can link into what areas.
  390.  
  391.         Per default, each AREA tag (in MAIL:Fido.Cfg) is assigned the
  392.       DEFAULTLEVEL.  This means that any PASSWORD PROTECTED AreaFix
  393.       session with a user with the default access level will be able to
  394.       link into/out of this area without the need for any
  395.       configuration by you the SysOp.
  396.  
  397.         Using the ECHOLEVEL keyword, you can do one of two things: (1)
  398.       increase the level of this AREA tag, which will mean that only
  399.       priviliged users with the requisite access (i.e. greater or
  400.       equal to the ECHOLEVEL) will be able to link in/out of the area;
  401.       (2) or you could DECREASE the level of this area and thus make
  402.       it available to not only password protected AreaFix users, but
  403.       to anyone and everyone (see the (NO)SECURE keyword description
  404.       for further explanation).
  405.  
  406.         This is not as daft as it might sound: suppose you host an
  407.       echo which is not available on the backbone.  If you wanted
  408.       anyone to link into, you'd normally have to setup session
  409.       passwords etc..  By decreasing the access level of an area, you
  410.       could make it available to ANYONE (or to ANYONE except certain
  411.       twit points or whatever) without the need for firing up your
  412.       text editor.  Thus preventing you from receiving annoying
  413.       messages from nodes/points saying 'I tried to link in, but I
  414.       was refused access'.
  415.  
  416.      Page 9             WiZFix's Fantastic Manual              Page 9
  417.  
  418.             
  419.       Note that non-password protected sessions can ONLY link into
  420.       AREA tags which have a lower access than the DEFAULTLEVEL. 
  421.       Also, you should note that you can still lock certain users out
  422.       of these areas, by assigning him/her an access level (using the
  423.       LEVEL keyword) lower still.
  424.  
  425.         I would anticipate that most people will use the ECHOLEVEL
  426.       keyword to restrict access to certain echoes (say, SysOp only
  427.       ones), but I thought it might be a nice feature to add, so I
  428.       added it. :-)
  429.  
  430.         Valid numbers are 0 - (2^32-1).
  431.  
  432.         Here's a few example ECHOLEVEL statements:
  433.  
  434.       ECHOLEVEL   BAD           9999999   ; No one gets this.
  435.       ECHOLEVEL   DICE          10        ; Anyone can have this.
  436.       ECHOLEVEL   255_SYSOP     65535     ; SysOps only
  437.       ECHOLEVEL   SYSOP_AMY     65535     ; Ditto.
  438.       ECHOLEVEL   ANDROMEDA     90        ; etc.
  439.       ECHOLEVEL   R13HOST       65535     ; Not many get to see this..
  440.       ECHOLEVEL   P-WARE_BETA   500       ; Get it yet? :-)
  441.  
  442.         If you receive an AreaFix request from a non-password
  443.       protected node/point then they would be allowed to link into
  444.       only the DICE and ANDROMEDA echoes - the others would not even
  445.       be listed to them.
  446.       
  447.         If you have a particularly annoying point/node that needs
  448.       additional sorting out, then you could assign him/her an access
  449.       level (using the LEVEL keyword) less than 90 (which would ban
  450.       him from the ANDROMEDA area) or less than 10 (which would ban
  451.       him completely).
  452.       
  453.         Got it?
  454.       
  455.  
  456. 4.1.13  (NO)SECURE
  457.  
  458.         Use this keyword if you wish to allow anyone to be able to
  459.       link into the areas with an access level of less than the
  460.       DEFAULTLEVEL.  i.e. in the above list, they could link into the
  461.       areas DICE and ANDROMEDA (DICE is an area I host, and ANDROMEDA
  462.       is my point area, in case you're interested. :-)
  463.       
  464.         Please use this and the above keyword with care.  It is
  465.       unwise to allow 'unlnowns' to link into backboned areas, as they
  466.       may be unpleasant individuals who are intent on causing you
  467.       inconvenience (say by duping mail - even unintentionally).  I
  468.       recommend that you only use the INSECURE keyword when you fully
  469.       understand what it does.
  470.  
  471.       (default - SECURE)
  472.  
  473.      Page 10             WiZFix's Fantastic Manual              Page 10
  474.  
  475.  
  476. 4.1.14  RESCANLEVEL
  477.  
  478.         Not yet implemented.
  479.  
  480.  
  481. 4.1.15  RESCANPROTECT
  482.  
  483.         Not yet implemented.
  484.  
  485.  
  486. 4.1.16  SKYTICK <path>
  487.  
  488.         WiZFix supports 'file echo' lists too (i.e. TICK file areas).
  489.       The above command tells WiZFix that you're using SKYTICK.  The 
  490.       path following the keyword tells WiZFix where it can find the
  491.       SkyTick configuration file (usually MAIL:Tick.Cfg).
  492.       
  493.         WiZFix automatically links users in/out of the SkyTick Tick.Cfg
  494.       file, and generates 'echo lists' etc. exactly as for the
  495.       Fido.Cfg.
  496.       
  497.       Requests for file echoes are dealt with AFTER requests for
  498.       message echoes, which complicates matters:
  499.       
  500.      o A file echo having the same name as a message echo WILL confuse
  501.        WiZFix (all requests to add/drop the area will always cause
  502.        WiZFix to work on the message area, not the file area).  Other
  503.        AreaFix programmes suffer the same problem..
  504.     
  505.      o Additionally, any requests for message echoes which you do not
  506.        carry will result in WiZFix searching your 'Tick.Cfg' file
  507.        BEFORE it tries to forward a request for your hub.  This will,
  508.        confusingly, mean that FILE ECHOES will be linked in/out of
  509.        instead of any requests being sent to your Hub if the FILE ECHO
  510.        TAG matches the message area TAG.
  511.       
  512.           It is unlikely that this will ever be a problem, and in any
  513.       case the rest of the planet will be in a similarly sorry state as
  514.       it's impossible to know whether a request is for a FILE or
  515.       MESSAGE area
  516.  
  517.      
  518. 4.1.17  FTICK <path>
  519.       
  520.         As for SKYTICK (see 4.1.16) but for Foozle's TICK configuration
  521.       file.  The quirks that apply to SKYTICK as regards identical FILE
  522.       and MESSAGE TAG names applies equally to Foozle Tick's file.
  523.  
  524.      Page 11             WiZFix's Fantastic Manual              Page 11
  525.  
  526.  
  527. 5  Operation
  528.       
  529.         WiZFix works by scanning the netmail base in order to find
  530.       messages addressed to 'AreaFix'.  Only messages above TrapToss'
  531.       'high water mark' are scanned, and each message can be
  532.       processed only once.  (i.e. I set the RECEIVED flag for each
  533.       processed message, which is therefore ignored on subsequent
  534.       scans).
  535.       
  536.         In order to allow TrapToss to work, you must run TrapToss in
  537.       either IMPORT or preferably TOSS mode.  Do not use the keywords
  538.       EXPORT or SCAN until after you've allowed WiZFix to process
  539.       mail.  (This is because trapToss correctly updates the 'high
  540.       water mark' after a SCAN or EXPORT, which would fool WiZFix
  541.       into thinking that all AreaFix messages have been processed).
  542.       
  543.         e.g. I run WiZFix as part of my incoming mail AFTERSESSION
  544.       script.  Here's a simplified version of my current
  545.       aftersession, which is called by TrapDoor after every successful
  546.       incoming call.
  547.  
  548.       ;
  549.       ; Import mail.
  550.  
  551.       ;Now unpack & process the mail.
  552.       TrapToss NOSCAN
  553.  
  554.       ;WiZFix
  555.       WiZFix
  556.  
  557.       ;Now export WiZFix replies (if any!)
  558.       If WARN
  559.               TrapToss SCAN MATRIXONLY
  560.       endif
  561.       ...
  562.  
  563.         Note that I run TrapToss in SCAN/TOSS mode (I don't use
  564.       IMPORT/EXPORT - neither should you if you're running a node
  565.       setup).
  566.  
  567.         Also note the use of the 'IF WARN' statement - WiZFix returns a
  568.       return code of 5 (WARN) IF it's processed any messages (i.e.
  569.       there are replies to send out).  If it has not created any
  570.       replies, then no 'WARN' code is returned.  Simple, but jolly
  571.       useful if you want to prevent TrapToss from firing up needlessly.
  572.  
  573.         If all goes well, that's all you need to do to install
  574.       WiZFix.  The hard bit is up to your calling nodes/points (they
  575.       have to send 'AreaFix' messages).  Full details of how WiZFix
  576.       works from your calling nodes/points viewpoint are given in the
  577.       file 'AreaFix.hlp' (which is the default file sent to every
  578.       node/point that uses the '-h' keyword on the subject line).
  579.       However, it might be useful to describe the main events that
  580.       occur here:-
  581.       
  582.         Firstly, a node/point sends a message to your system addressed
  583.       to AreaFix.  The subject line must contain their session
  584.       password (unless you use the NOSECURE keyword), followed
  585.       optionally by several switches: '-l -q -h -r -f -u' (in any
  586.       order; some, all or none can be used).
  587.  
  588.      Page 12             WiZFix's Fantastic Manual              Page 12
  589.  
  590.  
  591.         The '-q' switch will instruct WiZFix to send a reply message
  592.       that contains a list of AREAS to which that node/point is
  593.       connected.  Note, only areas containing that nodes/points
  594.       address (and NOT any of his AKA's) will be listed.
  595.       
  596.         The '-l' switch will instruct WiZFix to send a list of
  597.       available areas to that node/point. The list will contain the
  598.       AREA tag names only of areas to which that node/point (a) has
  599.       access to and (b) are in the same network as the calling
  600.       node/point (there is no valid reason to automatically send a
  601.       list of amiganet conferences to a fidonet node, and vice
  602.       versa).  In addition to the automatically generated list,
  603.       WiZFix will also send a text file as specified in the ZONE
  604.       HOSTLIST statement.  This can contain whatever you wish, but
  605.       would normally contain a list of available areas perhaps with
  606.       descriptions?  You could of course also list areas available in
  607.       other networks too.
  608.  
  609.         The '-f' switch has the same effect as '-l' but also sends
  610.       a copy of your Hub's echolist (if any).  I decided to make this
  611.       a separate switch as a full backbone list (which is what I use
  612.       for my Hub) is rather large, and users would get peeved PDQ if
  613.       they got one of them every time they issued a '-l'.
  614.  
  615.         A '-l' and '-f' will only cause one auto-list to be sent, so
  616.       there's no need for users to remember not to use '-l' when '-f'
  617.       is used.
  618.  
  619.         The '-u' switch will cause a list of echoes to which the node
  620.       is NOT linked in to be sent. 
  621.  
  622.         The '-h' switch instructs WiZFix to send a copy of the
  623.       HELPFILE to the calling node (this would normally explain how
  624.       to the user how use 'AreaFix' remotely).
  625.       
  626.         The '-r' switch instructs WiZFix to rescan the area(s)
  627.       listed in the message.  Currently, this is not implemented in
  628.       the released version, and is likely to change anyhow.
  629.  
  630.         The following '%' commands can be used in the message body text
  631.       in place of the '-x' commands  (the first letter of each COMMAND
  632.       is also sufficient):
  633.       
  634.                 %LIST, %L       -       same as '-l'
  635.                 %QUERY, %Q      -       same as '-q'
  636.                 %UNLINKED, %U   -       same as '-u'
  637.                 %HELP, %H       -       same as '-h'
  638.                 %FULL, %F       -       same as '-f'
  639.  
  640.         Having scanned the netmail base, WiZFix will process
  641.       messages as needed and create replies as appropriate.  These
  642.       will be exported to the calling node/point the next time that
  643.       TrapToss SCANs or EXPORTs mail.  Please note that normal
  644.       TrapToss routing commands are not affected.  So reply messages
  645.       to points can be placed on hold etc. as per normal.
  646.  
  647.      Page 13             WiZFix's Fantastic Manual              Page 13
  648.  
  649.       
  650.       If the received messages have resulted in any changes to the
  651.       Fido.Cfg file (e.g. a node/point has linked in or out of an
  652.       area) then the entire Fido.Cfg file is updated to reflect the
  653.       changes.  Ditto any changes to the 'Tick.Cfg' file (if
  654.       configured).
  655.       
  656.       Topology changes, as well as access/password infringements are
  657.       recorded in the log file.
  658.  
  659.         WiZFix has a few built-in aliases: you can call it 'AreaFix',
  660.       'FileFix' or 'Raid' (not case sensitive).  More words will be
  661.       added soon - suggest some if you want!
  662.  
  663.  
  664. 6  CLI arguments
  665.  
  666.         Pretty sparse right now, but that will change once I'm convinced
  667.      all the bugs are dead, and the functionality is acceptable.
  668.      
  669.      
  670. 6.1  ECHOLIST
  671.      
  672.         This will disable the normal operation of WiZFix, and will cause a
  673.      list of message/file areas to which nodes listed in your Fido.Cfg
  674.      file ([AreaFix] section) are connected.  Only nodes/points which are
  675.      defined with a LEVEL statement stand a chance of receiving an
  676.      echolist, and these must have the '[Q]' option in their definition
  677.      string.  So, if the following were listed in the 'Fido.Cfg':-
  678.      
  679.       ; Some privileged/dork users - set their access accordingly:
  680.       LEVEL 2:253/404         65535 [-]   ;Trustworthy
  681.       LEVEL 2:255/171.33      500   [Q]   ;Increased access for this point.
  682.       LEVEL 2:255/171.172     005   [Q]   ;Decreased for this twit point.
  683.       ;
  684.  
  685.      then only 2:255/171.33 and 2:255/171.172 would receive an echolist. 
  686.      Node 2:253/404 would only receive an echolist if (s)he sent a
  687.      specific AreaFix request.
  688.      
  689.         Please note that normal AreaFix messages are NOT processed if the
  690.      ECHOLIST CLI argument is used.
  691.           
  692.         Other keywords are planned, but feel free to make suggestions..
  693.      
  694.  
  695. 7  Example configuration
  696.       
  697.       Here is a drastically cut down version of my Fido.Cfg file,
  698.       showing how I operate WiZFix.  Please feel free to browse
  699.       this and use it in any way that helps you install WiZFix.
  700.  
  701.  
  702.      Page 14             WiZFix's Fantastic Manual              Page 14
  703.  
  704.       ;*******************************
  705.       ;* Fido.Cfg config file 27-5-93
  706.       ;* NODE  set-up                                                        *
  707.       ;*******************************
  708.       ;
  709.       Node    2:255/171
  710.       AKA     39:136/1 39:136/0 39:2424/0 2:2424/0
  711.       DOMAIN  amiganet  39:136/1  39:* 40:* 41:*
  712.       DOMAIN  fidonet
  713.       Origin  "Andromeda, Gwent 0873-858921"
  714.       NodeListPath    "Nodelist:"
  715.       Inbound     "Mail:Inbound"
  716.       Outbound    "Mail:Outbound"
  717.       TimeZone    "BST"
  718.  
  719.       [TrapToss]              ;The normally PRIVATE TrapToss section
  720.       UnAttended                            
  721.       ;CopyMsg #?
  722.       POINTNET 2424
  723.       LogLevel 5
  724.       LogFile Logs:TrapToss.Log
  725.       IOBuffersize 16384
  726.       Buffersize 1024000
  727.       BOUNCE 1:* 2:* 3:* 4:* 5:* 6:* 39:* 40:* 41:*
  728.       ScreenMode TRAPDOOR
  729.       ;etc. - plus all routing/packing commands.
  730.  
  731.       ;key areaname       directory                   nodes who get it
  732.       ;¯¯¯ ¯¯¯¯¯¯¯¯       ¯¯¯¯¯¯¯¯¯                   ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  733.       Netmail MAIL_DIR      MAIL:Mail/netmail
  734.       Area BAD              MAIL:Mail/Bad      
  735.       Area AMIGA.EUR        MAIL:Mail/AMIGA.EUR   255/171 255/1
  736.       Area AMIGA_COMP       MAIL:Mail/AMIGA_COMP  255/171 255/1
  737.       Area ANDROMEDA        MAIL:Mail/Andromeda   255/171 253/404
  738.       Area ANNOUNCE         MAIL:Mail/ANNOUNCE    255/171 255/171.8
  739.       Area BUY              MAIL:Mail/BUY         255/171 255/1 
  740.       Area CLUB_AMIGA       MAIL:Mail/CLUB_AMIGA  255/171 255/1
  741.       Area AUDIO_AMY        MAIL:Mail/AUDIO_AMY   39:136/1 39:133/1
  742.       Area BLITZ_AMY        MAIL:Mail/BLITZ_AMY   39:136/1 39:133/1
  743.       area COMMS_AMY        MAIL:Mail/COMMS_AMY   39:136/1 39:133/1
  744.       Area EMOD_AMY         MAIL:Mail/EMOD_AMY    39:136/1 39:133/1
  745.       ;
  746.       ;etc. - plus all other AREAS.
  747.       ;
  748.       [TrapList]              ;The normally PRIVATE TrapList section
  749.       gennewstyle
  750.       deloldlists
  751.       delolddiffs
  752.       checkcrc
  753.       report nodelist:Report.txt
  754.       comment SU
  755.       Zone        2           ; zone number
  756.       Output      Verbose     ; print additional information
  757.  
  758.      Page 15             WiZFix's Fantastic Manual              Page 15
  759.  
  760.       BufferSize  262144
  761.       NodeList    "NODELIST"  Diff "NODEDIFF" ; The weekly nodediff
  762.       Nodelist    "AMYLIST"   Diff "AMYDIFF"  ; AmigaNet
  763.       Password "Can you"      255/171 39:136/1 39:136/0
  764.       Password "Guess"        2:250/320 39:138/14
  765.       Password "What"         2:252/309
  766.       Password "These"        2:253/167
  767.       Password "are yet?"     2:253/419 39:135/1 39:135/0
  768.       ;
  769.       Dial  "-"         "-"         ; leave "-Unpublished-" as is
  770.       Dial    "44-"     "0"         ; UK numbers.
  771.       Dial    ""        "010"       ; USA.
  772.       ;
  773.       Cost  61    "1-"              ;North America
  774.       Cost  81    "61-"             ;Australia
  775.       Cost  48    "43-"             ;Austria
  776.       Cost  116   "973-"            ;Bahrain
  777.       ;etc, etc.
  778.       ;
  779.       [WiZFix]               ;The new WiZFix section.
  780.       ;
  781.       LOGFILE     LOGS:WiZFix.Log        ;My logfile.
  782.       ;
  783.       SKYTICK MAIL:Tick.Cfg              ;My TICK file..
  784.       ;
  785.       USETRAPLISTPW                      ;Use TrapList passwords.
  786.       ;
  787.       password "hidden" 1:234/567        ;Some additional ones..
  788.       password "guess"  39:999/999.999
  789.       ;
  790.       HELPFILE MAIL:WiZFix.hlp           ;My WiZFix 'Help' file
  791.       ;
  792.       ; Now some ZONE statements, togther with more files that can be
  793.       ;sent ('*' means send nothing).
  794.       ZONE 2  *         Mail:HubFidonet.txt   2:255/1   MAGIC
  795.       ZONE 39 *         *                    39:138/1   MORE_MAGIC
  796.       ;
  797.       ALLOWFORWARDINGPOINTS               ;Points can forward requests.
  798.       ;
  799.       NOALLOWFORWARDINGNODES              ;But nodes CAN'T.
  800.       ;
  801.       DEFAULTLEVEL 100                    ;Standard security level.
  802.       ;
  803.       ; Some privileged/dork users - set their access accordingly:
  804.       LEVEL 2:253/404         65535 [-]   ;Trustworthy
  805.       LEVEL 2:255/171.33      500   [Q]   ;Increased access for him.
  806.       LEVEL 2:255/171.172     005   [Q]   ;Decreased for this twit.
  807.       ;
  808.       ; Now change the access of restricted/public areas:
  809.       ECHOLEVEL   BAD           100000    ; No one gets this.
  810.       ECHOLEVEL   255_SYSOP     65535     ; SysOps only
  811.       ECHOLEVEL   SYSOP_AMY     65535     ; Ditto.
  812.       ECHOLEVEL   ANNOUNCE      9         ; Low access needed.
  813.       ECHOLEVEL   ANDROMEDA     10        ; etc.
  814.       ECHOLEVEL   JOE_PUBLIC    1         ; Free for all! :-)
  815.       ;
  816.       NOSECURE                  ; Anyone can use WiZFix here!
  817.  
  818.      Page 16             WiZFix's Fantastic Manual              Page 16
  819.  
  820.       
  821. 8  Future
  822.       
  823.         Open to suggestions..
  824.  
  825.       
  826. 9  Registration
  827.       
  828.         WiZFix is released under a new concept, which I genuinely
  829.       hope will catch on:  I have christened this new concept
  830.       'ComplicatedWare'.
  831.  
  832.         In a nutshell, this is FREE to all non-Shareware programmers,
  833.       but it's Shareware to all Shareware programmers!  Here's the
  834.       details:
  835.       
  836.         I have a general dislike for Shareware programmers.  Some of
  837.       them are of course fair and honest individuals, but for the
  838.       most part they are take your money and give little in the way
  839.       of support, or they ask for money for even the most trivial of
  840.       programmes.  This is my attempt to hit back:-
  841.       
  842.         If you have released ANY shareware software then to you,
  843.       WiZFix is SHAREWARE.  You are obliged to send me precisely
  844.       half of what you demand from everyone else.  You are entitled
  845.       to use WiZFix for a period of one week, after which you must
  846.       either register or delete the software from your system.
  847.       
  848.         If you have not released any shareware software, nor required
  849.       payment for any programme distributed either electronically or
  850.       via PD libraries etc. then to you, WiZFix is *FREE*,  You may
  851.       use it or not use it for as long as you want and you are not
  852.       obliged to send me anything.  However, I would like to mention
  853.       that I have a minor hobby, which is the collection of postcards
  854.       from around the world: if you by chance have a spare postcard
  855.       depicting your home town and/or country then I would very much
  856.       like to receive it. :-)
  857.       
  858.         SHAREWARE donations (i.e. from other SHAREWARE programmers),
  859.       and any postcards from the other decent folk on this planet
  860.       should be sent to:
  861.       
  862.             Andrew Wilson
  863.             47 Plas Derwen View
  864.             Abergavenny
  865.             Gwent
  866.             NP7 9SX
  867.             UK
  868.  
  869.       I genuinely hope that other programmers will become encouraged
  870.       to adopt the same attitude that I have: it's about time that
  871.       Amiga programmers started to follow the example set by some of
  872.       the kinder individuals out there, and not keep trying to
  873.       squeeze money out of fellow Amigans just because they know how
  874.       to drive a compiler.
  875.       
  876.                    >>>>>PROMOTE ComplicatedWare<<<<<
  877.  
  878.      Page 17             WiZFix's Fantastic Manual              Page 17
  879.  
  880.  
  881. 10 Copyright
  882.  
  883.         WiZFix is copyright Andy Wilson (1993) - all rights reserved. 
  884.       WiZFix may not be reverse engineered, dissassembled, de-compiled
  885.       or re-sourced at all.
  886.  
  887.       
  888. 11  Warranty
  889.  
  890.         No warranty is expressed or implied in the use of this
  891.       software, whether it be registered or freeware, the copyright
  892.       holder, Mr Andrew Wilson, accepts no responsibility whatsoever
  893.       for any damage or harm to you, your computer, or any third party
  894.       or third party equipment no matter how such damage may transpire.
  895.  
  896.         Any expense incurred directly or indirectly as a result of
  897.       using this software shall fall upon the user: YOU assume the cost
  898.       of any and all necesseary or desirable servicing, repair,
  899.       replacement or correction.  Under no conditions whatsoever shall
  900.       the copyright holder be liable to any damages arising out of the
  901.       use or misuse or inability of the programme to work or function
  902.       as described above.
  903.  
  904.         There is no warranty that this software is fit for the purpose
  905.       described above nor that it will operate reliably or reproducably
  906.       at any time.  The user uses this programme entirely at his/her
  907.       own risk.
  908.  
  909.         In a nutshell - if it goes wrong its NOT MY FAULT.
  910.  
  911.         The copyright holder reserves the right to develop or not
  912.       develop this software at any time in the future, without notice.
  913.  
  914. 12 Distribution
  915.       
  916.         WiZFix must be distributed freely in either electronic form or
  917.       via magnetic media.  No costs over and above that charged by Fred
  918.       Fish for the supply of one diskette may be charged.
  919.  
  920.         WiZFix must be distributed only as a complete file archive; the
  921.       executable files must not under any conditions be compressed with
  922.       e.g. POWERPACKER or other software.  Only unmodified copies of
  923.       the archive shall be distributed at all times, with all supplied
  924.       documentation etc. intact.
  925.       
  926.         The distributor agrees to withdraw the distribution of WiZFix
  927.       if requested to do so by the copyright holder.
  928.       
  929.       
  930.  
  931.      Page 18             WiZFix's Fantastic Manual              Page 18
  932.       
  933.            
  934. 13 Acknowledgements
  935.  
  936.         Many thanks to:
  937.       
  938.         Iain Hibbert for his programming advice and testing of WiZFix -
  939.       may your netmail directory recover in good time..
  940.       
  941.         René Hexel for TrapToss - without which this software would be
  942.       pretty useless!  An excellent piece of software René and one of
  943.       the very few actually worth the registration fee!  Well done and
  944.       please keep up the good work René.
  945.       
  946.         Luca Spada for providing an excellent range of FREE software. 
  947.       If only other Amiga programmers could follow such a lead.
  948.       
  949.         Fred Waicsek for calling me and informing me of bugs, even
  950.       though he's the other side of the North Sea - thanks chum!
  951.       
  952.         Roger Nordin for the useful dialogue and technical information,
  953.       and for the splendid job you've done for the Amiga community. 
  954.       Thanks!
  955.       
  956.         Tony Jones - nothing whatsoever to do with the development of
  957.       WiZFix, just a good friend..
  958.  
  959.  
  960.      Page 19             WiZFix's Fantastic Manual              Page 19
  961.      
  962.      
  963.                                 ROADMAP
  964.      
  965.         Section No.     Title                                Page No
  966.      
  967.      
  968.             1           Introduction                            2
  969.      
  970.             2           Overview                                2
  971.      
  972.             3           Installation                            3
  973.      
  974.             4           Configuration                           3
  975.      
  976.             4.1         Configuration Keywords                  4
  977.             4.1.1       LOGFILE                                 4
  978.             4.1.2       USETRAPLISTPW                           4
  979.             4.1.3       PASSWORD                                4
  980.             4.1.4       ALLOWCREATE                             5
  981.             4.1.5       PREADCONFIG                             5
  982.             4.1.6       HELPFILE                                5
  983.             4.1.7       ZONE                                    5
  984.             4.1.8       (NO)ALLOWFORWARDINGPOINTS               6
  985.             4.1.9       (NO)ALLOWFORWARDINGNODES                7
  986.             4.1.10      DEFAULTLEVEL                            7
  987.             4.1.11      LEVEL                                   7
  988.             4.1.12      ECHOLEVEL                               8
  989.             4.1.13      (NO)SECURE                              9
  990.             4.1.14      RESCANLEVEL                            10
  991.             4.1.15      RESCANPROTECT                          10
  992.             4.1.16      SKYTICK                                10
  993.             4.1.17      FTICK                                  10
  994.      
  995.             5           Operation                              11
  996.      
  997.             6           CLI Arguments                          13
  998.             6.1         ECHOLIST                               13
  999.      
  1000.             7           Example Configuration                  14
  1001.      
  1002.             8           Future                                 16
  1003.      
  1004.             9           Registration                           16
  1005.      
  1006.            10           Copyright                              17
  1007.      
  1008.            11           Warranty                               17
  1009.      
  1010.            12           Distribution                           17
  1011.      
  1012.            13           Acknowledgements                       18
  1013.      
  1014.                         RoadMap                                19
  1015.      
  1016.      
  1017.                  * I hope to see ComplicatedWare catch on *
  1018.      
  1019.