Introduction
------------

When running a LINUX build inside the LINUX source-tree for SPARC the output
image is <linux-dir>/arch/sparc/boot/image for Linux 3.4 and older and
<linux-dir>/vmlinux for Linux 3.5 and newer. This image however cannot be run
directly and it is linked to virtual addresses. The image expects among other
things an initialized romvector and the MMU to be switched on. The script
mklinuximg sets up such an environment. The output of mklinuximg can be uploaded
using GRMON, simulated in TSIM or serve as input to MKPROM2 for PROM bootloader
generation.

Invocation
----------

Run mklinuximg without parameters to see help printout.

Files
-----

 mklinuximg      Script that create config files and build environment for the
                 sources in src/ and include/.
 README.txt      This file.
 CHANGES         Changelog.
 xml-format.txt  Documentation on the xml format for files used with the -xml parameter.
                 Generated using Makefile
 example.xml     Example file on how to use the -xml parameter.

Linux
-----

The LINUX version has to be newer than 2.6.36.

Prom tree changes
-----------------

Using the option "-xml <file>" the prom tree can be changed to remove core nodes, to
add and remove properties to core nodes and to add subtree nodes to core nodes.

Documentation on the xml format can be found in xml-format.txt (and as output of
scanxml -d).

For an example on how to use the xml format, see the example file example.xml.
