| /* |
| * Copyright (C) 2008 The Android Open Source Project |
| * All rights reserved. |
| * Copyright (c) 2009, The Linux Foundation. All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * * Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * * Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in |
| * the documentation and/or other materials provided with the |
| * distribution. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS |
| * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE |
| * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, |
| * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
| * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS |
| * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED |
| * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, |
| * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT |
| * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
| * SUCH DAMAGE. |
| */ |
| |
| #ifndef _BOOT_IMAGE_H_ |
| #define _BOOT_IMAGE_H_ |
| |
| typedef struct boot_img_hdr boot_img_hdr; |
| |
| #define BOOT_MAGIC "ANDROID!" |
| #define BOOT_MAGIC_SIZE 8 |
| #define BOOT_NAME_SIZE 16 |
| #define BOOT_ARGS_SIZE 512 |
| |
| struct boot_img_hdr |
| { |
| unsigned char magic[BOOT_MAGIC_SIZE]; |
| |
| unsigned kernel_size; /* size in bytes */ |
| unsigned kernel_addr; /* physical load addr */ |
| |
| unsigned ramdisk_size; /* size in bytes */ |
| unsigned ramdisk_addr; /* physical load addr */ |
| |
| unsigned second_size; /* size in bytes */ |
| unsigned second_addr; /* physical load addr */ |
| |
| unsigned tags_addr; /* physical addr for kernel tags */ |
| unsigned page_size; /* flash page size we assume */ |
| unsigned unused[2]; /* future expansion: should be 0 */ |
| |
| unsigned char name[BOOT_NAME_SIZE]; /* asciiz product name */ |
| |
| unsigned char cmdline[BOOT_ARGS_SIZE]; |
| |
| unsigned id[8]; /* timestamp / checksum / sha1 / etc */ |
| }; |
| |
| /* |
| ** +-----------------+ |
| ** | boot header | 1 page |
| ** +-----------------+ |
| ** | kernel | n pages |
| ** +-----------------+ |
| ** | ramdisk | m pages |
| ** +-----------------+ |
| ** | second stage | o pages |
| ** +-----------------+ |
| ** |
| ** n = (kernel_size + page_size - 1) / page_size |
| ** m = (ramdisk_size + page_size - 1) / page_size |
| ** o = (second_size + page_size - 1) / page_size |
| ** |
| ** 0. all entities are page_size aligned in flash |
| ** 1. kernel and ramdisk are required (size != 0) |
| ** 2. second is optional (second_size == 0 -> no second) |
| ** 3. load each element (kernel, ramdisk, second) at |
| ** the specified physical address (kernel_addr, etc) |
| ** 4. prepare tags at tag_addr. kernel_args[] is |
| ** appended to the kernel commandline in the tags. |
| ** 5. r0 = 0, r1 = MACHINE_TYPE, r2 = tags_addr |
| ** 6. if second_size != 0: jump to second_addr |
| ** else: jump to kernel_addr |
| */ |
| |
| boot_img_hdr *mkbootimg(void *kernel, unsigned kernel_size, |
| void *ramdisk, unsigned ramdisk_size, |
| void *second, unsigned second_size, |
| unsigned page_size, |
| unsigned *bootimg_size); |
| |
| void bootimg_set_cmdline(boot_img_hdr *hdr, const char *cmdline); |
| #endif |
| |