From d7c88c2308d6806caef93d34a44a15b96d7f7128 Mon Sep 17 00:00:00 2001 From: Simon Glass Date: Mon, 21 Aug 2023 12:23:10 -0600 Subject: [PATCH] docs: Mention add_intermediate and provide an example This is a useful feature, so add a note about it. Change-Id: If29f6480f878bdaf877dc208cc4861b884e10840 Signed-off-by: Simon Glass Reviewed-on: https://review.coreboot.org/c/coreboot/+/77342 Tested-by: build bot (Jenkins) Reviewed-by: Patrick Georgi Reviewed-on: https://review.coreboot.org/c/coreboot/+/77465 Tested-by: Patrick Georgi Reviewed-by: Martin L Roth --- Documentation/getting_started/build_system.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/getting_started/build_system.md b/Documentation/getting_started/build_system.md index 787c833d2b..4013bc6057 100644 --- a/Documentation/getting_started/build_system.md +++ b/Documentation/getting_started/build_system.md @@ -62,6 +62,23 @@ supported options are: `position` and `align` are mutually exclusive. +### Adding Makefile fragments + +You can use the `add_intermediate` helper to add new post-processing steps for +the final `coreboot.rom` image. For example you can add new files to CBFS by +adding something like this to `site-local/Makefile.inc` + +``` +$(call add_intermediate, add_mrc_data) + $(CBFSTOOL) $< write -r RW_MRC_CACHE -f site-local/my-mrc-recording.bin +``` + +Note that the second line must start with a tab, not spaces. + +```eval_rst +See also :doc:`../tutorial/managing_local_additions`. +``` + #### FMAP region support With the addition of FMAP flash partitioning support to coreboot, there was a need to extend the specification of files to provide more precise control