LK / classic AOSP aboot · source analysis

classic aboot의 Linux 진입

ATAG 또는 DT 주소, machine type과 kernel entry를 준비하고 cache/MMU를 정리해 Linux로 분기하는 코드를 읽습니다.

고정 AOSP LK 9d6e28f의 classic ARM handoff 분석이다. 현재 제품의 보안 권고나 모든 target의 정상 부팅 검증 결과가 아니다.

Series
17 / 20
Baseline
AOSP 9d6e28f
Commit
9d6e28f24ba0
Source
app/aboot/aboot.c:423-511 (발췌 범위)

boot_linux()는 주소와 부팅 인자를 어떻게 넘기는가?

고정 AOSP aboot의 boot_linux()는 이미 적재된 kernel·ramdisk와 쓰기 가능한 tags 버퍼를 받는다. 이 함수 자체가 image를 읽거나 인증·복사하는 loader는 아니다. PA()로 entry·tags·ramdisk의 물리 주소를 계산하고 command line을 확장한다.

DEVICE_TREE이면 기존 DT를 갱신하고, 아니면 ATAG 목록을 쓴다. 그 뒤 critical section, platform 정리, cache 비활성화, 조건부 MMU 비활성화, timestamp, entry(0, machtype, tags_phys) 순서다.

분석 범위는 classic 32-bit ARM 호출 계약이다. 현대 Android A/B·AVB·GKI나 AArch64 인자 계약으로 일반화하지 않는다. 근거는 고정 aboot.c의 boot_linux()와 같은 버전 bootimg.h의 r0–r2 설명이다.

호출자 주소, 쓰는 버퍼, 최종 전달값

그림 1. 주소 변환과 데이터 작성은 다른 동작이다
호출자 입력함수 내부kernel 호출
01kernel · tags · ramdisk
02PA 주소 계산 · cmdline 확장
03tags에 DT 갱신 또는 ATAG 작성
04entry(0, machtype, tags_phys)
구분

tags는 DT/ATAG를 쓰는 접근 주소, tags_phys는 kernel에 넘길 물리 주소다. PA() 계산만으로 payload가 이동하지 않는다.

블록 배치는 RAM 주소의 높낮이를 뜻하지 않는다. kernel·ramdisk·tags·aboot의 실제 범위와 비중첩 여부는 사용 target의 map 및 호출자 적재 코드로 확인한다.

인자 작성 뒤 공통 종료 경로

그림 2. boot_linux()의 호출 순서
01PA 주소 계산·update_cmdline()
02DT 갱신 또는 ATAG 작성
03critical section·platform_uninit()
04cache off·조건부 MMU off
05timestamp·entry 호출

이 함수는 void이며 각 단계의 성공 코드를 받아 일반적인 오류 정리를 하는 구조가 아니다. DT 갱신 오류는 ASSERT(0)이다. platform_uninit()의 실제 장치 처리와 cache helper 내부 동작은 target·architecture 구현의 별도 계약이다.

소스에서 확인되는 값과 작성 대상

순서입력·조건이 함수의 동작구분할 한계
01kernel, tags, ramdiskentry=PA(kernel), tags_phys=PA(tags), ramdisk=PA(ramdisk)주소 계산; image 로드·검증 아님
02cmdline와 target 상태update_cmdline()으로 새 문자열 구성malloc 결과는 helper에서 ASSERT; 여기서 반환 오류 처리 없음
03DEVICE_TREEupdate_device_tree(tags, final_cmdline, ramdisk, size)오류면 ASSERT(0); 별도 buffer 재할당을 이 함수에서 하지 않음
04DEVICE_TREE가 아님generate_atags(tags, final_cmdline, ramdisk, size)DT 경로와 택일; tags capacity 인자 없음
05인자 작성 이후enter_critical_section(); platform_uninit(); arch_disable_cache(UCACHE)구체적 IRQ·장치·cache 유지 동작은 구현별 확인
06ARM_WITH_MMU인 빌드arch_disable_mmu()무조건 수행되는 단계가 아님
07공통 마지막timestamp 기록; entry(0, machtype, tags_phys)정상 kernel 진입은 복귀를 기대하지 않으나 코드에는 반환 후 명시적 halt 없음

물리 배치 대신 실제 데이터 관계를 보기

그림 3. 접근 주소와 전달 주소의 구분

aboot가 접근·작성할 값

kernel호출자가 이미 적재한 entry 주소

tags기존 DT 갱신 또는 새 ATAG 작성

cmdlinetarget 조건을 더한 새 문자열

kernel 진입에 쓸 값

entryPA(kernel)

r0/r10 / machtype

r2tags_phys = PA(tags)

그림 4. DT/ATAG 선택과 공통 handoff
공통 준비PA 주소 계산 → update_cmdline()
#if DEVICE_TREEupdate_device_tree()tags 버퍼를 갱신한다. 반환 오류는 ASSERT(0).
#elsegenerate_atags()CORE → 조건부 RAMDISK → target memory → 조건부 NAND partition → CMDLINE → END.

두 분기는 동시에 실행되지 않는다. 다음 단계에서는 같은 tags_phys를 전달한다.

01enter_critical_section()
02platform_uninit()
03arch_disable_cache(UCACHE)
04ARM_WITH_MMU이면 MMU off
05timestamp → entry 호출

원본 코드

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

commit9d6e28f24ba01e563d0b3801c6c6c95d756db623anchor · L447void boot_linux(void *kernel
423	*ptr++ = 0;
424	*ptr++ = 0;
425
426	return ptr;
427}
428
429void generate_atags(unsigned *ptr, const char *cmdline,
430                    void *ramdisk, unsigned ramdisk_size)
431{
432
433	ptr = atag_core(ptr);
434	ptr = atag_ramdisk(ptr, ramdisk, ramdisk_size);
435	ptr = target_atag_mem(ptr);
436
437	/* Skip NAND partition ATAGS for eMMC boot */
438	if (!target_is_emmc_boot()){
439		ptr = atag_ptable(&ptr);
440	}
441
442	ptr = atag_cmdline(ptr, cmdline);
443	ptr = atag_end(ptr);
444}
445
446typedef void entry_func_ptr(unsigned, unsigned, unsigned*);
447void boot_linux(void *kernel, unsigned *tags,
448		const char *cmdline, unsigned machtype,
449		void *ramdisk, unsigned ramdisk_size)
450{
451	unsigned char *final_cmdline;
452#if DEVICE_TREE
453	int ret = 0;
454#endif
455
456	void (*entry)(unsigned, unsigned, unsigned*) = (entry_func_ptr*)(PA((addr_t)kernel));
457	uint32_t tags_phys = PA((addr_t)tags);
458
459	ramdisk = PA(ramdisk);
460
461	final_cmdline = update_cmdline((const char*)cmdline);
462
463#if DEVICE_TREE
464	dprintf(INFO, "Updating device tree: start\n");
465
466	/* Update the Device Tree */
467	ret = update_device_tree((void *)tags, final_cmdline, ramdisk, ramdisk_size);
468	if(ret)
469	{
470		dprintf(CRITICAL, "ERROR: Updating Device Tree Failed \n");
471		ASSERT(0);
472	}
473	dprintf(INFO, "Updating device tree: done\n");
474#else
475	/* Generating the Atags */
476	generate_atags(tags, final_cmdline, ramdisk, ramdisk_size);
477#endif
478
479	dprintf(INFO, "booting linux @ %p, ramdisk @ %p (%d), tags/device tree @ %p\n",
480		entry, ramdisk, ramdisk_size, tags_phys);
481
482	enter_critical_section();
483
484	/* do any platform specific cleanup before kernel entry */
485	platform_uninit();
486
487	arch_disable_cache(UCACHE);
488
489#if ARM_WITH_MMU
490	arch_disable_mmu();
491#endif
492	bs_set_timestamp(BS_KERNEL_ENTRY);
493	entry(0, machtype, (unsigned*)tags_phys);
494}
495
496unsigned page_size = 0;
497unsigned page_mask = 0;
498
499#define ROUND_TO_PAGE(x,y) (((x) + (y)) & (~(y)))
500
501static unsigned char buf[4096]; //Equal to max-supported pagesize
502#if DEVICE_TREE
503static unsigned char dt_buf[4096];
504#endif
505
506int boot_linux_from_mmc(void)
507{
508	struct boot_img_hdr *hdr = (void*) buf;
509	struct boot_img_hdr *uhdr;
510	unsigned offset = 0;
511	unsigned long long ptn = 0;

발췌 범위와 읽기 기준

원문 423-511줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 void boot_linux(void *kernel은 L447에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.

함수 포인터 호출 한 줄보다 그 직전의 장치 종료와 cache 처리, argument register 계약이 중요하다. 32-bit ARM boot protocol이라는 시대적 범위도 표시한다.

함께 읽어야 하는 원본 코드

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

01. DTB를 쓰지 않는 경로의 ATAG 목록 생성

app/aboot/aboot.c 419-493줄이다.

fileapp/aboot/aboot.canchor · L429void generate_atags
419
420unsigned *atag_end(unsigned *ptr)
421{
422	/* END */
423	*ptr++ = 0;
424	*ptr++ = 0;
425
426	return ptr;
427}
428
429void generate_atags(unsigned *ptr, const char *cmdline,
430                    void *ramdisk, unsigned ramdisk_size)
431{
432
433	ptr = atag_core(ptr);
434	ptr = atag_ramdisk(ptr, ramdisk, ramdisk_size);
435	ptr = target_atag_mem(ptr);
436
437	/* Skip NAND partition ATAGS for eMMC boot */
438	if (!target_is_emmc_boot()){
439		ptr = atag_ptable(&ptr);
440	}
441
442	ptr = atag_cmdline(ptr, cmdline);
443	ptr = atag_end(ptr);
444}
445
446typedef void entry_func_ptr(unsigned, unsigned, unsigned*);
447void boot_linux(void *kernel, unsigned *tags,
448		const char *cmdline, unsigned machtype,
449		void *ramdisk, unsigned ramdisk_size)
450{
451	unsigned char *final_cmdline;
452#if DEVICE_TREE
453	int ret = 0;
454#endif
455
456	void (*entry)(unsigned, unsigned, unsigned*) = (entry_func_ptr*)(PA((addr_t)kernel));
457	uint32_t tags_phys = PA((addr_t)tags);
458
459	ramdisk = PA(ramdisk);
460
461	final_cmdline = update_cmdline((const char*)cmdline);
462
463#if DEVICE_TREE
464	dprintf(INFO, "Updating device tree: start\n");
465
466	/* Update the Device Tree */
467	ret = update_device_tree((void *)tags, final_cmdline, ramdisk, ramdisk_size);
468	if(ret)
469	{
470		dprintf(CRITICAL, "ERROR: Updating Device Tree Failed \n");
471		ASSERT(0);
472	}
473	dprintf(INFO, "Updating device tree: done\n");
474#else
475	/* Generating the Atags */
476	generate_atags(tags, final_cmdline, ramdisk, ramdisk_size);
477#endif
478
479	dprintf(INFO, "booting linux @ %p, ramdisk @ %p (%d), tags/device tree @ %p\n",
480		entry, ramdisk, ramdisk_size, tags_phys);
481
482	enter_critical_section();
483
484	/* do any platform specific cleanup before kernel entry */
485	platform_uninit();
486
487	arch_disable_cache(UCACHE);
488
489#if ARM_WITH_MMU
490	arch_disable_mmu();
491#endif
492	bs_set_timestamp(BS_KERNEL_ENTRY);
493	entry(0, machtype, (unsigned*)tags_phys);

인자 변환과 데이터 생성의 실제 구현

01

PA 변환은 복사가 아니다

entry와 tags_phys를 먼저 계산하고 ramdisk를 물리 주소로 바꾼다. tags를 넘기는 DT/ATAG helper는 원래 접근 주소를 사용하며 마지막 entry 호출에는 tags_phys를 준다. 주소 매핑의 성립은 호출자와 target 전제다.

02

command line은 target 조건을 더해 새로 만든다

update_cmdline()은 기존 문자열, eMMC 여부, serial, 충전 대기, signed-kernel 인증 상태, baseband에 따라 길이와 내용을 구성한다. 메모리를 할당하고 NULL이면 ASSERT한다. boot_linux()에는 final_cmdline을 free하는 후처리나 recoverable allocation-error 반환 경로가 없다.

03

DT와 ATAG는 빌드 시 선택된다

DEVICE_TREE에서는 update_device_tree()의 오류를 확인하고 ASSERT(0)한다. 다른 빌드는 generate_atags()로 CORE, 크기가 있을 때 RAMDISK, target_atag_mem(), 비-eMMC일 때 partition, CMDLINE, END를 순서대로 쓴다. 이 함수에는 tags 버퍼 용량 인자가 없다.

04

공통 종료 순서를 그대로 추적한다

enter_critical_section(), platform_uninit(), arch_disable_cache(UCACHE), ARM_WITH_MMU일 때 arch_disable_mmu(), timestamp, entry 호출 순서다. USB 중지는 cmd_boot() 같은 호출자에서 이 함수 진입 전에 수행될 수 있으며 boot_linux()의 공통 직접 호출이 아니다.

05

entry 반환을 처리하는 코드가 없다

entry는 void 반환 함수 포인터로 호출된다. 실제 kernel 진입은 복귀를 기대하지 않는 계약이지만 이 C 함수에는 호출 이후 panic이나 무한 정지가 없다. 반환하면 함수 끝으로 흐른다는 소스 사실과 제품의 비복귀 요구를 구별한다.

보장하지 않는 내용을 보장으로 쓰지 않기

01

machine type을 만드는 단계는 platform_uninit()이 아니다

machtype은 boot_linux()의 인자이며 마지막 entry 호출까지 전달된다. platform_uninit()이 machine type을 생산한다는 상태표는 맞지 않는다. 호출자들은 board_machtype()을 전달한다.

02

수명과 소유권은 실제 객체로 한정한다

이 함수에는 등록 list나 child/reference 공개·회수 단계가 없다. 살아 있어야 할 대상은 entry가 가리키는 kernel, tags 버퍼, ramdisk, 그리고 DT/ATAG 작성 동안 필요한 command line이다. 장치 정리의 전체 보장은 platform 구현과 실제 target 상태로 별도 검증한다.

03

32-bit 호출과 다른 architecture 계약을 분리한다

같은 버전 bootimg.h는 r0=0, r1=MACHINE_TYPE, r2=tags_addr를 설명한다. 이 함수는 그 세 인자 형태로 호출하며 AArch64의 x0–x3 계약을 구현한 함수로 해석하지 않는다. header에 second-stage field가 있다는 사실도 이 함수에 second-stage 선택 코드가 있다는 뜻은 아니다.

실제로 쓰이는 값과 버퍼

대상출처소비 위치제약
entryPA(kernel)마지막 함수 포인터 호출kernel 내용은 호출자가 적재; 여기서 signature 검사 안 함
tags / tags_phys호출자 tags / PA(tags)DT·ATAG 작성 / entry 세 번째 인자쓰는 주소와 넘기는 주소를 구별; 용량·배치 전제는 외부
ramdisk / ramdisk_size호출자 / PA 변환DT 또는 ATAG에 기록할 인자이 함수에서 ramdisk payload 복사 안 함
final_cmdlineupdate_cmdline()의 할당 문자열DT/ATAG helperhelper malloc ASSERT; 반환 후 free 없음
machtype호출자 인자entry 두 번째 인자platform cleanup의 산출물이 아님

실제 실패 처리와 외부 전제

조건소스에서 보이는 처리남는 확인
command line 할당 실패update_cmdline()에서 ASSERT(dst != NULL)일반 오류 반환·역순 정리 경로로 묘사하지 않기
DT 갱신 helper 오류로그와 ASSERT(0)ATAG fallback으로 전환하지 않음
tags capacity 부족·잘못된 주소이 함수는 별도 capacity·범위 검사를 하지 않음target 버퍼 크기·mapping·호출자 검증
platform·cache 상태가 기대와 다름고정 helper 호출 순서만 확인 가능사용 target 구현과 관측값 필요
kernel entry가 반환명시적 halt/panic 없이 함수 끝정상 비복귀 계약 위반과 실제 반환 코드 구별

원문 검토는 실기기 정상 부팅 증거가 아니다. board map, register, cache·interrupt 상태를 계측하지 않았으면 확인 완료로 적지 않는다.

고정 원문과 검증 범위

질문근거확인 내용
entry 인자·종료 순서aboot.c boot_linux()PA 변환, DT/ATAG 택일, critical→platform→cache→MMU조건→timestamp→entry
ATAG 항목generate_atags()ramdisk size와 eMMC 여부에 따른 조건부 항목
문자열 소유권update_cmdline()조건부 문자열, malloc, ASSERT, 반환
32-bit 인자 계약bootimg.hr0/r1/r2 설명과 함수 호출의 대응
실제 주소·상태사용 target의 map, 호출자, debugger 기록RAM 배치·hardware quiesce·cache 효과는 이 페이지의 실행 확인 결과가 아님

실행 결과와 구별한 확인 계획

01

소스만으로 분기표 작성

DEVICE_TREE와 ARM_WITH_MMU의 네 조합에서 실행되는 helper를 표로 만든다. DT 오류를 ATAG fallback 또는 일반 오류 정리로 추가하지 않는다.

02

대상 빌드의 주소 대조

map과 호출자 코드에서 kernel·ramdisk·tags·aboot의 실제 시작과 끝을 구한다. 그림의 세로 순서를 RAM 주소라고 사용하지 않는다.

03

복구 가능한 시험 환경에서 handoff 관측

기존 debugger나 계측으로 entry 직전의 인자와 platform·cache·MMU 상태를 기록한다. 장치 쓰기, 잘못된 image 실행, 보안 정책 변경을 이 문서 검토의 일부로 수행하지 않는다.

원문과 다음 글