mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-11-24 02:05:01 +00:00
527ba810ef
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: If2b8bbe467fdbd643239d8d9b5d7aa98df4d286f Signed-off-by: Simon Glass <sjg@chromium.org> Signed-off-by: David Hendricks <dhendrix@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/63336 Reviewed-by: Randall Spangler <rspangler@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/167361
84 lines
2.5 KiB
C
84 lines
2.5 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.
|
|
*
|
|
* Access to portions of the GBB using the region API.
|
|
*/
|
|
|
|
#ifndef VBOOT_REFERENCE_GBB_ACCESS_H_
|
|
#define VBOOT_REFERENCE_GBB_ACCESS_H_
|
|
|
|
#include "vboot_api.h"
|
|
|
|
struct BmpBlockHeader;
|
|
struct ImageInfo;
|
|
struct GoogleBinaryBlockHeader;
|
|
struct ScreenLayout;
|
|
struct VbPublicKey;
|
|
|
|
/**
|
|
* Read the GBB header
|
|
*
|
|
* This accesses the GBB and reads its header.
|
|
*
|
|
* @param cparams Vboot common parameters
|
|
* @param gbb Place to put GBB header
|
|
*/
|
|
VbError_t VbGbbReadHeader_static(VbCommonParams *cparams,
|
|
struct GoogleBinaryBlockHeader *gbb);
|
|
|
|
/**
|
|
* Read the root key from the GBB
|
|
*
|
|
* @param cparams Vboot common parameters
|
|
* @param keyp Returns a pointer to the key. The caller must call
|
|
* VbExFree() on the key when finished with it.
|
|
* @return VBERROR_... error, VBERROR_SUCCESS on success,
|
|
*/
|
|
VbError_t VbGbbReadRootKey(VbCommonParams *cparams,
|
|
struct VbPublicKey **keyp);
|
|
|
|
/**
|
|
* Read the recovery key from the GBB
|
|
*
|
|
* @param cparams Vboot common parameters
|
|
* @param keyp Returns a pointer to the key. The caller must call
|
|
* VbExFree() on the key when finished with it.
|
|
* @return VBERROR_... error, VBERROR_SUCCESS on success,
|
|
*/
|
|
VbError_t VbGbbReadRecoveryKey(VbCommonParams *cparams,
|
|
struct VbPublicKey **keyp);
|
|
|
|
/**
|
|
* Read the bitmap block header from the GBB
|
|
*
|
|
* @param cparams Vboot common parameters
|
|
* @param hdr The header is placed in this block
|
|
* @return VBERROR_... error, VBERROR_SUCCESS on success,
|
|
*/
|
|
VbError_t VbGbbReadBmpHeader(VbCommonParams *cparams,
|
|
struct BmpBlockHeader *hdr);
|
|
|
|
/**
|
|
* Read a image from the GBB
|
|
*
|
|
* The caller must call VbExFree() on *image_datap when finished with it.
|
|
*
|
|
* @param cparams Vboot common parameters
|
|
* @param localization Localization/language number
|
|
* @param screen_index Index of screen to display (VB_SCREEN_...)
|
|
* @param image_num Image number within the screen
|
|
* @param layout Returns layout information (x, y position)
|
|
* @param image_info Returns information about the image (format)
|
|
* @param image_datap Returns a pointer to the image data
|
|
* @param iamge_data_sizep Return size of image data
|
|
* @return VBERROR_... error, VBERROR_SUCCESS on success,
|
|
*/
|
|
VbError_t VbGbbReadImage(VbCommonParams *cparams,
|
|
uint32_t localization, uint32_t screen_index,
|
|
uint32_t image_num, struct ScreenLayout *layout,
|
|
struct ImageInfo *image_info, char **image_datap,
|
|
uint32_t *image_data_sizep);
|
|
|
|
#endif
|