home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 2 / amigaformatcd02.iso / comms / netsoftware / cslip.lha / README
Encoding:
Text File  |  1992-11-11  |  3.3 KB  |  92 lines
  1. This archive contains changes to the kernel and slattach
  2. to implement compressed (Van Jacobson TCP header compression) SLIP
  3. (aka CSLIP) for Amiga Unix.
  4.  
  5. I have tested the changes on Amiga Unix 2.03 and 2.1c, and I've used
  6. both SLIP and CSLIP modes successfully.
  7.  
  8.  
  9. INSTALLATION
  10. ------------
  11.  
  12. To apply the changes, here's a roadmap of the provided files. The 
  13. `usr' directory starts a hierarchy that corresponds to the /usr 
  14. hierarchy, and thus usr/amiga/bin/slattach corresponds to 
  15. /usr/amiga/bin/slattach.
  16.  
  17. usr/amiga/bin:            a new slattach binary, understanding
  18. slattach            new options `compressed', `autocomp'
  19.                 and `noicmp'.
  20.  
  21. usr/amiga/src/cmd/slattach:    diffs against the original slattach
  22. slattach.c-diff            source to implement the new options.
  23.  
  24. usr/sys/amiga/driver:        kernel changes:
  25. slcompress.c            new files. Implement compression/
  26. slcompress.h            decompression.
  27. slip.c-diff            diffs against the original slip.c
  28.  
  29.  
  30. To integrate the changes, replace the slattach binary (make a backup
  31. of the old one!) with the one in usr/amiga/bin. If you're interested
  32. into the new source (and if you have installed the amigasrc package)
  33. apply the slattach.c-diff patch to /usr/amiga/src/cmd/slattach/slattach.c.
  34.  
  35. To update the kernel, cd to /usr/sys/amiga/driver. Then do a 
  36.   cp slip.c cslip.c
  37. Now apply the slip.c-diff, this will change the cslip.c from being a 
  38. copy of slip.c into the real cslip.c. (If you don't want to keep the old
  39. driver slip.c, rename it to cslip.c and apply the patch. I don't
  40. recommend this however, I always like to have backups to fall back on).
  41.  
  42. Copy slcompress.[ch] into this directory as well. 
  43.  
  44. Now to edit /usr/sys/amiga/driver/Makefile. Replace in the assignment 
  45. to OBJ the "slip.o\" with "cslip.o slcompress.o\".
  46.  
  47. Then cd back to /usr/sys and make a new kernel.
  48.  
  49.  
  50.  
  51. WHAT'S NEW
  52. ----------
  53. The old device is enhanced to handle CSLIP as well as SLIP, so no new
  54. devices and/or streams modules are created. I added some code to 
  55. slattach to set the new modes of the driver, so the syntax for slattach
  56. is new:
  57.  
  58. slattach <speed> <local-addr> <remote-addr> [<new-opts>] [ifconfig opts]
  59.  
  60. with [<new-opts>] being optional, and a combination of:
  61.   compress    enable CSLIP mode. When in this mode, SLIP tcp headers
  62.         are *not* recognized.
  63.   autocomp    run in SLIP mode. On receipt of a valid compressed 
  64.         packet, automatically switch to CSLIP mode. This is the
  65.         preferred mode of operation on the server side of the
  66.         communication, so that both kinds of protocols are
  67.         available in parallel.
  68.   noicmp    when in CSLIP mode, supress ICMP traffic. This mode is 
  69.         meant to be used in low-speed connections, so nobody
  70.         can saturate the link with ICMP packets (such as 
  71.         generated by /usr/sbin/ping). Don't set this flag if
  72.         if you don't have problems with ICMP packets.
  73.  
  74. On my machine, I'm using "slattach ... compress" to connect to the
  75. other side, where I run "slattach ... autocomp" to enable both, SLIP
  76. and CSLIP clients to connect.
  77.  
  78.  
  79. COPYRIGHT / DISCLAIMER
  80. ----------------------
  81. Sources are copyrighted by the "Regents of the University of
  82. California." Please see the header of slcompress.h for the full
  83. copyright notice and disclaimer. I (Markus Wild) regard myself as
  84. "contributor" according to the above Copyright.
  85.  
  86.  
  87. Good luck!
  88.  
  89. If you find bugs, please tell me! You can reach me at:
  90.  
  91. <wild@nessie.cs.id.ethz.ch> and <wild@amiga.physik.unizh.ch>
  92.