QUESTION
cmd_boot()는 download image를 어디까지 확인하고 언제 실행하는가?
이 고정 버전은 flash를 쓰지 않고 download buffer에서 kernel·ramdisk를 RAM 목적지로 옮긴다. 첫 크기 검사는 sz < sizeof(hdr)로 포인터 크기를 비교한다. 전체 boot_img_hdr 크기나 Android boot magic을 검사하는 단계로 읽으면 안 된다.
뒤의 page_size + kernel_actual + ramdisk_actual > sz 검사는 raw kernel·ramdisk 입력 범위의 일부만 다룬다. DT table·second payload와 목적지 충돌까지 포괄적으로 검증했다는 뜻은 아니다.
classic AOSP aboot commit 9d6e28f에 한정한다. 현대 Android AVB·A/B 또는 제품별 secure boot 정책을 이 cmd_boot() 구현에 소급하지 않는다.
STRUCTURE
download buffer와 RAM 목적지를 구분
cmd_boot()가 참조하는 입력과 목적지data와 받은 길이 szhdr size·address, page_sizeboot_linux()실제 구현의 크기 검사를 전체 boot image·DTB·목적지 범위 보증으로 확대하지 않는다.
원본은 고정 aboot.c다. 그림은 논리적 관계이며 RAM 영역의 물리적 높낮이나 비중첩을 가정하지 않는다.
CALL PATH
cmd_boot()의 조건부 호출 순서
DEVICE_TREE면 copy_dtb()memmove()copy_dtb()는 DEVICE_TREE 빌드에서 payload 이동 전에 호출된다. 이 시도가 실패하면 이동 후 dev_tree_appended()를 찾고, 못 찾으면 FAIL/return한다. 성공 끝의 순서는 fastboot_okay() → udc_stop() → boot_linux()다.
STATE LEDGER
검사·복사·응답 경계
좁은 화면에서는 표를 좌우로 밀어 조건과 실제 보장 범위를 확인한다.
| 순서 | 고정 코드의 동작 | 실제로 확인하는 범위 | 다음 상태 |
|---|---|---|---|
| 01 | sz < sizeof(hdr) | 지역 포인터 크기만 비교; 전체 header·magic 검사 아님 | 통과 뒤 header 필드를 사용 |
| 02 | eMMC이고 hdr->page_size가 있으면 page size 반영; 주소 보정·VA 변환 | 이 단계에 page size의 유효성·목적지 충돌 검사가 보이지 않음 | round-up 크기와 목적지 주소 계산 |
| 03 | page_size + kernel_actual + ramdisk_actual > sz | raw kernel·ramdisk 길이 비교; DT/second 범위를 포함하지 않음 | 초과하면 FAIL/return |
| 04 | DEVICE_TREE일 때 copy_dtb(data) | DT table을 시도; 자체 return으로 dtb_copied 결정 | kernel·ramdisk 이동 이전 |
| 05 | ramdisk, 그다음 kernel을 memmove() | 요청된 byte 수 복사; 목적지 전체 충돌 검사는 별도 | RAM payload 배치 |
| 06 | DT가 복사되지 않았으면 dev_tree_appended() | 이동된 kernel에서 fallback 검색; 부재 시 FAIL | 조건부 DT 위치 결정 |
| 07 | fastboot_okay() → udc_stop() → boot_linux() | 명령 응답과 USB 종료 뒤 handoff; flash 기록 없음 | kernel 진입 경로 |
copy_dtb()의 DT table 조건과 entry offset도 받은 sz 전체에 대한 검증으로 볼 수 없다. 제품의 boot 허용 정책은 이 함수 밖의 호출 경로까지 확인한다.
VISUAL WALKTHROUGH
입력 offset과 두 DTB 시도의 순서
아래 표시는 코드의 상대 offset과 호출 순서다. 실제 RAM 주소 배치나 모든 입력의 유효성을 뜻하지 않는다.
raw kernel·ramdisk의 input 위치를 코드 식대로 적었다.
download buffer에서 읽기
01data 시작을 boot_img_hdr *로 사용
02kernel source: ptr + page_size
03ramdisk source: ptr + page_size + kernel_actual
04DT table offset에는 second rounded size도 더함
RAM 목적지에 쓰기
01header address 보정 뒤 VA() 적용
02copy_dtb() 성공 시 tags 위치에 DT 복사
03ramdisk를 먼저, kernel을 나중에 memmove()
04필요하면 옮겨진 kernel의 appended DTB 검색
cmd_boot()의 실제 검사와 handoff 순서조건부 DT 단계와 제한적인 길이 검사를 별도로 표시했다.
sz < sizeof(hdr) 포인터 크기만DEVICE_TREE: copy_dtb() 선복사udc_stop() → boot_linux()UPSTREAM SOURCE
원본 코드
아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/aboot.c에서 1211-1299줄을 그대로 가져온 것이다.
1211 /* Validate the device tree table header */
1212 if((table->magic != DEV_TREE_MAGIC) && (table->version != DEV_TREE_VERSION)) {
1213 dprintf(CRITICAL, "ERROR: Cannot validate Device Tree Table \n");
1214 return -1;
1215 }
1216
1217 /* Calculate the offset of device tree within device tree table */
1218 if((dt_entry_ptr = dev_tree_get_entry_ptr(table)) == NULL){
1219 dprintf(CRITICAL, "ERROR: Getting device tree address failed\n");
1220 return -1;
1221 }
1222
1223 /* Read device device tree in the "tags_add */
1224 memmove((void*) hdr->tags_addr,
1225 boot_image_start + dt_image_offset + dt_entry_ptr->offset,
1226 dt_entry_ptr->size);
1227 } else
1228 return -1;
1229
1230 /* Everything looks fine. Return success. */
1231 return 0;
1232}
1233#endif
1234
1235void cmd_boot(const char *arg, void *data, unsigned sz)
1236{
1237 unsigned kernel_actual;
1238 unsigned ramdisk_actual;
1239 struct boot_img_hdr *hdr;
1240 char *ptr = ((char*) data);
1241 int ret = 0;
1242 uint8_t dtb_copied = 0;
1243
1244 if (sz < sizeof(hdr)) {
1245 fastboot_fail("invalid bootimage header");
1246 return;
1247 }
1248
1249 hdr = (struct boot_img_hdr *)data;
1250
1251 /* ensure commandline is terminated */
1252 hdr->cmdline[BOOT_ARGS_SIZE-1] = 0;
1253
1254 if(target_is_emmc_boot() && hdr->page_size) {
1255 page_size = hdr->page_size;
1256 page_mask = page_size - 1;
1257 }
1258
1259 kernel_actual = ROUND_TO_PAGE(hdr->kernel_size, page_mask);
1260 ramdisk_actual = ROUND_TO_PAGE(hdr->ramdisk_size, page_mask);
1261
1262 /*
1263 * Update the kernel/ramdisk/tags address if the boot image header
1264 * has default values, these default values come from mkbootimg when
1265 * the boot image is flashed using fastboot flash:raw
1266 */
1267 update_ker_tags_rdisk_addr(hdr);
1268
1269 /* Get virtual addresses since the hdr saves physical addresses. */
1270 hdr->kernel_addr = VA(hdr->kernel_addr);
1271 hdr->ramdisk_addr = VA(hdr->ramdisk_addr);
1272 hdr->tags_addr = VA(hdr->tags_addr);
1273
1274 /* sz should have atleast raw boot image */
1275 if (page_size + kernel_actual + ramdisk_actual > sz) {
1276 fastboot_fail("incomplete bootimage");
1277 return;
1278 }
1279
1280#if DEVICE_TREE
1281 /* find correct dtb and copy it to right location */
1282 ret = copy_dtb(data);
1283
1284 dtb_copied = !ret ? 1 : 0;
1285#endif
1286
1287 /* Load ramdisk & kernel */
1288 memmove((void*) hdr->ramdisk_addr, ptr + page_size + kernel_actual, hdr->ramdisk_size);
1289 memmove((void*) hdr->kernel_addr, ptr + page_size, hdr->kernel_size);
1290
1291#if DEVICE_TREE
1292 /*
1293 * If dtb is not found look for appended DTB in the kernel.
1294 * If appended dev tree is found, update the atags with
1295 * memory address to the DTB appended location on RAM.
1296 * Else update with the atags address in the kernel header
1297 */
1298 if (!dtb_copied) {
1299 void *dtb;
READING CONTRACT
발췌 범위와 읽기 기준
첫 발췌에는 copy_dtb() 끝과 cmd_boot() 앞부분이 함께 있다. 아래 관련 원본 발췌는 DT table offset, entry 선택 및 cmd_boot()의 포인터 크기 검사를 보여 준다.
payload 이동, appended DTB fallback, fastboot_okay()와 udc_stop()는 같은 고정 원문 뒤쪽까지 이어 읽어야 한다. 앞 발췌의 첫 줄을 cmd_boot() 시작으로 해석하지 않는다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. download image 안의 DTB를 골라 handoff 위치로 복사
app/aboot/aboot.c 1169-1251줄이다.
1169}
1170
1171void set_device_root()
1172{
1173 dprintf(ALWAYS, "set_device_root called.");
1174 device.is_tampered = 1;
1175 write_device_info(&device);
1176}
1177
1178#if DEVICE_TREE
1179int copy_dtb(uint8_t *boot_image_start)
1180{
1181 uint32 dt_image_offset = 0;
1182 uint32_t n;
1183 struct dt_table *table;
1184 struct dt_entry *dt_entry_ptr;
1185
1186 struct boot_img_hdr *hdr = (struct boot_img_hdr *) (boot_image_start);
1187
1188 if(hdr->dt_size != 0) {
1189
1190 /* add kernel offset */
1191 dt_image_offset += page_size;
1192 n = ROUND_TO_PAGE(hdr->kernel_size, page_mask);
1193 dt_image_offset += n;
1194
1195 /* add ramdisk offset */
1196 n = ROUND_TO_PAGE(hdr->ramdisk_size, page_mask);
1197 dt_image_offset += n;
1198
1199 /* add second offset */
1200 if(hdr->second_size != 0) {
1201 n = ROUND_TO_PAGE(hdr->second_size, page_mask);
1202 dt_image_offset += n;
1203 }
1204
1205 /* offset now point to start of dt.img */
1206 table = (struct dt_table*)(boot_image_start + dt_image_offset);
1207
1208 /* Restriction that the device tree entry table should be less than a page*/
1209 ASSERT(((table->num_entries * sizeof(struct dt_entry))+ DEV_TREE_HEADER_SIZE) < hdr->page_size);
1210
1211 /* Validate the device tree table header */
1212 if((table->magic != DEV_TREE_MAGIC) && (table->version != DEV_TREE_VERSION)) {
1213 dprintf(CRITICAL, "ERROR: Cannot validate Device Tree Table \n");
1214 return -1;
1215 }
1216
1217 /* Calculate the offset of device tree within device tree table */
1218 if((dt_entry_ptr = dev_tree_get_entry_ptr(table)) == NULL){
1219 dprintf(CRITICAL, "ERROR: Getting device tree address failed\n");
1220 return -1;
1221 }
1222
1223 /* Read device device tree in the "tags_add */
1224 memmove((void*) hdr->tags_addr,
1225 boot_image_start + dt_image_offset + dt_entry_ptr->offset,
1226 dt_entry_ptr->size);
1227 } else
1228 return -1;
1229
1230 /* Everything looks fine. Return success. */
1231 return 0;
1232}
1233#endif
1234
1235void cmd_boot(const char *arg, void *data, unsigned sz)
1236{
1237 unsigned kernel_actual;
1238 unsigned ramdisk_actual;
1239 struct boot_img_hdr *hdr;
1240 char *ptr = ((char*) data);
1241 int ret = 0;
1242 uint8_t dtb_copied = 0;
1243
1244 if (sz < sizeof(hdr)) {
1245 fastboot_fail("invalid bootimage header");
1246 return;
1247 }
1248
1249 hdr = (struct boot_img_hdr *)data;
1250
1251 /* ensure commandline is terminated */
DETAILS
고정 callback의 주소와 길이 처리
첫 검사는 header 전체 크기가 아니다
hdr가 포인터 변수이므로 sizeof(hdr)는 구조체가 아닌 포인터 크기다. 이 비교 뒤 곧바로 hdr->cmdline을 수정하고 다른 header 필드를 읽는다. 이 함수에 Android boot magic 검사도 없다.
page size와 목적지 주소를 header에서 얻는다
eMMC이고 hdr->page_size가 0이 아니면 전역 page size/mask를 바꾼다. kernel·ramdisk size를 round-up하고 기본 주소를 보정한 뒤 VA()로 목적지 주소를 바꾼다. page size와 목적지가 안전한지 이 단계가 독립적으로 증명하지는 않는다.
raw payload 비교의 대상이 제한된다
page_size + kernel_actual + ramdisk_actual > sz이면 incomplete image로 FAIL한다. 이 비교에는 second payload, DT table, DT entry 전체 길이나 RAM 목적지와 aboot 영역의 충돌이 포함되지 않는다.
DT table 시도는 두 payload 복사 전이다
DEVICE_TREE 빌드에서 먼저 copy_dtb(data)를 호출한다. copy_dtb()는 dt_size가 없으면 실패하고, DT table과 entry를 찾아 tags_addr로 복사한다. 그 뒤 cmd_boot()은 ramdisk, kernel 순서로 memmove()한다.
fallback과 응답은 복사 뒤다
DT가 복사되지 않았으면 옮겨진 kernel에서 appended DTB를 찾는다. 없으면 FAIL/return한다. 정상 경로는 fastboot_okay(""), udc_stop(), boot_linux() 순서다. USB 응답이 호스트에 실제 도달했는지는 protocol/board 동작과 별도로 대조한다.
IMPLEMENTATION NOTES
함수 안에 없는 보증을 분리
DT table 검사도 전체 입력 검증이 아니다
copy_dtb()는 table entry 목록이 header 한 page보다 작은지 ASSERT하고 entry를 찾는다. 조건식은 magic과 version이 모두 불일치할 때 오류를 내며, DT table·entry의 끝이 download 길이 sz 안에 있는지 명시적으로 비교하지 않는다. 이를 종합적인 DTB 검증으로 표시하지 않는다.
overlap과 목적지 범위는 보드에서 확인한다
각 이동은 memmove()여서 같은 호출의 source/destination overlap에 대응한다. 그러나 ramdisk를 먼저 옮기는 동안 뒤이어 읽을 kernel source가 덮이는지, kernel·DT 목적지가 LK/stack과 충돌하는지는 실제 주소로 계산해야 한다.
secure boot는 이 callback의 암묵적 단계가 아니다
download image에 적용할 magic·signature·unlock 정책은 제품 요구 사항일 수 있다. 고정 cmd_boot()에 없는 검사라면 다른 계층의 근거를 찾거나 별도 추가 검증 과제로 적는다. flash를 쓰지 않는다는 사실만으로 임시 boot의 신뢰성이 보장되지는 않는다.
OBJECT LIFETIME
download 입력과 handoff 데이터
| 대상 | 출처 | 사용·변경 | 검증할 경계 |
|---|---|---|---|
data, sz | fastboot download callback 인자 | header와 payload source | 첫 검사는 sizeof(hdr)만 비교 |
boot_img_hdr * | data를 cast | cmdline 끝 NUL·주소 보정·VA 변환 | 수정 전 header 전체 길이·magic 검사가 없음 |
kernel_actual, ramdisk_actual | round-up한 header size | raw input bound와 source offset | overflow와 page size 유효성 별도 확인 |
dtb_copied | copy_dtb() 반환 | 후속 appended DTB fallback 결정 | DEVICE_TREE일 때만 사용 |
| RAM 목적지와 USB 상태 | header address·fastboot transport | payload 배치 뒤 OKAY→stop→handoff | 목적지 충돌과 응답 전달은 별도 관측 |
FAILURE PATH
이 코드가 거부하는 경우와 남는 위험
| 조건 | 고정 코드 동작 | 확인할 범위 |
|---|---|---|
sz < sizeof(hdr) | invalid header FAIL/return | 포인터 크기보다 크다고 구조체 전체가 들어온 것은 아님 |
raw kernel·ramdisk 합계가 sz 초과 | incomplete image FAIL/return | DT·second 및 실제 destination 검사는 별도 |
copy_dtb() 실패 | 즉시 중단하지 않고 복사 뒤 appended DTB 시도 | DT table 입력 길이·entry 검사 범위 |
| appended DTB도 없음 | dtb not found FAIL/return | 이미 RAM으로 옮긴 payload는 되돌리지 않음 |
memmove()의 사용을 memcpy overlap 버그로 묘사하지 않는다. 실제 위험은 받은 입력의 검증 폭과 여러 source/destination 구간의 상호 관계에 있다.
EVIDENCE
쓰지 않고 확인할 수 있는 증거
고정 source와 시험 장치의 빌드·주소 정보를 대조한다. 아래 단계는 flash storage를 쓰지 않는다.
| 목적 | 읽기 전용 자료·명령 | 판정 기준 |
|---|---|---|
| ELF 함수명 | nm -n build-*/lk.elf | grep -E ' cmd_boot$| copy_dtb$' | 해당 빌드에 callback과 조건부 DT helper가 있는지 확인한다. |
| host image 구조 | host에서 unpack_bootimg --boot_img boot.img --out out | page size, kernel·ramdisk·DT 입력 offset을 계산한다. 구형 LK가 현대 형식을 지원한다는 뜻은 아니다. |
| transport 변수 | 시험 기기에서 fastboot getvar product | 고정 aboot가 게시한 변수만 읽는다. slot/unlocked 변수는 보장하지 않는다. |
| 실제 RAM 영역 | 보드 linker map과 target memory map | download source, kernel/ramdisk/tags 목적지, LK·stack 사이의 충돌 여부를 계산한다. |
LAB
시험 보드에서 분리해 볼 지점
- 01source-only 길이 검사 대조
sizeof(hdr)와sizeof(*hdr), raw 합계 식의 대상 byte를 기록한다. 장치 실행 없이 고정 코드를 대조한다. - 02DT 조건별 호출 순서 계측
복구 가능한 시험 보드에서
DEVICE_TREE설정과 DT table 유무를 바꾸어 pre-copycopy_dtb(), post-copy appended fallback을 각각 계측한다. - 03응답·handoff 경계 기록
제어 가능한 시험 환경에서
fastboot_okay(),udc_stop(),boot_linux()의 시간 순서와 host 응답을 별도로 기록한다.
PRIMARY REFERENCES