| Index: utility/kernel_utility.cc
|
| diff --git a/utility/kernel_utility.cc b/utility/kernel_utility.cc
|
| deleted file mode 100644
|
| index 4940112d4aa92a4c8e80d8d000dc9286e572b42c..0000000000000000000000000000000000000000
|
| --- a/utility/kernel_utility.cc
|
| +++ /dev/null
|
| @@ -1,525 +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.
|
| -//
|
| -// Utility for manipulating verified boot kernel images.
|
| -//
|
| -
|
| -#include "kernel_utility.h"
|
| -
|
| -#include <getopt.h>
|
| -#include <stdio.h>
|
| -#include <stdint.h> // Needed for UINT16_MAX.
|
| -#include <stdlib.h>
|
| -#include <unistd.h>
|
| -
|
| -#include <iostream>
|
| -
|
| -extern "C" {
|
| -#include "cryptolib.h"
|
| -#include "file_keys.h"
|
| -#include "kernel_image.h"
|
| -#include "stateful_util.h"
|
| -#include "utility.h"
|
| -}
|
| -
|
| -using std::cerr;
|
| -
|
| -// Macro to determine the size of a field structure in the KernelImage
|
| -// structure.
|
| -#define FIELD_LEN(field) (sizeof(((KernelImage*)0)->field))
|
| -
|
| -namespace vboot_reference {
|
| -
|
| -KernelUtility::KernelUtility(): image_(NULL),
|
| - firmware_key_pub_(NULL),
|
| - header_version_(1),
|
| - firmware_sign_algorithm_(-1),
|
| - kernel_sign_algorithm_(-1),
|
| - kernel_key_version_(-1),
|
| - kernel_version_(-1),
|
| - padding_(0),
|
| - kernel_len_(0),
|
| - is_generate_(false),
|
| - is_verify_(false),
|
| - is_describe_(false),
|
| - is_only_vblock_(false) {}
|
| -
|
| -KernelUtility::~KernelUtility() {
|
| - RSAPublicKeyFree(firmware_key_pub_);
|
| - KernelImageFree(image_);
|
| -}
|
| -
|
| -void KernelUtility::PrintUsage(void) {
|
| - cerr << "\n"
|
| - "Utility to generate/verify/describe a verified boot kernel image\n"
|
| - "\n"
|
| - "Usage: kernel_utility <--generate|--verify|--describe> [OPTIONS]\n"
|
| - "\n"
|
| - "For \"--describe\", the required OPTIONS are:\n"
|
| - " --in <infile>\t\t\t\tSigned boot image to describe.\n"
|
| - "\n"
|
| - "For \"--verify\", required OPTIONS are:\n"
|
| - " --in <infile>\t\t\t\tSigned boot image to verify.\n"
|
| - " --firmware_key_pub <pubkeyfile>\tPre-processed public firmware key\n"
|
| - "\n"
|
| - "For \"--generate\", required OPTIONS are:\n"
|
| - " --firmware_key <privkeyfile>\t\tPrivate firmware signing key file\n"
|
| - " --kernel_key_pub <pubkeyfile>\t\tPre-processed public kernel signing"
|
| - " key\n"
|
| - " --firmware_sign_algorithm <algoid>\tSigning algorithm for firmware\n"
|
| - " --kernel_sign_algorithm <algoid>\tSigning algorithm for kernel\n"
|
| - " --kernel_key_version <number>\t\tKernel signing key version number\n"
|
| - "OR\n"
|
| - " --subkey_in <subkeyfile>\t\tExisting key signature header\n"
|
| - "\n"
|
| - " --kernel_key <privkeyfile>\t\tPrivate kernel signing key file\n"
|
| - " --kernel_version <number>\t\tKernel Version number\n"
|
| - " --config <file>\t\t\tEmbedded kernel command-line parameters\n"
|
| - " --bootloader <file>\t\t\tEmbedded bootloader stub\n"
|
| - " --vmlinuz <file>\t\t\tEmbedded kernel image\n"
|
| - " --out <outfile>\t\t\tOutput file for verified boot image\n"
|
| - "\n"
|
| - "Optional arguments for \"--generate\" are:\n"
|
| - " --padding <size>\t\t\tPad the header to this size\n"
|
| - " --subkey_out\t\t\t\tJust output the subkey (key verification) header\n"
|
| - " --vblock\t\t\t\tJust output the verification block\n"
|
| - "\n"
|
| - "<algoid> (for --*_sign_algorithm) is one of the following:\n";
|
| - for (int i = 0; i < kNumAlgorithms; i++) {
|
| - cerr << " " << i << " for " << algo_strings[i] << "\n";
|
| - }
|
| - cerr << "\n\n";
|
| -}
|
| -
|
| -bool KernelUtility::ParseCmdLineOptions(int argc, char* argv[]) {
|
| - int option_index, i;
|
| - char *e = 0;
|
| - enum {
|
| - OPT_FIRMWARE_KEY = 1000,
|
| - OPT_FIRMWARE_KEY_PUB,
|
| - OPT_KERNEL_KEY,
|
| - OPT_KERNEL_KEY_PUB,
|
| - OPT_SUBKEY_IN,
|
| - OPT_FIRMWARE_SIGN_ALGORITHM,
|
| - OPT_KERNEL_SIGN_ALGORITHM,
|
| - OPT_KERNEL_KEY_VERSION,
|
| - OPT_KERNEL_VERSION,
|
| - OPT_IN,
|
| - OPT_OUT,
|
| - OPT_GENERATE,
|
| - OPT_VERIFY,
|
| - OPT_DESCRIBE,
|
| - OPT_VBLOCK,
|
| - OPT_BOOTLOADER,
|
| - OPT_VMLINUZ,
|
| - OPT_CONFIG,
|
| - OPT_PADDING,
|
| - OPT_SUBKEY_OUT,
|
| - };
|
| - static struct option long_options[] = {
|
| - {"firmware_key", 1, 0, OPT_FIRMWARE_KEY },
|
| - {"firmware_key_pub", 1, 0, OPT_FIRMWARE_KEY_PUB },
|
| - {"kernel_key", 1, 0, OPT_KERNEL_KEY },
|
| - {"kernel_key_pub", 1, 0, OPT_KERNEL_KEY_PUB },
|
| - {"subkey_in", 1, 0, OPT_SUBKEY_IN },
|
| - {"firmware_sign_algorithm", 1, 0, OPT_FIRMWARE_SIGN_ALGORITHM },
|
| - {"kernel_sign_algorithm", 1, 0, OPT_KERNEL_SIGN_ALGORITHM },
|
| - {"kernel_key_version", 1, 0, OPT_KERNEL_KEY_VERSION },
|
| - {"kernel_version", 1, 0, OPT_KERNEL_VERSION },
|
| - {"in", 1, 0, OPT_IN },
|
| - {"out", 1, 0, OPT_OUT },
|
| - {"generate", 0, 0, OPT_GENERATE },
|
| - {"verify", 0, 0, OPT_VERIFY },
|
| - {"describe", 0, 0, OPT_DESCRIBE },
|
| - {"vblock", 0, 0, OPT_VBLOCK },
|
| - {"bootloader", 1, 0, OPT_BOOTLOADER },
|
| - {"vmlinuz", 1, 0, OPT_VMLINUZ },
|
| - {"config", 1, 0, OPT_CONFIG },
|
| - {"padding", 1, 0, OPT_PADDING },
|
| - {"subkey_out", 0, 0, OPT_SUBKEY_OUT },
|
| - {NULL, 0, 0, 0}
|
| - };
|
| - while ((i = getopt_long(argc, argv, "", long_options, &option_index)) != -1) {
|
| - switch (i) {
|
| - case '?':
|
| - return false;
|
| - break;
|
| - case OPT_FIRMWARE_KEY:
|
| - firmware_key_file_ = optarg;
|
| - break;
|
| - case OPT_FIRMWARE_KEY_PUB:
|
| - firmware_key_pub_file_ = optarg;
|
| - break;
|
| - case OPT_KERNEL_KEY:
|
| - kernel_key_file_ = optarg;
|
| - break;
|
| - case OPT_KERNEL_KEY_PUB:
|
| - kernel_key_pub_file_ = optarg;
|
| - break;
|
| - case OPT_SUBKEY_IN:
|
| - subkey_in_file_ = optarg;
|
| - break;
|
| - case OPT_FIRMWARE_SIGN_ALGORITHM:
|
| - firmware_sign_algorithm_ = strtol(optarg, &e, 0);
|
| - if (!*optarg || (e && *e)) {
|
| - cerr << "Invalid argument to --"
|
| - << long_options[option_index].name
|
| - << ": " << optarg << "\n";
|
| - return false;
|
| - }
|
| - break;
|
| - case OPT_KERNEL_SIGN_ALGORITHM:
|
| - kernel_sign_algorithm_ = strtol(optarg, &e, 0);
|
| - if (!*optarg || (e && *e)) {
|
| - cerr << "Invalid argument to --"
|
| - << long_options[option_index].name
|
| - << ": " << optarg << "\n";
|
| - return false;
|
| - }
|
| - break;
|
| - case OPT_KERNEL_KEY_VERSION:
|
| - kernel_key_version_ = strtol(optarg, &e, 0);
|
| - if (!*optarg || (e && *e)) {
|
| - cerr << "Invalid argument to --"
|
| - << long_options[option_index].name
|
| - << ": " << optarg << "\n";
|
| - return false;
|
| - }
|
| - break;
|
| - case OPT_KERNEL_VERSION:
|
| - kernel_version_ = strtol(optarg, &e, 0);
|
| - if (!*optarg || (e && *e)) {
|
| - cerr << "Invalid argument to --"
|
| - << long_options[option_index].name
|
| - << ": " << optarg << "\n";
|
| - return false;
|
| - }
|
| - break;
|
| - case OPT_IN:
|
| - in_file_ = optarg;
|
| - break;
|
| - case OPT_OUT:
|
| - out_file_ = optarg;
|
| - break;
|
| - case OPT_GENERATE:
|
| - is_generate_ = true;
|
| - break;
|
| - case OPT_VERIFY:
|
| - is_verify_ = true;
|
| - break;
|
| - case OPT_DESCRIBE:
|
| - is_describe_ = true;
|
| - break;
|
| - case OPT_VBLOCK:
|
| - is_only_vblock_ = true;
|
| - break;
|
| - case OPT_BOOTLOADER:
|
| - bootloader_file_ = optarg;
|
| - break;
|
| - case OPT_VMLINUZ:
|
| - vmlinuz_file_ = optarg;
|
| - break;
|
| - case OPT_CONFIG:
|
| - config_file_ = optarg;
|
| - break;
|
| - case OPT_PADDING:
|
| - padding_ = strtol(optarg, &e, 0);
|
| - if (!*optarg || (e && *e)) {
|
| - cerr << "Invalid argument to --"
|
| - << long_options[option_index].name
|
| - << ": " << optarg << "\n";
|
| - return false;
|
| - }
|
| - break;
|
| - case OPT_SUBKEY_OUT:
|
| - is_subkey_out_ = true;
|
| - break;
|
| - }
|
| - }
|
| - return CheckOptions();
|
| -}
|
| -
|
| -void KernelUtility::OutputSignedImage(void) {
|
| - if (image_) {
|
| - if (!WriteKernelImage(out_file_.c_str(), image_,
|
| - is_only_vblock_,
|
| - is_subkey_out_)) {
|
| - cerr << "Couldn't write verified boot kernel image to file "
|
| - << out_file_ <<".\n";
|
| - }
|
| - }
|
| -}
|
| -
|
| -void KernelUtility::DescribeSignedImage(void) {
|
| - image_ = ReadKernelImage(in_file_.c_str());
|
| - if (!image_) {
|
| - cerr << "Couldn't read kernel image or malformed image.\n";
|
| - return;
|
| - }
|
| - PrintKernelImage(image_);
|
| -}
|
| -
|
| -bool KernelUtility::GenerateSignedImage(void) {
|
| - uint64_t kernel_key_pub_len;
|
| -
|
| - image_ = KernelImageNew();
|
| - Memcpy(image_->magic, KERNEL_MAGIC, KERNEL_MAGIC_SIZE);
|
| -
|
| - if (subkey_in_file_.empty()) {
|
| - // We must generate the kernel key signature header (subkey header)
|
| - // ourselves.
|
| - image_->header_version = 1;
|
| - image_->firmware_sign_algorithm = (uint16_t) firmware_sign_algorithm_;
|
| - // Copy pre-processed public signing key.
|
| - image_->kernel_sign_algorithm = (uint16_t) kernel_sign_algorithm_;
|
| - image_->kernel_sign_key = BufferFromFile(kernel_key_pub_file_.c_str(),
|
| - &kernel_key_pub_len);
|
| - if (!image_->kernel_sign_key)
|
| - return false;
|
| - image_->kernel_key_version = kernel_key_version_;
|
| -
|
| - // Update header length.
|
| - image_->header_len = GetKernelHeaderLen(image_);
|
| - // Calculate header checksum.
|
| - CalculateKernelHeaderChecksum(image_, image_->header_checksum);
|
| -
|
| - // Generate and add the key signatures.
|
| - if (!AddKernelKeySignature(image_, firmware_key_file_.c_str())) {
|
| - cerr << "Couldn't write key signature to verified boot kernel image.\n";
|
| - return false;
|
| - }
|
| - } else {
|
| - // Use existing subkey header.
|
| - MemcpyState st;
|
| - uint8_t* subkey_header_buf = NULL;
|
| - uint64_t subkey_len;
|
| - int header_len;
|
| - int kernel_key_signature_len;
|
| - int kernel_sign_key_len;
|
| - uint8_t header_checksum[FIELD_LEN(header_checksum)];
|
| -
|
| - subkey_header_buf = BufferFromFile(subkey_in_file_.c_str(), &subkey_len);
|
| - if (!subkey_header_buf) {
|
| - cerr << "Couldn't read subkey header from file %s\n"
|
| - << subkey_in_file_.c_str();
|
| - return false;
|
| - }
|
| - st.remaining_len = subkey_len;
|
| - st.remaining_buf = subkey_header_buf;
|
| - st.overrun = 0;
|
| -
|
| - // TODO(gauravsh): This is basically the same code as the first half of
|
| - // of ReadKernelImage(). Refactor to eliminate code duplication.
|
| -
|
| - StatefulMemcpy(&st, &image_->header_version, FIELD_LEN(header_version));
|
| - StatefulMemcpy(&st, &image_->header_len, FIELD_LEN(header_len));
|
| - StatefulMemcpy(&st, &image_->firmware_sign_algorithm,
|
| - FIELD_LEN(firmware_sign_algorithm));
|
| - StatefulMemcpy(&st, &image_->kernel_sign_algorithm,
|
| - FIELD_LEN(kernel_sign_algorithm));
|
| -
|
| - // Valid Kernel Key signing algorithm.
|
| - if (image_->firmware_sign_algorithm >= kNumAlgorithms) {
|
| - Free(subkey_header_buf);
|
| - return NULL;
|
| - }
|
| -
|
| - // Valid Kernel Signing Algorithm?
|
| - if (image_->kernel_sign_algorithm >= kNumAlgorithms) {
|
| - Free(subkey_header_buf);
|
| - return NULL;
|
| - }
|
| -
|
| - // Compute size of pre-processed RSA public keys and signatures.
|
| - kernel_key_signature_len = siglen_map[image_->firmware_sign_algorithm];
|
| - kernel_sign_key_len = RSAProcessedKeySize(image_->kernel_sign_algorithm);
|
| -
|
| - // Check whether key header length is correct.
|
| - header_len = GetKernelHeaderLen(image_);
|
| - if (header_len != image_->header_len) {
|
| - debug("Header length mismatch. Got: %d, Expected: %d\n",
|
| - image_->header_len, header_len);
|
| - Free(subkey_header_buf);
|
| - return NULL;
|
| - }
|
| -
|
| - // Read pre-processed public half of the kernel signing key.
|
| - StatefulMemcpy(&st, &image_->kernel_key_version,
|
| - FIELD_LEN(kernel_key_version));
|
| - image_->kernel_sign_key = (uint8_t*) Malloc(kernel_sign_key_len);
|
| - StatefulMemcpy(&st, image_->kernel_sign_key, kernel_sign_key_len);
|
| - StatefulMemcpy(&st, image_->header_checksum, FIELD_LEN(header_checksum));
|
| -
|
| - // Check whether the header checksum matches.
|
| - CalculateKernelHeaderChecksum(image_, header_checksum);
|
| - if (SafeMemcmp(header_checksum, image_->header_checksum,
|
| - FIELD_LEN(header_checksum))) {
|
| - debug("Invalid kernel header checksum!\n");
|
| - Free(subkey_header_buf);
|
| - return NULL;
|
| - }
|
| -
|
| - // Read key signature.
|
| - image_->kernel_key_signature = (uint8_t*) Malloc(kernel_key_signature_len);
|
| - StatefulMemcpy(&st, image_->kernel_key_signature,
|
| - kernel_key_signature_len);
|
| -
|
| - Free(subkey_header_buf);
|
| - if (st.overrun || st.remaining_len != 0) /* Overrun or underrun. */
|
| - return false;
|
| - return true;
|
| - }
|
| -
|
| - // Fill up kernel preamble and kernel data.
|
| - image_->kernel_version = kernel_version_;
|
| - if (padding_)
|
| - image_->padded_header_size = padding_;
|
| - image_->kernel_data = GenerateKernelBlob(vmlinuz_file_.c_str(),
|
| - config_file_.c_str(),
|
| - bootloader_file_.c_str(),
|
| - &image_->kernel_len,
|
| - &image_->bootloader_offset,
|
| - &image_->bootloader_size);
|
| - if (!image_->kernel_data)
|
| - return false;
|
| -
|
| - // Generate and add the preamble and data signatures.
|
| - if (!AddKernelSignature(image_, kernel_key_file_.c_str())) {
|
| - cerr << "Couldn't write firmware signature to verified boot kernel image.\n";
|
| - return false;
|
| - }
|
| - return true;
|
| -}
|
| -
|
| -bool KernelUtility::VerifySignedImage(void) {
|
| - int error;
|
| - firmware_key_pub_ = RSAPublicKeyFromFile(firmware_key_pub_file_.c_str());
|
| - image_ = ReadKernelImage(in_file_.c_str());
|
| -
|
| - if (!firmware_key_pub_) {
|
| - cerr << "Couldn't read pre-processed public root key.\n";
|
| - return false;
|
| - }
|
| -
|
| - if (!image_) {
|
| - cerr << "Couldn't read kernel image or malformed image.\n";
|
| - return false;
|
| - }
|
| - if (!(error = VerifyKernelImage(firmware_key_pub_, image_, 0)))
|
| - return true;
|
| - cerr << VerifyKernelErrorString(error) << "\n";
|
| - return false;
|
| -}
|
| -
|
| -bool KernelUtility::CheckOptions(void) {
|
| - // Ensure that only one of --{describe|generate|verify} is set.
|
| - if (!((is_describe_ && !is_generate_ && !is_verify_) ||
|
| - (!is_describe_ && is_generate_ && !is_verify_) ||
|
| - (!is_describe_ && !is_generate_ && is_verify_))) {
|
| - cerr << "One (and only one) of --describe, --generate or --verify "
|
| - << "must be specified.\n";
|
| - return false;
|
| - }
|
| - // Common required options.
|
| - // Required options for --describe.
|
| - if (is_describe_) {
|
| - if (in_file_.empty()) {
|
| - cerr << "No input file specified.\n";
|
| - return false;
|
| - }
|
| - }
|
| - // Required options for --verify.
|
| - if (is_verify_) {
|
| - if (firmware_key_pub_file_.empty()) {
|
| - cerr << "No pre-processed public firmware key file specified.\n";
|
| - return false;
|
| - }
|
| - if (in_file_.empty()) {
|
| - cerr << "No input file specified.\n";
|
| - return false;
|
| - }
|
| - }
|
| - // Required options for --generate.
|
| - if (is_generate_) {
|
| - if (subkey_in_file_.empty()) {
|
| - // Firmware private key (root key), kernel signing public
|
| - // key, and signing algorithms are required to generate the key signature
|
| - // header.
|
| - if (firmware_key_file_.empty()) {
|
| - cerr << "No firmware key file specified.\n";
|
| - return false;
|
| - }
|
| - if (kernel_key_pub_file_.empty()) {
|
| - cerr << "No pre-processed public kernel key file specified\n";
|
| - return false;
|
| - }
|
| - if (kernel_key_version_ <= 0 || kernel_key_version_ > UINT16_MAX) {
|
| - cerr << "Invalid or no kernel key version specified.\n";
|
| - return false;
|
| - }
|
| - if (firmware_sign_algorithm_ < 0 ||
|
| - firmware_sign_algorithm_ >= kNumAlgorithms) {
|
| - cerr << "Invalid or no firmware signing key algorithm specified.\n";
|
| - return false;
|
| - }
|
| - if (kernel_sign_algorithm_ < 0 ||
|
| - kernel_sign_algorithm_ >= kNumAlgorithms) {
|
| - cerr << "Invalid or no kernel signing key algorithm specified.\n";
|
| - return false;
|
| - }
|
| - }
|
| - if (kernel_key_file_.empty()) {
|
| - cerr << "No kernel key file specified.\n";
|
| - return false;
|
| - }
|
| - if (kernel_version_ <=0 || kernel_version_ > UINT16_MAX) {
|
| - cerr << "Invalid or no kernel version specified.\n";
|
| - return false;
|
| - }
|
| - if (out_file_.empty()) {
|
| - cerr <<"No output file specified.\n";
|
| - return false;
|
| - }
|
| - if (config_file_.empty()) {
|
| - cerr << "No config file specified.\n";
|
| - return false;
|
| - }
|
| - if (bootloader_file_.empty()) {
|
| - cerr << "No bootloader file specified.\n";
|
| - return false;
|
| - }
|
| - if (vmlinuz_file_.empty()) {
|
| - cerr << "No vmlinuz file specified.\n";
|
| - return false;
|
| - }
|
| - // TODO(gauravsh): Enforce only one of --vblock or --subkey_out is specified
|
| - }
|
| - return true;
|
| -}
|
| -
|
| -} // namespace vboot_reference
|
| -
|
| -int main(int argc, char* argv[]) {
|
| - vboot_reference::KernelUtility ku;
|
| - if (!ku.ParseCmdLineOptions(argc, argv)) {
|
| - ku.PrintUsage();
|
| - return -1;
|
| - }
|
| - if (ku.is_describe()) {
|
| - ku.DescribeSignedImage();
|
| - }
|
| - else if (ku.is_generate()) {
|
| - if (!ku.GenerateSignedImage())
|
| - return -1;
|
| - ku.OutputSignedImage();
|
| - }
|
| - else if (ku.is_verify()) {
|
| - cerr << "Verification ";
|
| - if (ku.VerifySignedImage())
|
| - cerr << "SUCCESS.\n";
|
| - else
|
| - cerr << "FAILURE.\n";
|
| - }
|
| - return 0;
|
| -}
|
|
|