coreboot-kgpe-d16/util/cbfstool/fit.h
Philipp Deppenwiese 5ada0023d1 cbfstool: Add ifittool
Add the IntelFirmwareInterfaceTable-tool to modify the FIT.
As cbfstool is overloaded with arguments, introduce a new tool
to only modify FIT, which brings it's own command line syntax.

Provide clean interface to:
* Clear FIT
* Add entry to CBFS file
* Add entry to REGION
* Delete entries
* Add support for types other than 1
* Add support to dump current table
* Add support for top-swap
* Sort entries by type

Most code is reused from existing cbfstool and functionality of cbfstool
is kept. It will be removed once the make system uses only ifittool.

Based on "Intel Trusted Execution Technology (Intel TXT) LAB Handout"
and https://github.com/slimbootloader/slimbootloader .

Change-Id: I0fe8cd70611d58823aca1147d5b830722ed72bd5
Signed-off-by: Patrick Rudolph <patrick.rudolph@9elements.com>
Reviewed-on: https://review.coreboot.org/c/coreboot/+/31493
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Philipp Deppenwiese <zaolin.daisuki@gmail.com>
2019-06-24 09:42:31 +00:00

82 lines
2.6 KiB
C

/*
* Firmware Interface Table support.
*
* Copyright (C) 2012 Google Inc.
* Copyright (C) 2019 9elements Agency GmbH
* Copyright (C) 2019 Facebook Inc.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; version 2 of the License.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/
#ifndef __CBFSTOOL_FIT_H
#define __CBFSTOOL_FIT_H
#include "cbfs_image.h"
#include "common.h"
/**
* Based on "Intel Trusted Execution Technology (Intel TXT) LAB Handout" and
* https://github.com/slimbootloader/slimbootloader/
*/
enum fit_type {
FIT_TYPE_HEADER = 0,
FIT_TYPE_MICROCODE = 1,
FIT_TYPE_BIOS_ACM = 2,
FIT_TYPE_BIOS_STARTUP = 7,
FIT_TYPE_TPM_POLICY = 8,
FIT_TYPE_BIOS_POLICY = 9,
FIT_TYPE_TXT_POLICY = 0xa,
FIT_TYPE_KEY_MANIFEST = 0xb,
FIT_TYPE_BOOT_POLICY = 0xc,
FIT_TYPE_CSE_SECURE_BOOT = 0x10,
FIT_TYPE_TXTSX_POLICY = 0x2d,
FIT_TYPE_JMP_DEBUG_POLICY = 0x2f,
FIT_TYPE_UNUSED = 127,
};
/*
* Converts between offsets from the start of the specified image region and
* "top-aligned" offsets from the top of the entire flash image. Should work in
* both directions: accepts either type of offset and produces the other type.
* The implementation must have some notion of the flash image's total size.
*/
typedef unsigned (*fit_offset_converter_t)(const struct buffer *region,
unsigned offset);
struct fit_table;
struct fit_table *fit_get_table(struct buffer *bootblock,
fit_offset_converter_t offset_fn,
uint32_t topswap_size);
int fit_dump(struct fit_table *fit);
int fit_clear_table(struct fit_table *fit);
int fit_is_supported_type(const enum fit_type type);
int fit_add_entry(struct fit_table *fit,
const uint32_t offset,
const uint32_t len,
const enum fit_type type,
const size_t max_fit_entries);
int fit_delete_entry(struct fit_table *fit,
const size_t idx);
int fit_add_microcode_file(struct fit_table *fit,
struct cbfs_image *image,
const char *blob_name,
fit_offset_converter_t offset_helper,
const size_t max_fit_entries);
/* Legacy code */
int fit_update_table(struct buffer *bootblock, struct cbfs_image *image,
const char *microcode_blob_name,
unsigned int empty_entries,
fit_offset_converter_t offset_fn, uint32_t topswap_size,
uint32_t first_mcu_addr);
#endif