Index: vboot_firmware/include/firmware_image_fw.h |
diff --git a/vboot_firmware/include/firmware_image_fw.h b/vboot_firmware/include/firmware_image_fw.h |
deleted file mode 100644 |
index 32ae9ed4045cd54763dc87096c94b3e7aca87e09..0000000000000000000000000000000000000000 |
--- a/vboot_firmware/include/firmware_image_fw.h |
+++ /dev/null |
@@ -1,154 +0,0 @@ |
-/* Copyright (c) 2010 The Chromium OS Authors. All rights reserved. |
- * Use of this source code is governed by a BSD-style license that can be |
- * found in the LICENSE file. |
- * |
- * Data structure and API definitions for a verified boot firmware image. |
- * (Firmware Portion) |
- */ |
- |
-#ifndef VBOOT_REFERENCE_FIRMWARE_IMAGE_FW_H_ |
-#define VBOOT_REFERENCE_FIRMWARE_IMAGE_FW_H_ |
- |
-#include <stdint.h> |
-#include "cryptolib.h" |
- |
-#define FIRMWARE_MAGIC "CHROMEOS" |
-#define FIRMWARE_MAGIC_SIZE 8 |
-#define FIRMWARE_PREAMBLE_SIZE 8 |
- |
-/* RSA 8192 and SHA-512. */ |
-#define ROOT_SIGNATURE_ALGORITHM 11 |
-#define ROOT_SIGNATURE_ALGORITHM_STRING "11" |
- |
-typedef struct FirmwareImage { |
- uint8_t magic[FIRMWARE_MAGIC_SIZE]; |
- /* Key Header */ |
- uint16_t header_len; /* Length of the header. */ |
- uint16_t firmware_sign_algorithm; /* Signature algorithm used by the signing |
- * key. */ |
- uint16_t firmware_key_version; /* Key Version# for preventing rollbacks. */ |
- uint8_t* firmware_sign_key; /* Pre-processed public half of signing key. */ |
- uint8_t header_checksum[SHA512_DIGEST_SIZE]; /* SHA-512 hash of the header.*/ |
- |
- uint8_t firmware_key_signature[RSA8192NUMBYTES]; /* Signature of the header |
- * above. */ |
- |
- /* Firmware Preamble. */ |
- uint16_t firmware_version; /* Firmware Version# for preventing rollbacks.*/ |
- uint64_t firmware_len; /* Length of the rest of the R/W firmware data. */ |
- uint16_t kernel_subkey_sign_algorithm; /* Signature algorithm used for |
- * signing the kernel subkey. */ |
- uint8_t* kernel_subkey_sign_key; /* Pre-processed public half of the kernel |
- * subkey signing key. */ |
- uint8_t preamble[FIRMWARE_PREAMBLE_SIZE]; /* Remaining preamble data.*/ |
- |
- uint8_t* preamble_signature; /* Signature over the preamble. */ |
- |
- /* The firmware signature comes first as it may allow us to parallelize |
- * the firmware data fetch and RSA public operation. |
- */ |
- uint8_t* firmware_signature; /* Signature on the Preamble + |
- [firmware_data]. */ |
- uint8_t* firmware_data; /* Rest of firmware data */ |
- |
-} FirmwareImage; |
- |
- |
-/* Error Codes for VerifyFirmware* family of functions. */ |
-#define VERIFY_FIRMWARE_SUCCESS 0 |
-#define VERIFY_FIRMWARE_INVALID_IMAGE 1 |
-#define VERIFY_FIRMWARE_ROOT_SIGNATURE_FAILED 2 |
-#define VERIFY_FIRMWARE_INVALID_ALGORITHM 3 |
-#define VERIFY_FIRMWARE_PREAMBLE_SIGNATURE_FAILED 4 |
-#define VERIFY_FIRMWARE_SIGNATURE_FAILED 5 |
-#define VERIFY_FIRMWARE_WRONG_MAGIC 6 |
-#define VERIFY_FIRMWARE_WRONG_HEADER_CHECKSUM 7 |
-#define VERIFY_FIRMWARE_KEY_ROLLBACK 8 |
-#define VERIFY_FIRMWARE_VERSION_ROLLBACK 9 |
-#define VERIFY_FIRMWARE_TPM_ERROR 10 |
-#define VERIFY_FIRMWARE_MAX 11 /* Total number of error codes. */ |
- |
-extern char* kVerifyFirmwareErrors[VERIFY_FIRMWARE_MAX]; |
- |
-/* Returns the length of the verified boot firmware preamble based on |
- * kernel subkey signing algorithm [algorithm]. */ |
-uint64_t GetFirmwarePreambleLen(int algorithm); |
- |
-/* Checks for the sanity of the firmware header pointed by [header_blob]. |
- * |
- * On success, put signature algorithm in [algorithm], header length |
- * in [header_len], and return 0. |
- * Else, return error code on failure. |
- */ |
-int VerifyFirmwareHeader(const uint8_t* root_key_blob, |
- const uint8_t* header_blob, |
- int* algorithm, |
- int* header_len); |
- |
-/* Checks the preamble signature on firmware preamble pointed by |
- * [preamble_blob] using the signing key [sign_key]. |
- * |
- * On success, put firmware length into [firmware_len], and return 0. |
- * Else, return error code on failure. |
- */ |
-int VerifyFirmwarePreamble(RSAPublicKey* sign_key, |
- const uint8_t* preamble_blob, |
- int algorithm, |
- uint64_t* firmware_len); |
- |
-/* Checks the signature on the preamble + firmware data at |
- * [preamble_start] and [firmware_data]. |
- * The length of the actual firmware data is firmware_len and it is assumed to |
- * be prepended with the signature whose size depends on the signature_algorithm |
- * [algorithm]. This signature also covers the preamble data (but not the |
- * preamble signature itself). |
- * |
- * Return 0 on success, error code on failure. |
- */ |
-int VerifyFirmwareData(RSAPublicKey* sign_key, |
- const uint8_t* preamble_start, |
- const uint8_t* firmware_data, |
- uint64_t firmware_len, |
- int algorithm); |
- |
-/* Performs a chained verify of the firmware blob [firmware_blob], using root |
- * key [root_key] and verification header [verification_header_blob]. |
- * |
- * Returns 0 on success, error code on failure. |
- * |
- * NOTE: The length of the firmware blob is derived from reading the fields |
- * in the first few bytes of the verification header. This might look risky but |
- * in firmware land, the start address of the firmware_blob will always be fixed |
- * depending on the memory map on the particular platform. In addition, the |
- * signature on length itself is checked early in the verification process for |
- * extra safety. |
- */ |
-int VerifyFirmware(const uint8_t* root_key_blob, |
- const uint8_t* verification_header_blob, |
- const uint8_t* firmware_blob); |
- |
-/* Returns the logical version of a firmware blob which is calculated as |
- * (firmware_key_version << 16 | firmware_version). */ |
-uint32_t GetLogicalFirmwareVersion(uint8_t* firmware_blob); |
- |
-#define BOOT_FIRMWARE_A_CONTINUE 1 |
-#define BOOT_FIRMWARE_B_CONTINUE 2 |
-#define BOOT_FIRMWARE_RECOVERY_CONTINUE 3 |
- |
-/* This function is the driver used by the RO firmware to |
- * determine which copy of the firmware to boot from. It performs |
- * the requisite rollback index checking, including updating them, |
- * if required. |
- * |
- * Returns the code path to follow. It is one of: |
- * BOOT_FIRMWARE_A_CONTINUE Boot from Firmware A |
- * BOOT_FIRMWARE_B_CONTINUE Boot from Firmware B |
- * BOOT_FIRMWARE_RECOVERY_CONTINUE Jump to recovery mode |
- */ |
-int VerifyFirmwareDriver_f(uint8_t* root_key_blob, |
- uint8_t* verification_headerA, |
- uint8_t* firmwareA, |
- uint8_t* verification_headerB, |
- uint8_t* firmwareB); |
- |
-#endif /* VBOOT_REFERENCE_FIRMWARE_IMAGE_FW_H_ */ |