2 Implementation functions and structures for var check protocol.
4 Copyright (c) 2015, Intel Corporation. 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.
16 #include <Library/DevicePathLib.h>
18 extern LIST_ENTRY mLockedVariableList
;
19 extern BOOLEAN mEndOfDxe
;
20 extern BOOLEAN mEnableLocking
;
22 #define VAR_CHECK_HANDLER_TABLE_SIZE 0x8
24 UINT32 mNumberOfHandler
= 0;
25 UINT32 mMaxNumberOfHandler
= 0;
26 VAR_CHECK_SET_VARIABLE_CHECK_HANDLER
*mHandlerTable
= NULL
;
31 VAR_CHECK_VARIABLE_PROPERTY VariableProperty
;
33 } VAR_CHECK_VARIABLE_ENTRY
;
35 LIST_ENTRY mVarCheckVariableList
= INITIALIZE_LIST_HEAD_VARIABLE (mVarCheckVariableList
);
39 (EFIAPI
*INTERNAL_VAR_CHECK_FUNCTION
) (
40 IN VAR_CHECK_VARIABLE_PROPERTY
*Propery
,
47 VAR_CHECK_VARIABLE_PROPERTY VariableProperty
;
48 INTERNAL_VAR_CHECK_FUNCTION CheckFunction
;
49 } UEFI_DEFINED_VARIABLE_ENTRY
;
51 typedef struct _EFI_LOAD_OPTION
{
53 UINT16 FilePathListLength
;
54 //CHAR16 Description[];
55 //EFI_DEVICE_PATH_PROTOCOL FilePathList[];
56 //UINT8 OptionalData[];
60 Internal check for load option.
62 @param[in] VariablePropery Pointer to variable property.
63 @param[in] DataSize Data size.
64 @param[in] Data Pointer to data buffer.
66 @retval EFI_SUCCESS The SetVariable check result was success.
67 @retval EFI_INVALID_PARAMETER The data buffer is not a valid load option.
72 InternalVarCheckLoadOption (
73 IN VAR_CHECK_VARIABLE_PROPERTY
*VariablePropery
,
78 EFI_LOAD_OPTION
*LoadOption
;
80 EFI_DEVICE_PATH_PROTOCOL
*FilePathList
;
82 LoadOption
= (EFI_LOAD_OPTION
*) Data
;
87 Description
= (CHAR16
*) ((UINTN
) Data
+ sizeof (EFI_LOAD_OPTION
));
88 while (Description
< (CHAR16
*) ((UINTN
) Data
+ DataSize
)) {
89 if (*Description
== L
'\0') {
94 if ((UINTN
) Description
>= ((UINTN
) Data
+ DataSize
)) {
95 return EFI_INVALID_PARAMETER
;
100 // Check FilePathList
102 FilePathList
= (EFI_DEVICE_PATH_PROTOCOL
*) Description
;
103 if ((UINTN
) FilePathList
> (MAX_ADDRESS
- LoadOption
->FilePathListLength
)) {
104 return EFI_INVALID_PARAMETER
;
106 if (((UINTN
) FilePathList
+ LoadOption
->FilePathListLength
) > ((UINTN
) Data
+ DataSize
)) {
107 return EFI_INVALID_PARAMETER
;
109 if (LoadOption
->FilePathListLength
< sizeof (EFI_DEVICE_PATH_PROTOCOL
)) {
110 return EFI_INVALID_PARAMETER
;
112 if (!IsDevicePathValid (FilePathList
, LoadOption
->FilePathListLength
)) {
113 return EFI_INVALID_PARAMETER
;
120 Internal check for key option.
122 @param[in] VariablePropery Pointer to variable property.
123 @param[in] DataSize Data size.
124 @param[in] Data Pointer to data buffer.
126 @retval EFI_SUCCESS The SetVariable check result was success.
127 @retval EFI_INVALID_PARAMETER The data buffer is not a valid key option.
132 InternalVarCheckKeyOption (
133 IN VAR_CHECK_VARIABLE_PROPERTY
*VariablePropery
,
138 if (((DataSize
- sizeof (EFI_KEY_OPTION
)) % sizeof (EFI_INPUT_KEY
)) != 0) {
139 return EFI_INVALID_PARAMETER
;
146 Internal check for device path.
148 @param[in] VariablePropery Pointer to variable property.
149 @param[in] DataSize Data size.
150 @param[in] Data Pointer to data buffer.
152 @retval EFI_SUCCESS The SetVariable check result was success.
153 @retval EFI_INVALID_PARAMETER The data buffer is not a valid device path.
158 InternalVarCheckDevicePath (
159 IN VAR_CHECK_VARIABLE_PROPERTY
*VariablePropery
,
164 if (!IsDevicePathValid ((EFI_DEVICE_PATH_PROTOCOL
*) Data
, DataSize
)) {
165 return EFI_INVALID_PARAMETER
;
171 Internal check for ASCII string.
173 @param[in] VariablePropery Pointer to variable property.
174 @param[in] DataSize Data size.
175 @param[in] Data Pointer to data buffer.
177 @retval EFI_SUCCESS The SetVariable check result was success.
178 @retval EFI_INVALID_PARAMETER The data buffer is not a Null-terminated ASCII string.
183 InternalVarCheckAsciiString (
184 IN VAR_CHECK_VARIABLE_PROPERTY
*VariablePropery
,
192 String
= (CHAR8
*) Data
;
193 if (String
[DataSize
- 1] == '\0') {
196 for (Index
= 1; Index
< DataSize
&& (String
[DataSize
- 1 - Index
] != '\0'); Index
++);
197 if (Index
== DataSize
) {
198 return EFI_INVALID_PARAMETER
;
205 Internal check for size array.
207 @param[in] VariablePropery Pointer to variable property.
208 @param[in] DataSize Data size.
209 @param[in] Data Pointer to data buffer.
211 @retval EFI_SUCCESS The SetVariable check result was success.
212 @retval EFI_INVALID_PARAMETER The DataSize is not size array.
217 InternalVarCheckSizeArray (
218 IN VAR_CHECK_VARIABLE_PROPERTY
*VariablePropery
,
223 if ((DataSize
% VariablePropery
->MinSize
) != 0) {
224 return EFI_INVALID_PARAMETER
;
230 // To prevent name collisions with possible future globally defined variables,
231 // other internal firmware data variables that are not defined here must be
232 // saved with a unique VendorGuid other than EFI_GLOBAL_VARIABLE or
233 // any other GUID defined by the UEFI Specification. Implementations must
234 // only permit the creation of variables with a UEFI Specification-defined
235 // VendorGuid when these variables are documented in the UEFI Specification.
237 UEFI_DEFINED_VARIABLE_ENTRY mGlobalVariableList
[] = {
239 EFI_LANG_CODES_VARIABLE_NAME
,
241 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
243 VARIABLE_ATTRIBUTE_BS_RT
,
247 InternalVarCheckAsciiString
250 EFI_LANG_VARIABLE_NAME
,
252 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
254 VARIABLE_ATTRIBUTE_NV_BS_RT
,
258 InternalVarCheckAsciiString
261 EFI_TIME_OUT_VARIABLE_NAME
,
263 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
265 VARIABLE_ATTRIBUTE_NV_BS_RT
,
272 EFI_PLATFORM_LANG_CODES_VARIABLE_NAME
,
274 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
276 VARIABLE_ATTRIBUTE_BS_RT
,
280 InternalVarCheckAsciiString
283 EFI_PLATFORM_LANG_VARIABLE_NAME
,
285 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
287 VARIABLE_ATTRIBUTE_NV_BS_RT
,
291 InternalVarCheckAsciiString
294 EFI_CON_IN_VARIABLE_NAME
,
296 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
298 VARIABLE_ATTRIBUTE_NV_BS_RT
,
299 sizeof (EFI_DEVICE_PATH_PROTOCOL
),
302 InternalVarCheckDevicePath
305 EFI_CON_OUT_VARIABLE_NAME
,
307 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
309 VARIABLE_ATTRIBUTE_NV_BS_RT
,
310 sizeof (EFI_DEVICE_PATH_PROTOCOL
),
313 InternalVarCheckDevicePath
316 EFI_ERR_OUT_VARIABLE_NAME
,
318 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
320 VARIABLE_ATTRIBUTE_NV_BS_RT
,
321 sizeof (EFI_DEVICE_PATH_PROTOCOL
),
324 InternalVarCheckDevicePath
327 EFI_CON_IN_DEV_VARIABLE_NAME
,
329 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
331 VARIABLE_ATTRIBUTE_BS_RT
,
332 sizeof (EFI_DEVICE_PATH_PROTOCOL
),
335 InternalVarCheckDevicePath
338 EFI_CON_OUT_DEV_VARIABLE_NAME
,
340 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
342 VARIABLE_ATTRIBUTE_BS_RT
,
343 sizeof (EFI_DEVICE_PATH_PROTOCOL
),
346 InternalVarCheckDevicePath
349 EFI_ERR_OUT_DEV_VARIABLE_NAME
,
351 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
353 VARIABLE_ATTRIBUTE_BS_RT
,
354 sizeof (EFI_DEVICE_PATH_PROTOCOL
),
357 InternalVarCheckDevicePath
360 EFI_BOOT_ORDER_VARIABLE_NAME
,
362 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
364 VARIABLE_ATTRIBUTE_NV_BS_RT
,
368 InternalVarCheckSizeArray
371 EFI_BOOT_NEXT_VARIABLE_NAME
,
373 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
375 VARIABLE_ATTRIBUTE_NV_BS_RT
,
382 EFI_BOOT_CURRENT_VARIABLE_NAME
,
384 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
386 VARIABLE_ATTRIBUTE_BS_RT
,
393 EFI_BOOT_OPTION_SUPPORT_VARIABLE_NAME
,
395 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
397 VARIABLE_ATTRIBUTE_BS_RT
,
404 EFI_DRIVER_ORDER_VARIABLE_NAME
,
406 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
408 VARIABLE_ATTRIBUTE_NV_BS_RT
,
412 InternalVarCheckSizeArray
415 EFI_HW_ERR_REC_SUPPORT_VARIABLE_NAME
,
417 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
419 VARIABLE_ATTRIBUTE_NV_BS_RT
,
428 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
429 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
430 VARIABLE_ATTRIBUTE_BS_RT
,
437 EFI_KEY_EXCHANGE_KEY_NAME
,
439 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
441 VARIABLE_ATTRIBUTE_NV_BS_RT_AT
,
448 EFI_PLATFORM_KEY_NAME
,
450 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
452 VARIABLE_ATTRIBUTE_NV_BS_RT_AT
,
459 EFI_SIGNATURE_SUPPORT_NAME
,
461 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
462 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
463 VARIABLE_ATTRIBUTE_BS_RT
,
467 InternalVarCheckSizeArray
470 EFI_SECURE_BOOT_MODE_NAME
,
472 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
473 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
474 VARIABLE_ATTRIBUTE_BS_RT
,
481 EFI_KEK_DEFAULT_VARIABLE_NAME
,
483 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
484 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
485 VARIABLE_ATTRIBUTE_BS_RT
,
492 EFI_PK_DEFAULT_VARIABLE_NAME
,
494 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
495 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
496 VARIABLE_ATTRIBUTE_BS_RT
,
503 EFI_DB_DEFAULT_VARIABLE_NAME
,
505 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
506 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
507 VARIABLE_ATTRIBUTE_BS_RT
,
514 EFI_DBX_DEFAULT_VARIABLE_NAME
,
516 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
517 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
518 VARIABLE_ATTRIBUTE_BS_RT
,
525 EFI_DBT_DEFAULT_VARIABLE_NAME
,
527 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
528 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
529 VARIABLE_ATTRIBUTE_BS_RT
,
536 EFI_OS_INDICATIONS_SUPPORT_VARIABLE_NAME
,
538 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
540 VARIABLE_ATTRIBUTE_BS_RT
,
547 EFI_OS_INDICATIONS_VARIABLE_NAME
,
549 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
551 VARIABLE_ATTRIBUTE_NV_BS_RT
,
558 EFI_VENDOR_KEYS_VARIABLE_NAME
,
560 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
561 VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
,
562 VARIABLE_ATTRIBUTE_BS_RT
,
569 UEFI_DEFINED_VARIABLE_ENTRY mGlobalVariableList2
[] = {
573 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
575 VARIABLE_ATTRIBUTE_NV_BS_RT
,
576 sizeof (EFI_LOAD_OPTION
),
579 InternalVarCheckLoadOption
584 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
586 VARIABLE_ATTRIBUTE_NV_BS_RT
,
587 sizeof (EFI_LOAD_OPTION
),
590 InternalVarCheckLoadOption
595 VAR_CHECK_VARIABLE_PROPERTY_REVISION
,
597 VARIABLE_ATTRIBUTE_NV_BS_RT
,
598 sizeof (EFI_KEY_OPTION
),
599 sizeof (EFI_KEY_OPTION
) + 3 * sizeof (EFI_INPUT_KEY
)
601 InternalVarCheckKeyOption
606 Get UEFI defined global variable property.
607 The code will check if variable guid is global variable guid first.
608 If yes, further check if variable name is in mGlobalVariableList or mGlobalVariableList2.
610 @param[in] VariableName Pointer to variable name.
611 @param[in] VendorGuid Variable Vendor Guid.
612 @param[in] WildcardMatch Try wildcard match or not.
613 @param[out] VariableProperty Pointer to variable property.
614 @param[out] VarCheckFunction Pointer to check function.
616 @retval EFI_SUCCESS Variable is not global variable.
617 @retval EFI_INVALID_PARAMETER Variable is global variable, but variable name is not in the lists.
621 GetUefiDefinedVariableProperty (
622 IN CHAR16
*VariableName
,
623 IN EFI_GUID
*VendorGuid
,
624 IN BOOLEAN WildcardMatch
,
625 OUT VAR_CHECK_VARIABLE_PROPERTY
**VariableProperty
,
626 OUT INTERNAL_VAR_CHECK_FUNCTION
*VarCheckFunction OPTIONAL
632 if (CompareGuid (VendorGuid
, &gEfiGlobalVariableGuid
)) {
634 // Try list 1, exactly match.
636 for (Index
= 0; Index
< sizeof (mGlobalVariableList
)/sizeof (mGlobalVariableList
[0]); Index
++) {
637 if (StrCmp (mGlobalVariableList
[Index
].Name
, VariableName
) == 0) {
638 if (VarCheckFunction
!= NULL
) {
639 *VarCheckFunction
= mGlobalVariableList
[Index
].CheckFunction
;
641 *VariableProperty
= &mGlobalVariableList
[Index
].VariableProperty
;
649 NameLength
= StrLen (VariableName
) - 4;
650 for (Index
= 0; Index
< sizeof (mGlobalVariableList2
)/sizeof (mGlobalVariableList2
[0]); Index
++) {
652 if ((StrLen (VariableName
) == StrLen (mGlobalVariableList2
[Index
].Name
)) &&
653 (StrnCmp (mGlobalVariableList2
[Index
].Name
, VariableName
, NameLength
) == 0) &&
654 IsHexaDecimalDigitCharacter (VariableName
[NameLength
]) &&
655 IsHexaDecimalDigitCharacter (VariableName
[NameLength
+ 1]) &&
656 IsHexaDecimalDigitCharacter (VariableName
[NameLength
+ 2]) &&
657 IsHexaDecimalDigitCharacter (VariableName
[NameLength
+ 3])) {
658 if (VarCheckFunction
!= NULL
) {
659 *VarCheckFunction
= mGlobalVariableList2
[Index
].CheckFunction
;
661 *VariableProperty
= &mGlobalVariableList2
[Index
].VariableProperty
;
665 if (StrCmp (mGlobalVariableList2
[Index
].Name
, VariableName
) == 0) {
666 if (VarCheckFunction
!= NULL
) {
667 *VarCheckFunction
= mGlobalVariableList2
[Index
].CheckFunction
;
669 *VariableProperty
= &mGlobalVariableList2
[Index
].VariableProperty
;
676 // The variable name is not in the lists.
678 return EFI_INVALID_PARAMETER
;
682 // It is not global variable.
688 Internal SetVariable check.
690 @param[in] VariableName Name of Variable to set.
691 @param[in] VendorGuid Variable vendor GUID.
692 @param[in] Attributes Attribute value of the variable.
693 @param[in] DataSize Size of Data to set.
694 @param[in] Data Data pointer.
696 @retval EFI_SUCCESS The SetVariable check result was success.
697 @retval EFI_INVALID_PARAMETER An invalid combination of attribute bits, name, and GUID were supplied,
698 or the DataSize exceeds the minimum or maximum allowed,
699 or the Data value is not following UEFI spec for UEFI defined variables.
700 @retval EFI_WRITE_PROTECTED The variable in question is read-only.
701 @retval Others The return status from check handler.
706 InternalVarCheckSetVariableCheck (
707 IN CHAR16
*VariableName
,
708 IN EFI_GUID
*VendorGuid
,
709 IN UINT32 Attributes
,
717 VAR_CHECK_VARIABLE_ENTRY
*Entry
;
719 VAR_CHECK_VARIABLE_PROPERTY
*Property
;
720 INTERNAL_VAR_CHECK_FUNCTION VarCheckFunction
;
724 // Only do check after End Of Dxe.
730 Status
= GetUefiDefinedVariableProperty (VariableName
, VendorGuid
, TRUE
, &Property
, &VarCheckFunction
);
731 if (EFI_ERROR (Status
)) {
732 DEBUG ((EFI_D_INFO
, "[Variable]: Var Check UEFI defined variable fail %r - %g:%s\n", Status
, VendorGuid
, VariableName
));
735 if (Property
== NULL
) {
736 VarCheckFunction
= NULL
;
737 for ( Link
= GetFirstNode (&mVarCheckVariableList
)
738 ; !IsNull (&mVarCheckVariableList
, Link
)
739 ; Link
= GetNextNode (&mVarCheckVariableList
, Link
)
741 Entry
= BASE_CR (Link
, VAR_CHECK_VARIABLE_ENTRY
, Link
);
742 Name
= (CHAR16
*) ((UINTN
) Entry
+ sizeof (*Entry
));
743 if (CompareGuid (&Entry
->Guid
, VendorGuid
) && (StrCmp (Name
, VariableName
) == 0)) {
744 Property
= &Entry
->VariableProperty
;
749 if (Property
!= NULL
) {
750 if (mEnableLocking
&& ((Property
->Property
& VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
) != 0)) {
751 DEBUG ((EFI_D_INFO
, "[Variable]: Var Check ReadOnly variable fail %r - %g:%s\n", EFI_WRITE_PROTECTED
, VendorGuid
, VariableName
));
752 return EFI_WRITE_PROTECTED
;
754 if ((DataSize
== 0) || (Attributes
== 0)) {
756 // Do not check delete variable.
760 if (Attributes
!= Property
->Attributes
) {
761 DEBUG ((EFI_D_INFO
, "[Variable]: Var Check Attributes fail %r - %g:%s\n", EFI_INVALID_PARAMETER
, VendorGuid
, VariableName
));
762 return EFI_INVALID_PARAMETER
;
764 if ((DataSize
< Property
->MinSize
) || (DataSize
> Property
->MaxSize
)) {
765 DEBUG ((EFI_D_INFO
, "[Variable]: Var Check DataSize fail %r - %g:%s\n", EFI_INVALID_PARAMETER
, VendorGuid
, VariableName
));
766 return EFI_INVALID_PARAMETER
;
768 if (VarCheckFunction
!= NULL
) {
769 Status
= VarCheckFunction (
774 if (EFI_ERROR (Status
)) {
775 DEBUG ((EFI_D_INFO
, "[Variable]: Internal Var Check function fail %r - %g:%s\n", Status
, VendorGuid
, VariableName
));
781 for (Index
= 0; Index
< mNumberOfHandler
; Index
++) {
782 Status
= mHandlerTable
[Index
] (
789 if (EFI_ERROR (Status
)) {
790 DEBUG ((EFI_D_INFO
, "[Variable]: Var Check handler fail %r - %g:%s\n", Status
, VendorGuid
, VariableName
));
798 Reallocates more global memory to store the registered handler list.
800 @retval RETURN_SUCCESS Reallocate memory successfully.
801 @retval RETURN_OUT_OF_RESOURCES No enough memory to allocate.
806 ReallocateHandlerTable (
810 VAR_CHECK_SET_VARIABLE_CHECK_HANDLER
*HandlerTable
;
813 // Reallocate memory for check handler table.
815 HandlerTable
= ReallocateRuntimePool (
816 mMaxNumberOfHandler
* sizeof (VAR_CHECK_SET_VARIABLE_CHECK_HANDLER
),
817 (mMaxNumberOfHandler
+ VAR_CHECK_HANDLER_TABLE_SIZE
) * sizeof (VAR_CHECK_SET_VARIABLE_CHECK_HANDLER
),
822 // No enough resource to allocate.
824 if (HandlerTable
== NULL
) {
825 return RETURN_OUT_OF_RESOURCES
;
828 mHandlerTable
= HandlerTable
;
830 // Increase max handler number.
832 mMaxNumberOfHandler
= mMaxNumberOfHandler
+ VAR_CHECK_HANDLER_TABLE_SIZE
;
833 return RETURN_SUCCESS
;
837 Register SetVariable check handler.
839 @param[in] Handler Pointer to check handler.
841 @retval EFI_SUCCESS The SetVariable check handler was registered successfully.
842 @retval EFI_INVALID_PARAMETER Handler is NULL.
843 @retval EFI_ACCESS_DENIED EFI_END_OF_DXE_EVENT_GROUP_GUID or EFI_EVENT_GROUP_READY_TO_BOOT has
844 already been signaled.
845 @retval EFI_OUT_OF_RESOURCES There is not enough resource for the SetVariable check handler register request.
846 @retval EFI_UNSUPPORTED This interface is not implemented.
847 For example, it is unsupported in VarCheck protocol if both VarCheck and SmmVarCheck protocols are present.
852 VarCheckRegisterSetVariableCheckHandler (
853 IN VAR_CHECK_SET_VARIABLE_CHECK_HANDLER Handler
858 if (Handler
== NULL
) {
859 return EFI_INVALID_PARAMETER
;
863 return EFI_ACCESS_DENIED
;
866 DEBUG ((EFI_D_INFO
, "RegisterSetVariableCheckHandler - 0x%x\n", Handler
));
869 // Check whether the handler list is enough to store new handler.
871 if (mNumberOfHandler
== mMaxNumberOfHandler
) {
873 // Allocate more resources for new handler.
875 Status
= ReallocateHandlerTable();
876 if (EFI_ERROR (Status
)) {
882 // Register new handler into the handler list.
884 mHandlerTable
[mNumberOfHandler
] = Handler
;
891 Internal variable property get.
893 @param[in] Name Pointer to the variable name.
894 @param[in] Guid Pointer to the vendor GUID.
896 @return Pointer to the property of variable specified by the Name and Guid.
899 VAR_CHECK_VARIABLE_PROPERTY
*
900 InternalVarCheckVariablePropertyGet (
906 VAR_CHECK_VARIABLE_ENTRY
*Entry
;
907 CHAR16
*VariableName
;
908 VAR_CHECK_VARIABLE_PROPERTY
*Property
;
911 GetUefiDefinedVariableProperty (Name
, Guid
, FALSE
, &Property
, NULL
);
912 if (Property
!= NULL
) {
915 for ( Link
= GetFirstNode (&mVarCheckVariableList
)
916 ; !IsNull (&mVarCheckVariableList
, Link
)
917 ; Link
= GetNextNode (&mVarCheckVariableList
, Link
)
919 Entry
= BASE_CR (Link
, VAR_CHECK_VARIABLE_ENTRY
, Link
);
920 VariableName
= (CHAR16
*) ((UINTN
) Entry
+ sizeof (*Entry
));
921 if (CompareGuid (&Entry
->Guid
, Guid
) && (StrCmp (VariableName
, Name
) == 0)) {
922 return &Entry
->VariableProperty
;
931 Variable property set.
933 @param[in] Name Pointer to the variable name.
934 @param[in] Guid Pointer to the vendor GUID.
935 @param[in] VariableProperty Pointer to the input variable property.
937 @retval EFI_SUCCESS The property of variable specified by the Name and Guid was set successfully.
938 @retval EFI_INVALID_PARAMETER Name, Guid or VariableProperty is NULL, or Name is an empty string,
939 or the fields of VariableProperty are not valid.
940 @retval EFI_ACCESS_DENIED EFI_END_OF_DXE_EVENT_GROUP_GUID or EFI_EVENT_GROUP_READY_TO_BOOT has
941 already been signaled.
942 @retval EFI_OUT_OF_RESOURCES There is not enough resource for the variable property set request.
947 VarCheckVariablePropertySet (
950 IN VAR_CHECK_VARIABLE_PROPERTY
*VariableProperty
954 VAR_CHECK_VARIABLE_ENTRY
*Entry
;
955 CHAR16
*VariableName
;
956 VAR_CHECK_VARIABLE_PROPERTY
*Property
;
958 if (Name
== NULL
|| Name
[0] == 0 || Guid
== NULL
) {
959 return EFI_INVALID_PARAMETER
;
962 if (VariableProperty
== NULL
) {
963 return EFI_INVALID_PARAMETER
;
966 if (VariableProperty
->Revision
!= VAR_CHECK_VARIABLE_PROPERTY_REVISION
) {
967 return EFI_INVALID_PARAMETER
;
971 return EFI_ACCESS_DENIED
;
974 Status
= EFI_SUCCESS
;
976 AcquireLockOnlyAtBootTime (&mVariableModuleGlobal
->VariableGlobal
.VariableServicesLock
);
978 Property
= InternalVarCheckVariablePropertyGet (Name
, Guid
);
979 if (Property
!= NULL
) {
980 CopyMem (Property
, VariableProperty
, sizeof (*VariableProperty
));
982 Entry
= AllocateRuntimeZeroPool (sizeof (*Entry
) + StrSize (Name
));
984 Status
= EFI_OUT_OF_RESOURCES
;
987 VariableName
= (CHAR16
*) ((UINTN
) Entry
+ sizeof (*Entry
));
988 StrnCpy (VariableName
, Name
, StrLen (Name
));
989 CopyGuid (&Entry
->Guid
, Guid
);
990 CopyMem (&Entry
->VariableProperty
, VariableProperty
, sizeof (*VariableProperty
));
991 InsertTailList (&mVarCheckVariableList
, &Entry
->Link
);
995 ReleaseLockOnlyAtBootTime (&mVariableModuleGlobal
->VariableGlobal
.VariableServicesLock
);
1001 Variable property get.
1003 @param[in] Name Pointer to the variable name.
1004 @param[in] Guid Pointer to the vendor GUID.
1005 @param[out] VariableProperty Pointer to the output variable property.
1007 @retval EFI_SUCCESS The property of variable specified by the Name and Guid was got successfully.
1008 @retval EFI_INVALID_PARAMETER Name, Guid or VariableProperty is NULL, or Name is an empty string.
1009 @retval EFI_NOT_FOUND The property of variable specified by the Name and Guid was not found.
1014 VarCheckVariablePropertyGet (
1017 OUT VAR_CHECK_VARIABLE_PROPERTY
*VariableProperty
1021 VARIABLE_ENTRY
*Entry
;
1022 CHAR16
*VariableName
;
1024 VAR_CHECK_VARIABLE_PROPERTY
*Property
;
1026 if (Name
== NULL
|| Name
[0] == 0 || Guid
== NULL
) {
1027 return EFI_INVALID_PARAMETER
;
1030 if (VariableProperty
== NULL
) {
1031 return EFI_INVALID_PARAMETER
;
1036 AcquireLockOnlyAtBootTime (&mVariableModuleGlobal
->VariableGlobal
.VariableServicesLock
);
1038 Property
= InternalVarCheckVariablePropertyGet (Name
, Guid
);
1039 if (Property
!= NULL
) {
1040 CopyMem (VariableProperty
, Property
, sizeof (*VariableProperty
));
1044 for ( Link
= GetFirstNode (&mLockedVariableList
)
1045 ; !IsNull (&mLockedVariableList
, Link
)
1046 ; Link
= GetNextNode (&mLockedVariableList
, Link
)
1048 Entry
= BASE_CR (Link
, VARIABLE_ENTRY
, Link
);
1049 VariableName
= (CHAR16
*) ((UINTN
) Entry
+ sizeof (*Entry
));
1050 if (CompareGuid (&Entry
->Guid
, Guid
) && (StrCmp (VariableName
, Name
) == 0)) {
1051 VariableProperty
->Property
|= VAR_CHECK_VARIABLE_PROPERTY_READ_ONLY
;
1053 VariableProperty
->Revision
= VAR_CHECK_VARIABLE_PROPERTY_REVISION
;
1059 ReleaseLockOnlyAtBootTime (&mVariableModuleGlobal
->VariableGlobal
.VariableServicesLock
);
1061 return (Found
? EFI_SUCCESS
: EFI_NOT_FOUND
);