home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Extras / Networking / SANA-II / changes.txt < prev    next >
Encoding:
Text File  |  1992-11-12  |  3.6 KB  |  68 lines
  1. Changes
  2.  
  3. November 12th, 1992:
  4.  
  5. - Previous to this release, the SANA-II structure Sana2DeviceStats was
  6. defined differently in sana2.h and sana2.i.  The assembly include file
  7. contained an erroneous entry for a field labelled 'SoftMisses'.  This
  8. field had been removed from the 'C' header file, but never from the
  9. assembly include.  To resolve this problem, this field in the assembly
  10. file has been kept (to preserve structure size), but marked as "Unused".
  11. A ULONG has been added at the appropriate location in the header file,
  12. and also marked as "unused".  If you were using the header file
  13. definition for this structure, please take note that the structure size
  14. has -changed-!
  15.  
  16. - The SLIP and CSLIP drivers have been included in this archive.  These
  17. drivers are primarily useful only to an IP-based protocol stack, but
  18. can be used in other applications.  See the documentation in driver_docs
  19. for more information.
  20.  
  21. May, 1992:
  22.  
  23. There have been no substantive changes from the Novemeber 7 Draft for Final
  24. Comment and approval.  There have been minor clarifications and typographical
  25. corrections and a section was added to clarify ARCNET framing.
  26.  
  27. Since the Fish Disk/'91 DevCon draft of the SANA-II standard, here is a
  28. summary list of the important changes:
  29.  
  30. - Packet type specification has been drastically simplified.  The original
  31. standard called for a generalized "Packet Magic" which all drivers and
  32. protocols had to deal with, even though few people should ever have to worry
  33. about the problem.  We could also have specified that there are 802.3 SANA-II
  34. drivers and that there are ethernet drivers and that if you want 802.3 and
  35. ethernet (even if on the same wire) from the same machine, use two ethernet
  36. boards.  This didn't make sense because we don't anticipate multiple protocols
  37. needing to use 802.3 frames nor much encouragement for hardware manufactures
  38. to provide special 802.3 drivers.  The current solution keeps the standard
  39. simple and allows highly efficient implementations, but it does make ethernet
  40. drivers a little more complex and does make using 802.3 frames harder.
  41.  
  42.  
  43. - The original SANA-II device driver specification therefore called for
  44. drivers to have no internal buffers and to get all buffers from protocols in
  45. the form of a data structure called a NetBuff. Hence, all protocols were
  46. required to use NetBuffs.  This was highly unsatisfactory since most
  47. protocols are implemented from an existing code base which includes its own
  48. buffer management scheme.  NetBuffs are removed from the standard and
  49. replaced with a function callback.
  50.  
  51. - The original standard called for an interface to the ability of some hardware
  52. to simultaneously accept packets for several hardware addresses.  Such a
  53. feature is of dubious usefulness.  In order to simplify the standard, station
  54. aliases are no longer part of the SANA-II Network Device Driver Specification.
  55. If station aliasing does turn out to be a useful feature available on some
  56. hardware for the Amiga, the standard can easily be extended to re-introduce
  57. station aliasing.  Remember that all Exec drivers must check for io_Command
  58. values not supported by the driver. Hence, SANA-II commands can be added
  59. without requiring that existing drivers be rev'd.
  60.  
  61. - Since the IOSana2Req structure had to be changed anyway, many names in
  62. <devices/sana2.h> have been changed to be more consistent with other system
  63. names. It is believed that global search and replace should make this a mostly
  64. trivial change and that the benefits gained from consistent naming outweigh
  65. the inconvenience to those few who have existing SANA-II code.
  66.  
  67. - Events are now defined as a bit mask rather than as scalars.
  68.