

OVERVIEW
========

This is a summary. See the LEON Linux overview and the LINUXBUILD manual in the
doc/ directory for more information.


SUMMARY OF INSTALL/CONFIG/BUILD
===============================

$ make xconfig
... install Linux kernel
... top level configuration
$ make buildroot-xconfig
... configure buildroot
$ make linux-xconfig
... configure Linux kernel
$ make build
... building components according to configuration
$ cd output
$ ls -l


INSTALLING
==========

 1. After extracting do one of
   - make xconfig
   - make gconfig
 2. Select in what way to download and install the Linux kernel
 3. Use the installation target to install the Linux kernel.

Buildroot and MKLINUXIMG are preinstalled. LEON Linux Toolchain and MKPROM2 needs
to be installed individually outside of LINUXBUILD.

CONFIGURING
===========

Top level configuration, Buildroot configuration and Linux kernel configuration
are performed individually.

Top level:
- make xconfig
- make gconfig
- make menuconfig

Buildroot:
- make buildroot-xconfig
- make buildroot-gconfig
- make buildroot-menuconfig

Top level:
- make linux-xconfig
- make linux-gconfig
- make linux-menuconfig

BUILDING
========

The build process is started by issuing 'make build'. The resulting binaries
will be found in the output/ directory and in respective build directory.

Individual build steps can be performed with steps such as:
- make buildroot
- make linux
- make mklinuximg
- make mkprom

RESULTS
=======

In output images, the following can be found in output/images
 image          - Linux kernel image with debug information.
                  Not runnable in itself.
 image.ram      - RAM image produced by MKLINUXIMG. Can be loaded and executed
                  directly by GRMON or TSIM, or used with a bootloader such as
                  MKPROM2 or GRBOOT.
 image.prom     - PROM image produced by MKPROM2.


FILES
=====
 CHANGES        - Changelog
 README         - This file
 VERSION        - Current version of LINUXBUILD
 boot/          - RAM/FLASH/PROM booting
 dist/          - Distributions (root filesystem generation), e.g. Buildroot
 doc/           - Documentation
 gaisler/       - various scripts, kconfig and other stuff
 linux/         - Linux kernel build
 output/        - Resulting Images (kernel, filesystems, boot loaders etc.)
