home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume20 / etherlib / part02 / Instructions < prev    next >
Encoding:
Text File  |  1989-10-24  |  2.9 KB  |  61 lines
  1.  
  2. This ethernet access library is a part of the Columbia Netmate project which is
  3. being released as a useful component in its own right.
  4.  
  5. These functions provide access to the raw ethernet for user-level programs.  On
  6. Suns, they are implemented using NIT(4p) (network interface tap).  While they
  7. do not provide the full functionality of NIT, these functions do run on both
  8. the socket- and streams-based NIT implementations.  On Ultrix systems, they are
  9. implemented using DLI (data link interface).  On Berkeley systems, they are
  10. implemented using the Stanford enetfilter available as user-contributed
  11. software in the 4.3 BSD release.
  12.  
  13. These functions are not designed to be used for ethernet monitoring, but rather
  14. for programs implementing ethernet protocols such as RARP, or the Ethernet
  15. configuration test protocol.
  16.  
  17. It comes with a manual page, and both a GNU makefile and a regular one.
  18.  
  19. If you are on a BSD system with the enetfilter, you will have to create some
  20. new device files before you can build or use this library.  Because there is no
  21. way to map between the interface names ("il0", "de0", etc.) used by most
  22. programs and the old enetfilter device names (/dev/enet0, /dev/eneta0, etc.),
  23. this library uses a different convention for enetfilter device names, using
  24. device files in the /dev/enet/ directory.
  25.  
  26. Therefore, you should create or link an enetfilter device in /dev/enet for each
  27. ethernet interface, with names like /dev/enet/il0, /dev/enet/de0, etc.  The
  28. minor device numbers for these files will correspond to the order in which they
  29. are found by the kernel.  This order is the same as in the config file, except
  30. that devices configured into the kernel but not present are not counted.  You
  31. can look at the kernel startup messages in /usr/adm/messages to see the order
  32. of ethernet devices; the ethernet addresses are also printed out there, and you
  33. can check those against the results of the ethertest program here.
  34.  
  35. If you have GNU make, you should be able to say "gmake" in this directory, and
  36. it will build the library for your system in a subdirectory.  You may want to
  37. edit the GNUmake.config file to specify various options (such as installation
  38. directories, cc vs. gcc, etc.)  Once you are satisfied that it has built
  39. correctly, you can say "gmake install".
  40.  
  41. If you don't have GNU make, you will have to cd to the src subdirectory, and
  42. edit the Makefile there to reflect your system configuration.  Once you have
  43. done this, you can say "make" to build the library, and "make install" to
  44. install it.
  45.  
  46. If you encounter bugs, or are interested in porting this library to another
  47. ethernet access interface, please contact me.
  48.  
  49. Alexander Dupuy
  50. 480 C.S.B.
  51. Computer Science Dept.
  52. Columbia University
  53. New York City 10027-6699
  54.  
  55. <dupuy@cs.columbia.edu>
  56. !rutgers!cs.columbia.edu!dupuy
  57.  
  58. This library can be obtained via anonymous FTP from columbia.edu or
  59. cs.columbia.edu, in the file pub/etherlib.tar.Z.
  60.  
  61.