QUESTION
BL2 image descriptor와 순차 적재 단계에서 실제로 바뀌는 상태는 무엇인가?
BL2는 단순 복사기가 아니다. parent certificate, image ID, load region, executable 여부와 다음 image parameter list를 한꺼번에 관리한다.
각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.
STRUCTURE
객체와 주소가 놓이는 구조
각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다.
bl_mem_params_node_t / bl_params_t를 중심에 놓고 왼쪽의 입력이 어떤 검사를 거쳐 오른쪽 결과로 공개되는지 표시했다. 실제 디버깅에서는 각 블록의 주소와 크기를 로그에 대입한다.
CALL PATH
실행 흐름
화살표는 단순 호출 순서만 뜻하지 않는다. 각 단계가 성공을 반환할 때 다음 단계가 읽을 수 있는 상태가 무엇인지 함께 확인한다. 오류 반환이 발생하면 바로 다음 화살표로 진행하지 않고 해당 단계의 정리 경로를 따라간다.
STATE LEDGER
단계별 입력과 출력
호출 순서를 함수 이름으로만 외우지 않고, 각 단계가 무엇을 받아 무엇을 공개하는지 적은 표다. 실제 소스에서 생산 필드가 다르면 표를 고치는 방식으로 사용한다.
| # | 단계 | 진입 시 신뢰할 상태 | 성공 뒤 남아야 할 상태 | 다음 소비자 |
|---|---|---|---|---|
| 01 | BL1 handoff | BL2 trusted boot stage | bl_mem_params_node_t | BL2 platform setup |
| 02 | BL2 platform setup | BL1 handoff 완료 상태 | image_info_t | image descriptor walk |
| 03 | image descriptor walk | BL2 platform setup 완료 상태 | entry_point_info_t | load/auth images |
| 04 | load/auth images | image descriptor walk 완료 상태 | bl_params_t | BL31 params |
| 05 | BL31 params | load/auth images 완료 상태 | bl_params_t | 최종 최종 부트로더 이미지 또는 다음 stage |
공통 불변 조건: 각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다. 한 단계의 출력이 다음 단계의 입력 조건을 만족하지 않으면 오류가 실제로 드러난 위치보다 앞의 생산 단계부터 조사한다.
VISUAL WALKTHROUGH
주소와 객체의 이동을 그림으로 읽기
아래 그림은 호출 이름보다 주소, 객체 수명과 handoff 경계를 먼저 볼 수 있도록 구성했다. 실제 주소와 크기는 사용 중인 보드의 bdinfo, map과 linker symbol을 대입한다.
각 칸은 제어권이 다음 단계로 넘어가기 전에 확정되어야 하는 상태를 나타낸다.
왼쪽에서 만든 상태를 오른쪽 단계가 처음 사용하는 관계를 표시한다.
image_id→policy/UUID 선택→image_infoauth parent→certificate 검증→authenticated payloadload_info→destination bounds→loaded imageep_info→SPSR·security state→BL31 paramsUPSTREAM SOURCE
원본 코드
아래 코드는 Trusted Firmware-A LTS 2.14.3의 bl2/bl2_main.c에서 18-106줄을 그대로 가져온 것이다. 설명을 위해 실제 코드를 가짜 의사 코드로 바꾸지 않았다.
18#include <drivers/console.h>
19#include <drivers/fwu/fwu.h>
20#include <lib/bootmarker_capture.h>
21#include <lib/extensions/pauth.h>
22#include <lib/pmf/pmf.h>
23#include <plat/common/platform.h>
24
25#include "bl2_private.h"
26
27#ifdef __aarch64__
28#define NEXT_IMAGE "BL31"
29#else
30#define NEXT_IMAGE "BL32"
31#endif
32
33#if ENABLE_RUNTIME_INSTRUMENTATION
34 PMF_REGISTER_SERVICE(bl_svc, PMF_RT_INSTR_SVC_ID,
35 BL_TOTAL_IDS, PMF_DUMP_ENABLE);
36#endif
37
38/*******************************************************************************
39 * The only thing to do in BL2 is to load further images and pass control to
40 * next BL. The memory occupied by BL2 will be reclaimed by BL3x stages.
41 ******************************************************************************/
42void __no_pauth bl2_main(u_register_t arg0, u_register_t arg1, u_register_t arg2,
43 u_register_t arg3)
44{
45 entry_point_info_t *next_bl_ep_info;
46
47 /* Enable early console if EARLY_CONSOLE flag is enabled */
48 plat_setup_early_console();
49#if RESET_TO_BL2
50
51 /* Perform early platform-specific setup */
52 bl2_el3_early_platform_setup(arg0, arg1, arg2, arg3);
53
54 /* Perform late platform-specific setup */
55 bl2_el3_plat_arch_setup();
56#else /* RESET_TO_BL2 */
57 /* Perform early platform-specific setup */
58 bl2_early_platform_setup2(arg0, arg1, arg2, arg3);
59
60 /* Perform late platform-specific setup */
61 bl2_plat_arch_setup();
62#endif /* RESET_TO_BL2 */
63
64 if (is_feat_pauth_supported()) {
65#if BL2_RUNS_AT_EL3
66 pauth_init_enable_el3();
67#else
68 pauth_init_enable_el1();
69#endif
70 }
71
72#if ENABLE_RUNTIME_INSTRUMENTATION
73 PMF_CAPTURE_TIMESTAMP(bl_svc, BL2_ENTRY, PMF_CACHE_MAINT);
74#endif
75
76 NOTICE("BL2: %s\n", build_version_string);
77 NOTICE("BL2: %s\n", build_message);
78
79 /* Perform remaining generic architectural setup in S-EL1 */
80 bl2_arch_setup();
81
82#if PSA_FWU_SUPPORT
83 fwu_init();
84#endif /* PSA_FWU_SUPPORT */
85
86 crypto_mod_init();
87
88 /* Initialize authentication module */
89 auth_mod_init();
90
91 /* Initialize the Measured Boot backend */
92 bl2_plat_mboot_init();
93
94 /* Initialize boot source */
95 bl2_plat_preload_setup();
96
97 /* Load the subsequent bootloader images. */
98 next_bl_ep_info = bl2_load_images();
99
100 /* Teardown the Measured Boot backend */
101 bl2_plat_mboot_finish();
102
103 crypto_mod_finish();
104
105#if !BL2_RUNS_AT_EL3
106#ifndef __aarch64__
LINE BY LINE
18-106줄 해설
원본에 보이는 모든 줄을 순서대로 설명한다. 빈 줄도 block 경계로 남겨, 코드와 설명의 위치가 어긋나지 않게 했다.
#include <drivers/console.h>#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#include <drivers/fwu/fwu.h>#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#include <lib/bootmarker_capture.h>#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#include <lib/extensions/pauth.h>#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#include <lib/pmf/pmf.h>#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#include <plat/common/platform.h>#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#include <plat/common/platform.h>까지의 동작과 #include "bl2_private.h"에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#include "bl2_private.h"#include 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#include "bl2_private.h"까지의 동작과 #ifdef __aarch64__에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#ifdef __aarch64__#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#define NEXT_IMAGE "BL31"#define 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#else#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#define NEXT_IMAGE "BL32"#define 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#endif#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#endif까지의 동작과 #if ENABLE_RUNTIME_INSTRUMENTATION에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#if ENABLE_RUNTIME_INSTRUMENTATION#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
PMF_REGISTER_SERVICE(bl_svc, PMF_RT_INSTR_SVC_ID,PMF_REGISTER_SERVICE(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
BL_TOTAL_IDS, PMF_DUMP_ENABLE);원본 35번 줄의 BL_TOTAL_IDS, PMF_DUMP_ENABLE);는 앞의 PMF_REGISTER_SERVICE(bl_svc, PMF_RT_INSTR_SVC_ID, 결과를 받아 다음 #endif로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
#endif#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#endif까지의 동작과 /*******************************************************************************에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*******************************************************************************원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* The only thing to do in BL2 is to load further images and pass control to원본 주석이 'The only thing to do in BL2 is to load further images and pass control to'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* next BL. The memory occupied by BL2 will be reclaimed by BL3x stages.원본 주석이 'next BL. The memory occupied by BL2 will be reclaimed by BL3x stages.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
******************************************************************************/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
void __no_pauth bl2_main(u_register_t arg0, u_register_t arg1, u_register_t arg2,bl2_main(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
u_register_t arg3)원본 43번 줄의 u_register_t arg3)는 앞의 void __no_pauth bl2_main(u_register_t arg0, u_register_t arg1, u_register_t arg2, 결과를 받아 다음 {로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
{바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 bl_mem_params_node_t / bl_params_t의 수명에 맞춰 묶어 읽는다.
entry_point_info_t *next_bl_ep_info;원본 45번 줄의 entry_point_info_t *next_bl_ep_info;는 앞의 { 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
(빈 줄)entry_point_info_t *next_bl_ep_info;까지의 동작과 /* Enable early console if EARLY_CONSOLE flag is enabled */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Enable early console if EARLY_CONSOLE flag is enabled */원본 주석이 'Enable early console if EARLY_CONSOLE flag is enabled'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
plat_setup_early_console();plat_setup_early_console(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#if RESET_TO_BL2#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#if RESET_TO_BL2까지의 동작과 /* Perform early platform-specific setup */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Perform early platform-specific setup */원본 주석이 'Perform early platform-specific setup'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_el3_early_platform_setup(arg0, arg1, arg2, arg3);bl2_el3_early_platform_setup(arg0, arg1, arg2, arg3)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)bl2_el3_early_platform_setup(arg0, arg1, arg2, arg3);까지의 동작과 /* Perform late platform-specific setup */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Perform late platform-specific setup */원본 주석이 'Perform late platform-specific setup'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_el3_plat_arch_setup();bl2_el3_plat_arch_setup(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#else /* RESET_TO_BL2 */#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
/* Perform early platform-specific setup */원본 주석이 'Perform early platform-specific setup'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_early_platform_setup2(arg0, arg1, arg2, arg3);bl2_early_platform_setup2(arg0, arg1, arg2, arg3)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)bl2_early_platform_setup2(arg0, arg1, arg2, arg3);까지의 동작과 /* Perform late platform-specific setup */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Perform late platform-specific setup */원본 주석이 'Perform late platform-specific setup'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_plat_arch_setup();bl2_plat_arch_setup(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#endif /* RESET_TO_BL2 */#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#endif /* RESET_TO_BL2 */까지의 동작과 if (is_feat_pauth_supported()) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
if (is_feat_pauth_supported()) {is_feat_pauth_supported()를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
#if BL2_RUNS_AT_EL3#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
pauth_init_enable_el3();pauth_init_enable_el3(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#else#else 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
pauth_init_enable_el1();pauth_init_enable_el1(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#endif#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 #if ENABLE_RUNTIME_INSTRUMENTATION에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#if ENABLE_RUNTIME_INSTRUMENTATION#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
PMF_CAPTURE_TIMESTAMP(bl_svc, BL2_ENTRY, PMF_CACHE_MAINT);PMF_CAPTURE_TIMESTAMP(bl_svc, BL2_ENTRY, PMF_CACHE_MAINT)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#endif#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#endif까지의 동작과 NOTICE("BL2: %s\n", build_version_string);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
NOTICE("BL2: %s\n", build_version_string);NOTICE("BL2: %s\n", build_version_string)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
NOTICE("BL2: %s\n", build_message);NOTICE("BL2: %s\n", build_message)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)NOTICE("BL2: %s\n", build_message);까지의 동작과 /* Perform remaining generic architectural setup in S-EL1 */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Perform remaining generic architectural setup in S-EL1 */원본 주석이 'Perform remaining generic architectural setup in S-EL1'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_arch_setup();bl2_arch_setup(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)bl2_arch_setup();까지의 동작과 #if PSA_FWU_SUPPORT에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#if PSA_FWU_SUPPORT#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
fwu_init();fwu_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#endif /* PSA_FWU_SUPPORT */#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#endif /* PSA_FWU_SUPPORT */까지의 동작과 crypto_mod_init();에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
crypto_mod_init();crypto_mod_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)crypto_mod_init();까지의 동작과 /* Initialize authentication module */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Initialize authentication module */원본 주석이 'Initialize authentication module'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
auth_mod_init();auth_mod_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)auth_mod_init();까지의 동작과 /* Initialize the Measured Boot backend */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Initialize the Measured Boot backend */원본 주석이 'Initialize the Measured Boot backend'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_plat_mboot_init();bl2_plat_mboot_init(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)bl2_plat_mboot_init();까지의 동작과 /* Initialize boot source */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Initialize boot source */원본 주석이 'Initialize boot source'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_plat_preload_setup();bl2_plat_preload_setup(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)bl2_plat_preload_setup();까지의 동작과 /* Load the subsequent bootloader images. */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Load the subsequent bootloader images. */원본 주석이 'Load the subsequent bootloader images.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
next_bl_ep_info = bl2_load_images();next_bl_ep_info에 bl2_load_images()를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)next_bl_ep_info = bl2_load_images();까지의 동작과 /* Teardown the Measured Boot backend */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Teardown the Measured Boot backend */원본 주석이 'Teardown the Measured Boot backend'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl2_plat_mboot_finish();bl2_plat_mboot_finish(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)bl2_plat_mboot_finish();까지의 동작과 crypto_mod_finish();에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
crypto_mod_finish();crypto_mod_finish(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)crypto_mod_finish();까지의 동작과 #if !BL2_RUNS_AT_EL3에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#if !BL2_RUNS_AT_EL3#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
#ifndef __aarch64__#ifndef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. parent certificate까지 재귀적으로 적재·인증
common/bl_common.c 205-275줄이다.
205#endif
206
207 return load_image(image_id, image_data);
208}
209
210/*******************************************************************************
211 * Generic function to load and authenticate an image. The image is actually
212 * loaded by calling the 'load_image()' function. Therefore, it returns the
213 * same error codes if the loading operation failed, or -EAUTH if the
214 * authentication failed. In addition, this function uses recursion to
215 * authenticate the parent images up to the root of trust (if TBB is enabled).
216 ******************************************************************************/
217int load_auth_image(unsigned int image_id, image_info_t *image_data)
218{
219 int err;
220
221 if ((plat_try_img_ops == NULL) || (plat_try_img_ops->next_instance == NULL)) {
222 err = load_auth_image_internal(image_id, image_data);
223 } else {
224 do {
225 err = load_auth_image_internal(image_id, image_data);
226 if (err != 0) {
227 if (plat_try_img_ops->next_instance(image_id) != 0) {
228 return err;
229 }
230 }
231 } while (err != 0);
232 }
233
234 if (err == 0) {
235 /*
236 * If loading of the image gets passed (along with its
237 * authentication in case of Trusted-Boot flow) then measure
238 * it (if MEASURED_BOOT flag is enabled).
239 */
240 err = plat_mboot_measure_image(image_id, image_data);
241 if (err != 0) {
242 return err;
243 }
244
245 /*
246 * Flush the image to main memory so that it can be executed
247 * later by any CPU, regardless of cache and MMU state.
248 */
249 flush_dcache_range(image_data->image_base,
250 image_data->image_size);
251 }
252
253 return err;
254}
255
256/*******************************************************************************
257 * Print the content of an entry_point_info_t structure.
258 ******************************************************************************/
259void print_entry_point_info(const entry_point_info_t *ep_info)
260{
261 INFO("Entry point address = 0x%lx\n", ep_info->pc);
262 INFO("SPSR = 0x%x\n", ep_info->spsr);
263
264#define PRINT_IMAGE_ARG(n) \
265 VERBOSE("Argument #" #n " = 0x%llx\n", \
266 (unsigned long long) ep_info->args.arg##n)
267
268 PRINT_IMAGE_ARG(0);
269 PRINT_IMAGE_ARG(1);
270 PRINT_IMAGE_ARG(2);
271 PRINT_IMAGE_ARG(3);
272#ifdef __aarch64__
273 PRINT_IMAGE_ARG(4);
274 PRINT_IMAGE_ARG(5);
275 PRINT_IMAGE_ARG(6);
205-275줄 해설
#endif#endif 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
(빈 줄)#endif까지의 동작과 return load_image(image_id, image_data);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 image_info_t 상태가 아래 블록의 입력으로 사용되는 경계다.
return load_image(image_id, image_data);load_image(image_id, image_data)를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /*******************************************************************************에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*******************************************************************************원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* Generic function to load and authenticate an image. The image is actually원본 주석이 'Generic function to load and authenticate an image. The image is actually'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* loaded by calling the 'load_image()' function. Therefore, it returns the원본 주석이 'loaded by calling the 'load_image()' function. Therefore, it returns the'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* same error codes if the loading operation failed, or -EAUTH if the원본 주석이 'same error codes if the loading operation failed, or -EAUTH if the'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* authentication failed. In addition, this function uses recursion to원본 주석이 'authentication failed. In addition, this function uses recursion to'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* authenticate the parent images up to the root of trust (if TBB is enabled).원본 주석이 'authenticate the parent images up to the root of trust (if TBB is enabled).'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
******************************************************************************/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
int load_auth_image(unsigned int image_id, image_info_t *image_data)load_auth_image 함수 정의가 시작된다. 입력은 unsigned int image_id, image_info_t *image_data이며, BL2 trusted boot stage에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.
{바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 bl_mem_params_node_t / bl_params_t의 수명에 맞춰 묶어 읽는다.
int err;int err를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 bl_mem_params_node_t / bl_params_t를 직접 소유하는지 pointer만 빌리는지, BL2 trusted boot stage를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.
(빈 줄)int err;까지의 동작과 if ((plat_try_img_ops == NULL) || (plat_try_img_ops->next_instance == NULL)) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
if ((plat_try_img_ops == NULL) || (plat_try_img_ops->next_instance == NULL)) {(plat_try_img_ops == NULL) || (plat_try_img_ops->next_instance == NULL)를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
err = load_auth_image_internal(image_id, image_data);err에 load_auth_image_internal(image_id, image_data)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
} else {원본 223번 줄의 } else {는 앞의 err = load_auth_image_internal(image_id, image_data); 결과를 받아 다음 do {로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
do {원본 224번 줄의 do {는 앞의 } else { 결과를 받아 다음 err = load_auth_image_internal(image_id, image_data);로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
err = load_auth_image_internal(image_id, image_data);err에 load_auth_image_internal(image_id, image_data)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 if (err != 0) {가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
if (err != 0) {err != 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
if (plat_try_img_ops->next_instance(image_id) != 0) {plat_try_img_ops->next_instance(image_id) != 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
return err;err를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
} while (err != 0);} while (err !에 0)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 if (err == 0) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
if (err == 0) {err == 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
/*원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* If loading of the image gets passed (along with its원본 주석이 'If loading of the image gets passed (along with its'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* authentication in case of Trusted-Boot flow) then measure원본 주석이 'authentication in case of Trusted-Boot flow) then measure'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* it (if MEASURED_BOOT flag is enabled).원본 주석이 'it (if MEASURED_BOOT flag is enabled).'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
*/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
err = plat_mboot_measure_image(image_id, image_data);err에 plat_mboot_measure_image(image_id, image_data)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 if (err != 0) {가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
if (err != 0) {err != 0를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
return err;err를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* Flush the image to main memory so that it can be executed원본 주석이 'Flush the image to main memory so that it can be executed'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* later by any CPU, regardless of cache and MMU state.원본 주석이 'later by any CPU, regardless of cache and MMU state.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
*/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
flush_dcache_range(image_data->image_base,flush_dcache_range(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
image_data->image_size);원본 250번 줄의 image_data->image_size);는 앞의 flush_dcache_range(image_data->image_base, 결과를 받아 다음 }로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 return err;에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
return err;err를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /*******************************************************************************에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*******************************************************************************원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* Print the content of an entry_point_info_t structure.원본 주석이 'Print the content of an entry_point_info_t structure.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
******************************************************************************/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
void print_entry_point_info(const entry_point_info_t *ep_info)print_entry_point_info 함수 정의가 시작된다. 입력은 const entry_point_info_t *ep_info이며, BL2 trusted boot stage에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.
{바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 bl_mem_params_node_t / bl_params_t의 수명에 맞춰 묶어 읽는다.
INFO("Entry point address = 0x%lx\n", ep_info->pc);INFO("Entry point address에 0x%lx\n", ep_info->pc)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
INFO("SPSR = 0x%x\n", ep_info->spsr);INFO("SPSR에 0x%x\n", ep_info->spsr)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)INFO("SPSR = 0x%x\n", ep_info->spsr);까지의 동작과 #define PRINT_IMAGE_ARG(n) \에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
#define PRINT_IMAGE_ARG(n) \#define 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
VERBOSE("Argument #" #n " = 0x%llx\n", \VERBOSE(인자 없음)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(unsigned long long) ep_info->args.arg##n)원본 266번 줄의 (unsigned long long) ep_info->args.arg##n)는 앞의 VERBOSE("Argument #" #n " = 0x%llx\n", \ 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
(빈 줄)(unsigned long long) ep_info->args.arg##n)까지의 동작과 PRINT_IMAGE_ARG(0);에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
PRINT_IMAGE_ARG(0);PRINT_IMAGE_ARG(0)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
PRINT_IMAGE_ARG(1);PRINT_IMAGE_ARG(1)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
PRINT_IMAGE_ARG(2);PRINT_IMAGE_ARG(2)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
PRINT_IMAGE_ARG(3);PRINT_IMAGE_ARG(3)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
#ifdef __aarch64__#ifdef 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
PRINT_IMAGE_ARG(4);PRINT_IMAGE_ARG(4)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
PRINT_IMAGE_ARG(5);PRINT_IMAGE_ARG(5)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
PRINT_IMAGE_ARG(6);PRINT_IMAGE_ARG(6)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
02. memory descriptor를 BL31 handoff parameter list로 변환
common/desc_image_load.c 122-226줄이다.
122 return &bl_load_info;
123}
124
125/*******************************************************************************
126 * This function creates the list of executable images, by populating and
127 * linking each `bl_params_node_t` type node, using the internal array of
128 * image descriptor provided by bl_mem_params_desc_ptr. It also populates
129 * and returns `bl_params_t` type structure that contains head of the list
130 * of executable images.
131 ******************************************************************************/
132bl_params_t *get_next_bl_params_from_mem_params_desc(void)
133{
134 unsigned int count;
135 unsigned int img_id = 0U;
136 unsigned int link_index = 0U;
137 bl_params_node_t *bl_current_exec_node = NULL;
138 bl_params_node_t *bl_last_exec_node = NULL;
139 bl_mem_params_node_t *desc_ptr;
140
141 /* If there is no image to start with, return NULL */
142 if (bl_mem_params_desc_num == 0U)
143 return NULL;
144
145 /* Get the list HEAD */
146 for (count = 0U; count < bl_mem_params_desc_num; count++) {
147
148 desc_ptr = &bl_mem_params_desc_ptr[count];
149
150 if ((EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE) &&
151 (EP_GET_FIRST_EXE(desc_ptr->ep_info.h.attr) == EP_FIRST_EXE)) {
152 next_bl_params.head = &desc_ptr->params_node_mem;
153 link_index = count;
154 break;
155 }
156 }
157
158 /* Make sure we have a HEAD node */
159 assert(next_bl_params.head != NULL);
160
161 /* Populate the HEAD information */
162 SET_PARAM_HEAD(&next_bl_params, PARAM_BL_PARAMS, VERSION_2, 0U);
163
164 /*
165 * Go through the image descriptor array and create the list.
166 * This bounded loop is to make sure that we are not looping forever.
167 */
168 for (count = 0U; count < bl_mem_params_desc_num; count++) {
169
170 desc_ptr = &bl_mem_params_desc_ptr[link_index];
171
172 /* Make sure the image is executable */
173 assert(EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE);
174
175 /* Get the memory for current node */
176 bl_current_exec_node = &desc_ptr->params_node_mem;
177
178 /* Populate the image information */
179 bl_current_exec_node->image_id = desc_ptr->image_id;
180 bl_current_exec_node->image_info = &desc_ptr->image_info;
181 bl_current_exec_node->ep_info = &desc_ptr->ep_info;
182
183 if (bl_last_exec_node != NULL) {
184 /* Assert if loop detected */
185 assert(bl_last_exec_node->next_params_info == NULL);
186
187 /* Link the previous node to the current one */
188 bl_last_exec_node->next_params_info = bl_current_exec_node;
189 }
190
191 /* Update the last node */
192 bl_last_exec_node = bl_current_exec_node;
193
194 /* If no next hand-off image then break out */
195 img_id = desc_ptr->next_handoff_image_id;
196 if (img_id == INVALID_IMAGE_ID)
197 break;
198
199 /* Get the index for the next hand-off image */
200 link_index = get_bl_params_node_index(img_id);
201 assert((link_index > 0U) &&
202 (link_index < bl_mem_params_desc_num));
203 }
204
205 /* Invalid image is expected to terminate the loop */
206 assert(img_id == INVALID_IMAGE_ID);
207
208 return &next_bl_params;
209}
210
211/*******************************************************************************
212 * This function populates the entry point information with the corresponding
213 * config file for all executable BL images described in bl_params.
214 ******************************************************************************/
215void populate_next_bl_params_config(bl_params_t *bl2_to_next_bl_params)
216{
217 /*
218 * With Firmware Handoff configuration data is shared dynamically, most of
219 * the *_CONFIG files will be deprecated. Avoid populating the entry point
220 * arguments with their information as they're discarded anyway.
221 */
222#if !TRANSFER_LIST
223 bl_params_node_t *params_node;
224 unsigned int fw_config_id;
225 uintptr_t fw_config_base;
226 bl_mem_params_node_t *mem_params;
122-226줄 해설
return &bl_load_info;&bl_load_info를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /*******************************************************************************에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 entry_point_info_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*******************************************************************************원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* This function creates the list of executable images, by populating and원본 주석이 'This function creates the list of executable images, by populating and'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* linking each `bl_params_node_t` type node, using the internal array of원본 주석이 'linking each bl_params_node_t type node, using the internal array of'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* image descriptor provided by bl_mem_params_desc_ptr. It also populates원본 주석이 'image descriptor provided by bl_mem_params_desc_ptr. It also populates'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* and returns `bl_params_t` type structure that contains head of the list원본 주석이 'and returns bl_params_t type structure that contains head of the list'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* of executable images.원본 주석이 'of executable images.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
******************************************************************************/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl_params_t *get_next_bl_params_from_mem_params_desc(void)get_next_bl_params_from_mem_params_desc(void)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
{바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 bl_mem_params_node_t / bl_params_t의 수명에 맞춰 묶어 읽는다.
unsigned int count;unsigned int count를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 bl_mem_params_node_t / bl_params_t를 직접 소유하는지 pointer만 빌리는지, BL2 trusted boot stage를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.
unsigned int img_id = 0U;unsigned int img_id = 0U를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 bl_mem_params_node_t / bl_params_t를 직접 소유하는지 pointer만 빌리는지, BL2 trusted boot stage를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.
unsigned int link_index = 0U;unsigned int link_index = 0U를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 bl_mem_params_node_t / bl_params_t를 직접 소유하는지 pointer만 빌리는지, BL2 trusted boot stage를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.
bl_params_node_t *bl_current_exec_node = NULL;bl_params_node_t *bl_current_exec_node에 NULL를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
bl_params_node_t *bl_last_exec_node = NULL;bl_params_node_t *bl_last_exec_node에 NULL를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
bl_mem_params_node_t *desc_ptr;원본 139번 줄의 bl_mem_params_node_t *desc_ptr;는 앞의 bl_params_node_t *bl_last_exec_node = NULL; 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
(빈 줄)bl_mem_params_node_t *desc_ptr;까지의 동작과 /* If there is no image to start with, return NULL */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* If there is no image to start with, return NULL */원본 주석이 'If there is no image to start with, return NULL'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
if (bl_mem_params_desc_num == 0U)bl_mem_params_desc_num == 0U를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
return NULL;NULL를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
(빈 줄)return NULL;까지의 동작과 /* Get the list HEAD */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Get the list HEAD */원본 주석이 'Get the list HEAD'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
for (count = 0U; count < bl_mem_params_desc_num; count++) {'for (count = 0U; count < bl_mem_params_desc_num; count++) {'가 목록이나 후보를 순회한다. 반복 중 bl_mem_params_node_t / bl_params_t를 제거·추가하는 호출이 있는지와 loop 종료 뒤 iterator가 유효한지 확인한다.
(빈 줄)for (count = 0U; count < bl_mem_params_desc_num; count++) {까지의 동작과 desc_ptr = &bl_mem_params_desc_ptr[count];에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
desc_ptr = &bl_mem_params_desc_ptr[count];desc_ptr에 &bl_mem_params_desc_ptr[count]를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)desc_ptr = &bl_mem_params_desc_ptr[count];까지의 동작과 if ((EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE) &&에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
if ((EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE) &&EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE)를 호출한다. 반환 결과는 현재 줄 또는 다음 (EP_GET_FIRST_EXE(desc_ptr->ep_info.h.attr) == EP_FIRST_EXE)) {에서 검사되는 흐름이다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(EP_GET_FIRST_EXE(desc_ptr->ep_info.h.attr) == EP_FIRST_EXE)) {EP_GET_FIRST_EXE(desc_ptr->ep_info.h.attr) == EP_FIRST_EXE))를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
next_bl_params.head = &desc_ptr->params_node_mem;next_bl_params.head에 &desc_ptr->params_node_mem를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
link_index = count;link_index에 count를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
break;'break;'로 직선 경로를 벗어난다. 이동 대상에서 bl_mem_params_node_t / bl_params_t에 걸린 lock, allocation, list 등록을 어디까지 되돌리는지 이어서 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /* Make sure we have a HEAD node */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Make sure we have a HEAD node */원본 주석이 'Make sure we have a HEAD node'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
assert(next_bl_params.head != NULL);assert(next_bl_params.head !에 NULL)를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)assert(next_bl_params.head != NULL);까지의 동작과 /* Populate the HEAD information */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Populate the HEAD information */원본 주석이 'Populate the HEAD information'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
SET_PARAM_HEAD(&next_bl_params, PARAM_BL_PARAMS, VERSION_2, 0U);SET_PARAM_HEAD(&next_bl_params, PARAM_BL_PARAMS, VERSION_2, 0U)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(빈 줄)SET_PARAM_HEAD(&next_bl_params, PARAM_BL_PARAMS, VERSION_2, 0U);까지의 동작과 /*에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* Go through the image descriptor array and create the list.원본 주석이 'Go through the image descriptor array and create the list.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* This bounded loop is to make sure that we are not looping forever.원본 주석이 'This bounded loop is to make sure that we are not looping forever.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
*/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
for (count = 0U; count < bl_mem_params_desc_num; count++) {'for (count = 0U; count < bl_mem_params_desc_num; count++) {'가 목록이나 후보를 순회한다. 반복 중 bl_mem_params_node_t / bl_params_t를 제거·추가하는 호출이 있는지와 loop 종료 뒤 iterator가 유효한지 확인한다.
(빈 줄)for (count = 0U; count < bl_mem_params_desc_num; count++) {까지의 동작과 desc_ptr = &bl_mem_params_desc_ptr[link_index];에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
desc_ptr = &bl_mem_params_desc_ptr[link_index];desc_ptr에 &bl_mem_params_desc_ptr[link_index]를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)desc_ptr = &bl_mem_params_desc_ptr[link_index];까지의 동작과 /* Make sure the image is executable */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Make sure the image is executable */원본 주석이 'Make sure the image is executable'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
assert(EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE);assert(EP_GET_EXE(desc_ptr->ep_info.h.attr)에 = EXECUTABLE)를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)assert(EP_GET_EXE(desc_ptr->ep_info.h.attr) == EXECUTABLE);까지의 동작과 /* Get the memory for current node */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Get the memory for current node */원본 주석이 'Get the memory for current node'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl_current_exec_node = &desc_ptr->params_node_mem;bl_current_exec_node에 &desc_ptr->params_node_mem를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)bl_current_exec_node = &desc_ptr->params_node_mem;까지의 동작과 /* Populate the image information */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Populate the image information */원본 주석이 'Populate the image information'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl_current_exec_node->image_id = desc_ptr->image_id;bl_current_exec_node->image_id에 desc_ptr->image_id를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
bl_current_exec_node->image_info = &desc_ptr->image_info;bl_current_exec_node->image_info에 &desc_ptr->image_info를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
bl_current_exec_node->ep_info = &desc_ptr->ep_info;bl_current_exec_node->ep_info에 &desc_ptr->ep_info를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 주소·크기 값이면 단위와 정렬, 덧셈 overflow를 함께 검산한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)bl_current_exec_node->ep_info = &desc_ptr->ep_info;까지의 동작과 if (bl_last_exec_node != NULL) {에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
if (bl_last_exec_node != NULL) {bl_last_exec_node != NULL를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
/* Assert if loop detected */원본 주석이 'Assert if loop detected'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
assert(bl_last_exec_node->next_params_info == NULL);assert(bl_last_exec_node->next_params_info에 = NULL)를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)assert(bl_last_exec_node->next_params_info == NULL);까지의 동작과 /* Link the previous node to the current one */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Link the previous node to the current one */원본 주석이 'Link the previous node to the current one'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl_last_exec_node->next_params_info = bl_current_exec_node;bl_last_exec_node->next_params_info에 bl_current_exec_node를 = 연산으로 반영해 bl_mem_params_node_t / bl_params_t와 연결된 field를 갱신한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /* Update the last node */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Update the last node */원본 주석이 'Update the last node'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
bl_last_exec_node = bl_current_exec_node;bl_last_exec_node에 bl_current_exec_node를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)bl_last_exec_node = bl_current_exec_node;까지의 동작과 /* If no next hand-off image then break out */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* If no next hand-off image then break out */원본 주석이 'If no next hand-off image then break out'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
img_id = desc_ptr->next_handoff_image_id;img_id에 desc_ptr->next_handoff_image_id를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 if (img_id == INVALID_IMAGE_ID)가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
if (img_id == INVALID_IMAGE_ID)img_id == INVALID_IMAGE_ID를 검사해 진행 여부를 가른다. 거짓 경로와 참 경로 중 어느 쪽이 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건을 보존하는지 다음 return 또는 goto까지 따라간다.
break;'break;'로 직선 경로를 벗어난다. 이동 대상에서 bl_mem_params_node_t / bl_params_t에 걸린 lock, allocation, list 등록을 어디까지 되돌리는지 이어서 확인한다.
(빈 줄)break;까지의 동작과 /* Get the index for the next hand-off image */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Get the index for the next hand-off image */원본 주석이 'Get the index for the next hand-off image'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
link_index = get_bl_params_node_index(img_id);link_index에 get_bl_params_node_index(img_id)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 바로 다음 assert((link_index > 0U) &&가 이 값을 다시 읽으므로 그 전까지 완성된 값이어야 한다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
assert((link_index > 0U) &&assert((link_index > 0U)를 호출한다. 반환값을 직접 사용하지 않으므로 이 함수가 실패를 내부 처리하는지 확인해야 한다. pointer 인자는 bl_mem_params_node_t / bl_params_t의 소유권을 넘기는지 호출 동안만 빌리는지 구분하고, 호출 뒤 공개되는 상태를 bl_params_t 항목과 대조한다.
(link_index < bl_mem_params_desc_num));원본 202번 줄의 (link_index < bl_mem_params_desc_num));는 앞의 assert((link_index > 0U) && 결과를 받아 다음 }로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /* Invalid image is expected to terminate the loop */에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/* Invalid image is expected to terminate the loop */원본 주석이 'Invalid image is expected to terminate the loop'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
assert(img_id == INVALID_IMAGE_ID);assert(img_id에 = INVALID_IMAGE_ID)를 = 연산으로 반영해 현재 scope의 계산 결과를 저장한다. 이후 BL31 params 단계가 이 값을 처음 소비하는 지점을 찾는다. 실패 경로가 이 field를 이전 값으로 되돌리거나 객체 전체를 폐기하는지도 확인한다.
(빈 줄)assert(img_id == INVALID_IMAGE_ID);까지의 동작과 return &next_bl_params;에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
return &next_bl_params;&next_bl_params를 호출자에게 반환한다. caller가 이 값을 검사한 뒤 부분 초기화된 bl_mem_params_node_t / bl_params_t를 정리하거나 다음 단계로 진행하는지 확인한다.
}현재 block, initializer 또는 호출의 경계를 닫는다. 이 지점까지 획득한 resource가 성공 경로와 실패 경로에서 대칭인지 점검한다.
(빈 줄)}까지의 동작과 /*******************************************************************************에서 시작하는 동작을 나누는 빈 줄이다. 앞 블록이 만든 bl_params_t 상태가 아래 블록의 입력으로 사용되는 경계다.
/*******************************************************************************원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* This function populates the entry point information with the corresponding원본 주석이 'This function populates the entry point information with the corresponding'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* config file for all executable BL images described in bl_params.원본 주석이 'config file for all executable BL images described in bl_params.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
******************************************************************************/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
void populate_next_bl_params_config(bl_params_t *bl2_to_next_bl_params)populate_next_bl_params_config 함수 정의가 시작된다. 입력은 bl_params_t *bl2_to_next_bl_params이며, BL2 trusted boot stage에서 호출된다는 전제로 반환 전까지의 상태 변화를 읽는다.
{바로 위 함수·조건·초기화의 block이 열린다. 이 scope 안에서 만들어지는 지역 객체와 오류 이동 지점을 bl_mem_params_node_t / bl_params_t의 수명에 맞춰 묶어 읽는다.
/*원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* With Firmware Handoff configuration data is shared dynamically, most of원본 주석이 'With Firmware Handoff configuration data is shared dynamically, most of'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* the *_CONFIG files will be deprecated. Avoid populating the entry point원본 주석이 'the *_CONFIG files will be deprecated. Avoid populating the entry point'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
* arguments with their information as they're discarded anyway.원본 주석이 'arguments with their information as they're discarded anyway.'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
*/원본 주석이 'block boundary'라고 기록한 줄이다. 바로 아래 구현이 이 전제와 같은 순서·단위를 사용하는지 대조한다.
#if !TRANSFER_LIST#if 전처리 지시문으로 이 줄 아래의 code가 binary에 존재할지를 결정한다. architecture 또는 build stage 조건을 여닫는다. 현재 .config와 compiler의 -dD -E 출력에서 실제로 남은 branch를 확인한 뒤 line-by-line 흐름에 포함한다.
bl_params_node_t *params_node;원본 223번 줄의 bl_params_node_t *params_node;는 앞의 #if !TRANSFER_LIST 결과를 받아 다음 unsigned int fw_config_id;로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
unsigned int fw_config_id;unsigned int fw_config_id를 선언한다. 함수 안 선언이면 현재 stack frame, file scope와 static이면 image의 data/BSS에 놓인다. 이 값이 bl_mem_params_node_t / bl_params_t를 직접 소유하는지 pointer만 빌리는지, BL2 trusted boot stage를 벗어난 뒤에도 참조되는지 다음 대입과 callback 등록까지 따라간다.
uintptr_t fw_config_base;원본 225번 줄의 uintptr_t fw_config_base;는 앞의 unsigned int fw_config_id; 결과를 받아 다음 bl_mem_params_node_t *mem_params;로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
bl_mem_params_node_t *mem_params;원본 226번 줄의 bl_mem_params_node_t *mem_params;는 앞의 uintptr_t fw_config_base; 결과를 받아 다음 다음 block 경계로 넘기는 중간 연산이다. 이 줄이 바꾸는 register·field·list link를 찾고, 변경 뒤에도 '각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다' 조건이 유지되는지 확인한다.
DETAILS
내부 동작을 더 깊게 읽기
진입 조건을 먼저 고정한다
BL1 handoff에서 들어온 실행은 BL2 trusted boot stage에 놓여 있다. 이때 interrupt, MMU/cache, stack, heap 중 무엇이 이미 준비되었는지 소스의 호출자까지 올라가 확인한다. 같은 함수라도 SPL, relocation 전후, app thread처럼 호출 문맥이 달라지면 허용되는 API와 지연 시간이 달라진다.
BL2는 단순 복사기가 아니다. parent certificate, image ID, load region, executable 여부와 다음 image parameter list를 한꺼번에 관리한다.
중심 객체의 생성과 공개를 나눈다
이 글의 중심 객체는 bl_mem_params_node_t / bl_params_t다. 메모리를 확보한 시점, 필드를 채운 시점, 전역 list나 다른 subsystem에 공개한 시점을 구분한다. 공개 뒤 오류가 발생한다면 목록에서 제거하고 child, buffer, reference를 역순으로 정리하는지 확인한다.
빌드 산출물 관점에서는 최종 부트로더 이미지 안에 해당 symbol과 section이 실제로 포함되었는지도 map과 objdump로 검증한다.
주소, 크기와 정렬을 계산한다
부트 코드의 오류는 논리보다 주소 계산에서 먼저 드러나는 경우가 많다. source range, destination range, header가 말하는 payload size, block 또는 page 단위를 표로 적고 각 구간의 끝 주소를 직접 계산한다. 끝 주소는 start + size - 1인지 exclusive end인지 API 계약을 확인한다.
각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다.
성공 flag와 실제 완료 시점을 맞춘다
BL2 platform setup → image descriptor walk → load/auth images 구간에서는 부분 초기화 상태가 생길 수 있다. flag, list insertion, callback 등록, storage write 완료 중 무엇이 성공의 기준인지 찾는다. hardware write나 DMA가 포함되면 함수 반환과 장치 완료가 같은 시점인지도 확인한다.
다른 CPU, interrupt handler, USB completion 또는 shell command가 상태를 관찰할 수 있다면 memory ordering과 lock 범위도 함께 읽는다.
마지막 handoff의 계약을 적는다
정상 경로는 BL31 params에서 끝난다. 이 단계가 함수 반환인지, scheduler 전환인지, 다른 image로의 비복귀 분기인지 구분한다. 비복귀 handoff라면 cache clean/invalidate, interrupt disable, 장치 quiesce, argument register와 FDT 또는 image address가 최종 점검 항목이다.
반환하는 경로라면 caller가 오류와 부분 성공을 구분하고 다음 후보 또는 복구 경로를 선택하는지 확인한다.
IMPLEMENTATION NOTES
구현을 읽을 때 놓치기 쉬운 부분
BL1 handoff에서 BL31 params까지 제어권이 이동하는 조건
BL2가 platform image policy를 따라 BL31, BL32, BL33을 인증하고 reserved memory에 배치하는 전체 loop를 읽습니다. 이 경로는 함수 호출 목록만 외워서는 연결되지 않는다. BL1 handoff → BL2 platform setup → image descriptor walk → load/auth images → BL31 params 순서에서 각 단계가 읽는 입력, 새로 확정하는 상태, 다음 단계에 넘기는 값을 구분해야 한다. 특히 BL2 trusted boot stage에서는 이전 단계가 남긴 register와 memory attribute가 C 코드의 전제 조건이 된다.
BL2는 단순 복사기가 아니다. parent certificate, image ID, load region, executable 여부와 다음 image parameter list를 한꺼번에 관리한다. 따라서 첫 지점에서 bl_mem_params_node_t / bl_params_t의 주소와 owner를 기록하고, 마지막 지점에서 같은 값이 그대로 유지되는지 아니면 새 객체로 교체되는지를 확인한다. 중간 함수가 성공을 반환해도 각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다.
bl_mem_params_node_t와 bl_params_t의 생성 시점과 수명
이 글에서 함께 나타나는 객체는 bl_mem_params_node_t, image_info_t, entry_point_info_t, bl_params_t이다. 이름이 비슷해도 저장 위치와 수명은 다르다. build-time descriptor인지, boot 단계의 임시 객체인지, world switch 뒤에도 남는 runtime 객체인지 나눠야 pointer를 따라가다 다른 단계의 구조체를 같은 것으로 오해하지 않는다.
bl_mem_params_node_t / bl_params_t을 기준으로 allocation 또는 정적 배치 위치, list/table에 공개되는 시점, 참조가 끊기는 시점을 적는다. 그 다음 source와 destination 범위, per-CPU 여부, secure/non-secure 접근 권한을 map과 runtime log로 대조한다. 이 절차를 거치면 단순한 호출 순서가 아니라 실제 소유권 이동이 보인다.
성공 로그만으로 놓치기 쉬운 실패 경계
대표적인 실패 조건은 descriptor 순서 오류: parent 미인증; load region 겹침: 다음 image 손상; skip loading 오설정: 빈 entry 실행이다. 이 문제들은 대개 fault가 발생한 함수보다 앞에서 만들어진 잘못된 주소, size, security state 또는 refcount 때문에 생긴다. 마지막 출력만 보지 말고 각 경계 직전의 상태를 한 줄씩 남겨 최초 불일치 지점을 찾는다.
재현에는 descriptor list와 FIP ToC 대조; BL32 크기를 늘려 bounds 실패 확인; bl_params list를 BL31 진입 로그와 비교를 사용한다. 정상 경로와 실패 경로에서 같은 필드를 같은 위치에 출력하고, 실패가 검증 단계에서 차단되는지 아니면 다음 context까지 전파되는지 비교한다. firmware와 secure world에서는 실패 뒤의 cleanup 또는 reset 경로도 정상 경로만큼 중요하다.
DEEP ANALYSIS
레지스터에서 오류 판정까지 상세 분석
BL2의 image loading은 BL31, BL32, BL33 파일을 차례대로 memcpy하는 loop가 아니다. platform이 등록한 bl_mem_params_node_t graph에는 image ID, load 정보, executable entry, 다음 handoff image가 연결되어 있으며 인증 의존 관계와 실행 순서는 동일하지 않을 수 있다.
각 node를 읽을 때 image_info는 저장·적재 범위를, ep_info는 실행 계약을, next_handoff_image_id는 BL31에 넘길 parameter chain을 표현한다. 세 객체의 의미를 섞으면 data-only certificate에 entry point를 기대하거나 executable image의 인증 완료 전에 pc를 공개하는 오류를 놓친다.
BL2가 사용할 free trusted memory와 boot parameter를 가리킨다.
image ID가 고유하고 dependency/next link가 유효해야 한다.
base, max_size, 실제 image_size를 구분한다.
executable image만 pc/spsr/security state가 유효하다.
BL31·BL32·BL33 node가 올바른 순서와 type으로 연결돼야 한다.
각 계약은 앞 단계가 생산하고 현재 단계가 검증한 뒤 다음 소비자에게 넘기는 상태다. 한 항목이라도 확인되지 않으면 뒤 단계의 fault를 그 지점의 문제로 단정하지 않는다.
진입 레지스터와 메모리 계약
함수 첫 줄에 도달했을 때 이미 참이라고 가정하는 값과, 그 값이 틀렸을 때 영향을 받는 범위를 함께 적었다.
| # | 입력 상태 | 생산자 | 정상 조건 | 확인 이유 |
|---|---|---|---|---|
| 01 | BL1 parameter | BL1 handoff 또는 platform reset path | BL2가 사용할 free trusted memory와 boot parameter를 가리킨다. | BL2 자신의 allocator와 image destination 계산의 시작점이다. |
| 02 | mem params list | REGISTER_BL_IMAGE_DESCS와 platform code | image ID가 고유하고 dependency/next link가 유효해야 한다. | 전체 load·handoff graph를 정의한다. |
| 03 | image_info | platform descriptor와 loader | base, max_size, 실제 image_size를 구분한다. | storage read와 bounds 검사의 기준이다. |
| 04 | ep_info | descriptor와 post-image-load hook | executable image만 pc/spsr/security state가 유효하다. | BL31 parameter list에서 소비된다. |
| 05 | BL31 params | bl2_plat_get_bl31_params 또는 bl_params list | BL31·BL32·BL33 node가 올바른 순서와 type으로 연결돼야 한다. | BL31이 다음 image를 선택하는 유일한 입력이다. |
핵심 구조체 필드의 생산자, 소비자와 수명
구조체 이름만 나열하지 않고 어떤 코드가 값을 쓰고, 어느 코드가 처음 읽으며, 언제까지 주소와 내용이 유지되어야 하는지 구분했다.
| # | 객체 또는 필드 | 생산자 | 소비자 | 수명과 불변 조건 |
|---|---|---|---|---|
| 01 | bl_mem_params_node_t.image_id | platform descriptor | get_bl_mem_params_node | boot 동안 불변이며 auth/image policy ID와 일치해야 한다. |
| 02 | bl_mem_params_node_t.image_info | descriptor와 load_auth_image | I/O와 post-load hook | max_size에서 실제 image_size로 좁혀지며 destination은 유지된다. |
| 03 | bl_mem_params_node_t.ep_info | descriptor/post-load | BL31 handoff preparation | executable node에서만 다음 EL 진입까지 유효하다. |
| 04 | next_handoff_image_id | platform descriptor | get_next_bl_params_from_mem_params_desc | parameter list를 구성하는 동안 cycle과 누락이 없어야 한다. |
| 05 | bl_params_t/bl_params_node_t | BL2 parameter builder | BL31 entry | BL2 memory 또는 shared region에 놓이며 BL31이 복사·소비할 때까지 유지된다. |
| 06 | skip_loading flag | platform policy | image loading loop | preloaded image의 주소와 인증 책임이 다른 stage에 있음을 명확히 해야 한다. |
함수 내부 실행 순서
소스의 큰 분기와 side effect를 실행 순서대로 다시 펼쳤다. breakpoint는 이 목록의 경계에 두고, 다음 번호로 넘어갈 때 새로 유효해진 객체를 기록한다.
- 01
BL2가 platform memory와 I/O framework를 초기화하고 descriptor table에 접근 가능한 상태를 만든다.
- 02
image descriptor의 ID, type, parent, next_handoff link를 검사해 처리 순서를 결정한다.
- 03
platform policy에서 image source device와 image spec을 얻고 backend를 연다.
- 04
image_info.image_base와 image_max_size를 기준으로 destination overlap과 address overflow를 검사한다.
- 05
payload를 읽어 실제 image_size를 기록하고 short read와 storage 오류를 분리한다.
- 06
인증 모듈이 parent certificate, signature, hash, counter를 순서대로 검증한다.
- 07
post-image-load hook이 executable image의 SPSR, argument, security state와 platform-specific metadata를 보정한다.
- 08
next_handoff_image_id chain을 따라 bl_params list를 만들고 BL31, BL32, BL33의 순서를 확인한다.
- 09
BL31 진입 전에 cache clean과 parameter memory 수명을 보장하고 BL2 임시 영역을 더 이상 참조하지 않게 한다.
빌드 설정이 바꾸는 실제 코드 경로
동일한 함수 이름이라도 아래 설정에 따라 포함되는 source, 구조체 크기, 인자 의미와 failure path가 달라진다.
| # | 설정 | 바뀌는 동작 | 확인 방법 |
|---|---|---|---|
| 01 | LOAD_IMAGE_V2 | v2 image descriptor와 bl_params list 경로를 사용한다. | platform descriptor macro와 BL31 parameter ABI를 확인한다. |
| 02 | TRUSTED_BOARD_BOOT | load와 auth가 한 경로에서 결합된다. | data/certificate/executable node별 auth method를 출력한다. |
| 03 | BL32/BL33 | 외부 payload node의 존재와 source가 달라진다. | 빈 path가 skip_loading으로 잘못 처리되지 않는지 본다. |
| 04 | PRELOADED_BL33_BASE | storage load 없이 이미 놓인 BL33을 참조할 수 있다. | preloaded range의 owner와 cache 상태를 별도로 검증한다. |
증상에서 최초 불일치 지점까지 추적하기
마지막 panic 메시지가 아니라 어디에서 멈추고 무엇을 읽어 어떤 결론을 내릴지 정리했다. 정상값과 실패값은 같은 build와 같은 위치에서 비교한다.
| # | 관찰 증상 | 중단 위치 | 기록할 값 | 판정 |
|---|---|---|---|---|
| 01 | 특정 image ID에서만 ENOENT | plat_get_image_source 반환 직후 | image_id, device_handle, image_spec, UUID | descriptor는 있지만 platform I/O policy가 빠졌는지 확인한다. |
| 02 | 두 payload를 읽은 뒤 hash가 변함 | 각 load 전후 | 모든 destination start/end와 image_size | descriptor의 max_size 또는 실제 read 길이로 인한 overlap을 찾는다. |
| 03 | BL31은 뜨지만 BL32/BL33 정보를 못 찾음 | bl_params list 생성 | node type, image_id, next_params_info | next_handoff chain 누락과 cache visibility를 구분한다. |
| 04 | preloaded image에서만 fault | skip_loading branch와 handoff 직전 | preloaded base, first bytes, cache maintenance | load를 건너뛴 대신 누가 유효성을 보장하는지 확인한다. |
OBJECT LIFETIME
객체와 수명
| 대상 | 만들어지는 시점 | 유효 범위 | 확인할 조건 |
|---|---|---|---|
bl_mem_params_node_t / bl_params_t | BL2 platform setup | BL31 params 또는 오류 정리 완료까지 | 각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다. |
| 입력 buffer / metadata | BL1 handoff | parse와 검증이 끝날 때까지 | 길이, 정렬, 소유권, 변조 가능성 |
| 등록된 list / descriptor | image descriptor walk | subsystem 종료 또는 image handoff까지 | 이중 등록, dangling pointer, 오류 unwind |
| hardware 또는 persistent state | 실제 write/probe가 완료된 뒤 | reset 또는 명시적 해제·갱신까지 | flush, timeout, 전원 차단, rollback |
최종 부트로더 이미지 | link/image 생성 시점 | 다음 stage가 새 image로 교체할 때까지 | load address, entry, section과 header 일치 |
FAILURE PATH
실패 지점과 증상
| # | 조건 | 관찰되는 증상 | 먼저 볼 단계 |
|---|---|---|---|
| 01 | descriptor 순서 오류 | parent 미인증 | BL2 platform setup |
| 02 | load region 겹침 | 다음 image 손상 | image descriptor walk |
| 03 | skip loading 오설정 | 빈 entry 실행 | load/auth images |
로그가 끊긴 마지막 함수만 고치지 않는다. 그 함수가 받은 주소, size, flag가 만들어진 앞 단계까지 올라가고, 오류 뒤 등록 객체와 hardware 상태가 남았는지도 확인한다.
EVIDENCE
소스 밖에서 확인할 증거
소스 해석은 실제 빌드 산출물과 target 로그로 닫아야 한다. 아래 명령의 보드 이름과 toolchain prefix는 사용 중인 빌드 환경에 맞게 바꾼다.
| # | 목적 | 명령 또는 계측 | 판정 기준 |
|---|---|---|---|
| 01 | 빌드 산출물 | make PLAT=<platform> DEBUG=1 all fip | BL1, BL2, BL31과 FIP가 같은 설정으로 만들어졌는지 전체 빌드 명령부터 기록한다. |
| 02 | FIP 구성 | tools/fiptool/fiptool info build/<platform>/debug/fip.bin | FIP 안의 BL31, BL32, BL33 UUID와 offset, 크기를 확인해 실제 적재 입력을 고정한다. |
| 03 | 심볼과 주소 | ${CROSS_COMPILE}nm -n build/<platform>/debug/bl31/bl31.elf | grep 'void __no_pauth bl2_main' | 대상 함수가 BL31의 어느 주소와 섹션에 놓였는지 확인한다. |
| 04 | EL3 명령 추적 | ${CROSS_COMPILE}objdump -drS build/<platform>/debug/bl31/bl31.elf | C 코드가 EL3 system register 접근과 eret 경로로 어떻게 번역됐는지 대조한다. |
| 05 | 실행 시점 증거 | TF-A DEBUG log + CurrentEL/SCR_EL3/SPSR_EL3/x0-x3 기록 | 어느 exception level에서 어떤 security state와 인자를 다음 이미지에 넘겼는지 serial log로 남긴다. |
LAB
직접 확인할 실험
- 01descriptor list와 FIP ToC 대조
BL2 platform setup진입 전후에 bl_mem_params_node_t의 주소·크기·반환값과 timestamp를 함께 남긴다. 결과는 정상 부팅 여부로 끝내지 말고 각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다. 조건이 처음 깨지는 줄을 기록한다. - 02BL32 크기를 늘려 bounds 실패 확인
image descriptor walk진입 전후에 image_info_t의 주소·크기·반환값과 timestamp를 함께 남긴다. 결과는 정상 부팅 여부로 끝내지 말고 각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다. 조건이 처음 깨지는 줄을 기록한다. - 03bl_params list를 BL31 진입 로그와 비교
load/auth images진입 전후에 entry_point_info_t의 주소·크기·반환값과 timestamp를 함께 남긴다. 결과는 정상 부팅 여부로 끝내지 말고 각 image의 destination은 허용된 secure/non-secure 영역에 있고 선행 인증서와 payload 인증이 성공한 뒤 executable parameter에 공개되어야 한다. 조건이 처음 깨지는 줄을 기록한다.
PRIMARY REFERENCES