← Bootloader DUJINLABS.COM

OP-TEE OS · source analysis

OP-TEE AArch64 _start와 TF-A 인자

BL31의 secure ERET가 OP-TEE _start로 들어온 뒤 relocation, BSS, MMU와 primary/secondary 경로를 준비하는 assembly를 읽습니다.

Series
02 / 12
Baseline
4.10.0
Commit
753afbbee168
Source
core/arch/arm/kernel/entry_a64.S:141

OP-TEE AArch64 _start와 TF-A 인자 단계에서 실제로 바뀌는 상태는 무엇인가?

TF-A가 넘긴 x0-x3, 현재 EL, MMU/cache 상태와 load address를 첫 명령부터 추적한다. pageable image를 복사하는 구간과 아직 참조할 수 없는 전역도 구분한다.

C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.

객체와 주소가 놓이는 구조

그림 1. OP-TEE AArch64 _start와 TF-A 인자에서 입력, 내부 상태, 출력의 경계
입력과 전제내부 상태외부로 공개되는 결과
01secure load address
02boot arguments
03init stack
04identity map/vector
INVARIANT

C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다.

_start / boot arguments / early stack를 중심에 놓고 왼쪽의 입력이 어떤 검사를 거쳐 오른쪽 결과로 공개되는지 표시했다. 실제 디버깅에서는 각 블록의 주소와 크기를 로그에 대입한다.

실행 흐름

그림 2. 정상 경로의 주요 호출과 상태 전달
BL31 ERET
_start
boot args preserve
relocate/BSS
MMU enable
C init

화살표는 단순 호출 순서만 뜻하지 않는다. 각 단계가 성공을 반환할 때 다음 단계가 읽을 수 있는 상태가 무엇인지 함께 확인한다. 오류 반환이 발생하면 바로 다음 화살표로 진행하지 않고 해당 단계의 정리 경로를 따라간다.

단계별 입력과 출력

호출 순서를 함수 이름으로만 외우지 않고, 각 단계가 무엇을 받아 무엇을 공개하는지 적은 표다. 실제 소스에서 생산 필드가 다르면 표를 고치는 방식으로 사용한다.

#단계진입 시 신뢰할 상태성공 뒤 남아야 할 상태다음 소비자
01BL31 ERETS-EL1 early assembly contextsecure load address_start
02_startBL31 ERET 완료 상태boot argumentsboot args preserve
03boot args preserve_start 완료 상태init stackrelocate/BSS
04relocate/BSSboot args preserve 완료 상태identity map/vectorMMU enable
05MMU enablerelocate/BSS 완료 상태identity map/vectorC init
06C initMMU enable 완료 상태identity map/vector최종 최종 부트로더 이미지 또는 다음 stage

공통 불변 조건: C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다. 한 단계의 출력이 다음 단계의 입력 조건을 만족하지 않으면 오류가 실제로 드러난 위치보다 앞의 생산 단계부터 조사한다.

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

아래 그림은 호출 이름보다 주소, 객체 수명과 handoff 경계를 먼저 볼 수 있도록 구성했다. 실제 주소와 크기는 사용 중인 보드의 bdinfo, map과 linker symbol을 대입한다.

그림 3. OP-TEE AArch64 _start와 TF-A 인자의 실행 순서

각 칸은 제어권이 다음 단계로 넘어가기 전에 확정되어야 하는 상태를 나타낸다.

01BL31 ERET
02_start
03boot args preserve
04relocate/BSS
05MMU enable
06C init
그림 4. TF-A BL32 인자와 OP-TEE 초기 사용 지점

왼쪽에서 만든 상태를 오른쪽 단계가 처음 사용하는 관계를 표시한다.

01x0pageable partinit_primary
02x1unused/platform argentry contract
03x2FDT/boot dataplatform init
04PC/SPSRS-EL1 entry_start

원본 코드

아래 코드는 OP-TEE OS 4.10.0의 core/arch/arm/kernel/entry_a64.S에서 141-229줄을 그대로 가져온 것이다. 설명을 위해 실제 코드를 가짜 의사 코드로 바꾸지 않았다.

commit753afbbee1682f5d16fd30e87b31058a4fd4f4b8symbolFUNC _start , :
141
142	.macro init_pauth_secondary_cpu
143		msr	spsel, #1
144		ldp	x0, x1, [sp, #THREAD_CORE_LOCAL_KEYS]
145		msr	spsel, #0
146		write_apiakeyhi x0
147		write_apiakeylo x1
148		mrs	x0, sctlr_el1
149		orr	x0, x0, #SCTLR_ENIA
150		msr	sctlr_el1, x0
151		isb
152	.endm
153
154	.macro init_pan
155		read_feat_pan x0
156		cmp	x0, #0
157		b.eq	1f
158		mrs	x0, sctlr_el1
159		bic	x0, x0, #SCTLR_SPAN
160		msr	sctlr_el1, x0
161		write_pan_enable
162	1:
163	.endm
164
165FUNC _start , :
166	/*
167	 * Temporary copy of boot argument registers, will be passed to
168	 * boot_save_args() further down.
169	 */
170	mov	x19, x0
171	mov	x20, x1
172	mov	x21, x2
173	mov	x22, x3
174
175	adr	x0, reset_vect_table
176	msr	vbar_el1, x0
177	isb
178
179#ifdef CFG_PAN
180	init_pan
181#endif
182
183	set_sctlr_el1
184	isb
185
186#ifdef CFG_WITH_PAGER
187	/*
188	 * Move init code into correct location and move hashes to a
189	 * temporary safe location until the heap is initialized.
190	 *
191	 * The binary is built as:
192	 * [Pager code, rodata and data] : In correct location
193	 * [Init code and rodata] : Should be copied to __init_start
194	 * [struct boot_embdata + data] : Should be saved before
195	 * initializing pager, first uint32_t tells the length of the data
196	 */
197	adr	x0, __init_start	/* dst */
198	adr	x1, __data_end		/* src */
199	adr	x2, __init_end
200	sub	x2, x2, x0		/* init len */
201	ldr	w4, [x1, x2]		/* length of hashes etc */
202	add	x2, x2, x4		/* length of init and hashes etc */
203	/* Copy backwards (as memmove) in case we're overlapping */
204	add	x0, x0, x2		/* __init_start + len */
205	add	x1, x1, x2		/* __data_end + len */
206	adr_l	x3, boot_cached_mem_end
207	str	x0, [x3]
208	adr	x2, __init_start
209copy_init:
210	ldp	x3, x4, [x1, #-16]!
211	stp	x3, x4, [x0, #-16]!
212	cmp	x0, x2
213	b.gt	copy_init
214#else
215	/*
216	 * The binary is built as:
217	 * [Core, rodata and data] : In correct location
218	 * [struct boot_embdata + data] : Should be moved to right before
219	 * __vcore_free_end, the first uint32_t tells the length of the
220	 * struct + data
221	 */
222	adr_l	x1, __data_end		/* src */
223	ldr	w2, [x1]		/* struct boot_embdata::total_len */
224	/* dst */
225	adr_l	x0, __vcore_free_end
226	sub	x0, x0, x2
227	/* round down to beginning of page */
228	bic	x0, x0, #(SMALL_PAGE_SIZE - 1)
229	adr_l	x3, boot_embdata_ptr

141-229줄 해설

원본에 보이는 모든 줄을 순서대로 설명한다. 빈 줄도 block 경계로 남겨, 코드와 설명의 위치가 어긋나지 않게 했다.

141(빈 줄)

이전 block 경계까지의 동작과 .macro init_pauth_secondary_cpu에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 secure load address 상태가 아래 블록의 입력으로 사용되는 경계다.

142.macro init_pauth_secondary_cpu

원본 142번 줄의 .macro init_pauth_secondary_cpu는 앞의 이전 block 경계 결과를 받아 다음 msr spsel, #1로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

143msr spsel, #1

msr spsel, #1 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

144ldp x0, x1, [sp, #THREAD_CORE_LOCAL_KEYS]

ldp x0, x1, [sp, #THREAD_CORE_LOCAL_KEYS] 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

145msr spsel, #0

msr spsel, #0 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

146write_apiakeyhi x0

원본 146번 줄의 write_apiakeyhi x0는 앞의 msr spsel, #0 결과를 받아 다음 write_apiakeylo x1로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

147write_apiakeylo x1

원본 147번 줄의 write_apiakeylo x1는 앞의 write_apiakeyhi x0 결과를 받아 다음 mrs x0, sctlr_el1로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

148mrs x0, sctlr_el1

mrs x0, sctlr_el1 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

149orr x0, x0, #SCTLR_ENIA

원본 149번 줄의 orr x0, x0, #SCTLR_ENIA는 앞의 mrs x0, sctlr_el1 결과를 받아 다음 msr sctlr_el1, x0로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

150msr sctlr_el1, x0

msr sctlr_el1, x0 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

151isb

원본 151번 줄의 isb는 앞의 msr sctlr_el1, x0 결과를 받아 다음 .endm로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

152.endm

원본 152번 줄의 .endm는 앞의 isb 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

153(빈 줄)

.endm까지의 동작과 .macro init_pan에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

154.macro init_pan

원본 154번 줄의 .macro init_pan는 앞의 이전 block 경계 결과를 받아 다음 read_feat_pan x0로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

155read_feat_pan x0

원본 155번 줄의 read_feat_pan x0는 앞의 .macro init_pan 결과를 받아 다음 cmp x0, #0로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

156cmp x0, #0

cmp x0, #0 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

157b.eq 1f

b.eq 1f 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

158mrs x0, sctlr_el1

mrs x0, sctlr_el1 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

159bic x0, x0, #SCTLR_SPAN

원본 159번 줄의 bic x0, x0, #SCTLR_SPAN는 앞의 mrs x0, sctlr_el1 결과를 받아 다음 msr sctlr_el1, x0로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

160msr sctlr_el1, x0

msr sctlr_el1, x0 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

161write_pan_enable

원본 161번 줄의 write_pan_enable는 앞의 msr sctlr_el1, x0 결과를 받아 다음 1:로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

1621:

원본 162번 줄의 1:는 앞의 write_pan_enable 결과를 받아 다음 .endm로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

163.endm

원본 163번 줄의 .endm는 앞의 1: 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

164(빈 줄)

.endm까지의 동작과 FUNC _start , :에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

165FUNC _start , :

원본 165번 줄의 FUNC _start , :는 앞의 이전 block 경계 결과를 받아 다음 /*로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

166/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

167* Temporary copy of boot argument registers, will be passed to

원본 주석이 'Temporary copy of boot argument registers, will be passed to'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

168* boot_save_args() further down.

원본 주석이 'boot_save_args() further down.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

169*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

170mov x19, x0

mov x19, x0 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

171mov x20, x1

mov x20, x1 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

172mov x21, x2

mov x21, x2 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

173mov x22, x3

mov x22, x3 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

174(빈 줄)

mov x22, x3까지의 동작과 adr x0, reset_vect_table에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

175adr x0, reset_vect_table

adr x0, reset_vect_table 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

176msr vbar_el1, x0

msr vbar_el1, x0 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

177isb

원본 177번 줄의 isb는 앞의 msr vbar_el1, x0 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

178(빈 줄)

isb까지의 동작과 #ifdef CFG_PAN에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

179#ifdef CFG_PAN

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

180init_pan

원본 180번 줄의 init_pan는 앞의 #ifdef CFG_PAN 결과를 받아 다음 #endif로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

181#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

182(빈 줄)

#endif까지의 동작과 set_sctlr_el1에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

183set_sctlr_el1

원본 183번 줄의 set_sctlr_el1는 앞의 이전 block 경계 결과를 받아 다음 isb로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

184isb

원본 184번 줄의 isb는 앞의 set_sctlr_el1 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

185(빈 줄)

isb까지의 동작과 #ifdef CFG_WITH_PAGER에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

186#ifdef CFG_WITH_PAGER

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

187/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

188* Move init code into correct location and move hashes to a

원본 주석이 'Move init code into correct location and move hashes to a'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

189* temporary safe location until the heap is initialized.

원본 주석이 'temporary safe location until the heap is initialized.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

190*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

191* The binary is built as:

원본 주석이 'The binary is built as:'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

192* [Pager code, rodata and data] : In correct location

원본 주석이 '[Pager code, rodata and data] : In correct location'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

193* [Init code and rodata] : Should be copied to __init_start

원본 주석이 '[Init code and rodata] : Should be copied to __init_start'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

194* [struct boot_embdata + data] : Should be saved before

원본 주석이 '[struct boot_embdata + data] : Should be saved before'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

195* initializing pager, first uint32_t tells the length of the data

원본 주석이 'initializing pager, first uint32_t tells the length of the data'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

196*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

197adr x0, __init_start /* dst */

adr x0, __init_start /* dst */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

198adr x1, __data_end /* src */

adr x1, __data_end /* src */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

199adr x2, __init_end

adr x2, __init_end 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

200sub x2, x2, x0 /* init len */

sub x2, x2, x0 /* init len */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

201ldr w4, [x1, x2] /* length of hashes etc */

ldr w4, [x1, x2] /* length of hashes etc */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

202add x2, x2, x4 /* length of init and hashes etc */

add x2, x2, x4 /* length of init and hashes etc */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

203/* Copy backwards (as memmove) in case we're overlapping */

원본 주석이 'Copy backwards (as memmove) in case we're overlapping'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

204add x0, x0, x2 /* __init_start + len */

add x0, x0, x2 /* __init_start + len */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

205add x1, x1, x2 /* __data_end + len */

add x1, x1, x2 /* __data_end + len */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

206adr_l x3, boot_cached_mem_end

원본 206번 줄의 adr_l x3, boot_cached_mem_end는 앞의 add x1, x1, x2 /* __data_end + len */ 결과를 받아 다음 str x0, [x3]로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

207str x0, [x3]

str x0, [x3] 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

208adr x2, __init_start

adr x2, __init_start 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

209copy_init:

'copy_init' label이다. 이곳을 참조하는 branch를 역검색하고 각 진입 경로의 register, stack, lock 조건이 같은지 확인한다.

210ldp x3, x4, [x1, #-16]!

ldp x3, x4, [x1, #-16]! 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

211stp x3, x4, [x0, #-16]!

stp x3, x4, [x0, #-16]! 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

212cmp x0, x2

cmp x0, x2 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

213b.gt copy_init

b.gt copy_init 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

214#else

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

215/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

216* The binary is built as:

원본 주석이 'The binary is built as:'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

217* [Core, rodata and data] : In correct location

원본 주석이 '[Core, rodata and data] : In correct location'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

218* [struct boot_embdata + data] : Should be moved to right before

원본 주석이 '[struct boot_embdata + data] : Should be moved to right before'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

219* __vcore_free_end, the first uint32_t tells the length of the

원본 주석이 '__vcore_free_end, the first uint32_t tells the length of the'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

220* struct + data

원본 주석이 'struct + data'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

221*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

222adr_l x1, __data_end /* src */

원본 222번 줄의 adr_l x1, __data_end /* src */는 앞의 */ 결과를 받아 다음 ldr w2, [x1] /* struct boot_embdata::total_len */로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

223ldr w2, [x1] /* struct boot_embdata::total_len */

ldr w2, [x1] /* struct boot_embdata::total_len */ 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

224/* dst */

원본 주석이 'dst'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

225adr_l x0, __vcore_free_end

원본 225번 줄의 adr_l x0, __vcore_free_end는 앞의 /* dst */ 결과를 받아 다음 sub x0, x0, x2로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

226sub x0, x0, x2

sub x0, x0, x2 명령이 register, memory 또는 PC를 직접 바꾼다. S-EL1 early assembly context에서 source operand의 이전 값과 destination operand의 새 값을 debugger로 확인한다.

227/* round down to beginning of page */

원본 주석이 'round down to beginning of page'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

228bic x0, x0, #(SMALL_PAGE_SIZE - 1)

원본 228번 줄의 bic x0, x0, #(SMALL_PAGE_SIZE - 1)는 앞의 /* round down to beginning of page */ 결과를 받아 다음 adr_l x3, boot_embdata_ptr로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

229adr_l x3, boot_embdata_ptr

원본 229번 줄의 adr_l x3, boot_embdata_ptr는 앞의 bic x0, x0, #(SMALL_PAGE_SIZE - 1) 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

함께 읽어야 하는 원본 코드

첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.

01. assembly 초기화 뒤 호출되는 primary C 초기화

core/arch/arm/kernel/boot.c 871-993줄이다.

filecore/arch/arm/kernel/boot.canchorstatic void init_primary(unsigned long pageable_part)
871}
872
873static bool add_padding_to_pool(vaddr_t va, size_t len, void *ptr __unused)
874{
875#ifdef CFG_NS_VIRTUALIZATION
876	nex_malloc_add_pool((void *)va, len);
877#else
878	malloc_add_pool((void *)va, len);
879#endif
880	return true;
881}
882
883static void init_primary(unsigned long pageable_part)
884{
885	vaddr_t va = 0;
886
887	/*
888	 * Mask asynchronous exceptions before switch to the thread vector
889	 * as the thread handler requires those to be masked while
890	 * executing with the temporary stack. The thread subsystem also
891	 * asserts that the foreign interrupts are blocked when using most of
892	 * its functions.
893	 */
894	thread_set_exceptions(THREAD_EXCP_ALL);
895	primary_save_cntfrq();
896	init_vfp_sec();
897
898	if (IS_ENABLED(CFG_CRYPTO_WITH_CE))
899		check_crypto_extensions();
900
901	init_asan();
902
903	/*
904	 * By default whole OP-TEE uses malloc, so we need to initialize
905	 * it early. But, when virtualization is enabled, malloc is used
906	 * only by TEE runtime, so malloc should be initialized later, for
907	 * every virtual partition separately. Core code uses nex_malloc
908	 * instead.
909	 */
910#ifdef CFG_WITH_PAGER
911	/* Add heap2 first as heap1 may be too small as initial bget pool */
912	malloc_add_pool(__heap2_start, __heap2_end - __heap2_start);
913#endif
914#ifdef CFG_NS_VIRTUALIZATION
915	nex_malloc_add_pool(__nex_heap_start, __nex_heap_end -
916					      __nex_heap_start);
917#else
918	malloc_add_pool(__heap1_start, __heap1_end - __heap1_start);
919#endif
920	IMSG_RAW("\n");
921	if (IS_ENABLED(CFG_DYN_CONFIG)) {
922		size_t sz = sizeof(struct thread_core_local) *
923			    CFG_TEE_CORE_NB_CORE;
924		void *p = boot_mem_alloc(sz, alignof(void *) * 2);
925
926#ifdef CFG_NS_VIRTUALIZATION
927		nex_malloc_add_pool(p, sz);
928#else
929		malloc_add_pool(p, sz);
930#endif
931	}
932
933	core_mmu_save_mem_map();
934	core_mmu_init_phys_mem();
935	boot_mem_foreach_padding(add_padding_to_pool, NULL);
936	va = boot_mem_release_unused();
937	if (!IS_ENABLED(CFG_WITH_PAGER)) {
938		/*
939		 * We must update boot_cached_mem_end to reflect the memory
940		 * just unmapped by boot_mem_release_unused().
941		 */
942		assert(va && va <= boot_cached_mem_end);
943		boot_cached_mem_end = va;
944	}
945
946	if (IS_ENABLED(CFG_DYN_CONFIG)) {
947		/*
948		 * This is needed to enable virt_page_alloc() now that
949		 * boot_mem_alloc() can't be used any longer.
950		 */
951		if (IS_ENABLED(CFG_NS_VIRTUALIZATION))
952			nex_page_alloc_init();
953		else
954			page_alloc_init();
955	}
956
957	if (IS_ENABLED(CFG_WITH_PAGER)) {
958		/*
959		 * Pager: init_runtime() calls thread_kernel_enable_vfp()
960		 * so we must set a current thread right now to avoid a
961		 * chicken-and-egg problem (thread_init_boot_thread() sets
962		 * the current thread but needs things set by
963		 * init_runtime()).
964		 */
965		thread_get_core_local()->curr_thread = 0;
966		init_pager_runtime(pageable_part);
967	}
968
969	/* Initialize canaries around the stacks */
970	thread_init_canaries();
971	thread_init_per_cpu();
972}
973
974static bool cpu_nmfi_enabled(void)
975{
976#if defined(ARM32)
977	return read_sctlr() & SCTLR_NMFI;
978#else
979	/* Note: ARM64 does not feature non-maskable FIQ support. */
980	return false;
981#endif
982}
983
984/*
985 * Note: this function is weak just to make it possible to exclude it from
986 * the unpaged area.
987 */
988void __weak boot_init_primary_late(unsigned long fdt __unused,
989				   unsigned long manifest __unused)
990{
991	size_t fdt_size = CFG_DTB_MAX_SIZE;
992
993	if (IS_ENABLED(CFG_TRANSFER_LIST) && mapped_tl) {

871-993줄 해설

871}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

872(빈 줄)

}까지의 동작과 static bool add_padding_to_pool(vaddr_t va, size_t len, void *ptr __unused)에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 boot arguments 상태가 아래 블록의 입력으로 사용되는 경계다.

873static bool add_padding_to_pool(vaddr_t va, size_t len, void *ptr __unused)

add_padding_to_pool 함수 정의가 시작된다. 입력은 vaddr_t va, size_t len, void *ptr __unused이며, S-EL1 early assembly context에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.

874{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

875#ifdef CFG_NS_VIRTUALIZATION

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

876nex_malloc_add_pool((void *)va, len);

nex_malloc_add_pool((void *)va, len)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

877#else

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

878malloc_add_pool((void *)va, len);

malloc_add_pool((void *)va, len)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

879#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

880return true;

true를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 _start / boot arguments / early stack를 정리하거나 다음 단계로 진행하는지 확인한다.

881}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

882(빈 줄)

}까지의 동작과 static void init_primary(unsigned long pageable_part)에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

883static void init_primary(unsigned long pageable_part)

init_primary 함수 정의가 시작된다. 입력은 unsigned long pageable_part이며, S-EL1 early assembly context에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.

884{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

885vaddr_t va = 0;

vaddr_t va0를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

886(빈 줄)

vaddr_t va = 0;까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

887/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

888* Mask asynchronous exceptions before switch to the thread vector

원본 주석이 'Mask asynchronous exceptions before switch to the thread vector'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

889* as the thread handler requires those to be masked while

원본 주석이 'as the thread handler requires those to be masked while'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

890* executing with the temporary stack. The thread subsystem also

원본 주석이 'executing with the temporary stack. The thread subsystem also'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

891* asserts that the foreign interrupts are blocked when using most of

원본 주석이 'asserts that the foreign interrupts are blocked when using most of'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

892* its functions.

원본 주석이 'its functions.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

893*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

894thread_set_exceptions(THREAD_EXCP_ALL);

thread_set_exceptions(THREAD_EXCP_ALL)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

895primary_save_cntfrq();

primary_save_cntfrq(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

896init_vfp_sec();

init_vfp_sec(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

897(빈 줄)

init_vfp_sec();까지의 동작과 if (IS_ENABLED(CFG_CRYPTO_WITH_CE))에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

898if (IS_ENABLED(CFG_CRYPTO_WITH_CE))

IS_ENABLED(CFG_CRYPTO_WITH_CE)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

899check_crypto_extensions();

check_crypto_extensions(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

900(빈 줄)

check_crypto_extensions();까지의 동작과 init_asan();에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

901init_asan();

init_asan(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

902(빈 줄)

init_asan();까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

903/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

904* By default whole OP-TEE uses malloc, so we need to initialize

원본 주석이 'By default whole OP-TEE uses malloc, so we need to initialize'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

905* it early. But, when virtualization is enabled, malloc is used

원본 주석이 'it early. But, when virtualization is enabled, malloc is used'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

906* only by TEE runtime, so malloc should be initialized later, for

원본 주석이 'only by TEE runtime, so malloc should be initialized later, for'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

907* every virtual partition separately. Core code uses nex_malloc

원본 주석이 'every virtual partition separately. Core code uses nex_malloc'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

908* instead.

원본 주석이 'instead.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

909*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

910#ifdef CFG_WITH_PAGER

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

911/* Add heap2 first as heap1 may be too small as initial bget pool */

원본 주석이 'Add heap2 first as heap1 may be too small as initial bget pool'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

912malloc_add_pool(__heap2_start, __heap2_end - __heap2_start);

malloc_add_pool(__heap2_start, __heap2_end - __heap2_start)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

913#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

914#ifdef CFG_NS_VIRTUALIZATION

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

915nex_malloc_add_pool(__nex_heap_start, __nex_heap_end -

nex_malloc_add_pool(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

916__nex_heap_start);

원본 916번 줄의 __nex_heap_start);는 앞의 nex_malloc_add_pool(__nex_heap_start, __nex_heap_end - 결과를 받아 다음 #else로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

917#else

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

918malloc_add_pool(__heap1_start, __heap1_end - __heap1_start);

malloc_add_pool(__heap1_start, __heap1_end - __heap1_start)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

919#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

920IMSG_RAW("\n");

IMSG_RAW("\n")를 호출한다. 반환 결과는 현재 줄 또는 다음 if (IS_ENABLED(CFG_DYN_CONFIG)) {에서 검사되는 흐름이다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

921if (IS_ENABLED(CFG_DYN_CONFIG)) {

IS_ENABLED(CFG_DYN_CONFIG)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

922size_t sz = sizeof(struct thread_core_local) *

원본 922번 줄의 size_t sz = sizeof(struct thread_core_local) *는 앞의 if (IS_ENABLED(CFG_DYN_CONFIG)) { 결과를 받아 다음 CFG_TEE_CORE_NB_CORE;로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

923CFG_TEE_CORE_NB_CORE;

원본 923번 줄의 CFG_TEE_CORE_NB_CORE;는 앞의 size_t sz = sizeof(struct thread_core_local) * 결과를 받아 다음 void *p = boot_mem_alloc(sz, alignof(void *) * 2);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

924void *p = boot_mem_alloc(sz, alignof(void *) * 2);

void *p = boot_mem_alloc(sz, alignof(void *) * 2)를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

925(빈 줄)

void *p = boot_mem_alloc(sz, alignof(void *) * 2);까지의 동작과 #ifdef CFG_NS_VIRTUALIZATION에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

926#ifdef CFG_NS_VIRTUALIZATION

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

927nex_malloc_add_pool(p, sz);

nex_malloc_add_pool(p, sz)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

928#else

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

929malloc_add_pool(p, sz);

malloc_add_pool(p, sz)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

930#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

931}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

932(빈 줄)

}까지의 동작과 core_mmu_save_mem_map();에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

933core_mmu_save_mem_map();

core_mmu_save_mem_map(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

934core_mmu_init_phys_mem();

core_mmu_init_phys_mem(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

935boot_mem_foreach_padding(add_padding_to_pool, NULL);

boot_mem_foreach_padding(add_padding_to_pool, NULL)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

936va = boot_mem_release_unused();

vaboot_mem_release_unused()를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

937if (!IS_ENABLED(CFG_WITH_PAGER)) {

!IS_ENABLED(CFG_WITH_PAGER)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

938/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

939* We must update boot_cached_mem_end to reflect the memory

원본 주석이 'We must update boot_cached_mem_end to reflect the memory'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

940* just unmapped by boot_mem_release_unused().

원본 주석이 'just unmapped by boot_mem_release_unused().'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

941*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

942assert(va && va <= boot_cached_mem_end);

assert(va && va <boot_cached_mem_end)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

943boot_cached_mem_end = va;

boot_cached_mem_endva를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

944}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

945(빈 줄)

}까지의 동작과 if (IS_ENABLED(CFG_DYN_CONFIG)) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

946if (IS_ENABLED(CFG_DYN_CONFIG)) {

IS_ENABLED(CFG_DYN_CONFIG)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

947/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

948* This is needed to enable virt_page_alloc() now that

원본 주석이 'This is needed to enable virt_page_alloc() now that'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

949* boot_mem_alloc() can't be used any longer.

원본 주석이 'boot_mem_alloc() can't be used any longer.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

950*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

951if (IS_ENABLED(CFG_NS_VIRTUALIZATION))

IS_ENABLED(CFG_NS_VIRTUALIZATION)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

952nex_page_alloc_init();

nex_page_alloc_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

953else

원본 953번 줄의 else는 앞의 nex_page_alloc_init(); 결과를 받아 다음 page_alloc_init();로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

954page_alloc_init();

page_alloc_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

955}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

956(빈 줄)

}까지의 동작과 if (IS_ENABLED(CFG_WITH_PAGER)) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

957if (IS_ENABLED(CFG_WITH_PAGER)) {

IS_ENABLED(CFG_WITH_PAGER)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

958/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

959* Pager: init_runtime() calls thread_kernel_enable_vfp()

원본 주석이 'Pager: init_runtime() calls thread_kernel_enable_vfp()'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

960* so we must set a current thread right now to avoid a

원본 주석이 'so we must set a current thread right now to avoid a'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

961* chicken-and-egg problem (thread_init_boot_thread() sets

원본 주석이 'chicken-and-egg problem (thread_init_boot_thread() sets'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

962* the current thread but needs things set by

원본 주석이 'the current thread but needs things set by'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

963* init_runtime()).

원본 주석이 'init_runtime()).'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

964*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

965thread_get_core_local()->curr_thread = 0;

thread_get_core_local()->curr_thread0를 = 연산으로 반영해 _start / boot arguments / early stack와 연결된 field를 갱신한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

966init_pager_runtime(pageable_part);

init_pager_runtime(pageable_part)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

967}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

968(빈 줄)

}까지의 동작과 /* Initialize canaries around the stacks */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

969/* Initialize canaries around the stacks */

원본 주석이 'Initialize canaries around the stacks'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

970thread_init_canaries();

thread_init_canaries(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

971thread_init_per_cpu();

thread_init_per_cpu(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

972}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

973(빈 줄)

}까지의 동작과 static bool cpu_nmfi_enabled(void)에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

974static bool cpu_nmfi_enabled(void)

cpu_nmfi_enabled 함수 정의가 시작된다. 입력은 void이며, S-EL1 early assembly context에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.

975{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

976#if defined(ARM32)

#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

977return read_sctlr() & SCTLR_NMFI;

read_sctlr() & SCTLR_NMFI를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 _start / boot arguments / early stack를 정리하거나 다음 단계로 진행하는지 확인한다.

978#else

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

979/* Note: ARM64 does not feature non-maskable FIQ support. */

원본 주석이 'Note: ARM64 does not feature non-maskable FIQ support.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

980return false;

false를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 _start / boot arguments / early stack를 정리하거나 다음 단계로 진행하는지 확인한다.

981#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

982}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

983(빈 줄)

}까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

984/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

985* Note: this function is weak just to make it possible to exclude it from

원본 주석이 'Note: this function is weak just to make it possible to exclude it from'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

986* the unpaged area.

원본 주석이 'the unpaged area.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

987*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

988void __weak boot_init_primary_late(unsigned long fdt __unused,

boot_init_primary_late(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

989unsigned long manifest __unused)

원본 989번 줄의 unsigned long manifest __unused)는 앞의 void __weak boot_init_primary_late(unsigned long fdt __unused, 결과를 받아 다음 {로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

990{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

991size_t fdt_size = CFG_DTB_MAX_SIZE;

size_t fdt_size = CFG_DTB_MAX_SIZE를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

992(빈 줄)

size_t fdt_size = CFG_DTB_MAX_SIZE;까지의 동작과 if (IS_ENABLED(CFG_TRANSFER_LIST) && mapped_tl) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

993if (IS_ENABLED(CFG_TRANSFER_LIST) && mapped_tl) {

IS_ENABLED(CFG_TRANSFER_LIST) && mapped_tl를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

02. pageable image를 검증하고 pager runtime을 구성

core/arch/arm/kernel/boot.c 464-646줄이다.

filecore/arch/arm/kernel/boot.canchorstatic void init_pager_runtime(unsigned long pageable_part)
464#ifdef CFG_CORE_ASLR
465	unsigned int reloc_offs = (vaddr_t)__pageable_start - VCORE_START_VA;
466	const struct boot_embdata *embdata = (const void *)__init_end;
467	const void *reloc = __init_end + embdata->reloc_offset;
468
469	return fobj_ro_reloc_paged_alloc(num_pages, hashes, reloc_offs,
470					 reloc, embdata->reloc_len, store);
471#else
472	return fobj_ro_paged_alloc(num_pages, hashes, store);
473#endif
474}
475
476static void init_pager_runtime(unsigned long pageable_part)
477{
478	size_t n;
479	size_t init_size = (size_t)(__init_end - __init_start);
480	size_t pageable_start = (size_t)__pageable_start;
481	size_t pageable_end = (size_t)__pageable_end;
482	size_t pageable_size = pageable_end - pageable_start;
483	vaddr_t tzsram_end = TZSRAM_BASE + TZSRAM_SIZE - TEE_LOAD_ADDR +
484			     VCORE_START_VA;
485	size_t hash_size = (pageable_size / SMALL_PAGE_SIZE) *
486			   TEE_SHA256_HASH_SIZE;
487	const struct boot_embdata *embdata = (const void *)__init_end;
488	const void *tmp_hashes = NULL;
489	tee_mm_entry_t *mm = NULL;
490	struct fobj *fobj = NULL;
491	uint8_t *paged_store = NULL;
492	uint8_t *hashes = NULL;
493
494	assert(pageable_size % SMALL_PAGE_SIZE == 0);
495	assert(embdata->total_len >= embdata->hashes_offset +
496				     embdata->hashes_len);
497	assert(hash_size == embdata->hashes_len);
498
499	tmp_hashes = __init_end + embdata->hashes_offset;
500
501	/*
502	 * This needs to be initialized early to support address lookup
503	 * in MEM_AREA_TEE_RAM
504	 */
505	tee_pager_early_init();
506
507	hashes = malloc(hash_size);
508	IMSG_RAW("\n");
509	IMSG("Pager is enabled. Hashes: %zu bytes", hash_size);
510	assert(hashes);
511	asan_memcpy_unchecked(hashes, tmp_hashes, hash_size);
512
513	/*
514	 * The pager is about the be enabled below, eventual temporary boot
515	 * memory allocation must be removed now.
516	 */
517	boot_mem_release_tmp_alloc();
518
519	carve_out_asan_mem();
520
521	mm = nex_phys_mem_ta_alloc(pageable_size);
522	assert(mm);
523	paged_store = phys_to_virt(tee_mm_get_smem(mm),
524				   MEM_AREA_SEC_RAM_OVERALL, pageable_size);
525	/*
526	 * Load pageable part in the dedicated allocated area:
527	 * - Move pageable non-init part into pageable area. Note bootloader
528	 *   may have loaded it anywhere in TA RAM hence use memmove().
529	 * - Copy pageable init part from current location into pageable area.
530	 */
531	memmove(paged_store + init_size,
532		phys_to_virt(pageable_part,
533			     core_mmu_get_type_by_pa(pageable_part),
534			     __pageable_part_end - __pageable_part_start),
535		__pageable_part_end - __pageable_part_start);
536	asan_memcpy_unchecked(paged_store, __init_start, init_size);
537	/*
538	 * Undo eventual relocation for the init part so the hash checks
539	 * can pass.
540	 */
541	undo_init_relocation(paged_store);
542
543	/* Check that hashes of what's in pageable area is OK */
544	DMSG("Checking hashes of pageable area");
545	for (n = 0; (n * SMALL_PAGE_SIZE) < pageable_size; n++) {
546		const uint8_t *hash = hashes + n * TEE_SHA256_HASH_SIZE;
547		const uint8_t *page = paged_store + n * SMALL_PAGE_SIZE;
548		TEE_Result res;
549
550		DMSG("hash pg_idx %zu hash %p page %p", n, hash, page);
551		res = hash_sha256_check(hash, page, SMALL_PAGE_SIZE);
552		if (res != TEE_SUCCESS) {
553			EMSG("Hash failed for page %zu at %p: res 0x%x",
554			     n, (void *)page, res);
555			panic();
556		}
557	}
558
559	/*
560	 * Assert prepaged init sections are page aligned so that nothing
561	 * trails uninited at the end of the premapped init area.
562	 */
563	assert(!(init_size & SMALL_PAGE_MASK));
564
565	/*
566	 * Initialize the virtual memory pool used for main_mmu_l2_ttb which
567	 * is supplied to tee_pager_init() below.
568	 */
569	init_virt_pool(&core_virt_mem_pool);
570
571	/*
572	 * Assign alias area for pager end of the small page block the rest
573	 * of the binary is loaded into. We're taking more than needed, but
574	 * we're guaranteed to not need more than the physical amount of
575	 * TZSRAM.
576	 */
577	mm = tee_mm_alloc2(&core_virt_mem_pool,
578			   (vaddr_t)core_virt_mem_pool.lo +
579			   core_virt_mem_pool.size - TZSRAM_SIZE,
580			   TZSRAM_SIZE);
581	assert(mm);
582	tee_pager_set_alias_area(mm);
583
584	/*
585	 * Claim virtual memory which isn't paged.
586	 * Linear memory (flat map core memory) ends there.
587	 */
588	mm = tee_mm_alloc2(&core_virt_mem_pool, VCORE_UNPG_RX_PA,
589			   (vaddr_t)(__pageable_start - VCORE_UNPG_RX_PA));
590	assert(mm);
591
592	/*
593	 * Allocate virtual memory for the pageable area and let the pager
594	 * take charge of all the pages already assigned to that memory.
595	 */
596	mm = tee_mm_alloc2(&core_virt_mem_pool, (vaddr_t)__pageable_start,
597			   pageable_size);
598	assert(mm);
599	fobj = ro_paged_alloc(mm, hashes, paged_store);
600	assert(fobj);
601	tee_pager_add_core_region(tee_mm_get_smem(mm), PAGED_REGION_TYPE_RO,
602				  fobj);
603	fobj_put(fobj);
604
605	tee_pager_add_pages(pageable_start, init_size / SMALL_PAGE_SIZE, false);
606	tee_pager_add_pages(pageable_start + init_size,
607			    (pageable_size - init_size) / SMALL_PAGE_SIZE,
608			    true);
609	if (pageable_end < tzsram_end)
610		tee_pager_add_pages(pageable_end, (tzsram_end - pageable_end) /
611						   SMALL_PAGE_SIZE, true);
612
613	/*
614	 * There may be physical pages in TZSRAM before the core load address.
615	 * These pages can be added to the physical pages pool of the pager.
616	 * This setup may happen when a the secure bootloader runs in TZRAM
617	 * and its memory can be reused by OP-TEE once boot stages complete.
618	 */
619	tee_pager_add_pages(core_virt_mem_pool.lo,
620			    (VCORE_UNPG_RX_PA - core_virt_mem_pool.lo) /
621				SMALL_PAGE_SIZE,
622			    true);
623
624	print_pager_pool_size();
625}
626#else /*!CFG_WITH_PAGER*/
627static void init_pager_runtime(unsigned long pageable_part __unused)
628{
629}
630#endif
631
632#if defined(CFG_DT)
633static int add_optee_dt_node(struct dt_descriptor *dt)
634{
635	int offs;
636	int ret;
637
638	if (fdt_path_offset(dt->blob, "/firmware/optee") >= 0) {
639		DMSG("OP-TEE Device Tree node already exists!");
640		return 0;
641	}
642
643	offs = fdt_path_offset(dt->blob, "/firmware");
644	if (offs < 0) {
645		offs = add_dt_path_subnode(dt, "/", "firmware");
646		if (offs < 0)

464-646줄 해설

464#ifdef CFG_CORE_ASLR

#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

465unsigned int reloc_offs = (vaddr_t)__pageable_start - VCORE_START_VA;

unsigned int reloc_offs = (vaddr_t)__pageable_start - VCORE_START_VA를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

466const struct boot_embdata *embdata = (const void *)__init_end;

const struct boot_embdata *embdata = (const void *)__init_end를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

467const void *reloc = __init_end + embdata->reloc_offset;

const void *reloc = __init_end + embdata->reloc_offset를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

468(빈 줄)

const void *reloc = __init_end + embdata->reloc_offset;까지의 동작과 return fobj_ro_reloc_paged_alloc(num_pages, hashes, reloc_offs,에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

469return fobj_ro_reloc_paged_alloc(num_pages, hashes, reloc_offs,

fobj_ro_reloc_paged_alloc(num_pages, hashes, reloc_offs,를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 _start / boot arguments / early stack를 정리하거나 다음 단계로 진행하는지 확인한다.

470reloc, embdata->reloc_len, store);

원본 470번 줄의 reloc, embdata->reloc_len, store);는 앞의 return fobj_ro_reloc_paged_alloc(num_pages, hashes, reloc_offs, 결과를 받아 다음 #else로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

471#else

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

472return fobj_ro_paged_alloc(num_pages, hashes, store);

fobj_ro_paged_alloc(num_pages, hashes, store)를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 _start / boot arguments / early stack를 정리하거나 다음 단계로 진행하는지 확인한다.

473#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

474}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

475(빈 줄)

}까지의 동작과 static void init_pager_runtime(unsigned long pageable_part)에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

476static void init_pager_runtime(unsigned long pageable_part)

init_pager_runtime 함수 정의가 시작된다. 입력은 unsigned long pageable_part이며, S-EL1 early assembly context에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.

477{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

478size_t n;

size_t n를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

479size_t init_size = (size_t)(__init_end - __init_start);

size_t init_size = (size_t)(__init_end - __init_start)를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

480size_t pageable_start = (size_t)__pageable_start;

size_t pageable_start = (size_t)__pageable_start를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

481size_t pageable_end = (size_t)__pageable_end;

size_t pageable_end = (size_t)__pageable_end를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

482size_t pageable_size = pageable_end - pageable_start;

size_t pageable_size = pageable_end - pageable_start를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

483vaddr_t tzsram_end = TZSRAM_BASE + TZSRAM_SIZE - TEE_LOAD_ADDR +

원본 483번 줄의 vaddr_t tzsram_end = TZSRAM_BASE + TZSRAM_SIZE - TEE_LOAD_ADDR +는 앞의 size_t pageable_size = pageable_end - pageable_start; 결과를 받아 다음 VCORE_START_VA;로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

484VCORE_START_VA;

원본 484번 줄의 VCORE_START_VA;는 앞의 vaddr_t tzsram_end = TZSRAM_BASE + TZSRAM_SIZE - TEE_LOAD_ADDR + 결과를 받아 다음 size_t hash_size = (pageable_size / SMALL_PAGE_SIZE) *로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

485size_t hash_size = (pageable_size / SMALL_PAGE_SIZE) *

원본 485번 줄의 size_t hash_size = (pageable_size / SMALL_PAGE_SIZE) *는 앞의 VCORE_START_VA; 결과를 받아 다음 TEE_SHA256_HASH_SIZE;로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

486TEE_SHA256_HASH_SIZE;

원본 486번 줄의 TEE_SHA256_HASH_SIZE;는 앞의 size_t hash_size = (pageable_size / SMALL_PAGE_SIZE) * 결과를 받아 다음 const struct boot_embdata *embdata = (const void *)__init_end;로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

487const struct boot_embdata *embdata = (const void *)__init_end;

const struct boot_embdata *embdata = (const void *)__init_end를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

488const void *tmp_hashes = NULL;

const void *tmp_hashes = NULL를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

489tee_mm_entry_t *mm = NULL;

tee_mm_entry_t *mmNULL를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

490struct fobj *fobj = NULL;

struct fobj *fobj = NULL를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

491uint8_t *paged_store = NULL;

uint8_t *paged_storeNULL를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

492uint8_t *hashes = NULL;

uint8_t *hashesNULL를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

493(빈 줄)

uint8_t *hashes = NULL;까지의 동작과 assert(pageable_size % SMALL_PAGE_SIZE == 0);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

494assert(pageable_size % SMALL_PAGE_SIZE == 0);

assert(pageable_size % SMALL_PAGE_SIZE= 0)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

495assert(embdata->total_len >= embdata->hashes_offset +

assert(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

496embdata->hashes_len);

원본 496번 줄의 embdata->hashes_len);는 앞의 assert(embdata->total_len >= embdata->hashes_offset + 결과를 받아 다음 assert(hash_size == embdata->hashes_len);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

497assert(hash_size == embdata->hashes_len);

assert(hash_size= embdata->hashes_len)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

498(빈 줄)

assert(hash_size == embdata->hashes_len);까지의 동작과 tmp_hashes = __init_end + embdata->hashes_offset;에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

499tmp_hashes = __init_end + embdata->hashes_offset;

tmp_hashes__init_end + embdata->hashes_offset를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

500(빈 줄)

tmp_hashes = __init_end + embdata->hashes_offset;까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

501/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

502* This needs to be initialized early to support address lookup

원본 주석이 'This needs to be initialized early to support address lookup'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

503* in MEM_AREA_TEE_RAM

원본 주석이 'in MEM_AREA_TEE_RAM'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

504*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

505tee_pager_early_init();

tee_pager_early_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

506(빈 줄)

tee_pager_early_init();까지의 동작과 hashes = malloc(hash_size);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

507hashes = malloc(hash_size);

hashesmalloc(hash_size)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

508IMSG_RAW("\n");

IMSG_RAW("\n")를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

509IMSG("Pager is enabled. Hashes: %zu bytes", hash_size);

IMSG("Pager is enabled. Hashes: %zu bytes", hash_size)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

510assert(hashes);

assert(hashes)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

511asan_memcpy_unchecked(hashes, tmp_hashes, hash_size);

asan_memcpy_unchecked(hashes, tmp_hashes, hash_size)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

512(빈 줄)

asan_memcpy_unchecked(hashes, tmp_hashes, hash_size);까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

513/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

514* The pager is about the be enabled below, eventual temporary boot

원본 주석이 'The pager is about the be enabled below, eventual temporary boot'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

515* memory allocation must be removed now.

원본 주석이 'memory allocation must be removed now.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

516*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

517boot_mem_release_tmp_alloc();

boot_mem_release_tmp_alloc(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

518(빈 줄)

boot_mem_release_tmp_alloc();까지의 동작과 carve_out_asan_mem();에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

519carve_out_asan_mem();

carve_out_asan_mem(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

520(빈 줄)

carve_out_asan_mem();까지의 동작과 mm = nex_phys_mem_ta_alloc(pageable_size);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

521mm = nex_phys_mem_ta_alloc(pageable_size);

mmnex_phys_mem_ta_alloc(pageable_size)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 assert(mm);가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

522assert(mm);

assert(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

523paged_store = phys_to_virt(tee_mm_get_smem(mm),

tee_mm_get_smem(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

524MEM_AREA_SEC_RAM_OVERALL, pageable_size);

원본 524번 줄의 MEM_AREA_SEC_RAM_OVERALL, pageable_size);는 앞의 paged_store = phys_to_virt(tee_mm_get_smem(mm), 결과를 받아 다음 /*로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

525/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

526* Load pageable part in the dedicated allocated area:

원본 주석이 'Load pageable part in the dedicated allocated area:'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

527* - Move pageable non-init part into pageable area. Note bootloader

원본 주석이 '- Move pageable non-init part into pageable area. Note bootloader'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

528* may have loaded it anywhere in TA RAM hence use memmove().

원본 주석이 'may have loaded it anywhere in TA RAM hence use memmove().'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

529* - Copy pageable init part from current location into pageable area.

원본 주석이 '- Copy pageable init part from current location into pageable area.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

530*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

531memmove(paged_store + init_size,

memmove(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

532phys_to_virt(pageable_part,

phys_to_virt(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

533core_mmu_get_type_by_pa(pageable_part),

core_mmu_get_type_by_pa(pageable_part)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

534__pageable_part_end - __pageable_part_start),

원본 534번 줄의 __pageable_part_end - __pageable_part_start),는 앞의 core_mmu_get_type_by_pa(pageable_part), 결과를 받아 다음 __pageable_part_end - __pageable_part_start);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

535__pageable_part_end - __pageable_part_start);

원본 535번 줄의 __pageable_part_end - __pageable_part_start);는 앞의 __pageable_part_end - __pageable_part_start), 결과를 받아 다음 asan_memcpy_unchecked(paged_store, __init_start, init_size);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

536asan_memcpy_unchecked(paged_store, __init_start, init_size);

asan_memcpy_unchecked(paged_store, __init_start, init_size)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

537/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

538* Undo eventual relocation for the init part so the hash checks

원본 주석이 'Undo eventual relocation for the init part so the hash checks'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

539* can pass.

원본 주석이 'can pass.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

540*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

541undo_init_relocation(paged_store);

undo_init_relocation(paged_store)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

542(빈 줄)

undo_init_relocation(paged_store);까지의 동작과 /* Check that hashes of what's in pageable area is OK */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

543/* Check that hashes of what's in pageable area is OK */

원본 주석이 'Check that hashes of what's in pageable area is OK'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

544DMSG("Checking hashes of pageable area");

DMSG("Checking hashes of pageable area")를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

545for (n = 0; (n * SMALL_PAGE_SIZE) < pageable_size; n++) {

'for (n = 0; (n * SMALL_PAGE_SIZE) < pageable_size; n++) {'가 목록이나 후보를 순회한다. 반복 중 _start / boot arguments / early stack를 제거·추가하는 호출이 있는지와 loop 종료 뒤 iterator가 유효한지 확인한다.

546const uint8_t *hash = hashes + n * TEE_SHA256_HASH_SIZE;

const uint8_t *hashhashes + n * TEE_SHA256_HASH_SIZE를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

547const uint8_t *page = paged_store + n * SMALL_PAGE_SIZE;

const uint8_t *pagepaged_store + n * SMALL_PAGE_SIZE를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 C init 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

548TEE_Result res;

원본 548번 줄의 TEE_Result res;는 앞의 const uint8_t *page = paged_store + n * SMALL_PAGE_SIZE; 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

549(빈 줄)

TEE_Result res;까지의 동작과 DMSG("hash pg_idx %zu hash %p page %p", n, hash, page);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

550DMSG("hash pg_idx %zu hash %p page %p", n, hash, page);

DMSG("hash pg_idx %zu hash %p page %p", n, hash, page)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

551res = hash_sha256_check(hash, page, SMALL_PAGE_SIZE);

reshash_sha256_check(hash, page, SMALL_PAGE_SIZE)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 if (res != TEE_SUCCESS) {가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

552if (res != TEE_SUCCESS) {

res != TEE_SUCCESS를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

553EMSG("Hash failed for page %zu at %p: res 0x%x",

EMSG(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

554n, (void *)page, res);

원본 554번 줄의 n, (void *)page, res);는 앞의 EMSG("Hash failed for page %zu at %p: res 0x%x", 결과를 받아 다음 panic();로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

555panic();

panic(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

556}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

557}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

558(빈 줄)

}까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

559/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

560* Assert prepaged init sections are page aligned so that nothing

원본 주석이 'Assert prepaged init sections are page aligned so that nothing'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

561* trails uninited at the end of the premapped init area.

원본 주석이 'trails uninited at the end of the premapped init area.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

562*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

563assert(!(init_size & SMALL_PAGE_MASK));

assert(!(init_size & SMALL_PAGE_MASK))를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

564(빈 줄)

assert(!(init_size & SMALL_PAGE_MASK));까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

565/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

566* Initialize the virtual memory pool used for main_mmu_l2_ttb which

원본 주석이 'Initialize the virtual memory pool used for main_mmu_l2_ttb which'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

567* is supplied to tee_pager_init() below.

원본 주석이 'is supplied to tee_pager_init() below.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

568*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

569init_virt_pool(&core_virt_mem_pool);

init_virt_pool(&core_virt_mem_pool)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

570(빈 줄)

init_virt_pool(&core_virt_mem_pool);까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

571/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

572* Assign alias area for pager end of the small page block the rest

원본 주석이 'Assign alias area for pager end of the small page block the rest'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

573* of the binary is loaded into. We're taking more than needed, but

원본 주석이 'of the binary is loaded into. We're taking more than needed, but'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

574* we're guaranteed to not need more than the physical amount of

원본 주석이 'we're guaranteed to not need more than the physical amount of'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

575* TZSRAM.

원본 주석이 'TZSRAM.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

576*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

577mm = tee_mm_alloc2(&core_virt_mem_pool,

tee_mm_alloc2(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

578(vaddr_t)core_virt_mem_pool.lo +

원본 578번 줄의 (vaddr_t)core_virt_mem_pool.lo +는 앞의 mm = tee_mm_alloc2(&core_virt_mem_pool, 결과를 받아 다음 core_virt_mem_pool.size - TZSRAM_SIZE,로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

579core_virt_mem_pool.size - TZSRAM_SIZE,

원본 579번 줄의 core_virt_mem_pool.size - TZSRAM_SIZE,는 앞의 (vaddr_t)core_virt_mem_pool.lo + 결과를 받아 다음 TZSRAM_SIZE);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

580TZSRAM_SIZE);

원본 580번 줄의 TZSRAM_SIZE);는 앞의 core_virt_mem_pool.size - TZSRAM_SIZE, 결과를 받아 다음 assert(mm);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

581assert(mm);

assert(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

582tee_pager_set_alias_area(mm);

tee_pager_set_alias_area(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

583(빈 줄)

tee_pager_set_alias_area(mm);까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

584/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

585* Claim virtual memory which isn't paged.

원본 주석이 'Claim virtual memory which isn't paged.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

586* Linear memory (flat map core memory) ends there.

원본 주석이 'Linear memory (flat map core memory) ends there.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

587*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

588mm = tee_mm_alloc2(&core_virt_mem_pool, VCORE_UNPG_RX_PA,

tee_mm_alloc2(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

589(vaddr_t)(__pageable_start - VCORE_UNPG_RX_PA));

원본 589번 줄의 (vaddr_t)(__pageable_start - VCORE_UNPG_RX_PA));는 앞의 mm = tee_mm_alloc2(&core_virt_mem_pool, VCORE_UNPG_RX_PA, 결과를 받아 다음 assert(mm);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

590assert(mm);

assert(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

591(빈 줄)

assert(mm);까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

592/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

593* Allocate virtual memory for the pageable area and let the pager

원본 주석이 'Allocate virtual memory for the pageable area and let the pager'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

594* take charge of all the pages already assigned to that memory.

원본 주석이 'take charge of all the pages already assigned to that memory.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

595*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

596mm = tee_mm_alloc2(&core_virt_mem_pool, (vaddr_t)__pageable_start,

tee_mm_alloc2(&core_virt_mem_pool, (vaddr_t)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

597pageable_size);

원본 597번 줄의 pageable_size);는 앞의 mm = tee_mm_alloc2(&core_virt_mem_pool, (vaddr_t)__pageable_start, 결과를 받아 다음 assert(mm);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

598assert(mm);

assert(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

599fobj = ro_paged_alloc(mm, hashes, paged_store);

fobjro_paged_alloc(mm, hashes, paged_store)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 assert(fobj);가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

600assert(fobj);

assert(fobj)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

601tee_pager_add_core_region(tee_mm_get_smem(mm), PAGED_REGION_TYPE_RO,

tee_mm_get_smem(mm)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

602fobj);

원본 602번 줄의 fobj);는 앞의 tee_pager_add_core_region(tee_mm_get_smem(mm), PAGED_REGION_TYPE_RO, 결과를 받아 다음 fobj_put(fobj);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

603fobj_put(fobj);

fobj_put(fobj)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

604(빈 줄)

fobj_put(fobj);까지의 동작과 tee_pager_add_pages(pageable_start, init_size / SMALL_PAGE_SIZE, false);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

605tee_pager_add_pages(pageable_start, init_size / SMALL_PAGE_SIZE, false);

tee_pager_add_pages(pageable_start, init_size / SMALL_PAGE_SIZE, false)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

606tee_pager_add_pages(pageable_start + init_size,

tee_pager_add_pages(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

607(pageable_size - init_size) / SMALL_PAGE_SIZE,

원본 607번 줄의 (pageable_size - init_size) / SMALL_PAGE_SIZE,는 앞의 tee_pager_add_pages(pageable_start + init_size, 결과를 받아 다음 true);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

608true);

원본 608번 줄의 true);는 앞의 (pageable_size - init_size) / SMALL_PAGE_SIZE, 결과를 받아 다음 if (pageable_end < tzsram_end)로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

609if (pageable_end < tzsram_end)

pageable_end < tzsram_end를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

610tee_pager_add_pages(pageable_end, (tzsram_end - pageable_end) /

tee_pager_add_pages(pageable_end, (tzsram_end - pageable_end)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

611SMALL_PAGE_SIZE, true);

원본 611번 줄의 SMALL_PAGE_SIZE, true);는 앞의 tee_pager_add_pages(pageable_end, (tzsram_end - pageable_end) / 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

612(빈 줄)

SMALL_PAGE_SIZE, true);까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

613/*

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

614* There may be physical pages in TZSRAM before the core load address.

원본 주석이 'There may be physical pages in TZSRAM before the core load address.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

615* These pages can be added to the physical pages pool of the pager.

원본 주석이 'These pages can be added to the physical pages pool of the pager.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

616* This setup may happen when a the secure bootloader runs in TZRAM

원본 주석이 'This setup may happen when a the secure bootloader runs in TZRAM'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

617* and its memory can be reused by OP-TEE once boot stages complete.

원본 주석이 'and its memory can be reused by OP-TEE once boot stages complete.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

618*/

원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.

619tee_pager_add_pages(core_virt_mem_pool.lo,

tee_pager_add_pages(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

620(VCORE_UNPG_RX_PA - core_virt_mem_pool.lo) /

원본 620번 줄의 (VCORE_UNPG_RX_PA - core_virt_mem_pool.lo) /는 앞의 tee_pager_add_pages(core_virt_mem_pool.lo, 결과를 받아 다음 SMALL_PAGE_SIZE,로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

621SMALL_PAGE_SIZE,

원본 621번 줄의 SMALL_PAGE_SIZE,는 앞의 (VCORE_UNPG_RX_PA - core_virt_mem_pool.lo) / 결과를 받아 다음 true);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

622true);

원본 622번 줄의 true);는 앞의 SMALL_PAGE_SIZE, 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건이 유지되는지 확인한다.

623(빈 줄)

true);까지의 동작과 print_pager_pool_size();에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

624print_pager_pool_size();

print_pager_pool_size(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

625}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

626#else /*!CFG_WITH_PAGER*/

#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

627static void init_pager_runtime(unsigned long pageable_part __unused)

init_pager_runtime 함수 정의가 시작된다. 입력은 unsigned long pageable_part __unused이며, S-EL1 early assembly context에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.

628{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

629}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

630#endif

#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

631(빈 줄)

#endif까지의 동작과 #if defined(CFG_DT)에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

632#if defined(CFG_DT)

#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.

633static int add_optee_dt_node(struct dt_descriptor *dt)

add_optee_dt_node 함수 정의가 시작된다. 입력은 struct dt_descriptor *dt이며, S-EL1 early assembly context에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.

634{

바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 _start / boot arguments / early stack의 수명에 맞춰 묶어 읽는다.

635int offs;

int offs를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

636int ret;

int ret를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 _start / boot arguments / early stack를 직접 소유하는지 pointer만 빌리는지, S-EL1 early assembly context를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.

637(빈 줄)

int ret;까지의 동작과 if (fdt_path_offset(dt->blob, "/firmware/optee") >= 0) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

638if (fdt_path_offset(dt->blob, "/firmware/optee") >= 0) {

fdt_path_offset(dt->blob, "/firmware/optee") >= 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

639DMSG("OP-TEE Device Tree node already exists!");

DMSG("OP-TEE Device Tree node already exists!")를 호출한다. 반환 결과는 현재 줄 또는 다음 return 0;에서 검사되는 흐름이다. pointer 인자는 _start / boot arguments / early stack의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 identity map/vector 항목과 대조한다.

640return 0;

0를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 _start / boot arguments / early stack를 정리하거나 다음 단계로 진행하는지 확인한다.

641}

현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.

642(빈 줄)

}까지의 동작과 offs = fdt_path_offset(dt->blob, "/firmware");에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 identity map/vector 상태가 아래 블록의 입력으로 사용되는 경계다.

643offs = fdt_path_offset(dt->blob, "/firmware");

offsfdt_path_offset(dt->blob, "/firmware")를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 if (offs < 0) {가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

644if (offs < 0) {

offs < 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

645offs = add_dt_path_subnode(dt, "/", "firmware");

offsadd_dt_path_subnode(dt, "/", "firmware")를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 if (offs < 0)가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.

646if (offs < 0)

offs < 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 'C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.

내부 동작을 더 깊게 읽기

01

진입 조건을 먼저 고정한다

BL31 ERET에서 들어온 실행은 S-EL1 early assembly context에 놓여 있다. 이때 interrupt, MMU/cache, stack, heap 중 무엇이 이미 준비되었는지 소스의 호출자까지 올라가 확인한다. 같은 함수라도 SPL, relocation 전후, app thread처럼 호출 문맥이 달라지면 허용되는 API와 지연 시간이 달라진다.

TF-A가 넘긴 x0-x3, 현재 EL, MMU/cache 상태와 load address를 첫 명령부터 추적한다. pageable image를 복사하는 구간과 아직 참조할 수 없는 전역도 구분한다.

02

중심 객체의 생성과 공개를 나눈다

이 글의 중심 객체는 _start / boot arguments / early stack다. 메모리를 확보한 시점, 필드를 채운 시점, 전역 list나 다른 subsystem에 공개한 시점을 구분한다. 공개 뒤 오류가 발생한다면 목록에서 제거하고 child, buffer, reference를 역순으로 정리하는지 확인한다.

빌드 산출물 관점에서는 최종 부트로더 이미지 안에 해당 symbol과 section이 실제로 포함되었는지도 map과 objdump로 검증한다.

03

주소, 크기와 정렬을 계산한다

부트 코드의 오류는 논리보다 주소 계산에서 먼저 드러나는 경우가 많다. source range, destination range, header가 말하는 payload size, block 또는 page 단위를 표로 적고 각 구간의 끝 주소를 직접 계산한다. 끝 주소는 start + size - 1인지 exclusive end인지 API 계약을 확인한다.

C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다.

04

성공 flag와 실제 완료 시점을 맞춘다

_start → boot args preserve → relocate/BSS → MMU enable 구간에서는 부분 초기화 상태가 생길 수 있다. flag, list insertion, callback 등록, storage write 완료 중 무엇이 성공의 기준인지 찾는다. hardware write나 DMA가 포함되면 함수 반환과 장치 완료가 같은 시점인지도 확인한다.

다른 CPU, interrupt handler, USB completion 또는 shell command가 상태를 관찰할 수 있다면 memory ordering과 lock 범위도 함께 읽는다.

05

마지막 handoff의 계약을 적는다

정상 경로는 C init에서 끝난다. 이 단계가 함수 반환인지, scheduler 전환인지, 다른 image로의 비복귀 분기인지 구분한다. 비복귀 handoff라면 cache clean/invalidate, interrupt disable, 장치 quiesce, argument register와 FDT 또는 image address가 최종 점검 항목이다.

반환하는 경로라면 caller가 오류와 부분 성공을 구분하고 다음 후보 또는 복구 경로를 선택하는지 확인한다.

구현을 읽을 때 놓치기 쉬운 부분

01

BL31 ERET에서 C init까지 제어권이 이동하는 조건

BL31의 secure ERET가 OP-TEE _start로 들어온 뒤 relocation, BSS, MMU와 primary/secondary 경로를 준비하는 assembly를 읽습니다. 이 경로는 함수 호출 목록만 외워서는 연결되지 않는다. BL31 ERET → _start → boot args preserve → relocate/BSS → MMU enable → C init 순서에서 각 단계가 읽는 입력, 새로 확정하는 상태, 다음 단계에 넘기는 값을 구분해야 한다. 특히 S-EL1 early assembly context에서는 이전 단계가 남긴 register와 memory attribute가 C 코드의 전제 조건이 된다.

TF-A가 넘긴 x0-x3, 현재 EL, MMU/cache 상태와 load address를 첫 명령부터 추적한다. pageable image를 복사하는 구간과 아직 참조할 수 없는 전역도 구분한다. 따라서 첫 지점에서 _start / boot arguments / early stack의 주소와 owner를 기록하고, 마지막 지점에서 같은 값이 그대로 유지되는지 아니면 새 객체로 교체되는지를 확인한다. 중간 함수가 성공을 반환해도 C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다.

02

secure load address와 identity map/vector의 생성 시점과 수명

이 글에서 함께 나타나는 객체는 secure load address, boot arguments, init stack, identity map/vector이다. 이름이 비슷해도 저장 위치와 수명은 다르다. build-time descriptor인지, boot 단계의 임시 객체인지, world switch 뒤에도 남는 runtime 객체인지 나눠야 pointer를 따라가다 다른 단계의 구조체를 같은 것으로 오해하지 않는다.

_start / boot arguments / early stack을 기준으로 allocation 또는 정적 배치 위치, list/table에 공개되는 시점, 참조가 끊기는 시점을 적는다. 그 다음 source와 destination 범위, per-CPU 여부, secure/non-secure 접근 권한을 map과 runtime log로 대조한다. 이 절차를 거치면 단순한 호출 순서가 아니라 실제 소유권 이동이 보인다.

03

성공 로그만으로 놓치기 쉬운 실패 경계

대표적인 실패 조건은 잘못된 load address: relocation self-overlap; BSS 범위 오류: boot arg 손상; CurrentEL 불일치: system register trap이다. 이 문제들은 대개 fault가 발생한 함수보다 앞에서 만들어진 잘못된 주소, size, security state 또는 refcount 때문에 생긴다. 마지막 출력만 보지 말고 각 경계 직전의 상태를 한 줄씩 남겨 최초 불일치 지점을 찾는다.

재현에는 _start에서 x0-x3/SP/CurrentEL 기록; tee.elf symbol과 runtime PC 대조; pager on/off entry 경로 비교를 사용한다. 정상 경로와 실패 경로에서 같은 필드를 같은 위치에 출력하고, 실패가 검증 단계에서 차단되는지 아니면 다음 context까지 전파되는지 비교한다. firmware와 secure world에서는 실패 뒤의 cleanup 또는 reset 경로도 정상 경로만큼 중요하다.

레지스터에서 오류 판정까지 상세 분석

AArch64 _start는 TF-A가 넘긴 x0-x3를 보존하면서 OP-TEE가 C 코드를 실행할 수 있는 최소 상태를 만드는 구간이다. reset vector와 달리 S-EL1에서 시작하며, BL31이 설치한 SPSR/SCR와 secure physical load address를 전제로 VBAR_EL1, 임시 stack, BSS, relocation, MMU 상태를 순서대로 다룬다.

CFG_WITH_PAGER나 ASLR이 켜지면 link address와 실제 load address가 다를 수 있고 init/embedded data를 겹치지 않게 뒤에서 앞으로 복사하는 코드가 나타난다. 각 memcpy 방향과 source/destination end를 실제 linker symbol로 계산해야 self-overwrite 여부를 판단할 수 있다.

그림 5. 이 경로를 통과하는 다섯 개의 진입 계약
01CurrentEL

S-EL1 AArch64 실행을 가리켜야 한다.

02x0-x3

pageable address 또는 boot info 등 build mode가 기대하는 인자를 담는다.

03PC/load PA

_start 실제 byte가 놓인 secure executable 주소여야 한다.

04SCTLR_EL1

cache/MMU/alignment bit를 OP-TEE 초기화 순서에 맞춰 설정한다.

05temporary SP

현재 core에 대응하고 init/embedded data 복사 범위와 겹치지 않아야 한다.

각 계약은 앞 단계가 생산하고 현재 단계가 검증한 뒤 다음 소비자에게 넘기는 상태다. 한 항목이라도 확인되지 않으면 뒤 단계의 fault를 그 지점의 문제로 단정하지 않는다.

진입 레지스터와 메모리 계약

함수 첫 줄에 도달했을 때 이미 참이라고 가정하는 값과, 그 값이 틀렸을 때 영향을 받는 범위를 함께 적었다.

#입력 상태생산자정상 조건확인 이유
01CurrentELBL31 BL32 ep_infoS-EL1 AArch64 실행을 가리켜야 한다.SCTLR_EL1, VBAR_EL1, TTBR 접근의 전제다.
02x0-x3TF-A/platform BL32 ABIpageable address 또는 boot info 등 build mode가 기대하는 인자를 담는다.x19-x22에 보존되어 boot_init_primary에 다시 전달된다.
03PC/load PAFIP loader와 ep_info.pc_start 실제 byte가 놓인 secure executable 주소여야 한다.relocation offset과 core_mmu_tee_load_pa의 기준이다.
04SCTLR_EL1BL31/entry codecache/MMU/alignment bit를 OP-TEE 초기화 순서에 맞춰 설정한다.BSS/relocation과 page-table 전환의 memory semantics를 결정한다.
05temporary SPentry assembly/linker현재 core에 대응하고 init/embedded data 복사 범위와 겹치지 않아야 한다.C runtime 전 assembly 호출과 boot thread가 사용한다.

핵심 구조체 필드의 생산자, 소비자와 수명

구조체 이름만 나열하지 않고 어떤 코드가 값을 쓰고, 어느 코드가 처음 읽으며, 언제까지 주소와 내용이 유지되어야 하는지 구분했다.

#객체 또는 필드생산자소비자수명과 불변 조건
01x19-x22 saved boot args_startboot_init_primaryearly assembly 전체에서 callee-saved register로 유지된다.
02reset_vect_table/VBAR_EL1_startearly exception정식 vector 전에도 abort를 포착할 수 있도록 먼저 설치된다.
03__init_start/__init_endlinkerearly copy/executerelocation과 init 완료 뒤 pageable/runtime 영역과 수명이 달라진다.
04__bss_start/__bss_endlinkerzeroing loop와 C globalsC code 진입 전에 정확히 zero여야 하며 boot arg storage를 덮지 않는다.
05boot_embdata_ptrearly relocationMMU/pager/initembedded metadata 이동 뒤 새 주소를 가리키며 old range를 참조하면 안 된다.
06thread_core_local/tmp stackentry assemblythread/exception codeprimary core가 정식 per-CPU structure를 만들 때까지 임시 owner다.

함수 내부 실행 순서

소스의 큰 분기와 side effect를 실행 순서대로 다시 펼쳤다. breakpoint는 이 목록의 경계에 두고, 다음 번호로 넘어갈 때 새로 유효해진 객체를 기록한다.

  1. 01

    _start가 x0-x3를 x19-x22에 보존해 relocation과 register setup 중 유실되지 않게 한다.

  2. 02

    초기 exception을 잡을 reset vector를 VBAR_EL1에 설치하고 SCTLR_EL1 정책을 정규화한다.

  3. 03

    pager/ASLR 구성에 따라 init와 embedded data의 source/destination/length를 계산한다.

  4. 04

    겹침 방향을 고려해 뒤에서 앞으로 copy하고 새 boot_embdata_ptr와 cached memory end를 기록한다.

  5. 05

    BSS와 nex BSS 중 zero 대상만 지우며 nozi/stack/canary 같은 보존 영역을 구분한다.

  6. 06

    실제 _start load PA와 compiled TEE_LOAD_ADDR 차이로 relocation offset을 계산·적용한다.

  7. 07

    primary thread_core_local, temporary/abort stack과 current thread invalid state를 초기화한다.

  8. 08

    MMU table 생성에 필요한 load/virtual layout을 넘기고 cache maintenance와 barrier 뒤 translation을 전환한다.

  9. 09

    보존한 x0-x3를 복원해 boot_init_primary 또는 C primary init 경로로 진입한다.

빌드 설정이 바꾸는 실제 코드 경로

동일한 함수 이름이라도 아래 설정에 따라 포함되는 source, 구조체 크기, 인자 의미와 failure path가 달라진다.

#설정바뀌는 동작확인 방법
01CFG_WITH_PAGERinit resident copy와 pageable backing 인자 처리가 추가된다.x0 의미와 __pageable_part_* symbol을 대조한다.
02CFG_CORE_ASLRload address와 runtime mapping offset을 사용한다.core_mmu_tee_load_pa와 runtime PC 차이를 기록한다.
03CFG_MEMTAG/BTI/PAUTHSCTLR/TCR와 key 초기화 명령이 entry에 추가된다.CPU feature detect와 enable register를 확인한다.
04CFG_CORE_NB_COREtemporary stack/core-local 배치 수를 결정한다.MPIDR linear index가 배열 범위 안인지 본다.

증상에서 최초 불일치 지점까지 추적하기

마지막 panic 메시지가 아니라 어디에서 멈추고 무엇을 읽어 어떤 결론을 내릴지 정리했다. 정상값과 실패값은 같은 build와 같은 위치에서 비교한다.

#관찰 증상중단 위치기록할 값판정
01_start 200줄 이전 data abortcopy loopsrc/dst/end, load PA, linker symbolinit/embedded data self-overlap 또는 잘못된 segment size를 찾는다.
02C 진입 시 global이 임의 값BSS zero loopBSS start/end와 boot argument storage잘못된 linker boundary 또는 zero 누락을 확인한다.
03MMU enable 직후 instruction aborttranslation enable 전후TTBR/TCR/MAIR/SCTLR, PC VA/PArelocation과 mapping의 runtime VA 불일치를 판정한다.
04secondary core가 primary stack을 사용core index와 stack calculationMPIDR, core_pos, SP, thread_core_localplatform core mapping 또는 temporary stack stride 오류를 찾는다.

객체와 수명

대상만들어지는 시점유효 범위확인할 조건
_start / boot arguments / early stack_startC init 또는 오류 정리 완료까지C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다.
입력 buffer / metadataBL31 ERETparse와 검증이 끝날 때까지길이, 정렬, 소유권, 변조 가능성
등록된 list / descriptorboot args preservesubsystem 종료 또는 image handoff까지이중 등록, dangling pointer, 오류 unwind
hardware 또는 persistent state실제 write/probe가 완료된 뒤reset 또는 명시적 해제·갱신까지flush, timeout, 전원 차단, rollback
최종 부트로더 이미지link/image 생성 시점다음 stage가 새 image로 교체할 때까지load address, entry, section과 header 일치

실패 지점과 증상

#조건관찰되는 증상먼저 볼 단계
01잘못된 load addressrelocation self-overlap_start
02BSS 범위 오류boot arg 손상boot args preserve
03CurrentEL 불일치system register traprelocate/BSS

로그가 끊긴 마지막 함수만 고치지 않는다. 그 함수가 받은 주소, size, flag가 만들어진 앞 단계까지 올라가고, 오류 뒤 등록 객체와 hardware 상태가 남았는지도 확인한다.

소스 밖에서 확인할 증거

소스 해석은 실제 빌드 산출물과 target 로그로 닫아야 한다. 아래 명령의 보드 이름과 toolchain prefix는 사용 중인 빌드 환경에 맞게 바꾼다.

#목적명령 또는 계측판정 기준
01빌드 산출물make PLATFORM=<platform> CFG_TEE_CORE_LOG_LEVEL=4tee.elf, tee.bin과 pageable/pager 구성이 같은 설정에서 생성됐는지 확인한다.
02ELF 배치${CROSS_COMPILE64}readelf -W -lS out/arm/core/tee.elfsecure RAM 안에서 text, data, pager, pageable 구간이 어떤 주소와 권한으로 배치되는지 확인한다.
03심볼과 주소${CROSS_COMPILE64}nm -n out/arm/core/tee.elf | grep 'FUNC _start ,'entry, thread, TA manager 함수의 링크 주소를 원본 설명과 연결한다.
04명령과 예외 경로${CROSS_COMPILE64}objdump -drS out/arm/core/tee.elfSMC entry, world switch, abort 복귀가 실제 register save/restore와 어떻게 이어지는지 대조한다.
05Normal world 왕복xtest; dmesg | grep -i opteesecure console과 Linux OP-TEE driver 로그를 함께 보고 SMC, RPC, shared memory 왕복의 양쪽 증거를 맞춘다.

직접 확인할 실험

  1. 01
    _start에서 x0-x3/SP/CurrentEL 기록

    _start 진입 전후에 secure load address의 주소·크기·반환값과 timestamp를 함께 남긴다. 결과는 정상 부팅 여부로 끝내지 말고 C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다. 조건이 처음 깨지는 줄을 기록한다.

  2. 02
    tee.elf symbol과 runtime PC 대조

    boot args preserve 진입 전후에 boot arguments의 주소·크기·반환값과 timestamp를 함께 남긴다. 결과는 정상 부팅 여부로 끝내지 말고 C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다. 조건이 처음 깨지는 줄을 기록한다.

  3. 03
    pager on/off entry 경로 비교

    relocate/BSS 진입 전후에 init stack의 주소·크기·반환값과 timestamp를 함께 남긴다. 결과는 정상 부팅 여부로 끝내지 말고 C 함수 진입 전 stack, BSS, relocation destination과 vector base가 유효하고 TF-A가 넘긴 pageable/FDT 인자가 보존되어야 한다. 조건이 처음 깨지는 줄을 기록한다.

원문과 다음 글