[File last updated Jan 17/2000]

What is in this file:
    README			this file
    COPYING*			copyright and legal stuff
    freebsd-3.3-diffs		diffs to the freebsd-3.3 kernel (including
    				llc/802.2 network layer)
    freebsd-2.2.7-diffs		diffs to the freebsd 2.2.7 kernel (including
    				llc/802.2 network layer)
    samba-1.9.17.diffs		diffs to samba to make it talk netbios/llc
				(netbios protocol is added to the samba code)

Brief list of things to do:
    - Apply diffs to freebsd kernel:
	- cd /usr/src/sys && mkdir net802 && patch -p0 < freebsd-XXX-diffs
    - Install new kernel header files (so samba will find them):
	umask 22 && cd /usr/src/sys &&
	mkdir /usr/include/net802 && cp net802/i802.h /usr/include/net802 &&
	cp sys/sys/socket.h sys/mount.h sys/netisr.h /usr/include/sys/.
    - edit kernel configuration file
    - compile/install kernel
    - get samba 1.9.17, apply diffs
      (may want to change normal samba config things like where binaries
       live, etc)
    - edit source/netbios_mim.c and search for / change
	"/local/etc/bootptab"
      to some suitable location for your site
    - compile samba
    - set up afore mentioned bootptab file: this is a regular bootptab
      file - the hacked samba uses it to map mac addresses to ip addresses
      (a major kludge, done as samba does its authentication based on ip
       names/addresses)
    - set up standard smb.conf file
    - run smbd
    - on win95/nt machine, mount a share you have configured in the smb.conf


Misc notes:
    - the netbios name of the samba server is the machine's hostname after
      it has been upper-cased, truncated to 15 characters or space padded
      to 15 characters.  If your hostname (as returned by gethostname(2))
      has dots in it, you may want to hack the code to truncate at the
      first dot.

    - this is provided for those interested in seeing what has been
      done - it is not ready for public use.  Little effort has been
      spent doing things `right' (in either the packaging, or the samba
      hacks) - the code will be cleaned up when the netbios protocol
      moves into the kernel.

Future directions:
    - the current plan is to move the netbios protocol into the freebsd kernel;
      this will allow multiple netbios connections between two particular
      machines and it will make the patches to the samba code very much
      cleaner.  I would like to have this done before Feb/98 (actually,
      would like it done before christmas...).
    - once the freebsd kernel is done, netbios code is to be added to the
      linux kernel (either based on the freebsd code or from re-coded).
      A number of people have expressed interest in this.
      It would be very nice to ensure the kernel interface to netbios
      is the same in both freebsd and linux.  The same goes for the 802
      interface.

This code was written by John Rochester, jr@cs.mun.ca (net802 code),
and Michael Rendell, michael@cs.mun.ca (netbios/samba hacks).