fdabf3fcd7
This patch adds the first stage of the new CONFIG_CBFS_VERIFICATION feature. It's not useful to end-users in this stage so it cannot be selected in menuconfig (and should not be used other than for development) yet. With this patch coreboot can verify the metadata hash of the RO CBFS when it starts booting, but it does not verify individual files yet. Likewise, verifying RW CBFSes with vboot is not yet supported. Verification is bootstrapped from a "metadata hash anchor" structure that is embedded in the bootblock code and marked by a unique magic number. This anchor contains both the CBFS metadata hash and a separate hash for the FMAP which is required to find the primary CBFS. Both are verified on first use in the bootblock (and halt the system on failure). The CONFIG_TOCTOU_SAFETY option is also added for illustrative purposes to show some paths that need to be different when full protection against TOCTOU (time-of-check vs. time-of-use) attacks is desired. For normal verification it is sufficient to check the FMAP and the CBFS metadata hash only once in the bootblock -- for TOCTOU verification we do the same, but we need to be extra careful that we do not re-read the FMAP or any CBFS metadata in later stages. This is mostly achieved by depending on the CBFS metadata cache and FMAP cache features, but we allow for one edge case in case the RW CBFS metadata cache overflows (which may happen during an RW update and could otherwise no longer be fixed because mcache size is defined by RO code). This code is added to demonstrate design intent but won't really matter until RW CBFS verification can be supported. Signed-off-by: Julius Werner <jwerner@chromium.org> Change-Id: I8930434de55eb938b042fdada9aa90218c0b5a34 Reviewed-on: https://review.coreboot.org/c/coreboot/+/41120 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Patrick Georgi <pgeorgi@google.com>
75 lines
2.1 KiB
C
75 lines
2.1 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
|
|
#ifndef __CBFS_H
|
|
#define __CBFS_H
|
|
|
|
#include "common.h"
|
|
#include <commonlib/bsd/cbfs_serialized.h>
|
|
|
|
/* To make CBFS more friendly to ROM, fill -1 (0xFF) instead of zero. */
|
|
#define CBFS_CONTENT_DEFAULT_VALUE (-1)
|
|
|
|
#define CBFS_HEADPTR_ADDR_X86 0xFFFFFFFC
|
|
|
|
/* cbfstool is allowed to use this constant freely since it's not part of the
|
|
CBFS image, so make an alias for the name that's a little less aggressive. */
|
|
#define METADATA_HASH_ANCHOR_MAGIC \
|
|
DO_NOT_USE_METADATA_HASH_ANCHOR_MAGIC_DO_NOT_USE
|
|
|
|
struct typedesc_t {
|
|
uint32_t type;
|
|
const char *name;
|
|
};
|
|
|
|
static const struct typedesc_t types_cbfs_compression[] = {
|
|
{CBFS_COMPRESS_NONE, "none"},
|
|
{CBFS_COMPRESS_LZMA, "LZMA"},
|
|
{CBFS_COMPRESS_LZ4, "LZ4"},
|
|
{0, NULL},
|
|
};
|
|
|
|
static struct typedesc_t filetypes[] unused = {
|
|
{CBFS_TYPE_BOOTBLOCK, "bootblock"},
|
|
{CBFS_TYPE_CBFSHEADER, "cbfs header"},
|
|
{CBFS_TYPE_STAGE, "stage"},
|
|
{CBFS_TYPE_SELF, "simple elf"},
|
|
{CBFS_TYPE_FIT, "fit"},
|
|
{CBFS_TYPE_OPTIONROM, "optionrom"},
|
|
{CBFS_TYPE_BOOTSPLASH, "bootsplash"},
|
|
{CBFS_TYPE_RAW, "raw"},
|
|
{CBFS_TYPE_VSA, "vsa"},
|
|
{CBFS_TYPE_MBI, "mbi"},
|
|
{CBFS_TYPE_MICROCODE, "microcode"},
|
|
{CBFS_TYPE_FSP, "fsp"},
|
|
{CBFS_TYPE_MRC, "mrc"},
|
|
{CBFS_TYPE_CMOS_DEFAULT, "cmos_default"},
|
|
{CBFS_TYPE_CMOS_LAYOUT, "cmos_layout"},
|
|
{CBFS_TYPE_SPD, "spd"},
|
|
{CBFS_TYPE_MRC_CACHE, "mrc_cache"},
|
|
{CBFS_TYPE_MMA, "mma"},
|
|
{CBFS_TYPE_EFI, "efi"},
|
|
{CBFS_TYPE_STRUCT, "struct"},
|
|
{CBFS_TYPE_DELETED, "deleted"},
|
|
{CBFS_TYPE_NULL, "null"},
|
|
{0, NULL}
|
|
};
|
|
|
|
#define CBFS_SUBHEADER(_p) ( (void *) ((((uint8_t *) (_p)) + ntohl((_p)->offset))) )
|
|
|
|
static inline size_t cbfs_file_attr_hash_size(enum vb2_hash_algorithm algo)
|
|
{
|
|
return offsetof(struct cbfs_file_attr_hash, hash.raw) +
|
|
vb2_digest_size(algo);
|
|
}
|
|
|
|
/* cbfs_image.c */
|
|
uint32_t get_cbfs_entry_type(const char *name, uint32_t default_value);
|
|
uint32_t get_cbfs_compression(const char *name, uint32_t unknown);
|
|
|
|
/* cbfs-mkpayload.c */
|
|
void xdr_segs(struct buffer *output,
|
|
struct cbfs_payload_segment *segs, int nseg);
|
|
void xdr_get_seg(struct cbfs_payload_segment *out,
|
|
struct cbfs_payload_segment *in);
|
|
|
|
#endif
|