Add kernel-rebuilding script for the emulator.

Supports both arm and x86.

Change-Id: Ib4665eece4433f0a611b5420ef29785eeb26de1a

1 files changed, 32 insertions, 1 deletions

diff --git a/docs/KERNEL.TXT b/docs/KERNEL.TXT
index e174fe5..35d1f1f 100644
--- a/docs/KERNEL.TXT
+++ b/docs/KERNEL.TXT
@@ -1,6 +1,37 @@
 HOW TO REBUILT THE ANDROID EMULATOR-SPECIFIC KERNEL:
 ====================================================
 
+I. Helper script:
+-----------------
+
+We now provide a helper script to rebuild the kernel,
+it is under distrib/rebuild-kernel.sh.
+
+You need the sources in android.git.kernel.org/kernel/common.git,
+in branch origin/archive/android-gldfish-2.6.29 (note the typo!)
+
+To rebuild the ARM kernel:
+
+  cd $KERNEL_SOURCES
+  /path/to/rebuild-kernel.sh --out=$ANDROID/prebuilt/android-arm/kernel
+
+To rebuild the x86 kernel:
+
+  cd $KERNEL_SOURCES
+  /path/to/rebuild-kernel.sh --arch=x86 --out=$ANDROID/prebuilt/android-x86/kernel
+
+Note that you will need to have your cross-toolchain in your path.
+If this is not the case, the script will complain and give you the
+expected name. Use --cross=<prefix> to specify a different toolchain.
+
+See rebuild-kernel.sh --help for more options and details.
+
+
+II. Rebuilding from scratch:
+----------------------------
+
+If you don't or can't use the script, here are manual instructions:
+
 You need to have the Android toolchain in your path
 (i.e. 'arm-eabi-gcc --version' must work)
 
@@ -8,7 +39,7 @@ then:
 
 git clone git://android.git.kernel.org/kernel/common.git kernel-common
 cd kernel-common
-git checkout origin/android-goldfish-2.6.29
+git checkout origin/archive/android-gldfish-2.6.29
 
 export CROSS_COMPILE=arm-eabi-
 export ARCH=arm