coreboot-kgpe-d16/util
Hung-Te Lin 9497fcb742 cbfstool: Change FMD annotation to flags
The idea of "annotation" for firmware sections was pretty flexible, but
in future we will want multiple attributes applied to same area. For
example, indicate the section must be preserved when updating firmware
so serial number or MAC address can be preserved.

The solution here is to extend annotation so it can take multiple
identifiers (flags) in a row. For example, to declare a 64KB COREBOOT
section as CBFS using annotation:

 COREBOOT(CBFS)@0x0 64k

If there's a new flag "PRESERVE" indicating the section must be
preserved before update, we can declare it following CBFS flag:

 COREBOOT(CBFS PRESERVE)@0x0 64k

The flags are directly parsed in fmd_parser, and stored in an union
flashmap_flags. Output modules can choose to ignore or process the
flags.

Currently the only supported flag is "CBFS" (for backward compatible
with annotation). There will be more new flags in follow up patches.

BUG=chromium:936768
TEST=make; boots on x86 "google/eve" and arm "google/kukui" devices

Change-Id: Ie2d99f570e6faff6ed3a4344d6af7526a4515fae
Signed-off-by: Hung-Te Lin <hungte@chromium.org>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/31706
Reviewed-by: Julius Werner <jwerner@chromium.org>
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
2019-03-05 19:31:43 +00:00
..
abuild util/abuild: Set fatal asserts when running scanbuild 2019-02-27 19:33:43 +00:00
acpi treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
amdfwtool util: Add description.md to each util 2018-07-26 13:26:50 +00:00
amdtools treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
archive util: Add description.md to each util 2018-07-26 13:26:50 +00:00
arm_boot_tools/mksunxiboot util: Add description.md to each util 2018-07-26 13:26:50 +00:00
autoport cpu/intel/model_206ax: Remove the notion of sockets 2019-01-24 13:39:19 +00:00
bimgtool util: Add description.md to each util 2018-07-26 13:26:50 +00:00
bincfg Revert "util/bincfg: code cleanup: convert sym_table to a local variable" 2019-01-26 13:35:43 +00:00
board_status util/board_status.sh: Fix command for fetching the kernel log 2018-12-18 13:22:11 +00:00
bucts util/bucts: Add a description.md file 2018-12-18 13:24:56 +00:00
cavium util: Fix shebang for python2 scripts 2018-11-18 09:12:22 +00:00
cbfstool cbfstool: Change FMD annotation to flags 2019-03-05 19:31:43 +00:00
cbmem util/cbmem: Improve utility description 2019-03-01 10:00:46 +00:00
chromeos util/chromeos/crosfirmware.sh: Print more messages 2019-01-03 16:53:57 +00:00
crossgcc crossgcc: Update MPFR to version 4.0.2 2019-02-18 20:20:58 +00:00
docker cpu/intel: Rename socket_mFCPGA478 to socket_m 2019-02-28 13:47:54 +00:00
dtd_parser util: Add description.md to each util 2018-07-26 13:26:50 +00:00
ectool treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
exynos util: Add description.md to each util 2018-07-26 13:26:50 +00:00
find_usbdebug utils: introduce find_usbdebug.sh to help find USB debug ports 2018-12-19 10:21:32 +00:00
futility util: Add description.md to each util 2018-07-26 13:26:50 +00:00
fuzz-tests util: Add description.md to each util 2018-07-26 13:26:50 +00:00
genbuild_h ACPI: Fix error on asl_compiler_revision format 2019-02-26 21:44:01 +00:00
genprof treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
gitconfig util/gitconfig/pre-commit: Use clang-format to sanitise commits 2019-01-04 10:37:10 +00:00
ifdtool util/ifdtools: Make EC region readable to BIOS/CPU 2019-02-14 07:53:16 +00:00
intelmetool intelmetool: Use GPLv2+ where possible 2019-02-25 11:19:37 +00:00
inteltool util/inteltool: Add Apollo Lake GPIO groups and names 2019-03-05 11:56:02 +00:00
intelvbttool intelvbttool: Add support for reading vbt from sysfs 2019-02-22 11:09:58 +00:00
ipqheader util: Fix shebang for python2 scripts 2018-11-18 09:12:22 +00:00
k8resdump treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
kbc1126 util: Add description.md to each util 2018-07-26 13:26:50 +00:00
kconfig util/kconfig: Add `toada` Ada spec generation tool 2019-01-24 13:47:08 +00:00
lint util/lint: Fix clang-format test and enable it by default 2019-03-05 16:13:10 +00:00
marvell util: Add description.md to each util 2018-07-26 13:26:50 +00:00
me_cleaner treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
mma treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
msrtool util/msrtool: Fix typos 2018-08-28 14:19:13 +00:00
mtkheader util: Add description.md to each util 2018-07-26 13:26:50 +00:00
nvidia util: Add description.md to each util 2018-07-26 13:26:50 +00:00
nvramtool treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
pmh7tool treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
post util: Add description.md to each util 2018-07-26 13:26:50 +00:00
qualcomm util: Add description.md to each util 2018-07-26 13:26:50 +00:00
release util/release: Don't assume the source is in a directory called coreboot 2018-12-21 18:06:36 +00:00
riscv riscv: fix bug of sifive-gpt.py 2018-11-22 14:48:43 +00:00
rockchip util: Add description.md to each util 2018-07-26 13:26:50 +00:00
romcc romcc: Increase buffer size to fit max string size 2018-11-28 11:47:32 +00:00
sconfig sconfig: Allow setting device status in device tree 2018-09-16 08:37:36 +00:00
scripts util/scripts/maintainers.go: file: queries are more stable with quotes 2018-12-05 15:21:21 +00:00
showdevicetree util: Add description.md to each util 2018-07-26 13:26:50 +00:00
spkmodem_recv utils: spkmodem: suggest to use parec instead of parecord 2018-08-13 12:19:33 +00:00
superiotool util/superiotool: detect Fintek F81866, F8196* 2019-01-25 11:24:59 +00:00
testing broadcom: Remove SoC and board support 2018-11-30 10:26:37 +00:00
uio_usbdebug util: Add description.md to each util 2018-07-26 13:26:50 +00:00
util_readme util/util_readme: Don't recommend running this script with "sh" 2018-12-18 13:25:21 +00:00
vgabios util: Add description.md to each util 2018-07-26 13:26:50 +00:00
viatool treewide: use /usr/bin/env where appropriate 2018-11-17 07:32:03 +00:00
x86 util: Add description.md to each util 2018-07-26 13:26:50 +00:00
xcompile util/xcompile/xcompile: Use tab for indent 2018-12-28 22:33:30 +00:00
README.md utils: introduce find_usbdebug.sh to help find USB debug ports 2018-12-19 10:21:32 +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
  • archive - Concatenate files and create an archive C
  • mksunxiboot - A simple tool to generate bootable image for sunxi platform. C
  • autoport - Automated porting coreboot to Sandy Bridge/Ivy Bridge platforms Go
  • bimgtool - A simple tool which generates and verifies boot images in the BIMG format, used in systems designed by Imagination Technologies, for example the Pistachio SoC. C
  • 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 console log reader C
  • checklist - Board implementation checklist generator Make
  • chromeos - These scripts can be used 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). Python2
  • 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
  • genprof - Format function tracing logs Bash C
  • 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
  • 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
  • k8resdump - This program will dump the IO/memory/PCI resources from the K8 memory controller C
  • 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
  • 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. Python2
  • nvidia - nvidia blob parsers
  • nvramtool - Reads and writes coreboot parameters and displaying information from the coreboot table in CMOS/NVRAM. 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
  • 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. Python2
  • romcc - Compile a C source file generating a binary that does not implicitly use RAM. C
  • 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
    • 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
  • 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
  • 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
  • vgabios - emulated vga driver for qemu C
  • viatool - Extract certain configuration bits on VIA chipsets and CPUs. C
  • x86 - Generates 32-bit PAE page tables based on a CSV input file. Go
  • xcompile - Cross compile setup Bash