mirror of
https://github.com/Telecominfraproject/OpenCellular.git
synced 2025-11-24 02:05:01 +00:00
This will be used in subsequent CLs to support PD software sync. For now, only devidx=0 is used. This changes the external vboot API, so must be checked in at the same time as changes to the u-boot and depthcharge implementations. For now, those implementations should simply check if devidx=0 and fail if it's not. BUG=chrome-os-partner:30079 BRANCH=none TEST=make runtests CQ-DEPEND=CL:208195,CL:208196 Change-Id: Iad3be9d676ac224c4582669bcd67176b39f75c73 Signed-off-by: Randall Spangler <rspangler@chromium.org> Reviewed-on: https://chromium-review.googlesource.com/208210 Reviewed-by: Bill Richardson <wfrichar@chromium.org>
88 lines
2.5 KiB
C
88 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.
|
|
*
|
|
* 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);
|
|
|
|
/* Flags for VbUserConfirms() */
|
|
#define VB_CONFIRM_MUST_TRUST_KEYBOARD (1 << 0)
|
|
#define VB_CONFIRM_SPACE_MEANS_NO (1 << 1)
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* Additionally, in some situations we don't accept confirmations from an
|
|
* untrusted keyboard (such as a USB device). In those cases, a recovery
|
|
* button press is needed for confirmation, instead of ENTER.
|
|
*
|
|
* Returns: 1=yes, 0=no, -1 = shutdown.
|
|
*/
|
|
int VbUserConfirms(VbCommonParams *cparams, uint32_t confirm_flags);
|
|
|
|
/**
|
|
* 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 device <devidx> firmware to expected version.
|
|
*/
|
|
VbError_t VbEcSoftwareSync(int devidx, VbCommonParams *cparams);
|
|
|
|
#endif /* VBOOT_REFERENCE_VBOOT_KERNEL_H_ */
|