Trusted Firmware-A · source analysis

TF-A 빌드 산출물과 FIP 구성

BL1, BL2, BL31, BL32, BL33과 인증서가 fip.bin 안에서 어떤 UUID와 offset으로 묶이는지 읽습니다.

표의 버전은 소스 분석 기준이며 최신 보안 버전 권고가 아닙니다. TF-A LTS 2.14.3 이후에는 보안 수정이 있습니다. 제품 적용 시 공식 변경 기록과 사용 플랫폼의 errata를 확인하세요.

Series
01 / 12
Baseline
LTS 2.14.3
Commit
f5e765a3443f
Source
Makefile:1189-1277 (발췌 범위)

TF-A 빌드 산출물과 FIP 구성 단계에서 실제로 바뀌는 상태는 무엇인가?

파일 이름보다 FIP ToC의 UUID, offset, size와 각 image의 load address를 함께 본다. BL32와 BL33은 FIP 안의 순서가 아니라 image descriptor와 security state로 구분된다.

FIP의 각 ToC entry는 실제 payload 범위 안을 가리키고 platform image policy의 image ID와 같은 UUID 계약을 사용해야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.

빌드 입력과 FIP 메타데이터의 경계

그림 1. 선택된 이미지에서 FIP 메타데이터까지
조건부 입력fiptool 처리파일 결과
01선택된 BL image
02조건부 BL32/BL33
03조건부 인증서
04ToC + payload

Makefile의 이미지 선택과 인증 설정이 FIP 입력을 정한다. fiptool은 존재하는 입력의 UUID entry와 offset을 만든 뒤 메타데이터와 payload를 기록한다. 이 칸들은 BL1→BL2→BL31 실행 순서가 아니다.

FIP 생성 의존성

그림 2. 조건부 입력과 fiptool 패키징
platform makefile
BL image ELF/bin
조건부 인증서
fiptool package
fip.bin

인증서 생성은 GENERATE_COT 설정에 따른 분기이며 BL33을 생산하지 않는다. BL32·BL33도 플랫폼과 입력 설정에 따라 포함된다. fiptool은 선택된 이미지와 인증서를 UUID별로 묶는다.

단계별 입력과 출력

고정 LTS 2.14.3의 Makefile과 pack_images()가 실제로 생산·소비하는 값을 구분한다.

#규칙/함수입력결과다음 소비자/조건
01Makefile image rules플랫폼·BL2/BL31/BL32/BL33 설정과 기존 이미지선택된 BL binary와 FIP_ARGS필요한 이미지별 build 또는 외부 입력; BL32/BL33 조건부
02certificatesCoT 설정·선택된 이미지필요한 인증서 파일GENERATE_COT != 0일 때 FIP 의존성; BL33 생성 아님
03fiptool createFIP_DEPS, FIP_ARGS와 UUID별 payload이미지별 fip_toc_entry의 offset·size입력이 없는 이미지에는 entry가 생기지 않음
04pack_images() metadataentry 개수와 alignmentheader + 모든 ToC entry + null UUID 종료 entry메타데이터를 한 번에 먼저 파일에 기록
05pack_images() payload각 entry의 offset·size와 payload bytesfip.bin의 정렬된 payload 구간각 offset으로 seek한 뒤 기록; fiptool info로 확인

분석 범위의 전제와 비교하되, BL 단계 간 실행 순서와 host의 FIP 생성 규칙을 섞지 않는다.

FIP 파일의 ToC와 payload 배치를 읽기

아래 그림의 축은 보드 메모리 주소가 아니라 fip.bin 안의 byte offset이다. 실제 목록과 크기는 해당 빌드의 fiptool info와 파일 길이로 확인한다.

그림 3. 선택된 입력으로 FIP를 만드는 경로

host 빌드 단계의 의존성이다. 인증서와 BL32/BL33은 설정에 따라 달라진다.

01platform makefile
02BL image ELF/bin
03조건부 인증서
04fiptool package
05fip.bin
그림 4. fip.bin의 파일 offset 순서

고정 fiptool.c:pack_images()의 기록 순서다. payload의 종류와 개수는 입력 옵션에 따른다.

fip.bin 파일 시작offset 증가 ↓
ToC headermagic · serial · flags
ToC entry × NUUID · offset_address · size
null UUID 종료 entryToC 목록의 끝 · payload보다 앞
정렬 간격 + payload들각 entry가 가리키는 file offset에 기록
파일 끝마지막 offset은 정렬될 수 있음

원본 코드

아래 코드는 Trusted Firmware-A LTS 2.14.3의 Makefile에서 1189-1277줄을 그대로 가져온 것이다.

commitf5e765a3443fe21154aa908228e75ee2600085f6anchor · L1213fip: ${BUILD_PLAT}/${FIP_NAME}
1189endif #(GENERATE_COT)
1190
1191ifneq (${GENERATE_COT},0)
1192bl2_certificates: ${BUILD_PLAT}/${FIP_NAME} ${BL2_CRT_DEPS} ${CRTTOOL} | ${BUILD_PLAT}/
1193	$(q)${CRTTOOL} ${BL2_CRT_ARGS}
1194	$(s)echo
1195	$(s)echo "Built $@ successfully"
1196	$(s)echo "BL2 certificates can be found in ${BUILD_PLAT}"
1197	$(s)echo
1198endif #(GENERATE_COT)
1199
1200${BUILD_PLAT}/${FWU_FIP_NAME}: ${FWU_FIP_DEPS} ${FIPTOOL} | $$(@D)/
1201	$(eval ${CHECK_FWU_FIP_CMD})
1202	$(q)${FIPTOOL} create ${FWU_FIP_ARGS} $@
1203	$(q)${FIPTOOL} info $@
1204	$(s)echo
1205	$(s)echo "Built $@ successfully"
1206	$(s)echo
1207
1208fiptool: ${FIPTOOL}
1209ifeq (${SEPARATE_BL2_FIP},1)
1210bl2_fip: ${BUILD_PLAT}/${BL2_FIP_NAME}
1211fip: bl2_fip
1212else
1213fip: ${BUILD_PLAT}/${FIP_NAME}
1214endif #(SEPARATE_BL2_FIP)
1215fwu_fip: ${BUILD_PLAT}/${FWU_FIP_NAME}
1216
1217# symlink for compatibility before tools were in the build directory
1218${FIPTOOL}: FORCE | $$(@D)/
1219	$(q)${MAKE} PLAT=${PLAT} BUILD_PLAT=$(abspath ${BUILD_PLAT}) CPPFLAGS="-DVERSION='\"${VERSION_STRING}\"'" OPENSSL_DIR=${OPENSSL_DIR} DEBUG=${DEBUG} --no-print-directory -C ${FIPTOOLPATH} all
1220	$(q)ln -sf ${FIPTOOL} ${FIPTOOLPATH}/fiptool
1221
1222$(BUILD_PLAT)/romlib/romlib.bin $(BUILD_PLAT)/lib/libwrappers.a $&: $(BUILD_PLAT)/lib/libfdt.a $(BUILD_PLAT)/lib/libc.a $(CRYPTO_LIB) | $$(@D)/
1223	$(q)${MAKE} PLAT_DIR=${PLAT_DIR} BUILD_PLAT=${BUILD_PLAT} ENABLE_BTI=${ENABLE_BTI} CRYPTO_LIB=$(CRYPTO_LIB) ARM_ARCH_MINOR=${ARM_ARCH_MINOR} INCLUDES=$(call escape-shell,$(INCLUDES)) DEFINES=$(call escape-shell,$(DEFINES)) --no-print-directory -C ${ROMLIBPATH} all
1224
1225memmap: all
1226	$(if $(host-poetry),$(q)poetry -q install --no-root)
1227	$(q)$(if $(host-poetry),poetry run )memory --root ${BUILD_PLAT} symbols
1228
1229tl: ${BUILD_PLAT}/tl.bin
1230${BUILD_PLAT}/tl.bin: ${HW_CONFIG} | $$(@D)/
1231	$(if $(host-poetry),$(q)poetry -q install --no-root)
1232	$(q)$(if $(host-poetry),poetry run )tlc create --fdt $< -s ${FW_HANDOFF_SIZE} $@
1233
1234doc:
1235	$(s)echo "  BUILD DOCUMENTATION"
1236	$(if $(host-poetry),$(q)poetry -q install --with docs --no-root)
1237	$(q)$(if $(host-poetry),poetry run )${MAKE} --no-print-directory -C ${DOCS_PATH} BUILDDIR=$(abspath ${BUILD_BASE}/docs) html
1238
1239enctool: ${ENCTOOL}
1240
1241${ENCTOOL}: FORCE | $$(@D)/
1242	$(q)${MAKE} PLAT=${PLAT} BUILD_PLAT=$(abspath ${BUILD_PLAT}) BUILD_INFO=0 OPENSSL_DIR=${OPENSSL_DIR} DEBUG=${DEBUG} --no-print-directory -C ${ENCTOOLPATH} all
1243	$(s)echo
1244	$(s)echo "Built $@ successfully"
1245	$(s)echo
1246
1247cscope:
1248	$(s)echo "  CSCOPE"
1249	$(q)find ${CURDIR} -name "*.[chsS]" > cscope.files
1250	$(q)cscope -b -q -k
1251
1252help:
1253	$(s)echo "usage: ${MAKE} [PLAT=<platform>] [OPTIONS] [TARGET]"
1254	$(s)echo ""
1255	$(s)echo "PLAT is used to specify which platform you wish to build."
1256	$(s)echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}"
1257	$(s)echo ""
1258	$(s)echo "platform = ${PLATFORM_LIST}"
1259	$(s)echo ""
1260	$(s)echo "Please refer to the User Guide for a list of all supported options."
1261	$(s)echo "Note that the build system doesn't track dependencies for build "
1262	$(s)echo "options. Therefore, if any of the build options are changed "
1263	$(s)echo "from a previous build, a clean build must be performed."
1264	$(s)echo ""
1265	$(s)echo "Supported Targets:"
1266	$(s)echo "  all            Build all individual bootloader binaries"
1267	$(s)echo "  bl1            Build the BL1 binary"
1268	$(s)echo "  bl2            Build the BL2 binary"
1269	$(s)echo "  bl2u           Build the BL2U binary"
1270	$(s)echo "  bl31           Build the BL31 binary"
1271	$(s)echo "  bl32           Build the BL32 binary. If ARCH=aarch32, then "
1272	$(s)echo "                 this builds secure payload specified by AARCH32_SP"
1273	$(s)echo "  certificates   Build the certificates (requires 'GENERATE_COT=1')"
1274	$(s)echo "  fip            Build the Firmware Image Package (FIP)"
1275	$(s)echo "  fwu_fip        Build the FWU Firmware Image Package (FIP)"
1276	$(s)echo "  checkcodebase  Check the coding style of the entire source tree"
1277	$(s)echo "  checkpatch     Check the coding style on changes in the current"

발췌 범위와 읽기 기준

원문 1189-1277줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 fip: ${BUILD_PLAT}/${FIP_NAME}은 L1213에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.

파일 이름보다 FIP ToC의 UUID, offset, size와 각 image의 load address를 함께 본다. BL32와 BL33은 FIP 안의 순서가 아니라 image descriptor와 security state로 구분된다.

함께 읽어야 하는 원본 코드

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

01. fiptool이 ToC와 payload를 조립하는 진입점

tools/fiptool/fiptool.c 1231-1289줄이다.

filetools/fiptool/fiptool.canchor · L1243int main(int argc, char *argv[])
1231	printf("\n");
1232	printf("Commands supported:\n");
1233	printf("  info\t\tList images contained in FIP.\n");
1234	printf("  create\tCreate a new FIP with the given images.\n");
1235	printf("  update\tUpdate an existing FIP with the given images.\n");
1236	printf("  unpack\tUnpack images from FIP.\n");
1237	printf("  remove\tRemove images from FIP.\n");
1238	printf("  version\tShow fiptool version.\n");
1239	printf("  help\t\tShow help for given command.\n");
1240	exit(EXIT_SUCCESS);
1241}
1242
1243int main(int argc, char *argv[])
1244{
1245	int i, ret = 0;
1246
1247	while (1) {
1248		int c, opt_index = 0;
1249		static struct option opts[] = {
1250			{ "verbose", no_argument, NULL, 'v' },
1251			{ NULL, no_argument, NULL, 0 }
1252		};
1253
1254		/*
1255		 * Set POSIX mode so getopt stops at the first non-option
1256		 * which is the subcommand.
1257		 */
1258		c = getopt_long(argc, argv, "+v", opts, &opt_index);
1259		if (c == -1)
1260			break;
1261
1262		switch (c) {
1263		case 'v':
1264			verbose = 1;
1265			break;
1266		default:
1267			usage();
1268		}
1269	}
1270	argc -= optind;
1271	argv += optind;
1272	/* Reset optind for subsequent getopt processing. */
1273	optind = 0;
1274
1275	if (argc == 0)
1276		usage();
1277
1278	fill_image_descs();
1279	for (i = 0; i < NELEM(cmds); i++) {
1280		if (strcmp(cmds[i].name, argv[0]) == 0) {
1281			ret = cmds[i].handler(argc, argv);
1282			break;
1283		}
1284	}
1285	if (i == NELEM(cmds))
1286		usage();
1287	free_image_descs();
1288	return ret;
1289}

02. ToC offset을 계산하고 FIP payload를 기록하는 함수

tools/fiptool/fiptool.c 521-633줄이다.

filetools/fiptool/fiptool.canchor · L531static int pack_images(const char *filename
521
522	return 0;
523}
524
525static void info_usage(int exit_status)
526{
527	printf("fiptool info FIP_FILENAME\n");
528	exit(exit_status);
529}
530
531static int pack_images(const char *filename, uint64_t toc_flags, unsigned long align)
532{
533	FILE *fp;
534	image_desc_t *desc;
535	fip_toc_header_t *toc_header;
536	fip_toc_entry_t *toc_entry;
537	char *buf;
538	uint64_t entry_offset, buf_size, payload_size = 0, pad_size;
539	size_t nr_images = 0;
540
541	for (desc = image_desc_head; desc != NULL; desc = desc->next)
542		if (desc->image != NULL)
543			nr_images++;
544
545	buf_size = sizeof(fip_toc_header_t) +
546	    sizeof(fip_toc_entry_t) * (nr_images + 1);
547	buf = calloc(1, buf_size);
548	if (buf == NULL)
549		log_err("calloc");
550
551	/* Build up header and ToC entries from the image table. */
552	toc_header = (fip_toc_header_t *)buf;
553	toc_header->name = TOC_HEADER_NAME;
554	toc_header->serial_number = TOC_HEADER_SERIAL_NUMBER;
555	toc_header->flags = toc_flags;
556
557	toc_entry = (fip_toc_entry_t *)(toc_header + 1);
558
559	entry_offset = buf_size;
560	for (desc = image_desc_head; desc != NULL; desc = desc->next) {
561		image_t *image = desc->image;
562
563		if (image == NULL || (image->toc_e.size == 0ULL))
564			continue;
565		payload_size += image->toc_e.size;
566		entry_offset = (entry_offset + align - 1) & ~(align - 1);
567		image->toc_e.offset_address = entry_offset;
568		*toc_entry++ = image->toc_e;
569		entry_offset += image->toc_e.size;
570	}
571
572	/*
573	 * Append a null uuid entry to mark the end of ToC entries.
574	 * NOTE the offset address for the last toc_entry must match the fip
575	 * size.
576	 */
577	memset(toc_entry, 0, sizeof(*toc_entry));
578	toc_entry->offset_address = (entry_offset + align - 1) & ~(align - 1);
579
580	/* Generate the FIP file. */
581	fp = fopen(filename, "wb");
582	if (fp == NULL)
583		log_err("fopen %s", filename);
584
585	if (verbose)
586		log_dbgx("Metadata size: %zu bytes", buf_size);
587
588	xfwrite(buf, buf_size, fp, filename);
589
590	if (verbose)
591		log_dbgx("Payload size: %zu bytes", payload_size);
592
593	for (desc = image_desc_head; desc != NULL; desc = desc->next) {
594		image_t *image = desc->image;
595
596		if (image == NULL)
597			continue;
598		if (fseek(fp, image->toc_e.offset_address, SEEK_SET))
599			log_errx("Failed to set file position");
600
601		xfwrite(image->buffer, image->toc_e.size, fp, filename);
602	}
603
604	if (fseek(fp, entry_offset, SEEK_SET))
605		log_errx("Failed to set file position");
606
607	pad_size = toc_entry->offset_address - entry_offset;
608	while (pad_size--)
609		fputc(0x0, fp);
610
611	free(buf);
612	fclose(fp);
613	return 0;
614}
615
616/*
617 * This function is shared between the create and update subcommands.
618 * The difference between the two subcommands is that when the FIP file
619 * is created, the parsing of an existing FIP is skipped.  This results
620 * in update_fip() creating the new FIP file from scratch because the
621 * internal image table is not populated.
622 */
623static void update_fip(void)
624{
625	image_desc_t *desc;
626
627	/* Add or replace images in the FIP file. */
628	for (desc = image_desc_head; desc != NULL; desc = desc->next) {
629		image_t *image;
630
631		if (desc->action != DO_PACK)
632			continue;
633

호스트의 패키징과 보드의 적재를 구분합니다

fiptool은 개발 PC에서 입력 파일을 읽고 FIP를 쓰는 호스트 프로그램입니다. BL31의 EL3 실행 코드나 부트 단계 사이의 분기 함수가 아닙니다. 패키징 때 계산한 값은 FIP 파일 안의 바이트 offset이며, 보드에서 사용할 적재 주소·실행 주소는 플랫폼 이미지 정책과 ELF에서 따로 확인합니다.

pack_images()는 입력 descriptor를 세어 metadata buffer를 할당하고 헤더·ToC entry·종료 entry를 채웁니다. 이 buffer를 먼저 파일에 기록한 뒤 각 payload offset으로 이동해 내용을 씁니다. 보드의 interrupt, MMU, USB callback 또는 scheduler 상태를 이 호스트 함수의 전제로 넣지 않습니다.

빌드로 얻은 ELF에는 주소와 section 정보가 있지만 raw binary와 FIP에는 같은 형태의 ELF symbol table이 없습니다. FIP 구조는 fiptool info로, 대상 이미지 주소는 해당 ELF의 program header로 각각 확인합니다.

인증 설정과 파일 경계를 따로 확인합니다

GENERATE_COT != 0이면 Makefile의 FIP 의존성에 certificates가 들어가고 cert_create가 인증서 파일을 만듭니다. 이 옵션을 플랫폼 CoT C 소스를 생성하는 설정으로 해석하지 않습니다. TRUSTED_BOARD_BOOT로 인증 코드를 포함하는 일과 인증서 파일 생성은 구분해야 합니다.

BL32·BL33은 플랫폼의 필요 여부와 외부 파일·소스 설정에 따라 달라집니다. 특히 EL3_PAYLOAD_BASE나 PRELOADED_BL33_BASE 조건에서는 FIP에 BL33을 넣지 않을 수 있습니다. BL1 산출물을 만들었다고 BL1이 이 FIP의 필수 payload라는 뜻도 아닙니다.

UUID·offset·size는 파일의 어느 payload를 읽을지 정하는 값입니다. 인증 성공이나 제품 신뢰 루트의 설정을 증명하지 않습니다. 키와 인증서의 관계는 아래의 개발용 키 경계와 별도 인증 글에서 확인합니다.

파일 offset과 보드 주소의 계약

TF-A 빌드는 실행 파일 하나를 만드는 작업이 아니다. BL1, BL2, BL31은 서로 다른 링크 주소와 메모리 요구 조건을 가진 독립 이미지이며, BL32와 BL33은 외부 프로젝트의 산출물일 수도 있다. 최종 FIP는 이 파일들을 이름 순서로 이어 붙이는 archive가 아니라 UUID로 식별되는 ToC와 payload 구간을 가진 boot package다.

분석할 때는 ELF의 VMA/LMA, ELF에서 추출한 raw binary의 크기, FIP ToC가 가리키는 offset, BL2의 image policy가 지정한 destination을 네 개의 열로 놓고 대조한다. 이 값 중 하나라도 다른 build tree의 산출물에서 왔다면 fiptool은 정상 package를 만들더라도 target은 잘못된 주소에서 실패한다.

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

모든 하위 make와 tool invocation에 같은 값이 전달돼야 한다.

02ELF program header

p_paddr, p_vaddr, filesz, memsz, flags를 기록한다.

03인증 입력

인증서 생성에 필요한 키와 counter 값을 선택한 CoT에 맞게 제공한다.

04FIP ToC

각 entry 범위가 파일 길이 안에 있고 서로 겹치지 않아야 한다.

05외부 payload

파일 이름이 아니라 UUID와 image ID 대응을 확인한다.

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

빌드 입력과 적재 메모리 계약

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

#입력 상태생산자정상 조건확인 이유
01Make 변수PLAT, ARCH, DEBUG, SPD, BL32, BL33모든 하위 make와 tool invocation에 같은 값이 전달돼야 한다.stage별 ABI와 포함 payload를 결정한다.
02ELF program headerbl1.elf, bl2.elf, bl31.elf의 LOAD segmentp_paddr, p_vaddr, filesz, memsz, flags를 기록한다.raw binary에는 ELF의 주소 정보가 남지 않기 때문이다.
03인증 입력ROT_KEY, TRUSTED_WORLD_KEY, NON_TRUSTED_WORLD_KEY와 certificate인증서 생성에 필요한 키와 counter 값을 선택한 CoT에 맞게 제공한다.FIP에 payload만 있고 certificate가 없으면 BL2 인증이 막힌다.
04FIP ToCheader magic, serial_number, entry UUID/offset/size각 entry 범위가 파일 길이 안에 있고 서로 겹치지 않아야 한다.FIP 내부 상대 위치다. 실제 storage 주소는 backend와 함께 결정한다.
05외부 payloadBL32 OP-TEE, BL33 U-Boot/UEFI파일 이름이 아니라 UUID와 image ID 대응을 확인한다.동일한 파일명을 사용해도 security state는 descriptor가 결정한다.

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

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

#객체 또는 필드생산자소비자수명과 불변 조건
01fip_toc_header.namefiptool createio_fip_dev_initFIP magic으로 parser 대상을 판별하며 storage에 기록된 동안 유지된다.
02fip_toc_header.serial_numberfiptoolplatform update/diagnostic codepayload 무결성 자체를 보장하는 값은 아니며 package 식별 용도로 구분한다.
03fip_toc_entry.uuidUUID registry와 fiptoolFIP I/O policyimage ID와 간접 연결되므로 중복·잘못된 UUID를 허용하면 안 된다.
04fip_toc_entry.offset_address/sizefiptool layout 계산FIP reader의 payload 읽기FIP 파일의 byte 단위 exclusive 범위로 사용되며 overflow 검사가 필요하다.
05BL image raw binaryobjcopy와 external buildfiptool과 BL2 loaderpackage 생성부터 destination에 완전히 복사될 때까지 byte 내용이 동일해야 한다.
06certificate payloadcert_createauth module해당 child image를 인증할 때까지 유효하며 서명 대상 hash와 payload hash가 연결돼야 한다.

함수 내부 실행 순서

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

  1. 01

    platform makefile과 common build option을 합쳐 각 BL stage의 source, linker script, define을 확정한다.

  2. 02

    각 stage를 ELF로 link한 뒤 map과 program header에서 실행 주소, RW/BSS 범위, entry symbol을 확인한다.

  3. 03

    ELF의 loadable byte를 raw binary로 추출하되 BSS처럼 파일에 없는 memsz 구간과 혼동하지 않는다.

  4. 04

    GENERATE_COT가 0이 아니면 선택한 CoT에 맞는 인증서 생성 타깃을 실행한다. 런타임 인증 코드 포함과 구분한다.

  5. 05

    FIP payload 목록을 UUID 단위로 만들고 alignment를 적용해 각 offset과 size를 계산한다.

  6. 06

    ToC header와 entry 배열, terminator를 쓴 뒤 계산된 offset에 payload를 배치한다.

  7. 07

    fiptool info와 unpack 결과를 원본 binary의 hash·크기와 비교해 package 입력이 바뀌지 않았는지 확인한다.

  8. 08

    BL2 image policy의 UUID, image ID, load address를 FIP 결과와 대조하고 실제 storage backend에서 한 번 읽어 본다.

  9. 09

    배포 파일에는 fip.bin뿐 아니라 재현 가능한 config, commit, key 종류, ELF/map hash를 함께 기록한다.

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

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

#설정바뀌는 동작확인 방법
01TRUSTED_BOARD_BOOTcertificate와 인증 descriptor 경로를 포함한다.cert_create command와 FIP certificate UUID를 확인한다.
02GENERATE_COT0이 아니면 certificates 타깃을 FIP 의존성에 넣어 인증서 파일을 생성한다.cert_create 명령과 생성된 인증서 파일의 입력·UUID를 확인한다.
03SPD=opteed / BL32BL32 payload와 OP-TEE dispatcher를 BL31에 연결한다.FIP의 BL32 UUID와 bl31 map의 opteed symbol을 함께 본다.
04BL33Normal World firmware 파일을 FIP에 넣는다.BL33 UUID의 unpack hash와 U-Boot/UEFI 원본 hash를 비교한다.
05DEBUG=1assert, verbose log, debug ELF 경로가 달라진다.release FIP에 debug BL image가 섞이지 않았는지 build path를 기록한다.

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

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

#관찰 증상중단 위치기록할 값판정
01fiptool info는 정상인데 BL2가 image를 못 찾음plat_get_image_source와 io_open 직전image ID, UUID, backend handleFIP package보다 platform policy의 UUID 대응을 먼저 의심한다.
02BL31 진입 직후 instruction abortBL2 copy 완료와 BL31 entryELF p_paddr, destination, PC, first 32 bytes다른 platform ELF 또는 잘못된 load address가 package에 들어갔는지 판정한다.
03인증서 검증만 실패Generic code의 parent 탐색과 auth_mod_verify_img의 method 검사certificate UUID, key OID, payload hashkey 종류 또는 certificate-payload 조합 불일치를 찾는다.
04BL32만 초기화되지 않음BL2 descriptor walk와 BL31 SPD setupBL32 image_info base/size, ep_info.pcBL32 누락, size 0, SPD/BL32 build option 불일치를 구분한다.

객체와 수명

대상만들어지는 시점유효 범위확인할 조건
선택된 BL image·외부 payload각 image build 또는 입력 파일 선택FIP 생성 시 해당 UUID에 연결없는 입력을 필수 payload로 가정하지 않음
조건부 certificateGENERATE_COT 경로에서 생성선택한 CoT의 FIP 입력BL33을 생산하는 단계가 아님
fip_toc_headerpack_images()의 metadata bufferfip.bin 맨 앞magic·serial·flags 기록
fip_toc_entry와 null entry존재하는 image descriptor 순회 뒤 종료 entry 추가header 직후, payload보다 앞UUID·offset·size가 payload를 가리킴
payload bytes각 선택 입력 이미지계산된 파일 offset의 구간alignment gap과 파일 크기를 확인

생성 실패와 보드 적재 실패를 나눕니다

관찰확인 위치구분할 값
필요한 payload 파일 없음Makefile의 NEED_BL 설정과 FIP 의존성입력 경로, 플랫폼·SPD 설정, 빌드 결과
잘못된 이미지가 포함됨fiptool info와 unpack 결과UUID, 크기, 원본과 추출 파일의 해시
인증서와 이미지 불일치인증서 생성 입력과 BL1/BL2 인증 반환값같은 빌드의 키 종류·인증서·payload 조합
FIP는 읽히지만 대상 코드 실행 실패플랫폼 적재 정책과 해당 ELFimage ID, destination, entry PC, 메모리 요구

FIP 파일 생성과 실제 보드의 적재·인증·실행은 서로 다른 검사입니다. 파일 크기나 도구의 성공 출력만으로 뒤의 단계까지 통과했다고 판단하지 않습니다.

파일 형식에 맞는 도구로 대조합니다

목적명령 또는 자료판정 범위
재현 조건make PLAT=<platform> DEBUG=1 all fip선택한 플랫폼·payload·인증 옵션의 전체 명령과 입력 해시를 기록합니다.
FIP 내용tools/fiptool/fiptool info build/<platform>/debug/fip.bin포함된 UUID·offset·size를 확인합니다. 입력에 없는 BL 이미지를 요구하지 않습니다.
이미지 주소${CROSS_COMPILE}readelf -lW build/<platform>/debug/bl31/bl31.elf해당 이미지가 있는 빌드에서 LOAD segment의 주소·파일 크기·메모리 크기를 확인합니다.
호스트 함수tools/fiptool/fiptool.c:pack_images()호스트 실행 파일의 코드입니다. BL31 ELF에서 이 함수의 심볼을 찾지 않습니다.
실제 보드BL1/BL2 적재·인증 로그와 플랫폼 이미지 정책저장소·image ID·적재 주소를 파일 검사와 별도로 대조합니다.

패키지 입력과 출력의 일치를 확인합니다

  1. 같은 빌드의 원본 payload 크기·해시와 FIP 목록을 기록합니다. 필요한 인증서를 같은 입력으로 생성했는지 확인합니다.
  2. 별도 빈 출력 위치에 fiptool unpack 결과를 얻고 원본과 비교합니다. 기존 원본 파일을 덮어쓰지 않습니다.
  3. 한 payload를 바꾼 시험 FIP의 UUID·크기·offset과 인증서 의존성을 대조합니다. 파일 차이가 보였다는 사실을 보드 실행 성공으로 기록하지 않습니다.

이 글은 호스트 파일 검토 방법을 설명합니다. 제품 키 생성·주입, 보드 펌웨어 실행과 파괴적인 변조 시험을 수행한 결과는 아닙니다.

FIP 생성 성공은 제품의 신뢰 루트 설정이 아닙니다

이 글의 LTS 2.14.3 Makefile·fiptool 발췌는 인증서 생성 조건과 패키지 구성을 보여 줍니다. 조회 시 2.15.0으로 표시된 Trusted Board Boot 빌드 문서의 TRUSTED_BOARD_BOOT=1, GENERATE_COT=1 예제는 별도 버전의 개발 절차입니다. 옵션 두 개나 fiptool info 성공만으로 실제 제품의 키 주입·보호·폐기 정책을 검증할 수 없습니다.

문서 예제의 ARM_ROTPK_LOCATION=devel_rsa는 개발용 ROTPK hash를 사용하며 ROT_KEY를 생략하면 기본 개발 키가 사용됩니다. 이 예제를 제품 키 설정으로 복사하지 않습니다. 개인 키의 소유·보관 경계와 보드가 신뢰할 ROTPK 또는 hash의 보호된 저장 위치를 따로 정해야 합니다. self-signed 인증서를 만들었다는 사실도 그 키를 하드웨어가 신뢰한다는 증거는 아닙니다. Trusted Board Boot 빌드 예제 · Chain of Trust와 신뢰 루트

QEMU의 semihosting·flash 배치 예제와 Juno/FVP의 FWU 절차는 해당 플랫폼 조건에서만 읽습니다. 이 검토에서는 키 생성·provisioning·펌웨어 실행을 하지 않았으며 기존 공개 키나 개인 키를 수집·게시하지 않았습니다. QEMU 플랫폼 문서

LTS 태그와 제품 유지보수 책임을 구분합니다

이 글의 발췌는 LTS 2.14.3 커밋에 고정되어 있습니다. 반면 TF-A의 LTS 유지보수 정책은 움직이는 문서입니다. 2026-10-26 확인 본문은 긴 지원 목표와 별도의 요약 문단에서 서로 다른 기간을 사용하므로, 그 숫자를 특정 제품의 종료일이나 보증 기간으로 옮기지 않습니다. 실제 적용 브랜치의 공지와 유지보수 약속을 따로 확인해야 합니다.

LTS는 새 기능을 계속 가져오는 브랜치가 아닙니다. 보안 공지·CPU errata·기존 기능의 버그 수정처럼 선정 조건을 충족한 변경을 검토해 backport합니다. 일반적으로 mainline에 먼저 반영한 뒤 LTS 적용을 검토하며, 플랫폼 전용 수정은 해당 플랫폼 유지보수자의 검토가 필요합니다. 같은 수정 이름이라도 제품 분기의 설정·의존 코드가 다르면 충돌 없이 적용됐다는 사실만으로 안전성을 판정할 수 없습니다.

산출물 기록에는 기반 커밋, 적용한 보안 수정, 플랫폼 설정, TFTF의 대응 브랜치, 회귀 검사와 보드 시험 범위를 함께 남깁니다. 공통 CI·정적 검사·참조 플랫폼의 통과는 제품 보드 전체의 실행 증명이 아닙니다. 이 글은 유지보수 검토 기준이며 새 펌웨어를 빌드하거나 대상 기기에서 시험한 결과는 아닙니다.

길이가 0인 입력의 한계

고정 pack_images()는 metadata 크기를 셀 때 이미지 포인터 존재를 검사하지만, ToC entry를 채울 때는 image->toc_e.size == 0인 입력도 건너뜁니다. 따라서 모든 존재하는 입력에 유효한 entry가 생긴다고 일반화하지 않습니다. 정상 패키지 검토에서는 필요한 payload의 크기와 추출 결과를 직접 확인합니다.

원문과 다음 글