/** @file\r
Master header file for DxeIpl PEIM. All source files in this module should\r
- include this file for common defininitions.\r
+ include this file for common definitions.\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. This program and the accompanying materials\r
#define BSP_STORE_SIZE 0x4000\r
\r
\r
-//\r
-// This macro aligns the ActualSize with a given alignment and is used to \r
-// calculate the size an image occupies.\r
-//\r
-#define GET_OCCUPIED_SIZE(ActualSize, Alignment) ((ActualSize + (Alignment - 1)) & ~(Alignment - 1))\r
-\r
-//\r
-// Indicate whether DxeIpl has been shadowed to memory.\r
-//\r
-extern BOOLEAN gInMemory;\r
-\r
//\r
// This PPI is installed to indicate the end of the PEI usage of memory \r
//\r
\r
\r
/**\r
- This function simply retrieves the function pointer of ImageRead in\r
- ImageContext structure.\r
- \r
- @param ImageContext A pointer to the structure of \r
- PE_COFF_LOADER_IMAGE_CONTEXT\r
- \r
- @retval EFI_SUCCESS This function always return EFI_SUCCESS.\r
+ Support routine for the PE/COFF Loader that reads a buffer from a PE/COFF file\r
+\r
+ @param FileHandle The handle to the PE/COFF file \r
+ @param FileOffset The offset, in bytes, into the file to read \r
+ @param ReadSize The number of bytes to read from the file starting at \r
+ FileOffset \r
+ @param Buffer A pointer to the buffer to read the data into. \r
+\r
+ @retval EFI_SUCCESS ReadSize bytes of data were read into Buffer from the \r
+ PE/COFF file starting at FileOffset\r
\r
**/\r
EFI_STATUS\r
-GetImageReadFunction (\r
- IN PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext\r
+PeiImageRead (\r
+ IN VOID *FileHandle,\r
+ IN UINTN FileOffset,\r
+ IN OUT UINTN *ReadSize,\r
+ OUT VOID *Buffer\r
);\r
\r
\r
\r
This function performs a CPU architecture specific operations to execute\r
the entry point of DxeCore with the parameters of HobList.\r
- It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
+ It also installs EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
\r
- @param DxeCoreEntryPoint The entrypoint of DxeCore.\r
+ @param DxeCoreEntryPoint The entry point of DxeCore.\r
@param HobList The start of HobList passed to DxeCore.\r
\r
**/\r
/**\r
Decompresses a section to the output buffer.\r
\r
- This function lookes up the compression type field in the input section and\r
+ This function looks up the compression type field in the input section and\r
applies the appropriate compression algorithm to compress the section to a\r
callee allocated buffer.\r
\r
#/** @file\r
+# Last PEIM executed in PEI phase to load DXE Core from a Firmware Volume.\r
# \r
-# The responsibility of this module is to load the DXE Core from a Firmware Volume.\r
-# This implementation is used to load a 32-bit DXE Core.\r
-# \r
+# This module produces a special PPI named the DXE Initial Program Load (IPL)\r
+# PPI to discover and dispatch the DXE Foundation and components that are\r
+# needed to run the DXE Foundation.\r
+#\r
# Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
# All rights reserved. This program and the accompanying materials\r
# are licensed and made available under the terms and conditions of the BSD License\r
[Ppis]\r
gEfiEndOfPeiSignalPpiGuid # PPI SOMETIMES_PRODUCED\r
gEfiDxeIplPpiGuid # PPI SOMETIMES_PRODUCED\r
- gEfiPeiDecompressPpiGuid\r
- gEfiPeiReadOnlyVariable2PpiGuid\r
+ gEfiPeiDecompressPpiGuid # PPI SOMETIMES_PRODUCED\r
+ gEfiPeiReadOnlyVariable2PpiGuid # PPI SOMETIMES_CONSUMED\r
\r
[Guids]\r
gEfiMemoryTypeInformationGuid\r
\r
#include "DxeIpl.h"\r
\r
-//\r
-// This global variable indicates whether this module has been shadowed\r
-// to memory.\r
-//\r
-BOOLEAN gInMemory = FALSE;\r
\r
//\r
-// Module Globals used in the DXE to PEI handoff\r
+// Module Globals used in the DXE to PEI hand off\r
// These must be module globals, so the stack can be switched\r
//\r
CONST EFI_DXE_IPL_PPI mDxeIplPpi = {\r
Decompress\r
};\r
\r
-CONST EFI_PEI_PPI_DESCRIPTOR mPpiList[] = {\r
+CONST EFI_PEI_PPI_DESCRIPTOR mPpiList[] = {\r
{\r
EFI_PEI_PPI_DESCRIPTOR_PPI,\r
&gEfiDxeIplPpiGuid,\r
}\r
};\r
\r
-CONST EFI_PEI_PPI_DESCRIPTOR gEndOfPeiSignalPpi = {\r
+CONST EFI_PEI_PPI_DESCRIPTOR gEndOfPeiSignalPpi = {\r
(EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST),\r
&gEfiEndOfPeiSignalPpiGuid,\r
NULL\r
};\r
\r
/**\r
- Initializes the Dxe Ipl PPI\r
+ Entry point of DXE IPL PEIM.\r
+ \r
+ This function installs DXE IPL PPI and Decompress PPI. It also reloads\r
+ itself to memory on non-S3 resume boot path.\r
\r
@param FileHandle Handle of the file being invoked.\r
@param PeiServices Describes the list of possible PEI Services.\r
\r
- @return EFI_SUCESS\r
+ @retval EFI_SUCESS The entry point of DXE IPL PEIM executes successfully.\r
+ @retval Others Some error occurs during the execution of this function. \r
+\r
**/\r
EFI_STATUS\r
EFIAPI\r
Status = PeiServicesRegisterForShadow (FileHandle);\r
if (Status == EFI_SUCCESS) {\r
//\r
- // EFI_SUCESS means the first time call register for shadow \r
+ // EFI_SUCESS means it is the first time to call register for shadow. \r
// \r
return Status;\r
- } else if (Status == EFI_ALREADY_STARTED) {\r
+ }\r
+ \r
+ //\r
+ // Ensure that DXE IPL is shadowed to permanent memory.\r
+ //\r
+ ASSERT (Status == EFI_ALREADY_STARTED);\r
\r
- //\r
- // Get custom extract guided section method guid list \r
- //\r
- ExtractHandlerNumber = ExtractGuidedSectionGetGuidList (&ExtractHandlerGuidTable);\r
- \r
- //\r
- // Install custom extraction guid ppi\r
- //\r
- if (ExtractHandlerNumber > 0) {\r
- GuidPpi = (EFI_PEI_PPI_DESCRIPTOR *) AllocatePool (ExtractHandlerNumber * sizeof (EFI_PEI_PPI_DESCRIPTOR));\r
- ASSERT (GuidPpi != NULL);\r
- while (ExtractHandlerNumber-- > 0) {\r
- GuidPpi->Flags = EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST;\r
- GuidPpi->Ppi = (VOID *) &mCustomGuidedSectionExtractionPpi;\r
- GuidPpi->Guid = &(ExtractHandlerGuidTable [ExtractHandlerNumber]);\r
- Status = PeiServicesInstallPpi (GuidPpi++);\r
- ASSERT_EFI_ERROR(Status);\r
- }\r
+ //\r
+ // Get custom extract guided section method guid list \r
+ //\r
+ ExtractHandlerNumber = ExtractGuidedSectionGetGuidList (&ExtractHandlerGuidTable);\r
+ \r
+ //\r
+ // Install custom extraction guid PPI\r
+ //\r
+ if (ExtractHandlerNumber > 0) {\r
+ GuidPpi = (EFI_PEI_PPI_DESCRIPTOR *) AllocatePool (ExtractHandlerNumber * sizeof (EFI_PEI_PPI_DESCRIPTOR));\r
+ ASSERT (GuidPpi != NULL);\r
+ while (ExtractHandlerNumber-- > 0) {\r
+ GuidPpi->Flags = EFI_PEI_PPI_DESCRIPTOR_PPI | EFI_PEI_PPI_DESCRIPTOR_TERMINATE_LIST;\r
+ GuidPpi->Ppi = (VOID *) &mCustomGuidedSectionExtractionPpi;\r
+ GuidPpi->Guid = &ExtractHandlerGuidTable[ExtractHandlerNumber];\r
+ Status = PeiServicesInstallPpi (GuidPpi++);\r
+ ASSERT_EFI_ERROR(Status);\r
}\r
- } else {\r
- ASSERT (FALSE);\r
}\r
+ \r
}\r
\r
//\r
\r
/**\r
Main entry point to last PEIM. \r
+\r
+ This function finds DXE Core in the firmware volume and transfer the control to\r
+ DXE core.\r
\r
@param This Entry point for DXE IPL PPI.\r
@param PeiServices General purpose services available to every PEIM.\r
}\r
\r
//\r
- // Now should have a HOB with the DXE core w/ the old HOB destroyed\r
+ // Now should have a HOB with the DXE core\r
//\r
}\r
\r
FileHandle = DxeIplFindDxeCore ();\r
\r
//\r
- // Load the DXE Core from a Firmware Volume, may use LoadFile ppi to do this for save code size.\r
+ // Load the DXE Core from a Firmware Volume, may use LoadFile PPI to do this to save code size.\r
//\r
Status = PeiLoadFile (\r
FileHandle,\r
BuildModuleHob (\r
&DxeCoreFileInfo.FileName,\r
DxeCoreAddress,\r
- EFI_SIZE_TO_PAGES ((UINTN) DxeCoreSize) * EFI_PAGE_SIZE,\r
+ ALIGN_VALUE (DxeCoreSize, EFI_PAGE_SIZE),\r
DxeCoreEntryPoint\r
);\r
\r
//\r
// Report Status Code EFI_SW_PEI_PC_HANDOFF_TO_NEXT\r
//\r
- REPORT_STATUS_CODE (\r
- EFI_PROGRESS_CODE,\r
- PcdGet32(PcdStatusCodeValuePeiHandoffToDxe)\r
- );\r
+ REPORT_STATUS_CODE (EFI_PROGRESS_CODE, PcdGet32 (PcdStatusCodeValuePeiHandoffToDxe));\r
\r
DEBUG ((DEBUG_INFO | DEBUG_LOAD, "Loading DXE CORE at 0x%11p EntryPoint=0x%11p\n", (VOID *)(UINTN)DxeCoreAddress, FUNCTION_ENTRY_POINT (DxeCoreEntryPoint)));\r
\r
//\r
// Transfer control to the DXE Core\r
- // The handoff state is simply a pointer to the HOB list\r
+ // The hand off state is simply a pointer to the HOB list\r
//\r
HandOffToDxeCore (DxeCoreEntryPoint, HobList);\r
//\r
// If we get here, then the DXE Core returned. This is an error\r
- // Dxe Core should not return.\r
+ // DxeCore should not return.\r
//\r
ASSERT (FALSE);\r
CpuDeadLoop ();\r
\r
ZeroMem (&ImageContext, sizeof (ImageContext));\r
ImageContext.Handle = Pe32Data;\r
- Status = GetImageReadFunction (&ImageContext);\r
+ ImageContext.ImageRead = PeiImageRead;\r
\r
- ASSERT_EFI_ERROR (Status);\r
\r
Status = PeCoffLoaderGetImageInfo (&ImageContext);\r
if (EFI_ERROR (Status)) {\r
}\r
\r
//\r
- // Flush the instruction cache so the image data is written before we execute it\r
+ // Flush the instruction cache so the image data are written before we execute it\r
//\r
- InvalidateInstructionCacheRange ((VOID *)(UINTN)ImageContext.ImageAddress, (UINTN)ImageContext.ImageSize);\r
+ InvalidateInstructionCacheRange ((VOID *)(UINTN) ImageContext.ImageAddress, (UINTN) ImageContext.ImageSize);\r
\r
*ImageAddress = ImageContext.ImageAddress;\r
*ImageSize = ImageContext.ImageSize;\r
if (*OutputBuffer == NULL) {\r
return EFI_OUT_OF_RESOURCES;\r
}\r
- DEBUG ((DEBUG_INFO, "Customed Guided section Memory Size required is 0x%x and address is 0x%p\n", OutputBufferSize, *OutputBuffer));\r
+ DEBUG ((DEBUG_INFO, "Customized Guided section Memory Size required is 0x%x and address is 0x%p\n", OutputBufferSize, *OutputBuffer));\r
//\r
// *OutputBuffer still is one section. Adjust *OutputBuffer offset, \r
// skip EFI section header to make section data at page alignment.\r
OutputBuffer,\r
ScratchBuffer,\r
AuthenticationStatus\r
- );\r
+ );\r
if (EFI_ERROR (Status)) {\r
//\r
// Decode failed\r
/**\r
Decompresses a section to the output buffer.\r
\r
- This function lookes up the compression type field in the input section and\r
+ This function looks up the compression type field in the input section and\r
applies the appropriate compression algorithm to compress the section to a\r
callee allocated buffer.\r
\r
case EFI_STANDARD_COMPRESSION:\r
//\r
// Load EFI standard compression.\r
- // For compressed data, decompress them to dstbuffer.\r
+ // For compressed data, decompress them to destination buffer.\r
//\r
Status = UefiDecompressGetInfo (\r
(UINT8 *) ((EFI_COMPRESSION_SECTION *) Section + 1),\r
}\r
\r
\r
-\r
-\r
/**\r
Updates the Stack HOB passed to DXE phase.\r
\r
/** @file\r
- x64-specifc functionality for DxeLoad.\r
+ EBC-specific functionality for DxeLoad.\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. This program and the accompanying materials\r
\r
This function performs a CPU architecture specific operations to execute\r
the entry point of DxeCore with the parameters of HobList.\r
- It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
+ It also installs EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
\r
- @param DxeCoreEntryPoint The entrypoint of DxeCore.\r
+ @param DxeCoreEntryPoint The entry point of DxeCore.\r
@param HobList The start of HobList passed to DxeCore.\r
\r
**/\r
TopOfStack = ALIGN_POINTER (TopOfStack, CPU_STACK_ALIGNMENT);\r
\r
//\r
- // End of PEI phase singal\r
+ // End of PEI phase signal\r
//\r
Status = PeiServicesInstallPpi (&gEndOfPeiSignalPpi);\r
ASSERT_EFI_ERROR (Status);\r
/** @file\r
- Ia32-specifc functionality for DxeLoad.\r
+ Ia32-specific functionality for DxeLoad.\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. This program and the accompanying materials\r
\r
This function performs a CPU architecture specific operations to execute\r
the entry point of DxeCore with the parameters of HobList.\r
- It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
+ It also installs EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
\r
- @param DxeCoreEntryPoint The entrypoint of DxeCore.\r
+ @param DxeCoreEntryPoint The entry point of DxeCore.\r
@param HobList The start of HobList passed to DxeCore.\r
\r
**/\r
PageTables = CreateIdentityMappingPageTables ();\r
\r
//\r
- // End of PEI phase singal\r
+ // End of PEI phase signal\r
//\r
Status = PeiServicesInstallPpi (&gEndOfPeiSignalPpi);\r
ASSERT_EFI_ERROR (Status);\r
TopOfStack = (EFI_PHYSICAL_ADDRESS) (UINTN) ALIGN_POINTER (TopOfStack, CPU_STACK_ALIGNMENT);\r
\r
//\r
- // End of PEI phase singal\r
+ // End of PEI phase signal\r
//\r
Status = PeiServicesInstallPpi (&gEndOfPeiSignalPpi);\r
ASSERT_EFI_ERROR (Status);\r
\r
return EFI_SUCCESS;\r
}\r
-\r
-\r
-/**\r
- This function simply retrieves the function pointer of ImageRead in\r
- ImageContext structure.\r
- \r
- @param ImageContext A pointer to the structure of \r
- PE_COFF_LOADER_IMAGE_CONTEXT\r
- \r
- @retval EFI_SUCCESS This function always returns EFI_SUCCESS.\r
-\r
-**/\r
-EFI_STATUS\r
-GetImageReadFunction (\r
- IN PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext\r
- )\r
-{\r
- VOID *MemoryBuffer;\r
-\r
- if (gInMemory) {\r
- ImageContext->ImageRead = PeiImageRead;\r
- return EFI_SUCCESS;\r
- }\r
-\r
- //\r
- // BugBug; This code assumes PeiImageRead() is less than a page in size!\r
- // Allocate a page so we can shaddow the read function from FLASH into \r
- // memory to increase performance. \r
- //\r
- \r
- MemoryBuffer = AllocateCopyPool (0x400, (VOID *)(UINTN) PeiImageRead);\r
- ASSERT (MemoryBuffer != NULL);\r
-\r
- ImageContext->ImageRead = (PE_COFF_LOADER_READ_FILE) (UINTN) MemoryBuffer;\r
-\r
- return EFI_SUCCESS;\r
-}\r
enter Long Mode (x64 64-bit mode).\r
\r
While we make a 1:1 mapping (identity mapping) for all physical pages \r
- we still need to use the MTRR's to ensure that the cachability attirbutes\r
+ we still need to use the MTRR's to ensure that the cachability attributes\r
for all memory regions is correct.\r
\r
The basic idea is to use 2MB page table entries where ever possible. If\r
more granularity of cachability is required then 4K page tables are used.\r
\r
References:\r
- 1) IA-32 Intel(R) Atchitecture Software Developer's Manual Volume 1:Basic Architecture, Intel\r
- 2) IA-32 Intel(R) Atchitecture Software Developer's Manual Volume 2:Instruction Set Reference, Intel\r
- 3) IA-32 Intel(R) Atchitecture Software Developer's Manual Volume 3:System Programmer's Guide, Intel\r
+ 1) IA-32 Intel(R) Architecture Software Developer's Manual Volume 1:Basic Architecture, Intel\r
+ 2) IA-32 Intel(R) Architecture Software Developer's Manual Volume 2:Instruction Set Reference, Intel\r
+ 3) IA-32 Intel(R) Architecture Software Developer's Manual Volume 3:System Programmer's Guide, Intel\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. This program and the accompanying materials\r
#include "DxeIpl.h"\r
#include "VirtualMemory.h"\r
\r
-\r
-\r
-\r
-\r
-\r
/**\r
Allocates and fills in the Page Directory and Page Table Entries to\r
establish a 1:1 Virtual to Physical mapping.\r
table entries to the physical \r
address space. \r
\r
- @return EFI_SUCCESS The 1:1 Virtual to Physical identity mapping was created\r
+ @return The address of 4 level page map.\r
\r
**/\r
UINTN\r
table entries to the physical \r
address space. \r
\r
- @return EFI_SUCCESS The 1:1 Virtual to Physical identity mapping was created\r
+ @return The address of 4 level page map.\r
\r
**/\r
UINTN\r
);\r
\r
\r
-\r
-\r
-\r
/**\r
\r
Fix up the vector number in the vector code.\r
/** @file\r
- Ipf-specifc functionality for DxeLoad.\r
+ Ipf-specific functionality for DxeLoad.\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. This program and the accompanying materials\r
\r
This function performs a CPU architecture specific operations to execute\r
the entry point of DxeCore with the parameters of HobList.\r
- It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
+ It also installs EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
\r
- @param DxeCoreEntryPoint The entrypoint of DxeCore.\r
+ @param DxeCoreEntryPoint The entry point of DxeCore.\r
@param HobList The start of HobList passed to DxeCore.\r
\r
**/\r
TopOfStack = ALIGN_POINTER (TopOfStack, CPU_STACK_ALIGNMENT);\r
\r
//\r
- // End of PEI phase singal\r
+ // End of PEI phase signal\r
//\r
Status = PeiServicesInstallPpi (&gEndOfPeiSignalPpi);\r
ASSERT_EFI_ERROR (Status);\r
return EFI_SUCCESS;\r
}\r
\r
-\r
-/**\r
- This function simply retrieves the function pointer of ImageRead in\r
- ImageContext structure.\r
- \r
- @param ImageContext A pointer to the structure of \r
- PE_COFF_LOADER_IMAGE_CONTEXT\r
- \r
- @retval EFI_SUCCESS This function always returns EFI_SUCCESS.\r
-\r
-**/\r
-EFI_STATUS\r
-GetImageReadFunction (\r
- IN PE_COFF_LOADER_IMAGE_CONTEXT *ImageContext\r
- )\r
-{\r
- ImageContext->ImageRead = PeiImageRead;\r
- return EFI_SUCCESS;\r
-}\r
\r
This function performs a CPU architecture specific operations to execute\r
the entry point of DxeCore with the parameters of HobList.\r
- It also intalls EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
+ It also installs EFI_END_OF_PEI_PPI to signal the end of PEI phase.\r
\r
- @param DxeCoreEntryPoint The entrypoint of DxeCore.\r
+ @param DxeCoreEntryPoint The entry point of DxeCore.\r
@param HobList The start of HobList passed to DxeCore.\r
\r
**/\r
PageTables = CreateIdentityMappingPageTables ();\r
\r
//\r
- // End of PEI phase singal\r
+ // End of PEI phase signal\r
//\r
Status = PeiServicesInstallPpi (&gEndOfPeiSignalPpi);\r
ASSERT_EFI_ERROR (Status);\r
#include "DxeIpl.h"\r
#include "VirtualMemory.h"\r
\r
-\r
-\r
-\r
-\r
-\r
/**\r
Allocates and fills in the Page Directory and Page Table Entries to\r
establish a 1:1 Virtual to Physical mapping.\r
table entries to the physical \r
address space. \r
\r
- @return EFI_SUCCESS The 1:1 Virtual to Physical identity mapping was created\r
+ @return The address of 4 level page map.\r
\r
**/\r
UINTN\r
\r
Hob = GetFirstHob (EFI_HOB_TYPE_CPU);\r
if (Hob != NULL) {\r
- PhysicalAddressBits = ((EFI_HOB_CPU *) Hob)->SizeOfMemorySpace; \r
+ PhysicalAddressBits = ((EFI_HOB_CPU *) Hob)->SizeOfMemorySpace;\r
}\r
\r
//\r
x64 Long Mode Virtual Memory Management Definitions \r
\r
References:\r
- 1) IA-32 Intel(R) Atchitecture Software Developer's Manual Volume 1:Basic Architecture, Intel\r
- 2) IA-32 Intel(R) Atchitecture Software Developer's Manual Volume 2:Instruction Set Reference, Intel\r
- 3) IA-32 Intel(R) Atchitecture Software Developer's Manual Volume 3:System Programmer's Guide, Intel\r
+ 1) IA-32 Intel(R) Architecture Software Developer's Manual Volume 1:Basic Architecture, Intel\r
+ 2) IA-32 Intel(R) Architecture Software Developer's Manual Volume 2:Instruction Set Reference, Intel\r
+ 3) IA-32 Intel(R) Architecture Software Developer's Manual Volume 3:System Programmer's Guide, Intel\r
4) AMD64 Architecture Programmer's Manual Volume 2: System Programming\r
\r
Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
#pragma pack()\r
\r
\r
-\r
/**\r
Allocates and fills in the Page Directory and Page Table Entries to\r
establish a 1:1 Virtual to Physical mapping.\r
table entries to the physical \r
address space. \r
\r
- @return EFI_SUCCESS The 1:1 Virtual to Physical identity mapping was created\r
+ @return The address of 4 level page map.\r
\r
**/\r
UINTN\r
);\r
\r
\r
-\r
-\r
-\r
/**\r
\r
Fix up the vector number in the vector code.\r
\r
@param VectorBase Base address of the vector handler.\r
- \r
@param VectorNum Index of vector.\r
\r
**/\r
);\r
\r
\r
-\r
-\r
-\r
/**\r
\r
Get the information of vector template.\r
// But if new stack is smaller than the size of old stack, we also reserve\r
// the size of old stack at bottom of permenent memory.\r
//\r
+ DEBUG ((EFI_D_ERROR, "Old Stack Size%d, New stack size%d\n", (INT32) Private->StackSize, (INT32) OldPeiStackSize));\r
ASSERT (Private->StackSize >= OldPeiStackSize);\r
StackGap = Private->StackSize - OldPeiStackSize;\r
\r
/** @file\r
- CalculateCrc32 Boot Services as defined in DXE CIS.\r
+ This file implements CalculateCrc32 Boot Services as defined in\r
+ Platform Initialization specification 1.0 VOLUME 2 DXE Core Interface.\r
\r
This Boot Services is in the Runtime Driver because this service is\r
also required by SetVirtualAddressMap() when the EFI System Table and\r
EFI Runtime Services Table are converted from physical address to\r
- virtual addresses. This requires that the 32-bit CRC be recomputed.\r
+ virtual addresses. This requires that the 32-bit CRC be recomputed.\r
\r
-Copyright (c) 2006, Intel Corporation. <BR>\r
+Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. 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
\r
\r
/**\r
- Reverse bits for 32bit data.\r
- This is a internal function.\r
+ This internal function reverses bits for 32bit data.\r
\r
@param Value The data to be reversed.\r
\r
\r
/**\r
Initialize CRC32 table.\r
+\r
**/\r
VOID\r
RuntimeDriverInitializeCrc32Table (\r
/** @file\r
- Runtime Architectural Protocol as defined in the DXE CIS.\r
+ This file implements Runtime Architectural Protocol as defined in the\r
+ Platform Initialization specification 1.0 VOLUME 2 DXE Core Interface.\r
\r
This code is used to produce the EFI runtime virtual switch over\r
\r
So here is the concept. The code in this module will never ever be called in\r
virtual mode. This is the code that collects the information needed to convert\r
to virtual mode (DXE core registers runtime stuff with this code). Since this\r
- code is used to fixup all runtime images, it CAN NOT fix it's self up. So some\r
+ code is used to fix up all runtime images, it CAN NOT fix it's self up. So some\r
code has to stay behind and that is us.\r
\r
Also you need to be careful about when you allocate memory, as once we are in\r
Table now contains an item named CalculateCrc32.\r
\r
\r
-Copyright (c) 2006, Intel Corporation. <BR>\r
+Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
All rights reserved. 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
//\r
/**\r
\r
- Calcualte the 32-bit CRC in a EFI table using the Runtime Drivers\r
+ Calculate the 32-bit CRC in a EFI table using the Runtime Drivers\r
internal function. The EFI Boot Services Table can not be used because\r
the EFI Boot Services Table was destroyed at ExitBootServices().\r
This is a internal function.\r
return EFI_INVALID_PARAMETER;\r
}\r
\r
- VirtEntry = mVirtualMap;\r
+ VirtEntry = mVirtualMap;\r
for (Index = 0; Index < mVirtualMapMaxIndex; Index++) {\r
//\r
- // To prevent the inclusion of 64-bit math functions a UINTN was placed in\r
+ // To prevent the inclusion of 64-bit math functions a UINTN was placed in\r
// front of VirtEntry->NumberOfPages to cast it to a 32-bit thing on IA-32\r
// platforms. If you get this ASSERT remove the UINTN and do a 64-bit\r
// multiply.\r
RuntimeImage->RelocationData\r
);\r
\r
- InvalidateInstructionCacheRange (RuntimeImage->ImageBase, (UINTN)RuntimeImage->ImageSize);\r
+ InvalidateInstructionCacheRange (RuntimeImage->ImageBase, (UINTN) RuntimeImage->ImageSize);\r
}\r
}\r
\r
}\r
\r
/**\r
- Install Runtime AP. This code includes the EfiDriverLib, but it functions at\r
- RT in physical mode. The only Lib services are gBS, gRT, and the DEBUG and\r
- ASSERT macros (they do ReportStatusCode).\r
+ Entry Point for Runtime driver.\r
\r
+ This function installs Runtime Architectural Protocol and registers CalculateCrc32 boot services table,\r
+ SetVirtualAddressMap & ConvertPointer runtime services table.\r
\r
@param ImageHandle Image handle of this driver.\r
- @param SystemTable Pointer to the EFI System Table.\r
+ @param SystemTable a Pointer to the EFI System Table.\r
\r
- @retval EFI_SUCEESS Runtime Driver Architectural Protocol Installed\r
- @return Other value if gBS->InstallMultipleProtocolInterfaces fails. Check\r
- gBS->InstallMultipleProtocolInterfaces for details.\r
+ @retval EFI_SUCEESS Runtime Driver Architectural Protocol is successfully installed\r
+ @return Others Some error occurs when installing Runtime Driver Architectural Protocol.\r
\r
**/\r
EFI_STATUS\r
EFI_LOADED_IMAGE_PROTOCOL *MyLoadedImage;\r
\r
//\r
- // This image needs to be exclued from relocation for virtual mode, so cache\r
+ // This image needs to be excluded from relocation for virtual mode, so cache\r
// a copy of the Loaded Image protocol to test later.\r
//\r
Status = gBS->HandleProtocol (\r
);\r
ASSERT_EFI_ERROR (Status);\r
\r
- return EFI_SUCCESS;\r
+ return Status;\r
}\r
#/** @file\r
+# Module that produces EFI runtime virtual switch over services.\r
#\r
-# This module is used to produce the EFI runtime virtual switch over services.\r
+# This runtime module installs Runtime Architectural Protocol and registers\r
+# CalculateCrc32 boot services table, SetVirtualAddressMap & ConvertPointer\r
+# runtime services table.\r
#\r
# Copyright (c) 2006 - 2008, Intel Corporation\r
#\r
#/** @file\r
-# FvbService Library for UEFI drivers\r
+# FvbService Library for DXE phase drivers\r
#\r
# This library instance provide sevice functions to access Firmware Volume Block protocol.\r
#\r
FILE_GUID = bd4d540e-04b0-4b10-8fd5-4a7bb533cf67\r
MODULE_TYPE = DXE_RUNTIME_DRIVER\r
VERSION_STRING = 1.0\r
- LIBRARY_CLASS = FvbServiceLib|DXE_RUNTIME_DRIVER DXE_SMM_DRIVER\r
+ LIBRARY_CLASS = FvbServiceLib|DXE_RUNTIME_DRIVER DXE_SMM_DRIVER UEFI_APPLICATION UEFI_DRIVER\r
CONSTRUCTOR = FvbLibInitialize\r
\r
#\r
# The following information is for reference only and not required by the build tools.\r
#\r
-# VALID_ARCHITECTURES = IA32 X64 IPF EBC\r
+# VALID_ARCHITECTURES = IA32 X64 EBC\r
#\r
# VIRTUAL_ADDRESS_MAP_CALLBACK = FvbVirtualAddressChangeNotifyEvent\r
#\r
/**@file\r
-\r
Firmware Volume Block Protocol Runtime Interface Abstraction\r
And FVB Extension protocol Runtime Interface Abstraction\r
\r
mFvbEntry is an array of Handle Fvb pairs. The Fvb Lib Instance matches the\r
index in the mFvbEntry array. This should be the same sequence as the FVB's\r
were described in the HOB. We have to remember the handle so we can tell if\r
- the protocol has been reinstalled and it needs updateing.\r
+ the protocol has been reinstalled and it needs updating.\r
\r
\r
Copyright (c) 2006 - 2008, Intel Corporation\r
/**\r
Library constructor function entry.\r
\r
- @param ImageHandle The handle of image who call this libary.\r
+ @param ImageHandle The handle of image who call this library.\r
@param SystemTable The point of System Table.\r
\r
- @retval EFI_SUCESS Sucess construct this library.\r
- @retval Others Fail to contruct this libary.\r
+ @retval EFI_SUCESS Success construct this library.\r
+ @retval Others Fail to construct this library.\r
**/\r
EFI_STATUS\r
EFIAPI\r
\r
If NumBytes is NULL, then ASSERT().\r
\r
- @param Instance The FV instance to be written to\r
- @param Lba The starting logical block index to write to\r
- @param Offset The offset relative to the block, at which to begin writting.\r
+ @param Instance The FV instance to be written to.\r
+ @param Lba The starting logical block index to write.\r
+ @param Offset The offset relative to the block to write.\r
@param NumBytes Pointer to a UINTN. On input, *NumBytes contains\r
the total size of the buffer. On output, it contains\r
the actual number of bytes written.\r
/**\r
The user Entry Point for DevicePath module.\r
\r
- This is the entrhy point for DevicePath module. It installs the UEFI Device Path Utility Protocol and\r
- optionall the Device Path to Text and Device Path from Text protocols based on feature flags.\r
+ This is the entry point for DevicePath module. It installs the UEFI Device Path Utility Protocol and\r
+ optionally the Device Path to Text and Device Path from Text protocols based on feature flags.\r
\r
@param[in] ImageHandle The firmware allocated handle for the EFI image.\r
@param[in] SystemTable A pointer to the EFI System Table.\r
#include <Library/DevicePathLib.h>\r
#include <Library/PcdLib.h>\r
\r
-extern const EFI_GUID mEfiDevicePathMessagingUartFlowControlGuid;\r
-extern const EFI_GUID mEfiDevicePathMessagingSASGuid;\r
\r
#define MAX_CHAR 480\r
\r
-#define MIN_ALIGNMENT_SIZE sizeof(UINTN)\r
-#define ALIGN_SIZE(a) ((a % MIN_ALIGNMENT_SIZE) ? MIN_ALIGNMENT_SIZE - (a % MIN_ALIGNMENT_SIZE) : 0)\r
-\r
#define IS_COMMA(a) ((a) == L',')\r
#define IS_HYPHEN(a) ((a) == L'-')\r
#define IS_DOT(a) ((a) == L'.')\r
#define IS_SLASH(a) ((a) == L'/')\r
#define IS_NULL(a) ((a) == L'\0')\r
\r
-#define DEVICE_NODE_END 1\r
-#define DEVICE_PATH_INSTANCE_END 2\r
-#define DEVICE_PATH_END 3\r
\r
-#define SET_DEVICE_PATH_INSTANCE_END_NODE(a) { \\r
+#define SET_DEVICE_PATH_INSTANCE_END_NODE(a) { \\r
(a)->Type = END_DEVICE_PATH_TYPE; \\r
(a)->SubType = END_INSTANCE_DEVICE_PATH_SUBTYPE; \\r
(a)->Length[0] = sizeof (EFI_DEVICE_PATH_PROTOCOL); \\r
#/** @file\r
+# Device path driver that produces three UEFI device path protocols.\r
#\r
-# Component description file for Device Path Driver.\r
-#\r
-# This driver implement these three UEFI deveice path protocols (\r
-# DevicePathUtilities, DevicePahtToText and DevicePathFromText) and install them.\r
+# This driver produces Device Path Utilities protocol and optionally\r
+# DevicePahtToText and DevicePathFromText protocols based on feature flags\r
+# PcdDevicePathSupportDevicePathToText & PcdDevicePathSupportDevicePathFromText\r
+# respectively.\r
#\r
# Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
# All rights reserved. This program and the accompanying materials\r
gEfiVT100Guid # ALWAYS_CONSUMED\r
gEfiVT100PlusGuid # ALWAYS_CONSUMED\r
gEfiPcAnsiGuid # ALWAYS_CONSUMED\r
-\r
+ gEfiUartDevicePathGuid # ALWAYS_CONSUMED\r
+ gEfiSasDevicePathGuid # ALWAYS_CONSUMED\r
+ \r
[Protocols]\r
gEfiDevicePathToTextProtocolGuid # PROTOCOL ALWAYS_PRODUCED\r
gEfiDevicePathFromTextProtocolGuid # PROTOCOL ALWAYS_PRODUCED\r
\r
[Depex]\r
TRUE\r
-\r
sizeof (UART_FLOW_CONTROL_DEVICE_PATH)\r
);\r
\r
- CopyGuid (&UartFlowControl->Guid, &mEfiDevicePathMessagingUartFlowControlGuid);\r
+ CopyGuid (&UartFlowControl->Guid, &gEfiUartDevicePathGuid);\r
if (StrCmp (ValueStr, L"XonXoff") == 0) {\r
UartFlowControl->FlowControlMap = 2;\r
} else if (StrCmp (ValueStr, L"Hardware") == 0) {\r
sizeof (SAS_DEVICE_PATH)\r
);\r
\r
- CopyGuid (&Sas->Guid, &mEfiDevicePathMessagingSASGuid);\r
+ CopyGuid (&Sas->Guid, &gEfiSasDevicePathGuid);\r
Strtoi64 (AddressStr, &Sas->SasAddress);\r
Strtoi64 (LunStr, &Sas->Lun);\r
Sas->RelativeTargetPort = (UINT16) Strtoi (RTPStr);\r
Size = StrSize (AppendStr) - sizeof (UINT16);\r
Size = Size + StrSize (Str->Str);\r
Str->Str = ReallocatePool (\r
- StrSize (Str->Str),\r
- Size,\r
- Str->Str\r
- );\r
+ StrSize (Str->Str),\r
+ Size,\r
+ Str->Str\r
+ );\r
ASSERT (Str->Str != NULL);\r
}\r
\r
}\r
\r
/**\r
- Converts a PCI device path structure to its string representive.\r
+ Converts a PCI device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a PC Card device path structure to its string representive.\r
+ Converts a PC Card device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Memory Map device path structure to its string representive.\r
+ Converts a Memory Map device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Vendor device path structure to its string representive.\r
+ Converts a Vendor device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
} else if (CompareGuid (&Vendor->Guid, &gEfiVTUTF8Guid)) {\r
CatPrint (Str, L"VenUft8()");\r
return ;\r
- } else if (CompareGuid (&Vendor->Guid, &mEfiDevicePathMessagingUartFlowControlGuid)) {\r
+ } else if (CompareGuid (&Vendor->Guid, &gEfiUartDevicePathGuid)) {\r
FlowControlMap = (((UART_FLOW_CONTROL_DEVICE_PATH *) Vendor)->FlowControlMap);\r
switch (FlowControlMap & 0x00000003) {\r
case 0:\r
}\r
\r
return ;\r
- } else if (CompareGuid (&Vendor->Guid, &mEfiDevicePathMessagingSASGuid)) {\r
+ } else if (CompareGuid (&Vendor->Guid, &gEfiSasDevicePathGuid)) {\r
CatPrint (\r
Str,\r
L"SAS(0x%lx,0x%lx,0x%x,",\r
}\r
\r
/**\r
- Converts a Controller device path structure to its string representive.\r
+ Converts a Controller device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a ACPI device path structure to its string representive.\r
+ Converts a ACPI device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a ACPI extended HID device path structure to its string representive.\r
+ Converts a ACPI extended HID device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a ACPI address device path structure to its string representive.\r
+ Converts a ACPI address device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a ATAPI device path structure to its string representive.\r
+ Converts a ATAPI device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a SCSI device path structure to its string representive.\r
+ Converts a SCSI device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Fibre device path structure to its string representive.\r
+ Converts a Fibre device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a 1394 device path structure to its string representive.\r
+ Converts a 1394 device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a USB device path structure to its string representive.\r
+ Converts a USB device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a USB WWID device path structure to its string representive.\r
+ Converts a USB WWID device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Logic Unit device path structure to its string representive.\r
+ Converts a Logic Unit device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a USB class device path structure to its string representive.\r
+ Converts a USB class device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a SATA device path structure to its string representive.\r
+ Converts a SATA device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a I20 device path structure to its string representive.\r
+ Converts a I20 device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a MAC address device path structure to its string representive.\r
+ Converts a MAC address device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a IPv4 device path structure to its string representive.\r
+ Converts a IPv4 device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a IPv6 device path structure to its string representive.\r
+ Converts a IPv6 device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts an Infini Band device path structure to its string representive.\r
+ Converts an Infini Band device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a UART device path structure to its string representive.\r
+ Converts a UART device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts an iSCSI device path structure to its string representive.\r
+ Converts an iSCSI device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Hard drive device path structure to its string representive.\r
+ Converts a Hard drive device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a CDROM device path structure to its string representive.\r
+ Converts a CDROM device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a File device path structure to its string representive.\r
+ Converts a File device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Media protocol device path structure to its string representive.\r
+ Converts a Media protocol device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Firmware Volume device path structure to its string representive.\r
+ Converts a Firmware Volume device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a Firmware Volume File device path structure to its string representive.\r
+ Converts a Firmware Volume File device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts a BIOS Boot Specification device path structure to its string representive.\r
+ Converts a BIOS Boot Specification device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts an End-of-Device-Path structure to its string representive.\r
+ Converts an End-of-Device-Path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
}\r
\r
/**\r
- Converts an unknown device path structure to its string representive.\r
+ Converts an unknown device path structure to its string representative.\r
\r
- @param Str The string representive of input device.\r
+ @param Str The string representative of input device.\r
@param DevPath The input device path structure.\r
@param DisplayOnly If DisplayOnly is TRUE, then the shorter text representation\r
of the display node is used, where applicable. If DisplayOnly\r
&Private->DiskIo\r
);\r
if (!EFI_ERROR (Status)) {\r
-\r
Status = gBS->CloseProtocol (\r
ControllerHandle,\r
&gEfiBlockIoProtocolGuid,\r
#include <Library/UefiBootServicesTableLib.h>\r
\r
\r
-#define DISK_IO_PRIVATE_DATA_SIGNATURE SIGNATURE_32 ('d', 's', 'k', 'I')\r
+#define DATA_BUFFER_BLOCK_NUM 64\r
\r
-#define DATA_BUFFER_BLOCK_NUM (64)\r
+#define DISK_IO_PRIVATE_DATA_SIGNATURE SIGNATURE_32 ('d', 's', 'k', 'I')\r
\r
typedef struct {\r
UINTN Signature;\r
#/** @file\r
-# \r
-# This module lays DiskIo protocol on every blockIo protocol\r
-# to provide byte-oriented access to block media. \r
+# Module that lays Disk I/O protocol on every Block I/O protocol.\r
+#\r
+# This module produces Disk I/O protocol to abstract the block accesses\r
+# of the Block I/O protocol to a more general offset-length protocol\r
+# to provide byte-oriented access to block media. It adds this protocol\r
+# to any Block I/O interface that appears in the system that does not\r
+# already have a Disk I/O protocol. File systems and other disk access\r
+# code utilize the Disk I/O protocol.\r
# \r
# Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
# All rights reserved. This program and the accompanying materials\r
code that is not run on an EFI system. The legacy code reads the \r
first sector of the active partition into memory and \r
\r
- BPB - Boot(?) Parameter Block is in the first sector of a FAT file system. \r
+ BPB - BIOS Parameter Block is in the first sector of a FAT file system. \r
The BPB contains information about the FAT file system. The BPB is \r
always on the first sector of a media. The first sector also contains\r
the legacy boot strap code.\r
HdDev.PartitionNumber = PartitionNumber ++;\r
HdDev.PartitionStart = UNPACK_UINT32 (Mbr->Partition[Index].StartingLBA);\r
HdDev.PartitionSize = UNPACK_UINT32 (Mbr->Partition[Index].SizeInLBA);\r
- CopyMem (HdDev.Signature, &(Mbr->UniqueMbrSignature[0]), sizeof (UINT32));\r
+ CopyMem (HdDev.Signature, &(Mbr->UniqueMbrSignature[0]), sizeof (Mbr->UniqueMbrSignature));\r
\r
Status = PartitionInstallChildHandle (\r
This,\r
};\r
\r
//\r
-// Priortized function list to detect partition table. \r
+// Prioritized function list to detect partition table. \r
//\r
PARTITION_DETECT_ROUTINE mPartitionDetectRoutineTable[] = {\r
PartitionInstallGptChildHandles,\r
\r
\r
/**\r
- Stop this driver on ControllerHandle. Support stoping any child handles\r
+ Stop this driver on ControllerHandle. Support stopping any child handles\r
created by this driver.\r
\r
@param This Protocol instance pointer.\r
);\r
\r
/**\r
- Stop this driver on ControllerHandle. Support stoping any child handles\r
+ Stop this driver on ControllerHandle. Support stopping any child handles\r
created by this driver.\r
\r
@param This Protocol instance pointer.\r
#/** @file\r
-# \r
-# Component description file for Partition module.\r
-# \r
-# Partition driver produces the logical BlockIo device\r
-# that represents the bytes Start to End of the Parent Block IO\r
-# device (one partition of physical BlockIo device,\r
-# which can be one of GPT, MBR, ElTorito partition).\r
+# Modules that produces the logic Block I/O protocol for every partition\r
+# it discovers via the physical Block I/O.\r
+#\r
+# This module produces the logical Block I/O device that represents\r
+# the bytes from Start to End of the Parent Block I/O device.\r
+# The partition of physical BlockIo device supported is one of legacy MBR, GPT,\r
+# and "El Torito" partitions.\r
# \r
# Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
# All rights reserved. This program and the accompanying materials\r
#\r
# VALID_ARCHITECTURES = IA32 X64 IPF EBC\r
#\r
-# DRIVER_BINDING = gPartitionDriverBinding\r
-# COMPONENT_NAME = gPartitionComponentName\r
-# COMPONENT_NAME2 = gPartitionComponentName2\r
+# DRIVER_BINDING = gPartitionDriverBinding\r
+# COMPONENT_NAME = gPartitionComponentName\r
+# COMPONENT_NAME2 = gPartitionComponentName2\r
#\r
\r
[Sources.common]\r
[Protocols]\r
gEfiBlockIoProtocolGuid # PROTOCOL BY_START\r
gEfiDevicePathProtocolGuid # PROTOCOL BY_START\r
+ gEfiDiskIoProtocolGuid # PROTOCOL BY_START\r
+ gEfiBlockIoProtocolGuid # PROTOCOL TO_START\r
gEfiDevicePathProtocolGuid # PROTOCOL TO_START\r
gEfiDiskIoProtocolGuid # PROTOCOL TO_START\r
- gEfiBlockIoProtocolGuid # PROTOCOL TO_START\r
-\r
#/** @file\r
+# English module that provides Unicode Collation supports.\r
# \r
-# Component description file for English module for unicode collation.\r
-# \r
-# This driver installs UEFI EFI_UNICODE_COLLATION_PROTOCOL protocol to provide Unicode strings function.\r
+# This driver installs Unicode ISO 639-2 Collation and\r
+# RFC 4646 Unicode Collation 2 protocols based on feature flags\r
+# PcdUnicodeCollationSupport & PcdUnicodeCollation2Support respectively.\r
+# It allows code running in the boot services environment to perform lexical\r
+# comparison functions on Unicode strings for English languages.\r
# \r
# Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
# All rights reserved. This program and the accompanying materials\r
\r
#include "UnicodeCollationEng.h"\r
\r
-CHAR8 mEngUpperMap[0x100];\r
-CHAR8 mEngLowerMap[0x100];\r
-CHAR8 mEngInfoMap[0x100];\r
+CHAR8 mEngUpperMap[MAP_TABLE_SIZE];\r
+CHAR8 mEngLowerMap[MAP_TABLE_SIZE];\r
+CHAR8 mEngInfoMap[MAP_TABLE_SIZE];\r
\r
CHAR8 mOtherChars[] = {\r
'0',\r
//\r
// Initialize mapping tables for the supported languages\r
//\r
- for (Index = 0; Index < 0x100; Index++) {\r
+ for (Index = 0; Index < MAP_TABLE_SIZE; Index++) {\r
mEngUpperMap[Index] = (CHAR8) Index;\r
mEngLowerMap[Index] = (CHAR8) Index;\r
mEngInfoMap[Index] = 0;\r
if (*String != '.' && *String != ' ') {\r
//\r
// If this is a valid fat char, move it.\r
- // Otherwise, move a '_' and flag the fact that the name needs an Lfn\r
+ // Otherwise, move a '_' and flag the fact that the name needs a long file name.\r
//\r
- if (*String < 0x100 && ((mEngInfoMap[*String] & CHAR_FAT_VALID) != 0)) {\r
+ if (*String < MAP_TABLE_SIZE && ((mEngInfoMap[*String] & CHAR_FAT_VALID) != 0)) {\r
*Fat = mEngUpperMap[*String];\r
} else {\r
*Fat = '_';\r
\r
#include <Uefi.h>\r
\r
-\r
#include <Protocol/UnicodeCollation.h>\r
\r
#include <Library/DebugLib.h>\r
#include <Library/PcdLib.h>\r
\r
//\r
-// Defines\r
+// Bit mask to indicate the validity of character in FAT file name.\r
//\r
#define CHAR_FAT_VALID 0x01\r
\r
-#define TO_UPPER(a) (CHAR16) (a <= 0xFF ? mEngUpperMap[a] : a)\r
-#define TO_LOWER(a) (CHAR16) (a <= 0xFF ? mEngLowerMap[a] : a)\r
+//\r
+// Maximum FAT table size.\r
+//\r
+#define MAP_TABLE_SIZE 0x100\r
+\r
+//\r
+// Macro to map character a to upper case.\r
+//\r
+#define TO_UPPER(a) (CHAR16) ((a) <= 0xFF ? mEngUpperMap[a] : (a))\r
+\r
+//\r
+// Macro to map character a to lower case.\r
+//\r
+#define TO_LOWER(a) (CHAR16) ((a) <= 0xFF ? mEngLowerMap[a] : (a))\r
\r
//\r
// Prototypes\r
#/** @file\r
+# Module that produces EBC Interprete and EBC Debug Support protocols.\r
# \r
-# This module for the EBC virtual machine implementation produces \r
-# EBC and EBC debug support protocols.\r
-# \r
+# This module implements EFI Byte Code (EBC) Virtual Machine that can provide \r
+# platformand processor-independent mechanisms for loading and executing EFI\r
+# device drivers.\r
+#\r
# Copyright (c) 2006 - 2008, Intel Corporation. <BR>\r
# All rights reserved. This program and the accompanying materials\r
# are licensed and made available under the terms and conditions of the BSD License\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 8-bit value from the memory adress.\r
+ @return The 8-bit value from the memory address.\r
\r
**/\r
UINT8\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 16-bit value from the memory adress.\r
+ @return The 16-bit value from the memory address.\r
\r
**/\r
UINT16\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 32-bit value from the memory adress.\r
+ @return The 32-bit value from the memory address.\r
\r
**/\r
UINT32\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 64-bit value from the memory adress.\r
+ @return The 64-bit value from the memory address.\r
\r
**/\r
UINT64\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
);\r
\r
/**\r
- Reads 16-bit unsinged data from the code stream.\r
+ Reads 16-bit unsigned data from the code stream.\r
\r
This routine provides the ability to read raw unsigned data from the code\r
stream.\r
);\r
\r
/**\r
- Reads 32-bit unsinged data from the code stream.\r
+ Reads 32-bit unsigned data from the code stream.\r
\r
This routine provides the ability to read raw unsigned data from the code\r
stream.\r
);\r
\r
/**\r
- Reads 64-bit unsinged data from the code stream.\r
+ Reads 64-bit unsigned data from the code stream.\r
\r
This routine provides the ability to read raw unsigned data from the code\r
stream.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
\r
\r
/**\r
- Reads 16-bit unsinged data from the code stream.\r
+ Reads 16-bit unsigned data from the code stream.\r
\r
This routine provides the ability to read raw unsigned data from the code\r
stream.\r
\r
\r
/**\r
- Reads 32-bit unsinged data from the code stream.\r
+ Reads 32-bit unsigned data from the code stream.\r
\r
This routine provides the ability to read raw unsigned data from the code\r
stream.\r
\r
\r
/**\r
- Reads 64-bit unsinged data from the code stream.\r
+ Reads 64-bit unsigned data from the code stream.\r
\r
This routine provides the ability to read raw unsigned data from the code\r
stream.\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 8-bit value from the memory adress.\r
+ @return The 8-bit value from the memory address.\r
\r
**/\r
UINT8\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 16-bit value from the memory adress.\r
+ @return The 16-bit value from the memory address.\r
\r
**/\r
UINT16\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 32-bit value from the memory adress.\r
+ @return The 32-bit value from the memory address.\r
\r
**/\r
UINT32\r
@param VmPtr A pointer to VM context.\r
@param Addr The memory address.\r
\r
- @return The 64-bit value from the memory adress.\r
+ @return The 64-bit value from the memory address.\r
\r
**/\r
UINT64\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
VM stack) to point into the EBC entry point arguments.\r
\r
@param VmPtr A pointer to a VM context.\r
- @param Addr Adddress to write to.\r
+ @param Addr Address to write to.\r
@param Data Value to write to Addr.\r
\r
@retval EFI_SUCCESS The instruction is executed successfully.\r
typedef struct {\r
VM_REGISTER R[8]; // General purpose registers.\r
UINT64 Flags; // Flags register:\r
- // 0 Set to 1 if the result of the last compare was true\r
+ // 0 Set to 1 if the result of the last compare was true\r
// 1 Set to 1 if stepping\r
// 2..63 Reserved.\r
VMIP Ip; // Instruction pointer.\r
\r
/**\r
Add a thunk to our list of thunks for a given image handle.\r
- Also flush the instruction cache since we've written thunk code\r
+ Also flush the instruction cache since we have written thunk code\r
to memory that will be executed eventually.\r
\r
@param ImageHandle The image handle to which the thunk is tied.\r
);\r
\r
/**\r
- Returns the stack index and buffer assosicated with the Handle parameter.\r
+ Returns the stack index and buffer associated with the Handle parameter.\r
\r
@param Handle The EFI handle as the index to the EBC stack.\r
@param StackBuffer A pointer to hold the returned stack buffer.\r
projects / mirror_edk2.git / commitdiff