OP-TEE OS · source analysis

Abort 분류와 pager fault 복구

OP-TEE 4.10.0의 abort 분류와 pager 후보, user TA 오류, core panic의 조건부 경계를 읽습니다.

OP-TEE OS 4.10.0은 이 글의 코드 분석 기준입니다. 제품 적용에는 공식 OP-TEE 릴리스와 플랫폼 보안 공지를 확인하세요.

Series
12 / 12
Baseline
4.10.0
Commit
753afbbee168
Source
core/arch/arm/kernel/abort.c:530-602 (발췌 범위)

abort가 pager로 들어가는 경우는?

abort_handler()는 register frame에서 abort_info를 만들고 get_fault_type()로 분류한다. debug/기타 무시, user TA panic, 외부 abort, 선택적 VFP 처리, pageable 후보는 서로 다른 출구다. pageable로 분류되어도 region·권한·backing이 처리 가능한지 아직 모른다.

pager 후보는 thread context 확인 뒤 tee_pager_handle_fault()에 들어간다. 성공하면 faulting instruction으로 돌아가고, 미처리이면 user exception은 TA panic 경로, core exception은 core panic 경로다. CFG_WITH_PAGER=n의 stub는 false를 반환한다. MMU·pager 구성 글은 그 region과 backing이 언제 준비되는지 다룬다.

exception frame과 지역 abort_info

그림 1. register frame에서 abort_info로 전달되는 값

그림을 가로로 밀어 전체 흐름 보기 ↔

VECTORthread_abort_regssaved PC/SP/PSTATEexception frameDECODEset_abort_infotype/descr/VAregs pointerSCOPEabort_info aihandler 지역 값분류 중 유효abort_info는 지역 값이다. 모든 fault가 TA session 객체를 만드는 것은 아니다.

set_abort_info()가 frame의 ESR/FAR 등과 regs 포인터를 묶는다. TA 상태 저장은 user panic 분기에서만 따로 일어난다.

fault type은 단일 panic 호출열이 아니다

그림 2. get_fault_type의 조건부 출구

그림을 가로로 밀어 전체 흐름 보기 ↔

ENTRYabort_infoESR/FAR · regsCLASSIFYget_fault_typeorigin · statusIGNOREdebug/otherreturnUSERTA panicVFP는 별도EXTERNALplatform hook?설정 의존PAGEABLEpager 후보thread 검사VFPlazy stateCFG_WITH_VFPPAGEABLE 분류도 복구 성공을 뜻하지 않는다. VFP·external·ignore는 별도 출구다.

CORE_MMU_FAULT_TRANSLATION·read/write permission은 pageable 후보로 분류된다. external abort의 platform hook과 VFP 처리는 빌드 설정에 좌우된다.

분류 결과와 다음 처리자

분류/조건handler 동작끝점
FAULT_TYPE_IGNOREdebug event 또는 기타로 분류handler에서 복귀
USER_MODE_PANICabort 정보를 TSD에 저장, VFP 비활성화handle_user_mode_panic()
EXTERNAL_ABORT설정 시 platform handler 호출일반 pager 호출과 구별
USER_MODE_VFPCFG_WITH_VFP에서 VFP state 처리pager miss가 아님
PAGEABLE 또는 defaultthread 확인 후 pager 호출true면 복귀; false면 user TA/core panic 분기

translation/permission으로 분류되었다고 page를 반드시 적재하는 것은 아니다. hidden page, 권한 갱신, 미등록 VA가 갈린다.

pager 후보와 최종 오류 범위

pager 후보에서 thread 검사와 pager 반환값을 구분하고, 미처리된 user/core exception의 종료 범위를 나눈다.

그림 3. thread 검사·pager 결과·fault origin

그림을 가로로 밀어 전체 흐름 보기 ↔

PAGEABLEhandler 분기thread context 검사PAGERhandle_faultCFG_WITH_PAGER?TRUEexception 복귀명령 재시도FALSE미처리user/core 판정USERTA panicabort_info 저장COREcore panicunhandledthread가 없으면 pager 호출 전에 panic. no-pager stub는 false를 반환한다.

thread_get_id_may_fail()가 실패하면 pager 호출 전에 panic한다. pager 함수가 false여도 user fault와 core fault가 같은 오류 처리로 합쳐지지 않는다.

그림 4. 처리 성공과 미처리 user/core의 분기

그림을 가로로 밀어 전체 흐름 보기 ↔

PAGERhandled 결과true/falseTRUE명령 재시도mapping/permissionFALSEfault originuser 또는 coreUSERTA panic상태 저장COREcore panic미복구 faultuser와 core는 대안이다. false 뒤 두 종료 경로를 순서대로 실행하지 않는다.

handled=true는 원래 instruction을 재시도할 준비가 된 경로다. pager 내부의 backing 적재 실패가 항상 false 반환인 것은 아니다.

원본 코드

아래 코드는 OP-TEE OS 4.10.0의 core/arch/arm/kernel/abort.c에서 530-602줄을 그대로 가져온 것이다.

commit753afbbee1682f5d16fd30e87b31058a4fd4f4b8anchor · L554void abort_handler(uint32_t abort_type, struct thread_abort_regs *regs)
530	case CORE_MMU_FAULT_ASYNC_EXTERNAL:
531	case CORE_MMU_FAULT_SYNC_EXTERNAL:
532		if (!abort_is_user_exception(ai))
533			abort_print(ai);
534		DMSG("[abort]%s", fault_to_str(ai->abort_type,
535					       ai->fault_descr));
536		return FAULT_TYPE_EXTERNAL_ABORT;
537
538	case CORE_MMU_FAULT_TAG_CHECK:
539		if (abort_is_user_exception(ai))
540			return FAULT_TYPE_USER_MODE_PANIC;
541		abort_print_error(ai);
542		panic("[abort] Tag check fault! (trap CPU)");
543		break;
544
545	case CORE_MMU_FAULT_OTHER:
546	default:
547		if (!abort_is_user_exception(ai))
548			abort_print(ai);
549		DMSG("[abort] Unhandled fault!");
550		return FAULT_TYPE_IGNORE;
551	}
552}
553
554void abort_handler(uint32_t abort_type, struct thread_abort_regs *regs)
555{
556	struct abort_info ai;
557	bool handled;
558
559	set_abort_info(abort_type, regs, &ai);
560
561	switch (get_fault_type(&ai)) {
562	case FAULT_TYPE_IGNORE:
563		break;
564	case FAULT_TYPE_USER_MODE_PANIC:
565		DMSG("[abort] abort in User mode (TA will panic)");
566		save_abort_info_in_tsd(&ai);
567		vfp_disable();
568		handle_user_mode_panic(&ai);
569		break;
570	case FAULT_TYPE_EXTERNAL_ABORT:
571#ifdef CFG_EXTERNAL_ABORT_PLAT_HANDLER
572		/* Allow platform-specific handling */
573		plat_external_abort_handler(&ai);
574#endif
575		break;
576#ifdef CFG_WITH_VFP
577	case FAULT_TYPE_USER_MODE_VFP:
578		handle_user_mode_vfp();
579		break;
580#endif
581	case FAULT_TYPE_PAGEABLE:
582	default:
583		if (thread_get_id_may_fail() < 0) {
584			abort_print_error(&ai);
585			panic("abort outside thread context");
586		}
587		thread_kernel_save_vfp();
588		handled = tee_pager_handle_fault(&ai);
589		thread_kernel_restore_vfp();
590		if (!handled) {
591			if (!abort_is_user_exception(&ai)) {
592				abort_print_error(&ai);
593				panic("unhandled pageable abort");
594			}
595			DMSG("[abort] abort in User mode (TA will panic)");
596			save_abort_info_in_tsd(&ai);
597			vfp_disable();
598			handle_user_mode_panic(&ai);
599		}
600		break;
601	}
602}

대표 코드가 시작·끝나는 위치

대표 발췌 abort.c L530–602는 get_fault_type()의 switch 끝부터 시작한다. abort_handler() 정의는 L554다. 아래 관련 원문에는 abort_print() L241과 set_abort_info() L287이 들어 있다. 이 발췌를 하나의 함수 본문으로 읽지 않는다.

함께 읽어야 하는 원본 코드

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

01. 복구하지 못한 abort의 register와 call stack 출력

core/arch/arm/kernel/abort.c 231-313줄이다.

filecore/arch/arm/kernel/abort.canchor · L241void abort_print(struct abort_info *ai)
231	__print_abort_info(ai, "Core");
232
233	if (stack_dump) {
234		trace_printf_helper_raw(TRACE_ERROR, true,
235					"TEE load address @ %#"PRIxVA,
236					VCORE_START_VA);
237		__print_stack_unwind(ai);
238	}
239}
240
241void abort_print(struct abort_info *ai)
242{
243	__abort_print(ai, false);
244}
245
246void abort_print_error(struct abort_info *ai)
247{
248	__abort_print(ai, true);
249}
250
251/* This function must be called from a normal thread */
252void abort_print_current_ts(void)
253{
254	struct thread_specific_data *tsd = thread_get_tsd();
255	struct abort_info ai = { };
256	struct ts_session *s = ts_get_current_session();
257
258	ai.abort_type = tsd->abort_type;
259	ai.fault_descr = tsd->abort_descr;
260	ai.va = tsd->abort_va;
261	ai.pc = tsd->abort_regs.elr;
262	ai.regs = &tsd->abort_regs;
263
264	if (ai.abort_type != ABORT_TYPE_USER_MODE_PANIC)
265		__print_abort_info(&ai, "User mode");
266
267	s->ctx->ops->dump_state(s->ctx);
268
269#if defined(CFG_FTRACE_SUPPORT)
270	if (s->ctx->ops->dump_ftrace)
271		s->ctx->ops->dump_ftrace(s->ctx);
272#endif
273}
274
275static void save_abort_info_in_tsd(struct abort_info *ai)
276{
277	struct thread_specific_data *tsd = thread_get_tsd();
278
279	tsd->abort_type = ai->abort_type;
280	tsd->abort_descr = ai->fault_descr;
281	tsd->abort_va = ai->va;
282	tsd->abort_regs = *ai->regs;
283	tsd->abort_core = get_core_pos();
284}
285
286#ifdef ARM32
287static void set_abort_info(uint32_t abort_type, struct thread_abort_regs *regs,
288		struct abort_info *ai)
289{
290	switch (abort_type) {
291	case ABORT_TYPE_DATA:
292		ai->fault_descr = read_dfsr();
293		ai->va = read_dfar();
294		break;
295	case ABORT_TYPE_PREFETCH:
296		ai->fault_descr = read_ifsr();
297		ai->va = read_ifar();
298		break;
299	default:
300		ai->fault_descr = 0;
301		ai->va = regs->elr;
302		break;
303	}
304	ai->abort_type = abort_type;
305	ai->pc = regs->elr;
306	ai->regs = regs;
307}
308#endif /*ARM32*/
309
310#ifdef ARM64
311static void set_abort_info(uint32_t abort_type __unused,
312		struct thread_abort_regs *regs, struct abort_info *ai)
313{

02. ESR, FAR와 register frame으로 abort_info 구성

core/arch/arm/kernel/abort.c 277-359줄이다.

filecore/arch/arm/kernel/abort.canchor · L287static void set_abort_info(uint32_t abort_type
277	struct thread_specific_data *tsd = thread_get_tsd();
278
279	tsd->abort_type = ai->abort_type;
280	tsd->abort_descr = ai->fault_descr;
281	tsd->abort_va = ai->va;
282	tsd->abort_regs = *ai->regs;
283	tsd->abort_core = get_core_pos();
284}
285
286#ifdef ARM32
287static void set_abort_info(uint32_t abort_type, struct thread_abort_regs *regs,
288		struct abort_info *ai)
289{
290	switch (abort_type) {
291	case ABORT_TYPE_DATA:
292		ai->fault_descr = read_dfsr();
293		ai->va = read_dfar();
294		break;
295	case ABORT_TYPE_PREFETCH:
296		ai->fault_descr = read_ifsr();
297		ai->va = read_ifar();
298		break;
299	default:
300		ai->fault_descr = 0;
301		ai->va = regs->elr;
302		break;
303	}
304	ai->abort_type = abort_type;
305	ai->pc = regs->elr;
306	ai->regs = regs;
307}
308#endif /*ARM32*/
309
310#ifdef ARM64
311static void set_abort_info(uint32_t abort_type __unused,
312		struct thread_abort_regs *regs, struct abort_info *ai)
313{
314	ai->fault_descr = read_esr_el1();
315	switch ((ai->fault_descr >> ESR_EC_SHIFT) & ESR_EC_MASK) {
316	case ESR_EC_IABT_EL0:
317	case ESR_EC_IABT_EL1:
318		ai->abort_type = ABORT_TYPE_PREFETCH;
319		ai->va = read_far_el1();
320		break;
321	case ESR_EC_DABT_EL0:
322	case ESR_EC_DABT_EL1:
323	case ESR_EC_SP_ALIGN:
324		ai->abort_type = ABORT_TYPE_DATA;
325		ai->va = read_far_el1();
326		break;
327	default:
328		ai->abort_type = ABORT_TYPE_UNDEF;
329		ai->va = regs->elr;
330	}
331	ai->pc = regs->elr;
332	ai->regs = regs;
333}
334#endif /*ARM64*/
335
336#ifdef ARM32
337static void handle_user_mode_panic(struct abort_info *ai)
338{
339	/*
340	 * It was a user exception, stop user execution and return
341	 * to TEE Core.
342	 */
343	ai->regs->r0 = TEE_ERROR_TARGET_DEAD;
344	ai->regs->r1 = true;
345	ai->regs->r2 = 0xdeadbeef;
346	ai->regs->elr = (uint32_t)thread_unwind_user_mode;
347	ai->regs->spsr &= CPSR_FIA;
348	ai->regs->spsr &= ~CPSR_MODE_MASK;
349	ai->regs->spsr |= CPSR_MODE_SVC;
350	/* Select Thumb or ARM mode */
351	if (ai->regs->elr & 1)
352		ai->regs->spsr |= CPSR_T;
353	else
354		ai->regs->spsr &= ~CPSR_T;
355}
356#endif /*ARM32*/
357
358#ifdef ARM64
359static void handle_user_mode_panic(struct abort_info *ai)

분류·처리 경계를 순서대로 보기

01

fault type 분류

user exception은 VFP 여부를 먼저 본다. pager 없는 빌드에서는 일반 user fault가 곧 user panic으로 분류될 수 있다. alignment·access-bit·undefined 등은 별도 정책이다.

02

pageable 후보

translation 및 read/write permission fault는 후보로 분류한다. thread가 없으면 panic하고, 있으면 kernel VFP state 저장·복원 사이에 pager 함수를 호출한다.

03

pager 미처리

handled=false에서 core fault는 unhandled pageable abort panic, user fault는 abort 정보 저장 후 TA panic 경로다.

pager 안에서도 네 가지 결과

01

region 없음

tee_pager_handle_fault()가 core/UTA region과 page table을 찾지 못하면 false를 반환한다.

02

hidden·permission

hidden pmem은 다시 보이게 할 수 있다. 이미 매핑된 page는 접근 권한을 검사하거나 dirty 처리를 할 수 있다. 둘 다 새 page 적재는 아니다.

03

새 page

pager_get_page()가 pmem을 확보하고 alias로 backing을 로드한 뒤 최종 mapping을 공개한다. backing 오류나 pmem 고갈은 panic할 수도 있다.

빌드 설정과 fault origin의 교차

설정/조건고정 소스판정
CFG_WITH_PAGER=n + user faultabort.c L484–489VFP가 아니면 user panic 분류; page 적재 없음
CFG_WITH_PAGER=n + core translationtee_pager.h L268–275 stub falsehandler의 core 미처리 panic 경로
CFG_WITH_VFP + user VFPabort.c L576–580VFP 처리 후 복귀 가능; pager와 별도
CFG_EXTERNAL_ABORT_PLAT_HANDLERabort.c L570–575설정 시 platform callback; 무조건 core panic 아님
PAGEABLE + no threadabort.c L583–586pager 호출 전에 panic
pager false + user/coreabort.c L590–599TA panic과 core panic 범위를 분리

frame·abort_info·TA 상태를 분리

객체생산/참조수명·조건
thread_abort_regsexception entry가 만든 register frameexception 복귀 또는 fatal 처리까지
abort_info aihandler의 지역 값, set_abort_info()로 채움한 handler 호출 동안 유효
vm_paged_regionpager가 fault VA로 lookup등록된 영역에서만 page owner 확인
tee_pager_pmempager physical page의 alias/dirty/hidden 상태모든 abort에 존재하지 않음
TSD abort 정보user panic 분기에서 저장TA 오류 보고에 사용; core fault에 자동 생성 아님

복구 불가능한 지점

조건행동혼동하지 않을 것
user mode alignment/access-bit 등USER_MODE_PANIC일반 page miss와 다름
abort 재진입get_fault_type()가 panicpager 재시도가 아님
PAGEABLE인데 thread 없음abort_handler()가 panicpager handle 호출 전
region/권한 미처리pager false → origin별 TA/core 처리모두 core panic 아님
backing load/pmem 고갈pager 내부 panic 가능항상 handler의 false 분기까지 돌아오지 않음

읽기 전용으로 경계를 확인

동일한 4.10.0 빌드의 secure console, ELF, 빌드 설정을 대조한다. nm에는 C 선언이 아닌 심볼 이름이 나온다. 로그에는 secure 주소가 포함될 수 있으므로 공유 범위를 검토한다.

목적읽기 전용 예한계
심볼nm -an out/arm/core/tee.elf | grep -E " (abort_handler|set_abort_info|tee_pager_handle_fault)$"심볼 존재와 링크 주소만 확인
sectionreadelf -W -lS out/arm/core/tee.elf실제 fault 분류 결과는 보이지 않음
secure consoleabort type/VA, user/core, pager handled 결과로그 수준·보안 정책에 따라 내용 제한
빌드 설정CFG_WITH_PAGER, CFG_WITH_VFP, external handler설정별 분기를 별도로 해석

테스트 빌드에서 비교할 경로

  1. 01
    VFP와 pageable

    user VFP trap과 등록된 pager VA fault를 다른 분류 결과로 기록한다.

  2. 02
    미등록 VA

    pager false 후 user TA 처리와 core 처리의 경계를 테스트 환경에서 비교한다.

  3. 03
    pager on/off

    같은 fault 유형에서 CFG_WITH_PAGER 분류와 stub 결과 차이를 소스·로그로 대조한다.

원문과 다음 글