iPXE
UefiMultiPhase.h
Go to the documentation of this file.
1 /** @file
2  This includes some definitions introduced in UEFI that will be used in both PEI and DXE phases.
3 
4 Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
5 SPDX-License-Identifier: BSD-2-Clause-Patent
6 
7 **/
8 
9 #ifndef __UEFI_MULTIPHASE_H__
10 #define __UEFI_MULTIPHASE_H__
11 
12 FILE_LICENCE ( BSD2_PATENT );
13 
14 ///
15 /// Attributes of variable.
16 ///
17 #define EFI_VARIABLE_NON_VOLATILE 0x00000001
18 #define EFI_VARIABLE_BOOTSERVICE_ACCESS 0x00000002
19 #define EFI_VARIABLE_RUNTIME_ACCESS 0x00000004
20 ///
21 /// This attribute is identified by the mnemonic 'HR'
22 /// elsewhere in this specification.
23 ///
24 #define EFI_VARIABLE_HARDWARE_ERROR_RECORD 0x00000008
25 ///
26 /// Attributes of Authenticated Variable
27 ///
28 #define EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS 0x00000020
29 #define EFI_VARIABLE_APPEND_WRITE 0x00000040
30 ///
31 /// NOTE: EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS is deprecated and should be considered reserved.
32 ///
33 #define EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS 0x00000010
34 
35 #ifndef VFRCOMPILE
37 ///
38 /// Enumeration of memory types introduced in UEFI.
39 ///
40 typedef enum {
41  ///
42  /// Not used.
43  ///
45  ///
46  /// The code portions of a loaded application.
47  /// (Note that UEFI OS loaders are UEFI applications.)
48  ///
50  ///
51  /// The data portions of a loaded application and the default data allocation
52  /// type used by an application to allocate pool memory.
53  ///
55  ///
56  /// The code portions of a loaded Boot Services Driver.
57  ///
59  ///
60  /// The data portions of a loaded Boot Serves Driver, and the default data
61  /// allocation type used by a Boot Services Driver to allocate pool memory.
62  ///
64  ///
65  /// The code portions of a loaded Runtime Services Driver.
66  ///
68  ///
69  /// The data portions of a loaded Runtime Services Driver and the default
70  /// data allocation type used by a Runtime Services Driver to allocate pool memory.
71  ///
73  ///
74  /// Free (unallocated) memory.
75  ///
77  ///
78  /// Memory in which errors have been detected.
79  ///
81  ///
82  /// Memory that holds the ACPI tables.
83  ///
85  ///
86  /// Address space reserved for use by the firmware.
87  ///
89  ///
90  /// Used by system firmware to request that a memory-mapped IO region
91  /// be mapped by the OS to a virtual address so it can be accessed by EFI runtime services.
92  ///
94  ///
95  /// System memory-mapped IO region that is used to translate memory
96  /// cycles to IO cycles by the processor.
97  ///
99  ///
100  /// Address space reserved by the firmware for code that is part of the processor.
101  ///
103  ///
104  /// A memory region that operates as EfiConventionalMemory,
105  /// however it happens to also support byte-addressable non-volatility.
106  ///
108  ///
109  /// A memory region that describes system memory that has not been accepted
110  /// by a corresponding call to the underlying isolation architecture.
111  ///
115 
116 ///
117 /// Enumeration of reset types.
118 ///
119 typedef enum {
120  ///
121  /// Used to induce a system-wide reset. This sets all circuitry within the
122  /// system to its initial state. This type of reset is asynchronous to system
123  /// operation and operates withgout regard to cycle boundaries. EfiColdReset
124  /// is tantamount to a system power cycle.
125  ///
127  ///
128  /// Used to induce a system-wide initialization. The processors are set to their
129  /// initial state, and pending cycles are not corrupted. If the system does
130  /// not support this reset type, then an EfiResetCold must be performed.
131  ///
133  ///
134  /// Used to induce an entry into a power state equivalent to the ACPI G2/S5 or G3
135  /// state. If the system does not support this reset type, then when the system
136  /// is rebooted, it should exhibit the EfiResetCold attributes.
137  ///
139  ///
140  /// Used to induce a system-wide reset. The exact type of the reset is defined by
141  /// the EFI_GUID that follows the Null-terminated Unicode string passed into
142  /// ResetData. If the platform does not recognize the EFI_GUID in ResetData the
143  /// platform must pick a supported reset type to perform. The platform may
144  /// optionally log the parameters from any non-normal reset that occurs.
145  ///
148 
149 ///
150 /// Data structure that precedes all of the standard EFI table types.
151 ///
152 typedef struct {
153  ///
154  /// A 64-bit signature that identifies the type of table that follows.
155  /// Unique signatures have been generated for the EFI System Table,
156  /// the EFI Boot Services Table, and the EFI Runtime Services Table.
157  ///
159  ///
160  /// The revision of the EFI Specification to which this table
161  /// conforms. The upper 16 bits of this field contain the major
162  /// revision value, and the lower 16 bits contain the minor revision
163  /// value. The minor revision values are limited to the range of 00..99.
164  ///
166  ///
167  /// The size, in bytes, of the entire table including the EFI_TABLE_HEADER.
168  ///
170  ///
171  /// The 32-bit CRC for the entire table. This value is computed by
172  /// setting this field to 0, and computing the 32-bit CRC for HeaderSize bytes.
173  ///
175  ///
176  /// Reserved field that must be set to 0.
177  ///
180 
181 ///
182 /// AuthInfo is a WIN_CERTIFICATE using the wCertificateType
183 /// WIN_CERTIFICATE_UEFI_GUID and the CertType
184 /// EFI_CERT_TYPE_RSA2048_SHA256_GUID. If the attribute specifies
185 /// authenticated access, then the Data buffer should begin with an
186 /// authentication descriptor prior to the data payload and DataSize
187 /// should reflect the the data.and descriptor size. The caller
188 /// shall digest the Monotonic Count value and the associated data
189 /// for the variable update using the SHA-256 1-way hash algorithm.
190 /// The ensuing the 32-byte digest will be signed using the private
191 /// key associated w/ the public/private 2048-bit RSA key-pair. The
192 /// WIN_CERTIFICATE shall be used to describe the signature of the
193 /// Variable data *Data. In addition, the signature will also
194 /// include the MonotonicCount value to guard against replay attacks.
195 ///
196 typedef struct {
197  ///
198  /// Included in the signature of
199  /// AuthInfo.Used to ensure freshness/no
200  /// replay. Incremented during each
201  /// "Write" access.
202  ///
204  ///
205  /// Provides the authorization for the variable
206  /// access. It is a signature across the
207  /// variable data and the Monotonic Count
208  /// value. Caller uses Private key that is
209  /// associated with a public key that has been
210  /// provisioned via the key exchange.
211  ///
214 
215 ///
216 /// When the attribute EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS is
217 /// set, then the Data buffer shall begin with an instance of a complete (and serialized)
218 /// EFI_VARIABLE_AUTHENTICATION_2 descriptor. The descriptor shall be followed by the new
219 /// variable value and DataSize shall reflect the combined size of the descriptor and the new
220 /// variable value. The authentication descriptor is not part of the variable data and is not
221 /// returned by subsequent calls to GetVariable().
222 ///
223 typedef struct {
224  ///
225  /// For the TimeStamp value, components Pad1, Nanosecond, TimeZone, Daylight and
226  /// Pad2 shall be set to 0. This means that the time shall always be expressed in GMT.
227  ///
229  ///
230  /// Only a CertType of EFI_CERT_TYPE_PKCS7_GUID is accepted.
231  ///
234 #endif // VFRCOMPILE
235 
236 #endif
UINT32 Reserved
Reserved field that must be set to 0.
EFI_RESET_TYPE
Enumeration of reset types.
UINT64 MonotonicCount
Included in the signature of AuthInfo.Used to ensure freshness/no replay.
A memory region that operates as EfiConventionalMemory, however it happens to also support byte-addre...
unsigned int UINT32
Definition: ProcessorBind.h:98
Certificate which encapsulates a GUID-specific digital signature.
UINT64 Signature
A 64-bit signature that identifies the type of table that follows.
WIN_CERTIFICATE_UEFI_GUID AuthInfo
Provides the authorization for the variable access.
A memory region that describes system memory that has not been accepted by a corresponding call to th...
Used to induce a system-wide reset.
UINT32 CRC32
The 32-bit CRC for the entire table.
The code portions of a loaded application.
WIN_CERTIFICATE_UEFI_GUID AuthInfo
Only a CertType of EFI_CERT_TYPE_PKCS7_GUID is accepted.
Used to induce a system-wide reset.
Used to induce a system-wide initialization.
EFI_MEMORY_TYPE
Enumeration of memory types introduced in UEFI.
Address space reserved by the firmware for code that is part of the processor.
Used by system firmware to request that a memory-mapped IO region be mapped by the OS to a virtual ad...
Memory that holds the ACPI tables.
EFI_TIME TimeStamp
For the TimeStamp value, components Pad1, Nanosecond, TimeZone, Daylight and Pad2 shall be set to 0.
The code portions of a loaded Boot Services Driver.
Free (unallocated) memory.
Used to induce an entry into a power state equivalent to the ACPI G2/S5 or G3 state.
UINT32 Revision
The revision of the EFI Specification to which this table conforms.
unsigned long long UINT64
Definition: ProcessorBind.h:96
System memory-mapped IO region that is used to translate memory cycles to IO cycles by the processor.
EFI Time Abstraction: Year: 1900 - 9999 Month: 1 - 12 Day: 1 - 31 Hour: 0 - 23 Minute: 0 - 59 Second:...
Definition: UefiBaseType.h:70
FILE_LICENCE(BSD2_PATENT)
The data portions of a loaded Runtime Services Driver and the default data allocation type used by a ...
GUID for UEFI WIN_CERTIFICATE structure.
The code portions of a loaded Runtime Services Driver.
When the attribute EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS is set, then the Data buffer sh...
Data structure that precedes all of the standard EFI table types.
Address space reserved for use by the firmware.
The data portions of a loaded Boot Serves Driver, and the default data allocation type used by a Boot...
AuthInfo is a WIN_CERTIFICATE using the wCertificateType WIN_CERTIFICATE_UEFI_GUID and the CertType E...
UINT32 HeaderSize
The size, in bytes, of the entire table including the EFI_TABLE_HEADER.
The data portions of a loaded application and the default data allocation type used by an application...
Memory in which errors have been detected.