Remove PeiPeCoffLoader.h and gPeiPeCoffLoaderGuid, and Add PeCoffExtraActionLib class and instances.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@7812 6f19259b-4bc3-4df7-8a09-765794883524

8 files changed, 370 insertions, 891 deletions

diff --git a/UnixPkg/Library/DxeUnixPeCoffExtraActionLib/DxeUnixPeCoffExtraActionLib.c b/UnixPkg/Library/DxeUnixPeCoffExtraActionLib/DxeUnixPeCoffExtraActionLib.c
new file mode 100644
index 0000000000..a28fde8ebc
--- /dev/null
+++ b/UnixPkg/Library/DxeUnixPeCoffExtraActionLib/DxeUnixPeCoffExtraActionLib.c
@@ -0,0 +1,132 @@
+/**@file
+
+Copyright (c) 2006, Intel Corporation
+All rights reserved. This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+Module Name:
+
+  PeiUnixPeCoffExtraActionLib.c
+
+Abstract:
+
+  Provides services to perform additional actions to relocate and unload
+  PE/Coff image for Unix environment specific purpose such as souce level debug.
+  This version only works for DXE phase  
+
+
+**/
+
+#include <PiDxe.h>

+#include <Guid/StatusCodeDataTypeId.h>

+#include <UnixDxe.h>
+#include <Library/PeCoffLib.h>
+#include <Library/PeiServicesLib.h>
+
+#include <Library/BaseLib.h>
+#include <Library/DebugLib.h>
+#include <Library/HobLib.h>
+#include <Library/BaseMemoryLib.h>
+#include <Library/PeCoffExtraActionLib.h>
+
+//

+// Cache of UnixThunk protocol 

+//

+EFI_UNIX_THUNK_PROTOCOL   *mUnix;
+
+
+/**
+  The constructor function gets  the pointer of the WinNT thunk functions
+  It will ASSERT() if Unix thunk protocol is not installed.
+
+  @retval EFI_SUCCESS   Unix thunk protocol is found and cached.
+
+**/
+EFI_STATUS
+EFIAPI
+DxeUnixPeCoffLibExtraActionConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+	 EFI_HOB_GUID_TYPE        *GuidHob;

+

+  //

+  // Retrieve UnixThunkProtocol from GUID'ed HOB

+  //

+  GuidHob = GetFirstGuidHob (&gEfiUnixThunkProtocolGuid);

+  ASSERT (GuidHob != NULL);

+  mUnix = (EFI_UNIX_THUNK_PROTOCOL *)(*(UINTN *)(GET_GUID_HOB_DATA (GuidHob)));

+  ASSERT (mUnix != NULL);

+

+  return EFI_SUCCESS;
+}
+
+/**
+  Applies additional actions to relocate fixups to a PE/COFF image.
+
+  Generally this function is called after sucessfully Applying relocation fixups 
+  to a PE/COFF image for some specicial purpose.  
+  
+  @param  ImageContext        Pointer to the image context structure that describes the PE/COFF
+                              image that is being relocated.
+
+**/
+VOID
+EFIAPI
+PeCoffLoaderRelocateImageExtraAction (
+  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
+  )
+{
+  VOID * Handle;

+  VOID * Entry;

+

+  Handle = NULL;

+  Entry  = NULL;
+  
+  DEBUG ((EFI_D_ERROR, "Loading %s 0x%08lx - entry point 0x%08lx\n",

+          ImageContext->PdbPointer,

+          (UINTN)ImageContext->ImageAddress,

+          (UINTN)ImageContext->EntryPoint));

+

+  Handle = mUnix->Dlopen(ImageContext->PdbPointer, RTLD_NOW);

+  

+  if (Handle) {

+    Entry = mUnix->Dlsym(Handle, "_ModuleEntryPoint");

+  } else {
+  	DEBUG ((EFI_D_ERROR, "%s\n", mUnix->Dlerror()));

+  }

+  

+  if (Entry != NULL) {

+    ImageContext->EntryPoint = Entry;
+    DEBUG ((EFI_D_ERROR, "Change %s Entrypoint to :0x%08lx\n", ImageContext->PdbPointer, Entry));

+  }

+

+

+  return;
+ }  
+
+/**
+  Unloads a loaded PE/COFF image from memory and releases its taken resource.
+  
+  Releases any environment specific resources that were allocated when the image 
+  specified by ImageContext was loaded using PeCoffLoaderLoadImage(). 
+  
+  If ImageContext is NULL, then ASSERT().
+  
+  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF
+                                    image to be unloaded.
+
+**/
+VOID
+EFIAPI
+PeCoffLoaderUnloadImageExtraAction (
+  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
+  )
+{
+}
\ No newline at end of file
diff --git a/UnixPkg/Library/DxeUnixPeCoffLib/DxeUnixPeCoffLib.inf b/UnixPkg/Library/DxeUnixPeCoffExtraActionLib/DxeUnixPeCoffExtraActionLib.inf
index b5fd4732cb..93c514692c 100644
--- a/UnixPkg/Library/DxeUnixPeCoffLib/DxeUnixPeCoffLib.inf
+++ b/UnixPkg/Library/DxeUnixPeCoffExtraActionLib/DxeUnixPeCoffExtraActionLib.inf
@@ -1,50 +1,52 @@
-#/** @file

-# PeCoff libary for Dxe modules that run Unix emulator.

-#

-# Lib to provide memory journal status code reporting Routines

-# Copyright (c) 2007 - 2008, Intel Corporation

-# All rights reserved. This program and the accompanying materials

-# are licensed and made available under the terms and conditions of the BSD License

-# which accompanies this distribution.  The full text of the license may be found at

-# http://opensource.org/licenses/bsd-license.php

-#

-# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-#

-#

-#**/

-

-[Defines]

-  INF_VERSION                    = 0x00010005

-  BASE_NAME                      = DxeUnixPeCoffLib

-  FILE_GUID                      = 624571b0-4b69-40e3-bd13-78fae0e84270

-  MODULE_TYPE                    = DXE_DRIVER

-  VERSION_STRING                 = 1.0

-  LIBRARY_CLASS                  = PeCoffLib|DXE_CORE DXE_DRIVER

-  EDK_RELEASE_VERSION            = 0x00020000

-  EFI_SPECIFICATION_VERSION      = 0x00020000

-

-  CONSTRUCTOR                    = DxeUnixPeCoffLibConstructor

-

-#

-# The following information is for reference only and not required by the build tools.

-#

-#  VALID_ARCHITECTURES           = IA32

-#

-

-[Sources.common]

-  DxeUnixPeCoffLib.c

-

-[Packages]

-  MdePkg/MdePkg.dec

-  MdeModulePkg/MdeModulePkg.dec

-  UnixPkg/UnixPkg.dec

-

-[LibraryClasses]

-  DebugLib

-  HobLib

-

-[Guids]

-  gEfiPeiPeCoffLoaderGuid                # ALWAYS_CONSUMED

-

+#/** @file
+# PeCoff extra action libary for DXE phase that run Unix emulator.
+#
+# Lib to provide memory journal status code reporting Routines
+# Copyright (c) 2007, Intel Corporation
+# All rights reserved. This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+#
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = DxeUnixPeCoffExtraActionLib
+  FILE_GUID                      = C6F96971-39D2-49a5-93FC-5D42FB4D7DD2
+  MODULE_TYPE                    = DXE_DRIVER
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PeCoffExtraActionLib|DXE_CORE DXE_DRIVER DXE_RUNTIME_DRIVER UEFI_DRIVER
+  EDK_RELEASE_VERSION            = 0x00020000
+  EFI_SPECIFICATION_VERSION      = 0x00020000
+
+  CONSTRUCTOR                    = DxeUnixPeCoffLibExtraActionConstructor
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32
+#
+
+[Sources.common]
+  DxeUnixPeCoffExtraActionLib.c
+
+[Packages]
+  UnixPkg/UnixPkg.dec
+  MdePkg/MdePkg.dec
+  IntelFrameworkPkg/IntelFrameworkPkg.dec
+  IntelFrameworkModulePkg/IntelFrameworkModulePkg.dec
+
+[LibraryClasses]
+  DebugLib
+  HobLib
+  BaseMemoryLib
+
+[Protocols]
+  gEfiUnixThunkProtocolGuid                     # PROTOCOL ALWAYS_CONSUMED
+
diff --git a/UnixPkg/Library/DxeUnixPeCoffLib/DxeUnixPeCoffLib.c b/UnixPkg/Library/DxeUnixPeCoffLib/DxeUnixPeCoffLib.c
deleted file mode 100644
index 48a62549be..0000000000
--- a/UnixPkg/Library/DxeUnixPeCoffLib/DxeUnixPeCoffLib.c
+++ /dev/null
@@ -1,225 +0,0 @@
-/**@file

-

-Copyright (c) 2006 - 2008, Intel Corporation

-All rights reserved. This program and the accompanying materials

-are licensed and made available under the terms and conditions of the BSD License

-which accompanies this distribution.  The full text of the license may be found at

-http://opensource.org/licenses/bsd-license.php

-

-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-Module Name:

-

-  DxeUnixPeCoffLib.c

-

-Abstract:

-

-  Wrap the Unix PE/COFF loader with the PE COFF LOADER guid structure

-  to produce PeCoff library class.

-

-

-**/

-

-#include <PiDxe.h>

-#include <Guid/PeiPeCoffLoader.h>

-#include <Library/DebugLib.h>

-#include <Library/PeCoffLib.h>

-#include <Library/HobLib.h>

-

-EFI_PEI_PE_COFF_LOADER_PROTOCOL  *mPeiEfiPeiPeCoffLoader;

-

-/**

-  The constructor function gets the pointer to PeCofferLoader guid structure

-  from the guid data hob.

-

-  It will ASSERT() if the guid hob of PeCofferLoader guid structure doesn't exist.

-

-  @param  ImageHandle   The firmware allocated handle for the EFI image.

-  @param  SystemTable   A pointer to the EFI System Table.

-

-  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.

-

-**/

-EFI_STATUS

-EFIAPI

-DxeUnixPeCoffLibConstructor (

-  IN EFI_HANDLE        ImageHandle,

-  IN EFI_SYSTEM_TABLE  *SystemTable

-  )

-{

-  EFI_HOB_GUID_TYPE    *GuidHob;

-  

-  //

-  // Find guid data hob that contains PeCoffLoader guid structure.

-  //

-  GuidHob = GetFirstGuidHob (&gEfiPeiPeCoffLoaderGuid);

-  ASSERT (GuidHob != NULL);

-

-  //

-  // Get PeCofferLoader guid structure from guid hob data.

-  //

-  mPeiEfiPeiPeCoffLoader = (EFI_PEI_PE_COFF_LOADER_PROTOCOL *)(*(UINTN *)(GET_GUID_HOB_DATA (GuidHob)));

-

-  return EFI_SUCCESS;

-}

-

-/**

-  Retrieves information about a PE/COFF image.

-

-  Computes the PeCoffHeaderOffset, ImageAddress, ImageSize, DestinationAddress, CodeView,

-  PdbPointer, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva

-  fields of the ImageContext structure.  If ImageContext is NULL, then return RETURN_INVALID_PARAMETER.

-  If the PE/COFF image accessed through the ImageRead service in the ImageContext structure is not

-  a supported PE/COFF image type, then return RETURN_UNSUPPORTED.  If any errors occur while

-  computing the fields of ImageContext, then the error status is returned in the ImageError field of

-  ImageContext. 

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image that needs to be examined by this function.

-

-  @retval RETURN_SUCCESS            The information on the PE/COFF image was collected.

-  @retval RETURN_INVALID_PARAMETER  ImageContext is NULL.

-  @retval RETURN_UNSUPPORTED        The PE/COFF image is not supported.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderGetImageInfo (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-    return mPeiEfiPeiPeCoffLoader->GetImageInfo (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  Applies relocation fixups to a PE/COFF image that was loaded with PeCoffLoaderLoadImage().

-

-  If the DestinationAddress field of ImageContext is 0, then use the ImageAddress field of

-  ImageContext as the relocation base address.  Otherwise, use the DestinationAddress field

-  of ImageContext as the relocation base address.  The caller must allocate the relocation

-  fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function.  

-  If ImageContext is NULL, then ASSERT().

-

-  @param  ImageContext        Pointer to the image context structure that describes the PE/COFF

-                              image that is being relocated.

-

-  @retval RETURN_SUCCESS      The PE/COFF image was relocated.

-                              Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_LOAD_ERROR   The image in not a valid PE/COFF image.

-                              Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_UNSUPPORTED  A relocation record type is not supported.

-                              Extended status information is in the ImageError field of ImageContext.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderRelocateImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  return mPeiEfiPeiPeCoffLoader->RelocateImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  Loads a PE/COFF image into memory.

-

-  Loads the PE/COFF image accessed through the ImageRead service of ImageContext into the buffer

-  specified by the ImageAddress and ImageSize fields of ImageContext.  The caller must allocate

-  the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.

-  The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed.

-  If ImageContext is NULL, then ASSERT().

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image that is being loaded.

-

-  @retval RETURN_SUCCESS            The PE/COFF image was loaded into the buffer specified by

-                                    the ImageAddress and ImageSize fields of ImageContext.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_BUFFER_TOO_SMALL   The caller did not provide a large enough buffer.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_LOAD_ERROR         The PE/COFF image is an EFI Runtime image with no relocations.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_INVALID_PARAMETER  The image address is invalid.

-                                    Extended status information is in the ImageError field of ImageContext.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderLoadImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  return mPeiEfiPeiPeCoffLoader->LoadImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  ImageRead function that operates on a memory buffer whos base is passed into

-  FileHandle. 

-

-  @param  FileHandle        Ponter to baes of the input stream

-  @param  FileOffset        Offset to the start of the buffer

-  @param  ReadSize          Number of bytes to copy into the buffer

-  @param  Buffer            Location to place results of read

-

-  @retval RETURN_SUCCESS    Data is read from FileOffset from the Handle into 

-                            the buffer.

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderImageReadFromMemory (

-  IN     VOID    *FileHandle,

-  IN     UINTN   FileOffset,

-  IN OUT UINTN   *ReadSize,

-  OUT    VOID    *Buffer

-  )

-{

-  return RETURN_UNSUPPORTED;

-}

-

-

-/**

-  Reapply fixups on a fixed up PE32/PE32+ image to allow virutal calling at EFI

-  runtime. 

-  

-  PE_COFF_LOADER_IMAGE_CONTEXT.FixupData stores information needed to reapply

-  the fixups with a virtual mapping.

-

-

-  @param  ImageBase          Base address of relocated image

-  @param  VirtImageBase      Virtual mapping for ImageBase

-  @param  ImageSize          Size of the image to relocate

-  @param  RelocationData     Location to place results of read

-  

-**/

-VOID

-EFIAPI

-PeCoffLoaderRelocateImageForRuntime (

-  IN  PHYSICAL_ADDRESS        ImageBase,

-  IN  PHYSICAL_ADDRESS        VirtImageBase,

-  IN  UINTN                   ImageSize,

-  IN  VOID                    *RelocationData

-  )

-{

-}

-

-/**

-  Unloads a loaded PE/COFF image from memory and releases its taken resource.

-   

-  For Unix emulator, the PE/COFF image loaded by system needs to release.

-  For real platform, the PE/COFF image loaded by Core doesn't needs to be unloaded, 

-  this function can simply return RETURN_SUCCESS.

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image to be unloaded.

-

-  @retval RETURN_SUCCESS            The PE/COFF image was unloaded successfully.

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderUnloadImage (

-  IN PE_COFF_LOADER_IMAGE_CONTEXT         *ImageContext

-  )

-{

-  return mPeiEfiPeiPeCoffLoader->UnloadImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

diff --git a/UnixPkg/Library/PeiCoreUnixPeCoffLib/PeiCoreUnixPeCoffLib.c b/UnixPkg/Library/PeiCoreUnixPeCoffLib/PeiCoreUnixPeCoffLib.c
deleted file mode 100644
index 77b9106037..0000000000
--- a/UnixPkg/Library/PeiCoreUnixPeCoffLib/PeiCoreUnixPeCoffLib.c
+++ /dev/null
@@ -1,262 +0,0 @@
-/**@file

-

-Copyright (c) 2006 - 2008, Intel Corporation

-All rights reserved. This program and the accompanying materials

-are licensed and made available under the terms and conditions of the BSD License

-which accompanies this distribution.  The full text of the license may be found at

-http://opensource.org/licenses/bsd-license.php

-

-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-Module Name:

-

-  PeiCoreUnixPeCoffLib.c

-

-Abstract:

-

-  Wrap the Unix PE/COFF loader with the PE COFF LOADER guid structure

-  to produce PeCoff library class.

-

-

-**/

-

-#include <PiPei.h>

-#include <Guid/PeiPeCoffLoader.h>

-#include <Library/DebugLib.h>

-#include <Library/PeCoffLib.h>

-#include <Library/HobLib.h>

-#include <Library/PeiServicesLib.h>

-

-EFI_PEI_PE_COFF_LOADER_PROTOCOL  *mPeiEfiPeiPeCoffLoader = NULL;

-

-/**

-  The function caches the pointer of PeCofferLoader guid structure

-  into the guid data hob.

-

-  The funtion must be called after PeCofferLoader guid structure is installed.

-  It will ASSERT() if PeCofferLoader guid structure is not installed.

-

-  @retval EFI_SUCCESS   PeCofferLoader guid structure is found.

-

-**/

-EFI_STATUS

-EFIAPI

-GetPeCoffLoaderStucture (

-  )

-{

-  EFI_STATUS           Status;

-  EFI_HOB_GUID_TYPE    *GuidHob;

-

-  Status = EFI_NOT_FOUND;

-  

-  //

-  // Try to get guid data hob that contains PeCoffLoader guid structure.

-  //

-  GuidHob = GetFirstGuidHob (&gEfiPeiPeCoffLoaderGuid);

-

-  if (GuidHob == NULL) {

-    //

-    // GuidHob is not ready, try to locate PeCoffLoader guid structure.

-    //

-    Status = PeiServicesLocatePpi (

-                &gEfiPeiPeCoffLoaderGuid,

-                0,

-                NULL,

-                (VOID**) &mPeiEfiPeiPeCoffLoader

-                );

-    

-    //

-    // PeCofferLoader guid structure must be installed before this library runs.

-    //

-    ASSERT_EFI_ERROR (Status);

-    

-    //

-    // Build guid data hob of PeCofferLoader guid structure for DXE module use. 

-    //

-    BuildGuidDataHob (

-      &gEfiPeiPeCoffLoaderGuid,

-      (VOID *) &mPeiEfiPeiPeCoffLoader,

-      sizeof (VOID *)

-      );

-  } else {

-    //

-    // Get PeCofferLoader guid structure directly from guid hob data.

-    //

-    mPeiEfiPeiPeCoffLoader = (EFI_PEI_PE_COFF_LOADER_PROTOCOL *)(*(UINTN *)(GET_GUID_HOB_DATA (GuidHob)));

-  }

-

-  return EFI_SUCCESS;

-}

-

-/**

-  Retrieves information about a PE/COFF image.

-

-  Computes the PeCoffHeaderOffset, ImageAddress, ImageSize, DestinationAddress, CodeView,

-  PdbPointer, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva

-  fields of the ImageContext structure.  If ImageContext is NULL, then return RETURN_INVALID_PARAMETER.

-  If the PE/COFF image accessed through the ImageRead service in the ImageContext structure is not

-  a supported PE/COFF image type, then return RETURN_UNSUPPORTED.  If any errors occur while

-  computing the fields of ImageContext, then the error status is returned in the ImageError field of

-  ImageContext. 

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image that needs to be examined by this function.

-

-  @retval RETURN_SUCCESS            The information on the PE/COFF image was collected.

-  @retval RETURN_INVALID_PARAMETER  ImageContext is NULL.

-  @retval RETURN_UNSUPPORTED        The PE/COFF image is not supported.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderGetImageInfo (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  if (mPeiEfiPeiPeCoffLoader == NULL) {

-    GetPeCoffLoaderStucture ();

-  }

-  return mPeiEfiPeiPeCoffLoader->GetImageInfo (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  Applies relocation fixups to a PE/COFF image that was loaded with PeCoffLoaderLoadImage().

-

-  If the DestinationAddress field of ImageContext is 0, then use the ImageAddress field of

-  ImageContext as the relocation base address.  Otherwise, use the DestinationAddress field

-  of ImageContext as the relocation base address.  The caller must allocate the relocation

-  fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function.  

-  If ImageContext is NULL, then ASSERT().

-

-  @param  ImageContext        Pointer to the image context structure that describes the PE/COFF

-                              image that is being relocated.

-

-  @retval RETURN_SUCCESS      The PE/COFF image was relocated.

-                              Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_LOAD_ERROR   The image in not a valid PE/COFF image.

-                              Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_UNSUPPORTED  A relocation record type is not supported.

-                              Extended status information is in the ImageError field of ImageContext.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderRelocateImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  if (mPeiEfiPeiPeCoffLoader == NULL) {

-    GetPeCoffLoaderStucture ();

-  }

-  return mPeiEfiPeiPeCoffLoader->RelocateImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  Loads a PE/COFF image into memory.

-

-  Loads the PE/COFF image accessed through the ImageRead service of ImageContext into the buffer

-  specified by the ImageAddress and ImageSize fields of ImageContext.  The caller must allocate

-  the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.

-  The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed.

-  If ImageContext is NULL, then ASSERT().

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image that is being loaded.

-

-  @retval RETURN_SUCCESS            The PE/COFF image was loaded into the buffer specified by

-                                    the ImageAddress and ImageSize fields of ImageContext.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_BUFFER_TOO_SMALL   The caller did not provide a large enough buffer.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_LOAD_ERROR         The PE/COFF image is an EFI Runtime image with no relocations.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_INVALID_PARAMETER  The image address is invalid.

-                                    Extended status information is in the ImageError field of ImageContext.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderLoadImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  if (mPeiEfiPeiPeCoffLoader == NULL) {

-    GetPeCoffLoaderStucture ();

-  }

-  return mPeiEfiPeiPeCoffLoader->LoadImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  ImageRead function that operates on a memory buffer whos base is passed into

-  FileHandle. 

-

-  @param  FileHandle        Ponter to baes of the input stream

-  @param  FileOffset        Offset to the start of the buffer

-  @param  ReadSize          Number of bytes to copy into the buffer

-  @param  Buffer            Location to place results of read

-

-  @retval RETURN_SUCCESS    Data is read from FileOffset from the Handle into 

-                            the buffer.

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderImageReadFromMemory (

-  IN     VOID    *FileHandle,

-  IN     UINTN   FileOffset,

-  IN OUT UINTN   *ReadSize,

-  OUT    VOID    *Buffer

-  )

-{

-  return RETURN_UNSUPPORTED;

-}

-

-

-/**

-  Reapply fixups on a fixed up PE32/PE32+ image to allow virutal calling at EFI

-  runtime. 

-  

-  PE_COFF_LOADER_IMAGE_CONTEXT.FixupData stores information needed to reapply

-  the fixups with a virtual mapping.

-

-

-  @param  ImageBase          Base address of relocated image

-  @param  VirtImageBase      Virtual mapping for ImageBase

-  @param  ImageSize          Size of the image to relocate

-  @param  RelocationData     Location to place results of read

-  

-**/

-VOID

-EFIAPI

-PeCoffLoaderRelocateImageForRuntime (

-  IN  PHYSICAL_ADDRESS        ImageBase,

-  IN  PHYSICAL_ADDRESS        VirtImageBase,

-  IN  UINTN                   ImageSize,

-  IN  VOID                    *RelocationData

-  )

-{

-}

-

-/**

-  Unloads a loaded PE/COFF image from memory and releases its taken resource.

-   

-  For Unix emulator, the PE/COFF image loaded by system needs to release.

-  For real platform, the PE/COFF image loaded by Core doesn't needs to be unloaded, 

-  this function can simply return RETURN_SUCCESS.

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image to be unloaded.

-

-  @retval RETURN_SUCCESS            The PE/COFF image was unloaded successfully.

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderUnloadImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT         *ImageContext

-  )

-{

-  if (mPeiEfiPeiPeCoffLoader == NULL) {

-    GetPeCoffLoaderStucture ();

-  }

-  return mPeiEfiPeiPeCoffLoader->UnloadImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

diff --git a/UnixPkg/Library/PeiCoreUnixPeCoffLib/PeiCoreUnixPeCoffLib.inf b/UnixPkg/Library/PeiCoreUnixPeCoffLib/PeiCoreUnixPeCoffLib.inf
deleted file mode 100644
index 12b2188685..0000000000
--- a/UnixPkg/Library/PeiCoreUnixPeCoffLib/PeiCoreUnixPeCoffLib.inf
+++ /dev/null
@@ -1,49 +0,0 @@
-#/** @file

-# PeCoff libary for PeiCore modules that run Unix emulator.

-#

-# Lib to provide memory journal status code reporting Routines

-# Copyright (c) 2007 - 2008, Intel Corporation

-# All rights reserved. This program and the accompanying materials

-# are licensed and made available under the terms and conditions of the BSD License

-# which accompanies this distribution.  The full text of the license may be found at

-# http://opensource.org/licenses/bsd-license.php

-#

-# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-#

-#

-#**/

-

-[Defines]

-  INF_VERSION                    = 0x00010005

-  BASE_NAME                      = PeiCoreUnixPeCoffLib

-  FILE_GUID                      = ef9fd7ee-3181-4b16-adc1-8615f88b58b8

-  MODULE_TYPE                    = PEI_CORE

-  VERSION_STRING                 = 1.0

-  LIBRARY_CLASS                  = PeCoffLib|PEI_CORE

-  EDK_RELEASE_VERSION            = 0x00020000

-  EFI_SPECIFICATION_VERSION      = 0x00020000

-

-#

-# The following information is for reference only and not required by the build tools.

-#

-#  VALID_ARCHITECTURES           = IA32

-#

-

-[Sources.common]

-  PeiCoreUnixPeCoffLib.c

-

-[Packages]

-  MdePkg/MdePkg.dec

-  MdeModulePkg/MdeModulePkg.dec

-  UnixPkg/UnixPkg.dec

-

-[LibraryClasses]

-  PeiServicesLib

-  DebugLib

-  HobLib

-

-[Guids]

-  gEfiPeiPeCoffLoaderGuid                # ALWAYS_CONSUMED

-

diff --git a/UnixPkg/Library/PeiUnixPeCoffExtraActionLib/PeiUnixPeCoffExtraActionLib.c b/UnixPkg/Library/PeiUnixPeCoffExtraActionLib/PeiUnixPeCoffExtraActionLib.c
new file mode 100644
index 0000000000..c878b224da
--- /dev/null
+++ b/UnixPkg/Library/PeiUnixPeCoffExtraActionLib/PeiUnixPeCoffExtraActionLib.c
@@ -0,0 +1,137 @@
+/**@file
+
+Copyright (c) 2006, Intel Corporation
+All rights reserved. This program and the accompanying materials
+are licensed and made available under the terms and conditions of the BSD License
+which accompanies this distribution.  The full text of the license may be found at
+http://opensource.org/licenses/bsd-license.php
+
+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+Module Name:
+
+  PeiUnixPeCoffExtraActionLib.c
+
+Abstract:
+
+  Provides services to perform additional actions to relocate and unload
+  PE/Coff image for UNIX environment specific purpose such as souce level debug.
+  This version only works for PEI phase
+
+
+**/
+#include <PiPei.h>
+#include <Ppi/UnixThunk.h>
+#include <FrameworkModuleBase.h>
+
+#include <Library/PeCoffLib.h>
+#include <Library/PeiServicesLib.h>
+#include <Library/DebugLib.h>
+#include <Library/BaseLib.h>
+#include <Library/PeCoffExtraActionLib.h>
+
+//
+// Cache of UnixThunk protocol 
+//
+EFI_UNIX_THUNK_PROTOCOL   *mUnix = NULL;
+
+/**
+  The function caches the pointer of the WinNT thunk functions
+  It will ASSERT() if Unix thunk ppi is not installed.
+
+  @retval EFI_SUCCESS   WinNT thunk protocol is found and cached.
+
+**/
+EFI_STATUS
+EFIAPI
+UnixPeCoffGetUnixThunkStucture (
+  )
+{
+	PEI_UNIX_THUNK_PPI  *UnixThunkPpi;
+  EFI_STATUS        Status;
+
+  
+  //
+  // Locate Unix ThunkPpi for retrieving standard output handle
+  //
+  Status = PeiServicesLocatePpi (
+              &gPeiUnixThunkPpiGuid,
+              0,
+              NULL,
+              (VOID **) &UnixThunkPpi
+              );
+
+  ASSERT_EFI_ERROR (Status);
+
+  mUnix  = (EFI_UNIX_THUNK_PROTOCOL *) UnixThunkPpi->UnixThunk ();
+
+  return EFI_SUCCESS;
+}
+
+/**
+  Applies additional actions to relocate fixups to a PE/COFF image.
+
+  Generally this function is called after sucessfully Applying relocation fixups 
+  to a PE/COFF image for some specicial purpose.  
+  
+  @param  ImageContext        Pointer to the image context structure that describes the PE/COFF
+                              image that is being relocated.
+
+**/
+VOID
+EFIAPI
+PeCoffLoaderRelocateImageExtraAction (
+  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
+  )
+{
+  VOID * Handle;

+  VOID * Entry;

+

+  Handle = NULL;

+  Entry  = NULL;
+  
+  if (mUnix == NULL) {
+    UnixPeCoffGetUnixThunkStucture ();
+  }
+  DEBUG ((EFI_D_ERROR, "Loading %s 0x%08lx - entry point 0x%08lx\n",

+          ImageContext->PdbPointer,

+          (UINTN)ImageContext->ImageAddress,

+          (UINTN)ImageContext->EntryPoint));

+

+  Handle = mUnix->Dlopen (ImageContext->PdbPointer, RTLD_NOW);

+  

+  if (Handle) {

+    Entry = mUnix->Dlsym(Handle, "_ModuleEntryPoint");

+  } else {
+  	DEBUG ((EFI_D_ERROR, "%s\n", mUnix->Dlerror()));

+  }

+  

+  if (Entry != NULL) {

+    ImageContext->EntryPoint = Entry;
+    DEBUG ((EFI_D_ERROR, "Change %s Entrypoint to :0x%08lx\n", ImageContext->PdbPointer, Entry));

+  }

+

+

+  return;
+ }  
+
+/**
+  Unloads a loaded PE/COFF image from memory and releases its taken resource.
+  
+  Releases any environment specific resources that were allocated when the image 
+  specified by ImageContext was loaded using PeCoffLoaderLoadImage(). 
+  
+  If ImageContext is NULL, then ASSERT().
+  
+  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF
+                                    image to be unloaded.
+
+**/
+VOID
+EFIAPI
+PeCoffLoaderUnloadImageExtraAction (
+  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext
+  )
+{
+}
\ No newline at end of file
diff --git a/UnixPkg/Library/PeiUnixPeCoffLib/PeiUnixPeCoffLib.inf b/UnixPkg/Library/PeiUnixPeCoffExtraActionLib/PeiUnixPeCoffExtraActionLib.inf
index 6be755fd1a..1ecdd29681 100644
--- a/UnixPkg/Library/PeiUnixPeCoffLib/PeiUnixPeCoffLib.inf
+++ b/UnixPkg/Library/PeiUnixPeCoffExtraActionLib/PeiUnixPeCoffExtraActionLib.inf
@@ -1,51 +1,49 @@
-#/** @file

-# PeCoff libary for PEIM modules that run Unix emulator.

-#

-# Lib to provide memory journal status code reporting Routines

-# Copyright (c) 2007 - 2008, Intel Corporation

-# All rights reserved. This program and the accompanying materials

-# are licensed and made available under the terms and conditions of the BSD License

-# which accompanies this distribution.  The full text of the license may be found at

-# http://opensource.org/licenses/bsd-license.php

-#

-# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-#

-#

-#**/

-

-[Defines]

-  INF_VERSION                    = 0x00010005

-  BASE_NAME                      = PeiUnixPeCoffLib

-  FILE_GUID                      = 91404129-c58a-40bb-8a2b-f05bc05a961c

-  MODULE_TYPE                    = PEIM

-  VERSION_STRING                 = 1.0

-  LIBRARY_CLASS                  = PeCoffLib|PEIM

-  EDK_RELEASE_VERSION            = 0x00020000

-  EFI_SPECIFICATION_VERSION      = 0x00020000

-

-  CONSTRUCTOR                    = PeiUnixPeCoffLibConstructor

-

-#

-# The following information is for reference only and not required by the build tools.

-#

-#  VALID_ARCHITECTURES           = IA32

-#

-

-[Sources.common]

-  PeiUnixPeCoffLib.c

-

-[Packages]

-  MdePkg/MdePkg.dec

-  MdeModulePkg/MdeModulePkg.dec

-  UnixPkg/UnixPkg.dec

-

-[LibraryClasses]

-  DebugLib

-  HobLib

-  PeiServicesLib

-

-[Guids]

-  gEfiPeiPeCoffLoaderGuid                # ALWAYS_CONSUMED

-

+#/** @file
+# PeCoff extra action libary for Pei phase that run UNIX emulator.
+#
+# Lib to provide memory journal status code reporting Routines
+# Copyright (c) 2007, Intel Corporation
+# All rights reserved. This program and the accompanying materials
+# are licensed and made available under the terms and conditions of the BSD License
+# which accompanies this distribution.  The full text of the license may be found at
+# http://opensource.org/licenses/bsd-license.php
+#
+# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
+# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
+
+#
+#
+#**/
+
+[Defines]
+  INF_VERSION                    = 0x00010005
+  BASE_NAME                      = PeiUnixPeCoffExtraActionLib
+  FILE_GUID                      = 1D0D29DE-A5EC-46aa-AE8A-1A5A1F71F202
+  MODULE_TYPE                    = PEIM
+  VERSION_STRING                 = 1.0
+  LIBRARY_CLASS                  = PeCoffExtraActionLib|PEI_CORE PEIM
+  EDK_RELEASE_VERSION            = 0x00020000
+  EFI_SPECIFICATION_VERSION      = 0x00020000
+
+#
+# The following information is for reference only and not required by the build tools.
+#
+#  VALID_ARCHITECTURES           = IA32
+#
+
+[Sources.common]
+  PeiUnixPeCoffExtraActionLib.c
+
+[Packages]
+  MdePkg/MdePkg.dec
+  UnixPkg/UnixPkg.dec
+  IntelFrameworkModulePkg/IntelFrameworkModulePkg.dec
+  IntelFrameworkPkg/IntelFrameworkPkg.dec
+
+[LibraryClasses]
+  BaseLib
+  PeiServicesLib
+  DebugLib
+
+[Ppis]
+  gPeiUnixThunkPpiGuid                          # PPI ALWAYS_CONSUMED
diff --git a/UnixPkg/Library/PeiUnixPeCoffLib/PeiUnixPeCoffLib.c b/UnixPkg/Library/PeiUnixPeCoffLib/PeiUnixPeCoffLib.c
deleted file mode 100644
index bb88bc210f..0000000000
--- a/UnixPkg/Library/PeiUnixPeCoffLib/PeiUnixPeCoffLib.c
+++ /dev/null
@@ -1,254 +0,0 @@
-/**@file

-

-Copyright (c) 2006 - 2008, Intel Corporation

-All rights reserved. This program and the accompanying materials

-are licensed and made available under the terms and conditions of the BSD License

-which accompanies this distribution.  The full text of the license may be found at

-http://opensource.org/licenses/bsd-license.php

-

-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

-Module Name:

-

-  PeiUnixPeCoffLib.c

-

-Abstract:

-

-  Wrap the Unix PE/COFF loader with the PE COFF LOADER guid structure

-  to produce PeCoff library class.

-

-

-**/

-

-#include <PiPei.h>

-#include <Guid/PeiPeCoffLoader.h>

-#include <Library/DebugLib.h>

-#include <Library/PeCoffLib.h>

-#include <Library/HobLib.h>

-#include <Library/PeiServicesLib.h>

-

-EFI_PEI_PE_COFF_LOADER_PROTOCOL  *mPeiEfiPeiPeCoffLoader;

-

-/**

-  The constructor function caches the pointer of PeCofferLoader guid structure

-  into the guid data hob.

-

-  The constructor must be called after PeCofferLoader guid structure is installed.

-  It will ASSERT() if PeCofferLoader guid structure is not installed.

-

-  @param  FfsHeader   Pointer to FFS header the loaded driver.

-  @param  PeiServices Pointer to the PEI services.

-

-  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.

-

-**/

-EFI_STATUS

-EFIAPI

-PeiUnixPeCoffLibConstructor (

-  IN       EFI_PEI_FILE_HANDLE       FileHandle,

-  IN CONST EFI_PEI_SERVICES          **PeiServices

-  )

-{

-  EFI_STATUS           Status;

-  EFI_HOB_GUID_TYPE    *GuidHob;

-

-  Status = EFI_NOT_FOUND;

-  

-  //

-  // Try to get guid data hob that contains PeCoffLoader guid structure.

-  //

-  GuidHob = GetFirstGuidHob (&gEfiPeiPeCoffLoaderGuid);

-

-  if (GuidHob == NULL) {

-    //

-    // GuidHob is not ready, try to locate PeCoffLoader guid structure.

-    //

-    Status = PeiServicesLocatePpi (

-               &gEfiPeiPeCoffLoaderGuid,

-               0,

-               NULL,

-               (VOID **) &mPeiEfiPeiPeCoffLoader

-               );

-     //

-    // PeCofferLoader guid structure must be installed before this library runs.

-    //

-    ASSERT_EFI_ERROR (Status);

-    

-    //

-    // Build guid data hob of PeCofferLoader guid structure for DXE module use. 

-    //

-    BuildGuidDataHob (

-      &gEfiPeiPeCoffLoaderGuid,

-      (VOID *) &mPeiEfiPeiPeCoffLoader,

-      sizeof (VOID *)

-      );

-  } else {

-    //

-    // Get PeCofferLoader guid structure directly from guid hob data.

-    //

-    mPeiEfiPeiPeCoffLoader = (EFI_PEI_PE_COFF_LOADER_PROTOCOL *)(*(UINTN *)(GET_GUID_HOB_DATA (GuidHob)));

-  }

-

-  return EFI_SUCCESS;

-}

-

-/**

-  Retrieves information about a PE/COFF image.

-

-  Computes the PeCoffHeaderOffset, ImageAddress, ImageSize, DestinationAddress, CodeView,

-  PdbPointer, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva

-  fields of the ImageContext structure.  If ImageContext is NULL, then return RETURN_INVALID_PARAMETER.

-  If the PE/COFF image accessed through the ImageRead service in the ImageContext structure is not

-  a supported PE/COFF image type, then return RETURN_UNSUPPORTED.  If any errors occur while

-  computing the fields of ImageContext, then the error status is returned in the ImageError field of

-  ImageContext. 

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image that needs to be examined by this function.

-

-  @retval RETURN_SUCCESS            The information on the PE/COFF image was collected.

-  @retval RETURN_INVALID_PARAMETER  ImageContext is NULL.

-  @retval RETURN_UNSUPPORTED        The PE/COFF image is not supported.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderGetImageInfo (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-    return mPeiEfiPeiPeCoffLoader->GetImageInfo (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  Applies relocation fixups to a PE/COFF image that was loaded with PeCoffLoaderLoadImage().

-

-  If the DestinationAddress field of ImageContext is 0, then use the ImageAddress field of

-  ImageContext as the relocation base address.  Otherwise, use the DestinationAddress field

-  of ImageContext as the relocation base address.  The caller must allocate the relocation

-  fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function.  

-  If ImageContext is NULL, then ASSERT().

-

-  @param  ImageContext        Pointer to the image context structure that describes the PE/COFF

-                              image that is being relocated.

-

-  @retval RETURN_SUCCESS      The PE/COFF image was relocated.

-                              Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_LOAD_ERROR   The image in not a valid PE/COFF image.

-                              Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_UNSUPPORTED  A relocation record type is not supported.

-                              Extended status information is in the ImageError field of ImageContext.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderRelocateImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  return mPeiEfiPeiPeCoffLoader->RelocateImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  Loads a PE/COFF image into memory.

-

-  Loads the PE/COFF image accessed through the ImageRead service of ImageContext into the buffer

-  specified by the ImageAddress and ImageSize fields of ImageContext.  The caller must allocate

-  the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.

-  The EntryPoint, FixupDataSize, CodeView, and PdbPointer fields of ImageContext are computed.

-  If ImageContext is NULL, then ASSERT().

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image that is being loaded.

-

-  @retval RETURN_SUCCESS            The PE/COFF image was loaded into the buffer specified by

-                                    the ImageAddress and ImageSize fields of ImageContext.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_BUFFER_TOO_SMALL   The caller did not provide a large enough buffer.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_LOAD_ERROR         The PE/COFF image is an EFI Runtime image with no relocations.

-                                    Extended status information is in the ImageError field of ImageContext.

-  @retval RETURN_INVALID_PARAMETER  The image address is invalid.

-                                    Extended status information is in the ImageError field of ImageContext.

-

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderLoadImage (

-  IN OUT PE_COFF_LOADER_IMAGE_CONTEXT  *ImageContext

-  )

-{

-  return mPeiEfiPeiPeCoffLoader->LoadImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}

-

-/**

-  ImageRead function that operates on a memory buffer whos base is passed into

-  FileHandle. 

-

-  @param  FileHandle        Ponter to baes of the input stream

-  @param  FileOffset        Offset to the start of the buffer

-  @param  ReadSize          Number of bytes to copy into the buffer

-  @param  Buffer            Location to place results of read

-

-  @retval RETURN_SUCCESS    Data is read from FileOffset from the Handle into 

-                            the buffer.

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderImageReadFromMemory (

-  IN     VOID    *FileHandle,

-  IN     UINTN   FileOffset,

-  IN OUT UINTN   *ReadSize,

-  OUT    VOID    *Buffer

-  )

-{

-  return RETURN_UNSUPPORTED;

-}

-

-

-/**

-  Reapply fixups on a fixed up PE32/PE32+ image to allow virutal calling at EFI

-  runtime. 

-  

-  PE_COFF_LOADER_IMAGE_CONTEXT.FixupData stores information needed to reapply

-  the fixups with a virtual mapping.

-

-

-  @param  ImageBase          Base address of relocated image

-  @param  VirtImageBase      Virtual mapping for ImageBase

-  @param  ImageSize          Size of the image to relocate

-  @param  RelocationData     Location to place results of read

-  

-**/

-VOID

-EFIAPI

-PeCoffLoaderRelocateImageForRuntime (

-  IN  PHYSICAL_ADDRESS        ImageBase,

-  IN  PHYSICAL_ADDRESS        VirtImageBase,

-  IN  UINTN                   ImageSize,

-  IN  VOID                    *RelocationData

-  )

-{

-}

-

-/**

-  Unloads a loaded PE/COFF image from memory and releases its taken resource.

-   

-  For Unix emulator, the PE/COFF image loaded by system needs to release.

-  For real platform, the PE/COFF image loaded by Core doesn't needs to be unloaded, 

-  this function can simply return RETURN_SUCCESS.

-

-  @param  ImageContext              Pointer to the image context structure that describes the PE/COFF

-                                    image to be unloaded.

-

-  @retval RETURN_SUCCESS            The PE/COFF image was unloaded successfully.

-**/

-RETURN_STATUS

-EFIAPI

-PeCoffLoaderUnloadImage (

-  IN PE_COFF_LOADER_IMAGE_CONTEXT         *ImageContext

-  )

-{

-  return mPeiEfiPeiPeCoffLoader->UnloadImage (mPeiEfiPeiPeCoffLoader, ImageContext);

-}