Differences

This shows you the differences between two versions of the page.

--- abootimg [2012/02/14 22:41] – [Usage] armelf
+++ abootimg [2012/02/15 00:35] – [Usage] armelf
@@ Line 3: / Line 3: @@
 project's home page http://gitorious.org/ac100/abootimg
 ====== Introduction ======
-abootimg is a tool created by Gilles Grandou for manipulating Android Boot Images directly from the AC100 (Be carefull to not mess your bootimg or you will need NVidia's [[nvflash]] to flash again a bootable image). abootimg can work directly on block devices, or, the safest way,  on a file image.
+**abootimg** is a tool created by Gilles Grandou for manipulating Android Boot Images directly from the AC100 (Be carefull to not mess your bootimg otherwise you will need the free tool [[putusb]] or the proprietary NVidia's [[nvflash]] to flash again a bootable image). abootimg can work directly on block devices, or, the safest way, on a file image.
-For further informations, read the [[http://gitorious.org/ac100/abootimg/blobs/master/README|README]].
+For further informations, enter **abootimg -h** in a terminal or read the [[http://gitorious.org/ac100/abootimg/blobs/master/README|README]].
 ====== Usage ======
@@ Line 12: / Line 12: @@
 abootimg -i /dev/mmcblk0p2
 </code>
-here is the output for an AC100-114:
+  *extracting current bootable image
+<code>
+cd /tmp/bootimg
+abootimg -x /dev/mmcblk0p2
+</code>
+  *updating the kernel on a copy of the current bootable image
+<code>
+  dd if=/dev/mmcblk0p2 of=/tmp/part-6.img
+  abootimg -u /tmp/part-6.img -k /boot/vmlinuz
+</code>
+<html>
+<span style="color:red;font-size:150%;font-weight:bold;">WARNING</span>
+</html>
+: if you want to modify **/dev/mmcblk0p2**, DO A BACKUP BEFORE AND STORE IT ON REMOVABLE MEDIA!
+===== Output examples =====
+below there is the output of the previous commands for an AC100-114:
 <code>
 root@ac100:/tmp/bootimg# abootimg -i /dev/mmcblk0p2
@@ Line 36: / Line 51: @@
 * id = 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
-</code>
-  *extracting current bootable image
-<code>
-cd /tmp/bootimg
-abootimg -x /dev/mmcblk0p2
-</code>
-here is the result and files extracted:
-<code>
 root@ac100:/tmp/bootimg# abootimg -x /dev/mmcblk0p2
 writing boot image config in bootimg.cfg
@@ Line 52: / Line 60: @@
 initrd.img
 zImage
+root@ac100:/tmp/bootimg# dd if=/dev/mmcblk0p2 of=/tmp/part-6.img
++0 records in
++0 records out
+8388608 bytes (8.4 MB) copied, 0.430688 s, 19.5 MB/s
+root@ac100:/tmp/bootimg# abootimg -u /tmp/part-6.img -k /boot/vmlinuz-2.6.38-1001-ac100
+reading kernel from /boot/vmlinuz-2.6.38-1001-ac100
+Writing Boot Image /tmp/part-6.img
 </code>
-  *updating the kernel on a copy of the current bootable image
+====== Compiling ======
+if your distribution don't provide this tool, follow this method to compile it under [[installing_linux#ubuntu_oneiric|Ubuntu Oneiric]]:
 <code>
-  dd if=/dev/mmcblk0p2 of=/tmp/part-6.img
+apt-get install libblkid-dev
-  abootimg -u /tmp/part-6.img -k /boot/vmlinuz
+git clone git://gitorious.org/ac100/abootimg.git
+cd abootimg
+make
+cp -p abootimg /usr/local/sbin
 </code>
+====== References ======
+[[http://android.git.kernel.org/?p=platform/system/core.git;a=tree;f=mkbootimg|The official tool used to create boot images is part of the Android Project]]
+[[http://android-dls.com/wiki/index.php?title=HOWTO:_Unpack%2C_Edit%2C_and_Re-Pack_Boot_Images#Alternative_Method|HOWTO: Unpack, Edit, and Re-Pack Boot Images]]
 ====== Greatings ======
 Thank you very much for this great tools ggrandou! ;-)