QUESTION
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은 별도 조건 분기이므로 같은 화살표로 합치지 않는다.
STRUCTURE
초기 주소 계산과 실제 register 전환
위치는 개념도이며 실제 주소는 보드 설정으로 결정된다. alloc_reserve() 안에서는 C stack pointer를 바꾸지 않으므로 반환 뒤 L88–90의 mov가 예약을 완성한다.
CALL PATH
board_init_f(0) 전의 정확한 명령 순서
debug_uart_init은 설정될 때만 두 C 호출 사이에 있다(L93–95). GD가 0으로 초기화되기 전 x18 값만으로 gd 필드를 신뢰하지 않는다.
STATE LEDGER
SP·x18·BSS를 명령 경계마다 기록
| 경계 | SP / x0 | x18 / GD | BSS와 다음 소비자 |
|---|---|---|---|
| _main 진입 | 호출자 상태; 아직 이 함수에서 설정 전 | 이 함수에서 아직 설정 전 | BSS/초기화된 가변 전역값 사용 불가 |
| L85 | 설정값에서 16바이트 내림 정렬 | 아직 설정 전 | x0=SP로 alloc_reserve 호출 |
| L87 반환 | SP는 기존 값; x0는 계산한 base | 아직 설정 전 | 주소 계산과 실제 예약을 구별 |
| L88–90 | SP=base | x18=base; GD 내용은 아직 미초기화 | init_reserve가 다음 소비자 |
| L91 뒤 | 초기 GD 아래의 stack | GD 0 초기화·조건부 malloc_base | board_init_f(0) 호출 가능 |
| board_init_f 반환 | 초기 stack | 초기 GD에 다음 SP/new_gd·reloc 정보 | proper 또는 XPL 분기; BSS 아직 사용 불가 |
| proper L106–108 | gd->start_addr_sp에서 정렬한 새 SP | gd->new_gd로 전환 | skip-reloc 검사·relocate_code 또는 바로 반환 지점 |
| BSS clear 뒤 | proper: 새 SP; XPL: 조건부 stack 전환 | proper: 새 GD; XPL: 조건부 GD 전환 | 조건을 만족하는 경로에서 board_init_r 진입 |
VISUAL WALKTHROUGH
board_init_f 반환 이후 갈라지는 두 경로
board_init_f는 주소를 준비한다. ARM64 crt0가 먼저 SP/x18을 바꾸고, relocation을 건너뛸지 결정한다. 새 GD의 값은 board_init_f 경로에서 마련되어야 한다.
원본 주석은 SPL을 예로 들지만 실제 전처리 경계는 CONFIG_XPL_BUILD와 CONFIG_IS_ENABLED(FRAMEWORK)다. 모든 XPL에 proper의 relocation 순서를 적용하지 않는다.
UPSTREAM SOURCE
원본 코드
아래 코드는 U-Boot v2026.07의 arch/arm/lib/crt0_64.S에서 43-131줄을 그대로 가져온 것이다.
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 */
READING CONTRACT
발췌 범위와 읽기 기준
보존한 원본 발췌는 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 어셈블리에 있다.
DETAILS
초기 C 환경의 실제 보장 범위
초기 RAM은 설정에 따라 다름
HAVE_INIT_STACK이면 CONFIG_VAL(STACK), INIT_SP_RELATIVE이면 __bss_start에 offset을 더한 주소, 나머지는 SYS_INIT_SP_ADDR를 쓴다. 주석은 SRAM 또는 locked cache 등 사용 가능한 RAM을 예시한다.
alloc_reserve는 주소만 계산
SYS_MALLOC_F와 CFG_MALLOC_F_ADDR 조건에 따라 early malloc 크기를 빼고 GD 크기만큼 16바이트 정렬해 낮춘 base를 반환한다. 실제 SP 변경은 caller인 _main의 mov sp, x0다.
GD 포인터와 내용의 유효 시점은 다름
mov x18, x0 직후에는 위치만 정해졌다. board_init_f_init_reserve()가 GD 전체를 0으로 만들고, 조건부 malloc_base를 기록한 다음 board_init_f(0)이 실행된다.
board_init_f는 crt0로 돌아옴
U-Boot proper에서는 반환 뒤 old GD에 든 start_addr_sp/new_gd를 사용해 register를 교체한다. 이후 relocation, BSS clear와 board_init_r 분기가 이어진다.
IMPLEMENTATION NOTES
메모리와 분기 조건을 섞지 않기
BSS는 board_init_f 전에 유효하지 않음
crt0 주석은 이 단계에서 비상수 전역/BSS 사용을 금지한다. GD는 별도 예약 영역을 0으로 만든 것이며 BSS clear는 후속 경로 L158–168이다.
new_gd와 relocation은 다른 작업
board_init_f가 새 GD 주소와 다음 stack을 마련하고, crt0는 먼저 x18/SP를 옮긴다. GD_FLG_SKIP_RELOC가 켜져도 register 전환 뒤 relocation_return으로 간다.
XPL은 CONFIG gate를 기록
CONFIG_XPL_BUILD는 proper relocation 블록을 없앤다. FRAMEWORK가 켜진 XPL만 이 파일에서 spl_relocate_stack_gd()·BSS clear·board_init_r 경로를 탄다. NULL 반환이면 원래 SP/GD를 유지한다.
OBJECT LIFETIME
두 GD와 stack의 위치·유효 범위
| 대상 | 위치·생성 시점 | 언제 소비되는가 |
|---|---|---|
| 초기 SP | 설정값을 16바이트 정렬한 뒤, 반환 base로 다시 내림 | board_init_f와 그 안의 C 호출이 사용 |
| 초기 GD / x18 | alloc_reserve base를 SP·x18로 설정, init_reserve가 0 초기화 | board_init_f가 DRAM/relocation 정보를 기록 |
| early malloc | SYS_MALLOC_F 조건부; CFG_MALLOC_F_ADDR가 있으면 이 helper에서 top 차감 생략 | gd->malloc_base는 init_reserve에서 설정 |
| 새 SP·GD | board_init_f가 준비한 gd->start_addr_sp·new_gd | proper crt0 L106–108이 register로 읽음 |
| BSS | crt0 후속 L158–168에서 0으로 초기화 | board_init_r 진입 전 유효; XPL은 FRAMEWORK 경로 조건 |
FAILURE PATH
첫 C 호출이 깨질 때 볼 경계
| 관찰 증상 | 점검할 명령·값 | 뜻하는 경계 |
|---|---|---|
| 첫 C 호출에서 stack fault | L72–88의 설정 주소·16바이트 정렬·반환 base | 초기 RAM 범위 또는 아래쪽 stack 여유 |
| gd 필드 접근 오류 | L90 x18와 L91 memset의 base·sizeof(gd) | 포인터 설정과 값 초기화 시점 구분 |
| board_init_f 후 DRAM fault | old GD의 start_addr_sp/new_gd와 L106–108 | 예약된 새 주소와 register 교체 |
| relocation 이후 분기 오류 | GD_FLG_SKIP_RELOC, reloc_off, LR, relocaddr | skip와 실제 relocate_code 분기 구별 |
| BSS 기반 전역값 오류 | L158–168 clear 전후·CONFIG_XPL_BUILD/FRAMEWORK | 초기 GD 0화와 전체 BSS 0화를 혼동하지 않음 |
이 초기화 어셈블리는 일반적인 등록 목록·자원 해제 루틴이 아니다. 오류를 역순 cleanup한다는 가정보다 멈춘 PC와 SP/x18, 선택된 CONFIG 분기를 먼저 기록한다.
EVIDENCE
고정 빌드와 보드에서 볼 증거
| 목적 | 명령 / 관찰 | 판정 |
|---|---|---|
| 선택된 초기 SP | grep -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-boot | SP/x18 mov, skip 분기, relocate_code와 board_init_r 위치 대조 |
| 주소 기록 | gd->start_addr_sp, gd->new_gd, gd->relocaddr 및 SP/x18 | board_init_f 반환 직전과 crt0 L106–112 직후 비교 |
LAB
분기 경계를 실제로 구별하는 계측
- 01주소 계산과 SP 변경 분리
L87 반환의 x0와 SP를 함께 저장하고, L88–90 실행 뒤 SP/x18이 x0로 바뀌었는지 본다.
- 02GD 0화 시점 확인
L90과 L91 사이 및 L91 뒤에 같은 GD 바이트를 비교해 board_init_f 전 초기화를 검증한다.
- 03proper와 XPL 경로 분리
실제 CONFIG를 기록한 뒤 proper의 skip-reloc 분기와 XPL FRAMEWORK의 NULL/non-NULL stack 반환을 각각 추적한다.
PRIMARY REFERENCES