]> git.proxmox.com Git - mirror_edk2.git/blame - ShellPkg/Library/UefiShellDriver1CommandsLib/DevTree.c
ShellPkg/UefiHandleParsingLib: Remove some unused Guids
[mirror_edk2.git] / ShellPkg / Library / UefiShellDriver1CommandsLib / DevTree.c
CommitLineData
4ba49616 1/** @file\r
2 Main file for DevTree shell Driver1 function.\r
3\r
c011b6c9 4 (C) Copyright 2014-2015 Hewlett-Packard Development Company, L.P.<BR>\r
ba0014b9 5 Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>\r
56ba3746 6 SPDX-License-Identifier: BSD-2-Clause-Patent\r
4ba49616 7\r
8**/\r
9\r
10#include "UefiShellDriver1CommandsLib.h"\r
11\r
12STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
13 {L"-d", TypeFlag},\r
14 {L"-l", TypeValue},\r
15 {NULL, TypeMax}\r
16 };\r
17\r
361a8267 18/**\r
19 Display a tree starting from this handle.\r
20\r
21 @param[in] TheHandle The handle to start with.\r
22 @param[in] Lang Optionally, a UEFI defined language code.\r
23 @param[in] UseDevPaths TRUE to display info from DevPath as identifiers.\r
24 FALSE will use component name protocol instead.\r
25 @param[in] IndentCharCount How many characters to indent (allows for recursion).\r
26 @param[in] HiiString The string from HII to use for output.\r
27\r
28 @retval SHELL_SUCCESS The operation was successful.\r
29**/\r
4ba49616 30SHELL_STATUS\r
4ba49616 31DoDevTreeForHandle(\r
32 IN CONST EFI_HANDLE TheHandle,\r
33 IN CONST CHAR8 *Lang OPTIONAL,\r
34 IN CONST BOOLEAN UseDevPaths,\r
35 IN CONST UINTN IndentCharCount,\r
36 IN CONST CHAR16 *HiiString\r
37 )\r
38{\r
39 SHELL_STATUS ShellStatus;\r
40 EFI_STATUS Status;\r
41 CHAR16 *FormatString;\r
42 CHAR16 *Name;\r
43 EFI_HANDLE *ChildHandleBuffer;\r
44 UINTN ChildCount;\r
45 UINTN LoopVar;\r
46\r
47 Status = EFI_SUCCESS;\r
48 ShellStatus = SHELL_SUCCESS;\r
49 Name = NULL;\r
50 ChildHandleBuffer = NULL;\r
51 ChildCount = 0;\r
52\r
55b1d63d
RN
53 ASSERT (TheHandle != NULL);\r
54 ASSERT (HiiString != NULL);\r
ba0014b9 55\r
bbe94d7a
TS
56 if (ShellGetExecutionBreakFlag()) {\r
57 ShellStatus = SHELL_ABORTED;\r
58 return ShellStatus;\r
59 }\r
ba0014b9 60\r
4ba49616 61 //\r
62 // We want controller handles. they will not have LoadedImage or DriverBinding (or others...)\r
63 //\r
64 Status = gBS->OpenProtocol (\r
65 TheHandle,\r
66 &gEfiDriverBindingProtocolGuid,\r
67 NULL,\r
68 NULL,\r
69 NULL,\r
70 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
71 );\r
72 if (!EFI_ERROR (Status)) {\r
73 return SHELL_SUCCESS;\r
74 }\r
75\r
76 Status = gBS->OpenProtocol (\r
77 TheHandle,\r
78 &gEfiLoadedImageProtocolGuid,\r
79 NULL,\r
80 NULL,\r
81 NULL,\r
82 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
83 );\r
84 if (!EFI_ERROR (Status)) {\r
85 return SHELL_SUCCESS;\r
86 }\r
87\r
55b1d63d
RN
88 FormatString = AllocateZeroPool(StrSize(HiiString) + (10)*sizeof(FormatString[0]));\r
89 if (FormatString == NULL) {\r
90 return SHELL_OUT_OF_RESOURCES;\r
91 }\r
4ba49616 92\r
93 //\r
94 // we generate the format string on the fly so that we can control the\r
95 // number of space characters that the first (empty) string has. this\r
96 // handles the indenting.\r
97 //\r
98\r
99 UnicodeSPrint(FormatString, StrSize(HiiString) + (10)*sizeof(FormatString[0]), L"%%%ds %s", IndentCharCount, HiiString);\r
100 gEfiShellProtocol->GetDeviceName((EFI_HANDLE)TheHandle, !UseDevPaths?EFI_DEVICE_NAME_USE_COMPONENT_NAME|EFI_DEVICE_NAME_USE_DEVICE_PATH:EFI_DEVICE_NAME_USE_DEVICE_PATH, (CHAR8*)Lang, &Name);\r
101 //\r
102 // print out the information for ourselves\r
103 //\r
104 ShellPrintEx(\r
105 -1,\r
106 -1,\r
107 FormatString,\r
108 L"",\r
109 ConvertHandleToHandleIndex(TheHandle),\r
110 Name==NULL?L"Unknown":Name);\r
111\r
112 FreePool(FormatString);\r
113 if (Name != NULL) {\r
114 FreePool(Name);\r
115 }\r
116\r
117 //\r
118 // recurse on each child handle with IndentCharCount + 2\r
119 //\r
120 ParseHandleDatabaseForChildControllers(TheHandle, &ChildCount, &ChildHandleBuffer);\r
121 for (LoopVar = 0 ; LoopVar < ChildCount && ShellStatus == SHELL_SUCCESS; LoopVar++){\r
122 ShellStatus = DoDevTreeForHandle(ChildHandleBuffer[LoopVar], Lang, UseDevPaths, IndentCharCount+2, HiiString);\r
bbe94d7a
TS
123 if (ShellStatus == SHELL_ABORTED) {\r
124 break;\r
125 }\r
4ba49616 126 }\r
127\r
128 if (ChildHandleBuffer != NULL) {\r
129 FreePool(ChildHandleBuffer);\r
130 }\r
131\r
132 return (ShellStatus);\r
133}\r
134\r
135/**\r
136 Function for 'devtree' command.\r
137\r
138 @param[in] ImageHandle Handle to the Image (NULL if Internal).\r
139 @param[in] SystemTable Pointer to the System Table (NULL if Internal).\r
140**/\r
141SHELL_STATUS\r
142EFIAPI\r
143ShellCommandRunDevTree (\r
144 IN EFI_HANDLE ImageHandle,\r
145 IN EFI_SYSTEM_TABLE *SystemTable\r
146 )\r
147{\r
148 EFI_STATUS Status;\r
149 LIST_ENTRY *Package;\r
150 CHAR16 *ProblemParam;\r
151 SHELL_STATUS ShellStatus;\r
152 CHAR8 *Language;\r
153 CONST CHAR16 *Lang;\r
154 CHAR16 *HiiString;\r
155 UINTN LoopVar;\r
156 EFI_HANDLE TheHandle;\r
157 BOOLEAN FlagD;\r
361a8267 158 UINT64 Intermediate;\r
f330ff35 159 UINTN ParentControllerHandleCount;\r
160 EFI_HANDLE *ParentControllerHandleBuffer;\r
4ba49616 161\r
162 ShellStatus = SHELL_SUCCESS;\r
163 Status = EFI_SUCCESS;\r
164 Language = NULL;\r
165\r
166 //\r
167 // initialize the shell lib (we must be in non-auto-init...)\r
168 //\r
169 Status = ShellInitialize();\r
170 ASSERT_EFI_ERROR(Status);\r
171\r
172 Status = CommandInit();\r
173 ASSERT_EFI_ERROR(Status);\r
174\r
175 //\r
176 // parse the command line\r
177 //\r
178 Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);\r
179 if (EFI_ERROR(Status)) {\r
180 if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {\r
ba0014b9 181 ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDriver1HiiHandle, L"devtree", ProblemParam);\r
4ba49616 182 FreePool(ProblemParam);\r
183 ShellStatus = SHELL_INVALID_PARAMETER;\r
184 } else {\r
185 ASSERT(FALSE);\r
186 }\r
187 } else {\r
188 if (ShellCommandLineGetCount(Package) > 2) {\r
ba0014b9 189 ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDriver1HiiHandle, L"devtree");\r
4ba49616 190 ShellCommandLineFreeVarList (Package);\r
191 return (SHELL_INVALID_PARAMETER);\r
192 }\r
193 Lang = ShellCommandLineGetValue(Package, L"-l");\r
194 if (Lang != NULL) {\r
195 Language = AllocateZeroPool(StrSize(Lang));\r
196 AsciiSPrint(Language, StrSize(Lang), "%S", Lang);\r
197 } else if (!ShellCommandLineGetFlag(Package, L"-l")){\r
198 ASSERT(Language == NULL);\r
199// Language = AllocateZeroPool(10);\r
200// AsciiSPrint(Language, 10, "en-us");\r
201 } else {\r
202 ASSERT(Language == NULL);\r
ba0014b9 203 ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_VALUE), gShellDriver1HiiHandle, L"devtree", L"-l");\r
4ba49616 204 ShellCommandLineFreeVarList (Package);\r
205 return (SHELL_INVALID_PARAMETER);\r
206 }\r
207 FlagD = ShellCommandLineGetFlag(Package, L"-d");\r
208\r
209 Lang = ShellCommandLineGetRawValue(Package, 1);\r
210 HiiString = HiiGetString(gShellDriver1HiiHandle, STRING_TOKEN (STR_DEV_TREE_OUTPUT), Language);\r
211\r
212 if (Lang == NULL) {\r
213 for (LoopVar = 1 ; ; LoopVar++){\r
214 TheHandle = ConvertHandleIndexToHandle(LoopVar);\r
215 if (TheHandle == NULL){\r
216 break;\r
217 }\r
f330ff35 218\r
219 //\r
220 // Skip handles that do not have device path protocol\r
221 //\r
222 Status = gBS->OpenProtocol (\r
223 TheHandle,\r
224 &gEfiDevicePathProtocolGuid,\r
225 NULL,\r
226 NULL,\r
227 NULL,\r
228 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
229 );\r
230 if (EFI_ERROR (Status)) {\r
231 continue;\r
232 }\r
233\r
234 //\r
235 // Skip handles that do have parents\r
236 //\r
237 ParentControllerHandleBuffer = NULL;\r
238 Status = PARSE_HANDLE_DATABASE_PARENTS (\r
239 TheHandle,\r
240 &ParentControllerHandleCount,\r
241 &ParentControllerHandleBuffer\r
242 );\r
243 SHELL_FREE_NON_NULL (ParentControllerHandleBuffer);\r
244 if (ParentControllerHandleCount > 0) {\r
245 continue;\r
246 }\r
247\r
248 //\r
249 // Start a devtree from TheHandle that has a device path and no parents\r
250 //\r
4ba49616 251 ShellStatus = DoDevTreeForHandle(TheHandle, Language, FlagD, 0, HiiString);\r
252 }\r
253 } else {\r
361a8267 254 Status = ShellConvertStringToUint64(Lang, &Intermediate, TRUE, FALSE);\r
255 if (EFI_ERROR(Status) || ConvertHandleIndexToHandle((UINTN)Intermediate) == NULL) {\r
ba0014b9 256 ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_INV_HANDLE), gShellDriver1HiiHandle, L"devtree", Lang);\r
4ba49616 257 ShellStatus = SHELL_INVALID_PARAMETER;\r
258 } else {\r
361a8267 259 ShellStatus = DoDevTreeForHandle(ConvertHandleIndexToHandle((UINTN)Intermediate), Language, FlagD, 0, HiiString);\r
4ba49616 260 }\r
261 }\r
262\r
263 if (HiiString != NULL) {\r
264 FreePool(HiiString);\r
265 }\r
266 SHELL_FREE_NON_NULL(Language);\r
267 ShellCommandLineFreeVarList (Package);\r
268 }\r
269\r
270 return (ShellStatus);\r
271}\r