home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 April / Chip_2004-04_cd1.bin / tema / arachne / archn170.exe / SYSTEM / PKTDRVRS / ODIPKT.TXT < prev    next >
Encoding:
Text File  |  1999-04-21  |  4.2 KB  |  101 lines
  1. ODIPKT.TXT  "March 3, 1992"
  2.  
  3. odipkt: translate Open Data-Link Interface to Packet Driver interface
  4. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5. SYNOPSIS
  6.  odipkt [ <logical_board> [ <vector> ] ]
  7.  odipktpn [ <logical_board> [ <vector> ] ]
  8.  
  9. DESCRIPTION
  10. Odipkt.com provides a Packet Driver API over Novell's Open Data-Link
  11. Interface, allowing a single network adapter to service IPX, tcp/ip,
  12. and other protocol stacks which use packet drivers. Odipkt.com
  13. understands Ethernet, Token Ring, and ARCnet frame types.  Ethernet and
  14. Token Ring frames are passed unchanged to packet driver applications,
  15. but ARCnet frames are internally mapped to Ethernet.  Thus, packet
  16. driver applications do not need specific knowledge of ARCnet in order
  17. to operate in such environments.
  18.  
  19. The <logical_board> argument indicates which logical adapter odipkt
  20. should bind to.  Under ODI, there is one logical adapter per frame
  21. type.  There may be multiple physical adapters, and multiple frame
  22. types per physical adapter.  The logical adapter number starts at
  23. zero and increases by one for each frame type.  For example, if
  24. a system contained two physical adapters with two frame types
  25. each, there would be four logical adapters numbered 0-3.  The
  26. frame types are specified in the NET.CFG file which must be in the
  27. current directory (or on the APPEND path) when the ODI drivers are
  28. loaded.
  29.  
  30. Typically, the frame type used by default by Netware on a given
  31. adapter will not be appropriate for tcp/ip.  The correct frame type
  32. for tcp/ip on Token Ring is TOKEN-RING_SNAP and the correct frame
  33. type for tcp/ip on Ethernet is almost always ETHERNET_II.  Assuming
  34. an existing installation with one adapter running the default Netware
  35. frame type, it will usually be necessary to define a second frame
  36. type (as listed above) and to specify the <logical_board> argument as
  37. 1.  An exception to this rule is ARCnet which uses only one frame
  38. type.  Below is a NET.CFG entry for a 3c501 using the default address
  39. and interrupt.  Other Ethernet adapters would use similar
  40. 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 oipkt 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 example.  
  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.  
  72. The default is 105 and the parameter is decimal.
  73.  
  74. Odipkt.com should be loaded after lsl.com and the adapter-specific driver(s).
  75. It must, of course, be loaded before the packet driver applications
  76. which use it.  The Netware shell and ipxodi.com can be loaded before
  77. or after the odipkt.com program.
  78.  
  79. Odipktpn.com supports an older version of the ODI specification as used in
  80. Farallon's PhoneNET Talk product.  Operation of opipktpn.com is identical 
  81. to that of opipkt.com but configuration of NET.CFG is somewhat different:  
  82. 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.  
  92. Note that documentation is provided in troff format in the
  93. file odipkt.8 which I have stripped to ASCII in odipkt.txt.
  94. All the original files are at http://www.danlan.com
  95.  
  96. To unload (terminate) ODIPKT, use the little termin.com program 
  97. from the x-Clarkson collection. (Get pktd11.zip or later.)
  98.  
  99.  
  100. Ferdi Louw.
  101.