home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / NBR11.ZIP / README.DOC < prev    next >
Text File  |  1993-02-16  |  28KB  |  760 lines
  1.  
  2.         Readme.Doc for NIC Bridge/Async Version 1.1j
  3.  
  4.         Feb 15 1993
  5.  
  6.  
  7.  
  8.         Copyright (c) Eighth Layer Systems 1990-1993.
  9.         All rights reserved.
  10.  
  11.  
  12.  
  13.  
  14.  
  15.         The <PageUp>, <PageDown>, <Home> and <End> keys may be used to
  16. view this document from within the NicDoc utility.
  17.  
  18.  
  19.  
  20.         This documentation is formatted with 23 line pages. It contains
  21. IBM PC type block graphics characters.
  22.  
  23.  
  24.         ┌──────────────────────┐
  25.         │ Update: Version 1.1j │
  26.         └──────────────────────┘
  27.  
  28.     Version 1.1j of NIC Bridge/Async contains no functional enhancements
  29. over version 1.1i. This release contains only bug fixes for problems
  30. known as of February 15, 1993. These fixes are limited to the NAsync and
  31. NBridge device drivers as detailed below.
  32.  
  33.  
  34.   FIXED BUGS:
  35.  
  36.     NAsync.Os2/O86
  37.         - Direct Port Mode on OS/2 MCA PCs would not work,
  38.           causing a system trap. This has been rectified,
  39.           but the drivers do NOT support shared interrupts.
  40.           Alternate fix: use OS/2 Filesystem Mode.
  41.  
  42.     NAsync.Os2/O86/Dos/D86
  43.         - Some protocols, particularly IBM protocols such as the
  44.           LANDD.SYS component of IBM Communications Manager,
  45.           would not work and/or cause a system trap.
  46.  
  47.  
  48.     NBridge.Os2/O86/Dos/D86
  49.         - In Token Ring Source Routing Mode, communications through
  50.           another Source Routing Bridge would not work if that other
  51.           bridge had a non zero Bridge Number.
  52.         - In Ethernet Transparent Bridge Mode, broadcast filtering
  53.           would not work on networks with more than a moderate level
  54.           of traffic.
  55.  
  56.  
  57.   UNFIXED BUGS:
  58.  
  59.     NBridge.Os2/O86/Dos/D86
  60.         - In Ethernet Transparent Bridge Mode, NBridge may not be
  61.           able to peacefully coexist with some network protocols
  62.           on a shared ethernet adapter. This is most likely to be
  63.           true with NICs which do not support Multiple Data Transfers
  64.           and which use the NDIS ReceiveAhead receive method.
  65.           Workaround: use a dedicated PC or a dedicated Ethernet
  66.           adapter for Ethernet bridging.
  67.         - The Protocol.Ini FILTERBC_MAC parameter has been reported
  68.           to cause error messages on occasion. Workaround: disable
  69.           the parameter with a semicolon (;) or modify Protocol.Ini.
  70.  
  71.   FURTHER RECOMMENDATIONS:
  72.  
  73.     It has been observed that most reasonably sized networks generate
  74.     a great deal of broadcast traffic. This virtually requires that
  75.     broadcast filtering be used for any remote connections. Note that
  76.     broadcast filtering may not work with TCP/IP on Ethernet, however.
  77.     A Token Ring bridge may use the [SRTOK_NIF] SRBC parameter.
  78.  
  79.     Remember to enable broadcast filtering ONLY for local Ethernet or
  80.     Token Ring adapter ports. For example:
  81.  
  82.  
  83.         ; Protocol.Ini fragment:
  84.         ;  Note: example only. NBridge can't bridge Ethernet
  85.         ;   and Token Ring simultaneously.
  86.  
  87.     [NBRIDGE_NIF]
  88.  
  89.       BINDINGS      = "SRTOK_NIF", "ELNKII_NIF, "NASYNC_NIF", "NASYNC_NIF2"
  90.  
  91.       FILTERBC_MAC  = YES, YES, NO, NO, NO, NO, NO, NO, NO
  92.  
  93.  
  94.   DOCUMENTATION CHANGES:
  95.  
  96.     Only this document file, Readme.Doc, has been updated. The
  97.     updates are limited to this section: "Update: Version 1.1j".
  98.  
  99.  
  100.  
  101.   PLANNED ENHANCEMENTS:
  102.  
  103.     Version 1.1j of NIC Bridge/Async has been released to fix some
  104.     known problems, but has not been extensively tested.
  105.  
  106.     It will be followed with a more extensively tested version 1.1k.
  107.  
  108.     This upcoming version 1.1k will support some mechanism to allow
  109.     ethernet broadcast filtering with TCP/IP. This will involve either
  110.     allowing certain broadcast ARP requests to pass the broadcast
  111.     filter or allowing the bridge to generate ARP replies locally.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.   REPORTED COMPATABILITY:
  118.  
  119.     With the fixes contained in version 1.1j of NIC Bridge/Async,
  120.     the following configurations have been reported to work:
  121.  
  122.         - IBM NetBEUI on OS/2.
  123.         - IBM Lan Support Program on DOS.
  124.         - IBM Communications Manager on OS/2.
  125.         - IBM TCP/IP on OS/2.
  126.  
  127.         - Microsoft NetBEUI on OS/2 and DOS.
  128.         - Microsoft TCP/IP on OS/2 and DOS.
  129.  
  130.         - Banyan Vines on OS/2.
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.   SOFTWARE AVAILABILITY:
  141.  
  142.     The NIC Bridge/Async software was previously available as
  143.     Nbr11i.Zip. For version 1.1k and subsequent releases it will
  144.     be available as Nbr11.Zip. Currently the file size is
  145.     approximately 380 KBytes.
  146.  
  147.     NIC Bridge/Async is available on Compuserve in the MSNETWORKS
  148.     forum library 7 (LM/Remote Access) as well as in the OS2DF2 forum
  149.     library 3 (LAN Server).
  150.  
  151.     NIC Bridge/Async is reportedly available via FTP at:
  152.         comlab.gatech.edu   as   /pub/lanman/ndis/NAME
  153.         lanman.gatech.edu   as   /pub/lanman/ndis/NAME
  154.         ftp-os2.nmsu.edu    as   pub/os2/new/NAME
  155.         hobbes.nmsu.edu     as   pub/os2/new/NAME
  156.         comp.binaries.os2   as   UNKNOWN
  157.  
  158.     Where NAME is nbr11i.zip or nbr11.zip.
  159.  
  160.     NIC Bridge/Async is also available on BIX in the LANS section.
  161.  
  162.         ┌────────────────┐
  163.         │ NICDOC UTILITY │
  164.         └────────────────┘
  165.  
  166.         The NicDoc utility can be used to read the documentation provided
  167. with NIC Bridge/Async. Like all NIC Bridge/Async utilities it is a "bound"
  168. application and will run under either DOS or OS/2. It requires less than
  169. 200 KBytes of free memory to run. The error message "SYS2090: The system is
  170. unable to load the program." indicates insufficient free memory.
  171.  
  172.  
  173.         When NicDoc is run it will attempt to load and display the file
  174. Readme.Doc. This file will first be searched for in the directory specified
  175. by the environment variable NICDIR. If this environment variable is not set,
  176. the search defaults to the directory C:\NIC11. If the Readme.Doc file is
  177. not found the current directory is searched and if this fails NicDoc will
  178. terminate with the error message "Error opening README.DOC".
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.         Once the file has been loaded and displayed the <PageUp>, <PageDown>,
  187. <Home> and <End> keys may be used to view the document.
  188.  
  189.         Functions displayed at the bottom of the screen may be selected with
  190. the left and right cursor keys. Pressing <Enter> will select a function.
  191.  
  192.         To advance one page press <PageDown> or select [Next]. To go back one
  193. page press <PageUp> or select [Prev]. Pressing <Home> or <End> sets the view
  194. to the first or last page.
  195.  
  196.         Selecting the [Index] function allows other NIC Bridge/Async document
  197. files to be selected and viewed.
  198.  
  199.         NicDoc may be exited by pressing the <Esc> key or selecting [Exit].
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.         ┌──────────────────────┐
  209.         │ EIGHTH LAYER SYSTEMS │
  210.         └──────────────────────┘
  211.  
  212.         NIC Bridge/Async is brought to you by Eighth Layer Systems in Ottawa,
  213. Ontario, Canada. Eighth Layer Systems is solely owned by Michael A. Reid.
  214.  
  215.         Version 1.1j of NIC Bridge/Async is free of charge subject to the
  216. terms of a license detailed in the LICENSING section below. As no fee is
  217. charged, no support should be expected. I will attempt, however, to respond
  218. to simple questions or bug reports directed to my Compuserve mail address as
  219. time permits.
  220.  
  221.  
  222.         I may be reached at:
  223.  
  224.  
  225. Compuserve:     76236,1403
  226.  
  227. Internet:       76236.1403@CompuServe.COM
  228.  
  229.  
  230.  
  231.         ┌───────────┐
  232.         │ LICENSING │
  233.         └───────────┘
  234.  
  235.         This software, known as NIC Async, NIC Bridge, NIC Bridge/Async, the
  236. related drivers, utilities and documentation are copyrighted by Eighth Layer
  237. Systems. This software is licensed and not sold or given away. All rights are
  238. reserved.
  239.  
  240.         You are granted a cost free perpetual license to use version 1.1j of
  241. this software at your own risk. Eighth Layer Systems assumes no liability for
  242. any damages whatsoever that may arise from the use of this software or any
  243. information contained within.
  244.  
  245.         Version 1.1j of this software may be copied or otherwise distributed
  246. with the following restrictions:
  247.  
  248.         (1) No fee may be charged for the copying or distribution of this
  249.             software in excess of 20 U.S. dollars.
  250.  
  251.         (2) Any fee charged for the copying or distribution of this software
  252.             must be disclosed to the customer specifically as a fee for
  253.             copying or distribution only.
  254.  
  255.         (3) All files provided with this software must remain intact and
  256.             unmodified in any copy or distribution.
  257.  
  258.         (4) This software may not be included with any commercial product
  259.             without the express written permission of Eighth Layer Systems.
  260.  
  261. Failure to comply with any of these restrictions terminates this license.
  262.  
  263.  
  264.         Compliance with export controls on encryption or other technologies
  265. are the responsibility of the exporter.
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.         The 3Com NDIS Protocol Manager version 2.0E and related utilities
  279. are bundled with NIC Bridge/Async for use on standalone PCs. The 3Com NDIS
  280. Protocol Manager and related utilities are Copyright 1988 Through 1991
  281. 3Com Corporation.
  282.  
  283.         The 3Com NDIS Protocol Manager and related utilities may be found in
  284. the PROTMAN directory of the install disk and are copied to the PROTMAN
  285. subdirectory of the target directory when NIC Bridge is installed.
  286.  
  287.         Use of the 3Com software is subject to a license granted by 3Com to
  288. Eighth Layer Systems as reproduced below.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.                 DEVELOPER'S OBJECT CODE LICENSE
  302.  
  303.                 Copyright 1988 Through 1991 3Com Corporation
  304.                         All Rights Reserved
  305.  
  306.         By using this object code and related documentation as defined below,
  307. you are agreeing to the terms and conditions contained in this Developer's
  308. Object Code License ("License").
  309.  
  310. 1.      3Com Adapters Description.      3Com Adapters are the Etherlink and
  311. TokenLink adapters which are identified by the following 3Com product numbers:
  312. 3C501, 3C503, 3C503-16, 3C505, 3C507, 3C523, 3C527, 3C603, 3C605, 3C503-TP,
  313. 3C503-16-TP, 3C507-TP, 3C523-TP and 3C527-TPX, (collectively referred to as
  314. "3Com Adapters").
  315.  
  316. 2.      Licensed Software Description.  The object code and related
  317. documentation to be used exclusively with 3Com adapters is defined as follows:
  318. (i) 3Com Driver and Diagnostic program; (ii) DOS NDIS Utilities which includes
  319. NETBIND.EXE, PROTMAN.EXE, PROTMAN.DOS, PRO.MSG, PROH.MSG, READPRO.EXE and
  320. UNBIND.EXE; and (iii) OS/2 NDIS Utilities which includes NETBIND.EXE,
  321. PROTMAN.OS2, PROTCHK.EXE, READPRO.EXE, UNBIND.EXE and RELOAD.EXE; ("Licensed
  322. Software").
  323.  
  324. 3.      License Grant.  This Licensed Software is being licensed to you to be
  325. used exclusively in conjunction with 3Com Adapters. 3Com and Microsoft
  326. Corporation co-developed the NDIS Utilities, which are incorporated into the
  327. Licensed Software, and therefore, in order to use or distribute the Licensed
  328. Software with any other type of adapters other than the 3Com Adapters, you
  329. must contact Microsoft Corporation directly.
  330.  
  331.         This license grant is a non-exclusive, royalty-free, perpetual license
  332. to use and distribute the unmodified version of the Licensed Software. You may
  333. copy and distribute the unmodified copies of the Licensed Software as you
  334. receive it, in any medium, so long as the Licensed Software is used only with
  335. 3Com Adapters and provided that you: (i) distribute only the latest or most
  336. current version of the Licensed Software; (ii) provide technical support to
  337. the end user or installer of the Licensed Software; (iii) conspicuously and
  338. appropriately publish on each copy a valid copyright notice; (iv) keep intact
  339. the notices on all files that refer to this License and to the absence of any
  340. warranty on the Licensed Software; and (v) give any other recipients of the
  341. Licensed Software a copy of this License along with the Licensed Software.
  342.  
  343.  
  344.  
  345.  
  346.  
  347.         3Com shall have no obligation to you or any third party to provide any
  348. support or maintenance for, or new releases or updates to, the Licensed
  349. Software. Modification, reverse engineering, reverse compiling or disassembly
  350. of the Licensed Software are expressly prohibited. The Licensed Software may
  351. be downloaded from 3Com's Cardboard BBS or Ask3Com Forum on CompuServe.
  352.  
  353. 4.      Limited Warranty and Limitation of Liability.   BECAUSE THIS LICENSED
  354. SOFTWARE IS PROVIDED TO YOU FOR FREE OF CHARGE, 3COM MAKES NO WARRANTIES,
  355. EXPRESS OR IMPLIED IN FACT OR BY OPERATIONS OF LAW, STATUTORY OR OTHERWISE, AS
  356. TO ANY MATTER WHATSOEVER. IN PARTICULAR, 3COM SPECIFICALLY DISCLAIMS ANY AND
  357. ALL WARRANTIES OF MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  358. NONINFRINGEMENT OF THIRD-PARTY RIGHTS.
  359.  
  360.         IN NO EVENT SHALL 3COM BE LIABLE TO YOU OR TO ANY THIRD PARTY FOR ANY
  361. DAMAGES, INCLUDING WITHOUT LIMITATIONS, DIRECT, SPECIAL, INDIRECT,
  362. CONSEQUENTIAL, PUNITIVE OR INCIDENTAL DAMAGES, LOSS OF PROFITS OR REVENUE OR
  363. INTERRUPTION OF BUSINESS IN ANY WAY ARISING OUT OR RELATED TO THIS LICENSE OR
  364. THE LICENSED SOFTWARE (INCLUDING BUT NOT LIMITED TO, ERRORS, OMISSIONS, OR
  365. OTHER PROBLEMS WITH THE LICENSED SOFTWARE) REGARDLESS OF THE FORM OF ACTION,
  366. WHETHER IN CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT PRODUCT LIABILITY OR
  367. OTHERWISE, EVEN IF ANY REPRESENTATIVE OF 3COM HAS BEEN ADVISED OF THE
  368. POSSIBILITY OF SUCH DAMAGES.
  369.  
  370. 5.      General.        You agree not to assign any rights under this License;
  371. any attempted assignment shall be null and void and shall result in the
  372. termination of this License. This License shall be governed by the laws of the
  373. state of California, except for California's conflict of law rules.
  374.  
  375.         This License represents the entire agreement between the parties
  376. regarding the subject matter hereof and supercedes any and all prior or
  377. contemporaneous agreements or understandings, whether written or oral, between
  378. them relating to the subject matter hereof. This License may only be amended
  379. or modified by a writing signed by both parties.
  380.  
  381.  
  382.  
  383.  
  384.  
  385.         END OF 3COM LICENSE AGREEMENT
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.         ┌────────────────────────────────────┐
  393.         │ INSTALLATION/GENERAL CONFIGURATION │
  394.         └────────────────────────────────────┘
  395.  
  396.         There are two main steps required to make use of this software: the
  397. Installation/General Configuration step and the Setup/Main Configuration step.
  398. Any network software needed, such as MS Lan Manager or IBM Lan Server, should
  399. be installed prior to NIC Bridge/Async installation. This allows the automatic
  400. determination of General Configuration parameters.
  401.  
  402.         Installation/General Configuration is performed with the Install.Exe
  403. utility. It creates a general configuration file NIC.CFG, makes modifications
  404. to Config.Sys or Autoexec.bat to add a directory to the system command search
  405. path and set the NICDIR environment variable, and copies files from an install
  406. disk to a target disk. It makes no changes to the network configuration.
  407.  
  408.         Setup/Main Configuration is performed with the MS Lan Manager
  409. Setup.Exe, IBM Lan Server LanInst.Exe, NicSetup.Exe, and/or NicCfg.Exe
  410. utilities. This will create or modify the network configuration after
  411. Installation/General Configuration has been done.
  412.  
  413.  
  414.  
  415.  
  416.         If NIC Bridge/Async was received in a ZIP file format it must first be
  417. decompressed to create an install disk. The command "Pkunzip -d xxx.Zip A:\"
  418. will create an install disk on a floppy in drive A:. This requires a floppy
  419. disk with a capacity of at least 1.2 megabytes.
  420.  
  421.         To initiate Installation and General Configuration insert the install
  422. disk into the A: drive and enter the command "A:\Install". Reboot the PC when
  423. this completes. The command "NicDoc" can be used to read the NIC Bridge/Async
  424. documentation files.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.         ┌──────────┐
  439.         │ PLANNING │
  440.         └──────────┘
  441.  
  442.         The main component of NIC Async is an NDIS adapter driver for serial
  443. ports. It can be used virtually anywhere that an NDIS driver for Ethernet or
  444. Token-Ring adapters can be used. It may be used alone or with NIC Bridge.
  445.  
  446.         A diagram illustrating the use of NIC Async alone is shown below.
  447. This configuration allows a workstation to remotely access a single server.
  448.  
  449.         ┌─────────────┐                      ┌─────────────┐
  450.         │ Workstation │                      │   Server    │
  451.         └─────────────┘                      └─────────────┘
  452.                │                                    │
  453.         ┌─────────────┐                      ┌─────────────┐
  454.         │  NIC Async  │                      │  NIC Async  │
  455.         │ NDIS Driver │                      │ NDIS Driver │
  456.         └─────────────┘                      └─────────────┘
  457.                │                                    │
  458.          ┌───────────┐  Fixed or Dialup Link  ┌───────────┐
  459.          │   Modem   │───────────/ /──────────│   Modem   │
  460.          └───────────┘                        └───────────┘
  461.  
  462.         The main component of NIC Bridge is an NDIS protocol driver. It can
  463. be bound to multiple NDIS adapter drivers and provide bridging between the
  464. adapters. It may be used alone or with NIC Async.
  465.  
  466.         A diagram illustrating the use of NIC Bridge alone is shown below.
  467. This configuration provides local ethernet bridging between two segments.
  468. NIC Bridge can also be used to provide Source Routing Bridging with IBM
  469. Token Ring Adapters.
  470.  
  471.                     ┌───────────────────────────────┐
  472.                     │    NIC Bridge NDIS Protocol   │
  473.                     └───────────────────────────────┘
  474.                           │                  │
  475.                     ┌────────────┐     ┌────────────┐
  476.                     │  Ethernet  │     │  Ethernet  │
  477.                     │ NDIS Driver│     │ NDIS Driver│
  478.                     └────────────┘     └────────────┘
  479.                           │                  │
  480.                     ┌────────────┐     ┌────────────┐
  481.  Ethernet Segment A │  Ethernet  │     │  Ethernet  │ Ethernet Segment B
  482.  ────────//─────────│   Adapter  │     │   Adapter  │────────//─────────
  483.                     └────────────┘     └────────────┘
  484.  
  485.         A diagram illustrating the use of NIC Async and NIC Bridge together
  486. is shown below. This configuration provides remote access to all network
  487. resources. This remote access can be provided to a single user or to multiple
  488. users on another network with the same configuration.
  489.  
  490.         NIC Bridge can also be used to provide remote Source Routing Bridging
  491. with IBM Token Ring Adapters.
  492.  
  493.  
  494.                     ┌───────────────────────────────┐
  495.                     │    NIC Bridge NDIS Protocol   │
  496.                     └───────────────────────────────┘
  497.                           │                  │
  498.                     ┌────────────┐     ┌────────────┐
  499.                     │  NIC Async │     │  Ethernet  │
  500.                     │ NDIS Driver│     │ NDIS Driver│
  501.                     └────────────┘     └────────────┘
  502.                           │                  │
  503. To Remote User or         │            ┌────────────┐
  504. Remote Network      ┌───────────┐      │  Ethernet  │ Local Ethernet Network
  505. ────────//──────────│   Modem   │      │   Adapter  │────────//─────────────
  506.                     └───────────┘      └────────────┘
  507.  
  508.         The configuration possibilities shown in the preceding pages are just
  509. three of those possible. Multiple NIC Async drivers may be loaded on a single
  510. PC to allow multiple simultaneous remote connections. NIC Bridge, a multiple
  511. port bridge, can be used to tie together local networks, remote networks and
  512. remote standalone PCs all at the same time.
  513.  
  514.         For remote access to a single server by a remote PC the NIC Async only
  515. configuration should be considered first. This configuration is relatively
  516. easy to setup and has low resource requirements. It provides remote users
  517. with access to the server on which NIC Async is installed. Other servers and
  518. network resources will not be accessible to remote users, however.
  519.  
  520.         Remote access to multiple network servers requires the use of NIC
  521. Bridge together with NIC Async. This is shown in the configuration on the
  522. preceding page. The Bridge PC may run under DOS or OS/2 and be a standalone
  523. dedicated Bridge PC, a network workstation or a network server. A dedicated
  524. Bridge PC is however, recommended for reasons of performance and simplicity.
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.         NIC Bridge can provide Token Ring Source Routing Bridging with IBM
  532. Token Ring adapters. This requires the use of special NDIS drivers provided
  533. with NIC Bridge. In this release these drivers will work only with NIC Bridge
  534. and cannot be shared by other NDIS protocols. Thus, the installation of NIC
  535. Bridge on a PC which already makes use of an IBM Token Ring adapter will
  536. require the addition of another adapter.
  537.  
  538.         It should also be noted that the use of more than two serial ports
  539. with NIC Async will ususally require the use of a multi-port serial card
  540. under OS/2. The multi-port serial card used must provide OS/2 drivers.
  541.  
  542.         Further information on NIC Async may be found in NAsync.Doc or by
  543. selecting "NIC Async" from the NicDoc Index.
  544.  
  545.         Further information on NIC Bridge may be found in NBridge.Doc or by
  546. selecting "NIC Bridge" from the NicDoc Index.
  547.  
  548.  
  549.         The following pages contain information on NDIS concepts and is
  550. recommended reading for those who are unfamiliar with NDIS.
  551.  
  552.  
  553.         ┌───────────────┐
  554.         │ NDIS CONCEPTS │
  555.         └───────────────┘
  556.  
  557.         NDIS is an acronym for the Network Driver Interface Specification.
  558. It was jointly developed by 3Com and Microsoft and is supported by many
  559. network software vendors and network adapter manufacturers. NDIS is currently
  560. specified for both DOS and OS/2 and will soon include Windows NT.
  561.  
  562.         NDIS provides a published software interface between network protocol
  563. software and network adapter drivers, also known as MAC drivers. The interface
  564. is largely equivalent to the interface between the Data Link and Network
  565. layers of the OSI reference model. The position of the NDIS interface relative
  566. to the OSI reference model is illustrated on the following page.
  567.  
  568.         The introduction of published network adapter interface specifications
  569. such as NDIS is a major advance over prior proprietary interfaces. It allows
  570. the development of network protocol software which runs on a wide range of
  571. hardware and the development of network adapter drivers which work with a wide
  572. variety of network protocols. It also makes feasible the development of
  573. independent network software such as NIC Bridge and NIC Async.
  574.  
  575.  
  576.  
  577.         OSI Reference Model
  578.  
  579.         ┌──────────────┐   ────────────────────────────
  580.         │ Application  │
  581.         ├──────────────┤
  582.         │ Presentation │         NETWORK SOFTWARE
  583.         ├──────────────┤
  584.         │   Session    │   ────────────────────────────
  585.         ├──────────────┤
  586.         │  Transport   │
  587.         ├──────────────┤
  588.         │   Network    │         NDIS PROTOCOLS
  589.         ├──────────────┤   ────────────────────────────   <- NDIS INTERFACE
  590.         │  Data Link   │         NDIS MAC DRIVERS
  591.         ├──────────────┤   ────────────────────────────
  592.         │   Physical   │         ADAPTERS & CABLING
  593.         └──────────────┘   ────────────────────────────
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.         The main component of NDIS is the Protocol Manager. The Protocol
  601. Manager is implemented as a device driver, usually named Protman.Dos or
  602. Protman.Os2. This device driver must be loaded before any NDIS protocols
  603. or MAC drivers.
  604.  
  605.         When the Protocol Manager loads it will read and process protocol and
  606. MAC driver configuration data from a Protocol.Ini file. This configuration
  607. data is made available to NDIS protocols and MAC drivers when they load and
  608. register with the Protocol Manager.
  609.  
  610.         The Config.Sys fragment shown below is typical for IBM Lan Server. The
  611. Protocol Manager is loaded first, followed by the NDIS protocol NetBEUI and
  612. the NDIS MAC driver IBMTOK for an IBM Token Ring adapter. The "/I:C:\IBMCOM"
  613. parameter to the Protocol Manager specifies that the Protocol.Ini file can be
  614. found in the directory C:\IBMCOM.
  615.  
  616.  
  617.     Config.Sys fragment:
  618.  
  619.         DEVICE = C:\IBMCOM\PROTMAN.OS2 /I:C:\IBMCOM
  620.         DEVICE = C:\IBMCOM\PROTOCOL\NETBEUI.OS2
  621.         DEVICE = C:\IBMCOM\MACS\IBMTOK.OS2
  622.  
  623.         The Protocol.Ini file is an ASCII text file consisting of a number of
  624. named sections. The section names are enclosed in square brackets. The example
  625. Protocol.Ini fragment shown below is typical for IBM Lan Server. Note the
  626. BINDINGS parameter for NetBEUI. This specifies that NetBEUI will control or
  627. "Bind" to one MAC driver, the IBM Token Ring adapter driver.
  628.  
  629.  
  630.         Protocol.Ini fragment:
  631.  
  632.         [PROT_MAN]
  633.          DRIVERNAME = PROTMAN$
  634.  
  635.         [NETBEUI_NIF]
  636.          DRIVERNAME = NETBEUI$
  637.          BINDINGS   = IBMTOK_NIF
  638.          ;.... Other parameters
  639.  
  640.         [IBMTOK_NIF]
  641.          DRIVERNAME = IBMTOK$
  642.          ;.... Other parameters
  643.  
  644.  
  645.  
  646.         NDIS protocols must be bound to their MAC drivers in order to transmit
  647. and receive network packets. This binding can be initiated with the NDIS
  648. NetBind.Exe utility. IBM OS/2 Lan Server includes the following line in
  649. Config.Sys to initiate this binding.
  650.  
  651.         RUN = C:\IBMCOM\PROTOCOL\NETBIND.EXE
  652.  
  653.  
  654.        This binding can also take place when the OS/2 Netwksta IFS loads. MS
  655. OS/2 Lan Manager includes the following line in Config.Sys.
  656.  
  657.         IFS = C:\LANMAN\NETPROG\NETWKSTA.SYS /I:C:\LANMAN
  658.  
  659.  
  660.  
  661.         IBM OS/2 Lan Server includes the following IFS line in Config.Sys. The
  662. /N parameter disables the binding action of Netwksta.
  663.  
  664.  
  665.         IFS = C:\IBMLAN\NETPROG\NETWKSTA.200 /I:C:\IBMLAN /N
  666.  
  667.  
  668.  
  669.         The examples above show one protocol, NetBEUI, binding to one MAC
  670. driver, the IBM Token Ring adapter driver. This is the simplest case and is
  671. illustrated in the diagram below.
  672.  
  673.  
  674.  
  675.    NetBEUI Protocol driver
  676.  
  677.         ┌──────────┐
  678.         │ NetBEUI  │
  679.         └──────────┘
  680.              |         <- NDIS Interface
  681.         ┌──────────┐
  682.         │  IBMTOK  │
  683.         └──────────┘
  684.  
  685.    IBM Token Ring driver
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.         NDIS allows more complex configurations where multiple protocols may
  693. share and bind to multiple MAC drivers. Shown below is an illustration of a
  694. complex configuration. NetBEUI is bound to both an IBM Token Ring adapter
  695. driver and a 3Com Etherlink II adapter driver. NetBEUI and TCP/IP share the
  696. Etherlink II driver. This sharing is facilitated by the Protocol Manager and
  697. is transparent to all drivers.
  698.  
  699.  
  700.  
  701. NetBEUI Protocol driver    TCP/IP Protocol driver
  702.  
  703.         ┌──────────┐     ┌──────────┐
  704.         │ NetBEUI  │     │  TCP/IP  │
  705.         └──────────┘     └──────────┘
  706.             |       \          |
  707.             |         \        |
  708.             |           \      |
  709.         ┌──────────┐     ┌──────────┐
  710.         │  IBMTOK  │     │  ELNKII  │
  711.         └──────────┘     └──────────┘
  712.  
  713. IBM Token Ring driver    3Com Etherlink II driver
  714.  
  715.         A Protocol.Ini fragment for the complex configuration above is shown
  716. below. Note the BINDINGS parameter for NetBEUI. This specifies that NetBEUI
  717. will control or "Bind" to two MAC drivers: the IBM Token Ring adapter driver
  718. and the 3Com Etherlink II adapter driver. The TCP/IP protocol is bound to just
  719. one MAC driver: the 3Com Etherlink II adapter driver.
  720.  
  721.         Protocol.Ini fragment:
  722.  
  723.         [NETBEUI_NIF]
  724.          DRIVERNAME = NETBEUI$
  725.          BINDINGS   = IBMTOK_NIF, ELNKII_NIF
  726.  
  727.         [TCPIP_NIF]
  728.          DRIVERNAME = TCPIP$
  729.          BINDINGS   = ELNKII_NIF
  730.  
  731.         [IBMTOK_NIF]
  732.          DRIVERNAME = IBMTOK$
  733.  
  734.         [ELNKII_NIF]
  735.          DRIVERNAME = ELNKII$
  736.  
  737.         ┌──────────────────┐
  738.         │ ACKNOWLEDGEMENTS │
  739.         └──────────────────┘
  740.  
  741.         All trademarks are the property of their owners.
  742.  
  743.         This includes, but is not limited to, the trademarks
  744.         of 3Com, IBM, Microsoft, and Hayes.
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759. ;
  760.