home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / network / system / venet.1-1.1.README < prev    next >
Encoding:
Text File  |  1993-10-11  |  8.7 KB  |  284 lines
  1. README and FAQ list (March 1993)
  2. Copyright 1993 by Eric P. Scott.  All Rights Reserved.
  3.  
  4.  
  5. VENET1 is a Loadable Kernel Server for NeXT Software Release 2.x
  6. and 3.0 that provides access to EtherTalk Phase I (AppleTalk over
  7. Ethernet) datagrams.  It allows user-mode software to implement
  8. AppleTalk protocols, bridges, etc. on NeXT computers.
  9.  
  10. As an example, I provide an interface to the ARNS "Remote Network
  11. Server" package, which enables distant Macintoshes to access
  12. local AppleTalk networks via the Internet or over asynchronous
  13. serial line connections.
  14.  
  15. This software is not in the public domain, but may be freely
  16. redistributed and used pursuant to the licensing terms in the
  17. venet1.c file, which are essentially those of BSD's "NET2"
  18. software (although VENET1 contains no code taken from NET2).
  19.  
  20.  
  21. Building VENET1:
  22.  
  23. The supplied Makefile compiles the LKS and formats the manual
  24. page.
  25.  
  26. There are two compile-time options you can enable by editing the
  27. Makefile: FASTER_QUEUE suppresses the usual prepending of
  28. interface information on the read queue.  This is made an option
  29. because it violates 4.3BSD conventions.  SEGREGATE enables
  30. additional functionality as described on the man page.
  31.  
  32. Then  make NeXT2.x  or  make NeXT3.0  as appropriate.
  33. Build on the same major release you intend to run under and do
  34. not attempt to load a 2.x server on a 3.0 machine--there are
  35. significant (incompatible) internal differences.
  36.  
  37. You will need to create at least one character special file
  38. -> on each machine that will run the LKS <-  by doing a
  39.  
  40.     make /dev/etI0
  41.  
  42. as root.  Use  make devices  if you've chosen the SEGREGATE
  43. option (it does no harm if you didn't, but the additional devices
  44. won't be usable).
  45.  
  46. Loading VENET1:
  47.  
  48. kl_util -a /usr/local/lib/kern_loader/venet1_reloc
  49.  
  50. (This can be done from /etc/rc.local; note that only root can
  51. load kernel servers)
  52.  
  53.  
  54. Author's address:
  55.  
  56. Eric P. Scott
  57. School of Science
  58. San Francisco State University
  59. 1600 Holloway Avenue
  60. San Francisco, CA  94132
  61. USA
  62.  
  63. e-mail: <eps@cs.sfsu.edu>
  64. FAX:    +1 415 338 6136
  65.  
  66.  
  67. Building ARNS:
  68.  
  69. You must obtain a copy of ARNS patchlevel 5 (March 10, 1993).
  70. The package is available for anonymous FTP from munnari.OZ.AU
  71. as mac/arns.tar.Z (165351 bytes).
  72.  
  73. mkdir arns  and  cd arns  before unpacking the archive.
  74.  
  75.     zcat ../arns.tar | tar xvopBf -
  76.  
  77. Use Larry Wall's patch utility (available from countless
  78. anonymous FTP sites) to add support for the VENET1PF option:
  79.  
  80.     patch -p <../arns.patch
  81.  
  82. Note that this will change CFLAGS in the Makefiles to -O -bsd,
  83. so you won't have to do this manually.  make.
  84.  
  85. (Changes made by this patch may be incorporated in future ARNS
  86. releases.)
  87.  
  88.  
  89. Running ARNS:
  90.  
  91. Specify the device name with  -i etI0; everything else is as
  92. described on the arns man page.
  93.  
  94.  
  95. The ARNS package is copyright 1993, The University of Melbourne.
  96.  
  97. -------
  98. Frequently Asked Questions (and Answers)
  99.  
  100.  
  101. Q. How did you manage to do this?  I've wanted something like it
  102.    for years!
  103.  
  104. A. I read Writing Loadable Kernel Servers and the two books it
  105.    suggested (The Design and Implementation of the 4.3BSD UNIX
  106.    Operating System, and Writing a UNIX Device Driver).  Then I
  107.    went to the SunOS 4.x documentation and read Socket-Based IPC
  108.    Implementation Notes in the Network Programming Guide, and
  109.    Writing Device Drivers in the Writing Device Drivers/STREAMS
  110.    Programming volume.  Despite NeXT's "us vs. them" marketing
  111.    campaign, NeXT always has been and remains a Sun licensee.  If
  112.    you're familiar with SunOS 4.x internals, you're well prepared
  113.    for what NeXT throws at you.  Also, I had access to BSD NET1
  114.    and NET2 sources (NeXT's kernel APIs mostly agree with NET1).
  115.  
  116.  
  117. Q. How much kernel hacking experience did you have before writing
  118.    this?
  119.  
  120. A. Practically none on UNIX systems.  But I've worked on others,
  121.    and developed a healthy respect for the perils of kernel code.
  122.  
  123.  
  124. Q. How many machines did you crash before you got it right?
  125.  
  126. A. None.  In fact, it worked the first time it loaded and passed
  127.    every subsequent test I performed.
  128.  
  129.  
  130. Q. Is it really that easy?
  131.  
  132. A. Not for most people.  But I'm not most people.  I was also
  133.    VERY careful when writing it.
  134.  
  135.  
  136. Q. How long did it take?
  137.  
  138. A. Hard to say.  I worked on it in bits and pieces over a three
  139.    week period, mostly weekends and nights.  It was definitely a
  140.    low priority project.
  141.  
  142.  
  143. Q. What was the hardest part?
  144.  
  145. A. Writing the documentation.
  146.  
  147.  
  148. Q. Could you have done this without access to a 2.x system?
  149.  
  150. A. Probably not.  NeXT removed so much from the supplied header
  151.    files in 3.0 that newcomers are left at a severe disadvantage.
  152.  
  153.  
  154. Q. What about NeXT training?
  155.  
  156. A. (1) NeXT doesn't teach this sort of thing.  (2) I never
  157.    attended Developer Camp or any other NeXTedge course.
  158.  
  159.  
  160. Q. How much help did you get from NeXT?
  161.  
  162. A. None whatsoever.  In fact, they tried very hard to discourage
  163.    me from even attempting this.  They said they're only
  164.    interested in helping their Strategic Partners.  If they don't
  165.    think you're working on something that's going to generate
  166.    a lot of additional sales for them, you're just not worth
  167.    their time.
  168.  
  169.  
  170. Q. Did you obtain a major device number from NeXT Technical
  171.    Support?
  172.  
  173. A. No.  See previous Q/A.
  174.  
  175.  
  176. Q. Which major device numbers are available for user-written
  177.    character device drivers?
  178.  
  179. A. 19-31, 37.
  180.  
  181.  
  182. Q. What about the long-promised DriverKit?
  183.  
  184. A. I've never seen it, so I can't comment.
  185.  
  186.  
  187. Q. Why do I get what looks like an error message when compiling
  188.    venet1.c on a 3.0 system--something about including the wrong
  189.    file?
  190.  
  191. A. NeXT screwed up one of their header files.  Don't sweat it.
  192.    Don't worry about the sccsid warning either.  It's harmless.
  193.  
  194.  
  195. Q. OK, the "big" question: Can I use this driver to build a
  196.    "Native EtherTalk" version of CAP?
  197.  
  198. A. Probably not.  CAP with Native EtherTalk requires that the
  199.    network interface be able to be opened multiple times, once
  200.    per open AppleTalk socket, one or more per CAP process.  This
  201.    driver currently only supports multiple opens for different
  202.    protocols when -DSEGREGATE is defined.
  203.  
  204.  
  205. Q. Does this driver see its own broadcasts?
  206.  
  207. A. Yes.
  208.  
  209.  
  210. Q. Can this code be fitted with a programmable packet filter,
  211.    a la ENET or BPF?
  212.  
  213. A. I think you'd be better off porting one of those in its
  214.    entirety.  ENET probably involves less effort, and is probably
  215.    more immediately useful.
  216.  
  217.  
  218. Q. Can I use this as a basis for a RARP server?
  219.  
  220. A. Yes.
  221.  
  222.  
  223. Q. What about EtherTalk Phase II?
  224.  
  225. A. No way.  This version does not support multicast datagrams.
  226.  
  227.  
  228. Q. Can I run this at the same time as NeXT's AppleTalk
  229.    (under 3.0)?
  230.  
  231. A. No.  You can't have two competing protocol implementations
  232.    running on the same machine.
  233.  
  234.  
  235. Q. Where can I find Apple's EtherTalk Phase I extension?
  236.  
  237. A. As far as I know, Apple last distributed it with EtherTalk
  238.    Installer 2.0.1, in the "Previous Version" folder.  That's
  239.    going to be difficult to find these days unless you have
  240.    access to some old Developer CD-ROMs.  However, several third-
  241.    parties (3Com, Asante', Farallon, to name a few) who make 100%
  242.    register-compatible products probably have it on their
  243.    installer disks.  You may need to perform a "Custom"
  244.    installation to get at it.  Note that 3Com's EtherLink/NB card
  245.    is identical to the Apple product, and its [System 6]
  246.    installer is available by anonymous FTP from ftp.3com.com as
  247.    adapters/drivers/3c543.sit (use StuffIt Expander to extract).
  248.    It's also available on Compu$erve (GO THREECOM) for the FTP-
  249.    deprived, or from 3Com's Network Adapter BBS +1 408 980 8204.
  250.  
  251.  
  252. Q. I thought EtherTalk Phase I didn't work under System 7?
  253.  
  254. A. You thought wrong.  EtherTalk Phase I is compatible with
  255.    7.0, 7.0.1, and 7.1.  Note that Apple's Network Software
  256.    Installer will remove it; just copy it to your Extensions
  257.    folder after running Network Software Installer and restart.
  258.    Then select it from the Network Control Panel.
  259.  
  260.  
  261. Q. Is EtherTalk 1.2 compatible with AppleTalk 58?
  262.  
  263. A. It seems to be.  The major change with AppleTalk 58 (Network
  264.    Software Installer 1.3) is support for their SNMP agent.  If
  265.    you're really worried about this, use Network Software
  266.    Installer 1.2.3, or what's standard with System 7.1.
  267.  
  268.  
  269. Q. Are there any security-related issues I should be aware of?
  270.  
  271. A. The Makefile creates devices with 666 permissions (read/write
  272.    by anyone).  You may restrict access to a particular user or
  273.    group if desired.  Asynchronous (SIGIO) notifications can be
  274.    directed to processes which would be off-limits to kill(2).
  275.    This problem is not unique to VENET1; programs that catch
  276.    SIGIO should always be prepared to dismiss spurious signals.
  277.  
  278.  
  279. Q. What are your future plans for this software?
  280.  
  281. A. I haven't any.  I don't promise any enhancements, support, or
  282.    additional sample code.  What you see is what you get.
  283.    (But I also don't promise not to pursue further development.)
  284.