home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / msk314.pkz / NETWORKS / ODIPKT.DOC < prev    next >
Text File  |  1994-09-29  |  6KB  |  129 lines
  1. File ODIPKT.DOC
  2.  
  3. NAME
  4.      ODIPKT
  5.      Translate Open Data-Link Interface to Packet Driver interface.
  6.  
  7. SYNOPSIS
  8.      ODIPKT [ logical_board [ vector ] ]
  9.      ODIPKTpn [ logical_board [ vector ] ]
  10.  
  11. DESCRIPTION
  12.      ODIPKT provides a Packet Driver API over Novell's Open Data-Link
  13.      Interface (ODI), allowing a single network adapter to service IPX,
  14.      TCP/IP, and other protocol stacks which use packet drivers.  ODIPKT
  15.      understands Ethernet, Token Ring, and ARCnet frame types.  Ethernet and
  16.      Token Ring frames are passed unchanged to packet driver applications, but
  17.      ARCnet frames are internally mapped to Ethernet.  Thus, packet driver
  18.      applications do not need specific knowledge of ARCnet in order to operate
  19.      in such environments.
  20.  
  21.      The logical_board argument indicates which logical adapter ODIPKT should
  22.      bind to.  Under ODI, there is one logical adapter per frame type.  There
  23.      may be multiple physical adapters, and multiple frame types per physical
  24.      adapter.  The logical adapter number starts at zero and increases by one
  25.      for each frame type.  For example, if a system contained two physical
  26.      adapters with two frame types each, there would be four logical adapters
  27.      numbered 0-3.  The frame types are specified in the NET.CFG file which
  28.      must be in the current directory (or on the APPEND path) when the ODI
  29.      drivers are loaded.
  30.  
  31.      Typically, the frame type used by default by Netware on a given adapter
  32.      will not be appropriate for TCP/IP.  The correct frame type for TCP/IP on
  33.      Token Ring is TOKEN-RING_SNAP and the correct frame type for TCP/IP on
  34.      Ethernet is almost always ETHERNET_II.  Assuming an existing installation
  35.      with one adapter running the default Netware frame type, it will usually
  36.      be necessary to define a second frame type (as listed above) and to
  37.      specify the logical_board argument as 1.  An exception to this rule is
  38.      ARCnet which uses only one frame type.  Below is a NET.CFG entry for a
  39.      3c501 using the default address and interrupt.  Other Ethernet adapters
  40.      would use similar configurations:
  41.  
  42.      Link driver 3c501
  43.           envelope type ETHERNET_802.3
  44.           envelope type ETHERNET_II
  45.  
  46.      Given the above entry, the logical_board argument of ODIPKT would be 1.
  47.      Token Ring uses different frame types:
  48.  
  49.      Link driver token
  50.           envelope type TOKEN-RING
  51.           envelope type TOKEN-RING_SNAP
  52.  
  53.      Again, the logical_board should be specified as 1 for this nexample.
  54.      ARCnet installations require no frame-type definitions and should use a
  55.      logical_board of 0.
  56.  
  57.      Because ODIPKT.COM uses buffers provided by the Link Support Layer, the
  58.      Link support section of NET.CFG must specify at least one buffer of a
  59.      size appropriate to the medium in use.  Some adapters require more
  60.      buffers for optimal performance, e.g., the 3c503 can use at least five
  61.      during reception of back-to-back packets.  The following lines configure
  62.      five buffers large enough for Ethernet:
  63.  
  64.      Link support
  65.           Buffers 5 1600
  66.  
  67.      The correct buffer size for Token Ring will vary depending on the
  68.      installation.  Specifying too small a buffer size will result in
  69.      unpredictable behavior.
  70.  
  71.      Vector is the packet driver interrupt at which to provide service.  The
  72.      default is 105 and the parameter is decimal.
  73.  
  74.      ODIPKT.COM should be loaded after lsl.com and the adapter-specific
  75.      driver(s).  It must, of course, be loaded before the packet driver
  76.      applications which use it.  The Netware shell and ipxodi.com can be
  77.      loaded before or after the ODIPKT.COM program.
  78.  
  79.      ODIPKTPN.COM supports an older version of the ODI specification as used
  80.      in Farallon's PhoneNET Talk product.  Operation of ODIPKTPN.COM is
  81.      identical to that of ODIPKT.COM but configuration of NET.CFG is somewhat
  82.      different: no ``envelope'' statements are required or allowed.  Because
  83.      multiple frame types are not supported, ODIPKTPN.COM treats all Ethernet
  84.      cards as ETHERNET_II.
  85.  
  86. AUTHOR
  87.      Dan Lanciani
  88.      185 Atlantic Road
  89.      Gloucester, MA 01930
  90.  
  91. The following copyright notice appears in the ODIPKT.ASM source file:
  92.  
  93. ; ODIPKT.ASM - Adapter provides Packet Driver interface over ODI
  94. ;
  95. ; (c) Copyright Daniel D. Lanciani 1991-1994.  All rights reserved.
  96. ;
  97. ; This unmodified source file and its executable form may be used and
  98. ; redistributed freely.  The source may be modified, and the source or
  99. ; executable versions built from the modified source may be used and
  100. ; redistributed, provided that this notice and the copyright displayed by
  101. ; the exectuable remain intact, and provided that the executable displays
  102. ; an additional message indicating that it has been modified, and by whom.
  103. ;
  104. ; Daniel D. Lanciani releases this software "as is", with no express or
  105. ; implied warranty, including, but not limited to, the implied warranties
  106. ; of merchantability and fitness for a particular purpose.
  107. ;
  108. ; Please send bug reports to:
  109. ; Dan Lanciani
  110. ; 185 Atlantic Road
  111. ; Gloucester, MA  01930
  112. ; USA
  113. ; Voice: +1 508 283-4974
  114. ; Email: ddl@harvard.harvard.edu (Internet)
  115.  
  116. USING ODIPKT WITH MS-DOS KERMIT
  117.  
  118. ODIPKT is normally not needed, since MS-DOS Kermit 3.13 and later includes
  119. its own ODI interface, and can run on top of your network board's ODI driver.
  120.  
  121. Under Microsoft Windows, however, unless Kermit is "locked in memory", Windows
  122. will move it around causing system crashes (or worse) when the ODI driver
  123. goes to write incoming data into Kermit's memory space (this is not a Kermit
  124. problem -- it would happen with any network application).  Therefore we need
  125. to run Kermit over the WINPKT "shim".  But WINPKT goes over a packet driver,
  126. not an ODI driver.  That's where ODIPKT comes in -- it makes the ODI driver
  127. look like a packet driver to WINPKT, which, in turn feeds packets to Kermit.
  128.  
  129.