coreboot-kgpe-d16/util
Julius Werner af20fd748b cbfs: Add CBFS_TYPE_INTEL_FIT and exclude it from CBFS verification
The Intel Firmware Interface Table (FIT) is a bit of an annoying outlier
among CBFS files because it gets manipulated by a separate utility
(ifittool) after cbfstool has already added it to the image. This will
break file hashes created for CBFS verification.

This is not actually a problem when booting, since coreboot never
actually loads the FIT from CBFS -- instead, it's only in the image for
use by platform-specific mechanisms that run before coreboot's
bootblock. But having an invalid file hash in the CBFS image is
confusing when you want to verify that the image is correctly built for
verification.

This patch adds a new CBFS file type "intel_fit" which is only used for
the intel_fit (and intel_fit_ts, if applicable) file containing the FIT.
cbfstool will avoid generating and verifying file hashes for this type,
like it already does for the "bootblock" and "cbfs header" types. (Note
that this means that any attempt to use the CBFS API to actually access
this file from coreboot will result in a verification error when CBFS
verification is enabled.)

Signed-off-by: Julius Werner <jwerner@chromium.org>
Change-Id: I1c1bb6dab0c9ccc6e78529758a42ad3194cd130c
Reviewed-on: https://review.coreboot.org/c/coreboot/+/64736
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Arthur Heymans <arthur@aheymans.xyz>
2022-06-01 19:45:22 +00:00
..
abuild util: Fix a few spelling mistakes 2022-05-30 04:25:07 +00:00
acpi
amdfwtool util/amdfwtool: Add amdfwread utility 2022-05-13 15:51:37 +00:00
amdtools util: Update description files 2022-05-30 13:05:21 +00:00
apcb util/apcb/apcb_v3_edit.py: Edit APCB based on different SPD magic 2022-04-14 22:24:09 +00:00
archive util/archive: Clean up Makefile 2021-02-16 08:11:40 +00:00
autoport mainboard: Drop invalid `VGA_BIOS_FILE` defaults 2021-10-15 09:08:35 +00:00
bincfg util/bincfg/Makefile: change ./bincfg to $(abspath $(TARGET)) 2021-04-07 08:49:03 +00:00
board_status util: Fix a few spelling mistakes 2022-05-30 04:25:07 +00:00
bucts util/bucts: Clean up Makefile to match others 2021-02-25 10:03:00 +00:00
cavium
cbfstool cbfs: Add CBFS_TYPE_INTEL_FIT and exclude it from CBFS verification 2022-06-01 19:45:22 +00:00
cbmem util/cbmem: fix an unused parameter issue in timestamp_get 2022-04-27 00:32:29 +00:00
chromeos util/chromeos/crosfirmware: format with shfmt 2022-02-15 23:43:55 +00:00
coreboot-configurator util: Fix a few spelling mistakes 2022-05-30 04:25:07 +00:00
crossgcc util: Update description files 2022-05-30 13:05:21 +00:00
docker util/docker: Update dockerfiles 2022-05-31 13:41:56 +00:00
dtd_parser
ectool util/ectool: Update Makefile 2021-02-25 10:03:17 +00:00
exynos
find_usbdebug util: Update description files 2022-05-30 13:05:21 +00:00
futility util/futility: Don't echo the warning message unless it fails 2022-03-09 16:16:55 +00:00
fuzz-tests
genbuild_h util/genbuild_h: micro-adjust the regexp used to set COREBOOT_MAJOR_VERSION 2022-03-30 20:06:57 +00:00
gitconfig gitconfig/test: Adapt test to current tree layout 2021-01-28 12:32:07 +00:00
ifdtool util/ifdtool: Add Meteor Lake platform support under IFDv2 2022-03-15 19:22:49 +00:00
intelmetool Spell *Boot Guard* with a space for official spelling 2021-12-16 14:17:36 +00:00
intelp2m util: Update description files 2022-05-30 13:05:21 +00:00
inteltool util/inteltool: Add support for Alder Lake chips detection and GPIOs 2022-05-28 14:36:50 +00:00
intelvbttool
ipqheader util: Update description files 2022-05-30 13:05:21 +00:00
kbc1126 treewide: Remove trailing whitespace 2021-02-17 17:30:05 +00:00
kconfig util/kconfig: Uprev to Linux 5.15's kconfig 2021-11-02 08:10:47 +00:00
lint util/lint/checkpatch: Add alloc functions to alloc with multiplies check 2022-05-29 14:55:38 +00:00
liveiso util: Update description files 2022-05-30 13:05:21 +00:00
mainboard util/mb/google: add support for brask 2022-01-26 19:51:03 +00:00
marvell
me_cleaner
mma migrate out of flashrom deprecated options 2021-04-29 01:05:29 +00:00
msrtool util/msrtool: teach the configure script to use clang 2021-02-11 14:32:02 +00:00
mtkheader
nixshell util/nixshell: Add a Nix shell for building documentation 2022-02-22 10:31:41 +00:00
nvidia
nvramtool cbfs: Rename TYPE_FIT to TYPE_FIT_PAYLOAD 2022-06-01 19:45:08 +00:00
pmh7tool
post util/amdfwtool,post: add missing distclean target 2021-01-08 21:10:51 +00:00
qemu util: Update description files 2022-05-30 13:05:21 +00:00
qualcomm util/qualcomm: fix python syntax warnings 2021-03-18 08:15:18 +00:00
release util/release/build-release: Create cross-toolchain version file 2021-10-21 14:15:57 +00:00
riscv util: Update all shebangs to use /usr/bin/env 2021-01-25 08:57:40 +00:00
rockchip
sconfig SMBIOS/SCONFIG: Allow devtree-defined Type 41 entries 2021-11-04 10:25:09 +00:00
scripts util: Update description files 2022-05-30 13:05:21 +00:00
showdevicetree
spd_tools util/spd_tools/part_id_gen: Support Sabrina SoC 2022-04-14 22:23:51 +00:00
spdtool
spkmodem_recv
superiotool superiotool/ite: add IT8625E EC registers 2022-04-06 16:28:53 +00:00
supermicro util: Make sure all util dirs have description files at top level 2021-01-04 23:08:16 +00:00
testing util/testing: Remove amdfwread from makefile 2022-05-16 15:56:50 +00:00
uio_usbdebug Rename do_printk() to printk() 2021-04-14 10:38:09 +00:00
util_readme
vboot_list
vgabios
x86
xcompile xcompile,clang: increase the number of bracket-depth for CPP 2022-05-13 11:03:16 +00:00
README.md Update util.md documentation 2021-01-28 20:17:11 +00:00

README.md

  • abuild - coreboot autobuild script builds coreboot images for all available targets. bash
  • acpi - Walk through all ACPI tables with their addresses. bash
  • amdfwtool - Create AMD Firmware combination C
  • amdtools - A set of tools to compare extended) K8 memory settings. Perl
  • apcb - AMD PSP Control Block tools
    • apcb_edit.py - This tool allows patching an existing APCB binary with specific SPDs and GPIO selection pins. Python3
  • archive - Concatenate files and create an archive C
  • autoport - Automated porting coreboot to Sandy Bridge/Ivy Bridge platforms Go
  • bincfg - Compiler/Decompiler for data blobs with specs Lex Yacc
  • board_status - Tools to collect logs and upload them to the board status repository Bash Go
  • bucts - A tool to manipulate the BUC.TS bit on Intel targets. C
  • cavium - Devicetree_convert Tool to convert a DTB to a static C file Python
  • cbfstool
    • cbfstool - For manipulating CBFS file C
    • fmaptool - Converts plaintext fmd files into fmap blobs C
    • rmodtool - Creates rmodules C
    • ifwitool - For manipulating IFWI C
  • cbmem - CBMEM parser to read e.g. timestamps and console log C
  • chromeos - These scripts can be used to access Chrome OS resources, for example to extract System Agent reference code and other blobs (e.g. mrc.bin, refcode, VGA option roms) from a Chrome OS recovery image. C
  • crossgcc - A cross toolchain builder for -elf toolchains (ie. no libc support)
  • docker - Dockerfiles for coreboot-sdk, coreboot-jenkins-node, coreboot.org-status and docs.coreboot.org
  • dtd_parser - DTD structure parser Python2
  • ectool - Dumps the RAM of a laptop's Embedded/Environmental Controller (EC). C
  • exynos - Computes and fills Exynos ROM checksum (for BL1 or BL2). Python3
  • find_usbdebug - Help find USB debug ports
  • futility - Firmware utility for signing ChromeOS images Make
  • fuzz-tests - Create test cases that crash the jpeg code. C
  • genbuild_h - Generate build system definitions Shell
  • gitconfig - Initialize git repository submodules install git hooks Bash
  • ifdtool - Extract and dump Intel Firmware Descriptor information C
  • intelmetool - Dump interesting things about Management Engine even if hidden C
  • intelp2m - Intel Pad to Macro (intelp2m) converter 'Go'
  • inteltool - Provides information about the Intel CPU/chipset hardware configuration (register contents, MSRs, etc). C
  • intelvbttool - Parse VBT from VGA BIOS C
  • ipqheader
    • createxbl.py - Concatentates XBL segments into one ELF image Python
    • ipqheader.py - Returns a packed MBN header image with the specified base and size Python
    • mbncat.py - Generate ipq8064 uber SBL Python
    • mbn_tools.py - Contains all MBN Utilities for image generation Python
  • kbc1126 - Tools used to dump the two blobs from the factory firmware of many HP laptops with 8051-based SMSC KBC1098/KBC1126 embedded controller and insert them to the firmware image. C
  • kconfig - Build system Make
  • lint - Source linter and linting rules Shell
  • mainboard - mainboard specific scripts
    • google - Directory for google mainboard specific scripts
  • marvell - Add U-Boot boot loader for Marvell ARMADA38X C
  • me_cleaner - Tool for partial deblobbing of Intel ME/TXE firmware images Python
  • mma - Memory Margin Analysis automation tests Bash
  • msrtool - Dumps chipset-specific MSR registers. C
  • mtkheader - Generate MediaTek bootload header. Python3
  • nvidia - nvidia blob parsers
  • nvramtool - Reads and writes coreboot parameters and displaying information from the coreboot table in CMOS/NVRAM. C
  • pgtblgen - Generates page tables based on fixed physical address. C
  • pmh7tool - Dumps, reads and writes PMH7 registers on Lenovo ThinkPads. PMH7 is used for switching on and off the power of some devices on the board such as dGPU. C
  • post - Userspace utility that can be used to test POST cards. C
  • qemu - Makefile & comprehensive default config for QEMU Q35 emulation
  • qualcomm - CMM script to debug Qualcomm coreboot environments. CMM
  • release - Generate coreboot release Bash
  • riscv
    • make-spike-elf.sh - Converts a flat file into an ELF, that can be passed to SPIKE, the RISC-V reference emulator.Bash
    • sifive-gpt.py - Wraps the bootblock in a GPT partition for SiFive's bootrom. Python3
  • rockchip - Generate Rockchip idblock bootloader. Python3
  • sconfig - coreboot device tree compiler Lex Yacc
  • scripts
    • config - Manipulate options in a .config file from the command line Bash
    • cross-repo-cherrypick - Pull in patches from another tree from a gerrit repository. Shell
    • decode_spd.sh - Decodes Serial Presence Detect (SPD) files into various human readable formats.
    • dts-to-fmd.sh -Converts a depthcharge fmap.dts into an fmaptool compatible .fmd format Bash
    • find-unused-kconfig-symbols.sh - Points out Kconfig variables that may be unused. There are some false positives, but it serves as a starting point Shell
    • gerrit-rebase - Applies all commits that from-branch has over to-branch, based on a common ancestor and gerrit meta-data Bash
    • get_maintainer.pl - Print selected MAINTAINERS information for the files modified in a patch or for a file Perl
    • maintainers.go - Build subsystem Maintainers Go
    • no-fsf-addresses.sh - Removes various FSF addresses from license headers Shell
    • parse-maintainers.pl - Script to alphabetize MAINTAINERS file Perl
    • ucode_h_to_bin.sh - Microcode conversion tool Bash
    • update_submodules - Check all submodules for updates Bash
  • showdevicetree - Compile and dump the device tree C
  • spdtool - Dumps SPD ROMs from a given blob to separate files using known patterns and reserved bits. Useful for analysing firmware that holds SPDs on boards that have soldered down DRAM. python
  • spd_tools - Tools for generating SPD files for DDR4 memory used in platforms with memory down configuration.
    • gen_spd.go - Generates de-duplicated SPD files using a global memory part list provided by the mainboard in JSON format. Go
    • gen_part_id.go - Allocates DRAM strap IDs for different DDR4 memory parts used by the board. Go
  • spkmodem_recv - Decode spkmodem signals C
  • superiotool - A user-space utility to detect Super I/O of a mainboard and provide detailed information about the register contents of the Super I/O. C
  • supermicro - Tools for supermicro platforms
    • smcbiosinfo - Generates SMC biosinfo for BMC BIOS updates C
  • testing - coreboot test targets Make
  • uio_usbdebug - Debug coreboot's usbdebug driver inside a running operating system (only Linux at this time). C
  • util_readme - Creates README.md of description files in ./util subdirectories Bash
  • vboot_list - Tools to generate a list of vboot enabled devices to the documentation Bash
  • vgabios - emulated vga driver for qemu C
  • x86 - Generates 32-bit PAE page tables based on a CSV input file. Go
  • xcompile - Cross compile setup Bash