U-Boot · source analysis

빌드 산출물과 단계별 이미지

Kconfig와 Makefile의 선택이 u-boot, SPL, TPL, DTB와 결합 이미지로 굳어지는 과정을 정리합니다.

이 글은 U-Boot v2026.07의 고정 Makefile을 읽는 자료입니다. 실제 생성 파일과 부트 매체의 배치는 보드 설정과 패키징 규칙에 따라 달라집니다.

Series
01 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
Makefile:1176-1264 (발췌 범위)

한 번의 빌드에서 어떤 파일이 어떤 조건으로 생기는가?

이 글의 고정 발췌는 Makefile:1176–1264다. 중심인 INPUTS-y += ...는 Make 의존 대상으로 삼을 파일을 나열하는 규칙이지 CPU가 실행하는 순서나 이미지 내부 배치를 뜻하지 않는다.

u-boot ELF에서 raw u-boot-nodtb.bin을 만들고, 설정에 따라 DTB를 합쳐 u-boot.bin을 만든다. SPL/TPL/VPL은 별도 조건부 빌드 산출물이며, binman의 결합 이미지는 또 다른 패키징 단계다.

U-Boot proper의 파일 계보와 DTB 선택지

그림 1. 링크된 ELF와 raw binary 사이의 파생 관계; 아래 세 칸은 조건별 대안

INPUTS-y가 모으는 조건부 대상

그림 2. Make 의존 목록은 여러 산출물을 병렬로 모은다

이름·형식·생성 조건을 분리해서 읽기

아래 파일은 한 이미지의 연속 상태가 아니라 서로 다른 target이다. 특히 INPUTS-y의 항목은 Make 의존 대상이며 저장 위치를 직접 지정하지 않는다.

target형식 / 상위 입력조건읽을 때의 경계
u-boot객체 + 링커 스크립트 → ELFU-Boot proper linkELF section·entry 주소를 가진다
u-boot-nodtb.binu-boot → objcopy rawu-boot.bin의 하위 의존raw 바이트에 ELF 주소 메타데이터 없음
u-boot.binraw copy 또는 DTB/FIT 결합MULTI_DTB_FIT, OF_SEPARATE 등 분기파일명만으로 DTB 포함 여부 단정 불가
spl/u-boot-spl.bin 등별도 stage 빌드의 raw binaryCONFIG_SPL/TPL/VPLproper의 ELF에서 잘라낸 조각이 아님
u-boot.img / 결합 이미지mkimage target / binman 출력선택된 framework·보드 규칙헤더·offset·포함물은 별도로 확인

원본 코드

아래 코드는 U-Boot v2026.07의 Makefile에서 1176-1264줄을 그대로 가져온 것이다.

commitece349ade2973e220f524ce59e59711cc919263fanchor · L1200INPUTS-y += u-boot.srec
1176TPL_SIZE_CHECK =
1177endif
1178
1179ifneq ($(CONFIG_VPL_SIZE_LIMIT),0x0)
1180VPL_SIZE_CHECK = @$(call size_check,$@,$(CONFIG_VPL_SIZE_LIMIT))
1181else
1182VPL_SIZE_CHECK =
1183endif
1184
1185# Statically apply RELA-style relocations (currently arm64 only)
1186# This is useful for arm64 where static relocation needs to be performed on
1187# the raw binary, but certain simulators only accept an ELF file (but don't
1188# do the relocation).
1189ifneq ($(CONFIG_STATIC_RELA),)
1190# $(2) is u-boot ELF, $(3) is u-boot bin, $(4) is text base
1191quiet_cmd_static_rela = RELOC   $@
1192cmd_static_rela = \
1193	tools/relocate-rela $(3) $(2)
1194else
1195quiet_cmd_static_rela =
1196cmd_static_rela =
1197endif
1198
1199# Always append INPUTS so that arch config.mk's can add custom ones
1200INPUTS-y += u-boot.srec u-boot.bin u-boot.sym System.map binary_size_check
1201
1202ifeq ($(CONFIG_SPL_FSL_PBL),y)
1203INPUTS-$(CONFIG_RAMBOOT_PBL) += u-boot-with-spl-pbl.bin
1204else
1205ifneq ($(CONFIG_NXP_ESBC), y)
1206# For Secure Boot The Image needs to be signed and Header must also
1207# be included. So The image has to be built explicitly
1208INPUTS-$(CONFIG_RAMBOOT_PBL) += u-boot.pbl
1209endif
1210endif
1211INPUTS-$(CONFIG_SPL) += spl/u-boot-spl.bin
1212ifeq ($(CONFIG_MX6)$(CONFIG_IMX_HAB), yy)
1213INPUTS-$(CONFIG_SPL_FRAMEWORK) += u-boot-ivt.img
1214else
1215ifeq ($(CONFIG_MX7)$(CONFIG_IMX_HAB), yy)
1216INPUTS-$(CONFIG_SPL_FRAMEWORK) += u-boot-ivt.img
1217else
1218INPUTS-$(CONFIG_SPL_FRAMEWORK) += u-boot.img
1219endif
1220endif
1221INPUTS-$(CONFIG_TPL) += tpl/u-boot-tpl.bin
1222INPUTS-$(CONFIG_VPL) += vpl/u-boot-vpl.bin
1223
1224# Allow omitting the .dtb output if it is not normally used
1225INPUTS-$(CONFIG_OF_SEPARATE) += $(if $(CONFIG_OF_OMIT_DTB),dts/dt.dtb,u-boot.dtb)
1226ifeq ($(CONFIG_SPL_FRAMEWORK),y)
1227INPUTS-$(CONFIG_OF_SEPARATE) += u-boot-dtb.img
1228endif
1229INPUTS-$(CONFIG_SANDBOX) += u-boot.dtb
1230ifneq ($(CONFIG_SPL_TARGET),)
1231INPUTS-$(CONFIG_SPL) += $(CONFIG_SPL_TARGET:"%"=%)
1232endif
1233INPUTS-$(CONFIG_REMAKE_ELF) += u-boot.elf
1234INPUTS-$(CONFIG_SPL_REMAKE_ELF) += spl/u-boot-spl.elf
1235INPUTS-$(CONFIG_EFI_APP) += u-boot-app.efi
1236INPUTS-$(CONFIG_EFI_STUB) += u-boot-payload.efi
1237
1238# Generate this input file for binman
1239ifeq ($(CONFIG_SPL),)
1240ifneq ($(patsubst "%",%,$(CONFIG_MTK_BROM_HEADER_INFO)),)
1241INPUTS-$(CONFIG_ARCH_MEDIATEK) += u-boot-mtk.bin
1242endif
1243endif
1244
1245ifdef CONFIG_FUNCTION_TRACER
1246ifdef CONFIG_FTRACE_MCOUNT_USE_CC
1247  CC_FLAGS_FTRACE	+= -mrecord-mcount
1248  ifdef CONFIG_HAVE_NOP_MCOUNT
1249    ifeq ($(call cc-option-yn, -mnop-mcount),y)
1250      CC_FLAGS_FTRACE	+= -mnop-mcount
1251      CC_FLAGS_USING	+= -DCC_USING_NOP_MCOUNT
1252    endif
1253  endif
1254endif
1255ifdef CONFIG_FTRACE_MCOUNT_USE_OBJTOOL
1256  CC_FLAGS_USING	+= -DCC_USING_NOP_MCOUNT
1257endif
1258ifdef CONFIG_FTRACE_MCOUNT_USE_RECORDMCOUNT
1259  ifdef CONFIG_HAVE_C_RECORDMCOUNT
1260    BUILD_C_RECORDMCOUNT := y
1261    export BUILD_C_RECORDMCOUNT
1262  endif
1263endif
1264ifdef CONFIG_HAVE_FENTRY

발췌 범위와 읽기 기준

고정 Makefile의 1176–1264행은 TPL 크기 검사 분기 중간에서 시작해 ftrace 설정 중간에서 끝난다. 핵심 L1200은 INPUTS-y에 기본 target들을 추가한다. L1211·1221·1222는 SPL/TPL/VPL 옵션별 파일을, L1225–1229는 별도 DTB 조건을 나열한다.

u-boot-nodtb.bin을 만드는 objcopy 규칙(L1643–1645), u-boot.bin의 DTB 분기(L1462–1519), binman 의존·실행(L1392–1399, L1680–1707)은 이 발췌 밖에 있다. 아래 그림은 해당 고정 Makefile의 이웃 규칙까지 대조한 결과다.

target 이름에서 실제 이미지까지 추적하기

01

설정은 의존 target을 선택한다

INPUTS-y의 기본 다섯 target은 항상 추가된다. INPUTS-$(CONFIG_SPL) 같은 변수는 해당 옵션이 y일 때만 대상 목록에 합류한다. 이는 부트 단계의 시간 순서가 아니다.

02

proper는 ELF로 링크된다

객체와 링커 스크립트로 만들어지는 u-boot ELF가 주소와 section을 확인할 기준이다. u-boot.sym, System.map, u-boot.srec은 같은 ELF와 관계된 별도 산출물이며 ROM 이미지의 연속 단계가 아니다.

03

raw 변환 뒤 DTB 조건이 갈린다

u-boot-nodtb.bin은 ELF에서 objcopy로 만든다. CONFIG_MULTI_DTB_FIT이면 FIT DTB 컨테이너 경로, 그렇지 않고 CONFIG_OF_SEPARATE이며 DTB를 생략하지 않으면 단일 DTB 결합 경로, 나머지는 raw 복사 경로가 u-boot.bin으로 이어진다.

04

stage와 mkimage 출력은 조건부다

CONFIG_SPL, CONFIG_TPL, CONFIG_VPL은 각각 stage binary target을 추가한다. CONFIG_SPL_FRAMEWORK는 기본적으로 u-boot.img를, 일부 i.MX HAB 분기에서는 u-boot-ivt.img를 요구한다. 특정 보드가 어느 파일을 실제 부팅에 쓰는지는 별도 규칙으로 확인한다.

05

binman은 패키징 규칙을 따른다

all은 .binman_stamp를 의존하고 stamp는 $(INPUTS-y)를 요구한다. CONFIG_BINMAN=y일 때 binman이 보드의 devicetree description과 입력 파일로 결합 산출물을 만든다. 이름·offset·헤더를 INPUTS-y 한 줄에서 추론할 수 없다.

헷갈리기 쉬운 파일 경계

01

별도 stage는 같은 ELF의 부분 파일이 아니다

SPL/TPL/VPL의 조건부 target은 각 stage 빌드에서 생성된다. 각 단계의 객체·주소·크기 제한은 설정과 링커 규칙에 따라 다르다. proper u-boot.bin이 존재해도 초기 단계 파일이 올바른지 따로 확인해야 한다.

02

ELF 주소와 파일 offset을 섞지 않는다

readelf는 ELF의 section·program header와 entry를 보여 준다. objcopy한 raw 파일은 그 주소 정보를 담지 않으므로 offset 0을 물리 주소 0으로 읽을 수 없다. 결합 이미지에서는 헤더, padding, DTB 및 외부 firmware가 더 들어갈 수 있다.

03

부트 매체에 기록할 파일은 별도 결정이다

u-boot.img, u-boot.itb, binman 출력, SoC 전용 파일의 선택은 보드 규칙과 ROM 요구 형식에 달려 있다. 실제 기록 대상의 offset·크기·서명·DTB 포함 여부는 그 파일의 생성 규칙과 map에서 확인한다.

파일별 확인할 정보

파일 / 목록역할확인 방법
INPUTS-yMake 의존 target 목록고정 Makefile과 실제 .config 조건 대조
u-boot, u-boot.mapELF 실행 파일과 링크 배치 기록readelf -h -l, map의 section·symbol 확인
u-boot-nodtb.bin, u-boot.binraw 및 설정별 DTB 결합 payload파일 크기·DTB 연결 여부·hash 대조
spl/, tpl/, vpl/ binary옵션별 별도 실행 stage존재·크기·link address를 단계별로 확인
binman / SoC 전용 출력선택된 패키징 결과보드 description, map, 실제 flash offset 확인

산출물에서 먼저 찾을 불일치

증상먼저 확인할 관계근거
필요한 SPL/TPL 파일이 없음해당 CONFIG_SPL/TPL과 별도 stage targetMakefile L1211·1221, stage 빌드 로그
u-boot.bin의 DTB 기대와 다름OF_SEPARATE, OF_OMIT_DTB, MULTI_DTB_FIT 분기Makefile L1462–1519, 출력 크기
ROM이 결합 파일을 읽지 못함선택된 binman/SoC 포맷의 header·offset·크기보드 규칙과 패키징 map

빌드 target의 존재와 보드가 실제로 기록·실행하는 파일은 별도 확인 사항이다.

빌드 산출물에서 확인할 증거

이미 만든 해당 보드의 output directory에서 같은 빌드의 설정·ELF·binary·map을 함께 대조한다.

대상확인 방법판정 기준
조건rg 'CONFIG_(SPL|TPL|VPL|OF_SEPARATE|OF_OMIT_DTB|MULTI_DTB_FIT|BINMAN)=' .config목록과 DTB/패키징 분기를 결정하는 설정
ELF${CROSS_COMPILE}readelf -h -l u-bootentry, load segment, 주소
section / map${CROSS_COMPILE}objdump -h u-boot 및 u-boot.maplink 결과와 예상된 section 배치
raw / DTBls -l u-boot-nodtb.bin u-boot.bin u-boot.dtb존재하는 파일만 비교; DTB가 별도 파일로 요구되는 설정인지 확인
포장 출력binman map 또는 보드별 image map실제 출력 파일의 offset·크기·포함물

산출물 계보 대조

  1. 01
    실제 target 목록 확인

    해당 보드의 .config와 Makefile L1200–1234를 대조해 기본·조건부 파일의 존재를 확인한다. 없는 파일을 오류로 판정하기 전에 해당 옵션이 켜졌는지 본다.

  2. 02
    ELF와 raw 변환 구분

    readelf -h -l u-boot의 주소와 u-boot-nodtb.bin의 크기를 기록한다. raw 파일의 offset 0을 실행 주소로 해석하지 않는다.

  3. 03
    결합 이미지 확인

    DTB 설정에 맞는 u-boot.bin의 입력 경로를 확인하고, binman을 쓰는 보드라면 map에서 각 stage·DTB의 offset을 읽는다.

원문과 다음 글