1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
/* 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 "gpt_misc.h"
#include "load_kernel_fw.h"
#include "vboot_api.h"
struct vb2_context;
/**
* Attempt loading a kernel from the specified type(s) of disks.
*
* If successful, sets lkp.disk_handle to the disk for the kernel and returns
* VBERROR_SUCCESS.
*
* @param ctx Vboot context
* @param get_info_flags Flags to pass to VbExDiskGetInfo()
* @return VBERROR_SUCCESS, VBERROR_NO_DISK_FOUND if no disks of the specified
* type were found, or other non-zero VBERROR_ codes for other failures.
*/
uint32_t VbTryLoadKernel(struct vb2_context *ctx, 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(struct vb2_context *ctx, uint32_t confirm_flags);
/**
* Handle a normal boot.
*/
VbError_t VbBootNormal(struct vb2_context *ctx);
/**
* Handle a developer-mode boot.
*/
VbError_t VbBootDeveloper(struct vb2_context *ctx);
/**
* Handle a recovery-mode boot.
*/
VbError_t VbBootRecovery(struct vb2_context *ctx);
/**
* Handle a developer-mode boot using detachable menu ui
*/
VbError_t VbBootDeveloperMenu(struct vb2_context *ctx);
/**
* Handle a recovery-mode boot using detachable menu ui
*/
VbError_t VbBootRecoveryMenu(struct vb2_context *ctx);
/**
* Return the current FWMP flags. Valid only inside VbSelectAndLoadKernel().
*/
uint32_t vb2_get_fwmp_flags(void);
/**
* Commit NvStorage.
*
* This may be called by UI functions which need to save settings before they
* sit in an infinite loop waiting for shutdown (this is, by a UI state which
* will never return).
*/
void vb2_nv_commit(struct vb2_context *ctx);
/**
* Prepare to start a bootloader
*
* Get ready to jump into a bootloader if allowed, calling RollbackKernelLock().
*
* @param allowed 1 if allowed, 0 if not allowed (in which case this function
* prints a debug error)
* @return 0 if allowed, -1 if not allowed
*
*/
int vb2_prepare_alt_fw(int allowed);
/**
* Tidy up after failing to start a bootloader
*
* This beeps twice to indicate failure
*/
void vb2_exit_altfw(void);
/**
* Jump to a bootloader if possible
*
* This calls vb2_prepare_alt_fw() to check the operation is permitted. If it
* is, then it jumps to the selected bootloader and execution continues there,
* never returning.
*
* If the operation is not permitted, or it is permitted but the bootloader
* cannot be found, it calls vb2_exit_altfw() and returns.
*
* @allowed 1 if allowed, 0 if not allowed
* @altfw_num Number of bootloader to start (0=any, 1=first, etc.)
*/
void vb2_try_alt_fw(int allowed, int altfw_num);
enum vb2_beep_type {
VB_BEEP_FAILED, /* Permitted but the operation failed */
VB_BEEP_NOT_ALLOWED, /* Operation disabled by user setting */
};
/**
* Emit beeps to indicate an error
*/
void vb2_error_beep(enum vb2_beep_type beep);
#endif /* VBOOT_REFERENCE_VBOOT_KERNEL_H_ */
|
