Revision: 14597
http://sourceforge.net/p/edk2/code/14597
Author: shenshushi
Date: 2013-08-23 08:37:31 +0000 (Fri, 23 Aug 2013)
Log Message:
-----------
Update SetVariable() function description for the clarification of
requirements to update timestamp associated with authenticated variable.
Signed-off-by: Shumin Qiu <[email protected]>
Reviewed-by: Liming Gao <[email protected]>
Modified Paths:
--------------
trunk/edk2/MdePkg/Include/Uefi/UefiSpec.h
Modified: trunk/edk2/MdePkg/Include/Uefi/UefiSpec.h
===================================================================
--- trunk/edk2/MdePkg/Include/Uefi/UefiSpec.h 2013-08-23 08:31:11 UTC (rev
14596)
+++ trunk/edk2/MdePkg/Include/Uefi/UefiSpec.h 2013-08-23 08:37:31 UTC (rev
14597)
@@ -662,8 +662,15 @@
then EFI_INVALID_PARAMETER is returned.
@param VendorGuid A unique identifier for the vendor.
@param Attributes Attributes bitmask to set for the variable.
- @param DataSize The size in bytes of the Data buffer. A size
of zero causes the
- variable to be deleted.
+ @param DataSize The size in bytes of the Data buffer. Unless
the EFI_VARIABLE_APPEND_WRITE,
+ EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS, or
+
EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS attribute is set, a size of
zero
+ causes the variable to be deleted. When the
EFI_VARIABLE_APPEND_WRITE attribute is
+ set, then a SetVariable() call with a
DataSize of zero will not cause any change to
+ the variable value (the timestamp associated
with the variable may be updated however
+ even if no new data value is provided,see the
description of the
+ EFI_VARIABLE_AUTHENTICATION_2 descriptor
below. In this case the DataSize will not
+ be zero since the
EFI_VARIABLE_AUTHENTICATION_2 descriptor will be populated).
@param Data The contents for the variable.
@retval EFI_SUCCESS The firmware has successfully stored the
variable and its data as
@@ -675,9 +682,10 @@
@retval EFI_DEVICE_ERROR The variable could not be retrieved due to a
hardware error.
@retval EFI_WRITE_PROTECTED The variable in question is read-only.
@retval EFI_WRITE_PROTECTED The variable in question cannot be deleted.
- @retval EFI_SECURITY_VIOLATION The variable could not be written due to
EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS
- set but the AuthInfo does NOT pass the
validation check carried out
- by the firmware.
+ @retval EFI_SECURITY_VIOLATION The variable could not be written due to
EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS
+ or
EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACESS being set, but the AuthInfo
+ does NOT pass the validation check carried
out by the firmware.
+
@retval EFI_NOT_FOUND The variable trying to be updated or deleted
was not found.
**/
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
Introducing Performance Central, a new site from SourceForge and
AppDynamics. Performance Central is your source for news, insights,
analysis and resources for efficient Application Performance Management.
Visit us today!
http://pubads.g.doubleclick.net/gampad/clk?id=48897511&iu=/4140/ostg.clktrk
_______________________________________________
edk2-commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/edk2-commits
