QUESTION
relocation 이후 board_init_r 단계에서 실제로 바뀌는 상태는 무엇인가?
relocation은 memcpy 하나가 아니다. absolute relocation, gd 교체, BSS, malloc, driver model 재초기화가 어느 주소 기준으로 수행되는지 분리한다.
ARM64 U-Boot proper에서는 board_init_f가 새 GD를 예약·복사하고 crt0_64.S가 새 SP·x18을 먼저 선택한다. 그 뒤 코드 relocation(또는 skip), BSS 초기화, board_init_r의 initcall을 구분해야 runtime heap과 장치가 언제 사용 가능한지 판단할 수 있다.
STRUCTURE
객체와 주소가 놓이는 구조
reserve_global_data와 setup_reloc은 board_init_f 안에서 새 GD를 준비한다. initr_malloc은 board_init_r 내부의 initcall_run_r()에서 실행되므로 GD 전환과 같은 시점이 아니다.
CALL PATH
실행 흐름
새 GD 예약·복사
새 SP·x18 선택
image copy·fixup
board_init_r
malloc → 조건부 DM
main_loop
새 GD는 fixup 뒤에 생성되지 않는다. GD_FLG_SKIP_RELOC이면 image copy·fixup을 건너뛰지만 새 SP·x18 선택과 뒤의 초기화 경로는 계속된다. initr_malloc은 board_init_r이 호출하는 initcall_run_r()의 앞부분에 있고, initr_dm은 DM 설정 시에만 호출된다.
STATE LEDGER
단계별 입력과 출력
새 GD의 예약·복사·선택과 runtime heap 초기화는 서로 다른 단계다. 아래 순서는 ARM64 U-Boot proper 기준이며 조건부 분기는 따로 적었다.
| # | 단계 | 진입 시 신뢰할 상태 | 처리 뒤 상태 | 다음 소비자 |
|---|---|---|---|---|
| 01 | board_init_f의 reserve_global_data·setup_reloc | 초기 GD와 DRAM 예약 정보 | gd->new_gd 예약·복사, relocation 주소 계산 | crt0_64.S |
| 02 | 새 SP·x18 선택 | 기존 GD의 start_addr_sp·new_gd | DRAM의 stack·GD를 사용 | relocate_code 또는 skip 분기 |
| 03 | relocate_code | 새 SP·GD와 목적지 주소 | skip flag가 없고 목적지가 현재 시작 주소와 다르면 image copy·.rela.dyn fixup; cache는 조건부 | relocation return |
| 04 | crt0_64.S 최종 환경 | relocation return 또는 skip | CPU runtime setup 뒤 BSS clear, board_init_r로 분기 | board_init_r |
| 05 | initcall_run_r() | GD·stack·BSS 사용 가능 | initr_malloc로 runtime heap 초기화, 설정 시 initr_dm 실행 | run_main_loop |
| 06 | run_main_loop | 앞선 initcall 완료 | main_loop()를 반복 호출; 반환하면 다시 호출 | CLI·autoboot 경로 |
진입 전제를 확인할 때 새 GD 선택과 runtime malloc 초기화를 같은 이벤트로 취급하지 않는다.
VISUAL WALKTHROUGH
주소와 객체의 이동을 그림으로 읽기
아래 그림은 주소, 객체를 사용하는 기간, 제어권을 넘기는 시점을 중심으로 정리했다. 실제 주소와 크기는 사용 중인 보드의 bdinfo, 맵 파일과 링커 심벌로 확인한다.
GD_FLG_SKIP_RELOC이 없을 때 image copy와 상대 relocation을 수행한다. cache 작업은 활성 상태에 따라 조건부다.
board_f.c가 기록하는 GD offset과 relocate_64.S가 .rela.dyn에 쓰는 link-to-copy offset의 기준은 다르다.
relocaddr - __image_copy_startboard_f.c의 ARM gd->reloc_off
relocaddr - _TEXT_BASErelocate_64.S의 x9
addend + x9R_AARCH64_RELATIVE 대상
start_addr_spboard_init_f의 예약 결과
new_gdboard_init_f에서 복사, crt0에서 x18 선택
이름은 같아도 주소와 수명이 달라진다.
Pre-relocation
01old text/data
02초기 gd
03초기 stack
04early malloc (설정 시)
05원래 FDT
06pre-reloc device
board_init_r initcall 후
01text/data (copy 또는 skip)
02new gd
03new stack
04runtime malloc
05FDT (설정별 relocation)
06DM device (설정 시 재초기화)
UPSTREAM SOURCE
원본 코드
아래 코드는 U-Boot v2026.07의 common/board_r.c에서 755-810줄을 그대로 가져온 것이다.
755 INITCALL(initr_boot_led_blink);
756 /* PPC has a udelay(20) here dating from 2002. Why? */
757#if CONFIG_IS_ENABLED(BOARD_LATE_INIT)
758 INITCALL(board_late_init);
759#endif
760#if CONFIG_IS_ENABLED(PCI_ENDPOINT)
761 INITCALL(pci_ep_init);
762#endif
763#if CONFIG_IS_ENABLED(NET)
764 WATCHDOG_RESET();
765 INITCALL(initr_net);
766#endif
767#if CONFIG_IS_ENABLED(POST)
768 INITCALL(initr_post);
769#endif
770 WATCHDOG_RESET();
771 INITCALL_EVT(EVT_LAST_STAGE_INIT);
772#if defined(CFG_PRAM)
773 INITCALL(initr_mem);
774#endif
775 INITCALL(initr_boot_led_on);
776 INITCALL(run_main_loop);
777}
778
779void board_init_r(gd_t *new_gd, ulong dest_addr)
780{
781 /*
782 * The pre-relocation drivers may be using memory that has now gone
783 * away. Mark serial as unavailable - this will fall back to the debug
784 * UART if available.
785 *
786 * Do the same with log drivers since the memory may not be available.
787 */
788 gd->flags &= ~(GD_FLG_SERIAL_READY | GD_FLG_LOG_READY);
789
790 /*
791 * Set up the new global data pointer. So far only x86 does this
792 * here.
793 * TODO(sjg@chromium.org): Consider doing this for all archs, or
794 * dropping the new_gd parameter.
795 */
796 if (CONFIG_IS_ENABLED(X86_64) && !IS_ENABLED(CONFIG_EFI_APP))
797 arch_setup_gd(new_gd);
798
799#if defined(CONFIG_RISCV)
800 set_gd(new_gd);
801#elif !defined(CONFIG_X86) && !defined(CONFIG_ARM) && !defined(CONFIG_ARM64)
802 gd = new_gd;
803#endif
804 gd->flags &= ~GD_FLG_LOG_READY;
805
806 initcall_run_r();
807
808 /* NOTREACHED - run_main_loop() does not return */
809 hang();
810}
READING CONTRACT
발췌와 후속 호출의 범위
보존한 common/board_r.c L755–810 발췌는 초기화 목록의 끝과 L779의 board_init_r()를 포함한다. 실제 호출 순서는 같은 파일 L595–776의 initcall_run_r()에 직접 나열되어 있다. 함수 포인터 배열 init_sequence_r를 설명하는 글이 아니다.
ARM64의 앞 단계는 board_f.c L705–739, crt0_64.S L100–175와 relocate_64.S를 함께 읽는다. 아래 설명은 U-Boot proper 기준이며 XPL·다른 architecture의 진입 경로를 동일시하지 않는다.
DETAILS
주소 전환과 runtime 준비를 분리하기
새 GD는 코드 복사 전에 준비된다
reserve_global_data()가 새 GD 공간을 예약하고 setup_reloc()가 기존 GD를 그곳에 복사한다. ARM64 _main은 board_init_f() 반환 뒤 기존 GD의 start_addr_sp와 new_gd를 읽어 SP·x18을 바꾼다. 그 다음 GD_FLG_SKIP_RELOC을 검사한다.
복사와 상대 relocation은 두 루프다
relocate_code는 먼저 목적지와 현재 __image_copy_start가 같은지 비교한다. 같으면 복사·fixup 루프를 건너뛰고 relocate_done으로 간다. 주소가 다르면 image를 복사한 뒤 .rela.dyn을 순회한다. 이 루프는 R_AARCH64_RELATIVE만 처리하고 다른 종류는 건너뛴다.
fixup용 x9는 relocaddr - _TEXT_BASE다. 저장할 위치는 entry의 offset에 x9를 더한 주소이고, 저장할 값은 addend+x9다. 이는 ARM board_f.c의 gd->reloc_off = relocaddr - __image_copy_start와 기준 주소가 다르다.
BSS와 runtime heap은 별도로 초기화된다
proper의 relocation_return에서는 CPU runtime setup을 거친 뒤 BSS를 0으로 만들고 board_init_r로 분기한다. 새 GD를 선택했다고 runtime malloc까지 준비된 것은 아니다. initcall_run_r()가 initr_malloc()을 호출할 때 relocaddr - TOTAL_MALLOC_LEN부터 heap을 초기화한다.
초기 flag는 모든 장치의 완료 증거가 아니다
board_init_r()는 이전 serial·log 상태를 신뢰하지 않도록 READY 비트를 지운다. 초기 호출인 initr_reloc()은 GD_FLG_RELOC | GD_FLG_FULL_MALLOC_INIT를 설정하지만 실제 initr_malloc() 호출은 그 뒤다. 중간 flag 하나만 보고 malloc·DM·console 전체가 준비되었다고 판단하지 않는다.
초기화 목록의 실패는 공통 rollback이 아니다
INITCALL(fn)은 fn의 반환값이 0이 아니면 이름을 출력하고 hang()을 호출한다. 앞서 초기화한 heap·device·hardware를 역순으로 정리하는 공통 루프는 없다. 정상 경로의 run_main_loop()는 이벤트 통지 후 main_loop()를 무한 반복하며, main_loop가 반환해도 다시 호출한다. 운영체제로의 개별 handoff는 이 함수 자체와 구별한다.
IMPLEMENTATION NOTES
cache와 Driver Model의 조건부 경계
cache 유지 작업에는 두 단계 gate가 있다
relocate_done은 현재 EL의 SCTLR에서 D-cache 활성 비트를 먼저 검사한다. 꺼져 있으면 이 유지 작업 블록을 건너뛴다. 켜져 있으면 I-cache 활성 여부에 따라 ic iallu·isb를 실행하고, 이어 저장한 목적지 범위에 __asm_flush_dcache_range()와 __asm_flush_l3_dcache()를 호출한다. board_init_r의 initr_caches()는 별개의 나중 단계다.
같은 주소로의 조기 분기는 복사 뒤에 기록되는 끝 주소를 지나지 않는다. 따라서 그 분기의 유효 cache 범위까지 일반 복사 경로와 같다고 보장하지 않는다. 실제 설정·레지스터·어셈블리 경로를 확인해야 하며, 여기서 보드 실행이나 cache 장애 재현을 수행한 것은 아니다.
DM scan은 모든 device의 probe 완료와 다르다
initr_dm()은 oftree_reset() 후 gd->dm_root를 NULL로 만들고, TIMER 설정 시 timer 포인터도 비운다. 이어 dm_init_and_scan(false)가 성공해야 dm_autoprobe()로 간다. 이 호출만으로 모든 장치가 probe되었다고 단정하지 않는다.
pre-relocation 목록 끝의 cyclic_unregister_all()은 이전 장치를 참조하는 callback을 제거한다. 해당 driver가 새 장치에서 다시 probe될 때 callback을 등록하는 경로와, 모든 callback이 즉시 자동 복원된다는 주장을 구별한다.
이전 주소·link 주소·새 실행 주소를 따로 기록한다
현재 PC, SP, x18, relocaddr, 현재 image 시작과 link의 _TEXT_BASE를 함께 비교한다. GD offset을 ELF의 모든 주소에 무조건 더하면 실제 load 주소가 link 주소와 다른 경우를 놓친다. heap·MMIO·FDT 등 image 밖 포인터에 상대 relocation 공식을 일괄 적용하지 않는다.
GD_FLG_SKIP_RELOC이면 crt0가 relocate_code 자체를 건너뛴다. relocate_code 안의 같은 주소 분기와는 별개다. 어느 경우든 새 SP/GD 선택, BSS와 후속 initcall의 실제 실행 여부를 해당 경로에서 판단한다.
OBJECT LIFETIME
주소별 소유와 유효 시점
| 대상 | 준비·선택 시점 | 소비와 제한 |
|---|---|---|
| 새 GD | board_f에서 예약·복사, ARM64 crt0에서 x18 선택 | runtime GD로 계속 사용; initcall 실패 시 공통 해제된다는 보장은 없음 |
| 임시 board_f | board_init_f의 stack 지역 객체 | 반환하면 C 수명 종료; 복사된 GD의 boardf 포인터를 runtime 객체로 사용하지 않음 |
| image·.rela.dyn | 링크 산출물과 현재 적재 주소 | 다른 목적지일 때 복사·relative fixup; skip flag와 같은 주소 분기를 분리 |
| BSS | proper crt0가 board_init_r 전 0화 | 초기 GD 0화와 다름; 이후 runtime 가변 전역값의 기반 |
| runtime heap | initr_malloc이 시작 주소와 TOTAL_MALLOC_LEN으로 초기화 | 초기 malloc과 구별; DM·후속 초기화가 소비 |
| DM root·device | 조건부 initr_dm이 새 root와 scan/autoprobe 경로 시작 | 이전 device 포인터 재사용 금지; 개별 probe 완료는 별도 확인 |
FAILURE PATH
어느 경계에서 멈췄는지 구분하기
| 증상 | 직접 확인할 값·호출 | 단정하지 않을 점 |
|---|---|---|
| 복사 뒤 함수 포인터 오분기 | entry type, offset/addend, _TEXT_BASE, 목적지 | 모든 relocation type이 이 루프에서 처리되지 않음 |
| GD 접근에서 잘못된 주소 | board_f의 new_gd 복사와 crt0 x18 전환 | board_init_r가 ARM64 GD를 처음 옮기는 것이 아님 |
| 새 코드가 메모리에만 보임 | SCTLR D/I 비트, cache helper와 유지 범위 | 디버거의 바이트 표시만으로 instruction fetch 일치 보장 불가 |
| 초기화 함수 오류 후 정지 | INITCALL의 반환값·hang, serial/log 준비 여부 | 자동 rollback·다음 후보 진행 없음 |
| DM scan 뒤 일부 장치 미사용 | dm_init_and_scan 반환과 dm_autoprobe·개별 probe | 전체 device probe 완료를 scan 성공으로 대체하지 않음 |
아래 증상은 점검 경계이지 이 소스에서 실제 장애가 발생했다는 보고가 아니다. 보드 실행·fault injection·flash 쓰기는 수행하지 않았다.
EVIDENCE
기존 빌드와 관측 기록으로 대조
다음은 이미 보유한 빌드 산출물과 보드 기록을 읽는 예다. 새 defconfig나 펌웨어 빌드를 실행한 검증 결과가 아니다.
| 대상 | 읽기 전용 대조 | 확인점 |
|---|---|---|
| 선택된 설정 | 기존 .config·compile command 기록 | ARM64 proper, skip relocation, DM·cache 관련 분기 |
| 심벌 | ${CROSS_COMPILE}nm -n u-boot | board_init_f, relocate_code, board_init_r와 image 경계 |
| 명령·relocation | ${CROSS_COMPILE}objdump -drS u-boot 및 ${CROSS_COMPILE}readelf -rW u-boot | SP/x18 전환, 두 offset, 지원하는 relocation type |
| 주소·상태 | 기존 bdinfo·debugger·DM 출력 기록 | 새 GD·heap·device 초기화가 각각 완료된 시점 |
LAB
직접 확인할 실험
- 01새 GD 선택 시점 확인
board_init_f뒤gd->new_gd와start_addr_sp를 기록하고, ARM64 x18 전환이relocate_code앞에 있는지 objdump에서 확인한다. - 02relocation entry 추적
.rela.dynentry와 새 image 주소를 비교해R_AARCH64_RELATIVEfixup을 확인한다. skip 설정이면 copy·fixup을 기대하지 않는다. - 03runtime heap 시점 확인
initcall_run_r()의initr_malloc뒤bdinfo의 malloc 범위를 기록하고, 조건부initr_dm보다 앞인지 확인한다.
PRIMARY REFERENCES