]> git.proxmox.com Git - mirror_edk2.git/commitdiff
Update function description per UEFI2.3d. The main changes include:
authorlgao4 <lgao4@6f19259b-4bc3-4df7-8a09-765794883524>
Sat, 12 Feb 2011 01:26:11 +0000 (01:26 +0000)
committerlgao4 <lgao4@6f19259b-4bc3-4df7-8a09-765794883524>
Sat, 12 Feb 2011 01:26:11 +0000 (01:26 +0000)
1.    If string is a unicode string, its description doesn’t need to specify unicode word again, because by default, string is UCS-2 (Table 6) encoded.
2.    EFI_UNSUPPORTED return status is missing for EFI_EAP_PROTOCOL.SetDesiredAuthMethod() function.
3.    For LoadImage() service, EFI_ACCESS_DENIED return status is added, and EFI_SECURITY_VIOLATION return status description is updated.

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

MdePkg/Include/Protocol/DriverHealth.h
MdePkg/Include/Protocol/Eap.h
MdePkg/Include/Protocol/PlatformToDriverConfiguration.h
MdePkg/Include/Uefi/UefiSpec.h

index 24bb5bc1ee5502d3110926d21abafe13d7dcb343..a4c92fbd907a7fadb5c40b6e1beb03ea339f2699 100644 (file)
@@ -20,7 +20,7 @@
   may then need to be reconnected or the system may need to be rebooted for the \r
   configuration changes to take affect. \r
 \r
-  Copyright (c) 2009, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>\r
   This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -30,7 +30,7 @@
   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 \r
   @par Revision Reference:\r
-  This Protocol is defined in UEFI Specification 2.2 \r
+  This Protocol is defined in UEFI Specification 2.3d \r
 \r
 **/\r
 \r
@@ -131,7 +131,7 @@ EFI_STATUS
                               containing a EFI_HII_HANDLE with a value of NULL.  The \r
                               EFI_HII_STRING_PROTOCOL.GetString() function can be used to \r
                               retrieve the warning or error message as a Null-terminated \r
-                              Unicode string in a specific language.  Messages may be \r
+                              string in a specific language.  Messages may be \r
                               returned for any of the HealthStatus values except \r
                               EfiDriverHealthStatusReconnectRequired and \r
                               EfiDriverHealthStatusRebootRequired.\r
index f6dde627be008476cf8770d1d677b382b6489b66..f1c45d495c29c3b2215c86dc76d284af33ff9c74 100644 (file)
@@ -5,7 +5,7 @@
   The definitions in this file are defined in UEFI Specification 2.3, which have\r
   not been verified by one implementation yet.\r
 \r
-  Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved.<BR>\r
   This program and the accompanying materials\r
   are licensed and made available under the terms and conditions of the BSD License\r
   which accompanies this distribution.  The full text of the license may be found at\r
@@ -83,8 +83,8 @@ EFI_STATUS
   \r
   If EapAuthType is an invalid EAP authentication type, then EFI_INVALID_PARAMETER is \r
   returned.\r
-  If the EAP authentication method of EapAuthType is unsupported by the Ports, then this\r
-  function will return EFI_UNSUPPORTED.\r
+  If the EAP authentication method of EapAuthType is unsupported by the Ports, then it will\r
+  return EFI_UNSUPPORTED.\r
 \r
   @param[in] This                A pointer to the EFI_EAP_PROTOCOL instance that indicates \r
                                  the calling context.\r
@@ -95,7 +95,8 @@ EFI_STATUS
   @retval EFI_SUCCESS            The EAP authentication method of EapAuthType is \r
                                  registered successfully.\r
   @retval EFI_INVALID_PARAMETER  EapAuthType is an invalid EAP authentication type.\r
-  @retval EFI_OUT_OF_RESOURCES   There is not enough system memory to perform the registration.\r
+  @retval EFI_UNSUPPORTED        The EAP authentication method of EapAuthType is\r
+                                 unsupported by the Port.\r
 \r
 **/\r
 typedef\r
index c7ffd21b5d6dcf08c8bf1ad1d1344982ec9aaff8..657c9e8c34e487d2ba5b6457f10cac52c143983b 100644 (file)
@@ -5,7 +5,7 @@
   by a UEFI Driver in its Start() function. This protocol allows the driver to receive \r
   configuration information as part of being started.\r
 \r
-  Copyright (c) 2006 - 2009, Intel Corporation. All rights reserved.<BR>\r
+  Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>\r
   This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -289,14 +289,15 @@ struct _EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOCOL {
   used.\r
 **/\r
 typedef struct {\r
-  CHAR8   *CLPCommand;        ///<  A pointer to the DMTF SM CLP command line null-terminated string that the \r
-                              ///<  driver is required to parse and process when this function is called. \r
+  CHAR8   *CLPCommand;        ///<  A pointer to the null-terminated UTF-8 string that specifies the DMTF SM CLP command\r
+                              ///<  line that the driver is required to parse and process when this function is called. \r
                               ///<  See the DMTF SM CLP Specification 1.0 Final Standard for details on the \r
                               ///<  format and syntax of the CLP command line string. CLPCommand buffer\r
                               ///<  is allocated by the producer of the EFI_PLATFORM_TO_DRIVER_CONFIGURATION_PROTOOL.\r
   UINT32  CLPCommandLength;   ///< The length of the CLP Command in bytes.\r
-  CHAR8   *CLPReturnString;   ///<  A pointer to the CLP return status string that the driver is required to\r
-                              ///<  provide to the calling agent. The calling agent may parse and/ or pass\r
+  CHAR8   *CLPReturnString;   ///<  A pointer to the null-terminated UTF-8 string that indicates the CLP return status\r
+                              ///<  that the driver is required to provide to the calling agent.\r
+                              ///<  The calling agent may parse and/ or pass\r
                               ///<  this for processing and user feedback. The SM CLP Command Response string\r
                               ///<  buffer is filled in by the UEFI driver in the "keyword=value" format\r
                               ///<  described in the SM CLP Specification, unless otherwise requested via the SM\r
index 2dbef696d56c88cedd13fbbb5a657e4486442f46..e5448f9a5380ece30d89f14acc62926893b99bd1 100644 (file)
@@ -1,11 +1,11 @@
 /** @file\r
   Include file that supports UEFI.\r
 \r
-  This include file must only contain things defined in the UEFI 2.1 specification.\r
-  If a code construct is defined in the UEFI 2.1 specification it must be included\r
+  This include file must contain things defined in the UEFI 2.3 specification.\r
+  If a code construct is defined in the UEFI 2.3 specification it must be included\r
   by this include file.\r
 \r
-Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>\r
+Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>\r
 This program and the accompanying materials are licensed and made available under \r
 the terms and conditions of the BSD License that accompanies this distribution.  \r
 The full text of the license may be found at\r
@@ -821,7 +821,11 @@ EFI_STATUS
   @retval EFI_LOAD_ERROR        Image was not loaded because the image format was corrupt or not\r
                                 understood.\r
   @retval EFI_DEVICE_ERROR      Image was not loaded because the device returned a read error.\r
-\r
+  @retval EFI_ACCESS_DENIED     Image was not loaded because the platform policy prohibits the \r
+                                image from being loaded. NULL is returned in *ImageHandle.\r
+  @retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a \r
+                                valid EFI_LOADED_IMAGE_PROTOCOL. However, the current \r
+                                platform policy specifies that the image should not be started.\r
 **/\r
 typedef\r
 EFI_STATUS\r