U-Boot · source analysis

crt0_64.S의 임시 stack과 global data

ARM64 `_main`에서 초기 SP·GD를 만들고 board_init_f 반환 뒤 relocation 분기로 이어지는 경계를 추적합니다.

Series
03 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
arch/arm/lib/crt0_64.S:43-131 (발췌 범위)

C 코드 진입 전 SP와 x18은 언제 유효해지는가?

AArch64 _main은 보드 설정에 따른 초기 RAM 주소를 16바이트로 정렬해 SP에 넣는다. board_init_f_alloc_reserve()는 그 아래의 early malloc·GD 주소를 계산할 뿐이고, 뒤따르는 어셈블리가 SP와 x18을 실제로 바꾼다. board_init_f_init_reserve()가 GD를 0으로 만든 다음에야 board_init_f(0)가 호출된다.

board_init_f()는 이 글의 끝이 아니다. U-Boot proper는 예약된 새 SP/GD로 전환해 필요할 때 코드를 relocation하고, BSS를 지운 뒤 board_init_r()로 간다. XPL은 별도 조건 분기이므로 같은 화살표로 합치지 않는다.

초기 주소 계산과 실제 register 전환

그림 1. 초기 RAM과 GD base
높은 주소초기 top · 설정에 따른 RAMCONFIG_VAL(STACK), __bss_start + offset, SYS_INIT_SP_ADDR 중 빌드 분기로 선택; SRAM 고정 아님
조건부early malloc 영역SYS_MALLOC_F이며 CFG_MALLOC_F_ADDR가 없으면 top에서 크기를 뺀다
GD16바이트 정렬한 GD 공간board_init_f_alloc_reserve의 반환 base; assembly가 SP = x18 = base 설정
낮은 주소초기 stack이 아래로 성장GD 자체는 init_reserve가 0으로 초기화; stack 여유는 보드 메모리 배치에 달림

위치는 개념도이며 실제 주소는 보드 설정으로 결정된다. alloc_reserve() 안에서는 C stack pointer를 바꾸지 않으므로 반환 뒤 L88–90의 mov가 예약을 완성한다.

board_init_f(0) 전의 정확한 명령 순서

그림 2. 초기 SP·GD 설정 순서
L72–85초기 SP 선택·정렬HAVE_INIT_STACK / INIT_SP_RELATIVE / SYS_INIT_SP_ADDR 분기
L86–87주소 계산 호출top을 x0로 전달; early malloc 조건부 차감, GD base 정렬
L88–90SP·x18 변경SP와 GD 포인터가 같은 base를 가리킴; GD 값은 아직 미초기화
L91GD 0 초기화init_reserve에서 memset; malloc_base는 SYS_MALLOC_F 조건부
L97–98board_init_f(0)초기 GD와 stack을 써 DRAM 및 다음 주소를 준비

debug_uart_init은 설정될 때만 두 C 호출 사이에 있다(L93–95). GD가 0으로 초기화되기 전 x18 값만으로 gd 필드를 신뢰하지 않는다.

SP·x18·BSS를 명령 경계마다 기록

경계SP / x0x18 / GDBSS와 다음 소비자
_main 진입호출자 상태; 아직 이 함수에서 설정 전이 함수에서 아직 설정 전BSS/초기화된 가변 전역값 사용 불가
L85설정값에서 16바이트 내림 정렬아직 설정 전x0=SP로 alloc_reserve 호출
L87 반환SP는 기존 값; x0는 계산한 base아직 설정 전주소 계산과 실제 예약을 구별
L88–90SP=basex18=base; GD 내용은 아직 미초기화init_reserve가 다음 소비자
L91 뒤초기 GD 아래의 stackGD 0 초기화·조건부 malloc_baseboard_init_f(0) 호출 가능
board_init_f 반환초기 stack초기 GD에 다음 SP/new_gd·reloc 정보proper 또는 XPL 분기; BSS 아직 사용 불가
proper L106–108gd->start_addr_sp에서 정렬한 새 SPgd->new_gd로 전환skip-reloc 검사·relocate_code 또는 바로 반환 지점
BSS clear 뒤proper: 새 SP; XPL: 조건부 stack 전환proper: 새 GD; XPL: 조건부 GD 전환조건을 만족하는 경로에서 board_init_r 진입

board_init_f 반환 이후 갈라지는 두 경로

그림 3. U-Boot proper의 새 SP/GD와 relocation
01 SWITCHSP·x18 먼저 교체old GD의 start_addr_sp로 SP, old GD의 new_gd로 x18을 옮긴다(L106–108).
02 DECIDEGD_FLG_SKIP_RELOC 검사bit 11이 켜지면 relocate_code를 건너뛰고 relocation_return으로 간다(L110–112).
03 RELOCATE설정·flag에 따라 코드 이동skip하지 않으면 LR 오프셋을 조정하고 gd->relocaddr로 relocate_code에 분기한다(L114–132).
04 RUNTIMEBSS clear → board_init_rrelocation_return에서 c_runtime_cpu_setup, 이후 BSS 0 초기화와 board_init_r 분기(L134–173).

board_init_f는 주소를 준비한다. ARM64 crt0가 먼저 SP/x18을 바꾸고, relocation을 건너뛸지 결정한다. 새 GD의 값은 board_init_f 경로에서 마련되어야 한다.

그림 4. XPL FRAMEWORK 분기
XPL BUILDproper relocation 블록 제외CONFIG_XPL_BUILD에서는 L100–140의 새 SP/GD 전환과 relocate_code를 컴파일하지 않는다.
FRAMEWORK ON선택적인 stack/GD 전환spl_relocate_stack_gd()가 NULL이면 기존 x18/SP 유지, 주소가 오면 둘을 갱신한다(L141–156).
THENBSS clear·board_init_rFRAMEWORK 경로에서는 BSS를 지우고 x0=GD, x1=relocaddr로 board_init_r에 분기한다(L158–173).
FRAMEWORK OFF이 공통 후속 블록 없음board_init_f 반환 뒤 이 파일의 L141–176 후속 코드가 제외된다. 보드/XPL 경로를 따로 확인해야 한다.

원본 주석은 SPL을 예로 들지만 실제 전처리 경계는 CONFIG_XPL_BUILD와 CONFIG_IS_ENABLED(FRAMEWORK)다. 모든 XPL에 proper의 relocation 순서를 적용하지 않는다.

원본 코드

아래 코드는 U-Boot v2026.07의 arch/arm/lib/crt0_64.S에서 43-131줄을 그대로 가져온 것이다.

commitece349ade2973e220f524ce59e59711cc919263fanchor · L67ENTRY(_main)
43 *
44 * 4a.For U-Boot proper (not SPL), call relocate_code(). This function
45 *    relocates U-Boot from its current location into the relocation
46 *    destination computed by board_init_f().
47 *
48 * 4b.For SPL, board_init_f() just returns (to crt0). There is no
49 *    code relocation in SPL.
50 *
51 * 5. Set up final environment for calling board_init_r(). This
52 *    environment has BSS (initialized to 0), initialized non-const
53 *    data (initialized to their intended value), and stack in system
54 *    RAM (for SPL moving the stack and GD into RAM is optional - see
55 *    CONFIG_SPL_STACK_R). GD has retained values set by board_init_f().
56 *
57 * TODO: For SPL, implement stack relocation on AArch64.
58 *
59 * 6. For U-Boot proper (not SPL), some CPUs have some work left to do
60 *    at this point regarding memory, so call c_runtime_cpu_setup.
61 *
62 * 7. Branch to board_init_r().
63 *
64 * For more information see 'Board Initialisation Flow in README.
65 */
66
67ENTRY(_main)
68
69/*
70 * Set up initial C runtime environment and call board_init_f(0).
71 */
72#if CONFIG_IS_ENABLED(HAVE_INIT_STACK)
73	ldr	x0, =CONFIG_VAL(STACK)
74#elif defined(CONFIG_INIT_SP_RELATIVE)
75#if CONFIG_POSITION_INDEPENDENT
76	adrp	x0, __bss_start     /* x0 <- Runtime &__bss_start */
77	add	x0, x0, #:lo12:__bss_start
78#else
79	adr	x0, __bss_start
80#endif
81	add	x0, x0, #CONFIG_SYS_INIT_SP_BSS_OFFSET
82#else
83	ldr	x0, =(SYS_INIT_SP_ADDR)
84#endif
85	bic	sp, x0, #0xf	/* 16-byte alignment for ABI compliance */
86	mov	x0, sp
87	bl	board_init_f_alloc_reserve
88	mov	sp, x0
89	/* set up gd here, outside any C code */
90	mov	x18, x0
91	bl	board_init_f_init_reserve
92
93#if defined(CONFIG_DEBUG_UART) && CONFIG_IS_ENABLED(SERIAL)
94	bl	debug_uart_init
95#endif
96
97	mov	x0, #0
98	bl	board_init_f
99
100#if !defined(CONFIG_XPL_BUILD)
101/*
102 * Set up intermediate environment (new sp and gd) and call
103 * relocate_code(addr_moni). Trick here is that we'll return
104 * 'here' but relocated.
105 */
106	ldr	x0, [x18, #GD_START_ADDR_SP]	/* x0 <- gd->start_addr_sp */
107	bic	sp, x0, #0xf	/* 16-byte alignment for ABI compliance */
108	ldr	x18, [x18, #GD_NEW_GD]		/* x18 <- gd->new_gd */
109
110	/* Skip relocation in case gd->gd_flags & GD_FLG_SKIP_RELOC */
111	ldr	x0, [x18, #GD_FLAGS]		/* x0 <- gd->flags */
112	tbnz	x0, 11, relocation_return	/* GD_FLG_SKIP_RELOC is bit 11 */
113
114	adr	lr, relocation_return
115#if CONFIG_POSITION_INDEPENDENT
116	/* Add in link-vs-runtime offset */
117	adrp	x0, _start		/* x0 <- Runtime value of _start */
118	add	x0, x0, #:lo12:_start
119	ldr	x9, _TEXT_BASE		/* x9 <- Linked value of _start */
120	sub	x9, x9, x0		/* x9 <- Run-vs-link offset */
121	add	lr, lr, x9
122#if defined(CONFIG_ENV_RELOC_GD_ENV_ADDR)
123	ldr	x0, [x18, #GD_ENV_ADDR]	/* x0 <- gd->env_addr */
124	add	x0, x0, x9
125	str	x0, [x18, #GD_ENV_ADDR]
126#endif
127#endif
128	/* Add in link-vs-relocation offset */
129	ldr	x9, [x18, #GD_RELOC_OFF]	/* x9 <- gd->reloc_off */
130	add	lr, lr, x9	/* new return address after relocation */
131	ldr	x0, [x18, #GD_RELOCADDR]	/* x0 <- gd->relocaddr */

발췌 범위와 읽기 기준

보존한 원본 발췌는 crt0_64.S L43–131이다. L43–66은 설명 주석이며 실행 가능한 명령은 ENTRY(_main) L67 이후다. b relocate_code와 XPL 조건, BSS clear, board_init_r는 같은 고정 파일의 L132–175까지 함께 읽어야 한다.

board_init_f_alloc_reserve()와 board_init_f_init_reserve()의 차이는 common/init/board_init.c L81–93, L137–175를 따른다. 이 C 함수는 주소 계산과 GD 초기화를 맡고, SP·x18의 직접 변경은 AArch64 어셈블리에 있다.

초기 C 환경의 실제 보장 범위

01

초기 RAM은 설정에 따라 다름

HAVE_INIT_STACK이면 CONFIG_VAL(STACK), INIT_SP_RELATIVE이면 __bss_start에 offset을 더한 주소, 나머지는 SYS_INIT_SP_ADDR를 쓴다. 주석은 SRAM 또는 locked cache 등 사용 가능한 RAM을 예시한다.

02

alloc_reserve는 주소만 계산

SYS_MALLOC_F와 CFG_MALLOC_F_ADDR 조건에 따라 early malloc 크기를 빼고 GD 크기만큼 16바이트 정렬해 낮춘 base를 반환한다. 실제 SP 변경은 caller인 _main의 mov sp, x0다.

03

GD 포인터와 내용의 유효 시점은 다름

mov x18, x0 직후에는 위치만 정해졌다. board_init_f_init_reserve()가 GD 전체를 0으로 만들고, 조건부 malloc_base를 기록한 다음 board_init_f(0)이 실행된다.

04

board_init_f는 crt0로 돌아옴

U-Boot proper에서는 반환 뒤 old GD에 든 start_addr_sp/new_gd를 사용해 register를 교체한다. 이후 relocation, BSS clear와 board_init_r 분기가 이어진다.

메모리와 분기 조건을 섞지 않기

01

BSS는 board_init_f 전에 유효하지 않음

crt0 주석은 이 단계에서 비상수 전역/BSS 사용을 금지한다. GD는 별도 예약 영역을 0으로 만든 것이며 BSS clear는 후속 경로 L158–168이다.

02

new_gd와 relocation은 다른 작업

board_init_f가 새 GD 주소와 다음 stack을 마련하고, crt0는 먼저 x18/SP를 옮긴다. GD_FLG_SKIP_RELOC가 켜져도 register 전환 뒤 relocation_return으로 간다.

03

XPL은 CONFIG gate를 기록

CONFIG_XPL_BUILD는 proper relocation 블록을 없앤다. FRAMEWORK가 켜진 XPL만 이 파일에서 spl_relocate_stack_gd()·BSS clear·board_init_r 경로를 탄다. NULL 반환이면 원래 SP/GD를 유지한다.

두 GD와 stack의 위치·유효 범위

대상위치·생성 시점언제 소비되는가
초기 SP설정값을 16바이트 정렬한 뒤, 반환 base로 다시 내림board_init_f와 그 안의 C 호출이 사용
초기 GD / x18alloc_reserve base를 SP·x18로 설정, init_reserve가 0 초기화board_init_f가 DRAM/relocation 정보를 기록
early mallocSYS_MALLOC_F 조건부; CFG_MALLOC_F_ADDR가 있으면 이 helper에서 top 차감 생략gd->malloc_base는 init_reserve에서 설정
새 SP·GDboard_init_f가 준비한 gd->start_addr_sp·new_gdproper crt0 L106–108이 register로 읽음
BSScrt0 후속 L158–168에서 0으로 초기화board_init_r 진입 전 유효; XPL은 FRAMEWORK 경로 조건

첫 C 호출이 깨질 때 볼 경계

관찰 증상점검할 명령·값뜻하는 경계
첫 C 호출에서 stack faultL72–88의 설정 주소·16바이트 정렬·반환 base초기 RAM 범위 또는 아래쪽 stack 여유
gd 필드 접근 오류L90 x18와 L91 memset의 base·sizeof(gd)포인터 설정과 값 초기화 시점 구분
board_init_f 후 DRAM faultold GD의 start_addr_sp/new_gd와 L106–108예약된 새 주소와 register 교체
relocation 이후 분기 오류GD_FLG_SKIP_RELOC, reloc_off, LR, relocaddrskip와 실제 relocate_code 분기 구별
BSS 기반 전역값 오류L158–168 clear 전후·CONFIG_XPL_BUILD/FRAMEWORK초기 GD 0화와 전체 BSS 0화를 혼동하지 않음

이 초기화 어셈블리는 일반적인 등록 목록·자원 해제 루틴이 아니다. 오류를 역순 cleanup한다는 가정보다 멈춘 PC와 SP/x18, 선택된 CONFIG 분기를 먼저 기록한다.

고정 빌드와 보드에서 볼 증거

목적명령 / 관찰판정
선택된 초기 SPgrep -E "CONFIG_(HAVE_INIT_STACK|INIT_SP_RELATIVE|SYS_INIT_SP|XPL_BUILD)" .config실제 전처리 분기와 top 출처 확인
진입 심벌${CROSS_COMPILE}nm -n u-boot | grep -E " (_main|board_init_f|board_init_r)$"nm은 ENTRY 매크로 문자열이 아니라 심벌을 출력
기계어 분기${CROSS_COMPILE}objdump -dr u-bootSP/x18 mov, skip 분기, relocate_code와 board_init_r 위치 대조
주소 기록gd->start_addr_sp, gd->new_gd, gd->relocaddr 및 SP/x18board_init_f 반환 직전과 crt0 L106–112 직후 비교

분기 경계를 실제로 구별하는 계측

  1. 01
    주소 계산과 SP 변경 분리

    L87 반환의 x0와 SP를 함께 저장하고, L88–90 실행 뒤 SP/x18이 x0로 바뀌었는지 본다.

  2. 02
    GD 0화 시점 확인

    L90과 L91 사이 및 L91 뒤에 같은 GD 바이트를 비교해 board_init_f 전 초기화를 검증한다.

  3. 03
    proper와 XPL 경로 분리

    실제 CONFIG를 기록한 뒤 proper의 skip-reloc 분기와 XPL FRAMEWORK의 NULL/non-NULL stack 반환을 각각 추적한다.

원문과 다음 글