7ff7768d |
1 | /*++\r |
2 | \r |
3 | Copyright (c) 2006 - 2007, Intel Corporation\r |
4 | All rights reserved. This program and the accompanying materials\r |
5 | are licensed and made available under the terms and conditions of the BSD License\r |
6 | which accompanies this distribution. The full text of the license may be found at\r |
7 | http://opensource.org/licenses/bsd-license.php\r |
8 | \r |
9 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r |
10 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r |
11 | \r |
12 | Module Name:\r |
13 | \r |
14 | Variable.h\r |
15 | \r |
16 | Abstract:\r |
17 | \r |
18 | Tiano PEIM to provide the variable functionality\r |
19 | \r |
20 | --*/\r |
21 | \r |
22 | #ifndef _PEI_VARIABLE_H\r |
23 | #define _PEI_VARIABLE_H\r |
24 | \r |
25 | //\r |
26 | // BugBug: We need relcate the head file.\r |
27 | //\r |
28 | #include <Common/Variable.h>\r |
29 | #include <VarMachine.h>\r |
30 | \r |
31 | //\r |
32 | // Define GET_PAD_SIZE to optimize compiler\r |
33 | //\r |
34 | #if ((ALIGNMENT == 0) || (ALIGNMENT == 1))\r |
35 | #define GET_PAD_SIZE(a) (0)\r |
36 | #else\r |
37 | #define GET_PAD_SIZE(a) (((~a) + 1) & (ALIGNMENT - 1))\r |
38 | #endif\r |
39 | \r |
40 | #define GET_VARIABLE_NAME_PTR(a) (CHAR16 *) ((UINTN) (a) + sizeof (VARIABLE_HEADER))\r |
41 | \r |
42 | #define GET_VARIABLE_DATA_PTR(a) \\r |
43 | (UINT8 *) ((UINTN) GET_VARIABLE_NAME_PTR (a) + (a)->NameSize + GET_PAD_SIZE ((a)->NameSize))\r |
44 | \r |
45 | typedef struct {\r |
46 | VARIABLE_HEADER *CurrPtr;\r |
47 | VARIABLE_HEADER *EndPtr;\r |
48 | VARIABLE_HEADER *StartPtr;\r |
49 | } VARIABLE_POINTER_TRACK;\r |
50 | \r |
51 | #define VARIABLE_INDEX_TABLE_VOLUME 122\r |
52 | \r |
53 | #define EFI_VARIABLE_INDEX_TABLE_GUID \\r |
54 | { 0x8cfdb8c8, 0xd6b2, 0x40f3, { 0x8e, 0x97, 0x02, 0x30, 0x7c, 0xc9, 0x8b, 0x7c } }\r |
55 | \r |
56 | typedef struct {\r |
57 | UINT16 Length;\r |
58 | UINT16 GoneThrough;\r |
59 | VARIABLE_HEADER *EndPtr;\r |
60 | VARIABLE_HEADER *StartPtr;\r |
61 | UINT16 Index[VARIABLE_INDEX_TABLE_VOLUME];\r |
62 | } VARIABLE_INDEX_TABLE;\r |
63 | \r |
64 | \r |
65 | //\r |
66 | // Functions\r |
67 | //\r |
68 | EFI_STATUS\r |
69 | EFIAPI\r |
70 | PeimInitializeVariableServices (\r |
71 | IN EFI_FFS_FILE_HEADER *FfsHeader,\r |
72 | IN EFI_PEI_SERVICES **PeiServices\r |
73 | )\r |
74 | /*++\r |
75 | \r |
76 | Routine Description:\r |
77 | \r |
78 | TODO: Add function description\r |
79 | \r |
80 | Arguments:\r |
81 | \r |
82 | FfsHeader - TODO: add argument description\r |
83 | PeiServices - TODO: add argument description\r |
84 | \r |
85 | Returns:\r |
86 | \r |
87 | TODO: add return values\r |
88 | \r |
89 | --*/\r |
90 | ;\r |
91 | \r |
92 | EFI_STATUS\r |
93 | EFIAPI\r |
94 | PeiGetVariable (\r |
95 | IN EFI_PEI_SERVICES **PeiServices,\r |
96 | IN CHAR16 *VariableName,\r |
97 | IN EFI_GUID * VendorGuid,\r |
98 | OUT UINT32 *Attributes OPTIONAL,\r |
99 | IN OUT UINTN *DataSize,\r |
100 | OUT VOID *Data\r |
101 | )\r |
102 | /*++\r |
103 | \r |
104 | Routine Description:\r |
105 | \r |
106 | TODO: Add function description\r |
107 | \r |
108 | Arguments:\r |
109 | \r |
110 | PeiServices - TODO: add argument description\r |
111 | VariableName - TODO: add argument description\r |
112 | VendorGuid - TODO: add argument description\r |
113 | Attributes - TODO: add argument description\r |
114 | DataSize - TODO: add argument description\r |
115 | Data - TODO: add argument description\r |
116 | \r |
117 | Returns:\r |
118 | \r |
119 | TODO: add return values\r |
120 | \r |
121 | --*/\r |
122 | ;\r |
123 | \r |
124 | EFI_STATUS\r |
125 | EFIAPI\r |
126 | PeiGetNextVariableName (\r |
127 | IN EFI_PEI_SERVICES **PeiServices,\r |
128 | IN OUT UINTN *VariableNameSize,\r |
129 | IN OUT CHAR16 *VariableName,\r |
130 | IN OUT EFI_GUID *VendorGuid\r |
131 | )\r |
132 | /*++\r |
133 | \r |
134 | Routine Description:\r |
135 | \r |
136 | TODO: Add function description\r |
137 | \r |
138 | Arguments:\r |
139 | \r |
140 | PeiServices - TODO: add argument description\r |
141 | VariableNameSize - TODO: add argument description\r |
142 | VariableName - TODO: add argument description\r |
143 | VendorGuid - TODO: add argument description\r |
144 | \r |
145 | Returns:\r |
146 | \r |
147 | TODO: add return values\r |
148 | \r |
149 | --*/\r |
150 | ;\r |
151 | \r |
152 | /**\r |
153 | Get one variable by the index count.\r |
154 | \r |
155 | @param IndexTable The pointer to variable index table.\r |
156 | @param Count The index count of variable in index table.\r |
157 | \r |
158 | @return The pointer to variable header indexed by count.\r |
159 | \r |
160 | **/\r |
161 | VARIABLE_HEADER *\r |
162 | GetVariableByIndex (\r |
163 | IN VARIABLE_INDEX_TABLE *IndexTable,\r |
164 | IN UINT32 Count\r |
165 | );\r |
166 | \r |
167 | /**\r |
168 | Record Variable in VariableIndex HOB.\r |
169 | \r |
170 | Record Variable in VariableIndex HOB and update the length of variable index table.\r |
171 | \r |
172 | @param IndexTable The pointer to variable index table.\r |
173 | @param Variable The pointer to the variable that will be recorded.\r |
174 | \r |
175 | @retval VOID\r |
176 | \r |
177 | **/\r |
178 | VOID\r |
179 | VariableIndexTableUpdate (\r |
180 | IN OUT VARIABLE_INDEX_TABLE *IndexTable,\r |
181 | IN VARIABLE_HEADER *Variable\r |
182 | );\r |
183 | \r |
184 | #endif // _PEI_VARIABLE_H\r |