Notice
------
The software running on the VIP19xx series must be signed. The
resulting kernel/boot images signed with the keys supplied with this
distribution (located in dist/config/keys) will boot on a development
kit VIP19xx.


Installing the cross compiler toolchain
---------------------------------------
Extract the toolchain archive in /usr/local/motorola.


Building the cross compiler toolchain
-------------------------------------
Extract the toolchain src archive. Run make from the src root directory. This
is only needed if the pre built toolchain is not installed or if modifications
to binutils, gcc or glibc is needed.


Building
--------
Run the build_image.sh script from bootimage/tools. This will create:

 * dist/products/kernel.pre_vip1900
   - Linux kernel image
 * dist/products/kernel-debug.pre_vip1900
   - Linux kernel image with NFS support
 * bootimage/tools/vip1900/rootdisk.tar.gz
   - Tarball of the root filesystem
 * bootimage/tools/vip1900/boot
   - Bootimage
 * bootimage/tools/vip1900/debug-boot
   - Bootimage with NFS support


Altering a bootimage
--------------------
Modify build_image.sh to have more files added to the bootimage.


Boot methods
------------
What's required:
 * TFTP server
 * DHCP server

What's optional:
 * NFS server

For configuring the server daemons consult your system documentation. An
example of relevant dhcpd options follows below.

Configuring the dhcpd DHCP server for booting TFTP bootimage:

host clientname {
  next-server 0.0.0.0;                           # TFTP server IP
  filename "/tftpboot/boot";                     # bootimage location
}

Configuring the dhcpd DHCP server for booting TFTP kernel and NFS rootdisk:

host clientname {
  next-server 0.0.0.0;                           # TFTP server IP
  filename "/tftpboot/kernel-debug.pre_vip1900"; # kernel location
  option swap-server 0.0.0.0;                    # NFS server IP
  option root-path "/nfs/rootdisk";              # rootdisk location
}
