mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-11-24 02:05:01 +00:00
1d3c804b6b
At present reading data from storage in Vboot is a little fragmented. For the firmware image, we expect the boot loader to handle this. For the disk we have a block-level API. For the GBB (which also sits in the firmware image) we expect the entire thing to be read before Vboot is called. Add the concept of a region, and an API to read from a region. At present, and most pressing, is reading from a GBB region. In the future this could be extended to other parts of the firmware or even the disk. Move all access to the GBB into this API so that the boot loader can provide either a GBB region in one large contiguous chunk, or a function to deal with read requests from vboot. The call to VbExRegionRead() is behind a flag since not all boot loaders support it yet. The main change for boot loaders which don't support this new API is that vboot will do more behind the scenes. For example, it will allocate memory for chunks of data that it reads from the GBB, rather than just accessing it directly. This approach is considerably simpler than trying to pass char ** everywhere and have vboot decide whether something needs to be allocated or not. The tests are updated, mainly to include setting up a GBB structure accessible from VbCommonParams, which is now required by the firmware and kernel functions. In normal operation this is set up at the start of VbLoadFIrmware() and VbSelectAndLoadKernel() but for tests which call children of these functions directly, the GBB structure must be set up manually by the test. BUG=chrome-os-partner:21115 BRANCH=none TEST=manual FEATURES=test sudo -E emerge vboot_reference Change-Id: I2c19e9dc2ed602d0642bbf4f7d27f79fe9fad873 Signed-off-by: Simon Glass <sjg@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/63336 Reviewed-by: Randall Spangler <rspangler@chromium.org>
80 lines
2.1 KiB
C
80 lines
2.1 KiB
C
/* Copyright (c) 2013 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 kernel image.
|
|
* (Firmware Portion)
|
|
*/
|
|
|
|
#ifndef VBOOT_REFERENCE_VBOOT_KERNEL_H_
|
|
#define VBOOT_REFERENCE_VBOOT_KERNEL_H_
|
|
|
|
#include "cgptlib.h"
|
|
#include "load_firmware_fw.h"
|
|
#include "load_kernel_fw.h"
|
|
#include "vboot_api.h"
|
|
|
|
/**
|
|
* Allocate and read GPT data from the drive. The sector_bytes and
|
|
* drive_sectors fields should be filled on input. The primary and secondary
|
|
* header and entries are filled on output.
|
|
*
|
|
* Returns 0 if successful, 1 if error.
|
|
*/
|
|
int AllocAndReadGptData(VbExDiskHandle_t disk_handle, GptData *gptdata);
|
|
|
|
/**
|
|
* Write any changes for the GPT data back to the drive, then free the buffers.
|
|
*/
|
|
int WriteAndFreeGptData(VbExDiskHandle_t disk_handle, GptData *gptdata);
|
|
|
|
/**
|
|
* Accessors for unit tests only.
|
|
*/
|
|
VbNvContext *VbApiKernelGetVnc(void);
|
|
|
|
/**
|
|
* Exported for unit tests only - frees memory used by VbSelectAndLoadKernel()
|
|
*/
|
|
void VbApiKernelFree(VbCommonParams *cparams);
|
|
|
|
/**
|
|
* Try to load a kernel.
|
|
*/
|
|
uint32_t VbTryLoadKernel(VbCommonParams *cparams, LoadKernelParams *p,
|
|
uint32_t get_info_flags);
|
|
|
|
/**
|
|
* Ask the user to confirm something.
|
|
*
|
|
* We should display whatever the question is first, then call this. ESC is
|
|
* always "no", ENTER is always "yes", and we'll specify what SPACE means. We
|
|
* don't return until one of those keys is pressed, or until asked to shut
|
|
* down.
|
|
*
|
|
* Returns: 1=yes, 0=no, -1 = shutdown.
|
|
*/
|
|
int VbUserConfirms(VbCommonParams *cparams, int space_means_no);
|
|
|
|
/**
|
|
* Handle a normal boot.
|
|
*/
|
|
VbError_t VbBootNormal(VbCommonParams *cparams, LoadKernelParams *p);
|
|
|
|
/**
|
|
* Handle a developer-mode boot.
|
|
*/
|
|
VbError_t VbBootDeveloper(VbCommonParams *cparams, LoadKernelParams *p);
|
|
|
|
/**
|
|
* Handle a recovery-mode boot.
|
|
*/
|
|
VbError_t VbBootRecovery(VbCommonParams *cparams, LoadKernelParams *p);
|
|
|
|
/**
|
|
* Sync EC firmware to expected version.
|
|
*/
|
|
VbError_t VbEcSoftwareSync(VbCommonParams *cparams);
|
|
|
|
#endif /* VBOOT_REFERENCE_VBOOT_KERNEL_H_ */
|