LK / classic AOSP aboot · source analysis

fastboot boot의 임시 image 실행

download buffer의 제한적인 길이 검사와 DTB·payload 복사 순서를 따라 RAM kernel handoff를 읽습니다.

AOSP LK commit 9d6e28f는 이 글의 코드 분석 기준이다. 실제 제품의 image 검증·메모리 보호·boot 권한 정책은 해당 보드 구현에서 따로 확인한다.

Series
19 / 20
Baseline
AOSP 9d6e28f
Commit
9d6e28f24ba0
Source
app/aboot/aboot.c:1211-1299 (발췌 범위)

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() 구현에 소급하지 않는다.

download buffer와 RAM 목적지를 구분

그림 1. cmd_boot()가 참조하는 입력과 목적지
입력주소 결정실행 결과
01data와 받은 길이 sz
02hdr size·address, page_size
03kernel·ramdisk·조건부 DT 목적지
04응답·USB 종료 뒤 boot_linux()
범위

실제 구현의 크기 검사를 전체 boot image·DTB·목적지 범위 보증으로 확대하지 않는다.

원본은 고정 aboot.c다. 그림은 논리적 관계이며 RAM 영역의 물리적 높낮이나 비중첩을 가정하지 않는다.

cmd_boot()의 조건부 호출 순서

그림 2. pre-copy DTB 시도와 post-copy fallback의 위치
포인터 크기 검사·header 필드 사용
raw kernel·ramdisk 길이 비교
DEVICE_TREE면 copy_dtb()
ramdisk → kernel memmove()
필요하면 appended DTB → 응답·handoff

copy_dtb()는 DEVICE_TREE 빌드에서 payload 이동 전에 호출된다. 이 시도가 실패하면 이동 후 dev_tree_appended()를 찾고, 못 찾으면 FAIL/return한다. 성공 끝의 순서는 fastboot_okay() → udc_stop() → boot_linux()다.

검사·복사·응답 경계

좁은 화면에서는 표를 좌우로 밀어 조건과 실제 보장 범위를 확인한다.

순서고정 코드의 동작실제로 확인하는 범위다음 상태
01sz < sizeof(hdr)지역 포인터 크기만 비교; 전체 header·magic 검사 아님통과 뒤 header 필드를 사용
02eMMC이고 hdr->page_size가 있으면 page size 반영; 주소 보정·VA 변환이 단계에 page size의 유효성·목적지 충돌 검사가 보이지 않음round-up 크기와 목적지 주소 계산
03page_size + kernel_actual + ramdisk_actual > szraw kernel·ramdisk 길이 비교; DT/second 범위를 포함하지 않음초과하면 FAIL/return
04DEVICE_TREE일 때 copy_dtb(data)DT table을 시도; 자체 return으로 dtb_copied 결정kernel·ramdisk 이동 이전
05ramdisk, 그다음 kernel을 memmove()요청된 byte 수 복사; 목적지 전체 충돌 검사는 별도RAM payload 배치
06DT가 복사되지 않았으면 dev_tree_appended()이동된 kernel에서 fallback 검색; 부재 시 FAIL조건부 DT 위치 결정
07fastboot_okay() → udc_stop() → boot_linux()명령 응답과 USB 종료 뒤 handoff; flash 기록 없음kernel 진입 경로

copy_dtb()의 DT table 조건과 entry offset도 받은 sz 전체에 대한 검증으로 볼 수 없다. 제품의 boot 허용 정책은 이 함수 밖의 호출 경로까지 확인한다.

입력 offset과 두 DTB 시도의 순서

아래 표시는 코드의 상대 offset과 호출 순서다. 실제 RAM 주소 배치나 모든 입력의 유효성을 뜻하지 않는다.

그림 3. download buffer의 source 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 검색

그림 4. cmd_boot()의 실제 검사와 handoff 순서

조건부 DT 단계와 제한적인 길이 검사를 별도로 표시했다.

01sz < sizeof(hdr) 포인터 크기만
02cmdline·page size·주소 보정
03kernel·ramdisk 크기 합계 비교
04DEVICE_TREE: copy_dtb() 선복사
05ramdisk → kernel 이동
06DT 미복사면 appended DTB 검색
07OKAY → udc_stop() → boot_linux()

원본 코드

아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/aboot.c에서 1211-1299줄을 그대로 가져온 것이다.

commit9d6e28f24ba01e563d0b3801c6c6c95d756db623anchor · L1235void cmd_boot(const char *arg
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;

발췌 범위와 읽기 기준

첫 발췌에는 copy_dtb() 끝과 cmd_boot() 앞부분이 함께 있다. 아래 관련 원본 발췌는 DT table offset, entry 선택 및 cmd_boot()의 포인터 크기 검사를 보여 준다.

payload 이동, appended DTB fallback, fastboot_okay()와 udc_stop()는 같은 고정 원문 뒤쪽까지 이어 읽어야 한다. 앞 발췌의 첫 줄을 cmd_boot() 시작으로 해석하지 않는다.

함께 읽어야 하는 원본 코드

첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.

01. download image 안의 DTB를 골라 handoff 위치로 복사

app/aboot/aboot.c 1169-1251줄이다.

fileapp/aboot/aboot.canchor · L1179int copy_dtb
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 */

고정 callback의 주소와 길이 처리

01

첫 검사는 header 전체 크기가 아니다

hdr가 포인터 변수이므로 sizeof(hdr)는 구조체가 아닌 포인터 크기다. 이 비교 뒤 곧바로 hdr->cmdline을 수정하고 다른 header 필드를 읽는다. 이 함수에 Android boot magic 검사도 없다.

02

page size와 목적지 주소를 header에서 얻는다

eMMC이고 hdr->page_size가 0이 아니면 전역 page size/mask를 바꾼다. kernel·ramdisk size를 round-up하고 기본 주소를 보정한 뒤 VA()로 목적지 주소를 바꾼다. page size와 목적지가 안전한지 이 단계가 독립적으로 증명하지는 않는다.

03

raw payload 비교의 대상이 제한된다

page_size + kernel_actual + ramdisk_actual > sz이면 incomplete image로 FAIL한다. 이 비교에는 second payload, DT table, DT entry 전체 길이나 RAM 목적지와 aboot 영역의 충돌이 포함되지 않는다.

04

DT table 시도는 두 payload 복사 전이다

DEVICE_TREE 빌드에서 먼저 copy_dtb(data)를 호출한다. copy_dtb()는 dt_size가 없으면 실패하고, DT table과 entry를 찾아 tags_addr로 복사한다. 그 뒤 cmd_boot()은 ramdisk, kernel 순서로 memmove()한다.

05

fallback과 응답은 복사 뒤다

DT가 복사되지 않았으면 옮겨진 kernel에서 appended DTB를 찾는다. 없으면 FAIL/return한다. 정상 경로는 fastboot_okay(""), udc_stop(), boot_linux() 순서다. USB 응답이 호스트에 실제 도달했는지는 protocol/board 동작과 별도로 대조한다.

함수 안에 없는 보증을 분리

01

DT table 검사도 전체 입력 검증이 아니다

copy_dtb()는 table entry 목록이 header 한 page보다 작은지 ASSERT하고 entry를 찾는다. 조건식은 magic과 version이 모두 불일치할 때 오류를 내며, DT table·entry의 끝이 download 길이 sz 안에 있는지 명시적으로 비교하지 않는다. 이를 종합적인 DTB 검증으로 표시하지 않는다.

02

overlap과 목적지 범위는 보드에서 확인한다

각 이동은 memmove()여서 같은 호출의 source/destination overlap에 대응한다. 그러나 ramdisk를 먼저 옮기는 동안 뒤이어 읽을 kernel source가 덮이는지, kernel·DT 목적지가 LK/stack과 충돌하는지는 실제 주소로 계산해야 한다.

03

secure boot는 이 callback의 암묵적 단계가 아니다

download image에 적용할 magic·signature·unlock 정책은 제품 요구 사항일 수 있다. 고정 cmd_boot()에 없는 검사라면 다른 계층의 근거를 찾거나 별도 추가 검증 과제로 적는다. flash를 쓰지 않는다는 사실만으로 임시 boot의 신뢰성이 보장되지는 않는다.

download 입력과 handoff 데이터

대상출처사용·변경검증할 경계
data, szfastboot download callback 인자header와 payload source첫 검사는 sizeof(hdr)만 비교
boot_img_hdr *data를 castcmdline 끝 NUL·주소 보정·VA 변환수정 전 header 전체 길이·magic 검사가 없음
kernel_actual, ramdisk_actualround-up한 header sizeraw input bound와 source offsetoverflow와 page size 유효성 별도 확인
dtb_copiedcopy_dtb() 반환후속 appended DTB fallback 결정DEVICE_TREE일 때만 사용
RAM 목적지와 USB 상태header address·fastboot transportpayload 배치 뒤 OKAY→stop→handoff목적지 충돌과 응답 전달은 별도 관측

이 코드가 거부하는 경우와 남는 위험

조건고정 코드 동작확인할 범위
sz < sizeof(hdr)invalid header FAIL/return포인터 크기보다 크다고 구조체 전체가 들어온 것은 아님
raw kernel·ramdisk 합계가 sz 초과incomplete image FAIL/returnDT·second 및 실제 destination 검사는 별도
copy_dtb() 실패즉시 중단하지 않고 복사 뒤 appended DTB 시도DT table 입력 길이·entry 검사 범위
appended DTB도 없음dtb not found FAIL/return이미 RAM으로 옮긴 payload는 되돌리지 않음

memmove()의 사용을 memcpy overlap 버그로 묘사하지 않는다. 실제 위험은 받은 입력의 검증 폭과 여러 source/destination 구간의 상호 관계에 있다.

쓰지 않고 확인할 수 있는 증거

고정 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 outpage size, kernel·ramdisk·DT 입력 offset을 계산한다. 구형 LK가 현대 형식을 지원한다는 뜻은 아니다.
transport 변수시험 기기에서 fastboot getvar product고정 aboot가 게시한 변수만 읽는다. slot/unlocked 변수는 보장하지 않는다.
실제 RAM 영역보드 linker map과 target memory mapdownload source, kernel/ramdisk/tags 목적지, LK·stack 사이의 충돌 여부를 계산한다.

시험 보드에서 분리해 볼 지점

  1. 01
    source-only 길이 검사 대조

    sizeof(hdr)와 sizeof(*hdr), raw 합계 식의 대상 byte를 기록한다. 장치 실행 없이 고정 코드를 대조한다.

  2. 02
    DT 조건별 호출 순서 계측

    복구 가능한 시험 보드에서 DEVICE_TREE 설정과 DT table 유무를 바꾸어 pre-copy copy_dtb(), post-copy appended fallback을 각각 계측한다.

  3. 03
    응답·handoff 경계 기록

    제어 가능한 시험 환경에서 fastboot_okay(), udc_stop(), boot_linux()의 시간 순서와 host 응답을 별도로 기록한다.

원문과 다음 글