[mirror_edk2.git] / EdkCompatibilityPkg / Foundation / Framework / Include / EfiImageFormat.h

/*++\r
\r
Copyright (c) 2004, Intel Corporation. All rights reserved.<BR>\r
This program and the accompanying materials                          \r
are licensed and made available under the terms and conditions of the BSD License         \r
which accompanies this distribution.  The full text of the license may be found at        \r
http://opensource.org/licenses/bsd-license.php                                            \r
                                                                                          \r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
\r
Module Name:\r
\r
  EfiImageFormat.h\r
\r
Abstract:\r
\r
  This file defines the data structures that are architecturally defined for file\r
  images loaded via the FirmwareVolume protocol.  The Firmware Volume specification\r
  is the basis for these definitions.\r
\r
--*/\r
\r
#ifndef _EFI_IMAGE_FORMAT_H_\r
#define _EFI_IMAGE_FORMAT_H_\r
\r
//\r
// pack all data structures since this is actually a binary format and we cannot\r
// allow internal padding in the data structures because of some compilerism..\r
//\r
#pragma pack(1)\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Architectural file types\r
//\r
typedef UINT8 EFI_FV_FILETYPE;\r
\r
#define EFI_FV_FILETYPE_ALL                   0x00\r
#define EFI_FV_FILETYPE_RAW                   0x01\r
#define EFI_FV_FILETYPE_FREEFORM              0x02\r
#define EFI_FV_FILETYPE_SECURITY_CORE         0x03\r
#define EFI_FV_FILETYPE_PEI_CORE              0x04\r
#define EFI_FV_FILETYPE_DXE_CORE              0x05\r
#define EFI_FV_FILETYPE_PEIM                  0x06\r
#define EFI_FV_FILETYPE_DRIVER                0x07\r
#define EFI_FV_FILETYPE_COMBINED_PEIM_DRIVER  0x08\r
#define EFI_FV_FILETYPE_APPLICATION           0x09\r
//\r
// File type 0x0A is reserved and should not be used\r
//\r
#define EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE 0x0B\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Section types\r
//\r
typedef UINT8 EFI_SECTION_TYPE;\r
\r
//\r
// ************************************************************\r
// The section type EFI_SECTION_ALL is a psuedo type.  It is\r
// used as a wildcard when retrieving sections.  The section\r
// type EFI_SECTION_ALL matches all section types.\r
// ************************************************************\r
//\r
#define EFI_SECTION_ALL 0x00\r
\r
//\r
// ************************************************************\r
// Encapsulation section Type values\r
// ************************************************************\r
//\r
#define EFI_SECTION_COMPRESSION   0x01\r
#define EFI_SECTION_GUID_DEFINED  0x02\r
\r
//\r
// ************************************************************\r
// Leaf section Type values\r
// ************************************************************\r
//\r
#define EFI_SECTION_FIRST_LEAF_SECTION_TYPE 0x10\r
\r
#define EFI_SECTION_PE32                    0x10\r
#define EFI_SECTION_PIC                     0x11\r
#define EFI_SECTION_TE                      0x12\r
#define EFI_SECTION_DXE_DEPEX               0x13\r
#define EFI_SECTION_VERSION                 0x14\r
#define EFI_SECTION_USER_INTERFACE          0x15\r
#define EFI_SECTION_COMPATIBILITY16         0x16\r
#define EFI_SECTION_FIRMWARE_VOLUME_IMAGE   0x17\r
#define EFI_SECTION_FREEFORM_SUBTYPE_GUID   0x18\r
#define EFI_SECTION_RAW                     0x19\r
#define EFI_SECTION_PEI_DEPEX               0x1B\r
\r
#define EFI_SECTION_LAST_LEAF_SECTION_TYPE  0x1B\r
#define EFI_SECTION_LAST_SECTION_TYPE       0x1B\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Common section header\r
//\r
typedef struct {\r
  UINT8 Size[3];\r
  UINT8 Type;\r
} EFI_COMMON_SECTION_HEADER;\r
\r
#define SECTION_SIZE(SectionHeaderPtr) \\r
    ((UINT32) (*((UINT32 *) ((EFI_COMMON_SECTION_HEADER *) SectionHeaderPtr)->Size) & 0x00ffffff))\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Compression section\r
//\r
//\r
// CompressionType values\r
//\r
#define EFI_NOT_COMPRESSED          0x00\r
#define EFI_STANDARD_COMPRESSION    0x01\r
#define EFI_CUSTOMIZED_COMPRESSION  0x02\r
\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
  UINT32                    UncompressedLength;\r
  UINT8                     CompressionType;\r
} EFI_COMPRESSION_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// GUID defined section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
  EFI_GUID                  SectionDefinitionGuid;\r
  UINT16                    DataOffset;\r
  UINT16                    Attributes;\r
} EFI_GUID_DEFINED_SECTION;\r
\r
//\r
// Bit values for Attributes\r
//\r
#define EFI_GUIDED_SECTION_PROCESSING_REQUIRED  0x01\r
#define EFI_GUIDED_SECTION_AUTH_STATUS_VALID    0x02\r
\r
//\r
// Bit values for AuthenticationStatus\r
//\r
#define EFI_AGGREGATE_AUTH_STATUS_PLATFORM_OVERRIDE 0x000001\r
#define EFI_AGGREGATE_AUTH_STATUS_IMAGE_SIGNED      0x000002\r
#define EFI_AGGREGATE_AUTH_STATUS_NOT_TESTED        0x000004\r
#define EFI_AGGREGATE_AUTH_STATUS_TEST_FAILED       0x000008\r
#define EFI_AGGREGATE_AUTH_STATUS_ALL               0x00000f\r
\r
#define EFI_LOCAL_AUTH_STATUS_PLATFORM_OVERRIDE     0x010000\r
#define EFI_LOCAL_AUTH_STATUS_IMAGE_SIGNED          0x020000\r
#define EFI_LOCAL_AUTH_STATUS_NOT_TESTED            0x040000\r
#define EFI_LOCAL_AUTH_STATUS_TEST_FAILED           0x080000\r
#define EFI_LOCAL_AUTH_STATUS_ALL                   0x0f0000\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// PE32+ section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_PE32_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// PIC section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_PIC_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// PEIM header section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_PEIM_HEADER_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// DEPEX section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_DEPEX_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Version section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
  UINT16                    BuildNumber;\r
  INT16                     VersionString[1];\r
} EFI_VERSION_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// User interface section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
  INT16                     FileNameString[1];\r
} EFI_USER_INTERFACE_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Code16 section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_CODE16_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Firmware Volume Image section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_FIRMWARE_VOLUME_IMAGE_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Freeform subtype GUID section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
  EFI_GUID                  SubTypeGuid;\r
} EFI_FREEFORM_SUBTYPE_GUID_SECTION;\r
\r
//\r
// ////////////////////////////////////////////////////////////////////////////\r
//\r
// Raw section\r
//\r
typedef struct {\r
  EFI_COMMON_SECTION_HEADER CommonHeader;\r
} EFI_RAW_SECTION;\r
\r
//\r
// undo the pragma from the beginning...\r
//\r
#pragma pack()\r
\r
typedef union {\r
  EFI_COMMON_SECTION_HEADER         *CommonHeader;\r
  EFI_COMPRESSION_SECTION           *CompressionSection;\r
  EFI_GUID_DEFINED_SECTION          *GuidDefinedSection;\r
  EFI_PE32_SECTION                  *Pe32Section;\r
  EFI_PIC_SECTION                   *PicSection;\r
  EFI_PEIM_HEADER_SECTION           *PeimHeaderSection;\r
  EFI_DEPEX_SECTION                 *DependencySection;\r
  EFI_VERSION_SECTION               *VersionSection;\r
  EFI_USER_INTERFACE_SECTION        *UISection;\r
  EFI_CODE16_SECTION                *Code16Section;\r
  EFI_FIRMWARE_VOLUME_IMAGE_SECTION *FVImageSection;\r
  EFI_FREEFORM_SUBTYPE_GUID_SECTION *FreeformSubtypeSection;\r
  EFI_RAW_SECTION                   *RawSection;\r
} EFI_FILE_SECTION_POINTER;\r
\r
#endif\r
Commit	Line	Data
3eb9473e	1	/*++\r
3eb9473e	2	\r
f57387d5 HT	3	Copyright (c) 2004, Intel Corporation. All rights reserved.<BR>\r
f57387d5 HT	4	This program and the accompanying materials \r
3eb9473e	5	are licensed and made available under the terms and conditions of the BSD License \r
	6	which accompanies this distribution. The full text of the license may be found at \r
	7	http://opensource.org/licenses/bsd-license.php \r
	8	\r
	9	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	10	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	11	\r
	12	Module Name:\r
	13	\r
	14	EfiImageFormat.h\r
	15	\r
	16	Abstract:\r
	17	\r
	18	This file defines the data structures that are architecturally defined for file\r
	19	images loaded via the FirmwareVolume protocol. The Firmware Volume specification\r
	20	is the basis for these definitions.\r
	21	\r
	22	--*/\r
	23	\r
	24	#ifndef _EFI_IMAGE_FORMAT_H_\r
	25	#define _EFI_IMAGE_FORMAT_H_\r
	26	\r
	27	//\r
	28	// pack all data structures since this is actually a binary format and we cannot\r
	29	// allow internal padding in the data structures because of some compilerism..\r
	30	//\r
	31	#pragma pack(1)\r
	32	//\r
	33	// ////////////////////////////////////////////////////////////////////////////\r
	34	//\r
	35	// Architectural file types\r
	36	//\r
	37	typedef UINT8 EFI_FV_FILETYPE;\r
	38	\r
	39	#define EFI_FV_FILETYPE_ALL 0x00\r
	40	#define EFI_FV_FILETYPE_RAW 0x01\r
	41	#define EFI_FV_FILETYPE_FREEFORM 0x02\r
	42	#define EFI_FV_FILETYPE_SECURITY_CORE 0x03\r
	43	#define EFI_FV_FILETYPE_PEI_CORE 0x04\r
	44	#define EFI_FV_FILETYPE_DXE_CORE 0x05\r
	45	#define EFI_FV_FILETYPE_PEIM 0x06\r
	46	#define EFI_FV_FILETYPE_DRIVER 0x07\r
	47	#define EFI_FV_FILETYPE_COMBINED_PEIM_DRIVER 0x08\r
	48	#define EFI_FV_FILETYPE_APPLICATION 0x09\r
	49	//\r
	50	// File type 0x0A is reserved and should not be used\r
	51	//\r
	52	#define EFI_FV_FILETYPE_FIRMWARE_VOLUME_IMAGE 0x0B\r
	53	\r
	54	//\r
	55	// ////////////////////////////////////////////////////////////////////////////\r
	56	//\r
	57	// Section types\r
	58	//\r
	59	typedef UINT8 EFI_SECTION_TYPE;\r
	60	\r
	61	//\r
	62	// ************************************************************\r
	63	// The section type EFI_SECTION_ALL is a psuedo type. It is\r
	64	// used as a wildcard when retrieving sections. The section\r
	65	// type EFI_SECTION_ALL matches all section types.\r
	66	// ************************************************************\r
	67	//\r
	68	#define EFI_SECTION_ALL 0x00\r
69	\r
70	//\r
71	// ************************************************************\r
72	// Encapsulation section Type values\r
73	// ************************************************************\r
74	//\r
75	#define EFI_SECTION_COMPRESSION 0x01\r
76	#define EFI_SECTION_GUID_DEFINED 0x02\r
77	\r
78	//\r
79	// ************************************************************\r
80	// Leaf section Type values\r
81	// ************************************************************\r
82	//\r
83	#define EFI_SECTION_FIRST_LEAF_SECTION_TYPE 0x10\r
84	\r
85	#define EFI_SECTION_PE32 0x10\r
86	#define EFI_SECTION_PIC 0x11\r
87	#define EFI_SECTION_TE 0x12\r
88	#define EFI_SECTION_DXE_DEPEX 0x13\r
89	#define EFI_SECTION_VERSION 0x14\r
90	#define EFI_SECTION_USER_INTERFACE 0x15\r
91	#define EFI_SECTION_COMPATIBILITY16 0x16\r
92	#define EFI_SECTION_FIRMWARE_VOLUME_IMAGE 0x17\r
93	#define EFI_SECTION_FREEFORM_SUBTYPE_GUID 0x18\r
94	#define EFI_SECTION_RAW 0x19\r
95	#define EFI_SECTION_PEI_DEPEX 0x1B\r
96	\r
97	#define EFI_SECTION_LAST_LEAF_SECTION_TYPE 0x1B\r
98	#define EFI_SECTION_LAST_SECTION_TYPE 0x1B\r
99	\r
100	//\r
101	// ////////////////////////////////////////////////////////////////////////////\r
102	//\r
103	// Common section header\r
104	//\r
105	typedef struct {\r
106	UINT8 Size[3];\r
107	UINT8 Type;\r
108	} EFI_COMMON_SECTION_HEADER;\r
109	\r
110	#define SECTION_SIZE(SectionHeaderPtr) \\r
111	((UINT32) (((UINT32 ) ((EFI_COMMON_SECTION_HEADER *) SectionHeaderPtr)->Size) & 0x00ffffff))\r
112	\r
113	//\r
114	// ////////////////////////////////////////////////////////////////////////////\r
115	//\r
116	// Compression section\r
117	//\r
118	//\r
119	// CompressionType values\r
120	//\r
121	#define EFI_NOT_COMPRESSED 0x00\r
122	#define EFI_STANDARD_COMPRESSION 0x01\r
123	#define EFI_CUSTOMIZED_COMPRESSION 0x02\r
124	\r
125	typedef struct {\r
126	EFI_COMMON_SECTION_HEADER CommonHeader;\r
127	UINT32 UncompressedLength;\r
128	UINT8 CompressionType;\r
129	} EFI_COMPRESSION_SECTION;\r
130	\r
131	//\r
132	// ////////////////////////////////////////////////////////////////////////////\r
133	//\r
134	// GUID defined section\r
135	//\r
136	typedef struct {\r
137	EFI_COMMON_SECTION_HEADER CommonHeader;\r
138	EFI_GUID SectionDefinitionGuid;\r
139	UINT16 DataOffset;\r
140	UINT16 Attributes;\r
141	} EFI_GUID_DEFINED_SECTION;\r
142	\r
143	//\r
144	// Bit values for Attributes\r
145	//\r
146	#define EFI_GUIDED_SECTION_PROCESSING_REQUIRED 0x01\r
147	#define EFI_GUIDED_SECTION_AUTH_STATUS_VALID 0x02\r
148	\r
149	//\r
150	// Bit values for AuthenticationStatus\r
151	//\r
152	#define EFI_AGGREGATE_AUTH_STATUS_PLATFORM_OVERRIDE 0x000001\r
153	#define EFI_AGGREGATE_AUTH_STATUS_IMAGE_SIGNED 0x000002\r
154	#define EFI_AGGREGATE_AUTH_STATUS_NOT_TESTED 0x000004\r
155	#define EFI_AGGREGATE_AUTH_STATUS_TEST_FAILED 0x000008\r
156	#define EFI_AGGREGATE_AUTH_STATUS_ALL 0x00000f\r
157	\r
158	#define EFI_LOCAL_AUTH_STATUS_PLATFORM_OVERRIDE 0x010000\r
159	#define EFI_LOCAL_AUTH_STATUS_IMAGE_SIGNED 0x020000\r
160	#define EFI_LOCAL_AUTH_STATUS_NOT_TESTED 0x040000\r
161	#define EFI_LOCAL_AUTH_STATUS_TEST_FAILED 0x080000\r
162	#define EFI_LOCAL_AUTH_STATUS_ALL 0x0f0000\r
163	\r
164	//\r
165	// ////////////////////////////////////////////////////////////////////////////\r
166	//\r
167	// PE32+ section\r
168	//\r
169	typedef struct {\r
170	EFI_COMMON_SECTION_HEADER CommonHeader;\r
171	} EFI_PE32_SECTION;\r
172	\r
173	//\r
174	// ////////////////////////////////////////////////////////////////////////////\r
175	//\r
176	// PIC section\r
177	//\r
178	typedef struct {\r
179	EFI_COMMON_SECTION_HEADER CommonHeader;\r
180	} EFI_PIC_SECTION;\r
181	\r
182	//\r
183	// ////////////////////////////////////////////////////////////////////////////\r
184	//\r
185	// PEIM header section\r
186	//\r
187	typedef struct {\r
188	EFI_COMMON_SECTION_HEADER CommonHeader;\r
189	} EFI_PEIM_HEADER_SECTION;\r
190	\r
191	//\r
192	// ////////////////////////////////////////////////////////////////////////////\r
193	//\r
194	// DEPEX section\r
195	//\r
196	typedef struct {\r
197	EFI_COMMON_SECTION_HEADER CommonHeader;\r
198	} EFI_DEPEX_SECTION;\r
199	\r
200	//\r
201	// ////////////////////////////////////////////////////////////////////////////\r
202	//\r
203	// Version section\r
204	//\r
205	typedef struct {\r
206	EFI_COMMON_SECTION_HEADER CommonHeader;\r
207	UINT16 BuildNumber;\r
208	INT16 VersionString[1];\r
209	} EFI_VERSION_SECTION;\r
210	\r
211	//\r
212	// ////////////////////////////////////////////////////////////////////////////\r
213	//\r
214	// User interface section\r
215	//\r
216	typedef struct {\r
217	EFI_COMMON_SECTION_HEADER CommonHeader;\r
218	INT16 FileNameString[1];\r
219	} EFI_USER_INTERFACE_SECTION;\r
220	\r
221	//\r
222	// ////////////////////////////////////////////////////////////////////////////\r
223	//\r
224	// Code16 section\r
225	//\r
226	typedef struct {\r
227	EFI_COMMON_SECTION_HEADER CommonHeader;\r
228	} EFI_CODE16_SECTION;\r
229	\r
230	//\r
231	// ////////////////////////////////////////////////////////////////////////////\r
232	//\r
233	// Firmware Volume Image section\r
234	//\r
235	typedef struct {\r
236	EFI_COMMON_SECTION_HEADER CommonHeader;\r
237	} EFI_FIRMWARE_VOLUME_IMAGE_SECTION;\r
238	\r
239	//\r
240	// ////////////////////////////////////////////////////////////////////////////\r
241	//\r
242	// Freeform subtype GUID section\r
243	//\r
244	typedef struct {\r
245	EFI_COMMON_SECTION_HEADER CommonHeader;\r
246	EFI_GUID SubTypeGuid;\r
247	} EFI_FREEFORM_SUBTYPE_GUID_SECTION;\r
248	\r
249	//\r
250	// ////////////////////////////////////////////////////////////////////////////\r
251	//\r
252	// Raw section\r
253	//\r
254	typedef struct {\r
255	EFI_COMMON_SECTION_HEADER CommonHeader;\r
256	} EFI_RAW_SECTION;\r
257	\r
258	//\r
259	// undo the pragma from the beginning...\r
260	//\r
261	#pragma pack()\r
262	\r
263	typedef union {\r
264	EFI_COMMON_SECTION_HEADER *CommonHeader;\r
265	EFI_COMPRESSION_SECTION *CompressionSection;\r
266	EFI_GUID_DEFINED_SECTION *GuidDefinedSection;\r
267	EFI_PE32_SECTION *Pe32Section;\r
268	EFI_PIC_SECTION *PicSection;\r
269	EFI_PEIM_HEADER_SECTION *PeimHeaderSection;\r
270	EFI_DEPEX_SECTION *DependencySection;\r
271	EFI_VERSION_SECTION *VersionSection;\r
272	EFI_USER_INTERFACE_SECTION *UISection;\r
273	EFI_CODE16_SECTION *Code16Section;\r
274	EFI_FIRMWARE_VOLUME_IMAGE_SECTION *FVImageSection;\r
275	EFI_FREEFORM_SUBTYPE_GUID_SECTION *FreeformSubtypeSection;\r
276	EFI_RAW_SECTION *RawSection;\r
277	} EFI_FILE_SECTION_POINTER;\r
278	\r
279	#endif\r