home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / GENUTIL / NTF100.ZIP / NTFOSS.DOC < prev    next >
Text File  |  1997-05-23  |  9KB  |  223 lines
  1.  
  2.     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓
  3.     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓
  4.     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓
  5.     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓     ░NTFOSS▓
  6.  
  7.      (c) 1995-1997 by Gerhard Wiesinger
  8.  
  9.      For license information see LICENSE.DOC, for register see REGISTER.DOC.
  10.  
  11.  
  12.   1) What is NTFOSS?
  13.   ------------------
  14.      NTFOSS is a driver to support FOSSIL based applications under the Windows
  15.      NT operating system. Some sort of applications are: terminal programs,
  16.      BBS systems and fidonet mailer.
  17.      In most of all cases it will be used for FIDOnet compatible software.
  18.    
  19.      Some technical aspects:
  20.  
  21.      NTFOSS is a virtual device driver (VDD) for the Windows NT operating
  22.      system. It will redirect all FOSSIL calls made with INT 14 to
  23.      NTFOSS.DLL which calls the WIN32 API to virtualize the serial port.
  24.  
  25.   2) How to install it
  26.   --------------------
  27.      1) Log on with Administrator privileges
  28.      2) Copy NTFOSS.DLL to %SystemRoot%\SYSTEM32 (usually C:\WINNT\SYSTEM32)
  29.      3) Copy NTFOSS.COM to a directory of your choice. (Maybe a directory
  30.         included in your PATH).
  31.      4) Copy the DEMO Key (NTFOSS.KEY) and the registration program 
  32.         (REGISTER.EXE) included in the archive into the SAME directory of your
  33.         choice. Make sure you are logged on with Administrator privileges.
  34.         Then start REGISTER.EXE. You will be asked, if you are logged on as
  35.         Administrator or equivalent. If that's true, answer with 'Y' else
  36.         answer with 'N'. If you answered yes a message with
  37.         "successfully installed" should appear.
  38.         If you have registered NTFOSS you will receive a branded keyfile called
  39.         'serialnr.KEY', with your own serial number and registration
  40.         information. e.g. for serial number 1 the keyfile will be named
  41.         '1.KEY'. Rename this file to 'NTFOSS.KEY' and then you
  42.         have once again start REGISTER.EXE with the renamed ** NEW keyfile **
  43.         in the directory !!
  44.      5) Start Control Panel, select Ports, then the port you want to configure,
  45.         press the Settings button and modify the parameters you want.
  46.         If you have a FIFO (16550 or something like that) then press the
  47.         Advanced button and enable 'FIFO enabled'.
  48.      6) If you have a FIFO start FIFOREG.EXE.
  49.         This will install or modify the registry to ensure full performance:
  50.         FIFOREG.EXE will modify or add the following keys to the registry:
  51.         HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Serial,
  52.           RxFIFO(REG_DWORD)=0xe
  53.           TxFIFO(REG_DWORD)=0xe
  54.           ForceFifoEnable(REG_DWORD)=0x1
  55.         This will enable the FIFOs for receive and transmit.
  56.  
  57.         ***************************************************************
  58.         NOW YOU HAVE TO REBOOT YOUR MACHINE TO ACTIVATE THESE SETTINGS!
  59.         ***************************************************************
  60.  
  61.      7) I recommend that the multitasking is equivalent to all applications.
  62.         (Control Panel, System, Tasking, Equally Responsive)
  63.      8) Try to start 'NTFOSS COMx' where x is the comport you want to install
  64.         the FOSSIL driver.
  65.         For installing NTFOSS with your application have a look at
  66.         "SAMPLE.BAT", the FAQs (FAQ.DOC) and the manual of your application.
  67.      9) ***************************************************************
  68.         If your application requires ANSI-output an ANSI driver must be
  69.         installed. (e.g. for Binkley Term)
  70.         A removeable ansi driver from PC-Magazine can be found
  71.         on the SIMTEL 20 Mirror (/pcmag/ansi132.zip) or on internet
  72.         http://stud1.tuwien.ac.at/~e9125884/NTFOSS/ansi132.zip.
  73.         At fidonet request Magic "ANSI" at 2:310/500.
  74.         See also SAMPLE.BAT.
  75.         ***************************************************************
  76.     10) VFOSSIL is required for some applications. (e.g. Binkley Term)
  77.         A VFOSSIL compatible driver can be found on
  78.         http://stud1.tuwien.ac.at/~e9125884/NTFOSS/vfoss.zip.
  79.         At fidonet request Magic "VFOSS" at 2:310/500.
  80.         See also SAMPLE.BAT.
  81.  
  82.   3) How to use it
  83.   ----------------
  84.     INSTALL:
  85.       NTFOSS [/a auto] [/s sleep] [/t transbuff] [/r recbuff] [/l lock] COMx [mode]
  86.        auto: 1 ... will enable delays to keep CPU-Time low (default)
  87.              0 ... disable heuristic detection of Idle Time
  88.              IF YOU HAVE TROUBLES WITH NTFOSS TRY TO DISABLE AUTO!!!
  89.        sleep: 1 ... enables avoiding of excessive status polling, 0 disables it
  90.              IF YOU HAVE TROUBLES WITH NTFOSS UNDER NT 4.0 TRY TO DISABLE SLEEP!!!
  91.        transbuff:is the size of the transmitbuffer (default:512)
  92.        recbuff:  is the size of the receivebuffer (default:512)
  93.                  valid buffersizes are 512,1024,..,10240 (increment 512)
  94.        lock: 1 ... serial port will be locked, 0 ...  NO locking (default)
  95.        x: Specifies the comport where NTFOSS should be installed
  96.           The captured Fossilport will be x-1.
  97.        mode: Specifies parameters for the comport (see MODE or
  98.              Windows NT help for more information)
  99.     MODIFY PARAMETERS:
  100.        same as INSTALL, but parameters will be modified. /t and /r will be ignored.
  101.        Com-Parameters will not be modified, except there is some mode specified.
  102.     UNINSTALL:
  103.        NTFOSS /u               uninstall resident NTFOSS
  104.     This HELP MESSAGE will be displayed if NTFOSS is called with no parameters
  105.  
  106.  
  107.     NTFOSS can only once be installed in one VDM (Virtual Dos Machine) and
  108.     only one COM-port can be captured. But in another VDM NTFOSS can be
  109.     installed, if there are enough licenses available.
  110.  
  111.  
  112.     With 'mode' the following options are supported:
  113.     ------------------------------------------------
  114.       [baud=b] [parity=p] [data=d] [stop=s] [to=on|off] [xon=on|off]
  115.       [odsr=on|off] [octs=on|off] [dtr=on|off|hs] [rts=on|off|hs|tg]
  116.       [idsr=on|off]
  117.  
  118.      baud=b
  119.      ------
  120.      Specifies the transmission rate in bits per second.
  121.      The following list shows valid abbreviations for b and its related rate:
  122.  
  123.        11   110 baud 
  124.        15   150 baud 
  125.        30   300 baud 
  126.        60   600 baud
  127.        12   1200 baud 
  128.        24   2400 baud 
  129.        48   4800 baud
  130.        96   9600 baud 
  131.        19   19200 baud
  132.  
  133.      The rest of the baudrates must be fully written,
  134.      e.g. 115200 for 115200 Baud.
  135.  
  136.      parity=p
  137.      --------
  138.      Specifies how the system uses the parity bit to check for
  139.      transmission errors. The p value can be one of the following:
  140.      n (none) (default), e (even), o (odd), m (mark), or s (space). 
  141.      Not all computers support the values m and s.  
  142.  
  143.      data=d
  144.      ------
  145.      Specifies the number of data bits in a character.
  146.      Valid values for d are in the range 5 through 8.
  147.      The default value is 8. Not all computers support the values 5 and 6.
  148.  
  149.      stop=s
  150.      ------
  151.      Specifies the number of stop bits that define the end of a character:
  152.      1 (default), 1.5, or 2.
  153.      Not all computers support the value 1.5. 
  154.  
  155.      to=on|off
  156.      ---------
  157.      Specifies whether infinite time-out processing is on or off.
  158.      The default is on.
  159.  
  160.      xon=on|off
  161.      ----------
  162.      Specifies whether the xon or xoff protocol for data-flow control is on
  163.      or off. The default in off.
  164.  
  165.      odsr=on|off
  166.      -----------
  167.      Specifies whether output handshaking that uses the Data Set Ready (DSR)
  168.      circuit is on or off. The default is off.
  169.  
  170.      octs=on|off
  171.      -----------
  172.      Specifies whether output handshaking that uses the Clear To Send (CTS)
  173.      circuit is on or off. The default is on.
  174.  
  175.      dtr=on|off
  176.      ----------
  177.      Specifes whether the DTR circuit is on or off. The default is off.
  178.  
  179.      rts=on|off|hs|tg
  180.      ----------------
  181.      Specifies whether the RTS circuit is set to on, off, handshake, or toggle.
  182.      The default is handshake.
  183.  
  184.      idsr=on|off
  185.      -----------
  186.      Specifies whether the DSR circuit sensitivity is on or off.
  187.      The default is off.
  188.  
  189.   4) Bugs
  190.   -------
  191.      For further development of this piece of software write bug reports
  192.      or any other question to the author.
  193.  
  194.      Any suggestions are also welcome!
  195.  
  196.      Thank you for your reply!
  197.  
  198.  
  199.   A) The latest version
  200.   ---------------------
  201.      can be obtained from:
  202.  
  203.        FIDONET:  2:310/500@fidonet, MAGIC: NTFOSS
  204.        SCOUTNET: 71:431/100@scoutnet, MAGIC: NTFOSS
  205.        INTERNET: http://stud1.tuwien.ac.at/~e9125884/NTFOSS/
  206.  
  207.   B) The Author
  208.   -------------
  209.      The author can be contacted through:
  210.  
  211.        FIDONET:  2:310/500.3@fidonet
  212.        SCOUTNET: 71:431/100.3@scoutnet
  213.        INTERNET: e9125884@student.tuwien.ac.at (prefered contact address)
  214.  
  215.      For the registration sites and support sites look at REGISTER.DOC for
  216.      more information.
  217.  
  218.      NTFOSS has been written with the WIN32 SDK for Windows NT 3.1 (including
  219.      Microsoft C 8.x), the WIN32 DDK for Windows NT 3.1 and Borlands Turbo
  220.      Assembler 2.0.
  221.  
  222.    I hope you like NTFOSS!
  223.