# $Id: README,v 1.5 1996/02/06 01:10:00 seb Exp $

  This is MILO -- a bootstrap loader for Linux/MIPS on ARC 
compliant systems, and PANDORA -- a ARC compliant systems
`explorer'. From  here in this file, `MILO' will mean `MILO' or
`PANDORA'.

  Please send comments, bug reports and so on to the
Linux/MIPS developers' mailinglist linux-mips@fnet.fr.

  MILO has been successfully tested on Deskstation Tyne, Acer
PICA-61, Mips Magnum 4000, Olivetti M700-10 systems and SNI RM200. 
Deskstation rPC44 support is in progress.

  If you have an ARC system which is not identified by MILO,
please send us the ARC Vendor ID, Product ID, System ID and
any information MILO wasn't able to find out. We will include
your system in later releases.

Milo is distributed under the terms of the GNU PUBLIC LICENSE. See 
the file COPYING for details. 

  This release contains binaries too. There were created for a kernel
base address (KERNELBASE) of 0x80000000 and a milo/pandora load
address of (LOADADDR) 0x80600000. If you want to compile MILO
yourself, please make sure that you have the latest release of
Linux/MIPS which is currently 1.3.98 with a little patch,
subsequent 1.3.xx releases will not need any patches.

Without kernel sources you cannot compile MILO.  

How to compile Milo:

  First you have to configure the package by running the configure
script. Configure has to determine two important things: the
bootmethod that is to be used and the Linux kernel sources top
directory. 
  The former is impossible to determine automagically for now
- even with native compilation under Linux/MIPS. So you have to
specify to configure the '--enable-<something>' option which
correspond to the platform support you're interested in. Only
'--enable-arc' is supported as for Milo 0.27. 
  The latter can be guessed as /usr/src/linux for native compilation but
for cross-compilation what on earth prohibits you from installing your
Linux/MIPS kernel sources in /u/opt/tmp/linux ? So most of the time the
option '--with-linux-kernel=DIR' has to be used. 
For cross-compilation, you have to specify on `configure' command
line the name of the cross-compilation tools. In practice only the C
compiler will do the job (see below for an example in bourne-like
shell). 
  Another funny thing about cross-compilation and configure, I
can't figure what is going on - I surely missed something in Autoconf
:) - but I found myself using the two options `--host' and `--build' 
to make the configuration process working. If someone can explain me 
this I'll be delighted.
  So I use this command to configure Milo 0.27 on my home Linux/i386 
box:

CC=mipsel-linux-gcc ./configure --host=mipsel-linux \
   --build=i586-linux --with-linux-kernel=/usr/local/src/mips/linux \
   --enable-arc

  If you need to adjust the defaults values of LOADADDR or/and
KERNELBASE just set them on `configure' command line or adjust the
toplevel generated Makefile.
  Then just do a `make'.

 Have fun,

    Stoned Elipot (Stoned.Elipot@fnet.fr)

  Please note that the former mainteners of Milo were our great
Linux/MIPS kernel and project hackers, mamely, in alphabetical order:

    Ralf Baechle (ralf@waldorf-gmbh.de)
    Andreas Busse (andy@soft-n-hard.de)