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
|
/* Copyright (c) 2012 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.
*
* Architecture-specific APIs for crossystem
*/
#ifndef VBOOT_REFERENCE_CROSSYSTEM_ARCH_H_
#define VBOOT_REFERENCE_CROSSYSTEM_ARCH_H_
#include <stddef.h>
#include "2sysincludes.h"
#include "2api.h"
#include "2nvstorage.h"
#include "vboot_struct.h"
/* Firmware types from BINF.3. Placed in the common file because both x86 and
* arm use this. The constants are defined in "Chrome OS Main Processor
* Firmware Spec"
*/
#define BINF3_RECOVERY 0
#define BINF3_NORMAL 1
#define BINF3_DEVELOPER 2
#define BINF3_NETBOOT 3
#define BINF3_LEGACY 4
/* INTERNAL APIS FOR CROSSYSTEM AVAILABLE TO ARCH-SPECIFIC FUNCTIONS */
/* Read an integer property from VbNvStorage.
*
* Returns the parameter value, or -1 if error. */
int vb2_get_nv_storage(enum vb2_nv_param param);
/* Write an integer property to VbNvStorage.
*
* Returns 0 if success, -1 if error. */
int vb2_set_nv_storage(enum vb2_nv_param param, int value);
/* Return true if the FWID starts with the specified string. */
int FwidStartsWith(const char *start);
/* Return version of VbSharedData struct or -1 if not found. */
int VbSharedDataVersion(void);
/* Apis WITH ARCH-SPECIFIC IMPLEMENTATIONS */
/* Read the non-volatile context from NVRAM.
*
* Returns 0 if success, -1 if error. */
int vb2_read_nv_storage(struct vb2_context *ctx);
/* Write the non-volatile context to NVRAM.
*
* Returns 0 if success, -1 if error. */
int vb2_write_nv_storage(struct vb2_context *ctx);
/* Read the VbSharedData buffer.
*
* Verifies the buffer contains at least enough data for the
* VbSharedDataHeader; if not, this is an error.
*
* If less data is read than expected, sets the returned structure's data_size
* to the actual amount of data read. If this is less than data_used, then
* some data was not returned; callers must handle this; this is not considered
* an error.
*
* Returns the data buffer, which must be freed by the caller using
* free(), or NULL if error. */
VbSharedDataHeader* VbSharedDataRead(void);
/* Read an architecture-specific system property integer.
*
* Returns the property value, or -1 if error. */
int VbGetArchPropertyInt(const char* name);
/* Read an architecture-specific system property string into a
* destination buffer of the specified size. Returned string will be
* null-terminated. If the buffer is too small, the returned string
* will be truncated.
*
* Returns the passed buffer, or NULL if error. */
const char* VbGetArchPropertyString(const char* name, char* dest, size_t size);
/* Set an architecture-specific system property integer.
*
* Returns 0 if success, -1 if error. */
int VbSetArchPropertyInt(const char* name, int value);
/* Set an architecture-specific system property string.
*
* Returns 0 if success, -1 if error. */
int VbSetArchPropertyString(const char* name, const char* value);
#endif /* VBOOT_REFERENCE__CROSSYSTEM_ARCH_H_ */
|
