3 Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>
4 Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 PeiUnixPeCoffExtraActionLib.c
19 Provides services to perform additional actions to relocate and unload
20 PE/Coff image for Unix environment specific purpose such as souce level debug.
21 This version only works for DXE phase
28 #include <Library/PeCoffLib.h>
30 #include <Library/BaseLib.h>
31 #include <Library/DebugLib.h>
32 #include <Library/HobLib.h>
33 #include <Library/BaseMemoryLib.h>
34 #include <Library/PeCoffExtraActionLib.h>
38 // Cache of UnixThunk protocol
42 EFI_UNIX_THUNK_PROTOCOL
*mUnix
= NULL
;
46 The constructor function gets the pointer of the WinNT thunk functions
47 It will ASSERT() if Unix thunk protocol is not installed.
49 @retval EFI_SUCCESS Unix thunk protocol is found and cached.
54 DxeUnixPeCoffLibExtraActionConstructor (
55 IN EFI_HANDLE ImageHandle
,
56 IN EFI_SYSTEM_TABLE
*SystemTable
59 EFI_HOB_GUID_TYPE
*GuidHob
;
62 // Retrieve UnixThunkProtocol from GUID'ed HOB
64 GuidHob
= GetFirstGuidHob (&gEfiUnixThunkProtocolGuid
);
65 ASSERT (GuidHob
!= NULL
);
66 mUnix
= (EFI_UNIX_THUNK_PROTOCOL
*)(*(UINTN
*)(GET_GUID_HOB_DATA (GuidHob
)));
67 ASSERT (mUnix
!= NULL
);
73 Performs additional actions after a PE/COFF image has been loaded and relocated.
75 If ImageContext is NULL, then ASSERT().
77 @param ImageContext Pointer to the image context structure that describes the
78 PE/COFF image that has already been loaded and relocated.
83 PeCoffLoaderRelocateImageExtraAction (
84 IN OUT PE_COFF_LOADER_IMAGE_CONTEXT
*ImageContext
87 mUnix
->PeCoffRelocateImageExtraAction (ImageContext
);
93 Performs additional actions just before a PE/COFF image is unloaded. Any resources
94 that were allocated by PeCoffLoaderRelocateImageExtraAction() must be freed.
96 If ImageContext is NULL, then ASSERT().
98 @param ImageContext Pointer to the image context structure that describes the
99 PE/COFF image that is being unloaded.
104 PeCoffLoaderUnloadImageExtraAction (
105 IN OUT PE_COFF_LOADER_IMAGE_CONTEXT
*ImageContext
108 mUnix
->PeCoffUnloadImageExtraAction (ImageContext
);