5fc7c2896a
Currently, src/vboot/bootmode.c gets compiled even if vboot is disabled. It seems that this was only done to support calling certain developer/recovery mode functions in this case. There is no reason to compile the whole file for that -- we can just differentiate with a stub in the header instead, which is what other parts of coreboot usually do for cases like this. Change-Id: If83e1b3e0f34f75c2395b4c464651e373724b2e6 Signed-off-by: Julius Werner <jwerner@chromium.org> Reviewed-on: https://review.coreboot.org/18982 Reviewed-by: Aaron Durbin <adurbin@chromium.org> Tested-by: build bot (Jenkins)
117 lines
4.1 KiB
C
117 lines
4.1 KiB
C
/*
|
|
* This file is part of the coreboot project.
|
|
*
|
|
* Copyright (C) 2014 Google, Inc.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; version 2 of the License.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*/
|
|
#ifndef __VBOOT_VBOOT_COMMON_H__
|
|
#define __VBOOT_VBOOT_COMMON_H__
|
|
|
|
#include <commonlib/region.h>
|
|
#include <stdint.h>
|
|
#include <vboot_api.h>
|
|
#include <vboot_struct.h>
|
|
|
|
/* Locate vboot area by name. Returns 0 on success and -1 on error. */
|
|
int vboot_named_region_device(const char *name, struct region_device *rdev);
|
|
|
|
/* Like vboot_named_region_device() but provides a RW region device. */
|
|
int vboot_named_region_device_rw(const char *name, struct region_device *rdev);
|
|
|
|
/*
|
|
* Function to check if there is a request to enter recovery mode. Returns
|
|
* reason code if request to enter recovery mode is present, otherwise 0.
|
|
*/
|
|
int vboot_check_recovery_request(void);
|
|
|
|
/* ========================== VBOOT HANDOFF APIs =========================== */
|
|
/*
|
|
* The vboot_handoff structure contains the data to be consumed by downstream
|
|
* firmware after firmware selection has been completed. Namely it provides
|
|
* vboot shared data as well as the flags from VbInit.
|
|
*/
|
|
struct vboot_handoff {
|
|
VbInitParams init_params;
|
|
uint32_t selected_firmware;
|
|
char shared_data[VB_SHARED_DATA_MIN_SIZE];
|
|
} __attribute__((packed));
|
|
|
|
/*
|
|
* vboot_get_handoff_info returns pointer to the vboot_handoff structure if
|
|
* available. vboot_handoff is available only after CBMEM comes online. If size
|
|
* is not NULL, size of the vboot_handoff structure is returned in it.
|
|
* Returns 0 on success and -1 on error.
|
|
*/
|
|
int vboot_get_handoff_info(void **addr, uint32_t *size);
|
|
|
|
/*
|
|
* The following functions read vboot_handoff structure to obtain requested
|
|
* information. If vboot handoff is not available, 0 is returned by default.
|
|
* If vboot handoff is available:
|
|
* Returns 1 for flag if true
|
|
* Returns 0 for flag if false
|
|
* Returns value read for other fields
|
|
*/
|
|
int vboot_handoff_skip_display_init(void);
|
|
int vboot_handoff_check_recovery_flag(void);
|
|
int vboot_handoff_check_developer_flag(void);
|
|
int vboot_handoff_get_recovery_reason(void);
|
|
|
|
/* ============================ VBOOT REBOOT ============================== */
|
|
/*
|
|
* vboot_reboot handles the reboot requests made by vboot_reference library. It
|
|
* allows the platform to run any preparation steps before the reboot and then
|
|
* does a hard reset.
|
|
*/
|
|
void vboot_reboot(void);
|
|
|
|
/* Allow the platform to do any clean up work when vboot requests a reboot. */
|
|
void vboot_platform_prepare_reboot(void);
|
|
|
|
/* ============================ VBOOT RESUME ============================== */
|
|
/*
|
|
* Save the provided hash digest to a secure location to check against in
|
|
* the resume path. Returns 0 on success, < 0 on error.
|
|
*/
|
|
int vboot_save_hash(void *digest, size_t digest_size);
|
|
|
|
/*
|
|
* Retrieve the previously saved hash digest. Returns 0 on success,
|
|
* < 0 on error.
|
|
*/
|
|
int vboot_retrieve_hash(void *digest, size_t digest_size);
|
|
|
|
/*
|
|
* Determine if the platform is resuming from suspend. Returns 0 when
|
|
* not resuming, > 0 if resuming, and < 0 on error.
|
|
*/
|
|
int vboot_platform_is_resuming(void);
|
|
|
|
/* ============================= VERSTAGE ================================== */
|
|
/*
|
|
* Main logic for verified boot. verstage_main() is just the core vboot logic.
|
|
* If the verstage is a separate stage, it should be entered via main().
|
|
*/
|
|
void verstage_main(void);
|
|
void verstage_mainboard_init(void);
|
|
|
|
/* Check boot modes */
|
|
#if IS_ENABLED(CONFIG_VBOOT)
|
|
int vboot_developer_mode_enabled(void);
|
|
int vboot_recovery_mode_enabled(void);
|
|
int vboot_recovery_mode_memory_retrain(void);
|
|
#else /* !CONFIG_VBOOT */
|
|
static inline int vboot_developer_mode_enabled(void) { return 0; }
|
|
static inline int vboot_recovery_mode_enabled(void) { return 0; }
|
|
static inline int vboot_recovery_mode_memory_retrain(void) { return 0; }
|
|
#endif
|
|
|
|
#endif /* __VBOOT_VBOOT_COMMON_H__ */
|