3 Copyright (c) 2006, Intel Corporation
4 All rights reserved. This program and the accompanying materials
5 are licensed and made available under the terms and conditions of the BSD License
6 which accompanies this distribution. The full text of the license may be found at
7 http://opensource.org/licenses/bsd-license.php
9 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
10 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
26 // Don't use module globals after the SetVirtualAddress map is signaled
28 ESAL_VARIABLE_GLOBAL
*mVariableModuleGlobal
;
39 Determine the length of null terminated char16 array.
43 String Null-terminated CHAR16 array pointer.
47 UINT32 Number of bytes in the string, including the double NULL at the end;
59 while (0 != String
[Count
]) {
63 return (Count
* 2) + 2;
68 IsValidVariableHeader (
69 IN VARIABLE_HEADER
*Variable
75 This code checks if variable header is valid or not.
78 Variable Pointer to the Variable Header.
81 TRUE Variable header is valid.
82 FALSE Variable header is not valid.
86 if (Variable
== NULL
||
87 Variable
->StartId
!= VARIABLE_DATA
||
88 (sizeof (VARIABLE_HEADER
) + Variable
->NameSize
+ Variable
->DataSize
) > MAX_VARIABLE_SIZE
99 IN VARIABLE_GLOBAL
*Global
,
101 IN BOOLEAN SetByIndex
,
103 IN UINTN DataPtrIndex
,
111 This function writes data to the FWH at the correct LBA even if the LBAs
116 Global Pointer to VARAIBLE_GLOBAL structure
117 Volatile If the Variable is Volatile or Non-Volatile
118 SetByIndex TRUE: Target pointer is given as index
119 FALSE: Target pointer is absolute
120 Instance Instance of FV Block services
121 DataPtrIndex Pointer to the Data from the end of VARIABLE_STORE_HEADER
123 DataSize Size of data to be written.
124 Buffer Pointer to the buffer from which data is written
132 EFI_FV_BLOCK_MAP_ENTRY
*PtrBlockMapEntry
;
140 EFI_FIRMWARE_VOLUME_HEADER
*FwVolHeader
;
141 VARIABLE_STORE_HEADER
*VolatileBase
;
142 EFI_PHYSICAL_ADDRESS FvVolHdr
;
143 EFI_PHYSICAL_ADDRESS DataPtr
;
147 DataPtr
= DataPtrIndex
;
150 // Check if the Data is Volatile
153 EfiFvbGetPhysicalAddress (Instance
, &FvVolHdr
);
154 FwVolHeader
= (EFI_FIRMWARE_VOLUME_HEADER
*) ((UINTN
) FvVolHdr
);
156 // Data Pointer should point to the actual Address where data is to be
160 DataPtr
+= Global
->NonVolatileVariableBase
;
163 if ((DataPtr
+ DataSize
) >= ((EFI_PHYSICAL_ADDRESS
) (UINTN
) ((UINT8
*) FwVolHeader
+ FwVolHeader
->FvLength
))) {
164 return EFI_INVALID_PARAMETER
;
168 // Data Pointer should point to the actual Address where data is to be
171 VolatileBase
= (VARIABLE_STORE_HEADER
*) ((UINTN
) Global
->VolatileVariableBase
);
173 DataPtr
+= Global
->VolatileVariableBase
;
176 if ((DataPtr
+ DataSize
) >= ((UINTN
) ((UINT8
*) VolatileBase
+ VolatileBase
->Size
))) {
177 return EFI_INVALID_PARAMETER
;
181 // If Volatile Variable just do a simple mem copy.
184 CopyMem ((UINT8
*) ((UINTN
) DataPtr
), Buffer
, DataSize
);
188 // If we are here we are dealing with Non-Volatile Variables
190 LinearOffset
= (UINTN
) FwVolHeader
;
191 CurrWritePtr
= (UINTN
) DataPtr
;
192 CurrWriteSize
= DataSize
;
196 if (CurrWritePtr
< LinearOffset
) {
197 return EFI_INVALID_PARAMETER
;
200 for (PtrBlockMapEntry
= FwVolHeader
->FvBlockMap
; PtrBlockMapEntry
->NumBlocks
!= 0; PtrBlockMapEntry
++) {
201 for (BlockIndex2
= 0; BlockIndex2
< PtrBlockMapEntry
->NumBlocks
; BlockIndex2
++) {
203 // Check to see if the Variable Writes are spanning through multiple
206 if ((CurrWritePtr
>= LinearOffset
) && (CurrWritePtr
< LinearOffset
+ PtrBlockMapEntry
->BlockLength
)) {
207 if ((CurrWritePtr
+ CurrWriteSize
) <= (LinearOffset
+ PtrBlockMapEntry
->BlockLength
)) {
208 Status
= EfiFvbWriteBlock (
211 (UINTN
) (CurrWritePtr
- LinearOffset
),
215 if (EFI_ERROR (Status
)) {
219 Size
= (UINT32
) (LinearOffset
+ PtrBlockMapEntry
->BlockLength
- CurrWritePtr
);
220 Status
= EfiFvbWriteBlock (
223 (UINTN
) (CurrWritePtr
- LinearOffset
),
227 if (EFI_ERROR (Status
)) {
231 CurrWritePtr
= LinearOffset
+ PtrBlockMapEntry
->BlockLength
;
232 CurrBuffer
= CurrBuffer
+ Size
;
233 CurrWriteSize
= CurrWriteSize
- Size
;
237 LinearOffset
+= PtrBlockMapEntry
->BlockLength
;
245 VARIABLE_STORE_STATUS
247 GetVariableStoreStatus (
248 IN VARIABLE_STORE_HEADER
*VarStoreHeader
254 This code gets the current status of Variable Store.
258 VarStoreHeader Pointer to the Variable Store Header.
262 EfiRaw Variable store status is raw
263 EfiValid Variable store status is valid
264 EfiInvalid Variable store status is invalid
268 if (VarStoreHeader
->Signature
== VARIABLE_STORE_SIGNATURE
&&
269 VarStoreHeader
->Format
== VARIABLE_STORE_FORMATTED
&&
270 VarStoreHeader
->State
== VARIABLE_STORE_HEALTHY
274 } else if (VarStoreHeader
->Signature
== 0xffffffff &&
275 VarStoreHeader
->Size
== 0xffffffff &&
276 VarStoreHeader
->Format
== 0xff &&
277 VarStoreHeader
->State
== 0xff
289 IN VARIABLE_HEADER
*Variable
295 This code gets the pointer to the variable data.
299 Variable Pointer to the Variable Header.
303 UINT8* Pointer to Variable Data
308 // Be careful about pad size for alignment
310 return (UINT8
*) ((UINTN
) GET_VARIABLE_NAME_PTR (Variable
) + Variable
->NameSize
+ GET_PAD_SIZE (Variable
->NameSize
));
316 IN VARIABLE_HEADER
*Variable
322 This code gets the pointer to the next variable header.
326 Variable Pointer to the Variable Header.
330 VARIABLE_HEADER* Pointer to next variable header.
334 if (!IsValidVariableHeader (Variable
)) {
338 // Be careful about pad size for alignment
340 return (VARIABLE_HEADER
*) ((UINTN
) GetVariableDataPtr (Variable
) + Variable
->DataSize
+ GET_PAD_SIZE (Variable
->DataSize
));
346 IN VARIABLE_STORE_HEADER
*VarStoreHeader
352 This code gets the pointer to the last variable memory pointer byte
356 VarStoreHeader Pointer to the Variable Store Header.
360 VARIABLE_HEADER* Pointer to last unavailable Variable Header
365 // The end of variable store
367 return (VARIABLE_HEADER
*) ((UINTN
) VarStoreHeader
+ VarStoreHeader
->Size
);
373 IN EFI_PHYSICAL_ADDRESS VariableBase
,
374 OUT UINTN
*LastVariableOffset
,
375 IN BOOLEAN IsVolatile
381 Variable store garbage collection and reclaim operation
385 VariableBase Base address of variable store
386 LastVariableOffset Offset of last variable
387 IsVolatile The variable store is volatile or not,
388 if it is non-volatile, need FTW
396 VARIABLE_HEADER
*Variable
;
397 VARIABLE_HEADER
*NextVariable
;
398 VARIABLE_STORE_HEADER
*VariableStoreHeader
;
400 UINTN ValidBufferSize
;
405 VariableStoreHeader
= (VARIABLE_STORE_HEADER
*) ((UINTN
) VariableBase
);
408 // Start Pointers for the variable.
410 Variable
= (VARIABLE_HEADER
*) (VariableStoreHeader
+ 1);
412 ValidBufferSize
= sizeof (VARIABLE_STORE_HEADER
);
414 while (IsValidVariableHeader (Variable
)) {
415 NextVariable
= GetNextVariablePtr (Variable
);
416 if (Variable
->State
== VAR_ADDED
) {
417 VariableSize
= (UINTN
) NextVariable
- (UINTN
) Variable
;
418 ValidBufferSize
+= VariableSize
;
421 Variable
= NextVariable
;
424 Status
= gBS
->AllocatePool (
427 (VOID
**) &ValidBuffer
429 if (EFI_ERROR (Status
)) {
433 SetMem (ValidBuffer
, ValidBufferSize
, 0xff);
435 CurrPtr
= ValidBuffer
;
438 // Copy variable store header
440 CopyMem (CurrPtr
, VariableStoreHeader
, sizeof (VARIABLE_STORE_HEADER
));
441 CurrPtr
+= sizeof (VARIABLE_STORE_HEADER
);
444 // Start Pointers for the variable.
446 Variable
= (VARIABLE_HEADER
*) (VariableStoreHeader
+ 1);
448 while (IsValidVariableHeader (Variable
)) {
449 NextVariable
= GetNextVariablePtr (Variable
);
450 if (Variable
->State
== VAR_ADDED
) {
451 VariableSize
= (UINTN
) NextVariable
- (UINTN
) Variable
;
452 CopyMem (CurrPtr
, (UINT8
*) Variable
, VariableSize
);
453 CurrPtr
+= VariableSize
;
456 Variable
= NextVariable
;
461 // If volatile variable store, just copy valid buffer
463 SetMem ((UINT8
*) (UINTN
) VariableBase
, VariableStoreHeader
->Size
, 0xff);
464 CopyMem ((UINT8
*) (UINTN
) VariableBase
, ValidBuffer
, ValidBufferSize
);
465 *LastVariableOffset
= ValidBufferSize
;
466 Status
= EFI_SUCCESS
;
469 // If non-volatile variable store, perform FTW here.
471 Status
= FtwVariableSpace (
476 if (!EFI_ERROR (Status
)) {
477 *LastVariableOffset
= ValidBufferSize
;
481 gBS
->FreePool (ValidBuffer
);
483 if (EFI_ERROR (Status
)) {
484 *LastVariableOffset
= 0;
493 IN CHAR16
*VariableName
,
494 IN EFI_GUID
*VendorGuid
,
495 OUT VARIABLE_POINTER_TRACK
*PtrTrack
,
496 IN VARIABLE_GLOBAL
*Global
502 This code finds variable in storage blocks (Volatile or Non-Volatile)
506 VariableName Name of the variable to be found
507 VendorGuid Vendor GUID to be found.
508 PtrTrack Variable Track Pointer structure that contains
509 Variable Information.
510 Contains the pointer of Variable header.
511 Global VARIABLE_GLOBAL pointer
519 VARIABLE_HEADER
*Variable
[2];
520 VARIABLE_STORE_HEADER
*VariableStoreHeader
[2];
524 // 0: Non-Volatile, 1: Volatile
526 VariableStoreHeader
[0] = (VARIABLE_STORE_HEADER
*) ((UINTN
) Global
->NonVolatileVariableBase
);
527 VariableStoreHeader
[1] = (VARIABLE_STORE_HEADER
*) ((UINTN
) Global
->VolatileVariableBase
);
530 // Start Pointers for the variable.
531 // Actual Data Pointer where data can be written.
533 Variable
[0] = (VARIABLE_HEADER
*) (VariableStoreHeader
[0] + 1);
534 Variable
[1] = (VARIABLE_HEADER
*) (VariableStoreHeader
[1] + 1);
536 if (VariableName
[0] != 0 && VendorGuid
== NULL
) {
537 return EFI_INVALID_PARAMETER
;
540 // Find the variable by walk through non-volatile and volatile variable store
542 for (Index
= 0; Index
< 2; Index
++) {
543 PtrTrack
->StartPtr
= (VARIABLE_HEADER
*) (VariableStoreHeader
[Index
] + 1);
544 PtrTrack
->EndPtr
= GetEndPointer (VariableStoreHeader
[Index
]);
546 while (IsValidVariableHeader (Variable
[Index
]) && (Variable
[Index
] <= GetEndPointer (VariableStoreHeader
[Index
]))) {
547 if (Variable
[Index
]->State
== VAR_ADDED
) {
548 if (!(EfiAtRuntime () && !(Variable
[Index
]->Attributes
& EFI_VARIABLE_RUNTIME_ACCESS
))) {
549 if (VariableName
[0] == 0) {
550 PtrTrack
->CurrPtr
= Variable
[Index
];
551 PtrTrack
->Volatile
= (BOOLEAN
) Index
;
554 if (CompareGuid (VendorGuid
, &Variable
[Index
]->VendorGuid
)) {
555 if (!CompareMem (VariableName
, GET_VARIABLE_NAME_PTR (Variable
[Index
]), ArrayLength (VariableName
))) {
556 PtrTrack
->CurrPtr
= Variable
[Index
];
557 PtrTrack
->Volatile
= (BOOLEAN
) Index
;
565 Variable
[Index
] = GetNextVariablePtr (Variable
[Index
]);
574 PtrTrack
->CurrPtr
= NULL
;
575 return EFI_NOT_FOUND
;
581 IN CHAR16
*VariableName
,
582 IN EFI_GUID
* VendorGuid
,
583 OUT UINT32
*Attributes OPTIONAL
,
584 IN OUT UINTN
*DataSize
,
586 IN VARIABLE_GLOBAL
* Global
,
593 This code finds variable in storage blocks (Volatile or Non-Volatile)
597 VariableName Name of Variable to be found
598 VendorGuid Variable vendor GUID
599 Attributes OPTIONAL Attribute value of the variable found
600 DataSize Size of Data found. If size is less than the
601 data, this value contains the required size.
603 Global Pointer to VARIABLE_GLOBAL structure
604 Instance Instance of the Firmware Volume.
612 VARIABLE_POINTER_TRACK Variable
;
616 if (VariableName
== NULL
|| VendorGuid
== NULL
|| DataSize
== NULL
) {
617 return EFI_INVALID_PARAMETER
;
620 // Find existing variable
622 Status
= FindVariable (VariableName
, VendorGuid
, &Variable
, Global
);
624 if (Variable
.CurrPtr
== NULL
|| EFI_ERROR (Status
)) {
630 VarDataSize
= Variable
.CurrPtr
->DataSize
;
631 if (*DataSize
>= VarDataSize
) {
633 return EFI_INVALID_PARAMETER
;
636 CopyMem (Data
, GetVariableDataPtr (Variable
.CurrPtr
), VarDataSize
);
637 if (Attributes
!= NULL
) {
638 *Attributes
= Variable
.CurrPtr
->Attributes
;
641 *DataSize
= VarDataSize
;
644 *DataSize
= VarDataSize
;
645 return EFI_BUFFER_TOO_SMALL
;
651 GetNextVariableName (
652 IN OUT UINTN
*VariableNameSize
,
653 IN OUT CHAR16
*VariableName
,
654 IN OUT EFI_GUID
*VendorGuid
,
655 IN VARIABLE_GLOBAL
*Global
,
662 This code Finds the Next available variable
666 VariableNameSize Size of the variable
667 VariableName Pointer to variable name
668 VendorGuid Variable Vendor Guid
669 Global VARIABLE_GLOBAL structure pointer.
678 VARIABLE_POINTER_TRACK Variable
;
682 if (VariableNameSize
== NULL
|| VariableName
== NULL
|| VendorGuid
== NULL
) {
683 return EFI_INVALID_PARAMETER
;
686 Status
= FindVariable (VariableName
, VendorGuid
, &Variable
, Global
);
688 if (Variable
.CurrPtr
== NULL
|| EFI_ERROR (Status
)) {
692 if (VariableName
[0] != 0) {
694 // If variable name is not NULL, get next variable
696 Variable
.CurrPtr
= GetNextVariablePtr (Variable
.CurrPtr
);
701 // If both volatile and non-volatile variable store are parsed,
704 if (Variable
.CurrPtr
>= Variable
.EndPtr
|| Variable
.CurrPtr
== NULL
) {
705 Variable
.Volatile
= (BOOLEAN
) (Variable
.Volatile
^ ((BOOLEAN
) 0x1));
706 if (Variable
.Volatile
) {
707 Variable
.StartPtr
= (VARIABLE_HEADER
*) ((UINTN
) (Global
->VolatileVariableBase
+ sizeof (VARIABLE_STORE_HEADER
)));
708 Variable
.EndPtr
= (VARIABLE_HEADER
*) GetEndPointer ((VARIABLE_STORE_HEADER
*) ((UINTN
) Global
->VolatileVariableBase
));
710 return EFI_NOT_FOUND
;
713 Variable
.CurrPtr
= Variable
.StartPtr
;
714 if (!IsValidVariableHeader (Variable
.CurrPtr
)) {
721 if (IsValidVariableHeader (Variable
.CurrPtr
) && Variable
.CurrPtr
->State
== VAR_ADDED
) {
722 if (!(EfiAtRuntime () && !(Variable
.CurrPtr
->Attributes
& EFI_VARIABLE_RUNTIME_ACCESS
))) {
723 VarNameSize
= Variable
.CurrPtr
->NameSize
;
724 if (VarNameSize
<= *VariableNameSize
) {
727 GET_VARIABLE_NAME_PTR (Variable
.CurrPtr
),
732 &Variable
.CurrPtr
->VendorGuid
,
735 Status
= EFI_SUCCESS
;
737 Status
= EFI_BUFFER_TOO_SMALL
;
740 *VariableNameSize
= VarNameSize
;
745 Variable
.CurrPtr
= GetNextVariablePtr (Variable
.CurrPtr
);
748 return EFI_NOT_FOUND
;
754 IN CHAR16
*VariableName
,
755 IN EFI_GUID
*VendorGuid
,
756 IN UINT32 Attributes
,
759 IN VARIABLE_GLOBAL
*Global
,
760 IN UINTN
*VolatileOffset
,
761 IN UINTN
*NonVolatileOffset
,
768 This code sets variable in storage blocks (Volatile or Non-Volatile)
772 VariableName Name of Variable to be found
773 VendorGuid Variable vendor GUID
774 Attributes Attribute value of the variable found
775 DataSize Size of Data found. If size is less than the
776 data, this value contains the required size.
778 Global Pointer to VARIABLE_GLOBAL structure
779 VolatileOffset The offset of last volatile variable
780 NonVolatileOffset The offset of last non-volatile variable
781 Instance Instance of the Firmware Volume.
786 EFI_INVALID_PARAMETER - Invalid parameter
787 EFI_SUCCESS - Set successfully
788 EFI_OUT_OF_RESOURCES - Resource not enough to set variable
789 EFI_NOT_FOUND - Not found
793 VARIABLE_POINTER_TRACK Variable
;
795 VARIABLE_HEADER
*NextVariable
;
805 if (VariableName
== NULL
|| VariableName
[0] == 0 || VendorGuid
== NULL
) {
806 return EFI_INVALID_PARAMETER
;
809 Status
= FindVariable (VariableName
, VendorGuid
, &Variable
, Global
);
811 if (Status
== EFI_INVALID_PARAMETER
) {
815 // The size of the VariableName, including the Unicode Null in bytes plus
816 // the DataSize is limited to maximum size of MAX_VARIABLE_SIZE (1024) bytes.
818 else if (sizeof (VARIABLE_HEADER
) + ArrayLength (VariableName
) + DataSize
> MAX_VARIABLE_SIZE
) {
819 return EFI_INVALID_PARAMETER
;
822 // Make sure if runtime bit is set, boot service bit is set also
824 else if ((Attributes
& (EFI_VARIABLE_RUNTIME_ACCESS
| EFI_VARIABLE_BOOTSERVICE_ACCESS
)) == EFI_VARIABLE_RUNTIME_ACCESS
826 return EFI_INVALID_PARAMETER
;
829 // Runtime but Attribute is not Runtime
831 else if (EfiAtRuntime () && Attributes
&& !(Attributes
& EFI_VARIABLE_RUNTIME_ACCESS
)) {
832 return EFI_INVALID_PARAMETER
;
835 // Cannot set volatile variable in Runtime
837 else if (EfiAtRuntime () && Attributes
&& !(Attributes
& EFI_VARIABLE_NON_VOLATILE
)) {
838 return EFI_INVALID_PARAMETER
;
841 // Setting a data variable with no access, or zero DataSize attributes
842 // specified causes it to be deleted.
844 else if (DataSize
== 0 || Attributes
== 0) {
845 if (!EFI_ERROR (Status
)) {
846 State
= Variable
.CurrPtr
->State
;
847 State
&= VAR_DELETED
;
849 Status
= UpdateVariableStore (
854 (UINTN
) &Variable
.CurrPtr
->State
,
858 if (EFI_ERROR (Status
)) {
865 return EFI_NOT_FOUND
;
867 if (!EFI_ERROR (Status
)) {
869 // If the variable is marked valid and the same data has been passed in
870 // then return to the caller immediately.
872 if (Variable
.CurrPtr
->DataSize
== DataSize
&&
873 !CompareMem (Data
, GetVariableDataPtr (Variable
.CurrPtr
), DataSize
)
876 } else if (Variable
.CurrPtr
->State
== VAR_ADDED
) {
878 // Mark the old variable as in delete transition
880 State
= Variable
.CurrPtr
->State
;
881 State
&= VAR_IN_DELETED_TRANSITION
;
883 Status
= UpdateVariableStore (
888 (UINTN
) &Variable
.CurrPtr
->State
,
892 if (EFI_ERROR (Status
)) {
898 // Create a new variable and copy the data.
900 // Tricky part: Use scratch data area at the end of volatile variable store
901 // as a temporary storage.
903 NextVariable
= GetEndPointer ((VARIABLE_STORE_HEADER
*) ((UINTN
) Global
->VolatileVariableBase
));
905 SetMem (NextVariable
, SCRATCH_SIZE
, 0xff);
907 NextVariable
->StartId
= VARIABLE_DATA
;
908 NextVariable
->Attributes
= Attributes
;
910 // NextVariable->State = VAR_ADDED;
912 NextVariable
->Reserved
= 0;
913 VarNameOffset
= sizeof (VARIABLE_HEADER
);
914 VarNameSize
= ArrayLength (VariableName
);
916 (UINT8
*) ((UINTN
) NextVariable
+ VarNameOffset
),
920 VarDataOffset
= VarNameOffset
+ VarNameSize
+ GET_PAD_SIZE (VarNameSize
);
922 (UINT8
*) ((UINTN
) NextVariable
+ VarDataOffset
),
926 CopyMem (&NextVariable
->VendorGuid
, VendorGuid
, sizeof (EFI_GUID
));
928 // There will be pad bytes after Data, the NextVariable->NameSize and
929 // NextVariable->DataSize should not include pad size so that variable
930 // service can get actual size in GetVariable
932 NextVariable
->NameSize
= (UINT32
)VarNameSize
;
933 NextVariable
->DataSize
= (UINT32
)DataSize
;
936 // The actual size of the variable that stores in storage should
939 VarSize
= VarDataOffset
+ DataSize
+ GET_PAD_SIZE (DataSize
);
940 if (Attributes
& EFI_VARIABLE_NON_VOLATILE
) {
941 if ((UINT32
) (VarSize
+*NonVolatileOffset
) >
942 ((VARIABLE_STORE_HEADER
*) ((UINTN
) (Global
->NonVolatileVariableBase
)))->Size
944 if (EfiAtRuntime ()) {
945 return EFI_OUT_OF_RESOURCES
;
948 // Perform garbage collection & reclaim operation
950 Status
= Reclaim (Global
->NonVolatileVariableBase
, NonVolatileOffset
, FALSE
);
951 if (EFI_ERROR (Status
)) {
955 // If still no enough space, return out of resources
957 if ((UINT32
) (VarSize
+*NonVolatileOffset
) >
958 ((VARIABLE_STORE_HEADER
*) ((UINTN
) (Global
->NonVolatileVariableBase
)))->Size
960 return EFI_OUT_OF_RESOURCES
;
967 // 1. Write variable header
968 // 2. Write variable data
969 // 3. Set variable state to valid
974 Status
= UpdateVariableStore (
980 sizeof (VARIABLE_HEADER
),
981 (UINT8
*) NextVariable
984 if (EFI_ERROR (Status
)) {
990 Status
= UpdateVariableStore (
995 *NonVolatileOffset
+ sizeof (VARIABLE_HEADER
),
996 (UINT32
) VarSize
- sizeof (VARIABLE_HEADER
),
997 (UINT8
*) NextVariable
+ sizeof (VARIABLE_HEADER
)
1000 if (EFI_ERROR (Status
)) {
1006 NextVariable
->State
= VAR_ADDED
;
1007 Status
= UpdateVariableStore (
1013 sizeof (VARIABLE_HEADER
),
1014 (UINT8
*) NextVariable
1017 if (EFI_ERROR (Status
)) {
1021 *NonVolatileOffset
= *NonVolatileOffset
+ VarSize
;
1024 if (EfiAtRuntime ()) {
1025 return EFI_INVALID_PARAMETER
;
1028 if ((UINT32
) (VarSize
+*VolatileOffset
) >
1029 ((VARIABLE_STORE_HEADER
*) ((UINTN
) (Global
->VolatileVariableBase
)))->Size
1032 // Perform garbage collection & reclaim operation
1034 Status
= Reclaim (Global
->VolatileVariableBase
, VolatileOffset
, TRUE
);
1035 if (EFI_ERROR (Status
)) {
1039 // If still no enough space, return out of resources
1041 if ((UINT32
) (VarSize
+*VolatileOffset
) >
1042 ((VARIABLE_STORE_HEADER
*) ((UINTN
) (Global
->VolatileVariableBase
)))->Size
1044 return EFI_OUT_OF_RESOURCES
;
1050 NextVariable
->State
= VAR_ADDED
;
1051 Status
= UpdateVariableStore (
1058 (UINT8
*) NextVariable
1061 if (EFI_ERROR (Status
)) {
1065 *VolatileOffset
= *VolatileOffset
+ VarSize
;
1068 // Mark the old variable as deleted
1070 if (!Reclaimed
&& !EFI_ERROR (Status
) && Variable
.CurrPtr
!= NULL
) {
1071 State
= Variable
.CurrPtr
->State
;
1072 State
&= VAR_DELETED
;
1074 Status
= UpdateVariableStore (
1079 (UINTN
) &Variable
.CurrPtr
->State
,
1084 if (EFI_ERROR (Status
)) {
1095 VariableCommonInitialize (
1096 IN EFI_HANDLE ImageHandle
,
1097 IN EFI_SYSTEM_TABLE
*SystemTable
1101 Routine Description:
1102 This function does common initialization for variable services
1106 ImageHandle - The firmware allocated handle for the EFI image.
1107 SystemTable - A pointer to the EFI System Table.
1113 EFI_NOT_FOUND - Variable store area not found.
1114 EFI_UNSUPPORTED - Currently only one non-volatile variable store is supported.
1115 EFI_SUCCESS - Variable services successfully initialized.
1120 EFI_FIRMWARE_VOLUME_HEADER
*FwVolHeader
;
1122 VARIABLE_STORE_HEADER
*VolatileVariableStore
;
1123 VARIABLE_STORE_HEADER
*VariableStoreHeader
;
1124 VARIABLE_HEADER
*NextVariable
;
1126 EFI_PHYSICAL_ADDRESS FvVolHdr
;
1128 EFI_FLASH_MAP_ENTRY_DATA
*FlashMapEntryData
;
1129 EFI_GCD_MEMORY_SPACE_DESCRIPTOR GcdDescriptor
;
1130 EFI_FLASH_SUBAREA_ENTRY VariableStoreEntry
;
1135 EFI_PEI_HOB_POINTERS GuidHob
;
1137 Status
= gBS
->AllocatePool (
1138 EfiRuntimeServicesData
,
1139 sizeof (ESAL_VARIABLE_GLOBAL
),
1140 (VOID
**) &mVariableModuleGlobal
1143 if (EFI_ERROR (Status
)) {
1147 // Allocate memory for volatile variable store
1149 Status
= gBS
->AllocatePool (
1150 EfiRuntimeServicesData
,
1151 VARIABLE_STORE_SIZE
+ SCRATCH_SIZE
,
1152 (VOID
**) &VolatileVariableStore
1155 if (EFI_ERROR (Status
)) {
1156 gBS
->FreePool (mVariableModuleGlobal
);
1160 SetMem (VolatileVariableStore
, VARIABLE_STORE_SIZE
+ SCRATCH_SIZE
, 0xff);
1163 // Variable Specific Data
1165 mVariableModuleGlobal
->VariableBase
[Physical
].VolatileVariableBase
= (EFI_PHYSICAL_ADDRESS
) (UINTN
) VolatileVariableStore
;
1166 mVariableModuleGlobal
->VolatileLastVariableOffset
= sizeof (VARIABLE_STORE_HEADER
);
1168 VolatileVariableStore
->Signature
= VARIABLE_STORE_SIGNATURE
;
1169 VolatileVariableStore
->Size
= VARIABLE_STORE_SIZE
;
1170 VolatileVariableStore
->Format
= VARIABLE_STORE_FORMATTED
;
1171 VolatileVariableStore
->State
= VARIABLE_STORE_HEALTHY
;
1172 VolatileVariableStore
->Reserved
= 0;
1173 VolatileVariableStore
->Reserved1
= 0;
1176 // Get non volatile varaible store
1179 FlashMapEntryData
= NULL
;
1181 GuidHob
.Raw
= GetHobList ();
1182 while (NULL
!= (GuidHob
.Raw
= GetNextGuidHob (&gEfiFlashMapHobGuid
, GuidHob
.Raw
))) {
1183 FlashMapEntryData
= (EFI_FLASH_MAP_ENTRY_DATA
*) GET_GUID_HOB_DATA (GuidHob
.Guid
);
1185 if (FlashMapEntryData
->AreaType
== EFI_FLASH_AREA_EFI_VARIABLES
) {
1188 GuidHob
.Raw
= GET_NEXT_HOB (GuidHob
);
1191 if (NULL
== GuidHob
.Raw
|| FlashMapEntryData
== NULL
) {
1192 gBS
->FreePool (mVariableModuleGlobal
);
1193 gBS
->FreePool (VolatileVariableStore
);
1194 return EFI_NOT_FOUND
;
1198 // Currently only one non-volatile variable store is supported
1200 if (FlashMapEntryData
->NumEntries
!= 1) {
1201 gBS
->FreePool (mVariableModuleGlobal
);
1202 gBS
->FreePool (VolatileVariableStore
);
1203 return EFI_UNSUPPORTED
;
1206 CopyMem (&VariableStoreEntry
, &FlashMapEntryData
->Entries
[0], sizeof (VariableStoreEntry
));
1209 // Mark the variable storage region of the FLASH as RUNTIME
1211 BaseAddress
= VariableStoreEntry
.Base
& (~EFI_PAGE_MASK
);
1212 Length
= VariableStoreEntry
.Length
+ (VariableStoreEntry
.Base
- BaseAddress
);
1213 Length
= (Length
+ EFI_PAGE_SIZE
- 1) & (~EFI_PAGE_MASK
);
1215 Status
= gDS
->GetMemorySpaceDescriptor (BaseAddress
, &GcdDescriptor
);
1216 if (EFI_ERROR (Status
)) {
1217 gBS
->FreePool (mVariableModuleGlobal
);
1218 gBS
->FreePool (VolatileVariableStore
);
1219 return EFI_UNSUPPORTED
;
1222 Status
= gDS
->SetMemorySpaceAttributes (
1225 GcdDescriptor
.Attributes
| EFI_MEMORY_RUNTIME
1227 if (EFI_ERROR (Status
)) {
1228 gBS
->FreePool (mVariableModuleGlobal
);
1229 gBS
->FreePool (VolatileVariableStore
);
1230 return EFI_UNSUPPORTED
;
1233 // Get address of non volatile variable store base
1235 mVariableModuleGlobal
->VariableBase
[Physical
].NonVolatileVariableBase
= VariableStoreEntry
.Base
;
1241 // Find the Correct Instance of the FV Block Service.
1244 CurrPtr
= (CHAR8
*) ((UINTN
) mVariableModuleGlobal
->VariableBase
[Physical
].NonVolatileVariableBase
);
1245 while (EfiFvbGetPhysicalAddress (Instance
, &FvVolHdr
) == EFI_SUCCESS
) {
1246 FwVolHeader
= (EFI_FIRMWARE_VOLUME_HEADER
*) ((UINTN
) FvVolHdr
);
1247 if (CurrPtr
>= (CHAR8
*) FwVolHeader
&& CurrPtr
< (((CHAR8
*) FwVolHeader
) + FwVolHeader
->FvLength
)) {
1248 mVariableModuleGlobal
->FvbInstance
= Instance
;
1255 VariableStoreHeader
= (VARIABLE_STORE_HEADER
*) CurrPtr
;
1256 if (GetVariableStoreStatus (VariableStoreHeader
) == EfiValid
) {
1257 if (~VariableStoreHeader
->Size
== 0) {
1258 Status
= UpdateVariableStore (
1259 &mVariableModuleGlobal
->VariableBase
[Physical
],
1262 mVariableModuleGlobal
->FvbInstance
,
1263 (UINTN
) &VariableStoreHeader
->Size
,
1265 (UINT8
*) &VariableStoreEntry
.Length
1268 if (EFI_ERROR (Status
)) {
1273 mVariableModuleGlobal
->VariableBase
[Physical
].NonVolatileVariableBase
= (EFI_PHYSICAL_ADDRESS
) ((UINTN
) CurrPtr
);
1275 // Parse non-volatile variable data and get last variable offset
1277 NextVariable
= (VARIABLE_HEADER
*) (CurrPtr
+ sizeof (VARIABLE_STORE_HEADER
));
1278 Status
= EFI_SUCCESS
;
1280 while (IsValidVariableHeader (NextVariable
)) {
1281 NextVariable
= GetNextVariablePtr (NextVariable
);
1284 mVariableModuleGlobal
->NonVolatileLastVariableOffset
= (UINTN
) NextVariable
- (UINTN
) CurrPtr
;
1287 // Check if the free area is really free.
1289 for (Index
= mVariableModuleGlobal
->NonVolatileLastVariableOffset
; Index
< VariableStoreHeader
->Size
; Index
++) {
1290 Data
= ((UINT8
*) (UINTN
) mVariableModuleGlobal
->VariableBase
[Physical
].NonVolatileVariableBase
)[Index
];
1293 // There must be something wrong in variable store, do reclaim operation.
1296 mVariableModuleGlobal
->VariableBase
[Physical
].NonVolatileVariableBase
,
1297 &mVariableModuleGlobal
->NonVolatileLastVariableOffset
,
1305 if (EFI_ERROR (Status
)) {
1306 gBS
->FreePool (mVariableModuleGlobal
);
1307 gBS
->FreePool (VolatileVariableStore
);