home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / VFAST30R.ZIP / VFAST.DOC < prev    next >
Text File  |  1995-01-12  |  10KB  |  261 lines
  1.          Vfast             Technical Reference Manual           Page 1
  2.  
  3.                                   vFAST v3.0
  4.             Copyright 1993-95 (c) International TeleCommunications
  5.                               All Rights Reserved
  6.  
  7.                                  Introduction
  8.  
  9.          vFAST  was designed specifically for v32, v32bis,  and  vFAST
  10.          modems. You should not attempt to use vFAST with a 2400  baud
  11.          modem  unless your modem is error correcting.   The reason, a
  12.          single  error could produce a resend request for as  much  as
  13.          8192  bytes. It COULD be as little as 256 bytes but the  risk
  14.          of 8192... well that is up to you.
  15.  
  16.          vFAST needs ONE of the following:
  17.  
  18.          16550 Uart
  19.          Intelligent Digiboard (2, 4, 8, or 16 port).
  20.          Intelligent Stargate.
  21.          Intelligent Arnet.
  22.  
  23.          If you don't have one of the above, well try  and see.   You
  24.          MIGHT be able to keep up but I doubt it.
  25.  
  26.          vFAST  is just what the name implies, a vERY  FAST  protocol,
  27.          it'll run circles around Zmodem.
  28.  
  29.          vFAST  uses  DUAL 16 bit CRC's to protect  data.  Each  SHORT
  30.          block  of  data  has a 16 bit CRC and every  8192  bytes  has
  31.          another 16 bit crc. In short, CRC's inside of CRC's. Just  as
  32.          effective  as  one single 32 bit crc but has  much  less  CPU
  33.          overhead.
  34.  
  35.          vFAST  has RESTART recovery for aborted transfers as well  as
  36.          SKIP for files you ALREADY have.
  37.  
  38.          You can ABORT a transfer by pressing ESC. Again, to keep  CPU
  39.          overhead  low, we only check the  keyboard every  8  to  16K,
  40.          depending on the status of the RX/TX buffers, so there may be
  41.          a  short  delay   between  the time you  press  ESC  and  the
  42.          program acknowledges the ESC.
  43.  
  44.          Once you see the acknowledgment, nothing may appear to happen
  45.          for upwards of 10 to 12 seconds. vFAST is attempting to clear
  46.          out the RX buffer and phone lines before exiting, to  prevent
  47.          garbage  from spraying all over your screen.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.          Vfast             Technical Reference Manual           Page 2
  57.  
  58.                              Hardware Requirements
  59.  
  60.          You need a 386, 486, or Pentium processor. vFast will NOT run
  61.          on a 8088 or 80286 micro processor.
  62.  
  63.                              Command Line Switches
  64.  
  65.          vFAST supports the following command line switches:
  66.  
  67.          -Tx            Use Timeslicing when you cannot send or
  68.                         receive anything. x is the TYPE of time
  69.                         slicing. Valid TYPES are:
  70.  
  71.                         D         Desqview
  72.                         O         OS-2
  73.                         W         Windows
  74.  
  75.                         If  you use OS-2 or Windows Time Slicing,  you
  76.                         must have have  DPMI turned on.
  77.  
  78.          -Bxxxxx        xxxx is the connect baud rate.
  79.  
  80.          -Pxxx          xxxx is the serial port, 1-4 if using the
  81.                         standard internal driver.
  82.  
  83.          -Lxxxx         xxxx is Serial LOCK rate, 9600 - 115200.
  84.  
  85.          -S  <Fnames>   Start Sending files. Fnames is the  names  of
  86.                         the  files  to  send.  Each  name  should   be
  87.                         separated  by a single blank space. If  Fnames
  88.                         is  prefixed  with an AT sign, @,  vFAST  will
  89.                         ASSUME  Fnames is the name of a  SEND  control
  90.                         file.
  91.  
  92.                         E.g.  -S @C:\TERM\SEND.CTL
  93.  
  94.                         SEND.CTL would be a text file listing the
  95.                         files to send, one per line. Drive, path,
  96.                         and DOS wildcards supported.
  97.  
  98.                         This must be the LAST command line switch used.
  99.  
  100.          -D<TYPE>       The TYPE of serial driver to use. Valid <TYPE>
  101.                         are:
  102.  
  103.                         D       Digiboard
  104.                         S       Stargate
  105.                         A       Arnet
  106.  
  107.                        The default is the internal (Standard DOS  type
  108.                        serial ports) highspeed serial driver.
  109.  
  110.  
  111.          Vfast             Technical Reference Manual           Page 3
  112.  
  113.          -N*N          If you're running vFAST as a protocol driver
  114.                        with Osiris XLT, include this switch.
  115.  
  116.  
  117.          -R            Begin Receiving, must be the LAST command line
  118.                        switch used.
  119.  
  120.          -K            Disable Keep Aborted Transfers. The default it
  121.                        to keep all partial transfers. If you use this
  122.                        driver as an external protocol driver for a BBS
  123.                        you'll  want  to include this  on  the  command
  124.                        line.
  125.  
  126.          -U<PATH>      This tells vFAST to place all files you receive
  127.                        in   THIS  directory.  This  feature  is   ONLY
  128.                        available if you register vFAST.
  129.  
  130.          -!<FILENAME>  This tells vFAST to pull the callers name from
  131.                        DOOR.SYS, DOOR1.SYS, DOOR2.SYS, etc. This file
  132.                        must be in DOOR.SYS format and you must supply
  133.                        the full drive, path, AND filename.
  134.  
  135.                        E.g.  -!C:\PCBOARD\DOOR.SYS
  136.  
  137.                        NOTE:   This  feature  is  only  available   in
  138.                        REGISTERED mode.
  139.  
  140.          -W<LOGFILE>   This allows you to redirect the log file to any
  141.                        drive, directory, and file. You must supply the
  142.                        full drive, path, AND filename.
  143.  
  144.                        E.g.  -WC:\PCBOARD\JOHN.LOG
  145.  
  146.                        NOTE:   This  feature  is  only  available   in
  147.                        REGISTERED mode.
  148.  
  149.          -C<IRQ,ADDR>  Lets you reconfigure the IRQ and BASE  address
  150.                        for the serial port. IRQ and ADDR are in  BASE
  151.                        10 format.
  152.  
  153.                        E.g. -C3,744
  154.  
  155.                     Command Lines For Sending And Receiving
  156.  
  157.          The  minimum  command  line for RECEIVING  a  file  would  be
  158.          something like this:
  159.  
  160.          vFAST -P<Port Number> -R
  161.  
  162.          This  assumes  two  things.  First that  you  are  using  the
  163.          internal  serial  driver and second, that vFAST can  use  the
  164.          the CURRENT serial port settings.
  165.  
  166.          Vfast             Technical Reference Manual           Page 4
  167.  
  168.          If you are using a Digiboard, Stargate, or Arnet board or for
  169.          some  reason  vFAST  cannot  use  the  CURRENT  serial   port
  170.          settings, you'll need to use something like this:
  171.  
  172.          vFAST -B<BaudRate> -L<LockRate> -P<Port Number> -R
  173.  
  174.          Assuming  your BBS/Terminal requires batch files  and  passes
  175.          baudrate  in  %1,  port  number in  %2  then  you  might  use
  176.          something like this:
  177.  
  178.          vfast -B%1 -L57600 -P%2 -R
  179.  
  180.          The  minimum  command  line  for  SENDING  a  file  would  be
  181.          something like this:
  182.  
  183.          vFAST -P<Port Number> -S <Ctl Filename>
  184.  
  185.          This  assumes  two  things.  First that  you  are  using  the
  186.          internal  serial  driver and second, that vFAST can  use  the
  187.          the CURRENT serial port settings.
  188.  
  189.          If you are using a Digiboard, Stargate, or Arnet board or for
  190.          some  reason,  vFAST  cannot  use  the  CURRENT  serial  port
  191.          settings, you'll need to use something like this:
  192.  
  193.          vFAST -B<BaudRate> -L<LockRate> -P<Port Number> -S <Ctl Filename>
  194.  
  195.          Notice, and this is VERY important, the space between -S  and
  196.          <Ctl  Filename>. If you forget to put a space there,  nothing
  197.          will happen.
  198.  
  199.          How  you  pass  the parameters will vary  depending  on  your
  200.          terminal  software or bbs software. Check  the  documentation
  201.          that came with your terminal or bbs software for specifics.
  202.  
  203.          Assuming your BBS/Terminal passes baudrate in %1, port number
  204.          in  %2,  and the name of the file in %3, then you  might  use
  205.          something like this:
  206.  
  207.          vfast -B%1 -L57600 -P%2 -S %3
  208.  
  209.              Examples of how to install vfast.exe with Osiris XLT
  210.  
  211.          Example of an Osiris XLT Rcv cmdline:
  212.  
  213.          VFAST -B*B -L*L -N*N -P*P -K -R
  214.  
  215.          Example of an Osiris XLT Send cmdline:
  216.  
  217.          VFAST -B*B -L*L -N*N -P*P -S @*U
  218.  
  219.  
  220.  
  221.          Vfast             Technical Reference Manual           Page 5
  222.  
  223.  
  224.                          Sample Batch Files For BBSes
  225.  
  226.          The  requirements  are clearly outlined above.  If  you  need
  227.          help  installing vfast do not ask us. You should contact  the
  228.          people  that designed your BBS software. We will only  answer
  229.          questions directly related to vFAST itself.
  230.  
  231.                        Getting BATCH transfers to work.
  232.  
  233.          That's  easy, register the program. The shareware version  of
  234.          vFAST will simply NOT do batch transfers.
  235.  
  236.          Again,  the  shareware version of vFAST will *NOT*  do  batch
  237.          transfers.  Only  a REGISTERED copy of vFAST  will  do  batch
  238.          transfers.
  239.  
  240.                                vFAST Order Form
  241.  
  242.          Send $15.00 (US Currency) to:
  243.  
  244.                        International TeleCommunications
  245.                                 302 W. Mckinley
  246.                           Poplar Bluff Mo. 63901-6372
  247.                            United States Of America
  248.  
  249.  
  250.          Register To (___________________________________)
  251.  
  252.  
  253.          A  registration key will be placed on our BBS at  (314)  686-
  254.          0120 in file area #15. The key will be password protected  so
  255.          only YOU can download it. To reach this area, press F at  the
  256.          MAIN  menu. When you reach the file area, press A then  enter
  257.          15 and press RETURN.
  258.  
  259.          What Password do you want to use?   (________)
  260.  
  261.