sravan/system76-edk2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updates function description per UEFI2.3d. No impact is for functionality. The main changes include:

Browse Source 
1. For LoadImage() service, EFI_ACCESS_DENIED return status is added, and EFI_SECURITY_VIOLATION return status description is updated. Meanwhile, EFI_PE32_IMAGE_PROTOCOL. LoadPeImage() in MdeModulePkg is also updated to match LoadImage() service.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11306 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
lgao4
2011-02-12 01:29:17 +00:00
parent 9095e76b3d
commit b695e7ff4a
4 changed files with 54 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
MdeModulePkg/Core/Dxe/DxeMain.h
View File

@ -2,7 +2,7 @@
The internal header file includes the common header files, defines The internal header file includes the common header files, defines
internal structure and functions used by DxeCore module. internal structure and functions used by DxeCore module.
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
@ -1298,6 +1298,14 @@ CoreFreePool (
protocol for loading the file. protocol for loading the file.
@retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient @retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient
resources. resources.
@retval EFI_LOAD_ERROR Image was not loaded because the image format was corrupt or not
understood.
@retval EFI_DEVICE_ERROR Image was not loaded because the device returned a read error.
@retval EFI_ACCESS_DENIED Image was not loaded because the platform policy prohibits the
image from being loaded. NULL is returned in *ImageHandle.
@retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a
valid EFI_LOADED_IMAGE_PROTOCOL. However, the current
platform policy specifies that the image should not be started.
**/ **/
EFI_STATUS EFI_STATUS
@ -1339,7 +1347,7 @@ CoreUnloadImage (
@param ImageHandle Handle of image to be started. @param ImageHandle Handle of image to be started.
@param ExitDataSize Pointer of the size to ExitData @param ExitDataSize Pointer of the size to ExitData
@param ExitData Pointer to a pointer to a data buffer that @param ExitData Pointer to a pointer to a data buffer that
includes a Null-terminated Unicode string, includes a Null-terminated string,
optionally followed by additional binary data. optionally followed by additional binary data.
The string is a description that the caller may The string is a description that the caller may
use to further indicate the reason for the use to further indicate the reason for the

28
MdeModulePkg/Core/Dxe/Image/Image.c
View File

@ -1,7 +1,7 @@
/** @file /** @file
Core image handling services to load and unload PeImage. Core image handling services to load and unload PeImage.
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
@ -959,6 +959,14 @@ CoreUnloadAndCloseImage (
protocol for loading the file. protocol for loading the file.
@retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient @retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient
resources. resources.
@retval EFI_LOAD_ERROR Image was not loaded because the image format was corrupt or not
understood.
@retval EFI_DEVICE_ERROR Image was not loaded because the device returned a read error.
@retval EFI_ACCESS_DENIED Image was not loaded because the platform policy prohibits the
image from being loaded. NULL is returned in *ImageHandle.
@retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a
valid EFI_LOADED_IMAGE_PROTOCOL. However, the current
platform policy specifies that the image should not be started.
**/ **/
EFI_STATUS EFI_STATUS
@ -1265,6 +1273,14 @@ Done:
protocol for loading the file. protocol for loading the file.
@retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient @retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient
resources. resources.
@retval EFI_LOAD_ERROR Image was not loaded because the image format was corrupt or not
understood.
@retval EFI_DEVICE_ERROR Image was not loaded because the device returned a read error.
@retval EFI_ACCESS_DENIED Image was not loaded because the platform policy prohibits the
image from being loaded. NULL is returned in *ImageHandle.
@retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a
valid EFI_LOADED_IMAGE_PROTOCOL. However, the current
platform policy specifies that the image should not be started.
**/ **/
EFI_STATUS EFI_STATUS
@ -1334,6 +1350,14 @@ CoreLoadImage (
protocol for loading the file. protocol for loading the file.
@retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient @retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient
resources. resources.
@retval EFI_LOAD_ERROR Image was not loaded because the image format was corrupt or not
understood.
@retval EFI_DEVICE_ERROR Image was not loaded because the device returned a read error.
@retval EFI_ACCESS_DENIED Image was not loaded because the platform policy prohibits the
image from being loaded. NULL is returned in *ImageHandle.
@retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a
valid EFI_LOADED_IMAGE_PROTOCOL. However, the current
platform policy specifies that the image should not be started.
**/ **/
EFI_STATUS EFI_STATUS
@ -1372,7 +1396,7 @@ CoreLoadImageEx (
@param ImageHandle Handle of image to be started. @param ImageHandle Handle of image to be started.
@param ExitDataSize Pointer of the size to ExitData @param ExitDataSize Pointer of the size to ExitData
@param ExitData Pointer to a pointer to a data buffer that @param ExitData Pointer to a pointer to a data buffer that
includes a Null-terminated Unicode string, includes a Null-terminated string,
optionally followed by additional binary data. optionally followed by additional binary data.
The string is a description that the caller may The string is a description that the caller may
use to further indicate the reason for the use to further indicate the reason for the

10
MdeModulePkg/Core/Dxe/Image/Image.h
View File

@ -1,7 +1,7 @@
/** @file /** @file
Data structure and functions to load and unload PeImage. Data structure and functions to load and unload PeImage.
Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
@ -116,6 +116,14 @@ typedef struct {
protocol for loading the file. protocol for loading the file.
@retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient @retval EFI_OUT_OF_RESOURCES Image was not loaded due to insufficient
resources. resources.
@retval EFI_LOAD_ERROR Image was not loaded because the image format was corrupt or not
understood.
@retval EFI_DEVICE_ERROR Image was not loaded because the device returned a read error.
@retval EFI_ACCESS_DENIED Image was not loaded because the platform policy prohibits the
image from being loaded. NULL is returned in *ImageHandle.
@retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a
valid EFI_LOADED_IMAGE_PROTOCOL. However, the current
platform policy specifies that the image should not be started.
**/ **/
EFI_STATUS EFI_STATUS

10
MdeModulePkg/Include/Protocol/LoadPe32Image.h
View File

@ -3,7 +3,7 @@
Load Pe32 Image protocol enables loading and unloading EFI images into memory and executing those images. Load Pe32 Image protocol enables loading and unloading EFI images into memory and executing those images.
This protocol uses File Device Path to get an EFI image. This protocol uses File Device Path to get an EFI image.
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR> Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>
This program and the accompanying materials are licensed and made available under This program and the accompanying materials are licensed and made available under
the terms and conditions of the BSD License that accompanies this distribution. the terms and conditions of the BSD License that accompanies this distribution.
The full text of the license may be found at The full text of the license may be found at
@ -49,6 +49,14 @@ typedef struct _EFI_PE32_IMAGE_PROTOCOL EFI_PE32_IMAGE_PROTOCOL;
@retval EFI_UNSUPPORTED The image type is not supported, or the device path cannot be @retval EFI_UNSUPPORTED The image type is not supported, or the device path cannot be
parsed to locate the proper protocol for loading the file. parsed to locate the proper protocol for loading the file.
@retval EFI_OUT_OF_RESOURCES The image was not loaded due to insufficient memory resources. @retval EFI_OUT_OF_RESOURCES The image was not loaded due to insufficient memory resources.
@retval EFI_LOAD_ERROR Image was not loaded because the image format was corrupt or not
understood.
@retval EFI_DEVICE_ERROR Image was not loaded because the device returned a read error.
@retval EFI_ACCESS_DENIED Image was not loaded because the platform policy prohibits the
image from being loaded. NULL is returned in *ImageHandle.
@retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a
valid EFI_LOADED_IMAGE_PROTOCOL. However, the current
platform policy specifies that the image should not be started.
**/ **/
typedef typedef
EFI_STATUS EFI_STATUS