QUESTION
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 계약을 사용해야 한다. 이 문장을 기준으로 코드를 위에서 아래로 읽으면, 함수 이름을 외우는 대신 어느 시점에 어떤 상태를 신뢰할 수 있는지 판단할 수 있다.
STRUCTURE
빌드 입력과 FIP 메타데이터의 경계
Makefile의 이미지 선택과 인증 설정이 FIP 입력을 정한다. fiptool은 존재하는 입력의 UUID entry와 offset을 만든 뒤 메타데이터와 payload를 기록한다. 이 칸들은 BL1→BL2→BL31 실행 순서가 아니다.
CALL PATH
FIP 생성 의존성
인증서 생성은 GENERATE_COT 설정에 따른 분기이며 BL33을 생산하지 않는다. BL32·BL33도 플랫폼과 입력 설정에 따라 포함된다. fiptool은 선택된 이미지와 인증서를 UUID별로 묶는다.
STATE LEDGER
단계별 입력과 출력
고정 LTS 2.14.3의 Makefile과 pack_images()가 실제로 생산·소비하는 값을 구분한다.
| # | 규칙/함수 | 입력 | 결과 | 다음 소비자/조건 |
|---|---|---|---|---|
| 01 | Makefile image rules | 플랫폼·BL2/BL31/BL32/BL33 설정과 기존 이미지 | 선택된 BL binary와 FIP_ARGS | 필요한 이미지별 build 또는 외부 입력; BL32/BL33 조건부 |
| 02 | certificates | CoT 설정·선택된 이미지 | 필요한 인증서 파일 | GENERATE_COT != 0일 때 FIP 의존성; BL33 생성 아님 |
| 03 | fiptool create | FIP_DEPS, FIP_ARGS와 UUID별 payload | 이미지별 fip_toc_entry의 offset·size | 입력이 없는 이미지에는 entry가 생기지 않음 |
| 04 | pack_images() metadata | entry 개수와 alignment | header + 모든 ToC entry + null UUID 종료 entry | 메타데이터를 한 번에 먼저 파일에 기록 |
| 05 | pack_images() payload | 각 entry의 offset·size와 payload bytes | fip.bin의 정렬된 payload 구간 | 각 offset으로 seek한 뒤 기록; fiptool info로 확인 |
분석 범위의 전제와 비교하되, BL 단계 간 실행 순서와 host의 FIP 생성 규칙을 섞지 않는다.
VISUAL WALKTHROUGH
FIP 파일의 ToC와 payload 배치를 읽기
아래 그림의 축은 보드 메모리 주소가 아니라 fip.bin 안의 byte offset이다. 실제 목록과 크기는 해당 빌드의 fiptool info와 파일 길이로 확인한다.
host 빌드 단계의 의존성이다. 인증서와 BL32/BL33은 설정에 따라 달라진다.
고정 fiptool.c:pack_images()의 기록 순서다. payload의 종류와 개수는 입력 옵션에 따른다.
UPSTREAM SOURCE
원본 코드
아래 코드는 Trusted Firmware-A LTS 2.14.3의 Makefile에서 1189-1277줄을 그대로 가져온 것이다.
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"
READING CONTRACT
발췌 범위와 읽기 기준
원문 1189-1277줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 fip: ${BUILD_PLAT}/${FIP_NAME}은 L1213에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.
파일 이름보다 FIP ToC의 UUID, offset, size와 각 image의 load address를 함께 본다. BL32와 BL33은 FIP 안의 순서가 아니라 image descriptor와 security state로 구분된다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. fiptool이 ToC와 payload를 조립하는 진입점
tools/fiptool/fiptool.c 1231-1289줄이다.
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줄이다.
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
DETAILS
호스트의 패키징과 보드의 적재를 구분합니다
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로 각각 확인합니다.
IMPLEMENTATION NOTES
인증 설정과 파일 경계를 따로 확인합니다
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를 읽을지 정하는 값입니다. 인증 성공이나 제품 신뢰 루트의 설정을 증명하지 않습니다. 키와 인증서의 관계는 아래의 개발용 키 경계와 별도 인증 글에서 확인합니다.
DEEP ANALYSIS
파일 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은 잘못된 주소에서 실패한다.
모든 하위 make와 tool invocation에 같은 값이 전달돼야 한다.
p_paddr, p_vaddr, filesz, memsz, flags를 기록한다.
인증서 생성에 필요한 키와 counter 값을 선택한 CoT에 맞게 제공한다.
각 entry 범위가 파일 길이 안에 있고 서로 겹치지 않아야 한다.
파일 이름이 아니라 UUID와 image ID 대응을 확인한다.
각 계약은 앞 단계가 생산하고 현재 단계가 검증한 뒤 다음 소비자에게 넘기는 상태다. 한 항목이라도 확인되지 않으면 뒤 단계의 fault를 그 지점의 문제로 단정하지 않는다.
빌드 입력과 적재 메모리 계약
함수 첫 줄에 도달했을 때 이미 참이라고 가정하는 값과, 그 값이 틀렸을 때 영향을 받는 범위를 함께 적었다.
| # | 입력 상태 | 생산자 | 정상 조건 | 확인 이유 |
|---|---|---|---|---|
| 01 | Make 변수 | PLAT, ARCH, DEBUG, SPD, BL32, BL33 | 모든 하위 make와 tool invocation에 같은 값이 전달돼야 한다. | stage별 ABI와 포함 payload를 결정한다. |
| 02 | ELF program header | bl1.elf, bl2.elf, bl31.elf의 LOAD segment | p_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 인증이 막힌다. |
| 04 | FIP ToC | header magic, serial_number, entry UUID/offset/size | 각 entry 범위가 파일 길이 안에 있고 서로 겹치지 않아야 한다. | FIP 내부 상대 위치다. 실제 storage 주소는 backend와 함께 결정한다. |
| 05 | 외부 payload | BL32 OP-TEE, BL33 U-Boot/UEFI | 파일 이름이 아니라 UUID와 image ID 대응을 확인한다. | 동일한 파일명을 사용해도 security state는 descriptor가 결정한다. |
핵심 구조체 필드의 생산자, 소비자와 수명
구조체 이름만 나열하지 않고 어떤 코드가 값을 쓰고, 어느 코드가 처음 읽으며, 언제까지 주소와 내용이 유지되어야 하는지 구분했다.
| # | 객체 또는 필드 | 생산자 | 소비자 | 수명과 불변 조건 |
|---|---|---|---|---|
| 01 | fip_toc_header.name | fiptool create | io_fip_dev_init | FIP magic으로 parser 대상을 판별하며 storage에 기록된 동안 유지된다. |
| 02 | fip_toc_header.serial_number | fiptool | platform update/diagnostic code | payload 무결성 자체를 보장하는 값은 아니며 package 식별 용도로 구분한다. |
| 03 | fip_toc_entry.uuid | UUID registry와 fiptool | FIP I/O policy | image ID와 간접 연결되므로 중복·잘못된 UUID를 허용하면 안 된다. |
| 04 | fip_toc_entry.offset_address/size | fiptool layout 계산 | FIP reader의 payload 읽기 | FIP 파일의 byte 단위 exclusive 범위로 사용되며 overflow 검사가 필요하다. |
| 05 | BL image raw binary | objcopy와 external build | fiptool과 BL2 loader | package 생성부터 destination에 완전히 복사될 때까지 byte 내용이 동일해야 한다. |
| 06 | certificate payload | cert_create | auth module | 해당 child image를 인증할 때까지 유효하며 서명 대상 hash와 payload hash가 연결돼야 한다. |
함수 내부 실행 순서
소스의 큰 분기와 side effect를 실행 순서대로 다시 펼쳤다. breakpoint는 이 목록의 경계에 두고, 다음 번호로 넘어갈 때 새로 유효해진 객체를 기록한다.
- 01
platform makefile과 common build option을 합쳐 각 BL stage의 source, linker script, define을 확정한다.
- 02
각 stage를 ELF로 link한 뒤 map과 program header에서 실행 주소, RW/BSS 범위, entry symbol을 확인한다.
- 03
ELF의 loadable byte를 raw binary로 추출하되 BSS처럼 파일에 없는 memsz 구간과 혼동하지 않는다.
- 04
GENERATE_COT가 0이 아니면 선택한 CoT에 맞는 인증서 생성 타깃을 실행한다. 런타임 인증 코드 포함과 구분한다.
- 05
FIP payload 목록을 UUID 단위로 만들고 alignment를 적용해 각 offset과 size를 계산한다.
- 06
ToC header와 entry 배열, terminator를 쓴 뒤 계산된 offset에 payload를 배치한다.
- 07
fiptool info와 unpack 결과를 원본 binary의 hash·크기와 비교해 package 입력이 바뀌지 않았는지 확인한다.
- 08
BL2 image policy의 UUID, image ID, load address를 FIP 결과와 대조하고 실제 storage backend에서 한 번 읽어 본다.
- 09
배포 파일에는 fip.bin뿐 아니라 재현 가능한 config, commit, key 종류, ELF/map hash를 함께 기록한다.
빌드 설정이 바꾸는 실제 코드 경로
동일한 함수 이름이라도 아래 설정에 따라 포함되는 source, 구조체 크기, 인자 의미와 failure path가 달라진다.
| # | 설정 | 바뀌는 동작 | 확인 방법 |
|---|---|---|---|
| 01 | TRUSTED_BOARD_BOOT | certificate와 인증 descriptor 경로를 포함한다. | cert_create command와 FIP certificate UUID를 확인한다. |
| 02 | GENERATE_COT | 0이 아니면 certificates 타깃을 FIP 의존성에 넣어 인증서 파일을 생성한다. | cert_create 명령과 생성된 인증서 파일의 입력·UUID를 확인한다. |
| 03 | SPD=opteed / BL32 | BL32 payload와 OP-TEE dispatcher를 BL31에 연결한다. | FIP의 BL32 UUID와 bl31 map의 opteed symbol을 함께 본다. |
| 04 | BL33 | Normal World firmware 파일을 FIP에 넣는다. | BL33 UUID의 unpack hash와 U-Boot/UEFI 원본 hash를 비교한다. |
| 05 | DEBUG=1 | assert, verbose log, debug ELF 경로가 달라진다. | release FIP에 debug BL image가 섞이지 않았는지 build path를 기록한다. |
증상에서 최초 불일치 지점까지 추적하기
마지막 panic 메시지가 아니라 어디에서 멈추고 무엇을 읽어 어떤 결론을 내릴지 정리했다. 정상값과 실패값은 같은 build와 같은 위치에서 비교한다.
| # | 관찰 증상 | 중단 위치 | 기록할 값 | 판정 |
|---|---|---|---|---|
| 01 | fiptool info는 정상인데 BL2가 image를 못 찾음 | plat_get_image_source와 io_open 직전 | image ID, UUID, backend handle | FIP package보다 platform policy의 UUID 대응을 먼저 의심한다. |
| 02 | BL31 진입 직후 instruction abort | BL2 copy 완료와 BL31 entry | ELF 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 hash | key 종류 또는 certificate-payload 조합 불일치를 찾는다. |
| 04 | BL32만 초기화되지 않음 | BL2 descriptor walk와 BL31 SPD setup | BL32 image_info base/size, ep_info.pc | BL32 누락, size 0, SPD/BL32 build option 불일치를 구분한다. |
OBJECT LIFETIME
객체와 수명
| 대상 | 만들어지는 시점 | 유효 범위 | 확인할 조건 |
|---|---|---|---|
| 선택된 BL image·외부 payload | 각 image build 또는 입력 파일 선택 | FIP 생성 시 해당 UUID에 연결 | 없는 입력을 필수 payload로 가정하지 않음 |
| 조건부 certificate | GENERATE_COT 경로에서 생성 | 선택한 CoT의 FIP 입력 | BL33을 생산하는 단계가 아님 |
fip_toc_header | pack_images()의 metadata buffer | fip.bin 맨 앞 | magic·serial·flags 기록 |
fip_toc_entry와 null entry | 존재하는 image descriptor 순회 뒤 종료 entry 추가 | header 직후, payload보다 앞 | UUID·offset·size가 payload를 가리킴 |
| payload bytes | 각 선택 입력 이미지 | 계산된 파일 offset의 구간 | alignment gap과 파일 크기를 확인 |
FAILURE PATH
생성 실패와 보드 적재 실패를 나눕니다
| 관찰 | 확인 위치 | 구분할 값 |
|---|---|---|
| 필요한 payload 파일 없음 | Makefile의 NEED_BL 설정과 FIP 의존성 | 입력 경로, 플랫폼·SPD 설정, 빌드 결과 |
| 잘못된 이미지가 포함됨 | fiptool info와 unpack 결과 | UUID, 크기, 원본과 추출 파일의 해시 |
| 인증서와 이미지 불일치 | 인증서 생성 입력과 BL1/BL2 인증 반환값 | 같은 빌드의 키 종류·인증서·payload 조합 |
| FIP는 읽히지만 대상 코드 실행 실패 | 플랫폼 적재 정책과 해당 ELF | image ID, destination, entry PC, 메모리 요구 |
FIP 파일 생성과 실제 보드의 적재·인증·실행은 서로 다른 검사입니다. 파일 크기나 도구의 성공 출력만으로 뒤의 단계까지 통과했다고 판단하지 않습니다.
EVIDENCE
파일 형식에 맞는 도구로 대조합니다
| 목적 | 명령 또는 자료 | 판정 범위 |
|---|---|---|
| 재현 조건 | 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·적재 주소를 파일 검사와 별도로 대조합니다. |
LAB
패키지 입력과 출력의 일치를 확인합니다
- 같은 빌드의 원본 payload 크기·해시와 FIP 목록을 기록합니다. 필요한 인증서를 같은 입력으로 생성했는지 확인합니다.
- 별도 빈 출력 위치에
fiptool unpack결과를 얻고 원본과 비교합니다. 기존 원본 파일을 덮어쓰지 않습니다. - 한 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의 크기와 추출 결과를 직접 확인합니다.
PRIMARY REFERENCES