  16-bit README
  Ken Yap, ken.yap@acm.org
  1 July 1997

  These are some notes on src-16, a 16-bit version of etherboot, a pack-
  age for making boot ROMS for Linux.
  ______________________________________________________________________

  Table of Contents


  1. Why a 16-bit version?

  2. But Linux doesn't run on XTs and ATs

  3. So should I use src-32 or src-16?

  4. What do I need to run it?

  5. How do I build it?

  6. How do I run it?

  7. Copyright



  ______________________________________________________________________

  11..  WWhhyy aa 1166--bbiitt vveerrssiioonn??


  So that etherboot can run on XTs and ATs.


  22..  BBuutt LLiinnuuxx ddooeessnn''tt rruunn oonn XXTTss aanndd AATTss


  That's right, but Linux/ELKS eventually will.  Not that it will be
  ever the same as the Linux you love.  So src-16 would be useful for
  booting those over the network. After all, embedded apps for XTs and
  ATs are one goal of Linux/ELKS. It might also be useful for netbooting
  other OSes, but you have to figure out how yourself.


  33..  SSoo sshhoouulldd II uussee ssrrcc--3322 oorr ssrrcc--1166??


  If you are using etherboot to load Linux, then you probably want
  src-32 because src-16 is a subset. It only loads tagged images. It can
  load to extended memory if running on a 286 or above. On a 8086/8
  loading to extended memory will silently fail.


  44..  WWhhaatt ddoo II nneeeedd ttoo rruunn iitt??


  Most of the cards as the src-32 version are supported, the exceptions
  mainly being the PCI cards which don't work with XTs and ATs anyway.


  55..  HHooww ddoo II bbuuiilldd iitt??


  First of all get a bcc (Bruce Evan's C compiler) distribution, from
  the ELKS tool distribution at http://www.cix.co.uk/ mayday/ There is
  also a mailing list for Linux-8086 developers at
  linux-8086@vger.rutgers.edu. Send mail to majordomo@vger.rutgers.edu
  with the line "subscribe linux-8086" if you want to join. It's very
  technical though and there won't be anything user friendly for a
  while.

  Look over the Config file to see if you need to alter something. By
  default it builds images for all 4 versions. You can omit the ones you
  don't want. But it compiles very quickly anyway.  Then build the
  software by saying make. There will be some warnings about duplication
  definitions of some library routines. Ignore them, the correct ones
  are the ones in this directory.


  66..  HHooww ddoo II rruunn iitt??


  Like src-32, src-16 builds two versions of the boot program for a
  given card, card.rom, and card.lzrom.  If you want to test from a
  floppy, prepend floppyload.bin before writing raw to a blank floppy or
  use the .fd0 targets in the Makefile. All this is just like the src-32
  version.



  Currently only booting tagged images (see documentation) is supported
  as I don't know when or if Linux/ELKS will support booting off a NFS
  mounted root. To make a tagged image see the directory netboot-*.


  77..  CCooppyyrriigghhtt


  This work is derived from FreeBSD and you should consult the copyright
  statement.  Any parts I wrote are public domain.































