home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BNU202.ZIP / FUTIL.TXT < prev    next >
Encoding:
Text File  |  1992-10-15  |  8.8 KB  |  265 lines
  1.  
  2.                                                 FUTIL FOSSIL Companion
  3.                                                           Version 1.10
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                                    FUTIL
  11.  
  12.                         A FOSSIL Companion Utility
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                             Copyright (C) 1992
  22.  
  23.                   Unique Computing Pty Ltd & David Nugent
  24.  
  25.                          FidoNet  3:632/348.0
  26.                         AlterNet  7:833/387.0
  27.                          FreeNet  23:2/3.0
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                 June, 1992
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.     FUTIL.COM, FUTIL.ASM and  accompanying  documentation are released
  52.     free of charge  in  the  interests   of   encouraging   others  to
  53.     contribute to the Fidonet community and to provide information and
  54.     assistance to those  "learning  the  ropes" in communications  and
  55.     programming in general.
  56.  
  57.     This utility will  be  of  particular interest to those wanting to
  58.     test their systems locally, simulating  a  full connect, logon and
  59.     logoff using no  or  a direct wire external connection.   It  will
  60.     also assist (a  little)  those  wanting  to delve further into the
  61.     workings of FOSSIL.
  62.  
  63.  
  64.  
  65.                                    - 1 -
  66.  
  67.  
  68.                                                 FUTIL FOSSIL Companion
  69.                                                           Version 1.10
  70.  
  71.     Usage:
  72.  
  73.        FUTIL has only two possible command line parameters.
  74.  
  75.           FUTIL [/Pn] [/U]
  76.  
  77.             /Pn  Install for port 'n' (0-16), default is port 0 (COM1)
  78.              /U  Uninstall from memory, if already resident
  79.  
  80.  
  81.  
  82.     FUTIL - What is it?
  83.  
  84.  
  85.     FUTIL is a  small  TSR (terminate and stay resident) utility which
  86.     acts as a wedge between FOSSIL  and  a  FOSSIL  aware  application
  87.     (such as a  mailer  or  BBS).   Using keyboard commands,  you  can
  88.     simulate modem return  codes  and  FOSSIL  status  information  to
  89.     'fool' the application  into  thinking   that  it  has  connected,
  90.     received carrier and has a remote user logged on.   This  is  very
  91.     useful  while setting  up  a  new  BBS,  or to simulate a modem to
  92.     modem connection with two locally hard-wire connected machines.
  93.  
  94.     FUTIL fools the application by providing the means of intercepting
  95.     FOSSIL calls, optionally    'eating'    transmitted    characters,
  96.     returning modem  result and connect codes and manipulating various
  97.     modem status information returned by a FOSSIL.  All  result  codes
  98.     and status changes   can  be  entered  and  manipulated  from  the
  99.     keyboard.
  100.  
  101.     FUTIL is known to work with BNU  and  Opus!Com.   It will normally
  102.     work with X00, excepting where an application uses  the "x00" high
  103.     level language interface  to  bypass  INT  14H and call the driver
  104.     directly.  Therefore use with X00  is  not  recommended  (but will
  105.     usually work).
  106.  
  107.     In thory, FUTIL should work with just about any other  FOSSIL in a
  108.     100% PC, PC/AT or PS/2 compatible under MS-DOS.
  109.  
  110.  
  111.  
  112.     Why release source?
  113.  
  114.     FUTIL's source is  provided  to  enable  its customisation to your
  115.     particular purpose.  This  will   extend   its   usefulness.   For
  116.     example, with  slight  modification, it can be used  to  intercept
  117.     standard BIOS calls in a similar way.  Keyboard 'hotkeys' can also
  118.     be changed and   added   to,   additional   codes   added,   other
  119.     communications status bits status  by altering the keyboard tables
  120.     and re-assembling.
  121.  
  122.     FUTIL *works*.  But it should not be left resident unless during
  123.     testing or unless it has been completely deactivated.  BE WARNED!
  124.     Since FUTIL provides the ability to set and override real
  125.     communications status information (such as carrier  detect),  this
  126.     can cause failed  connects  or  complete  confusion so far as your
  127.     FOSSIL application is   concerned.     Use   only   under   direct
  128.     supervision!
  129.  
  130.  
  131.                                    - 2 -
  132.  
  133.  
  134.                                                 FUTIL FOSSIL Companion
  135.                                                           Version 1.10
  136.  
  137.  
  138.     This source can  be  easily  used  as  a learning tool both in the
  139.     'art' of FOSSILs  and  the  'hotkey'   aspects   of   TSR's.    To
  140.     investigate what FUTIL does, it is advisable to have a copy of the
  141.     FOSSIL specification handy.  The source is heavily commented.
  142.  
  143.  
  144.  
  145.     Supplied configuration
  146.  
  147.     FUTIL is pre-configured  for  COM1  (FOSSIL  port   0)  -  may  be
  148.     overridden with the  command line switch /Pn - and will by default
  149.     not be active.  In this state, it  will  pass all calls through to
  150.     the resident FOSSIL driver unmodified and returns  all information
  151.     unaltered.  However, the  keyboard provides a way of changing this
  152.     as follows:
  153.  
  154.       NOTE:  All keys mus be pressed  while  holding  down  the  Ctrl-
  155.              Leftshift key combination (this too can be modified).
  156.  
  157.  
  158.          Key  Result
  159.  
  160.          `    Turns all (FUTIL) processing off (default state)
  161.          0    Forces (and keeps on forcing) no carrier
  162.          O    Simulates an 'OK' and forces carrier low
  163.          E    Simulates an 'ERROR', forcing carrier low
  164.          N    Simulates a 'NO CARRIER', forcing carrier low
  165.          B    Simulates 'BUSY' forces carrier low
  166.          F    'CONNECT FAST', carrier high
  167.          9    'CONNECT 9600', carrier high
  168.          3    'CONNECT 2400/REL', carrier high
  169.          2    'CONNECT 2400', carrier high
  170.          1    'CONNECT 1200', carrier high
  171.          R    'RING', carrier low
  172.          V    'VOICE', carrier low
  173.          I    'RRING', carrier low
  174.  
  175.  
  176.     These can be easily re-configured to suit if you have an assembler
  177.     handy (MASM 5.10  or  TASM  1.0 required).  Each  hotkey  and  its
  178.     effect are configured by changing data in the "notkey" structures;
  179.     refer to the source for further details.
  180.  
  181.     FOSSIL calls intercepted  by  FUTIL  are all data transmit/receive
  182.     ones, including 'block' transmit/receive  supported  by FOSSIL rev
  183.     5.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                    - 3 -
  198.  
  199.  
  200.                                                 FUTIL FOSSIL Companion
  201.                                                           Version 1.10
  202.  
  203.                             LICENSE INFORMATION
  204.  
  205.  
  206.     Programs and documentation are supplied free of charge on an as is
  207.     basis to the  Fidonet  (and  othernet) community.  You are free to
  208.     use them in any non-profit venture  with  no  obligation on either
  209.     myself or my company to support or be responsible for any such use
  210.     (or misuse).
  211.  
  212.     This program and documentation is the exclusive property of Unique
  213.     Computing Pty Ltd,  and  is  protected by international  copyright
  214.     laws.  By obtaining a copy of the package, you do not "own" a copy
  215.     - simply a license to use it.  All property rights are retained by
  216.     the owner.
  217.  
  218.     You may use  the  package  and/or  give  copies  of the package to
  219.     others including posting for download  on  a  bulletin  board, but
  220.     only in a form that permits inclusion of all files as found in the
  221.     original, archived form in which it is distributed.   You  are not
  222.     permitted to modify any portion of the package in any way which is
  223.     to be passed  on  to  others, including, but not limited to adding
  224.     files to or removing files from the distribution package, changing
  225.     or editing the documentation, and/or  changing  or  modifying  the
  226.     executable program.  Permission   is   granted   to   repack   the
  227.     distribution archive using  a  different  packing method, provided
  228.     that the uncompressed  contents  EXACTLY  match  the  uncompressed
  229.     contents of the  distribution  archive  (I  have   no   particular
  230.     affiliation with or   preference   for  any  particular  archiving
  231.     method).
  232.  
  233.     This program is  not  provided with  any  warranty  of  any  kind,
  234.     including, but not  limited to fitness for any particular  purpose
  235.     or consequential loss.
  236.  
  237.     This package may  be  posted  for  download or file request by any
  238.     FidoNet or compatible network system  in  archived  form,  and  in
  239.     adherence to the  terms of the License above.  No  profit  may  be
  240.     realised directly from such distribution, although the package may
  241.     be provided for   download  on  "pay  systems."   Distribution  on
  242.     diskette form is  strictly prohibited unless done for free for for
  243.     a charge not exceeding the cost of the diskettes.
  244.  
  245.     For commercial application, contact details are:
  246.  
  247.          David Nugent
  248.          c/o Unique Computing Pty Ltd
  249.          Central Source ICBS BBS, +61-3-874-8927
  250.          3:632/348.0@fidonet
  251.          7:833/387.0@alternet
  252.          23:2/3.0@freenet
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                    - 4 -
  264.  
  265.