QUESTION
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 설명이다.
STRUCTURE
호출자 주소, 쓰는 버퍼, 최종 전달값
tags는 DT/ATAG를 쓰는 접근 주소, tags_phys는 kernel에 넘길 물리 주소다. PA() 계산만으로 payload가 이동하지 않는다.
블록 배치는 RAM 주소의 높낮이를 뜻하지 않는다. kernel·ramdisk·tags·aboot의 실제 범위와 비중첩 여부는 사용 target의 map 및 호출자 적재 코드로 확인한다.
CALL PATH
인자 작성 뒤 공통 종료 경로
이 함수는 void이며 각 단계의 성공 코드를 받아 일반적인 오류 정리를 하는 구조가 아니다. DT 갱신 오류는 ASSERT(0)이다. platform_uninit()의 실제 장치 처리와 cache helper 내부 동작은 target·architecture 구현의 별도 계약이다.
STATE LEDGER
소스에서 확인되는 값과 작성 대상
| 순서 | 입력·조건 | 이 함수의 동작 | 구분할 한계 |
|---|---|---|---|
| 01 | kernel, tags, ramdisk | entry=PA(kernel), tags_phys=PA(tags), ramdisk=PA(ramdisk) | 주소 계산; image 로드·검증 아님 |
| 02 | cmdline와 target 상태 | update_cmdline()으로 새 문자열 구성 | malloc 결과는 helper에서 ASSERT; 여기서 반환 오류 처리 없음 |
| 03 | DEVICE_TREE | update_device_tree(tags, final_cmdline, ramdisk, size) | 오류면 ASSERT(0); 별도 buffer 재할당을 이 함수에서 하지 않음 |
| 04 | DEVICE_TREE가 아님 | generate_atags(tags, final_cmdline, ramdisk, size) | DT 경로와 택일; tags capacity 인자 없음 |
| 05 | 인자 작성 이후 | enter_critical_section(); platform_uninit(); arch_disable_cache(UCACHE) | 구체적 IRQ·장치·cache 유지 동작은 구현별 확인 |
| 06 | ARM_WITH_MMU인 빌드 | arch_disable_mmu() | 무조건 수행되는 단계가 아님 |
| 07 | 공통 마지막 | timestamp 기록; entry(0, machtype, tags_phys) | 정상 kernel 진입은 복귀를 기대하지 않으나 코드에는 반환 후 명시적 halt 없음 |
VISUAL WALKTHROUGH
물리 배치 대신 실제 데이터 관계를 보기
aboot가 접근·작성할 값
kernel호출자가 이미 적재한 entry 주소
tags기존 DT 갱신 또는 새 ATAG 작성
cmdlinetarget 조건을 더한 새 문자열
kernel 진입에 쓸 값
entryPA(kernel)
r0/r10 / machtype
r2tags_phys = PA(tags)
두 분기는 동시에 실행되지 않는다. 다음 단계에서는 같은 tags_phys를 전달한다.
UPSTREAM SOURCE
원본 코드
아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/aboot.c에서 423-511줄을 그대로 가져온 것이다.
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;
READING CONTRACT
발췌 범위와 읽기 기준
원문 423-511줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 void boot_linux(void *kernel은 L447에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.
함수 포인터 호출 한 줄보다 그 직전의 장치 종료와 cache 처리, argument register 계약이 중요하다. 32-bit ARM boot protocol이라는 시대적 범위도 표시한다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. DTB를 쓰지 않는 경로의 ATAG 목록 생성
app/aboot/aboot.c 419-493줄이다.
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);
DETAILS
인자 변환과 데이터 생성의 실제 구현
PA 변환은 복사가 아니다
entry와 tags_phys를 먼저 계산하고 ramdisk를 물리 주소로 바꾼다. tags를 넘기는 DT/ATAG helper는 원래 접근 주소를 사용하며 마지막 entry 호출에는 tags_phys를 준다. 주소 매핑의 성립은 호출자와 target 전제다.
command line은 target 조건을 더해 새로 만든다
update_cmdline()은 기존 문자열, eMMC 여부, serial, 충전 대기, signed-kernel 인증 상태, baseband에 따라 길이와 내용을 구성한다. 메모리를 할당하고 NULL이면 ASSERT한다. boot_linux()에는 final_cmdline을 free하는 후처리나 recoverable allocation-error 반환 경로가 없다.
DT와 ATAG는 빌드 시 선택된다
DEVICE_TREE에서는 update_device_tree()의 오류를 확인하고 ASSERT(0)한다. 다른 빌드는 generate_atags()로 CORE, 크기가 있을 때 RAMDISK, target_atag_mem(), 비-eMMC일 때 partition, CMDLINE, END를 순서대로 쓴다. 이 함수에는 tags 버퍼 용량 인자가 없다.
공통 종료 순서를 그대로 추적한다
enter_critical_section(), platform_uninit(), arch_disable_cache(UCACHE), ARM_WITH_MMU일 때 arch_disable_mmu(), timestamp, entry 호출 순서다. USB 중지는 cmd_boot() 같은 호출자에서 이 함수 진입 전에 수행될 수 있으며 boot_linux()의 공통 직접 호출이 아니다.
entry 반환을 처리하는 코드가 없다
entry는 void 반환 함수 포인터로 호출된다. 실제 kernel 진입은 복귀를 기대하지 않는 계약이지만 이 C 함수에는 호출 이후 panic이나 무한 정지가 없다. 반환하면 함수 끝으로 흐른다는 소스 사실과 제품의 비복귀 요구를 구별한다.
IMPLEMENTATION NOTES
보장하지 않는 내용을 보장으로 쓰지 않기
machine type을 만드는 단계는 platform_uninit()이 아니다
machtype은 boot_linux()의 인자이며 마지막 entry 호출까지 전달된다. platform_uninit()이 machine type을 생산한다는 상태표는 맞지 않는다. 호출자들은 board_machtype()을 전달한다.
수명과 소유권은 실제 객체로 한정한다
이 함수에는 등록 list나 child/reference 공개·회수 단계가 없다. 살아 있어야 할 대상은 entry가 가리키는 kernel, tags 버퍼, ramdisk, 그리고 DT/ATAG 작성 동안 필요한 command line이다. 장치 정리의 전체 보장은 platform 구현과 실제 target 상태로 별도 검증한다.
32-bit 호출과 다른 architecture 계약을 분리한다
같은 버전 bootimg.h는 r0=0, r1=MACHINE_TYPE, r2=tags_addr를 설명한다. 이 함수는 그 세 인자 형태로 호출하며 AArch64의 x0–x3 계약을 구현한 함수로 해석하지 않는다. header에 second-stage field가 있다는 사실도 이 함수에 second-stage 선택 코드가 있다는 뜻은 아니다.
OBJECT LIFETIME
실제로 쓰이는 값과 버퍼
| 대상 | 출처 | 소비 위치 | 제약 |
|---|---|---|---|
| entry | PA(kernel) | 마지막 함수 포인터 호출 | kernel 내용은 호출자가 적재; 여기서 signature 검사 안 함 |
| tags / tags_phys | 호출자 tags / PA(tags) | DT·ATAG 작성 / entry 세 번째 인자 | 쓰는 주소와 넘기는 주소를 구별; 용량·배치 전제는 외부 |
| ramdisk / ramdisk_size | 호출자 / PA 변환 | DT 또는 ATAG에 기록할 인자 | 이 함수에서 ramdisk payload 복사 안 함 |
| final_cmdline | update_cmdline()의 할당 문자열 | DT/ATAG helper | helper malloc ASSERT; 반환 후 free 없음 |
| machtype | 호출자 인자 | entry 두 번째 인자 | platform cleanup의 산출물이 아님 |
FAILURE PATH
실제 실패 처리와 외부 전제
| 조건 | 소스에서 보이는 처리 | 남는 확인 |
|---|---|---|
| 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 상태를 계측하지 않았으면 확인 완료로 적지 않는다.
EVIDENCE
고정 원문과 검증 범위
| 질문 | 근거 | 확인 내용 |
|---|---|---|
| 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.h | r0/r1/r2 설명과 함수 호출의 대응 |
| 실제 주소·상태 | 사용 target의 map, 호출자, debugger 기록 | RAM 배치·hardware quiesce·cache 효과는 이 페이지의 실행 확인 결과가 아님 |
LAB
실행 결과와 구별한 확인 계획
소스만으로 분기표 작성
DEVICE_TREE와 ARM_WITH_MMU의 네 조합에서 실행되는 helper를 표로 만든다. DT 오류를 ATAG fallback 또는 일반 오류 정리로 추가하지 않는다.
대상 빌드의 주소 대조
map과 호출자 코드에서 kernel·ramdisk·tags·aboot의 실제 시작과 끝을 구한다. 그림의 세로 순서를 RAM 주소라고 사용하지 않는다.
복구 가능한 시험 환경에서 handoff 관측
기존 debugger나 계측으로 entry 직전의 인자와 platform·cache·MMU 상태를 기록한다. 장치 쓰기, 잘못된 image 실행, 보안 정책 변경을 이 문서 검토의 일부로 수행하지 않는다.
PRIMARY REFERENCES