home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / packetdrivers.tar.gz / pd.tar / new / pktdll.doc < prev    next >
Text File  |  1993-09-11  |  7KB  |  157 lines
  1. PKTDLL v1.2
  2. ~~~~~~~~~~~
  3. PKTDLL provides a Packet Driver interface over Digital Equipment Corp.'s
  4. Datalink (DLL) specification drivers.  This is a small TSR shim which
  5. translates application Packet Driver calls into appropriate DLL calls.
  6. PKTDLL should work over any of the current v4.1 DLL and earlier drivers
  7. (DLLDEPCA, DLLNDIS, etc.), making it a simple matter to add Packet Driver
  8. applications to an existing PATHWORKS network environment (v5.0 should
  9. most likely work as well - except for Novell 802.3 support - see below).
  10. Simply add a line with "PKTDLL" into your AUTOEXEC.BAT after the commands
  11. to start the network.  If you feel really adventurous you could even
  12. "LOADHIGH PKTDLL" (it works fine!).
  13.  
  14. PKTDLL was renamed from DLLPKT to be consistent with the naming conventions
  15. used within Digital Equipment Corporation and the left to right reading
  16. habits of the western world.  If you feel stubborn about this issue, DOS
  17. does have a file renaming command.
  18.  
  19. I have not included support for any advanced functionality such as
  20. multicast and promiscuous mode.  If there are significant grumblings, I
  21. will re-examine these issues, however, I really don't see the need.  This
  22. extra functionality is better served by existing utilities which deal
  23. directly with the DLL.
  24.  
  25. There is an assumption that the DECnet flavour of PATHWORKS is being used.
  26. Having two different TCP/IP stacks simultaneously on a single machine would
  27. be somewhat strange (perhaps it would be ok with multiple network cards).
  28. Also, PKTDLL is currently setup as a Class 1 Packet Driver (ethernet).  I
  29. will soon be examining the changes required to support Token Ring.  I have
  30. also made this a so called high performance Packer Driver, but there has
  31. been a minimum of testing with the high performance functions.  This may
  32. sound somewhat tentative, however, I have been using the driver regularly
  33. for quite some time and have found no problems.
  34.  
  35. If you have the desire to modify this code or find items needing repair,
  36. please send me your requests and/or updates.  I am closer to DEC's
  37. engineering group and should be able to ensure that PKTDLL functions
  38. according to the DLL specification, hopefully keeping so called quality at
  39. a high level.  Please also forward any other comments to me.  I am quite
  40. interested in how people may be using this driver.
  41.  
  42. As with any other packet driver, to use most network applications within
  43. MS Windows, one must employ the services of WINPKT or PKTMUX.
  44.  
  45. The following packages have been successfully tested with PKTDLL:
  46. WATTCP                          NCSA Telnet
  47. KA9Q                            CUTCP
  48. Kermit                          QVTNET
  49. Trumpet - News Reader           PDIPX from Intel
  50. Trumpet - TCPDRV                IPX from BYU
  51. PKTMUX                          WINPKT
  52.  
  53.  
  54. New in PKTDLL 1.2:
  55. ~~~~~~~~~~~~~~~~~~
  56. 1)      Specifying a protocol type of "0" as the first protocol type on
  57.     the command line will stop any protocols from being held open for
  58.     Windows.  This should not be necessary in most circumstances, as
  59.     the protocols are always available to DOS applications.  There may
  60.     be a very tiny performance gain.
  61.  
  62. 2)      Specifying "/s" on the command line will stop all upcalls from
  63.     PKTDLL (similar to "TERMIN/S").  This combined with a MARK/RELEASE
  64.     type program will safely allow the unloading of a normally non-
  65.     unloadable packet driver based program (eg. IPX).  This can and
  66.     will ungracefully mess up any running packet driver applications
  67.     (ie. not recommended except for very specific uses).
  68.  
  69. 3)      The command line parsing is somewhat more freeform, though the
  70.     switches must still be at the end of the line.  The order of the
  71.     numbers is less important and the vector does not have to be
  72.     specified in order to change the protocol types anymore.
  73.  
  74. 4)      A problem with Novell 802.3 support over v4.1 DLLDEPCA has been
  75.     fixed.  Novell 802.3 packets have now been successfully tested
  76.     over DLLDEPCA and DLLNDIS (still no progress on v5.0 DLL support).
  77.  
  78.     Thanks for feedback to David Denholm.
  79.  
  80.  
  81. Usage:                  PKTDLL [packet_int] [proto_type...] [/n] [/s] [/u]
  82. ~~~~~~
  83.  
  84. packet_int      -       This is the Packet Driver interrupt to use.  The
  85.             default interrupt is 61 HEX.  The number will be
  86.             interpreted as hexadecimal whether or not it is
  87.             prefixed by "0x".  This same rule applies to the
  88.             protocol type following.
  89.  
  90.             range: 60 - 7F
  91.  
  92. proto_type      -       This is a list of protocol types to hold open for
  93.             Windows access.  The DLL must have any protocols
  94.             which it will use in Windows opened prior to
  95.             entering Windows.  The protocols in this list will 
  96.             be opened and held in limbo until accessed by an
  97.             application.  There is no such restriction on Packet
  98.             Driver applications outside of Windows.
  99.  
  100.             The default is to open protocols 0800, 0806, and
  101.             8035 (IP, ARP, and RARP).  This list may replaced
  102.             by a list of your own choosing.  Be aware that the
  103.             DLL only supports 8 portals, several of which are
  104.             often used by PATHWORKS.  MOP and LoopBack are
  105.             temporarily disabled when PKTDLL is loaded but are
  106.             restored on exiting PKTDLL.  A value of 0 will
  107.             disable this feature.
  108.  
  109.             range: 0 or 05EF - FFFE
  110.  
  111. /n              -       "/n" will select 802.3 framing for Novell's IPX.
  112.             Most public domain IPX stacks use Novell's 8137
  113.             DIX protocol type.  This will convert these packets
  114.             to 802.3 on the wire.  This functionality will not
  115.             work with the new PATHWORKS V5.x DLL drivers being
  116.             developed - ie. only DIX will be supported (the API
  117.             is changing and I am feeling very lazy).
  118.  
  119. /s              -       "/s" will stop all upcalls from PKTDLL, allowing
  120.             a MARK/RELEASE type program to safely unload a
  121.             non-unloadable program like IPX.  PKTDLL remains
  122.             in memory and available for use.
  123.  
  124. /u              -       "/u" will unload the driver releasing both its
  125.             memory and it reserved protocols, provided there
  126.             are none in use.  If an alternate interrupt has
  127.             been chosen, it must be specified when unloading
  128.             the driver.
  129.  
  130.  
  131. Examples:               PKTDLL
  132.  
  133.             Loads the Packet Driver at interrupt 61 with protocols
  134.             IP, ARP and RARP active for Windows.
  135.  
  136.             PKTDLL 61 7301 7302 /n
  137.             WINPKT 0x60 0x61
  138.  
  139.             Loads the Packet Driver at Interrupt 61 with protocols
  140.             7301 and 7302 (just made them up!) active for Windows.
  141.             Also, protocol 8137 will be converted to 802.3.
  142.             The WINPKT line is necessary to run most packet driver
  143.             applications within Windows.  If you feel adventurous
  144.             try PKTMUX v1.2c (it actually works).
  145.  
  146.             PKTDLL 60 /u
  147.  
  148.             Unloads the Packer Driver loaded at interrupt 60.
  149.  
  150.  
  151. Have Fun,
  152.  
  153. Brian Angus
  154.  
  155. angus@trcoa.enet.dec.com
  156. (416) 597-3268
  157.