home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 2 / CD ACTUAL VOL 2.iso / docs / kernel.13 / readme.000 < prev    next >
Encoding:
Text File  |  1995-09-10  |  9.6 KB  |  236 lines
  1.  
  2. ----------------------------------------------------------------------------
  3. NOTE:  See also README.arcnet-jumpers in this directory for jumper-setting
  4. information if you're like many of us and didn't happen to get a manual with
  5. your ARCnet card.
  6. ----------------------------------------------------------------------------
  7.  
  8. Since no one seems to listen to me otherwise, perhaps a poem will get your
  9. attention:
  10.             This is alpha software
  11.             If it works I DO CARE.
  12.             
  13. Hmm, I think I'm allowed to call that a poem, even though it's only two
  14. lines.  Hey, I'm in Computer Science, not English.  Give me a break.
  15.  
  16. The point is:  I REALLY REALLY REALLY REALLY REALLY want to hear from you if
  17. you test this and get it working.  Or if you don't.  Or anything.
  18.  
  19. ARCnet 0.32 ALPHA first made it into the Linux kernel 1.1.80 - this was
  20. nice, but after that even FEWER people started writing to me because they
  21. didn't even have to install the patch.  <sigh>
  22.  
  23. Come on, be a sport!  Send me a success report!
  24.  
  25. (hey, that was even better than my original poem... this is getting bad!)
  26.  
  27. Anyway, enough complaining.  Let's get started:
  28.  
  29. ---------------------------------------------------------------------------
  30.             
  31. These are the ARCnet drivers for Linux.
  32.  
  33. We're now back to more ALPHA releases after the 1.01 release which made it
  34. into Linux 1.2.2, so please be careful, and send all possible
  35. success/failure reports to me.  If I don't know when/if/how it works, I
  36. won't be able to answer people's questions.  Do we want that?  Of course
  37. not.
  38.  
  39. Once again:  DO send me success reports!  I want to know if this is working!
  40. (You know, it might be argued that I'm pushing this point a little too much. 
  41. If you think so, why not flame me in a quick little e-mail?  Please also
  42. include the type of card(s) you're using, software, size of network, and
  43. whether it's working or not.)
  44.  
  45. My e-mail address is:
  46.     apenwarr@foxnet.net
  47.  
  48.  
  49. Where do I discuss these drivers?
  50. ---------------------------------
  51.  
  52. There is a mailing list specifically for discussion of the ARCnet drivers
  53. for Linux, and anything you might want to interface them with (ie. DOS). 
  54. I'll also post new versions of the Linux-ARCnet distribution to the list in
  55. tar-gzip-uuencode format.
  56.  
  57. To subscribe to the list, send a message to listserv@807-city.on.ca
  58. with the following line in the BODY (not the SUBJECT) of your message:
  59.     subscribe linux-arcnet YOUR REAL NAME
  60. Remember to remove your signature, or you'll get an error back.
  61.  
  62. Send all bug (or success) reports to me or to the list.
  63.  
  64. The people on linux-net@vger.rutgers.edu have also been known to be very
  65. helpful! :)
  66.  
  67.  
  68. Other Drivers and Info
  69. ----------------------
  70.  
  71. Also, SMC (one of the companies that makes ARCnet cards) has a WorldWideWeb
  72. site you might be interested in, which includes several drivers for various
  73. cards including ARCnet.  Try:
  74.     http://www.smc.com/
  75.     
  76. Performance Technologies makes various network software that supports
  77. ARCnet.
  78.     http://www.perftech.com/ or ftp to ftp.perftech.com.
  79.     
  80. Novell makes a networking stack for DOS which includes ARCnet drivers.  Try
  81. ftp'ing to ftp.novell.com.
  82.  
  83. You can get the Crynwr packet driver collection (including arcether.com, the
  84. one you'll want for arcnet cards) from oak.oakland.edu:/simtel/msdos/pktdrvr.
  85. It won't work perfectly on a 386+ without patches, though, and also doesn't
  86. like several cards.  Mail me if you want a fixed version.  (Ahem:  I may or
  87. may not have a 100% fixed version by the time I get your mail!)
  88.  
  89.  
  90. Loadable Module Support
  91. -----------------------
  92.  
  93. This is a available starting with 0.42 ALPHA.
  94.  
  95. Configure and rebuild Linux.  When asked, say NO to "arcnet support" if you
  96. want loadable module support.
  97.  
  98.     make config
  99.     make dep
  100.     make clean    
  101.     make zImage
  102.     make modules
  103.     
  104.     
  105. Booting into your "ARCnet" Kernel
  106. ---------------------------------
  107.  
  108. If you're using a loadable module, you need to use insmod to load the
  109. module, and you need to specify various characteristics of your card on the
  110. command line.  For example:
  111.     cd /usr/src/linux/modules
  112.     insmod arcnet.o io=0x300 irqnum=2 shmem=0xd0000
  113. You can also add a num=1, num=2 etc for additional arcnet cards that will
  114. use arc1, arc2 etc for their device names (instead of the default, arc0).
  115.     
  116. Otherwise the driver will load and probe for your card automatically.
  117.     
  118. Now go read the NET-2-HOWTO and ETHERNET-HOWTO for Linux; they should be
  119. available where you picked up this driver.  Think of your ARCnet as a
  120. souped-up (or down, as the case may be) ethernet card.
  121.  
  122. By the way, be sure to change all references from "eth0" to "arc0" in the
  123. HOWTOs.  Remember that ARCnet isn't a "true" ethernet, and the device name
  124. is DIFFERENT.
  125.  
  126.  
  127. How do I get it to work with...?
  128. --------------------------------
  129.  
  130. NFS: Should be fine linux->linux, just pretend you're using ethernet cards. 
  131.         oak.oakland.edu:/simtel/msdos/nfs has some nice DOS clients.  There
  132.         is also a DOS-based NFS server called SOSS.  It doesn't multitask
  133.         quite the way Linux does (actually, it doesn't multitask AT ALL) but
  134.         you never know what you might need.
  135.  
  136. DOS: If you're using the freeware arcether.com, you might want to install
  137.         the source code patch.  It helps with PC/TCP, and also can get
  138.         arcether to load if it timed out too quickly during initialization. 
  139.         Mail me if you need a precompiled version of arcether.com. (ie. you
  140.         if don't have a DOS assembler)
  141.     
  142. Windows:  See DOS :)  Trumpet Winsock works fine with either the Novell or
  143.     Arcether client, assuming you remember to load winpkt of course.
  144.  
  145. LAN Manager and Windows for Workgroups: These programs use protocols that
  146.         are incompatible with the internet standard.  They try to pretend
  147.         the cards are ethernet, and confuse everyone else on the network. 
  148.         However, v1.93 ALPHA and later of the Linux ARCnet driver support
  149.         this protocol via the 'arc0e' device.  After setting up arc0 as
  150.         usual, ifconfig and set up routes to your ethernet-encap hosts
  151.         through arc0e.  There may be non-Microsoft products that support
  152.         this protocol as well, so it was changed in 1.93 ALPHA from arc0w
  153.         to arc0e.
  154.         
  155.     Using the freeware Samba server and clients for Linux, you can now
  156.     interface quite nicely with TCP/IP-based WfWg or Lan Manager
  157.     networks.  In addition, the Linux host can be used as a router
  158.     between the standard and WfWg protocols, so hosts that could
  159.     previously never talk to each other should now be able to.
  160.  
  161.         This feature is still in early testing, so please e-mail with any
  162.     comments/questions you might have.
  163.     
  164. OS2: Has not been tested.  The "correct" solution would be to buy either of
  165.     IBM's "TCP/IP for OS/2" or "Warp Connect" packages.  However,
  166.     ftp.microsoft.com also has a freeware Lan Manager for OS/2 client
  167.     which should use the same protocol as WfWg does.  This has not been
  168.     tested, however.  Please mail me with any results.
  169.         
  170. NetBSD/AmiTCP: These use an old version of the Internet standard ARCnet
  171.     protocol which is incompatible with the Linux driver at present. 
  172.     Work to support these is underway and should be available in a
  173.     standard release soon.
  174.  
  175.  
  176. It works: what now?
  177. -------------------
  178.  
  179. Send mail describing your setup, preferably including driver version, kernel
  180. version, ARCnet card model, CPU type, number of systems on your network, and
  181. list of software in use to me at the following address:
  182.     apenwarr@foxnet.net
  183.  
  184. I do send (sometimes automated) replies to all messages I receive.  My email
  185. can be weird (and also usually gets forwarded all over the place along the
  186. way to me), so if you don't get a reply within a reasonable time, please
  187. resend.
  188.  
  189.  
  190. It doesn't work: what now?
  191. --------------------------
  192.  
  193. Do the same as above, but also include the output of the ifconfig and route
  194. commands, as well as any pertinent log entries (ie: anything that starts
  195. with "arcnet:" and has shown up since the last reboot) in your mail.
  196.  
  197. If you want to try fixing it yourself (I highly recommend that you mail me
  198. about the problem first, since it might already have been solved) you may
  199. want to try some of the debug levels available.  For heavy testing on
  200. D_DURING or more, it would be a REALLY good idea to kill your klogd
  201. daemon first!  D_DURING displays 4-5 lines for each packet sent or
  202. received.  D_TX and RX actually DISPLAY each packet as it is sent or
  203. received, which is obviously quite big.
  204.  
  205. You can run the arcdump shell script (available from me or in the full
  206. ARCnet package if you got it) as root to list the contents of the arcnet
  207. buffers at any time.  To make any sense at all out of this, you should grab
  208. the pertinent RFC's. (some are listed near the top of arcnet.c).  arcdump
  209. assumes your card is at 0xD0000.  If it isn't, edit the script.
  210.  
  211. Buffers #0 and 1 are used for receiving, and Buffers #2 and 3 are for
  212. sending.  Ping-pong buffers are implemented both ways.
  213.  
  214. If your debug level includes D_DURING, the buffers are cleared to a constant
  215. value of 0x42 every time the card is reset (which should only happen when
  216. you do an ifconfig up, or when Linux decides that the driver is broken). 
  217. This is to make it easier to figure out which bytes are being used by a
  218. packet.
  219.  
  220. You can change the debug level without recompiling the kernel by typing:
  221.     ifconfig arc0 down metric 1xxx
  222.     /etc/rc.d/rc.inet1
  223. where "xxx" is the debug level you want.  For example, "metric 1015" would put
  224. you at debug level 15.  Debug level 7 is currently the default.
  225.  
  226. Note that the debug level is (as of v1.90 ALPHA) a binary combination of
  227. different debug flags; so debug level 7 is really 1+2+4 or
  228. D_NORMAL+D_INIT+D_EXTRA.  To reach D_DURING, you would add 8 to this,
  229. resulting in debug level 15.
  230.  
  231.  
  232. I want to send money: what now?
  233. -------------------------------
  234.  
  235. Go take a nap or something.  You'll feel better in the morning.
  236.