[Balloon-svn] r992 - balloon/trunk

Author: wookey
Date: 2010-02-12 16:15:18 +0000 (Fri, 12 Feb 2010)
New Revision: 992

Added:
balloon/trunk/README
Log:
This got lost somehow. UPdated a little for the current state of affairs

Added: balloon/trunk/README
===================================================================
--- balloon/trunk/README                            (rev 0)
+++ balloon/trunk/README    2010-02-12 16:15:18 UTC (rev 992)
@@ -0,0 +1,41 @@
+These are the sources from which all the balloon release files are made.
+
+There is some complexity about how things are built and configured.
+This readme explains the structure.
+
+Kernel: Upstream kernel is patched with quilt to include balloon and
+yaffs code. Then built, to make two images, one plain, one
+incorporating an initrd. The plain kernel goes in NAND and is used for
+normal boot. The initrd kernel goes in NOR and is used for rescue
+purposes.
+
+Initrd: This is a very small rootfs ~2MB made with buildroot and using
+uclibc. Contains enough config to set up balloon and mount a USB or
+network device in order to install real rootfs. It also contains a
+script 'setup' which knows how to load images into nand and configure
+the debian or emdebian rootfs (see below).
+
+Rootfs: Currently Debian and Emdebian rootfses are provided. Emdebian
+is the default. The makefile builds a '1st-stage debootstrap' rootfs
+for Debian and the equivalent multistrap rootfs for emdebian. This
+contains all the base/default unpacked packages, but none of them are
+configured. A script rootfs-config also makes a few changes to the
+files so that the image can be booted on a real balloon if loaded into
+nand.
+
+Normally the 1st stage image is not loaded directly into NAND - it is
+supplied on a USB drive, the setup script runs, chroots into it and
+runs the 2nd-stage debootstrap, or apt-get install -f to make it a
+fully-configured rootfs. This is then copied into flash (and saved as
+a tarball).
+
+Packages: There is a config package which exists to perform 1st-boot
+time configurations. Static config is done using the rootfs-config
+script.
+
+Balloon3-config: sets up some base files for desired networking,
+mounts, dependencies, apt config etc. The default apt config checks
+local USB drive, balloonboard.org repository, and then debian, with
+preference given to the first two sources. This alows for easy updates.
+
+cued-config: brings in various CUED packages for their standard release.