U-Boot · source analysis

relocation 이후 board_init_r

새 DRAM 주소로 코드와 global data를 옮긴 뒤 runtime 서비스와 main loop를 여는 과정을 읽습니다.

이 글의 v2026.07은 분석 기준 소스입니다. 제품 적용 시 사용하는 U-Boot 버전과 보드 설정의 차이를 공식 소스 및 빌드 산출물에 대조하세요.

Series
06 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
common/board_r.c:755-810 (발췌 범위)

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과 장치가 언제 사용 가능한지 판단할 수 있다.

객체와 주소가 놓이는 구조

그림 1. ARM64 U-Boot proper의 GD 전환과 runtime 초기화 경계
입력과 전제내부 상태외부로 공개되는 결과
01board_init_f: 새 GD 예약·복사
02새 SP·x18 → image relocation
03board_init_r: initr_malloc
04조건부 DM → main loop

reserve_global_data와 setup_reloc은 board_init_f 안에서 새 GD를 준비한다. initr_malloc은 board_init_r 내부의 initcall_run_r()에서 실행되므로 GD 전환과 같은 시점이 아니다.

실행 흐름

그림 2. ARM64 U-Boot proper의 정상 relocation 경로와 runtime initcall
board_init_f
새 GD 예약·복사
crt0_64.S
새 SP·x18 선택
relocate_code
image copy·fixup
BSS clear
board_init_r
initcall_run_r
malloc → 조건부 DM
run_main_loop
main_loop

새 GD는 fixup 뒤에 생성되지 않는다. GD_FLG_SKIP_RELOC이면 image copy·fixup을 건너뛰지만 새 SP·x18 선택과 뒤의 초기화 경로는 계속된다. initr_malloc은 board_init_r이 호출하는 initcall_run_r()의 앞부분에 있고, initr_dm은 DM 설정 시에만 호출된다.

단계별 입력과 출력

새 GD의 예약·복사·선택과 runtime heap 초기화는 서로 다른 단계다. 아래 순서는 ARM64 U-Boot proper 기준이며 조건부 분기는 따로 적었다.

#단계진입 시 신뢰할 상태처리 뒤 상태다음 소비자
01board_init_f의 reserve_global_data·setup_reloc초기 GD와 DRAM 예약 정보gd->new_gd 예약·복사, relocation 주소 계산crt0_64.S
02새 SP·x18 선택기존 GD의 start_addr_sp·new_gdDRAM의 stack·GD를 사용relocate_code 또는 skip 분기
03relocate_code새 SP·GD와 목적지 주소skip flag가 없고 목적지가 현재 시작 주소와 다르면 image copy·.rela.dyn fixup; cache는 조건부relocation return
04crt0_64.S 최종 환경relocation return 또는 skipCPU runtime setup 뒤 BSS clear, board_init_r로 분기board_init_r
05initcall_run_r()GD·stack·BSS 사용 가능initr_malloc로 runtime heap 초기화, 설정 시 initr_dm 실행run_main_loop
06run_main_loop앞선 initcall 완료main_loop()를 반복 호출; 반환하면 다시 호출CLI·autoboot 경로

진입 전제를 확인할 때 새 GD 선택과 runtime malloc 초기화를 같은 이벤트로 취급하지 않는다.

주소와 객체의 이동을 그림으로 읽기

아래 그림은 주소, 객체를 사용하는 기간, 제어권을 넘기는 시점을 중심으로 정리했다. 실제 주소와 크기는 사용 중인 보드의 bdinfo, 맵 파일과 링커 심벌로 확인한다.

그림 3. ARM64에서 새 GD 선택부터 board_init_r까지

GD_FLG_SKIP_RELOC이 없을 때 image copy와 상대 relocation을 수행한다. cache 작업은 활성 상태에 따라 조건부다.

01board_init_f: 새 GD 예약·복사
02새 SP·x18 선택
03image copy → .rela.dyn fixup
04조건부 I-cache invalidate → D-cache flush
05relocated return·CPU setup
06BSS clear
07board_init_r → initcall_run_r
그림 4. ARM64의 두 relocation offset과 예약 주소

board_f.c가 기록하는 GD offset과 relocate_64.S가 .rela.dyn에 쓰는 link-to-copy offset의 기준은 다르다.

01GD offsetrelocaddr - __image_copy_start

board_f.c의 ARM gd->reloc_off

02fixup offsetrelocaddr - _TEXT_BASE

relocate_64.S의 x9

03relative fixupaddend + x9

R_AARCH64_RELATIVE 대상

04stackstart_addr_sp

board_init_f의 예약 결과

05gdnew_gd

board_init_f에서 복사, crt0에서 x18 선택

그림 5. relocation 전후에 같은 이름이 가리키는 객체

이름은 같아도 주소와 수명이 달라진다.

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 (설정 시 재초기화)

원본 코드

아래 코드는 U-Boot v2026.07의 common/board_r.c에서 755-810줄을 그대로 가져온 것이다.

commitece349ade2973e220f524ce59e59711cc919263fanchor · L779void board_init_r(gd_t *new_gd, ulong dest_addr)
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}

발췌와 후속 호출의 범위

보존한 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의 진입 경로를 동일시하지 않는다.

주소 전환과 runtime 준비를 분리하기

01

새 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을 검사한다.

02

복사와 상대 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와 기준 주소가 다르다.

03

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을 초기화한다.

04

초기 flag는 모든 장치의 완료 증거가 아니다

board_init_r()는 이전 serial·log 상태를 신뢰하지 않도록 READY 비트를 지운다. 초기 호출인 initr_reloc()은 GD_FLG_RELOC | GD_FLG_FULL_MALLOC_INIT를 설정하지만 실제 initr_malloc() 호출은 그 뒤다. 중간 flag 하나만 보고 malloc·DM·console 전체가 준비되었다고 판단하지 않는다.

05

초기화 목록의 실패는 공통 rollback이 아니다

INITCALL(fn)은 fn의 반환값이 0이 아니면 이름을 출력하고 hang()을 호출한다. 앞서 초기화한 heap·device·hardware를 역순으로 정리하는 공통 루프는 없다. 정상 경로의 run_main_loop()는 이벤트 통지 후 main_loop()를 무한 반복하며, main_loop가 반환해도 다시 호출한다. 운영체제로의 개별 handoff는 이 함수 자체와 구별한다.

cache와 Driver Model의 조건부 경계

01

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 장애 재현을 수행한 것은 아니다.

02

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이 즉시 자동 복원된다는 주장을 구별한다.

03

이전 주소·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의 실제 실행 여부를 해당 경로에서 판단한다.

주소별 소유와 유효 시점

대상준비·선택 시점소비와 제한
새 GDboard_f에서 예약·복사, ARM64 crt0에서 x18 선택runtime GD로 계속 사용; initcall 실패 시 공통 해제된다는 보장은 없음
임시 board_fboard_init_f의 stack 지역 객체반환하면 C 수명 종료; 복사된 GD의 boardf 포인터를 runtime 객체로 사용하지 않음
image·.rela.dyn링크 산출물과 현재 적재 주소다른 목적지일 때 복사·relative fixup; skip flag와 같은 주소 분기를 분리
BSSproper crt0가 board_init_r 전 0화초기 GD 0화와 다름; 이후 runtime 가변 전역값의 기반
runtime heapinitr_malloc이 시작 주소와 TOTAL_MALLOC_LEN으로 초기화초기 malloc과 구별; DM·후속 초기화가 소비
DM root·device조건부 initr_dm이 새 root와 scan/autoprobe 경로 시작이전 device 포인터 재사용 금지; 개별 probe 완료는 별도 확인

어느 경계에서 멈췄는지 구분하기

증상직접 확인할 값·호출단정하지 않을 점
복사 뒤 함수 포인터 오분기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 쓰기는 수행하지 않았다.

기존 빌드와 관측 기록으로 대조

다음은 이미 보유한 빌드 산출물과 보드 기록을 읽는 예다. 새 defconfig나 펌웨어 빌드를 실행한 검증 결과가 아니다.

대상읽기 전용 대조확인점
선택된 설정기존 .config·compile command 기록ARM64 proper, skip relocation, DM·cache 관련 분기
심벌${CROSS_COMPILE}nm -n u-bootboard_init_f, relocate_code, board_init_r와 image 경계
명령·relocation${CROSS_COMPILE}objdump -drS u-boot 및 ${CROSS_COMPILE}readelf -rW u-bootSP/x18 전환, 두 offset, 지원하는 relocation type
주소·상태기존 bdinfo·debugger·DM 출력 기록새 GD·heap·device 초기화가 각각 완료된 시점

직접 확인할 실험

  1. 01
    새 GD 선택 시점 확인

    board_init_f 뒤 gd->new_gd와 start_addr_sp를 기록하고, ARM64 x18 전환이 relocate_code 앞에 있는지 objdump에서 확인한다.

  2. 02
    relocation entry 추적

    .rela.dyn entry와 새 image 주소를 비교해 R_AARCH64_RELATIVE fixup을 확인한다. skip 설정이면 copy·fixup을 기대하지 않는다.

  3. 03
    runtime heap 시점 확인

    initcall_run_r()의 initr_malloc 뒤 bdinfo의 malloc 범위를 기록하고, 조건부 initr_dm보다 앞인지 확인한다.

원문과 다음 글