projects / mirror_edk2.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
ShellPkg/HandleParsingLib: Rename global variables
[mirror_edk2.git] / ShellPkg / Library / UefiHandleParsingLib / UefiHandleParsingLib.c
CommitLineData
a405b86d 1/** @file\r
2 Provides interface to advanced shell functionality for parsing both handle and protocol database.\r
3\r
d4ec9a57 4 Copyright (c) 2010 - 2017, Intel Corporation. All rights reserved.<BR>\r
256aa6d0 5 (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>\r
8985d612 6 (C) Copyright 2015-2016 Hewlett Packard Enterprise Development LP<BR>\r
a405b86d 7 This program and the accompanying materials\r
8 are licensed and made available under the terms and conditions of the BSD License\r
9 which accompanies this distribution. The full text of the license may be found at\r
10 http://opensource.org/licenses/bsd-license.php\r
11\r
12 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
13 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
14\r
15**/\r
16\r
17#include "UefiHandleParsingLib.h"\r
f4f3c6bf 18#include "IndustryStandard/Acpi10.h"\r
a405b86d 19\r
e7e0e42b 20EFI_HANDLE mHandleParsingHiiHandle = NULL;\r
a405b86d 21HANDLE_INDEX_LIST mHandleList = {{{NULL,NULL},0,0},0};\r
d4ec9a57
RN		 22GUID_INFO_BLOCK *mGuidList;\r
23UINTN mGuidListCount;\r
efb76d1a
JC		 24/**\r
25 Function to translate the EFI_MEMORY_TYPE into a string.\r
26\r
27 @param[in] Memory The memory type.\r
28\r
29 @retval A string representation of the type allocated from BS Pool.\r
30**/\r
31CHAR16*\r
efb76d1a
JC		 32ConvertMemoryType (\r
33 IN CONST EFI_MEMORY_TYPE Memory\r
34 )\r
35{\r
36 CHAR16 *RetVal;\r
37 RetVal = NULL;\r
38\r
39 switch (Memory) {\r
40 case EfiReservedMemoryType: StrnCatGrow(&RetVal, NULL, L"EfiReservedMemoryType", 0); break;\r
41 case EfiLoaderCode: StrnCatGrow(&RetVal, NULL, L"EfiLoaderCode", 0); break;\r
42 case EfiLoaderData: StrnCatGrow(&RetVal, NULL, L"EfiLoaderData", 0); break;\r
43 case EfiBootServicesCode: StrnCatGrow(&RetVal, NULL, L"EfiBootServicesCode", 0); break;\r
44 case EfiBootServicesData: StrnCatGrow(&RetVal, NULL, L"EfiBootServicesData", 0); break;\r
45 case EfiRuntimeServicesCode: StrnCatGrow(&RetVal, NULL, L"EfiRuntimeServicesCode", 0); break;\r
46 case EfiRuntimeServicesData: StrnCatGrow(&RetVal, NULL, L"EfiRuntimeServicesData", 0); break;\r
47 case EfiConventionalMemory: StrnCatGrow(&RetVal, NULL, L"EfiConventionalMemory", 0); break;\r
48 case EfiUnusableMemory: StrnCatGrow(&RetVal, NULL, L"EfiUnusableMemory", 0); break;\r
49 case EfiACPIReclaimMemory: StrnCatGrow(&RetVal, NULL, L"EfiACPIReclaimMemory", 0); break;\r
50 case EfiACPIMemoryNVS: StrnCatGrow(&RetVal, NULL, L"EfiACPIMemoryNVS", 0); break;\r
51 case EfiMemoryMappedIO: StrnCatGrow(&RetVal, NULL, L"EfiMemoryMappedIO", 0); break;\r
52 case EfiMemoryMappedIOPortSpace: StrnCatGrow(&RetVal, NULL, L"EfiMemoryMappedIOPortSpace", 0); break;\r
53 case EfiPalCode: StrnCatGrow(&RetVal, NULL, L"EfiPalCode", 0); break;\r
54 case EfiMaxMemoryType: StrnCatGrow(&RetVal, NULL, L"EfiMaxMemoryType", 0); break;\r
55 default: ASSERT(FALSE);\r
56 }\r
57 return (RetVal);\r
58}\r
59\r
609e0c58
JC		 60/**\r
61 Function to translate the EFI_GRAPHICS_PIXEL_FORMAT into a string.\r
62\r
9145d314 63 @param[in] Fmt The format type.\r
609e0c58
JC		 64\r
65 @retval A string representation of the type allocated from BS Pool.\r
66**/\r
67CHAR16*\r
609e0c58
JC		 68ConvertPixelFormat (\r
69 IN CONST EFI_GRAPHICS_PIXEL_FORMAT Fmt\r
70 )\r
71{\r
72 CHAR16 *RetVal;\r
73 RetVal = NULL;\r
74\r
75 switch (Fmt) {\r
76 case PixelRedGreenBlueReserved8BitPerColor: StrnCatGrow(&RetVal, NULL, L"PixelRedGreenBlueReserved8BitPerColor", 0); break;\r
77 case PixelBlueGreenRedReserved8BitPerColor: StrnCatGrow(&RetVal, NULL, L"PixelBlueGreenRedReserved8BitPerColor", 0); break;\r
78 case PixelBitMask: StrnCatGrow(&RetVal, NULL, L"PixelBitMask", 0); break;\r
79 case PixelBltOnly: StrnCatGrow(&RetVal, NULL, L"PixelBltOnly", 0); break;\r
80 case PixelFormatMax: StrnCatGrow(&RetVal, NULL, L"PixelFormatMax", 0); break;\r
81 default: ASSERT(FALSE);\r
82 }\r
83 return (RetVal);\r
84}\r
85\r
a405b86d 86/**\r
87 Constructor for the library.\r
88\r
89 @param[in] ImageHandle Ignored.\r
90 @param[in] SystemTable Ignored.\r
91\r
92 @retval EFI_SUCCESS The operation was successful.\r
93**/\r
94EFI_STATUS\r
95EFIAPI\r
96HandleParsingLibConstructor (\r
97 IN EFI_HANDLE ImageHandle,\r
98 IN EFI_SYSTEM_TABLE *SystemTable\r
99 )\r
100{\r
d4ec9a57
RN		 101 mGuidListCount = 0;\r
102 mGuidList = NULL;\r
6306fd90 103\r
e7e0e42b
CP		 104 //\r
105 // Do nothing with mHandleParsingHiiHandle. Initialize HII as needed.\r
106 //\r
107 return (EFI_SUCCESS);\r
108}\r
109\r
1a6f74d9 110/**\r
e7e0e42b 111 Initialization function for HII packages.\r
1a6f74d9 112\r
e7e0e42b
CP		 113**/\r
114VOID\r
115HandleParsingHiiInit (VOID)\r
116{\r
a405b86d 117 if (mHandleParsingHiiHandle == NULL) {\r
e7e0e42b
CP		 118 mHandleParsingHiiHandle = HiiAddPackages (&gHandleParsingHiiGuid, gImageHandle, UefiHandleParsingLibStrings, NULL);\r
119 ASSERT (mHandleParsingHiiHandle != NULL);\r
a405b86d 120 }\r
a405b86d 121}\r
122\r
123/**\r
124 Destructor for the library. free any resources.\r
125\r
126 @param[in] ImageHandle Ignored.\r
127 @param[in] SystemTable Ignored.\r
128\r
129 @retval EFI_SUCCESS The operation was successful.\r
130**/\r
131EFI_STATUS\r
132EFIAPI\r
133HandleParsingLibDestructor (\r
134 IN EFI_HANDLE ImageHandle,\r
135 IN EFI_SYSTEM_TABLE *SystemTable\r
136 )\r
137{\r
6306fd90
JC		 138 UINTN LoopCount;\r
139\r
d4ec9a57
RN		 140 for (LoopCount = 0; mGuidList != NULL && LoopCount < mGuidListCount; LoopCount++) {\r
141 SHELL_FREE_NON_NULL(mGuidList[LoopCount].GuidId);\r
6306fd90
JC		 142 }\r
143\r
d4ec9a57 144 SHELL_FREE_NON_NULL(mGuidList);\r
a405b86d 145 if (mHandleParsingHiiHandle != NULL) {\r
146 HiiRemovePackages(mHandleParsingHiiHandle);\r
147 }\r
148 return (EFI_SUCCESS);\r
149}\r
150\r
efb76d1a
JC		 151/**\r
152 Function to dump information about LoadedImage.\r
153\r
154 This will allocate the return buffer from boot services pool.\r
155\r
156 @param[in] TheHandle The handle that has LoadedImage installed.\r
157 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
158\r
159 @retval A poitner to a string containing the information.\r
160**/\r
a405b86d 161CHAR16*\r
162EFIAPI\r
163LoadedImageProtocolDumpInformation(\r
164 IN CONST EFI_HANDLE TheHandle,\r
165 IN CONST BOOLEAN Verbose\r
166 )\r
167{\r
efb76d1a 168 EFI_LOADED_IMAGE_PROTOCOL *LoadedImage;\r
a405b86d 169 EFI_STATUS Status;\r
efb76d1a
JC		 170 CHAR16 *RetVal;\r
171 CHAR16 *Temp;\r
172 CHAR16 *CodeType;\r
173 CHAR16 *DataType;\r
a405b86d 174\r
efb76d1a
JC		 175 if (!Verbose) {\r
176 return (CatSPrint(NULL, L"LoadedImage"));\r
a405b86d 177 }\r
178\r
e7e0e42b
CP		 179 HandleParsingHiiInit();\r
180\r
efb76d1a 181 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_LI_DUMP_MAIN), NULL);\r
1a6f74d9 182 if (Temp == NULL) {\r
efb76d1a 183 return NULL;\r
a405b86d 184 }\r
185\r
efb76d1a
JC		 186 Status = gBS->OpenProtocol (\r
187 TheHandle,\r
188 &gEfiLoadedImageProtocolGuid,\r
189 (VOID**)&LoadedImage,\r
190 gImageHandle,\r
191 NULL,\r
192 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
193 );\r
194\r
5f119dfc
HL		 195 if (EFI_ERROR (Status)) {\r
196 SHELL_FREE_NON_NULL (Temp);\r
5f119dfc
HL		 197 return NULL;\r
198 }\r
199\r
efb76d1a
JC		 200 DataType = ConvertMemoryType(LoadedImage->ImageDataType);\r
201 CodeType = ConvertMemoryType(LoadedImage->ImageCodeType);\r
202\r
1a6f74d9
CS		 203 RetVal = CatSPrint(\r
204 NULL,\r
205 Temp,\r
206 LoadedImage->Revision,\r
207 LoadedImage->ParentHandle,\r
208 LoadedImage->SystemTable,\r
209 LoadedImage->DeviceHandle,\r
210 LoadedImage->FilePath,\r
211 LoadedImage->LoadOptionsSize,\r
212 LoadedImage->LoadOptions,\r
213 LoadedImage->ImageBase,\r
214 LoadedImage->ImageSize,\r
215 CodeType,\r
216 DataType,\r
217 LoadedImage->Unload\r
218 );\r
219\r
220\r
efb76d1a
JC		 221 SHELL_FREE_NON_NULL(Temp);\r
222 SHELL_FREE_NON_NULL(CodeType);\r
223 SHELL_FREE_NON_NULL(DataType);\r
224\r
225 return RetVal;\r
a405b86d 226}\r
a405b86d 227\r
609e0c58
JC		 228/**\r
229 Function to dump information about GOP.\r
230\r
231 This will allocate the return buffer from boot services pool.\r
232\r
233 @param[in] TheHandle The handle that has LoadedImage installed.\r
234 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
235\r
236 @retval A poitner to a string containing the information.\r
237**/\r
238CHAR16*\r
239EFIAPI\r
240GraphicsOutputProtocolDumpInformation(\r
241 IN CONST EFI_HANDLE TheHandle,\r
242 IN CONST BOOLEAN Verbose\r
243 )\r
244{\r
e918029f
RN		 245 EFI_GRAPHICS_OUTPUT_PROTOCOL *GraphicsOutput;\r
246 EFI_STATUS Status;\r
247 CHAR16 *RetVal;\r
248 CHAR16 *Temp;\r
249 CHAR16 *Fmt;\r
250 CHAR16 *TempRetVal;\r
251 UINTN GopInfoSize;\r
252 UINT32 Mode;\r
253 EFI_GRAPHICS_OUTPUT_MODE_INFORMATION *GopInfo;\r
609e0c58
JC		 254\r
255 if (!Verbose) {\r
256 return (CatSPrint(NULL, L"GraphicsOutput"));\r
257 }\r
258\r
e7e0e42b
CP		 259 HandleParsingHiiInit();\r
260\r
609e0c58 261 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_GOP_DUMP_MAIN), NULL);\r
1a6f74d9 262 if (Temp == NULL) {\r
609e0c58
JC		 263 return NULL;\r
264 }\r
265\r
266 Status = gBS->OpenProtocol (\r
267 TheHandle,\r
268 &gEfiGraphicsOutputProtocolGuid,\r
269 (VOID**)&GraphicsOutput,\r
270 gImageHandle,\r
271 NULL,\r
272 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
273 );\r
274\r
275 if (EFI_ERROR (Status)) {\r
276 SHELL_FREE_NON_NULL (Temp);\r
609e0c58
JC		 277 return NULL;\r
278 }\r
279\r
280 Fmt = ConvertPixelFormat(GraphicsOutput->Mode->Info->PixelFormat);\r
281\r
1a6f74d9
CS		 282 RetVal = CatSPrint(\r
283 NULL,\r
284 Temp,\r
285 GraphicsOutput->Mode->MaxMode,\r
286 GraphicsOutput->Mode->Mode,\r
287 GraphicsOutput->Mode->FrameBufferBase,\r
288 (UINT64)GraphicsOutput->Mode->FrameBufferSize,\r
289 (UINT64)GraphicsOutput->Mode->SizeOfInfo,\r
290 GraphicsOutput->Mode->Info->Version,\r
291 GraphicsOutput->Mode->Info->HorizontalResolution,\r
292 GraphicsOutput->Mode->Info->VerticalResolution,\r
293 Fmt,\r
294 GraphicsOutput->Mode->Info->PixelsPerScanLine,\r
295 GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.RedMask,\r
296 GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.GreenMask,\r
297 GraphicsOutput->Mode->Info->PixelFormat!=PixelBitMask?0:GraphicsOutput->Mode->Info->PixelInformation.BlueMask\r
298 );\r
299\r
e918029f
RN		 300 SHELL_FREE_NON_NULL (Temp);\r
301\r
6d3911d4
QS		 302 Temp = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN (STR_GOP_RES_LIST_MAIN), NULL);\r
303 if (Temp == NULL) {\r
304 SHELL_FREE_NON_NULL (RetVal);\r
305 goto EXIT;\r
306 }\r
e918029f
RN		 307\r
308 TempRetVal = CatSPrint (RetVal, Temp);\r
6d3911d4
QS		 309 SHELL_FREE_NON_NULL (RetVal);\r
310 if (TempRetVal == NULL) {\r
311 goto EXIT;\r
312 }\r
e918029f
RN		 313 RetVal = TempRetVal;\r
314 SHELL_FREE_NON_NULL (Temp);\r
315\r
6d3911d4
QS		 316 Temp = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN (STR_GOP_RES_LIST_ENTRY), NULL);\r
317 if (Temp == NULL) {\r
318 SHELL_FREE_NON_NULL (RetVal);\r
319 goto EXIT;\r
320 }\r
321\r
e918029f
RN		 322\r
323 for (Mode = 0; Mode < GraphicsOutput->Mode->MaxMode; Mode++) {\r
324 Status = GraphicsOutput->QueryMode (\r
325 GraphicsOutput,\r
326 Mode,\r
327 &GopInfoSize,\r
328 &GopInfo\r
329 );\r
330 if (EFI_ERROR (Status)) {\r
331 continue;\r
332 }\r
333\r
334 TempRetVal = CatSPrint (\r
335 RetVal,\r
336 Temp,\r
337 Mode,\r
338 GopInfo->HorizontalResolution,\r
339 GopInfo->VerticalResolution\r
340 );\r
341\r
342 SHELL_FREE_NON_NULL (GopInfo);\r
343 SHELL_FREE_NON_NULL (RetVal);\r
344 RetVal = TempRetVal;\r
345 }\r
346\r
6d3911d4
QS		 347\r
348EXIT:\r
609e0c58
JC		 349 SHELL_FREE_NON_NULL(Temp);\r
350 SHELL_FREE_NON_NULL(Fmt);\r
351\r
352 return RetVal;\r
353}\r
354\r
f4f3c6bf 355/**\r
e918029f
RN		 356 Function to dump information about EDID Discovered Protocol.\r
357\r
358 This will allocate the return buffer from boot services pool.\r
359\r
360 @param[in] TheHandle The handle that has LoadedImage installed.\r
361 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
362\r
363 @retval A pointer to a string containing the information.\r
364**/\r
365CHAR16*\r
366EFIAPI\r
367EdidDiscoveredProtocolDumpInformation (\r
368 IN CONST EFI_HANDLE TheHandle,\r
369 IN CONST BOOLEAN Verbose\r
370 )\r
371{\r
372 EFI_EDID_DISCOVERED_PROTOCOL *EdidDiscovered;\r
373 EFI_STATUS Status;\r
374 CHAR16 *RetVal;\r
375 CHAR16 *Temp;\r
376 CHAR16 *TempRetVal;\r
377\r
378 if (!Verbose) {\r
379 return (CatSPrint (NULL, L"EDIDDiscovered"));\r
380 }\r
381\r
382 Status = gBS->OpenProtocol (\r
383 TheHandle,\r
384 &gEfiEdidDiscoveredProtocolGuid,\r
385 (VOID**)&EdidDiscovered,\r
386 NULL,\r
387 NULL,\r
388 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
389 );\r
390\r
391 if (EFI_ERROR (Status)) {\r
392 return NULL;\r
393 }\r
394\r
395 Temp = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN (STR_EDID_DISCOVERED_MAIN), NULL);\r
396 if (Temp == NULL) {\r
397 return NULL;\r
398 }\r
399\r
400 RetVal = CatSPrint (NULL, Temp, EdidDiscovered->SizeOfEdid);\r
401 SHELL_FREE_NON_NULL (Temp);\r
402\r
403 if (EdidDiscovered->SizeOfEdid != 0) {\r
404 Temp = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN (STR_EDID_DISCOVERED_DATA), NULL);\r
405 if (Temp == NULL) {\r
406 SHELL_FREE_NON_NULL (RetVal);\r
407 return NULL;\r
408 }\r
409 TempRetVal = CatSPrint (RetVal, Temp);\r
410 SHELL_FREE_NON_NULL (RetVal);\r
411 RetVal = TempRetVal;\r
412\r
413 TempRetVal = CatSDumpHex (RetVal, 7, 0, EdidDiscovered->SizeOfEdid, EdidDiscovered->Edid);\r
414 RetVal = TempRetVal;\r
415 }\r
416 return RetVal;\r
417}\r
418\r
419/**\r
420 Function to dump information about EDID Active Protocol.\r
421\r
422 This will allocate the return buffer from boot services pool.\r
423\r
424 @param[in] TheHandle The handle that has LoadedImage installed.\r
425 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
426\r
427 @retval A pointer to a string containing the information.\r
428**/\r
429CHAR16*\r
430EFIAPI\r
431EdidActiveProtocolDumpInformation (\r
432 IN CONST EFI_HANDLE TheHandle,\r
433 IN CONST BOOLEAN Verbose\r
434 )\r
435{\r
436 EFI_EDID_ACTIVE_PROTOCOL *EdidActive;\r
437 EFI_STATUS Status;\r
438 CHAR16 *RetVal;\r
439 CHAR16 *Temp;\r
440 CHAR16 *TempRetVal;\r
441\r
442 if (!Verbose) {\r
443 return (CatSPrint (NULL, L"EDIDActive"));\r
444 }\r
445\r
446 Status = gBS->OpenProtocol (\r
447 TheHandle,\r
448 &gEfiEdidActiveProtocolGuid,\r
449 (VOID**)&EdidActive,\r
450 NULL,\r
451 NULL,\r
452 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
453 );\r
454\r
455 if (EFI_ERROR (Status)) {\r
456 return NULL;\r
457 }\r
458\r
459 Temp = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN (STR_EDID_ACTIVE_MAIN), NULL);\r
460 if (Temp == NULL) {\r
461 return NULL;\r
462 }\r
463\r
464 RetVal = CatSPrint (NULL, Temp, EdidActive->SizeOfEdid);\r
465 SHELL_FREE_NON_NULL (Temp);\r
466\r
467 if (EdidActive->SizeOfEdid != 0) {\r
468 Temp = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN (STR_EDID_ACTIVE_DATA), NULL);\r
469 if (Temp == NULL) {\r
470 SHELL_FREE_NON_NULL (RetVal);\r
471 return NULL;\r
472 }\r
473 TempRetVal = CatSPrint (RetVal, Temp);\r
474 SHELL_FREE_NON_NULL (RetVal);\r
475 RetVal = TempRetVal;\r
476\r
477 TempRetVal = CatSDumpHex (RetVal, 7, 0, EdidActive->SizeOfEdid, EdidActive->Edid);\r
478 RetVal = TempRetVal;\r
479 }\r
480 return RetVal;\r
481}\r
482\r
483/**\r
f4f3c6bf 484 Function to dump information about PciRootBridgeIo.\r
485\r
486 This will allocate the return buffer from boot services pool.\r
487\r
488 @param[in] TheHandle The handle that has PciRootBridgeIo installed.\r
489 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
490\r
491 @retval A poitner to a string containing the information.\r
492**/\r
493CHAR16*\r
494EFIAPI\r
495PciRootBridgeIoDumpInformation(\r
496 IN CONST EFI_HANDLE TheHandle,\r
497 IN CONST BOOLEAN Verbose\r
498 )\r
499{\r
500 EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL *PciRootBridgeIo;\r
501 EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR *Configuration;\r
502 UINT64 Supports;\r
503 UINT64 Attributes;\r
504 CHAR16 *Temp;\r
505 CHAR16 *Temp2;\r
506 CHAR16 *RetVal;\r
507 EFI_STATUS Status;\r
508\r
509 RetVal = NULL;\r
510\r
511 if (!Verbose) {\r
512 return (CatSPrint(NULL, L"PciRootBridgeIo"));\r
513 }\r
514\r
e7e0e42b
CP		 515 HandleParsingHiiInit();\r
516\r
f4f3c6bf 517 Status = gBS->HandleProtocol(\r
518 TheHandle,\r
519 &gEfiPciRootBridgeIoProtocolGuid,\r
520 (VOID**)&PciRootBridgeIo);\r
521\r
522 if (EFI_ERROR(Status)) {\r
523 return NULL;\r
524 }\r
525\r
526 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_PH), NULL);\r
1d6ccad2
QS		 527 if (Temp == NULL) {\r
528 return NULL;\r
529 }\r
f4f3c6bf 530 Temp2 = CatSPrint(L"\r\n", Temp, PciRootBridgeIo->ParentHandle);\r
531 FreePool(Temp);\r
532 RetVal = Temp2;\r
533 Temp2 = NULL;\r
1a6f74d9 534\r
f4f3c6bf 535 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_SEG), NULL);\r
1d6ccad2
QS		 536 if (Temp == NULL) {\r
537 SHELL_FREE_NON_NULL(RetVal);\r
538 return NULL;\r
539 }\r
f4f3c6bf 540 Temp2 = CatSPrint(RetVal, Temp, PciRootBridgeIo->SegmentNumber);\r
541 FreePool(Temp);\r
542 FreePool(RetVal);\r
543 RetVal = Temp2;\r
544 Temp2 = NULL;\r
545\r
546 Supports = 0;\r
547 Attributes = 0;\r
548 Status = PciRootBridgeIo->GetAttributes (PciRootBridgeIo, &Supports, &Attributes);\r
549 if (!EFI_ERROR(Status)) {\r
550 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_ATT), NULL);\r
1d6ccad2
QS		 551 if (Temp == NULL) {\r
552 SHELL_FREE_NON_NULL(RetVal);\r
553 return NULL;\r
1a6f74d9 554 }\r
f4f3c6bf 555 Temp2 = CatSPrint(RetVal, Temp, Attributes);\r
556 FreePool(Temp);\r
557 FreePool(RetVal);\r
558 RetVal = Temp2;\r
559 Temp2 = NULL;\r
1a6f74d9 560\r
f4f3c6bf 561 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_SUPPORTS), NULL);\r
1d6ccad2
QS		 562 if (Temp == NULL) {\r
563 SHELL_FREE_NON_NULL(RetVal);\r
564 return NULL;\r
565 }\r
f4f3c6bf 566 Temp2 = CatSPrint(RetVal, Temp, Supports);\r
567 FreePool(Temp);\r
568 FreePool(RetVal);\r
569 RetVal = Temp2;\r
570 Temp2 = NULL;\r
571 }\r
572\r
573 Configuration = NULL;\r
574 Status = PciRootBridgeIo->Configuration (PciRootBridgeIo, (VOID **) &Configuration);\r
575 if (!EFI_ERROR(Status) && Configuration != NULL) {\r
576 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_TITLE), NULL);\r
1d6ccad2
QS		 577 if (Temp == NULL) {\r
578 SHELL_FREE_NON_NULL(RetVal);\r
579 return NULL;\r
580 }\r
f4f3c6bf 581 Temp2 = CatSPrint(RetVal, Temp, Supports);\r
582 FreePool(Temp);\r
583 FreePool(RetVal);\r
584 RetVal = Temp2;\r
585 Temp2 = NULL;\r
586 while (Configuration->Desc == ACPI_ADDRESS_SPACE_DESCRIPTOR) {\r
587 Temp = NULL;\r
588 switch (Configuration->ResType) {\r
589 case ACPI_ADDRESS_SPACE_TYPE_MEM:\r
590 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_MEM), NULL);\r
591 break;\r
592 case ACPI_ADDRESS_SPACE_TYPE_IO:\r
593 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_IO), NULL);\r
594 break;\r
595 case ACPI_ADDRESS_SPACE_TYPE_BUS:\r
596 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_PCIRB_DUMP_BUS), NULL);\r
597 break;\r
598 }\r
599 if (Temp != NULL) {\r
600 Temp2 = CatSPrint(RetVal, L"%s", Temp);\r
601 FreePool(Temp);\r
602 FreePool(RetVal);\r
603 RetVal = Temp2;\r
604 Temp2 = NULL;\r
605 }\r
606\r
1a6f74d9 607 Temp2 = CatSPrint(RetVal,\r
f4f3c6bf 608 L"%H%02x %016lx %016lx %02x%N\r\n",\r
609 Configuration->SpecificFlag,\r
610 Configuration->AddrRangeMin,\r
611 Configuration->AddrRangeMax,\r
612 Configuration->AddrSpaceGranularity\r
613 );\r
614 FreePool(RetVal);\r
615 RetVal = Temp2;\r
616 Temp2 = NULL;\r
617 Configuration++;\r
618 }\r
619 }\r
620 return (RetVal);\r
621}\r
622\r
a405b86d 623/**\r
624 Function to dump information about SimpleTextOut.\r
625\r
626 This will allocate the return buffer from boot services pool.\r
627\r
628 @param[in] TheHandle The handle that has SimpleTextOut installed.\r
629 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
630\r
631 @retval A poitner to a string containing the information.\r
632**/\r
633CHAR16*\r
634EFIAPI\r
635TxtOutProtocolDumpInformation(\r
636 IN CONST EFI_HANDLE TheHandle,\r
637 IN CONST BOOLEAN Verbose\r
638 )\r
639{\r
640 EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL *Dev;\r
641 INTN Index;\r
642 UINTN Col;\r
643 UINTN Row;\r
644 EFI_STATUS Status;\r
645 CHAR16 *RetVal;\r
646 UINTN Size;\r
647 CHAR16 *Temp;\r
648 UINTN NewSize;\r
649\r
650 if (!Verbose) {\r
651 return (NULL);\r
652 }\r
653\r
e7e0e42b
CP		 654 HandleParsingHiiInit();\r
655\r
a405b86d 656 RetVal = NULL;\r
657 Size = 0;\r
658\r
659 Status = gBS->HandleProtocol(\r
660 TheHandle,\r
661 &gEfiSimpleTextOutProtocolGuid,\r
662 (VOID**)&Dev);\r
663\r
664 ASSERT_EFI_ERROR(Status);\r
665 ASSERT (Dev != NULL && Dev->Mode != NULL);\r
666\r
667 Size = (Dev->Mode->MaxMode + 1) * 80;\r
668 RetVal = AllocateZeroPool(Size);\r
669\r
670 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_TXT_OUT_DUMP_HEADER), NULL);\r
ecae5117 671 if (Temp != NULL) {\r
672 UnicodeSPrint(RetVal, Size, Temp, Dev, Dev->Mode->Attribute);\r
673 FreePool(Temp);\r
674 }\r
a405b86d 675\r
676 //\r
677 // Dump TextOut Info\r
678 //\r
679 Temp = HiiGetString(mHandleParsingHiiHandle, STRING_TOKEN(STR_TXT_OUT_DUMP_LINE), NULL);\r
680 for (Index = 0; Index < Dev->Mode->MaxMode; Index++) {\r
681 Status = Dev->QueryMode (Dev, Index, &Col, &Row);\r
682 NewSize = Size - StrSize(RetVal);\r
683 UnicodeSPrint(\r
684 RetVal + StrLen(RetVal),\r
685 NewSize,\r
ecae5117 686 Temp == NULL?L"":Temp,\r
a405b86d 687 Index == Dev->Mode->Mode ? L'*' : L' ',\r
688 Index,\r
28981267 689 !EFI_ERROR(Status)?(INTN)Col:-1,\r
690 !EFI_ERROR(Status)?(INTN)Row:-1\r
a405b86d 691 );\r
692 }\r
693 FreePool(Temp);\r
694 return (RetVal);\r
695}\r
696\r
697STATIC CONST UINTN VersionStringSize = 60;\r
698\r
699/**\r
700 Function to dump information about EfiDriverSupportedEfiVersion protocol.\r
701\r
702 This will allocate the return buffer from boot services pool.\r
703\r
704 @param[in] TheHandle The handle that has the protocol installed.\r
705 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
706\r
707 @retval A poitner to a string containing the information.\r
708**/\r
709CHAR16*\r
710EFIAPI\r
711DriverEfiVersionProtocolDumpInformation(\r
712 IN CONST EFI_HANDLE TheHandle,\r
713 IN CONST BOOLEAN Verbose\r
714 )\r
715{\r
716 EFI_DRIVER_SUPPORTED_EFI_VERSION_PROTOCOL *DriverEfiVersion;\r
717 EFI_STATUS Status;\r
718 CHAR16 *RetVal;\r
719\r
720 Status = gBS->HandleProtocol(\r
721 TheHandle,\r
722 &gEfiDriverSupportedEfiVersionProtocolGuid,\r
723 (VOID**)&DriverEfiVersion);\r
724\r
725 ASSERT_EFI_ERROR(Status);\r
726\r
78ed876b 727 RetVal = AllocateZeroPool(VersionStringSize);\r
aa3276c1
RN		 728 if (RetVal != NULL) {\r
729 UnicodeSPrint (RetVal, VersionStringSize, L"0x%08x", DriverEfiVersion->FirmwareVersion);\r
730 }\r
a405b86d 731 return (RetVal);\r
732}\r
5e32460d
RN		 733/**\r
734 Function to convert device path to string.\r
735\r
736 This will allocate the return buffer from boot services pool.\r
737\r
738 @param[in] DevPath Pointer to device path instance.\r
739 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
740 @param[in] Length Maximum allowed text length of the device path.\r
741\r
742 @retval A pointer to a string containing the information.\r
743**/\r
744CHAR16*\r
745ConvertDevicePathToShortText(\r
746 IN CONST EFI_DEVICE_PATH_PROTOCOL *DevPath,\r
747 IN CONST BOOLEAN Verbose,\r
748 IN CONST UINTN Length\r
749 )\r
750{\r
751 CHAR16 *Temp;\r
752 CHAR16 *Temp2;\r
753 UINTN Size;\r
754\r
755 //\r
756 // I cannot decide whether to allow shortcuts here (the second BOOLEAN on the next line)\r
757 //\r
758 Temp = ConvertDevicePathToText(DevPath, TRUE, TRUE);\r
759 if (!Verbose && Temp != NULL && StrLen(Temp) > Length) {\r
760 Temp2 = NULL;\r
761 Size = 0;\r
762 Temp2 = StrnCatGrow(&Temp2, &Size, L"..", 0);\r
763 Temp2 = StrnCatGrow(&Temp2, &Size, Temp+(StrLen(Temp) - (Length - 2)), 0);\r
764 FreePool(Temp);\r
765 Temp = Temp2;\r
766 }\r
767 return (Temp);\r
768}\r
a405b86d 769\r
770/**\r
771 Function to dump information about DevicePath protocol.\r
772\r
773 This will allocate the return buffer from boot services pool.\r
774\r
775 @param[in] TheHandle The handle that has the protocol installed.\r
776 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
777\r
5e32460d 778 @retval A pointer to a string containing the information.\r
a405b86d 779**/\r
780CHAR16*\r
781EFIAPI\r
782DevicePathProtocolDumpInformation(\r
783 IN CONST EFI_HANDLE TheHandle,\r
784 IN CONST BOOLEAN Verbose\r
785 )\r
786{\r
787 EFI_DEVICE_PATH_PROTOCOL *DevPath;\r
788 CHAR16 *Temp;\r
a405b86d 789 EFI_STATUS Status;\r
a405b86d 790 Temp = NULL;\r
791\r
863986b3 792 Status = gBS->OpenProtocol(TheHandle, &gEfiDevicePathProtocolGuid, (VOID**)&DevPath, gImageHandle, NULL, EFI_OPEN_PROTOCOL_GET_PROTOCOL);\r
a405b86d 793 if (!EFI_ERROR(Status)) {\r
5e32460d 794 Temp = ConvertDevicePathToShortText (DevPath, Verbose, 30);\r
863986b3 795 gBS->CloseProtocol(TheHandle, &gEfiDevicePathProtocolGuid, gImageHandle, NULL);\r
a405b86d 796 }\r
5e32460d
RN		 797 return (Temp);\r
798}\r
799\r
800/**\r
801 Function to dump information about LoadedImageDevicePath protocol.\r
802\r
803 This will allocate the return buffer from boot services pool.\r
804\r
805 @param[in] TheHandle The handle that has the protocol installed.\r
806 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
807\r
808 @retval A pointer to a string containing the information.\r
809**/\r
810CHAR16*\r
811EFIAPI\r
812LoadedImageDevicePathProtocolDumpInformation(\r
813 IN CONST EFI_HANDLE TheHandle,\r
814 IN CONST BOOLEAN Verbose\r
815 )\r
816{\r
817 EFI_DEVICE_PATH_PROTOCOL *DevPath;\r
818 CHAR16 *Temp;\r
819 EFI_STATUS Status;\r
820 Temp = NULL;\r
821\r
822 Status = gBS->OpenProtocol(TheHandle, &gEfiLoadedImageDevicePathProtocolGuid, (VOID**)&DevPath, gImageHandle, NULL, EFI_OPEN_PROTOCOL_GET_PROTOCOL);\r
823 if (!EFI_ERROR(Status)) {\r
824 Temp = ConvertDevicePathToShortText (DevPath, Verbose, 30);\r
825 gBS->CloseProtocol(TheHandle, &gEfiDevicePathProtocolGuid, gImageHandle, NULL);\r
a405b86d 826 }\r
827 return (Temp);\r
828}\r
829\r
59febea1
SEHM		 830/**\r
831 Function to dump information about EfiAdapterInformation Protocol.\r
832\r
833 @param[in] TheHandle The handle that has the protocol installed.\r
834 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
835\r
836 @retval A pointer to a string containing the information.\r
837**/\r
838CHAR16*\r
839EFIAPI\r
840AdapterInformationDumpInformation (\r
841 IN CONST EFI_HANDLE TheHandle,\r
842 IN CONST BOOLEAN Verbose\r
843 )\r
844{\r
845 EFI_STATUS Status;\r
846 EFI_ADAPTER_INFORMATION_PROTOCOL *EfiAdptrInfoProtocol;\r
847 UINTN InfoTypesBufferCount;\r
848 UINTN GuidIndex;\r
849 EFI_GUID *InfoTypesBuffer;\r
850 CHAR16 *GuidStr;\r
851 CHAR16 *TempStr;\r
852 CHAR16 *RetVal;\r
1a6f74d9 853 CHAR16 *TempRetVal;\r
59febea1
SEHM		 854 VOID *InformationBlock;\r
855 UINTN InformationBlockSize;\r
1a6f74d9 856\r
59febea1
SEHM		 857 if (!Verbose) {\r
858 return (CatSPrint(NULL, L"AdapterInfo"));\r
859 }\r
860\r
1d6ccad2
QS		 861 InfoTypesBuffer = NULL;\r
862 InformationBlock = NULL;\r
1a6f74d9 863\r
59febea1
SEHM		 864\r
865 Status = gBS->OpenProtocol (\r
866 (EFI_HANDLE) (TheHandle),\r
867 &gEfiAdapterInformationProtocolGuid,\r
868 (VOID **) &EfiAdptrInfoProtocol,\r
869 NULL,\r
870 NULL,\r
871 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
872 );\r
873\r
874 if (EFI_ERROR (Status)) {\r
59febea1
SEHM		 875 return NULL;\r
876 }\r
877\r
878 //\r
879 // Get a list of supported information types for this instance of the protocol.\r
880 //\r
881 Status = EfiAdptrInfoProtocol->GetSupportedTypes (\r
882 EfiAdptrInfoProtocol,\r
1a6f74d9 883 &InfoTypesBuffer,\r
59febea1
SEHM		 884 &InfoTypesBufferCount\r
885 );\r
1a6f74d9 886 RetVal = NULL;\r
59febea1
SEHM		 887 if (EFI_ERROR (Status)) {\r
888 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_GET_SUPP_TYPES_FAILED), NULL);\r
1d6ccad2 889 if (TempStr != NULL) {\r
1a6f74d9 890 RetVal = CatSPrint (NULL, TempStr, Status);\r
1d6ccad2
QS		 891 } else {\r
892 goto ERROR_EXIT;\r
1a6f74d9 893 }\r
59febea1
SEHM		 894 } else {\r
895 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_SUPP_TYPE_HEADER), NULL);\r
1d6ccad2
QS		 896 if (TempStr == NULL) {\r
897 goto ERROR_EXIT;\r
898 }\r
1a6f74d9 899 RetVal = CatSPrint (NULL, TempStr);\r
59febea1
SEHM		 900 SHELL_FREE_NON_NULL (TempStr);\r
901\r
902 for (GuidIndex = 0; GuidIndex < InfoTypesBufferCount; GuidIndex++) {\r
903 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_GUID_NUMBER), NULL);\r
1d6ccad2
QS		 904 if (TempStr == NULL) {\r
905 goto ERROR_EXIT;\r
906 }\r
5d54bbec 907 TempRetVal = CatSPrint (RetVal, TempStr, (GuidIndex + 1), &InfoTypesBuffer[GuidIndex]);\r
1a6f74d9
CS		 908 SHELL_FREE_NON_NULL (RetVal);\r
909 RetVal = TempRetVal;\r
59febea1
SEHM		 910 SHELL_FREE_NON_NULL (TempStr);\r
911\r
912 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_GUID_STRING), NULL);\r
1d6ccad2
QS		 913 if (TempStr == NULL) {\r
914 goto ERROR_EXIT;\r
915 }\r
59febea1
SEHM		 916\r
917 if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoMediaStateGuid)) {\r
1a6f74d9
CS		 918 TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoMediaStateGuid");\r
919 SHELL_FREE_NON_NULL (RetVal);\r
920 RetVal = TempRetVal;\r
59febea1 921 } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoNetworkBootGuid)) {\r
1a6f74d9
CS		 922 TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoNetworkBootGuid");\r
923 SHELL_FREE_NON_NULL (RetVal);\r
924 RetVal = TempRetVal;\r
59febea1 925 } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoSanMacAddressGuid)) {\r
1a6f74d9
CS		 926 TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoSanMacAddressGuid");\r
927 SHELL_FREE_NON_NULL (RetVal);\r
928 RetVal = TempRetVal;\r
256aa6d0
SEHM		 929 } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoUndiIpv6SupportGuid)) {\r
930 TempRetVal = CatSPrint (RetVal, TempStr, L"gEfiAdapterInfoUndiIpv6SupportGuid");\r
931 SHELL_FREE_NON_NULL (RetVal);\r
932 RetVal = TempRetVal;\r
59febea1
SEHM		 933 } else {\r
934\r
935 GuidStr = GetStringNameFromGuid (&InfoTypesBuffer[GuidIndex], NULL);\r
1a6f74d9 936\r
59febea1
SEHM		 937 if (GuidStr != NULL) {\r
938 if (StrCmp(GuidStr, L"UnknownDevice") == 0) {\r
1a6f74d9
CS		 939 TempRetVal = CatSPrint (RetVal, TempStr, L"UnknownInfoType");\r
940 SHELL_FREE_NON_NULL (RetVal);\r
941 RetVal = TempRetVal;\r
942\r
59febea1
SEHM		 943 SHELL_FREE_NON_NULL (TempStr);\r
944 SHELL_FREE_NON_NULL(GuidStr);\r
945 //\r
946 // So that we never have to pass this UnknownInfoType to the parsing function "GetInformation" service of AIP\r
947 //\r
1a6f74d9 948 continue;\r
59febea1 949 } else {\r
1a6f74d9
CS		 950 TempRetVal = CatSPrint (RetVal, TempStr, GuidStr);\r
951 SHELL_FREE_NON_NULL (RetVal);\r
952 RetVal = TempRetVal;\r
59febea1
SEHM		 953 SHELL_FREE_NON_NULL(GuidStr);\r
954 }\r
955 }\r
956 }\r
1a6f74d9 957\r
59febea1
SEHM		 958 SHELL_FREE_NON_NULL (TempStr);\r
959\r
960 Status = EfiAdptrInfoProtocol->GetInformation (\r
961 EfiAdptrInfoProtocol,\r
962 &InfoTypesBuffer[GuidIndex],\r
963 &InformationBlock,\r
964 &InformationBlockSize\r
965 );\r
966\r
967 if (EFI_ERROR (Status)) {\r
968 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_GETINFO_FAILED), NULL);\r
1d6ccad2
QS		 969 if (TempStr == NULL) {\r
970 goto ERROR_EXIT;\r
971 }\r
1a6f74d9
CS		 972 TempRetVal = CatSPrint (RetVal, TempStr, Status);\r
973 SHELL_FREE_NON_NULL (RetVal);\r
974 RetVal = TempRetVal;\r
59febea1
SEHM		 975 } else {\r
976 if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoMediaStateGuid)) {\r
977 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_MEDIA_STATE), NULL);\r
1d6ccad2
QS		 978 if (TempStr == NULL) {\r
979 goto ERROR_EXIT;\r
980 }\r
1a6f74d9
CS		 981 TempRetVal = CatSPrint (\r
982 RetVal,\r
983 TempStr,\r
984 ((EFI_ADAPTER_INFO_MEDIA_STATE *)InformationBlock)->MediaState,\r
985 ((EFI_ADAPTER_INFO_MEDIA_STATE *)InformationBlock)->MediaState\r
986 );\r
987 SHELL_FREE_NON_NULL (RetVal);\r
988 RetVal = TempRetVal;\r
59febea1
SEHM		 989 } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoNetworkBootGuid)) {\r
990 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_NETWORK_BOOT_INFO), NULL);\r
1d6ccad2
QS		 991 if (TempStr == NULL) {\r
992 goto ERROR_EXIT;\r
993 }\r
1a6f74d9
CS		 994 TempRetVal = CatSPrint (\r
995 RetVal,\r
996 TempStr,\r
997 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv4BootCapablity,\r
998 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv6BootCapablity,\r
999 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->FCoeBootCapablity,\r
1000 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->OffloadCapability,\r
1001 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiMpioCapability,\r
1002 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv4Boot,\r
1003 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->iScsiIpv6Boot,\r
1004 ((EFI_ADAPTER_INFO_NETWORK_BOOT *)InformationBlock)->FCoeBoot\r
1005 );\r
1006 SHELL_FREE_NON_NULL (RetVal);\r
1007 RetVal = TempRetVal;\r
1008 } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoSanMacAddressGuid) == TRUE) {\r
59febea1 1009 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_SAN_MAC_ADDRESS_INFO), NULL);\r
1d6ccad2
QS		 1010 if (TempStr == NULL) {\r
1011 goto ERROR_EXIT;\r
1012 }\r
1a6f74d9
CS		 1013 TempRetVal = CatSPrint (\r
1014 RetVal,\r
1015 TempStr,\r
1016 ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[0],\r
1017 ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[1],\r
1018 ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[2],\r
1019 ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[3],\r
1020 ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[4],\r
1021 ((EFI_ADAPTER_INFO_SAN_MAC_ADDRESS *)InformationBlock)->SanMacAddress.Addr[5]\r
1022 );\r
1023 SHELL_FREE_NON_NULL (RetVal);\r
1024 RetVal = TempRetVal;\r
256aa6d0
SEHM		 1025 } else if (CompareGuid (&InfoTypesBuffer[GuidIndex], &gEfiAdapterInfoUndiIpv6SupportGuid) == TRUE) {\r
1026 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_UNDI_IPV6_INFO), NULL);\r
1027 if (TempStr == NULL) {\r
1028 goto ERROR_EXIT;\r
1029 }\r
1030\r
1031 TempRetVal = CatSPrint (\r
1032 RetVal,\r
1033 TempStr,\r
1034 ((EFI_ADAPTER_INFO_UNDI_IPV6_SUPPORT *)InformationBlock)->Ipv6Support\r
e918029f 1035 );\r
256aa6d0
SEHM		 1036 SHELL_FREE_NON_NULL (RetVal);\r
1037 RetVal = TempRetVal;\r
59febea1
SEHM		 1038 } else {\r
1039 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_UNKNOWN_INFO_TYPE), NULL);\r
1d6ccad2
QS		 1040 if (TempStr == NULL) {\r
1041 goto ERROR_EXIT;\r
1042 }\r
1a6f74d9
CS		 1043 TempRetVal = CatSPrint (RetVal, TempStr, &InfoTypesBuffer[GuidIndex]);\r
1044 SHELL_FREE_NON_NULL (RetVal);\r
1045 RetVal = TempRetVal;\r
59febea1
SEHM		 1046 }\r
1047 }\r
1048 SHELL_FREE_NON_NULL (TempStr);\r
1049 SHELL_FREE_NON_NULL (InformationBlock);\r
1050 }\r
1051 }\r
1052\r
1d6ccad2 1053 SHELL_FREE_NON_NULL (InfoTypesBuffer);\r
59febea1 1054 return RetVal;\r
1d6ccad2
QS		 1055\r
1056ERROR_EXIT:\r
1057 SHELL_FREE_NON_NULL (RetVal);\r
1058 SHELL_FREE_NON_NULL (InfoTypesBuffer);\r
1059 SHELL_FREE_NON_NULL (InformationBlock);\r
1060 return NULL;\r
59febea1 1061}\r
8985d612
TS		 1062\r
1063/**\r
1064 Function to dump information about EFI_FIRMWARE_MANAGEMENT_PROTOCOL Protocol.\r
1065\r
1066 @param[in] TheHandle The handle that has the protocol installed.\r
1067 @param[in] Verbose TRUE for additional information, FALSE otherwise.\r
1068\r
1069 @retval A pointer to a string containing the information.\r
1070**/\r
1071CHAR16*\r
1072EFIAPI\r
1073FirmwareManagementDumpInformation (\r
1074 IN CONST EFI_HANDLE TheHandle,\r
1075 IN CONST BOOLEAN Verbose\r
1076 )\r
1077{\r
1078 EFI_STATUS Status;\r
1079 EFI_FIRMWARE_MANAGEMENT_PROTOCOL *EfiFwMgmtProtocol;\r
1080 EFI_FIRMWARE_IMAGE_DESCRIPTOR *ImageInfo;\r
1081 EFI_FIRMWARE_IMAGE_DESCRIPTOR_V1 *ImageInfoV1;\r
1082 EFI_FIRMWARE_IMAGE_DESCRIPTOR_V2 *ImageInfoV2;\r
1083 UINT64 AttributeSetting;\r
1084 UINTN ImageInfoSize;\r
1085 UINTN DescriptorSize;\r
1086 UINT32 DescriptorVersion;\r
1087 UINT32 PackageVersion;\r
1088 UINT8 DescriptorCount;\r
1089 UINT8 Index;\r
1090 UINT8 Index1;\r
1091 UINT8 ImageCount;\r
1092 CHAR16 *PackageVersionName;\r
1093 CHAR16 *TempStr;\r
1094 CHAR16 *RetVal;\r
1095 CHAR16 *TempRetVal;\r
1096 CHAR16 *AttributeSettingStr;\r
1097 BOOLEAN Found;\r
1098 BOOLEAN AttributeSupported;\r
1099\r
1100 //\r
1101 // Initialize local variables\r
1102 //\r
1103 ImageCount = 0;\r
1104 ImageInfoSize = 1;\r
1105 AttributeSetting = 0;\r
1106 Found = FALSE;\r
1107 AttributeSupported = FALSE;\r
1108 ImageInfo = NULL;\r
1109 ImageInfoV1 = NULL;\r
1110 ImageInfoV2 = NULL;\r
1111 PackageVersionName = NULL;\r
1112 RetVal = NULL;\r
1113 TempRetVal = NULL;\r
1114 TempStr = NULL;\r
1115 AttributeSettingStr = NULL;\r
1116\r
1117 if (!Verbose) {\r
1118 return (CatSPrint(NULL, L"FirmwareManagement"));\r
1119 }\r
1120\r
1121 Status = gBS->OpenProtocol (\r
1122 (EFI_HANDLE) (TheHandle),\r
1123 &gEfiFirmwareManagementProtocolGuid,\r
1124 (VOID **) &EfiFwMgmtProtocol,\r
1125 NULL,\r
1126 NULL,\r
1127 EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
1128 );\r
1129\r
1130 if (EFI_ERROR (Status)) {\r
1131 return NULL;\r
1132 }\r
1133\r
1134 Status = EfiFwMgmtProtocol->GetImageInfo (\r
1135 EfiFwMgmtProtocol,\r
1136 &ImageInfoSize,\r
1137 ImageInfo,\r
1138 &DescriptorVersion,\r
1139 &DescriptorCount,\r
1140 &DescriptorSize,\r
1141 &PackageVersion,\r
1142 &PackageVersionName\r
1143 );\r
1144\r
1145 if (Status == EFI_BUFFER_TOO_SMALL) {\r
1146 ImageInfo = AllocateZeroPool (ImageInfoSize);\r
1147\r
1148 if (ImageInfo == NULL) {\r
1149 Status = EFI_OUT_OF_RESOURCES;\r
1150 } else {\r
1151 Status = EfiFwMgmtProtocol->GetImageInfo (\r
1152 EfiFwMgmtProtocol,\r
1153 &ImageInfoSize,\r
1154 ImageInfo,\r
1155 &DescriptorVersion,\r
1156 &DescriptorCount,\r
1157 &DescriptorSize,\r
1158 &PackageVersion,\r
1159 &PackageVersionName\r
1160 );\r
1161 }\r
1162 }\r
1163\r
1164 if (EFI_ERROR (Status)) {\r
1165 goto ERROR_EXIT;\r
1166 }\r
1167\r
1168 //\r
1169 // Decode Image Descriptor data only if its version is supported\r
1170 //\r
1171 if (DescriptorVersion <= EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION) {\r
1172\r
1173 if (ImageInfo == NULL) {\r
1174 goto ERROR_EXIT;\r
1175 }\r
1176\r
1177 ImageInfoV1 = (EFI_FIRMWARE_IMAGE_DESCRIPTOR_V1 *)ImageInfo;\r
1178 ImageInfoV2 = (EFI_FIRMWARE_IMAGE_DESCRIPTOR_V2 *)ImageInfo;\r
1179\r
1180 //\r
1181 // Set ImageInfoSize in return buffer\r
1182 //\r
1183 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_IMAGE_INFO_SIZE), NULL);\r
1184 if (TempStr == NULL) {\r
1185 goto ERROR_EXIT;\r
1186 }\r
1187 RetVal = CatSPrint (NULL, TempStr, ImageInfoSize);\r
1188 SHELL_FREE_NON_NULL (TempStr);\r
1189\r
1190 //\r
1191 // Set DescriptorVersion in return buffer\r
1192 //\r
1193 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_DESCRIPTOR_VERSION), NULL);\r
1194 if (TempStr == NULL) {\r
1195 goto ERROR_EXIT;\r
1196 }\r
1197 TempRetVal = CatSPrint (RetVal, TempStr, DescriptorVersion);\r
1198 SHELL_FREE_NON_NULL (RetVal);\r
1199 RetVal = TempRetVal;\r
1200 SHELL_FREE_NON_NULL (TempStr);\r
1201\r
1202 //\r
1203 // Set DescriptorCount in return buffer\r
1204 //\r
1205 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_DESCRIPTOR_COUNT), NULL);\r
1206 if (TempStr == NULL) {\r
1207 goto ERROR_EXIT;\r
1208 }\r
1209 TempRetVal = CatSPrint (RetVal, TempStr, DescriptorCount);\r
1210 SHELL_FREE_NON_NULL (RetVal);\r
1211 RetVal = TempRetVal;\r
1212 SHELL_FREE_NON_NULL (TempStr);\r
1213\r
1214\r
1215 //\r
1216 // Set DescriptorSize in return buffer\r
1217 //\r
1218 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_DESCRIPTOR_SIZE), NULL);\r
1219 if (TempStr == NULL) {\r
1220 goto ERROR_EXIT;\r
1221 }\r
1222 TempRetVal = CatSPrint (RetVal, TempStr, DescriptorSize);\r
1223 SHELL_FREE_NON_NULL (RetVal);\r
1224 RetVal = TempRetVal;\r
1225 SHELL_FREE_NON_NULL (TempStr);\r
1226\r
1227 //\r
1228 // Set PackageVersion in return buffer\r
1229 //\r
1230 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_PACKAGE_VERSION), NULL);\r
1231 if (TempStr == NULL) {\r
1232 goto ERROR_EXIT;\r
1233 }\r
1234 TempRetVal = CatSPrint (RetVal, TempStr, PackageVersion);\r
1235 SHELL_FREE_NON_NULL (RetVal);\r
1236 RetVal = TempRetVal;\r
1237 SHELL_FREE_NON_NULL (TempStr);\r
1238\r
1239 //\r
1240 // Set PackageVersionName in return buffer\r
1241 //\r
1242 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_PACKAGE_VERSION_NAME), NULL);\r
1243 if (TempStr == NULL) {\r
1244 goto ERROR_EXIT;\r
1245 }\r
1246 TempRetVal = CatSPrint (RetVal, TempStr, PackageVersionName);\r
1247 SHELL_FREE_NON_NULL (RetVal);\r
1248 RetVal = TempRetVal;\r
1249 SHELL_FREE_NON_NULL (TempStr);\r
1250\r
1251 for (Index = 0; Index < DescriptorCount; Index++) {\r
1252 //\r
1253 // First check if Attribute is supported\r
1254 // and generate a string for AttributeSetting field\r
1255 //\r
1256 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1257 AttributeSupported = FALSE;\r
1258 AttributeSetting = 0;\r
1259 if (DescriptorVersion == EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION_V1) {\r
1260 if (ImageInfoV1[Index].AttributesSupported != 0x0) {\r
1261 AttributeSupported = TRUE;\r
1262 AttributeSetting = ImageInfoV1[Index].AttributesSetting;\r
1263 }\r
1264 } else if (DescriptorVersion == EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION_V2) {\r
1265 if (ImageInfoV2[Index].AttributesSupported != 0x0) {\r
1266 AttributeSupported = TRUE;\r
1267 AttributeSetting = ImageInfoV2[Index].AttributesSetting;\r
1268 }\r
1269 } else {\r
1270 if (ImageInfo[Index].AttributesSupported != 0x0) {\r
1271 AttributeSupported = TRUE;\r
1272 AttributeSetting = ImageInfo[Index].AttributesSetting;\r
1273 }\r
1274 }\r
1275\r
1276 if (!AttributeSupported) {\r
1277 AttributeSettingStr = CatSPrint (NULL, L"None");\r
1278 } else {\r
1279 AttributeSettingStr = CatSPrint (NULL, L"(");\r
1280\r
ac14846a 1281 if ((AttributeSetting & IMAGE_ATTRIBUTE_IMAGE_UPDATABLE) != 0x0) {\r
8985d612
TS		 1282 TempRetVal = CatSPrint (AttributeSettingStr, L" IMAGE_ATTRIBUTE_IMAGE_UPDATABLE");\r
1283 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1284 AttributeSettingStr = TempRetVal;\r
1285 }\r
ac14846a 1286 if ((AttributeSetting & IMAGE_ATTRIBUTE_RESET_REQUIRED) != 0x0) {\r
8985d612
TS		 1287 TempRetVal = CatSPrint (AttributeSettingStr, L" IMAGE_ATTRIBUTE_RESET_REQUIRED");\r
1288 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1289 AttributeSettingStr = TempRetVal;\r
1290 }\r
ac14846a 1291 if ((AttributeSetting & IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED) != 0x0) {\r
8985d612
TS		 1292 TempRetVal = CatSPrint (AttributeSettingStr, L" IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED");\r
1293 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1294 AttributeSettingStr = TempRetVal;\r
1295 }\r
ac14846a 1296 if ((AttributeSetting & IMAGE_ATTRIBUTE_IN_USE) != 0x0) {\r
8985d612
TS		 1297 TempRetVal = CatSPrint (AttributeSettingStr, L" IMAGE_ATTRIBUTE_IN_USE");\r
1298 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1299 AttributeSettingStr = TempRetVal;\r
1300 }\r
ac14846a 1301 if ((AttributeSetting & IMAGE_ATTRIBUTE_UEFI_IMAGE) != 0x0) {\r
8985d612
TS		 1302 TempRetVal = CatSPrint (AttributeSettingStr, L" IMAGE_ATTRIBUTE_UEFI_IMAGE");\r
1303 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1304 AttributeSettingStr = TempRetVal;\r
1305 }\r
1306 TempRetVal = CatSPrint (AttributeSettingStr, L" )");\r
1307 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1308 AttributeSettingStr = TempRetVal;\r
1309 }\r
1310\r
1311 if (DescriptorVersion == EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION_V1) {\r
1312 if (ImageInfoV1[Index].ImageIndex != 0x0) {\r
1313 ImageCount++;\r
1314 }\r
1315\r
1316 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_IMAGE_DESCRIPTOR_INFO_V1), NULL);\r
1317 if (TempStr == NULL) {\r
1318 goto ERROR_EXIT;\r
1319 }\r
1320 TempRetVal = CatSPrint (\r
1321 RetVal,\r
1322 TempStr,\r
1323 Index,\r
1324 ImageInfoV1[Index].ImageIndex,\r
e06a4c08 1325 &ImageInfoV1[Index].ImageTypeId,\r
8985d612
TS		 1326 ImageInfoV1[Index].ImageId,\r
1327 ImageInfoV1[Index].ImageIdName,\r
1328 ImageInfoV1[Index].Version,\r
1329 ImageInfoV1[Index].VersionName,\r
1330 ImageInfoV1[Index].Size,\r
1331 ImageInfoV1[Index].AttributesSupported,\r
1332 AttributeSettingStr,\r
1333 ImageInfoV1[Index].Compatibilities\r
1334 );\r
1335 SHELL_FREE_NON_NULL (RetVal);\r
1336 RetVal = TempRetVal;\r
1337 SHELL_FREE_NON_NULL (TempStr);\r
1338 } else if (DescriptorVersion == EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION_V2) {\r
1339 if (ImageInfoV2[Index].ImageIndex != 0x0) {\r
1340 ImageCount++;\r
1341 }\r
1342\r
1343 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_IMAGE_DESCRIPTOR_INFO_V2), NULL);\r
1344 if (TempStr == NULL) {\r
1345 goto ERROR_EXIT;\r
1346 }\r
1347 TempRetVal = CatSPrint (\r
1348 RetVal,\r
1349 TempStr,\r
1350 Index,\r
1351 ImageInfoV2[Index].ImageIndex,\r
e06a4c08 1352 &ImageInfoV2[Index].ImageTypeId,\r
8985d612
TS		 1353 ImageInfoV2[Index].ImageId,\r
1354 ImageInfoV2[Index].ImageIdName,\r
1355 ImageInfoV2[Index].Version,\r
1356 ImageInfoV2[Index].VersionName,\r
1357 ImageInfoV2[Index].Size,\r
1358 ImageInfoV2[Index].AttributesSupported,\r
1359 AttributeSettingStr,\r
1360 ImageInfoV2[Index].Compatibilities,\r
1361 ImageInfoV2[Index].LowestSupportedImageVersion\r
1362 );\r
1363 SHELL_FREE_NON_NULL (RetVal);\r
1364 RetVal = TempRetVal;\r
1365 SHELL_FREE_NON_NULL (TempStr);\r
1366 } else {\r
1367 if (ImageInfo[Index].ImageIndex != 0x0) {\r
1368 ImageCount++;\r
1369 }\r
1370\r
1371 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_IMAGE_DESCRIPTOR_INFO), NULL);\r
1372 if (TempStr == NULL) {\r
1373 goto ERROR_EXIT;\r
1374 }\r
1375 TempRetVal = CatSPrint (\r
1376 RetVal,\r
1377 TempStr,\r
1378 Index,\r
1379 ImageInfo[Index].ImageIndex,\r
e06a4c08 1380 &ImageInfo[Index].ImageTypeId,\r
8985d612
TS		 1381 ImageInfo[Index].ImageId,\r
1382 ImageInfo[Index].ImageIdName,\r
1383 ImageInfo[Index].Version,\r
1384 ImageInfo[Index].VersionName,\r
1385 ImageInfo[Index].Size,\r
1386 ImageInfo[Index].AttributesSupported,\r
1387 AttributeSettingStr,\r
1388 ImageInfo[Index].Compatibilities,\r
1389 ImageInfo[Index].LowestSupportedImageVersion,\r
1390 ImageInfo[Index].LastAttemptVersion,\r
1391 ImageInfo[Index].LastAttemptStatus,\r
1392 ImageInfo[Index].HardwareInstance\r
1393 );\r
1394 SHELL_FREE_NON_NULL (RetVal);\r
1395 RetVal = TempRetVal;\r
1396 SHELL_FREE_NON_NULL (TempStr);\r
1397 }\r
1398 }\r
1399 }\r
1400\r
1401 if (ImageCount > 0) {\r
1402 for (Index=0; Index<DescriptorCount; Index++) {\r
1403 for (Index1=Index+1; Index1<DescriptorCount; Index1++) {\r
1404 if (DescriptorVersion == EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION_V1) {\r
1405 if (ImageInfoV1[Index].ImageId == ImageInfoV1[Index1].ImageId) {\r
1406 Found = TRUE;\r
1407 //\r
1408 // At least one match found indicating presense of non unique ImageId values so no more comparisons needed\r
1409 //\r
1410 goto ENDLOOP;\r
1411 }\r
1412 } else if (DescriptorVersion == EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION_V2) {\r
1413 if (ImageInfoV2[Index].ImageId == ImageInfoV2[Index1].ImageId) {\r
1414 Found = TRUE;\r
1415 //\r
1416 // At least one match found indicating presense of non unique ImageId values so no more comparisons needed\r
1417 //\r
1418 goto ENDLOOP;\r
1419 }\r
1420 } else {\r
1421 if (ImageInfo[Index].ImageId == ImageInfo[Index1].ImageId) {\r
1422 Found = TRUE;\r
1423 //\r
1424 // At least one match found indicating presense of non unique ImageId values so no more comparisons needed\r
1425 //\r
1426 goto ENDLOOP;\r
1427 }\r
1428 }\r
1429 }\r
1430 }\r
1431 }\r
1432\r
1433ENDLOOP:\r
1434 //\r
1435 // Check if ImageId with duplicate value was found\r
1436 //\r
ac14846a 1437 if (Found) {\r
8985d612
TS		 1438 TempStr = HiiGetString (mHandleParsingHiiHandle, STRING_TOKEN(STR_FMP_IMAGEID_NON_UNIQUE), NULL);\r
1439 if (TempStr == NULL) {\r
1440 goto ERROR_EXIT;\r
1441 }\r
1442 TempRetVal = CatSPrint (RetVal, TempStr);\r
1443 SHELL_FREE_NON_NULL (RetVal);\r
1444 RetVal = TempRetVal;\r
1445 SHELL_FREE_NON_NULL (TempStr);\r
1446 }\r
1447\r
1448 SHELL_FREE_NON_NULL (ImageInfo);\r
1449 SHELL_FREE_NON_NULL (PackageVersionName);\r
1450 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1451\r
1452 return RetVal;\r
1453\r
1454ERROR_EXIT:\r
1455 SHELL_FREE_NON_NULL (RetVal);\r
1456 SHELL_FREE_NON_NULL (ImageInfo);\r
1457 SHELL_FREE_NON_NULL (PackageVersionName);\r
1458 SHELL_FREE_NON_NULL (AttributeSettingStr);\r
1459\r
1460 return NULL;\r
1461}\r
1462\r
a405b86d 1463//\r
1464// Put the information on the NT32 protocol GUIDs here so we are not dependant on the Nt32Pkg\r
1465//\r
1466#define LOCAL_EFI_WIN_NT_THUNK_PROTOCOL_GUID \\r
1467 { \\r
ce68d3bc 1468 0x58c518b1, 0x76f3, 0x11d4, { 0xbc, 0xea, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \\r
a405b86d 1469 }\r
1470\r
1471#define LOCAL_EFI_WIN_NT_BUS_DRIVER_IO_PROTOCOL_GUID \\r
1472 { \\r
ce68d3bc 1473 0x96eb4ad6, 0xa32a, 0x11d4, { 0xbc, 0xfd, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \\r
a405b86d 1474 }\r
1475\r
1476#define LOCAL_EFI_WIN_NT_SERIAL_PORT_GUID \\r
1477 { \\r
ce68d3bc 1478 0xc95a93d, 0xa006, 0x11d4, { 0xbc, 0xfa, 0x0, 0x80, 0xc7, 0x3c, 0x88, 0x81 } \\r
a405b86d 1479 }\r
1480STATIC CONST EFI_GUID WinNtThunkProtocolGuid = LOCAL_EFI_WIN_NT_THUNK_PROTOCOL_GUID;\r
1481STATIC CONST EFI_GUID WinNtIoProtocolGuid = LOCAL_EFI_WIN_NT_BUS_DRIVER_IO_PROTOCOL_GUID;\r
1482STATIC CONST EFI_GUID WinNtSerialPortGuid = LOCAL_EFI_WIN_NT_SERIAL_PORT_GUID;\r
1483\r
2c23ddaa 1484//\r
1485// Deprecated protocols we dont want to link from IntelFrameworkModulePkg\r
1486//\r
1487#define LOCAL_EFI_ISA_IO_PROTOCOL_GUID \\r
1488 { \\r
1489 0x7ee2bd44, 0x3da0, 0x11d4, { 0x9a, 0x38, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d } \\r
1a6f74d9 1490 }\r
2c23ddaa 1491#define LOCAL_EFI_ISA_ACPI_PROTOCOL_GUID \\r
1492 { \\r
1493 0x64a892dc, 0x5561, 0x4536, { 0x92, 0xc7, 0x79, 0x9b, 0xfc, 0x18, 0x33, 0x55 } \\r
1494 }\r
1495STATIC CONST EFI_GUID EfiIsaIoProtocolGuid = LOCAL_EFI_ISA_IO_PROTOCOL_GUID;\r
1496STATIC CONST EFI_GUID EfiIsaAcpiProtocolGuid = LOCAL_EFI_ISA_ACPI_PROTOCOL_GUID;\r
1497\r
1498\r
dee34318 1499STATIC CONST GUID_INFO_BLOCK mGuidStringListNT[] = {\r
a405b86d 1500 {STRING_TOKEN(STR_WINNT_THUNK), (EFI_GUID*)&WinNtThunkProtocolGuid, NULL},\r
1501 {STRING_TOKEN(STR_WINNT_DRIVER_IO), (EFI_GUID*)&WinNtIoProtocolGuid, NULL},\r
1502 {STRING_TOKEN(STR_WINNT_SERIAL_PORT), (EFI_GUID*)&WinNtSerialPortGuid, NULL},\r
1503 {STRING_TOKEN(STR_UNKNOWN_DEVICE), NULL, NULL},\r
1504};\r
1505\r
dee34318 1506STATIC CONST GUID_INFO_BLOCK mGuidStringList[] = {\r
efb76d1a 1507 {STRING_TOKEN(STR_LOADED_IMAGE), &gEfiLoadedImageProtocolGuid, LoadedImageProtocolDumpInformation},\r
a405b86d 1508 {STRING_TOKEN(STR_DEVICE_PATH), &gEfiDevicePathProtocolGuid, DevicePathProtocolDumpInformation},\r
5e32460d 1509 {STRING_TOKEN(STR_IMAGE_PATH), &gEfiLoadedImageDevicePathProtocolGuid, LoadedImageDevicePathProtocolDumpInformation},\r
a405b86d 1510 {STRING_TOKEN(STR_DEVICE_PATH_UTIL), &gEfiDevicePathUtilitiesProtocolGuid, NULL},\r
1511 {STRING_TOKEN(STR_DEVICE_PATH_TXT), &gEfiDevicePathToTextProtocolGuid, NULL},\r
1512 {STRING_TOKEN(STR_DEVICE_PATH_FTXT), &gEfiDevicePathFromTextProtocolGuid, NULL},\r
1513 {STRING_TOKEN(STR_DEVICE_PATH_PC), &gEfiPcAnsiGuid, NULL},\r
1514 {STRING_TOKEN(STR_DEVICE_PATH_VT100), &gEfiVT100Guid, NULL},\r
1515 {STRING_TOKEN(STR_DEVICE_PATH_VT100P), &gEfiVT100PlusGuid, NULL},\r
1516 {STRING_TOKEN(STR_DEVICE_PATH_VTUTF8), &gEfiVTUTF8Guid, NULL},\r
1517 {STRING_TOKEN(STR_DRIVER_BINDING), &gEfiDriverBindingProtocolGuid, NULL},\r
1518 {STRING_TOKEN(STR_PLATFORM_OVERRIDE), &gEfiPlatformDriverOverrideProtocolGuid, NULL},\r
1519 {STRING_TOKEN(STR_BUS_OVERRIDE), &gEfiBusSpecificDriverOverrideProtocolGuid, NULL},\r
1520 {STRING_TOKEN(STR_DRIVER_DIAG), &gEfiDriverDiagnosticsProtocolGuid, NULL},\r
1521 {STRING_TOKEN(STR_DRIVER_DIAG2), &gEfiDriverDiagnostics2ProtocolGuid, NULL},\r
1522 {STRING_TOKEN(STR_DRIVER_CN), &gEfiComponentNameProtocolGuid, NULL},\r
1523 {STRING_TOKEN(STR_DRIVER_CN2), &gEfiComponentName2ProtocolGuid, NULL},\r
1524 {STRING_TOKEN(STR_PLAT_DRV_CFG), &gEfiPlatformToDriverConfigurationProtocolGuid, NULL},\r
1525 {STRING_TOKEN(STR_DRIVER_VERSION), &gEfiDriverSupportedEfiVersionProtocolGuid, DriverEfiVersionProtocolDumpInformation},\r
1526 {STRING_TOKEN(STR_TXT_IN), &gEfiSimpleTextInProtocolGuid, NULL},\r
1527 {STRING_TOKEN(STR_TXT_IN_EX), &gEfiSimpleTextInputExProtocolGuid, NULL},\r
1528 {STRING_TOKEN(STR_TXT_OUT), &gEfiSimpleTextOutProtocolGuid, TxtOutProtocolDumpInformation},\r
1529 {STRING_TOKEN(STR_SIM_POINTER), &gEfiSimplePointerProtocolGuid, NULL},\r
1530 {STRING_TOKEN(STR_ABS_POINTER), &gEfiAbsolutePointerProtocolGuid, NULL},\r
1531 {STRING_TOKEN(STR_SERIAL_IO), &gEfiSerialIoProtocolGuid, NULL},\r
609e0c58 1532 {STRING_TOKEN(STR_GRAPHICS_OUTPUT), &gEfiGraphicsOutputProtocolGuid, GraphicsOutputProtocolDumpInformation},\r
e918029f
RN		 1533 {STRING_TOKEN(STR_EDID_DISCOVERED), &gEfiEdidDiscoveredProtocolGuid, EdidDiscoveredProtocolDumpInformation},\r
1534 {STRING_TOKEN(STR_EDID_ACTIVE), &gEfiEdidActiveProtocolGuid, EdidActiveProtocolDumpInformation},\r
a405b86d 1535 {STRING_TOKEN(STR_EDID_OVERRIDE), &gEfiEdidOverrideProtocolGuid, NULL},\r
1536 {STRING_TOKEN(STR_CON_IN), &gEfiConsoleInDeviceGuid, NULL},\r
1537 {STRING_TOKEN(STR_CON_OUT), &gEfiConsoleOutDeviceGuid, NULL},\r
1538 {STRING_TOKEN(STR_STD_ERR), &gEfiStandardErrorDeviceGuid, NULL},\r
1539 {STRING_TOKEN(STR_LOAD_FILE), &gEfiLoadFileProtocolGuid, NULL},\r
1540 {STRING_TOKEN(STR_LOAD_FILE2), &gEfiLoadFile2ProtocolGuid, NULL},\r
1541 {STRING_TOKEN(STR_SIMPLE_FILE_SYS), &gEfiSimpleFileSystemProtocolGuid, NULL},\r
a405b86d 1542 {STRING_TOKEN(STR_TAPE_IO), &gEfiTapeIoProtocolGuid, NULL},\r
1543 {STRING_TOKEN(STR_DISK_IO), &gEfiDiskIoProtocolGuid, NULL},\r
1544 {STRING_TOKEN(STR_BLK_IO), &gEfiBlockIoProtocolGuid, NULL},\r
1545 {STRING_TOKEN(STR_UC), &gEfiUnicodeCollationProtocolGuid, NULL},\r
1546 {STRING_TOKEN(STR_UC2), &gEfiUnicodeCollation2ProtocolGuid, NULL},\r
f4f3c6bf 1547 {STRING_TOKEN(STR_PCIRB_IO), &gEfiPciRootBridgeIoProtocolGuid, PciRootBridgeIoDumpInformation},\r
a405b86d 1548 {STRING_TOKEN(STR_PCI_IO), &gEfiPciIoProtocolGuid, NULL},\r
1549 {STRING_TOKEN(STR_SCSI_PT), &gEfiScsiPassThruProtocolGuid, NULL},\r
1550 {STRING_TOKEN(STR_SCSI_IO), &gEfiScsiIoProtocolGuid, NULL},\r
1551 {STRING_TOKEN(STR_SCSI_PT_EXT), &gEfiExtScsiPassThruProtocolGuid, NULL},\r
1552 {STRING_TOKEN(STR_ISCSI), &gEfiIScsiInitiatorNameProtocolGuid, NULL},\r
1553 {STRING_TOKEN(STR_USB_IO), &gEfiUsbIoProtocolGuid, NULL},\r
1554 {STRING_TOKEN(STR_USB_HC), &gEfiUsbHcProtocolGuid, NULL},\r
1555 {STRING_TOKEN(STR_USB_HC2), &gEfiUsb2HcProtocolGuid, NULL},\r
1556 {STRING_TOKEN(STR_DEBUG_SUPPORT), &gEfiDebugSupportProtocolGuid, NULL},\r
1557 {STRING_TOKEN(STR_DEBUG_PORT), &gEfiDebugPortProtocolGuid, NULL},\r
1558 {STRING_TOKEN(STR_DECOMPRESS), &gEfiDecompressProtocolGuid, NULL},\r
1559 {STRING_TOKEN(STR_ACPI_TABLE), &gEfiAcpiTableProtocolGuid, NULL},\r
1560 {STRING_TOKEN(STR_EBC_INTERPRETER), &gEfiEbcProtocolGuid, NULL},\r
1561 {STRING_TOKEN(STR_SNP), &gEfiSimpleNetworkProtocolGuid, NULL},\r
1562 {STRING_TOKEN(STR_NII), &gEfiNetworkInterfaceIdentifierProtocolGuid, NULL},\r
1563 {STRING_TOKEN(STR_NII_31), &gEfiNetworkInterfaceIdentifierProtocolGuid_31, NULL},\r
1564 {STRING_TOKEN(STR_PXE_BC), &gEfiPxeBaseCodeProtocolGuid, NULL},\r
1565 {STRING_TOKEN(STR_PXE_CB), &gEfiPxeBaseCodeCallbackProtocolGuid, NULL},\r
1566 {STRING_TOKEN(STR_BIS), &gEfiBisProtocolGuid, NULL},\r
1567 {STRING_TOKEN(STR_MNP_SB), &gEfiManagedNetworkServiceBindingProtocolGuid, NULL},\r
1568 {STRING_TOKEN(STR_MNP), &gEfiManagedNetworkProtocolGuid, NULL},\r
1569 {STRING_TOKEN(STR_ARP_SB), &gEfiArpServiceBindingProtocolGuid, NULL},\r
1570 {STRING_TOKEN(STR_ARP), &gEfiArpProtocolGuid, NULL},\r
1571 {STRING_TOKEN(STR_DHCPV4_SB), &gEfiDhcp4ServiceBindingProtocolGuid, NULL},\r
1572 {STRING_TOKEN(STR_DHCPV4), &gEfiDhcp4ProtocolGuid, NULL},\r
1573 {STRING_TOKEN(STR_TCPV4_SB), &gEfiTcp4ServiceBindingProtocolGuid, NULL},\r
1574 {STRING_TOKEN(STR_TCPV4), &gEfiTcp4ProtocolGuid, NULL},\r
1575 {STRING_TOKEN(STR_IPV4_SB), &gEfiIp4ServiceBindingProtocolGuid, NULL},\r
1576 {STRING_TOKEN(STR_IPV4), &gEfiIp4ProtocolGuid, NULL},\r
1577 {STRING_TOKEN(STR_IPV4_CFG), &gEfiIp4ConfigProtocolGuid, NULL},\r
00a6ad1b 1578 {STRING_TOKEN(STR_IPV4_CFG2), &gEfiIp4Config2ProtocolGuid, NULL},\r
a405b86d 1579 {STRING_TOKEN(STR_UDPV4_SB), &gEfiUdp4ServiceBindingProtocolGuid, NULL},\r
1580 {STRING_TOKEN(STR_UDPV4), &gEfiUdp4ProtocolGuid, NULL},\r
1581 {STRING_TOKEN(STR_MTFTPV4_SB), &gEfiMtftp4ServiceBindingProtocolGuid, NULL},\r
1582 {STRING_TOKEN(STR_MTFTPV4), &gEfiMtftp4ProtocolGuid, NULL},\r
1583 {STRING_TOKEN(STR_AUTH_INFO), &gEfiAuthenticationInfoProtocolGuid, NULL},\r
1584 {STRING_TOKEN(STR_HASH_SB), &gEfiHashServiceBindingProtocolGuid, NULL},\r
1585 {STRING_TOKEN(STR_HASH), &gEfiHashProtocolGuid, NULL},\r
1586 {STRING_TOKEN(STR_HII_FONT), &gEfiHiiFontProtocolGuid, NULL},\r
1587 {STRING_TOKEN(STR_HII_STRING), &gEfiHiiStringProtocolGuid, NULL},\r
1588 {STRING_TOKEN(STR_HII_IMAGE), &gEfiHiiImageProtocolGuid, NULL},\r
1589 {STRING_TOKEN(STR_HII_DATABASE), &gEfiHiiDatabaseProtocolGuid, NULL},\r
1590 {STRING_TOKEN(STR_HII_CONFIG_ROUT), &gEfiHiiConfigRoutingProtocolGuid, NULL},\r
1591 {STRING_TOKEN(STR_HII_CONFIG_ACC), &gEfiHiiConfigAccessProtocolGuid, NULL},\r
1592 {STRING_TOKEN(STR_HII_FORM_BROWSER2), &gEfiFormBrowser2ProtocolGuid, NULL},\r
dee34318 1593 {STRING_TOKEN(STR_DRIVER_FAM_OVERRIDE), &gEfiDriverFamilyOverrideProtocolGuid, NULL},\r
1594 {STRING_TOKEN(STR_PCD), &gPcdProtocolGuid, NULL},\r
1595 {STRING_TOKEN(STR_TCG), &gEfiTcgProtocolGuid, NULL},\r
1596 {STRING_TOKEN(STR_HII_PACKAGE_LIST), &gEfiHiiPackageListProtocolGuid, NULL},\r
1597\r
1598//\r
1599// the ones under this are deprecated by the current UEFI Spec, but may be found anyways...\r
1600//\r
a405b86d 1601 {STRING_TOKEN(STR_SHELL_INTERFACE), &gEfiShellInterfaceGuid, NULL},\r
1602 {STRING_TOKEN(STR_SHELL_ENV2), &gEfiShellEnvironment2Guid, NULL},\r
1603 {STRING_TOKEN(STR_SHELL_ENV), &gEfiShellEnvironment2Guid, NULL},\r
1604 {STRING_TOKEN(STR_DEVICE_IO), &gEfiDeviceIoProtocolGuid, NULL},\r
1605 {STRING_TOKEN(STR_UGA_DRAW), &gEfiUgaDrawProtocolGuid, NULL},\r
1606 {STRING_TOKEN(STR_UGA_IO), &gEfiUgaIoProtocolGuid, NULL},\r
1607 {STRING_TOKEN(STR_ESP), &gEfiPartTypeSystemPartGuid, NULL},\r
1608 {STRING_TOKEN(STR_GPT_NBR), &gEfiPartTypeLegacyMbrGuid, NULL},\r
1609 {STRING_TOKEN(STR_DRIVER_CONFIG), &gEfiDriverConfigurationProtocolGuid, NULL},\r
1610 {STRING_TOKEN(STR_DRIVER_CONFIG2), &gEfiDriverConfiguration2ProtocolGuid, NULL},\r
2c23ddaa 1611\r
1612//\r
1613// these are using local (non-global) definitions to reduce package dependancy.\r
1614//\r
1615 {STRING_TOKEN(STR_ISA_IO), (EFI_GUID*)&EfiIsaIoProtocolGuid, NULL},\r
1616 {STRING_TOKEN(STR_ISA_ACPI), (EFI_GUID*)&EfiIsaAcpiProtocolGuid, NULL},\r
dee34318 1617\r
1618//\r
1619// the ones under this are GUID identified structs, not protocols\r
1620//\r
1621 {STRING_TOKEN(STR_FILE_INFO), &gEfiFileInfoGuid, NULL},\r
1622 {STRING_TOKEN(STR_FILE_SYS_INFO), &gEfiFileSystemInfoGuid, NULL},\r
1623\r
1624//\r
1625// the ones under this are misc GUIDS.\r
1626//\r
1627 {STRING_TOKEN(STR_EFI_GLOBAL_VARIABLE), &gEfiGlobalVariableGuid, NULL},\r
1628\r
1629//\r
1630// UEFI 2.2\r
1631//\r
1632 {STRING_TOKEN(STR_IP6_SB), &gEfiIp6ServiceBindingProtocolGuid, NULL},\r
1633 {STRING_TOKEN(STR_IP6), &gEfiIp6ProtocolGuid, NULL},\r
1634 {STRING_TOKEN(STR_IP6_CONFIG), &gEfiIp6ConfigProtocolGuid, NULL},\r
1635 {STRING_TOKEN(STR_MTFTP6_SB), &gEfiMtftp6ServiceBindingProtocolGuid, NULL},\r
1636 {STRING_TOKEN(STR_MTFTP6), &gEfiMtftp6ProtocolGuid, NULL},\r
1637 {STRING_TOKEN(STR_DHCP6_SB), &gEfiDhcp6ServiceBindingProtocolGuid, NULL},\r
1638 {STRING_TOKEN(STR_DHCP6), &gEfiDhcp6ProtocolGuid, NULL},\r
1639 {STRING_TOKEN(STR_UDP6_SB), &gEfiUdp6ServiceBindingProtocolGuid, NULL},\r
1640 {STRING_TOKEN(STR_UDP6), &gEfiUdp6ProtocolGuid, NULL},\r
1641 {STRING_TOKEN(STR_TCP6_SB), &gEfiTcp6ServiceBindingProtocolGuid, NULL},\r
1642 {STRING_TOKEN(STR_TCP6), &gEfiTcp6ProtocolGuid, NULL},\r
1643 {STRING_TOKEN(STR_VLAN_CONFIG), &gEfiVlanConfigProtocolGuid, NULL},\r
1644 {STRING_TOKEN(STR_EAP), &gEfiEapProtocolGuid, NULL},\r
1645 {STRING_TOKEN(STR_EAP_MGMT), &gEfiEapManagementProtocolGuid, NULL},\r
1646 {STRING_TOKEN(STR_FTP4_SB), &gEfiFtp4ServiceBindingProtocolGuid, NULL},\r
1647 {STRING_TOKEN(STR_FTP4), &gEfiFtp4ProtocolGuid, NULL},\r
1648 {STRING_TOKEN(STR_IP_SEC_CONFIG), &gEfiIpSecConfigProtocolGuid, NULL},\r
1649 {STRING_TOKEN(STR_DH), &gEfiDriverHealthProtocolGuid, NULL},\r
1650 {STRING_TOKEN(STR_DEF_IMG_LOAD), &gEfiDeferredImageLoadProtocolGuid, NULL},\r
1651 {STRING_TOKEN(STR_USER_CRED), &gEfiUserCredentialProtocolGuid, NULL},\r
1652 {STRING_TOKEN(STR_USER_MNGR), &gEfiUserManagerProtocolGuid, NULL},\r
1653 {STRING_TOKEN(STR_ATA_PASS_THRU), &gEfiAtaPassThruProtocolGuid, NULL},\r
1654\r
1655//\r
1656// UEFI 2.3\r
1657//\r
8985d612 1658 {STRING_TOKEN(STR_FW_MGMT), &gEfiFirmwareManagementProtocolGuid, FirmwareManagementDumpInformation},\r
dee34318 1659 {STRING_TOKEN(STR_IP_SEC), &gEfiIpSecProtocolGuid, NULL},\r
1660 {STRING_TOKEN(STR_IP_SEC2), &gEfiIpSec2ProtocolGuid, NULL},\r
1661\r
1662//\r
1663// UEFI 2.3.1\r
1664//\r
1665 {STRING_TOKEN(STR_KMS), &gEfiKmsProtocolGuid, NULL},\r
1666 {STRING_TOKEN(STR_BLK_IO2), &gEfiBlockIo2ProtocolGuid, NULL},\r
1667 {STRING_TOKEN(STR_SSC), &gEfiStorageSecurityCommandProtocolGuid, NULL},\r
12f1a36c 1668 {STRING_TOKEN(STR_UCRED2), &gEfiUserCredential2ProtocolGuid, NULL},\r
dee34318 1669\r
28cdb62b
CP		 1670//\r
1671// UEFI 2.4\r
1672//\r
1673 {STRING_TOKEN(STR_DISK_IO2), &gEfiDiskIo2ProtocolGuid, NULL},\r
59febea1 1674 {STRING_TOKEN(STR_ADAPTER_INFO), &gEfiAdapterInformationProtocolGuid, AdapterInformationDumpInformation},\r
28cdb62b 1675\r
6b640b4a
JC		 1676//\r
1677// PI Spec ones\r
1678//\r
1679 {STRING_TOKEN(STR_IDE_CONT_INIT), &gEfiIdeControllerInitProtocolGuid, NULL},\r
4024c116 1680 {STRING_TOKEN(STR_DISK_INFO), &gEfiDiskInfoProtocolGuid, NULL},\r
6b640b4a 1681\r
c2788f1c
JC		 1682//\r
1683// PI Spec 1.0\r
1684//\r
1685 {STRING_TOKEN(STR_BDS_ARCH), &gEfiBdsArchProtocolGuid, NULL},\r
1686 {STRING_TOKEN(STR_CPU_ARCH), &gEfiCpuArchProtocolGuid, NULL},\r
1687 {STRING_TOKEN(STR_MET_ARCH), &gEfiMetronomeArchProtocolGuid, NULL},\r
1688 {STRING_TOKEN(STR_MON_ARCH), &gEfiMonotonicCounterArchProtocolGuid, NULL},\r
1689 {STRING_TOKEN(STR_RTC_ARCH), &gEfiRealTimeClockArchProtocolGuid, NULL},\r
1690 {STRING_TOKEN(STR_RESET_ARCH), &gEfiResetArchProtocolGuid, NULL},\r
1691 {STRING_TOKEN(STR_RT_ARCH), &gEfiRuntimeArchProtocolGuid, NULL},\r
1692 {STRING_TOKEN(STR_SEC_ARCH), &gEfiSecurityArchProtocolGuid, NULL},\r
1693 {STRING_TOKEN(STR_TIMER_ARCH), &gEfiTimerArchProtocolGuid, NULL},\r
1694 {STRING_TOKEN(STR_VAR_ARCH), &gEfiVariableWriteArchProtocolGuid, NULL},\r
1695 {STRING_TOKEN(STR_V_ARCH), &gEfiVariableArchProtocolGuid, NULL},\r
1696 {STRING_TOKEN(STR_SECP), &gEfiSecurityPolicyProtocolGuid, NULL},\r
1697 {STRING_TOKEN(STR_WDT_ARCH), &gEfiWatchdogTimerArchProtocolGuid, NULL},\r
1698 {STRING_TOKEN(STR_SCR), &gEfiStatusCodeRuntimeProtocolGuid, NULL},\r
1699 {STRING_TOKEN(STR_SMB_HC), &gEfiSmbusHcProtocolGuid, NULL},\r
1700 {STRING_TOKEN(STR_FV_2), &gEfiFirmwareVolume2ProtocolGuid, NULL},\r
1701 {STRING_TOKEN(STR_FV_BLOCK), &gEfiFirmwareVolumeBlockProtocolGuid, NULL},\r
1702 {STRING_TOKEN(STR_CAP_ARCH), &gEfiCapsuleArchProtocolGuid, NULL},\r
1703 {STRING_TOKEN(STR_MP_SERVICE), &gEfiMpServiceProtocolGuid, NULL},\r
1704 {STRING_TOKEN(STR_HBRAP), &gEfiPciHostBridgeResourceAllocationProtocolGuid, NULL},\r
1705 {STRING_TOKEN(STR_PCIP), &gEfiPciPlatformProtocolGuid, NULL},\r
1706 {STRING_TOKEN(STR_PCIO), &gEfiPciOverrideProtocolGuid, NULL},\r
1707 {STRING_TOKEN(STR_PCIE), &gEfiPciEnumerationCompleteProtocolGuid, NULL},\r
1708 {STRING_TOKEN(STR_IPCID), &gEfiIncompatiblePciDeviceSupportProtocolGuid, NULL},\r
1709 {STRING_TOKEN(STR_PCIHPI), &gEfiPciHotPlugInitProtocolGuid, NULL},\r
1710 {STRING_TOKEN(STR_PCIHPR), &gEfiPciHotPlugRequestProtocolGuid, NULL},\r
1711 {STRING_TOKEN(STR_SMBIOS), &gEfiSmbiosProtocolGuid, NULL},\r
1712 {STRING_TOKEN(STR_S3_SAVE), &gEfiS3SaveStateProtocolGuid, NULL},\r
1713 {STRING_TOKEN(STR_S3_S_SMM), &gEfiS3SmmSaveStateProtocolGuid, NULL},\r
1714 {STRING_TOKEN(STR_RSC), &gEfiRscHandlerProtocolGuid, NULL},\r
1715 {STRING_TOKEN(STR_S_RSC), &gEfiSmmRscHandlerProtocolGuid, NULL},\r
1716 {STRING_TOKEN(STR_ACPI_SDT), &gEfiAcpiSdtProtocolGuid, NULL},\r
1717 {STRING_TOKEN(STR_SIO), &gEfiSioProtocolGuid, NULL},\r
1718 {STRING_TOKEN(STR_S_CPU2), &gEfiSmmCpuIo2ProtocolGuid, NULL},\r
1719 {STRING_TOKEN(STR_S_BASE2), &gEfiSmmBase2ProtocolGuid, NULL},\r
1720 {STRING_TOKEN(STR_S_ACC_2), &gEfiSmmAccess2ProtocolGuid, NULL},\r
1721 {STRING_TOKEN(STR_S_CON_2), &gEfiSmmControl2ProtocolGuid, NULL},\r
1722 {STRING_TOKEN(STR_S_CONFIG), &gEfiSmmConfigurationProtocolGuid, NULL},\r
1723 {STRING_TOKEN(STR_S_RTL), &gEfiSmmReadyToLockProtocolGuid, NULL},\r
1724 {STRING_TOKEN(STR_DS_RTL), &gEfiDxeSmmReadyToLockProtocolGuid, NULL},\r
1725 {STRING_TOKEN(STR_S_COMM), &gEfiSmmCommunicationProtocolGuid, NULL},\r
1726 {STRING_TOKEN(STR_S_STAT), &gEfiSmmStatusCodeProtocolGuid, NULL},\r
1727 {STRING_TOKEN(STR_S_CPU), &gEfiSmmCpuProtocolGuid, NULL},\r
1728 {STRING_TOKEN(STR_S_PCIRBIO), &gEfiPciRootBridgeIoProtocolGuid, NULL},\r
1729 {STRING_TOKEN(STR_S_SWD), &gEfiSmmSwDispatch2ProtocolGuid, NULL},\r
1730 {STRING_TOKEN(STR_S_SXD), &gEfiSmmSxDispatch2ProtocolGuid, NULL},\r
1731 {STRING_TOKEN(STR_S_PTD2), &gEfiSmmPeriodicTimerDispatch2ProtocolGuid, NULL},\r
1732 {STRING_TOKEN(STR_S_UD2), &gEfiSmmUsbDispatch2ProtocolGuid, NULL},\r
1733 {STRING_TOKEN(STR_S_GD2), &gEfiSmmGpiDispatch2ProtocolGuid, NULL},\r
1734 {STRING_TOKEN(STR_S_SBD2), &gEfiSmmStandbyButtonDispatch2ProtocolGuid, NULL},\r
1735 {STRING_TOKEN(STR_S_PBD2), &gEfiSmmPowerButtonDispatch2ProtocolGuid, NULL},\r
1736 {STRING_TOKEN(STR_S_ITD2), &gEfiSmmIoTrapDispatch2ProtocolGuid, NULL},\r
1737 {STRING_TOKEN(STR_PCD), &gEfiPcdProtocolGuid, NULL},\r
1738 {STRING_TOKEN(STR_FVB2), &gEfiFirmwareVolumeBlock2ProtocolGuid, NULL},\r
1739 {STRING_TOKEN(STR_CPUIO2), &gEfiCpuIo2ProtocolGuid, NULL},\r
1740 {STRING_TOKEN(STR_LEGACY_R2), &gEfiLegacyRegion2ProtocolGuid, NULL},\r
1741 {STRING_TOKEN(STR_SAL_MIP), &gEfiSalMcaInitPmiProtocolGuid, NULL},\r
1742 {STRING_TOKEN(STR_ES_BS), &gEfiExtendedSalBootServiceProtocolGuid, NULL},\r
1743 {STRING_TOKEN(STR_ES_BIO), &gEfiExtendedSalBaseIoServicesProtocolGuid, NULL},\r
1744 {STRING_TOKEN(STR_ES_STALL), &gEfiExtendedSalStallServicesProtocolGuid, NULL},\r
1745 {STRING_TOKEN(STR_ES_RTC), &gEfiExtendedSalRtcServicesProtocolGuid, NULL},\r
1746 {STRING_TOKEN(STR_ES_VS), &gEfiExtendedSalVariableServicesProtocolGuid, NULL},\r
1747 {STRING_TOKEN(STR_ES_MTC), &gEfiExtendedSalMtcServicesProtocolGuid, NULL},\r
1748 {STRING_TOKEN(STR_ES_RESET), &gEfiExtendedSalResetServicesProtocolGuid, NULL},\r
1749 {STRING_TOKEN(STR_ES_SC), &gEfiExtendedSalStatusCodeServicesProtocolGuid, NULL},\r
1750 {STRING_TOKEN(STR_ES_FBS), &gEfiExtendedSalFvBlockServicesProtocolGuid, NULL},\r
1751 {STRING_TOKEN(STR_ES_MP), &gEfiExtendedSalMpServicesProtocolGuid, NULL},\r
1752 {STRING_TOKEN(STR_ES_PAL), &gEfiExtendedSalPalServicesProtocolGuid, NULL},\r
1753 {STRING_TOKEN(STR_ES_BASE), &gEfiExtendedSalBaseServicesProtocolGuid, NULL},\r
1754 {STRING_TOKEN(STR_ES_MCA), &gEfiExtendedSalMcaServicesProtocolGuid, NULL},\r
1755 {STRING_TOKEN(STR_ES_PCI), &gEfiExtendedSalPciServicesProtocolGuid, NULL},\r
1756 {STRING_TOKEN(STR_ES_CACHE), &gEfiExtendedSalCacheServicesProtocolGuid, NULL},\r
1757 {STRING_TOKEN(STR_ES_MCA_LOG), &gEfiExtendedSalMcaLogServicesProtocolGuid, NULL},\r
1758 {STRING_TOKEN(STR_S2ARCH), &gEfiSecurity2ArchProtocolGuid, NULL},\r
1759 {STRING_TOKEN(STR_EODXE), &gEfiSmmEndOfDxeProtocolGuid, NULL},\r
1760 {STRING_TOKEN(STR_ISAHC), &gEfiIsaHcProtocolGuid, NULL},\r
1761 {STRING_TOKEN(STR_ISAHC_B), &gEfiIsaHcServiceBindingProtocolGuid, NULL},\r
1762 {STRING_TOKEN(STR_SIO_C), &gEfiSioControlProtocolGuid, NULL},\r
1763 {STRING_TOKEN(STR_GET_PCD), &gEfiGetPcdInfoProtocolGuid, NULL},\r
1764 {STRING_TOKEN(STR_I2C_M), &gEfiI2cMasterProtocolGuid, NULL},\r
1765 {STRING_TOKEN(STR_I2CIO), &gEfiI2cIoProtocolGuid, NULL},\r
1766 {STRING_TOKEN(STR_I2CEN), &gEfiI2cEnumerateProtocolGuid, NULL},\r
1767 {STRING_TOKEN(STR_I2C_H), &gEfiI2cHostProtocolGuid, NULL},\r
1768 {STRING_TOKEN(STR_I2C_BCM), &gEfiI2cBusConfigurationManagementProtocolGuid, NULL},\r
1769 {STRING_TOKEN(STR_TREE), &gEfiTrEEProtocolGuid, NULL},\r
1770 {STRING_TOKEN(STR_TCG2), &gEfiTcg2ProtocolGuid, NULL},\r
1771 {STRING_TOKEN(STR_TIMESTAMP), &gEfiTimestampProtocolGuid, NULL},\r
1772 {STRING_TOKEN(STR_RNG), &gEfiRngProtocolGuid, NULL},\r
1773 {STRING_TOKEN(STR_NVMEPT), &gEfiNvmExpressPassThruProtocolGuid, NULL},\r
1774 {STRING_TOKEN(STR_H2_SB), &gEfiHash2ServiceBindingProtocolGuid, NULL},\r
1775 {STRING_TOKEN(STR_HASH2), &gEfiHash2ProtocolGuid, NULL},\r
1776 {STRING_TOKEN(STR_BIO_C), &gEfiBlockIoCryptoProtocolGuid, NULL},\r
1777 {STRING_TOKEN(STR_SCR), &gEfiSmartCardReaderProtocolGuid, NULL},\r
1778 {STRING_TOKEN(STR_SCE), &gEfiSmartCardEdgeProtocolGuid, NULL},\r
1779 {STRING_TOKEN(STR_USB_FIO), &gEfiUsbFunctionIoProtocolGuid, NULL},\r
1780 {STRING_TOKEN(STR_BC_HC), &gEfiBluetoothHcProtocolGuid, NULL},\r
1781 {STRING_TOKEN(STR_BC_IO_SB), &gEfiBluetoothIoServiceBindingProtocolGuid, NULL},\r
1782 {STRING_TOKEN(STR_BC_IO), &gEfiBluetoothIoProtocolGuid, NULL},\r
1783 {STRING_TOKEN(STR_BC_C), &gEfiBluetoothConfigProtocolGuid, NULL},\r
1784 {STRING_TOKEN(STR_REG_EXP), &gEfiRegularExpressionProtocolGuid, NULL},\r
1785 {STRING_TOKEN(STR_B_MGR_P), &gEfiBootManagerPolicyProtocolGuid, NULL},\r
1786 {STRING_TOKEN(STR_CKH), &gEfiConfigKeywordHandlerProtocolGuid, NULL},\r
1787 {STRING_TOKEN(STR_WIFI), &gEfiWiFiProtocolGuid, NULL},\r
1788 {STRING_TOKEN(STR_EAP_M), &gEfiEapManagement2ProtocolGuid, NULL},\r
1789 {STRING_TOKEN(STR_EAP_C), &gEfiEapConfigurationProtocolGuid, NULL},\r
1790 {STRING_TOKEN(STR_PKCS7), &gEfiPkcs7VerifyProtocolGuid, NULL},\r
1791 {STRING_TOKEN(STR_NET_DNS4_SB), &gEfiDns4ServiceBindingProtocolGuid, NULL},\r
1792 {STRING_TOKEN(STR_NET_DNS4), &gEfiDns4ProtocolGuid, NULL},\r
1793 {STRING_TOKEN(STR_NET_DNS6_SB), &gEfiDns6ServiceBindingProtocolGuid, NULL},\r
1794 {STRING_TOKEN(STR_NET_DNS6), &gEfiDns6ProtocolGuid, NULL},\r
1795 {STRING_TOKEN(STR_NET_HTTP_SB), &gEfiHttpServiceBindingProtocolGuid, NULL},\r
1796 {STRING_TOKEN(STR_NET_HTTP), &gEfiHttpProtocolGuid, NULL},\r
1797 {STRING_TOKEN(STR_NET_HTTP_U), &gEfiHttpUtilitiesProtocolGuid, NULL},\r
1798 {STRING_TOKEN(STR_REST), &gEfiRestProtocolGuid, NULL},\r
1799\r
0a1eb97d
JC		 1800//\r
1801// UEFI Shell Spec 2.0\r
1802//\r
1803 {STRING_TOKEN(STR_SHELL_PARAMETERS), &gEfiShellParametersProtocolGuid, NULL},\r
1804 {STRING_TOKEN(STR_SHELL), &gEfiShellProtocolGuid, NULL},\r
1805\r
1806//\r
1807// UEFI Shell Spec 2.1\r
1808//\r
1809 {STRING_TOKEN(STR_SHELL_DYNAMIC), &gEfiShellDynamicCommandProtocolGuid, NULL},\r
1810\r
c2788f1c
JC		 1811//\r
1812// Misc\r
1813//\r
1814 {STRING_TOKEN(STR_PCDINFOPROT), &gGetPcdInfoProtocolGuid, NULL},\r
1815\r
dee34318 1816//\r
1817// terminator\r
1818//\r
a405b86d 1819 {STRING_TOKEN(STR_UNKNOWN_DEVICE), NULL, NULL},\r
1820};\r
1821\r
1822/**\r
1823 Function to get the node for a protocol or struct from it's GUID.\r
1824\r
1825 if Guid is NULL, then ASSERT.\r
1826\r
1827 @param[in] Guid The GUID to look for the name of.\r
1828\r
1829 @return The node.\r
1830**/\r
dee34318 1831CONST GUID_INFO_BLOCK *\r
a405b86d 1832InternalShellGetNodeFromGuid(\r
1833 IN CONST EFI_GUID* Guid\r
1834 )\r
1835{\r
dee34318 1836 CONST GUID_INFO_BLOCK *ListWalker;\r
6306fd90 1837 UINTN LoopCount;\r
a405b86d 1838\r
1839 ASSERT(Guid != NULL);\r
1840\r
d4ec9a57 1841 for (LoopCount = 0, ListWalker = mGuidList; mGuidList != NULL && LoopCount < mGuidListCount; LoopCount++, ListWalker++) {\r
6306fd90
JC		 1842 if (CompareGuid(ListWalker->GuidId, Guid)) {\r
1843 return (ListWalker);\r
1844 }\r
1845 }\r
1846\r
a405b86d 1847 if (PcdGetBool(PcdShellIncludeNtGuids)) {\r
1848 for (ListWalker = mGuidStringListNT ; ListWalker != NULL && ListWalker->GuidId != NULL ; ListWalker++) {\r
1849 if (CompareGuid(ListWalker->GuidId, Guid)) {\r
1850 return (ListWalker);\r
1851 }\r
1852 }\r
1853 }\r
1854 for (ListWalker = mGuidStringList ; ListWalker != NULL && ListWalker->GuidId != NULL ; ListWalker++) {\r
1855 if (CompareGuid(ListWalker->GuidId, Guid)) {\r
1856 return (ListWalker);\r
1857 }\r
1858 }\r
6306fd90
JC		 1859 return (NULL);\r
1860}\r
1861\r
1862/**\r
1863Function to add a new GUID/Name mapping.\r
1864\r
1865@param[in] Guid The Guid\r
f5ba4007
QS		 1866@param[in] NameID The STRING id of the HII string to use\r
1867@param[in] DumpFunc The pointer to the dump function\r
6306fd90
JC		 1868\r
1869\r
1870@retval EFI_SUCCESS The operation was sucessful\r
1871@retval EFI_OUT_OF_RESOURCES A memory allocation failed\r
1872@retval EFI_INVALID_PARAMETER Guid NameId was invalid\r
1873**/\r
6306fd90 1874EFI_STATUS\r
6306fd90
JC		 1875InsertNewGuidNameMapping(\r
1876 IN CONST EFI_GUID *Guid,\r
1877 IN CONST EFI_STRING_ID NameID,\r
1878 IN CONST DUMP_PROTOCOL_INFO DumpFunc OPTIONAL\r
1879 )\r
1880{\r
1881 ASSERT(Guid != NULL);\r
1882 ASSERT(NameID != 0);\r
1883\r
d4ec9a57
RN		 1884 mGuidList = ReallocatePool(mGuidListCount * sizeof(GUID_INFO_BLOCK), mGuidListCount+1 * sizeof(GUID_INFO_BLOCK), mGuidList);\r
1885 if (mGuidList == NULL) {\r
1886 mGuidListCount = 0;\r
6306fd90
JC		 1887 return (EFI_OUT_OF_RESOURCES);\r
1888 }\r
d4ec9a57 1889 mGuidListCount++;\r
6306fd90 1890\r
d4ec9a57
RN		 1891 mGuidList[mGuidListCount - 1].GuidId = AllocateCopyPool(sizeof(EFI_GUID), Guid);\r
1892 mGuidList[mGuidListCount - 1].StringId = NameID;\r
1893 mGuidList[mGuidListCount - 1].DumpInfo = DumpFunc;\r
6306fd90 1894\r
d4ec9a57 1895 if (mGuidList[mGuidListCount - 1].GuidId == NULL) {\r
6306fd90
JC		 1896 return (EFI_OUT_OF_RESOURCES);\r
1897 }\r
1898\r
1899 return (EFI_SUCCESS);\r
1900}\r
1901\r
1902/**\r
1903 Function to add a new GUID/Name mapping.\r
1904\r
1905 This cannot overwrite an existing mapping.\r
1906\r
1907 @param[in] Guid The Guid\r
1908 @param[in] TheName The Guid's name\r
1909 @param[in] Lang RFC4646 language code list or NULL\r
1910\r
1911 @retval EFI_SUCCESS The operation was sucessful\r
1912 @retval EFI_ACCESS_DENIED There was a duplicate\r
1913 @retval EFI_OUT_OF_RESOURCES A memory allocation failed\r
1914 @retval EFI_INVALID_PARAMETER Guid or TheName was NULL\r
1915**/\r
1916EFI_STATUS\r
1917EFIAPI\r
1918AddNewGuidNameMapping(\r
1919 IN CONST EFI_GUID *Guid,\r
1920 IN CONST CHAR16 *TheName,\r
1921 IN CONST CHAR8 *Lang OPTIONAL\r
1922 )\r
1923{\r
6306fd90
JC		 1924 EFI_STRING_ID NameID;\r
1925\r
e7e0e42b
CP		 1926 HandleParsingHiiInit();\r
1927\r
6306fd90
JC		 1928 if (Guid == NULL || TheName == NULL){\r
1929 return (EFI_INVALID_PARAMETER);\r
1930 }\r
1931\r
931b2cff 1932 if ((InternalShellGetNodeFromGuid(Guid)) != NULL) {\r
6306fd90
JC		 1933 return (EFI_ACCESS_DENIED);\r
1934 }\r
1935\r
1936 NameID = HiiSetString(mHandleParsingHiiHandle, 0, (CHAR16*)TheName, Lang);\r
1937 if (NameID == 0) {\r
1938 return (EFI_OUT_OF_RESOURCES);\r
1939 }\r
1940\r
1941 return (InsertNewGuidNameMapping(Guid, NameID, NULL));\r
a405b86d 1942}\r
1943\r
1944/**\r
1945 Function to get the name of a protocol or struct from it's GUID.\r
1946\r
1947 if Guid is NULL, then ASSERT.\r
1948\r
1949 @param[in] Guid The GUID to look for the name of.\r
1950 @param[in] Lang The language to use.\r
1951\r
1952 @return pointer to string of the name. The caller\r
1953 is responsible to free this memory.\r
1954**/\r
1955CHAR16*\r
1956EFIAPI\r
1957GetStringNameFromGuid(\r
1958 IN CONST EFI_GUID *Guid,\r
1959 IN CONST CHAR8 *Lang OPTIONAL\r
1960 )\r
1961{\r
dee34318 1962 CONST GUID_INFO_BLOCK *Id;\r
a405b86d 1963\r
e7e0e42b
CP		 1964 HandleParsingHiiInit();\r
1965\r
a405b86d 1966 Id = InternalShellGetNodeFromGuid(Guid);\r
6306fd90 1967 return (HiiGetString(mHandleParsingHiiHandle, Id==NULL?STRING_TOKEN(STR_UNKNOWN_DEVICE):Id->StringId, Lang));\r
a405b86d 1968}\r
1969\r
1970/**\r
1971 Function to dump protocol information from a handle.\r
1972\r
1973 This function will return a allocated string buffer containing the\r
1974 information. The caller is responsible for freeing the memory.\r
1975\r
1976 If Guid is NULL, ASSERT().\r
1977 If TheHandle is NULL, ASSERT().\r
1978\r
1979 @param[in] TheHandle The handle to dump information from.\r
1980 @param[in] Guid The GUID of the protocol to dump.\r
1981 @param[in] Verbose TRUE for extra info. FALSE otherwise.\r
1982\r
1983 @return The pointer to string.\r
1984 @retval NULL An error was encountered.\r
1985**/\r
1986CHAR16*\r
1987EFIAPI\r
1988GetProtocolInformationDump(\r
1989 IN CONST EFI_HANDLE TheHandle,\r
1990 IN CONST EFI_GUID *Guid,\r
1991 IN CONST BOOLEAN Verbose\r
1992 )\r
1993{\r
dee34318 1994 CONST GUID_INFO_BLOCK *Id;\r
a405b86d 1995\r
1996 ASSERT(TheHandle != NULL);\r
1997 ASSERT(Guid != NULL);\r
1998\r
1999 if (TheHandle == NULL || Guid == NULL) {\r
2000 return (NULL);\r
2001 }\r
2002\r
2003 Id = InternalShellGetNodeFromGuid(Guid);\r
2004 if (Id != NULL && Id->DumpInfo != NULL) {\r
2005 return (Id->DumpInfo(TheHandle, Verbose));\r
2006 }\r
2007 return (NULL);\r
2008}\r
2009\r
2010/**\r
2011 Function to get the Guid for a protocol or struct based on it's string name.\r
2012\r
0a1eb97d
JC		 2013 do not modify the returned Guid.\r
2014\r
a405b86d 2015 @param[in] Name The pointer to the string name.\r
2016 @param[in] Lang The pointer to the language code.\r
0a1eb97d 2017 @param[out] Guid The pointer to the Guid.\r
a405b86d 2018\r
2019 @retval EFI_SUCCESS The operation was sucessful.\r
2020**/\r
2021EFI_STATUS\r
2022EFIAPI\r
2023GetGuidFromStringName(\r
2024 IN CONST CHAR16 *Name,\r
2025 IN CONST CHAR8 *Lang OPTIONAL,\r
0a1eb97d 2026 OUT EFI_GUID **Guid\r
a405b86d 2027 )\r
2028{\r
dee34318 2029 CONST GUID_INFO_BLOCK *ListWalker;\r
a405b86d 2030 CHAR16 *String;\r
6306fd90 2031 UINTN LoopCount;\r
a405b86d 2032\r
e7e0e42b
CP		 2033 HandleParsingHiiInit();\r
2034\r
a405b86d 2035 ASSERT(Guid != NULL);\r
2036 if (Guid == NULL) {\r
2037 return (EFI_INVALID_PARAMETER);\r
2038 }\r
2039 *Guid = NULL;\r
2040\r
2041 if (PcdGetBool(PcdShellIncludeNtGuids)) {\r
2042 for (ListWalker = mGuidStringListNT ; ListWalker != NULL && ListWalker->GuidId != NULL ; ListWalker++) {\r
2043 String = HiiGetString(mHandleParsingHiiHandle, ListWalker->StringId, Lang);\r
28cdb62b 2044 if (Name != NULL && String != NULL && StringNoCaseCompare (&Name, &String) == 0) {\r
a405b86d 2045 *Guid = ListWalker->GuidId;\r
2046 }\r
2047 SHELL_FREE_NON_NULL(String);\r
2048 if (*Guid != NULL) {\r
2049 return (EFI_SUCCESS);\r
2050 }\r
2051 }\r
2052 }\r
2053 for (ListWalker = mGuidStringList ; ListWalker != NULL && ListWalker->GuidId != NULL ; ListWalker++) {\r
2054 String = HiiGetString(mHandleParsingHiiHandle, ListWalker->StringId, Lang);\r
28cdb62b 2055 if (Name != NULL && String != NULL && StringNoCaseCompare (&Name, &String) == 0) {\r
a405b86d 2056 *Guid = ListWalker->GuidId;\r
2057 }\r
2058 SHELL_FREE_NON_NULL(String);\r
2059 if (*Guid != NULL) {\r
2060 return (EFI_SUCCESS);\r
2061 }\r
2062 }\r
6306fd90 2063\r
d4ec9a57 2064 for (LoopCount = 0, ListWalker = mGuidList; mGuidList != NULL && LoopCount < mGuidListCount; LoopCount++, ListWalker++) {\r
6306fd90
JC		 2065 String = HiiGetString(mHandleParsingHiiHandle, ListWalker->StringId, Lang);\r
2066 if (Name != NULL && String != NULL && StringNoCaseCompare (&Name, &String) == 0) {\r
2067 *Guid = ListWalker->GuidId;\r
2068 }\r
2069 SHELL_FREE_NON_NULL(String);\r
2070 if (*Guid != NULL) {\r
2071 return (EFI_SUCCESS);\r
2072 }\r
2073 }\r
2074\r
a405b86d 2075 return (EFI_NOT_FOUND);\r
2076}\r
2077\r
36384ceb
ED		 2078/**\r
2079 Get best support language for this driver.\r
1a6f74d9
CS		 2080\r
2081 First base on the user input language to search, second base on the current\r
2082 platform used language to search, third get the first language from the\r
a71003f2 2083 support language list. The caller need to free the buffer of the best language.\r
36384ceb
ED		 2084\r
2085 @param[in] SupportedLanguages The support languages for this driver.\r
a71003f2 2086 @param[in] InputLanguage The user input language.\r
36384ceb
ED		 2087 @param[in] Iso639Language Whether get language for ISO639.\r
2088\r
2089 @return The best support language for this driver.\r
2090**/\r
2091CHAR8 *\r
a71003f2 2092EFIAPI\r
36384ceb 2093GetBestLanguageForDriver (\r
a71003f2
ED		 2094 IN CONST CHAR8 *SupportedLanguages,\r
2095 IN CONST CHAR8 *InputLanguage,\r
36384ceb
ED		 2096 IN BOOLEAN Iso639Language\r
2097 )\r
2098{\r
2099 CHAR8 *LanguageVariable;\r
2100 CHAR8 *BestLanguage;\r
2101\r
3cdd434e 2102 GetVariable2 (Iso639Language ? L"Lang" : L"PlatformLang", &gEfiGlobalVariableGuid, (VOID**)&LanguageVariable, NULL);\r
36384ceb
ED		 2103\r
2104 BestLanguage = GetBestLanguage(\r
2105 SupportedLanguages,\r
2106 Iso639Language,\r
a71003f2 2107 (InputLanguage != NULL) ? InputLanguage : "",\r
36384ceb 2108 (LanguageVariable != NULL) ? LanguageVariable : "",\r
a71003f2 2109 SupportedLanguages,\r
36384ceb
ED		 2110 NULL\r
2111 );\r
2112\r
2113 if (LanguageVariable != NULL) {\r
2114 FreePool (LanguageVariable);\r
2115 }\r
2116\r
2117 return BestLanguage;\r
2118}\r
2119\r
a405b86d 2120/**\r
2121 Function to retrieve the driver name (if possible) from the ComponentName or\r
2122 ComponentName2 protocol\r
2123\r
2124 @param[in] TheHandle The driver handle to get the name of.\r
2125 @param[in] Language The language to use.\r
2126\r
2127 @retval NULL The name could not be found.\r
2128 @return A pointer to the string name. Do not de-allocate the memory.\r
2129**/\r
2130CONST CHAR16*\r
2131EFIAPI\r
2132GetStringNameFromHandle(\r
2133 IN CONST EFI_HANDLE TheHandle,\r
2134 IN CONST CHAR8 *Language\r
2135 )\r
2136{\r
2137 EFI_COMPONENT_NAME2_PROTOCOL *CompNameStruct;\r
2138 EFI_STATUS Status;\r
2139 CHAR16 *RetVal;\r
36384ceb
ED		 2140 CHAR8 *BestLang;\r
2141\r
2142 BestLang = NULL;\r
a405b86d 2143\r
2144 Status = gBS->OpenProtocol(\r
2145 TheHandle,\r
2146 &gEfiComponentName2ProtocolGuid,\r
2147 (VOID**)&CompNameStruct,\r
2148 gImageHandle,\r
2149 NULL,\r
2150 EFI_OPEN_PROTOCOL_GET_PROTOCOL);\r
2151 if (!EFI_ERROR(Status)) {\r
a71003f2
ED		 2152 BestLang = GetBestLanguageForDriver (CompNameStruct->SupportedLanguages, Language, FALSE);\r
2153 Status = CompNameStruct->GetDriverName(CompNameStruct, BestLang, &RetVal);\r
36384ceb
ED		 2154 if (BestLang != NULL) {\r
2155 FreePool (BestLang);\r
2156 BestLang = NULL;\r
2157 }\r
a405b86d 2158 if (!EFI_ERROR(Status)) {\r
2159 return (RetVal);\r
2160 }\r
2161 }\r
2162 Status = gBS->OpenProtocol(\r
2163 TheHandle,\r
2164 &gEfiComponentNameProtocolGuid,\r
2165 (VOID**)&CompNameStruct,\r
2166 gImageHandle,\r
2167 NULL,\r
2168 EFI_OPEN_PROTOCOL_GET_PROTOCOL);\r
2169 if (!EFI_ERROR(Status)) {\r
a71003f2
ED		 2170 BestLang = GetBestLanguageForDriver (CompNameStruct->SupportedLanguages, Language, FALSE);\r
2171 Status = CompNameStruct->GetDriverName(CompNameStruct, BestLang, &RetVal);\r
36384ceb
ED		 2172 if (BestLang != NULL) {\r
2173 FreePool (BestLang);\r
2174 }\r
a405b86d 2175 if (!EFI_ERROR(Status)) {\r
2176 return (RetVal);\r
2177 }\r
2178 }\r
2179 return (NULL);\r
2180}\r
2181\r
2182/**\r
2183 Function to initialize the file global mHandleList object for use in\r
2184 vonverting handles to index and index to handle.\r
2185\r
2186 @retval EFI_SUCCESS The operation was successful.\r
2187**/\r
2188EFI_STATUS\r
a405b86d 2189InternalShellInitHandleList(\r
2190 VOID\r
2191 )\r
2192{\r
2193 EFI_STATUS Status;\r
2194 EFI_HANDLE *HandleBuffer;\r
2195 UINTN HandleCount;\r
2196 HANDLE_LIST *ListWalker;\r
2197\r
2198 if (mHandleList.NextIndex != 0) {\r
2199 return EFI_SUCCESS;\r
2200 }\r
2201 InitializeListHead(&mHandleList.List.Link);\r
2202 mHandleList.NextIndex = 1;\r
2203 Status = gBS->LocateHandleBuffer (\r
2204 AllHandles,\r
2205 NULL,\r
2206 NULL,\r
2207 &HandleCount,\r
2208 &HandleBuffer\r
2209 );\r
2210 ASSERT_EFI_ERROR(Status);\r
2211 if (EFI_ERROR(Status)) {\r
2212 return (Status);\r
2213 }\r
2214 for (mHandleList.NextIndex = 1 ; mHandleList.NextIndex <= HandleCount ; mHandleList.NextIndex++){\r
78ed876b 2215 ListWalker = AllocateZeroPool(sizeof(HANDLE_LIST));\r
aa3276c1
RN		 2216 if (ListWalker != NULL) {\r
2217 ListWalker->TheHandle = HandleBuffer[mHandleList.NextIndex - 1];\r
2218 ListWalker->TheIndex = mHandleList.NextIndex;\r
2219 InsertTailList (&mHandleList.List.Link, &ListWalker->Link);\r
2220 }\r
a405b86d 2221 }\r
2222 FreePool(HandleBuffer);\r
2223 return (EFI_SUCCESS);\r
2224}\r
2225\r
2226/**\r
2227 Function to retrieve the human-friendly index of a given handle. If the handle\r
2228 does not have a index one will be automatically assigned. The index value is valid\r
2229 until the termination of the shell application.\r
2230\r
2231 @param[in] TheHandle The handle to retrieve an index for.\r
2232\r
2233 @retval 0 A memory allocation failed.\r
2234 @return The index of the handle.\r
2235\r
2236**/\r
2237UINTN\r
2238EFIAPI\r
2239ConvertHandleToHandleIndex(\r
2240 IN CONST EFI_HANDLE TheHandle\r
2241 )\r
2242{\r
f330ff35 2243 EFI_STATUS Status;\r
2244 EFI_GUID **ProtocolBuffer;\r
2245 UINTN ProtocolCount;\r
2246 HANDLE_LIST *ListWalker;\r
2247\r
78ed876b 2248 if (TheHandle == NULL) {\r
2249 return 0;\r
2250 }\r
a405b86d 2251\r
2252 InternalShellInitHandleList();\r
2253\r
2254 for (ListWalker = (HANDLE_LIST*)GetFirstNode(&mHandleList.List.Link)\r
2255 ; !IsNull(&mHandleList.List.Link,&ListWalker->Link)\r
2256 ; ListWalker = (HANDLE_LIST*)GetNextNode(&mHandleList.List.Link,&ListWalker->Link)\r
2257 ){\r
2258 if (ListWalker->TheHandle == TheHandle) {\r
f330ff35 2259 //\r
2260 // Verify that TheHandle is still present in the Handle Database\r
2261 //\r
2262 Status = gBS->ProtocolsPerHandle(TheHandle, &ProtocolBuffer, &ProtocolCount);\r
2263 if (EFI_ERROR (Status)) {\r
2264 //\r
2265 // TheHandle is not present in the Handle Database, so delete from the handle list\r
2266 //\r
2267 RemoveEntryList (&ListWalker->Link);\r
2268 return 0;\r
2269 }\r
2270 FreePool (ProtocolBuffer);\r
a405b86d 2271 return (ListWalker->TheIndex);\r
2272 }\r
2273 }\r
f330ff35 2274\r
2275 //\r
2276 // Verify that TheHandle is valid handle\r
2277 //\r
2278 Status = gBS->ProtocolsPerHandle(TheHandle, &ProtocolBuffer, &ProtocolCount);\r
2279 if (EFI_ERROR (Status)) {\r
2280 //\r
2281 // TheHandle is not valid, so do not add to handle list\r
2282 //\r
2283 return 0;\r
2284 }\r
2285 FreePool (ProtocolBuffer);\r
2286\r
78ed876b 2287 ListWalker = AllocateZeroPool(sizeof(HANDLE_LIST));\r
aa3276c1
RN		 2288 if (ListWalker == NULL) {\r
2289 return 0;\r
2290 }\r
a405b86d 2291 ListWalker->TheHandle = TheHandle;\r
2292 ListWalker->TheIndex = mHandleList.NextIndex++;\r
2293 InsertTailList(&mHandleList.List.Link,&ListWalker->Link);\r
2294 return (ListWalker->TheIndex);\r
2295}\r
2296\r
2297\r
2298\r
2299/**\r
2300 Function to retrieve the EFI_HANDLE from the human-friendly index.\r
2301\r
2302 @param[in] TheIndex The index to retrieve the EFI_HANDLE for.\r
2303\r
2304 @retval NULL The index was invalid.\r
2305 @return The EFI_HANDLE that index represents.\r
2306\r
2307**/\r
2308EFI_HANDLE\r
2309EFIAPI\r
2310ConvertHandleIndexToHandle(\r
2311 IN CONST UINTN TheIndex\r
2312 )\r
2313{\r
f330ff35 2314 EFI_STATUS Status;\r
2315 EFI_GUID **ProtocolBuffer;\r
2316 UINTN ProtocolCount;\r
a405b86d 2317 HANDLE_LIST *ListWalker;\r
2318\r
2319 InternalShellInitHandleList();\r
2320\r
2321 if (TheIndex >= mHandleList.NextIndex) {\r
f330ff35 2322 return NULL;\r
a405b86d 2323 }\r
2324\r
2325 for (ListWalker = (HANDLE_LIST*)GetFirstNode(&mHandleList.List.Link)\r
2326 ; !IsNull(&mHandleList.List.Link,&ListWalker->Link)\r
2327 ; ListWalker = (HANDLE_LIST*)GetNextNode(&mHandleList.List.Link,&ListWalker->Link)\r
2328 ){\r
f330ff35 2329 if (ListWalker->TheIndex == TheIndex && ListWalker->TheHandle != NULL) {\r
2330 //\r
2331 // Verify that LinkWalker->TheHandle is valid handle\r
2332 //\r
2333 Status = gBS->ProtocolsPerHandle(ListWalker->TheHandle, &ProtocolBuffer, &ProtocolCount);\r
2334 if (EFI_ERROR (Status)) {\r
2335 //\r
2336 // TheHandle is not valid, so do not add to handle list\r
2337 //\r
2338 ListWalker->TheHandle = NULL;\r
2339 }\r
a405b86d 2340 return (ListWalker->TheHandle);\r
2341 }\r
2342 }\r
f330ff35 2343 return NULL;\r
a405b86d 2344}\r
2345\r
2346/**\r
2347 Gets all the related EFI_HANDLEs based on the mask supplied.\r
2348\r
2349 This function scans all EFI_HANDLES in the UEFI environment's handle database\r
2350 and returns the ones with the specified relationship (Mask) to the specified\r
2351 controller handle.\r
2352\r
2353 If both DriverBindingHandle and ControllerHandle are NULL, then ASSERT.\r
2354 If MatchingHandleCount is NULL, then ASSERT.\r
2355\r
2356 If MatchingHandleBuffer is not NULL upon a successful return the memory must be\r
2357 caller freed.\r
2358\r
2359 @param[in] DriverBindingHandle The handle with Driver Binding protocol on it.\r
2360 @param[in] ControllerHandle The handle with Device Path protocol on it.\r
2361 @param[in] MatchingHandleCount The pointer to UINTN that specifies the number of HANDLES in\r
2362 MatchingHandleBuffer.\r
2363 @param[out] MatchingHandleBuffer On a successful return, a buffer of MatchingHandleCount\r
2364 EFI_HANDLEs with a terminating NULL EFI_HANDLE.\r
2365 @param[out] HandleType An array of type information.\r
2366\r
2367 @retval EFI_SUCCESS The operation was successful, and any related handles\r
2368 are in MatchingHandleBuffer.\r
2369 @retval EFI_NOT_FOUND No matching handles were found.\r
2370 @retval EFI_INVALID_PARAMETER A parameter was invalid or out of range.\r
2371**/\r
2372EFI_STATUS\r
2373EFIAPI\r
2374ParseHandleDatabaseByRelationshipWithType (\r
2375 IN CONST EFI_HANDLE DriverBindingHandle OPTIONAL,\r
2376 IN CONST EFI_HANDLE ControllerHandle OPTIONAL,\r
2377 IN UINTN *HandleCount,\r
2378 OUT EFI_HANDLE **HandleBuffer,\r
2379 OUT UINTN **HandleType\r
2380 )\r
2381{\r
2382 EFI_STATUS Status;\r
2383 UINTN HandleIndex;\r
2384 EFI_GUID **ProtocolGuidArray;\r
2385 UINTN ArrayCount;\r
2386 UINTN ProtocolIndex;\r
2387 EFI_OPEN_PROTOCOL_INFORMATION_ENTRY *OpenInfo;\r
2388 UINTN OpenInfoCount;\r
2389 UINTN OpenInfoIndex;\r
2390 UINTN ChildIndex;\r
f330ff35 2391 INTN DriverBindingHandleIndex;\r
a405b86d 2392\r
2393 ASSERT(HandleCount != NULL);\r
2394 ASSERT(HandleBuffer != NULL);\r
2395 ASSERT(HandleType != NULL);\r
2396 ASSERT(DriverBindingHandle != NULL || ControllerHandle != NULL);\r
2397\r
2398 *HandleCount = 0;\r
2399 *HandleBuffer = NULL;\r
2400 *HandleType = NULL;\r
2401\r
2402 //\r
2403 // Retrieve the list of all handles from the handle database\r
2404 //\r
2405 Status = gBS->LocateHandleBuffer (\r
2406 AllHandles,\r
2407 NULL,\r
2408 NULL,\r
2409 HandleCount,\r
2410 HandleBuffer\r
2411 );\r
2412 if (EFI_ERROR (Status)) {\r
2413 return (Status);\r
2414 }\r
2415\r
2416 *HandleType = AllocateZeroPool (*HandleCount * sizeof (UINTN));\r
aa3276c1
RN		 2417 if (*HandleType == NULL) {\r
2418 SHELL_FREE_NON_NULL (*HandleBuffer);\r
94fcb76b 2419 *HandleCount = 0;\r
aa3276c1
RN		 2420 return EFI_OUT_OF_RESOURCES;\r
2421 }\r
a405b86d 2422\r
f330ff35 2423 DriverBindingHandleIndex = -1;\r
2424 for (HandleIndex = 0; HandleIndex < *HandleCount; HandleIndex++) {\r
2425 if (DriverBindingHandle != NULL && (*HandleBuffer)[HandleIndex] == DriverBindingHandle) {\r
2426 DriverBindingHandleIndex = (INTN)HandleIndex;\r
2427 }\r
2428 }\r
2429\r
a405b86d 2430 for (HandleIndex = 0; HandleIndex < *HandleCount; HandleIndex++) {\r
2431 //\r
2432 // Retrieve the list of all the protocols on each handle\r
2433 //\r
2434 Status = gBS->ProtocolsPerHandle (\r
2435 (*HandleBuffer)[HandleIndex],\r
2436 &ProtocolGuidArray,\r
2437 &ArrayCount\r
2438 );\r
f330ff35 2439 if (EFI_ERROR (Status)) {\r
2440 continue;\r
2441 }\r
a405b86d 2442\r
f330ff35 2443 for (ProtocolIndex = 0; ProtocolIndex < ArrayCount; ProtocolIndex++) {\r
a405b86d 2444\r
f330ff35 2445 //\r
2446 // Set the bit describing what this handle has\r
2447 //\r
2448 if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiLoadedImageProtocolGuid) ) {\r
7aae3c35 2449 (*HandleType)[HandleIndex] |= (UINTN)HR_IMAGE_HANDLE;\r
f330ff35 2450 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiDriverBindingProtocolGuid) ) {\r
7aae3c35 2451 (*HandleType)[HandleIndex] |= (UINTN)HR_DRIVER_BINDING_HANDLE;\r
f330ff35 2452 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiDriverConfiguration2ProtocolGuid)) {\r
7aae3c35 2453 (*HandleType)[HandleIndex] |= (UINTN)HR_DRIVER_CONFIGURATION_HANDLE;\r
f330ff35 2454 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiDriverConfigurationProtocolGuid) ) {\r
7aae3c35 2455 (*HandleType)[HandleIndex] |= (UINTN)HR_DRIVER_CONFIGURATION_HANDLE;\r
f330ff35 2456 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiDriverDiagnostics2ProtocolGuid) ) {\r
7aae3c35 2457 (*HandleType)[HandleIndex] |= (UINTN)HR_DRIVER_DIAGNOSTICS_HANDLE;\r
f330ff35 2458 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiDriverDiagnosticsProtocolGuid) ) {\r
7aae3c35 2459 (*HandleType)[HandleIndex] |= (UINTN)HR_DRIVER_DIAGNOSTICS_HANDLE;\r
f330ff35 2460 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiComponentName2ProtocolGuid) ) {\r
7aae3c35 2461 (*HandleType)[HandleIndex] |= (UINTN)HR_COMPONENT_NAME_HANDLE;\r
f330ff35 2462 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiComponentNameProtocolGuid) ) {\r
7aae3c35 2463 (*HandleType)[HandleIndex] |= (UINTN)HR_COMPONENT_NAME_HANDLE;\r
f330ff35 2464 } else if (CompareGuid (ProtocolGuidArray[ProtocolIndex], &gEfiDevicePathProtocolGuid) ) {\r
7aae3c35 2465 (*HandleType)[HandleIndex] |= (UINTN)HR_DEVICE_HANDLE;\r
f330ff35 2466 }\r
2467 //\r
2468 // Retrieve the list of agents that have opened each protocol\r
2469 //\r
2470 Status = gBS->OpenProtocolInformation (\r
a405b86d 2471 (*HandleBuffer)[HandleIndex],\r
2472 ProtocolGuidArray[ProtocolIndex],\r
2473 &OpenInfo,\r
2474 &OpenInfoCount\r
2475 );\r
f330ff35 2476 if (EFI_ERROR (Status)) {\r
2477 continue;\r
2478 }\r
2479\r
2480 if (ControllerHandle == NULL) {\r
2481 //\r
1a6f74d9 2482 // ControllerHandle == NULL and DriverBindingHandle != NULL.\r
f330ff35 2483 // Return information on all the controller handles that the driver specified by DriverBindingHandle is managing\r
2484 //\r
2485 for (OpenInfoIndex = 0; OpenInfoIndex < OpenInfoCount; OpenInfoIndex++) {\r
2486 if (OpenInfo[OpenInfoIndex].AgentHandle == DriverBindingHandle && (OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {\r
7aae3c35 2487 (*HandleType)[HandleIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CONTROLLER_HANDLE);\r
f330ff35 2488 if (DriverBindingHandleIndex != -1) {\r
7aae3c35 2489 (*HandleType)[DriverBindingHandleIndex] |= (UINTN)HR_DEVICE_DRIVER;\r
f330ff35 2490 }\r
2491 }\r
2492 if (OpenInfo[OpenInfoIndex].AgentHandle == DriverBindingHandle && (OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
7aae3c35 2493 (*HandleType)[HandleIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CONTROLLER_HANDLE);\r
f330ff35 2494 if (DriverBindingHandleIndex != -1) {\r
7aae3c35 2495 (*HandleType)[DriverBindingHandleIndex] |= (UINTN)(HR_BUS_DRIVER | HR_DEVICE_DRIVER);\r
f330ff35 2496 }\r
2497 for (ChildIndex = 0; ChildIndex < *HandleCount; ChildIndex++) {\r
2498 if (OpenInfo[OpenInfoIndex].ControllerHandle == (*HandleBuffer)[ChildIndex]) {\r
7aae3c35 2499 (*HandleType)[ChildIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CHILD_HANDLE);\r
f330ff35 2500 }\r
2501 }\r
2502 }\r
2503 }\r
2504 }\r
2505 if (DriverBindingHandle == NULL && ControllerHandle != NULL) {\r
2506 if (ControllerHandle == (*HandleBuffer)[HandleIndex]) {\r
7aae3c35 2507 (*HandleType)[HandleIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CONTROLLER_HANDLE);\r
a405b86d 2508 for (OpenInfoIndex = 0; OpenInfoIndex < OpenInfoCount; OpenInfoIndex++) {\r
f330ff35 2509 if ((OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {\r
2510 for (ChildIndex = 0; ChildIndex < *HandleCount; ChildIndex++) {\r
2511 if (OpenInfo[OpenInfoIndex].AgentHandle == (*HandleBuffer)[ChildIndex]) {\r
7aae3c35 2512 (*HandleType)[ChildIndex] |= (UINTN)HR_DEVICE_DRIVER;\r
f330ff35 2513 }\r
a405b86d 2514 }\r
f330ff35 2515 }\r
2516 if ((OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
2517 for (ChildIndex = 0; ChildIndex < *HandleCount; ChildIndex++) {\r
2518 if (OpenInfo[OpenInfoIndex].AgentHandle == (*HandleBuffer)[ChildIndex]) {\r
7aae3c35 2519 (*HandleType)[ChildIndex] |= (UINTN)(HR_BUS_DRIVER | HR_DEVICE_DRIVER);\r
f330ff35 2520 }\r
2521 if (OpenInfo[OpenInfoIndex].ControllerHandle == (*HandleBuffer)[ChildIndex]) {\r
7aae3c35 2522 (*HandleType)[ChildIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CHILD_HANDLE);\r
a405b86d 2523 }\r
2524 }\r
2525 }\r
f330ff35 2526 }\r
2527 } else {\r
2528 for (OpenInfoIndex = 0; OpenInfoIndex < OpenInfoCount; OpenInfoIndex++) {\r
2529 if ((OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
2530 if (OpenInfo[OpenInfoIndex].ControllerHandle == ControllerHandle) {\r
7aae3c35 2531 (*HandleType)[HandleIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_PARENT_HANDLE);\r
f330ff35 2532 }\r
2533 }\r
2534 }\r
2535 }\r
2536 }\r
2537 if (DriverBindingHandle != NULL && ControllerHandle != NULL) {\r
2538 if (ControllerHandle == (*HandleBuffer)[HandleIndex]) {\r
7aae3c35 2539 (*HandleType)[HandleIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CONTROLLER_HANDLE);\r
f330ff35 2540 for (OpenInfoIndex = 0; OpenInfoIndex < OpenInfoCount; OpenInfoIndex++) {\r
2541 if ((OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_DRIVER) != 0) {\r
2542 if (OpenInfo[OpenInfoIndex].AgentHandle == DriverBindingHandle) {\r
2543 if (DriverBindingHandleIndex != -1) {\r
7aae3c35 2544 (*HandleType)[DriverBindingHandleIndex] |= (UINTN)HR_DEVICE_DRIVER;\r
a405b86d 2545 }\r
2546 }\r
f330ff35 2547 }\r
2548 if ((OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
2549 if (OpenInfo[OpenInfoIndex].AgentHandle == DriverBindingHandle) {\r
a405b86d 2550 for (ChildIndex = 0; ChildIndex < *HandleCount; ChildIndex++) {\r
f330ff35 2551 if (OpenInfo[OpenInfoIndex].ControllerHandle == (*HandleBuffer)[ChildIndex]) {\r
7aae3c35 2552 (*HandleType)[ChildIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_CHILD_HANDLE);\r
a405b86d 2553 }\r
2554 }\r
2555 }\r
f330ff35 2556\r
2557 for (ChildIndex = 0; ChildIndex < *HandleCount; ChildIndex++) {\r
2558 if (OpenInfo[OpenInfoIndex].AgentHandle == (*HandleBuffer)[ChildIndex]) {\r
7aae3c35 2559 (*HandleType)[ChildIndex] |= (UINTN)(HR_BUS_DRIVER | HR_DEVICE_DRIVER);\r
f330ff35 2560 }\r
2561 }\r
2562 }\r
2563 }\r
2564 } else {\r
2565 for (OpenInfoIndex = 0; OpenInfoIndex < OpenInfoCount; OpenInfoIndex++) {\r
2566 if ((OpenInfo[OpenInfoIndex].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {\r
2567 if (OpenInfo[OpenInfoIndex].ControllerHandle == ControllerHandle) {\r
7aae3c35 2568 (*HandleType)[HandleIndex] |= (UINTN)(HR_DEVICE_HANDLE | HR_PARENT_HANDLE);\r
f330ff35 2569 }\r
a405b86d 2570 }\r
2571 }\r
a405b86d 2572 }\r
2573 }\r
f330ff35 2574 FreePool (OpenInfo);\r
a405b86d 2575 }\r
f330ff35 2576 FreePool (ProtocolGuidArray);\r
a405b86d 2577 }\r
f330ff35 2578 return EFI_SUCCESS;\r
a405b86d 2579}\r
2580\r
2581/**\r
2582 Gets all the related EFI_HANDLEs based on the single EFI_HANDLE and the mask\r
2583 supplied.\r
2584\r
2585 This function will scan all EFI_HANDLES in the UEFI environment's handle database\r
2586 and return all the ones with the specified relationship (Mask) to the specified\r
2587 controller handle.\r
2588\r
2589 If both DriverBindingHandle and ControllerHandle are NULL, then ASSERT.\r
2590 If MatchingHandleCount is NULL, then ASSERT.\r
2591\r
2592 If MatchingHandleBuffer is not NULL upon a sucessful return the memory must be\r
2593 caller freed.\r
2594\r
2595 @param[in] DriverBindingHandle Handle to a object with Driver Binding protocol\r
2596 on it.\r
2597 @param[in] ControllerHandle Handle to a device with Device Path protocol on it.\r
2598 @param[in] Mask Mask of what relationship(s) is desired.\r
2599 @param[in] MatchingHandleCount Poitner to UINTN specifying number of HANDLES in\r
2600 MatchingHandleBuffer.\r
2601 @param[out] MatchingHandleBuffer On a sucessful return a buffer of MatchingHandleCount\r
2602 EFI_HANDLEs and a terminating NULL EFI_HANDLE.\r
2603\r
2604 @retval EFI_SUCCESS The operation was sucessful and any related handles\r
2605 are in MatchingHandleBuffer;\r
2606 @retval EFI_NOT_FOUND No matching handles were found.\r
2607 @retval EFI_INVALID_PARAMETER A parameter was invalid or out of range.\r
2608**/\r
2609EFI_STATUS\r
2610EFIAPI\r
2611ParseHandleDatabaseByRelationship (\r
2612 IN CONST EFI_HANDLE DriverBindingHandle OPTIONAL,\r
2613 IN CONST EFI_HANDLE ControllerHandle OPTIONAL,\r
2614 IN CONST UINTN Mask,\r
2615 IN UINTN *MatchingHandleCount,\r
2616 OUT EFI_HANDLE **MatchingHandleBuffer OPTIONAL\r
2617 )\r
2618{\r
2619 EFI_STATUS Status;\r
2620 UINTN HandleCount;\r
2621 EFI_HANDLE *HandleBuffer;\r
2622 UINTN *HandleType;\r
2623 UINTN HandleIndex;\r
2624\r
2625 ASSERT(MatchingHandleCount != NULL);\r
2626 ASSERT(DriverBindingHandle != NULL || ControllerHandle != NULL);\r
2627\r
2628 if ((Mask & HR_VALID_MASK) != Mask) {\r
2629 return (EFI_INVALID_PARAMETER);\r
2630 }\r
2631\r
2632 if ((Mask & HR_CHILD_HANDLE) != 0 && DriverBindingHandle == NULL) {\r
2633 return (EFI_INVALID_PARAMETER);\r
2634 }\r
2635\r
2636 *MatchingHandleCount = 0;\r
2637 if (MatchingHandleBuffer != NULL) {\r
2638 *MatchingHandleBuffer = NULL;\r
2639 }\r
2640\r
2641 HandleBuffer = NULL;\r
2642 HandleType = NULL;\r
2643\r
2644 Status = ParseHandleDatabaseByRelationshipWithType (\r
2645 DriverBindingHandle,\r
2646 ControllerHandle,\r
2647 &HandleCount,\r
2648 &HandleBuffer,\r
2649 &HandleType\r
2650 );\r
2651 if (!EFI_ERROR (Status)) {\r
2652 //\r
2653 // Count the number of handles that match the attributes in Mask\r
2654 //\r
2655 for (HandleIndex = 0; HandleIndex < HandleCount; HandleIndex++) {\r
2656 if ((HandleType[HandleIndex] & Mask) == Mask) {\r
2657 (*MatchingHandleCount)++;\r
2658 }\r
2659 }\r
2660 //\r
2661 // If no handles match the attributes in Mask then return EFI_NOT_FOUND\r
2662 //\r
2663 if (*MatchingHandleCount == 0) {\r
2664 Status = EFI_NOT_FOUND;\r
2665 } else {\r
2666\r
2667 if (MatchingHandleBuffer == NULL) {\r
2668 //\r
2669 // Someone just wanted the count...\r
2670 //\r
2671 Status = EFI_SUCCESS;\r
2672 } else {\r
2673 //\r
2674 // Allocate a handle buffer for the number of handles that matched the attributes in Mask\r
2675 //\r
78ed876b 2676 *MatchingHandleBuffer = AllocateZeroPool ((*MatchingHandleCount +1)* sizeof (EFI_HANDLE));\r
94fcb76b
RN		 2677 if (*MatchingHandleBuffer == NULL) {\r
2678 Status = EFI_OUT_OF_RESOURCES;\r
2679 } else {\r
aa3276c1
RN		 2680 for (HandleIndex = 0, *MatchingHandleCount = 0\r
2681 ; HandleIndex < HandleCount\r
2682 ; HandleIndex++\r
2683 ) {\r
2684 //\r
2685 // Fill the allocated buffer with the handles that matched the attributes in Mask\r
2686 //\r
2687 if ((HandleType[HandleIndex] & Mask) == Mask) {\r
2688 (*MatchingHandleBuffer)[(*MatchingHandleCount)++] = HandleBuffer[HandleIndex];\r
2689 }\r
2690 }\r
a405b86d 2691\r
a405b86d 2692 //\r
aa3276c1 2693 // Make the last one NULL\r
a405b86d 2694 //\r
aa3276c1 2695 (*MatchingHandleBuffer)[*MatchingHandleCount] = NULL;\r
a405b86d 2696\r
aa3276c1 2697 Status = EFI_SUCCESS;\r
94fcb76b 2698 } // *MatchingHandleBuffer == NULL (ELSE)\r
a405b86d 2699 } // MacthingHandleBuffer == NULL (ELSE)\r
2700 } // *MatchingHandleCount == 0 (ELSE)\r
2701 } // no error on ParseHandleDatabaseByRelationshipWithType\r
2702\r
2703 if (HandleBuffer != NULL) {\r
2704 FreePool (HandleBuffer);\r
2705 }\r
2706\r
2707 if (HandleType != NULL) {\r
2708 FreePool (HandleType);\r
2709 }\r
2710\r
94fcb76b
RN		 2711 ASSERT ((MatchingHandleBuffer == NULL) ||\r
2712 (*MatchingHandleCount == 0 && *MatchingHandleBuffer == NULL) ||\r
2713 (*MatchingHandleCount != 0 && *MatchingHandleBuffer != NULL));\r
a405b86d 2714 return Status;\r
2715}\r
2716\r
2717/**\r
2718 Gets handles for any child controllers of the passed in controller.\r
2719\r
2720 @param[in] ControllerHandle The handle of the "parent controller"\r
b6c54204 2721 @param[out] MatchingHandleCount Pointer to the number of handles in\r
a405b86d 2722 MatchingHandleBuffer on return.\r
2723 @param[out] MatchingHandleBuffer Buffer containing handles on a successful\r
2724 return.\r
2725\r
2726\r
2727 @retval EFI_SUCCESS The operation was sucessful.\r
2728**/\r
2729EFI_STATUS\r
2730EFIAPI\r
2731ParseHandleDatabaseForChildControllers(\r
2732 IN CONST EFI_HANDLE ControllerHandle,\r
b6c54204 2733 OUT UINTN *MatchingHandleCount,\r
a405b86d 2734 OUT EFI_HANDLE **MatchingHandleBuffer OPTIONAL\r
2735 )\r
2736{\r
2737 EFI_STATUS Status;\r
f330ff35 2738 UINTN HandleIndex;\r
a405b86d 2739 UINTN DriverBindingHandleCount;\r
2740 EFI_HANDLE *DriverBindingHandleBuffer;\r
2741 UINTN DriverBindingHandleIndex;\r
2742 UINTN ChildControllerHandleCount;\r
2743 EFI_HANDLE *ChildControllerHandleBuffer;\r
2744 UINTN ChildControllerHandleIndex;\r
a405b86d 2745 EFI_HANDLE *HandleBufferForReturn;\r
2746\r
ff51746b 2747 if (MatchingHandleCount == NULL) {\r
2748 return (EFI_INVALID_PARAMETER);\r
2749 }\r
64d753f1 2750 *MatchingHandleCount = 0;\r
a405b86d 2751\r
2752 Status = PARSE_HANDLE_DATABASE_UEFI_DRIVERS (\r
2753 ControllerHandle,\r
2754 &DriverBindingHandleCount,\r
2755 &DriverBindingHandleBuffer\r
2756 );\r
2757 if (EFI_ERROR (Status)) {\r
2758 return Status;\r
2759 }\r
2760\r
ff51746b 2761 //\r
2762 // Get a buffer big enough for all the controllers.\r
2763 //\r
f330ff35 2764 HandleBufferForReturn = GetHandleListByProtocol(NULL);\r
a405b86d 2765 if (HandleBufferForReturn == NULL) {\r
2766 FreePool (DriverBindingHandleBuffer);\r
ff51746b 2767 return (EFI_NOT_FOUND);\r
a405b86d 2768 }\r
2769\r
a405b86d 2770 for (DriverBindingHandleIndex = 0; DriverBindingHandleIndex < DriverBindingHandleCount; DriverBindingHandleIndex++) {\r
2771 Status = PARSE_HANDLE_DATABASE_MANAGED_CHILDREN (\r
2772 DriverBindingHandleBuffer[DriverBindingHandleIndex],\r
2773 ControllerHandle,\r
2774 &ChildControllerHandleCount,\r
2775 &ChildControllerHandleBuffer\r
2776 );\r
2777 if (EFI_ERROR (Status)) {\r
2778 continue;\r
2779 }\r
2780\r
2781 for (ChildControllerHandleIndex = 0;\r
2782 ChildControllerHandleIndex < ChildControllerHandleCount;\r
2783 ChildControllerHandleIndex++\r
2784 ) {\r
f330ff35 2785 for (HandleIndex = 0; HandleIndex < *MatchingHandleCount; HandleIndex++) {\r
2786 if (HandleBufferForReturn[HandleIndex] == ChildControllerHandleBuffer[ChildControllerHandleIndex]) {\r
2787 break;\r
2788 }\r
2789 }\r
2790 if (HandleIndex >= *MatchingHandleCount) {\r
2791 HandleBufferForReturn[(*MatchingHandleCount)++] = ChildControllerHandleBuffer[ChildControllerHandleIndex];\r
2792 }\r
a405b86d 2793 }\r
2794\r
2795 FreePool (ChildControllerHandleBuffer);\r
2796 }\r
2797\r
2798 FreePool (DriverBindingHandleBuffer);\r
2799\r
7eb3bb6c
LE		 2800 if (MatchingHandleBuffer == NULL || *MatchingHandleCount == 0) {\r
2801 //\r
2802 // The caller is not interested in the actual handles, or we've found none.\r
2803 //\r
2804 FreePool (HandleBufferForReturn);\r
2805 HandleBufferForReturn = NULL;\r
2806 }\r
2807\r
a405b86d 2808 if (MatchingHandleBuffer != NULL) {\r
2809 *MatchingHandleBuffer = HandleBufferForReturn;\r
a405b86d 2810 }\r
7eb3bb6c 2811\r
94fcb76b
RN		 2812 ASSERT ((MatchingHandleBuffer == NULL) ||\r
2813 (*MatchingHandleCount == 0 && *MatchingHandleBuffer == NULL) ||\r
2814 (*MatchingHandleCount != 0 && *MatchingHandleBuffer != NULL));\r
a405b86d 2815\r
2816 return (EFI_SUCCESS);\r
2817}\r
2818\r
2819/**\r
2820 Appends 1 buffer to another buffer. This will re-allocate the destination buffer\r
2821 if necessary to fit all of the data.\r
2822\r
2823 If DestinationBuffer is NULL, then ASSERT().\r
2824\r
4ff7e37b
ED		 2825 @param[in, out] DestinationBuffer The pointer to the pointer to the buffer to append onto.\r
2826 @param[in, out] DestinationSize The pointer to the size of DestinationBuffer.\r
2827 @param[in] SourceBuffer The pointer to the buffer to append onto DestinationBuffer.\r
2828 @param[in] SourceSize The number of bytes of SourceBuffer to append.\r
a405b86d 2829\r
2830 @retval NULL A memory allocation failed.\r
2831 @retval NULL A parameter was invalid.\r
2832 @return A pointer to (*DestinationBuffer).\r
2833**/\r
2834VOID*\r
a405b86d 2835BuffernCatGrow (\r
2836 IN OUT VOID **DestinationBuffer,\r
2837 IN OUT UINTN *DestinationSize,\r
2838 IN VOID *SourceBuffer,\r
2839 IN UINTN SourceSize\r
2840 )\r
2841{\r
2842 UINTN LocalDestinationSize;\r
2843 UINTN LocalDestinationFinalSize;\r
2844\r
2845 ASSERT(DestinationBuffer != NULL);\r
2846\r
2847 if (SourceSize == 0 || SourceBuffer == NULL) {\r
2848 return (*DestinationBuffer);\r
2849 }\r
2850\r
2851 if (DestinationSize == NULL) {\r
2852 LocalDestinationSize = 0;\r
2853 } else {\r
2854 LocalDestinationSize = *DestinationSize;\r
2855 }\r
2856\r
2857 LocalDestinationFinalSize = LocalDestinationSize + SourceSize;\r