QUESTION
한 번의 빌드에서 어떤 파일이 어떤 조건으로 생기는가?
이 글의 고정 발췌는 Makefile:1176–1264다. 중심인 INPUTS-y += ...는 Make 의존 대상으로 삼을 파일을 나열하는 규칙이지 CPU가 실행하는 순서나 이미지 내부 배치를 뜻하지 않는다.
u-boot ELF에서 raw u-boot-nodtb.bin을 만들고, 설정에 따라 DTB를 합쳐 u-boot.bin을 만든다. SPL/TPL/VPL은 별도 조건부 빌드 산출물이며, binman의 결합 이미지는 또 다른 패키징 단계다.
STRUCTURE
U-Boot proper의 파일 계보와 DTB 선택지
.config + object 목록Kconfig와 Kbuild 조건이 U-Boot proper에 들어갈 객체와 링크 설정을 고른다.
u-boot (ELF)링커 스크립트와 객체를 결합한 실행 파일. u-boot.sym, System.map, S-record도 별도 진단/변환 산출물이다.
u-boot-nodtb.bin-O binary로 ELF에서 얻는 raw payload. 파일 오프셋에는 ELF의 주소 정보가 보존되지 않는다.
u-boot.bin으로 가는 대안 경로 ↓u-boot.dtb는 dts/dt.dtb를 복사한 별도 파일일 수 있다. 모든 보드에서 DTB가 별도 파일로 붙거나 모든 u-boot.bin이 ROM 입력이 되는 것은 아니다.DEPENDENCY GRAPH
INPUTS-y가 모으는 조건부 대상
INPUTS-y + INPUTS-$(CONFIG_...)설정에 맞는 target 이름이 의존 목록으로 확장됨u-boot.srec, u-boot.bin, u-boot.sym, System.map, binary_size_check. 서로를 순차 실행하는 명령 목록이 아니다.
CONFIG_SPL → spl/u-boot-spl.bin; CONFIG_TPL / CONFIG_VPL → 각 stage의 raw binary. 실제 부트 순서는 이 목록만으로 확정할 수 없다.
CONFIG_SPL_FRAMEWORK에 따른 u-boot.img 또는 u-boot-ivt.img, CONFIG_OF_SEPARATE에 따른 DTB target 등.
all: .binman_stamp ← $(INPUTS-y)CONFIG_BINMAN=y일 때만 binman 명령 실행. 생성될 결합 이미지의 이름과 배치는 보드의 binman description 및 추가 규칙이 결정한다.STATE LEDGER
이름·형식·생성 조건을 분리해서 읽기
아래 파일은 한 이미지의 연속 상태가 아니라 서로 다른 target이다. 특히 INPUTS-y의 항목은 Make 의존 대상이며 저장 위치를 직접 지정하지 않는다.
| target | 형식 / 상위 입력 | 조건 | 읽을 때의 경계 |
|---|---|---|---|
u-boot | 객체 + 링커 스크립트 → ELF | U-Boot proper link | ELF section·entry 주소를 가진다 |
u-boot-nodtb.bin | u-boot → objcopy raw | u-boot.bin의 하위 의존 | raw 바이트에 ELF 주소 메타데이터 없음 |
u-boot.bin | raw copy 또는 DTB/FIT 결합 | MULTI_DTB_FIT, OF_SEPARATE 등 분기 | 파일명만으로 DTB 포함 여부 단정 불가 |
spl/u-boot-spl.bin 등 | 별도 stage 빌드의 raw binary | CONFIG_SPL/TPL/VPL | proper의 ELF에서 잘라낸 조각이 아님 |
u-boot.img / 결합 이미지 | mkimage target / binman 출력 | 선택된 framework·보드 규칙 | 헤더·offset·포함물은 별도로 확인 |
UPSTREAM SOURCE
원본 코드
아래 코드는 U-Boot v2026.07의 Makefile에서 1176-1264줄을 그대로 가져온 것이다.
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
READING CONTRACT
발췌 범위와 읽기 기준
고정 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의 이웃 규칙까지 대조한 결과다.
DETAILS
target 이름에서 실제 이미지까지 추적하기
설정은 의존 target을 선택한다
INPUTS-y의 기본 다섯 target은 항상 추가된다. INPUTS-$(CONFIG_SPL) 같은 변수는 해당 옵션이 y일 때만 대상 목록에 합류한다. 이는 부트 단계의 시간 순서가 아니다.
proper는 ELF로 링크된다
객체와 링커 스크립트로 만들어지는 u-boot ELF가 주소와 section을 확인할 기준이다. u-boot.sym, System.map, u-boot.srec은 같은 ELF와 관계된 별도 산출물이며 ROM 이미지의 연속 단계가 아니다.
raw 변환 뒤 DTB 조건이 갈린다
u-boot-nodtb.bin은 ELF에서 objcopy로 만든다. CONFIG_MULTI_DTB_FIT이면 FIT DTB 컨테이너 경로, 그렇지 않고 CONFIG_OF_SEPARATE이며 DTB를 생략하지 않으면 단일 DTB 결합 경로, 나머지는 raw 복사 경로가 u-boot.bin으로 이어진다.
stage와 mkimage 출력은 조건부다
CONFIG_SPL, CONFIG_TPL, CONFIG_VPL은 각각 stage binary target을 추가한다. CONFIG_SPL_FRAMEWORK는 기본적으로 u-boot.img를, 일부 i.MX HAB 분기에서는 u-boot-ivt.img를 요구한다. 특정 보드가 어느 파일을 실제 부팅에 쓰는지는 별도 규칙으로 확인한다.
binman은 패키징 규칙을 따른다
all은 .binman_stamp를 의존하고 stamp는 $(INPUTS-y)를 요구한다. CONFIG_BINMAN=y일 때 binman이 보드의 devicetree description과 입력 파일로 결합 산출물을 만든다. 이름·offset·헤더를 INPUTS-y 한 줄에서 추론할 수 없다.
IMPLEMENTATION NOTES
헷갈리기 쉬운 파일 경계
별도 stage는 같은 ELF의 부분 파일이 아니다
SPL/TPL/VPL의 조건부 target은 각 stage 빌드에서 생성된다. 각 단계의 객체·주소·크기 제한은 설정과 링커 규칙에 따라 다르다. proper u-boot.bin이 존재해도 초기 단계 파일이 올바른지 따로 확인해야 한다.
ELF 주소와 파일 offset을 섞지 않는다
readelf는 ELF의 section·program header와 entry를 보여 준다. objcopy한 raw 파일은 그 주소 정보를 담지 않으므로 offset 0을 물리 주소 0으로 읽을 수 없다. 결합 이미지에서는 헤더, padding, DTB 및 외부 firmware가 더 들어갈 수 있다.
부트 매체에 기록할 파일은 별도 결정이다
u-boot.img, u-boot.itb, binman 출력, SoC 전용 파일의 선택은 보드 규칙과 ROM 요구 형식에 달려 있다. 실제 기록 대상의 offset·크기·서명·DTB 포함 여부는 그 파일의 생성 규칙과 map에서 확인한다.
ARTIFACT INVENTORY
파일별 확인할 정보
| 파일 / 목록 | 역할 | 확인 방법 |
|---|---|---|
INPUTS-y | Make 의존 target 목록 | 고정 Makefile과 실제 .config 조건 대조 |
u-boot, u-boot.map | ELF 실행 파일과 링크 배치 기록 | readelf -h -l, map의 section·symbol 확인 |
u-boot-nodtb.bin, u-boot.bin | raw 및 설정별 DTB 결합 payload | 파일 크기·DTB 연결 여부·hash 대조 |
spl/, tpl/, vpl/ binary | 옵션별 별도 실행 stage | 존재·크기·link address를 단계별로 확인 |
| binman / SoC 전용 출력 | 선택된 패키징 결과 | 보드 description, map, 실제 flash offset 확인 |
FAILURE PATH
산출물에서 먼저 찾을 불일치
| 증상 | 먼저 확인할 관계 | 근거 |
|---|---|---|
| 필요한 SPL/TPL 파일이 없음 | 해당 CONFIG_SPL/TPL과 별도 stage target | Makefile 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의 존재와 보드가 실제로 기록·실행하는 파일은 별도 확인 사항이다.
EVIDENCE
빌드 산출물에서 확인할 증거
이미 만든 해당 보드의 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-boot | entry, load segment, 주소 |
| section / map | ${CROSS_COMPILE}objdump -h u-boot 및 u-boot.map | link 결과와 예상된 section 배치 |
| raw / DTB | ls -l u-boot-nodtb.bin u-boot.bin u-boot.dtb | 존재하는 파일만 비교; DTB가 별도 파일로 요구되는 설정인지 확인 |
| 포장 출력 | binman map 또는 보드별 image map | 실제 출력 파일의 offset·크기·포함물 |
LAB
산출물 계보 대조
- 01실제 target 목록 확인
해당 보드의
.config와 Makefile L1200–1234를 대조해 기본·조건부 파일의 존재를 확인한다. 없는 파일을 오류로 판정하기 전에 해당 옵션이 켜졌는지 본다. - 02ELF와 raw 변환 구분
readelf -h -l u-boot의 주소와u-boot-nodtb.bin의 크기를 기록한다. raw 파일의 offset 0을 실행 주소로 해석하지 않는다. - 03결합 이미지 확인
DTB 설정에 맞는
u-boot.bin의 입력 경로를 확인하고, binman을 쓰는 보드라면 map에서 각 stage·DTB의 offset을 읽는다.
PRIMARY REFERENCES