]> git.proxmox.com Git - mirror_edk2.git/blame - ShellPkg/Library/UefiShellDriver1CommandsLib/DevTree.c
UefiCpuPkg: Move AsmRelocateApLoopStart from Mpfuncs.nasm to AmdSev.nasm
[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
47d20b54
MK
12STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
13 { L"-d", TypeFlag },\r
14 { L"-l", TypeValue },\r
15 { NULL, TypeMax }\r
16};\r
4ba49616 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
47d20b54
MK
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
4ba49616 37 )\r
38{\r
47d20b54
MK
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
4ba49616 52\r
55b1d63d
RN
53 ASSERT (TheHandle != NULL);\r
54 ASSERT (HiiString != NULL);\r
ba0014b9 55\r
47d20b54 56 if (ShellGetExecutionBreakFlag ()) {\r
bbe94d7a
TS
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
47d20b54
MK
65 TheHandle,\r
66 &gEfiDriverBindingProtocolGuid,\r
67 NULL,\r
68 NULL,\r
69 NULL,\r
70 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
71 );\r
4ba49616 72 if (!EFI_ERROR (Status)) {\r
73 return SHELL_SUCCESS;\r
74 }\r
75\r
76 Status = gBS->OpenProtocol (\r
47d20b54
MK
77 TheHandle,\r
78 &gEfiLoadedImageProtocolGuid,\r
79 NULL,\r
80 NULL,\r
81 NULL,\r
82 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
83 );\r
4ba49616 84 if (!EFI_ERROR (Status)) {\r
85 return SHELL_SUCCESS;\r
86 }\r
87\r
47d20b54 88 FormatString = AllocateZeroPool (StrSize (HiiString) + (10)*sizeof (FormatString[0]));\r
55b1d63d
RN
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
47d20b54
MK
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
4ba49616 101 //\r
102 // print out the information for ourselves\r
103 //\r
47d20b54 104 ShellPrintEx (\r
4ba49616 105 -1,\r
106 -1,\r
107 FormatString,\r
108 L"",\r
47d20b54
MK
109 ConvertHandleToHandleIndex (TheHandle),\r
110 Name == NULL ? L"Unknown" : Name\r
111 );\r
4ba49616 112\r
47d20b54 113 FreePool (FormatString);\r
4ba49616 114 if (Name != NULL) {\r
47d20b54 115 FreePool (Name);\r
4ba49616 116 }\r
117\r
118 //\r
119 // recurse on each child handle with IndentCharCount + 2\r
120 //\r
47d20b54
MK
121 ParseHandleDatabaseForChildControllers (TheHandle, &ChildCount, &ChildHandleBuffer);\r
122 for (LoopVar = 0; LoopVar < ChildCount && ShellStatus == SHELL_SUCCESS; LoopVar++) {\r
123 ShellStatus = DoDevTreeForHandle (ChildHandleBuffer[LoopVar], Lang, UseDevPaths, IndentCharCount+2, HiiString);\r
bbe94d7a
TS
124 if (ShellStatus == SHELL_ABORTED) {\r
125 break;\r
126 }\r
4ba49616 127 }\r
128\r
129 if (ChildHandleBuffer != NULL) {\r
47d20b54 130 FreePool (ChildHandleBuffer);\r
4ba49616 131 }\r
132\r
133 return (ShellStatus);\r
134}\r
135\r
136/**\r
137 Function for 'devtree' command.\r
138\r
139 @param[in] ImageHandle Handle to the Image (NULL if Internal).\r
140 @param[in] SystemTable Pointer to the System Table (NULL if Internal).\r
141**/\r
142SHELL_STATUS\r
143EFIAPI\r
144ShellCommandRunDevTree (\r
145 IN EFI_HANDLE ImageHandle,\r
146 IN EFI_SYSTEM_TABLE *SystemTable\r
147 )\r
148{\r
47d20b54
MK
149 EFI_STATUS Status;\r
150 LIST_ENTRY *Package;\r
151 CHAR16 *ProblemParam;\r
152 SHELL_STATUS ShellStatus;\r
153 CHAR8 *Language;\r
154 CONST CHAR16 *Lang;\r
155 CHAR16 *HiiString;\r
156 UINTN LoopVar;\r
157 EFI_HANDLE TheHandle;\r
158 BOOLEAN FlagD;\r
159 UINT64 Intermediate;\r
160 UINTN ParentControllerHandleCount;\r
161 EFI_HANDLE *ParentControllerHandleBuffer;\r
162\r
163 ShellStatus = SHELL_SUCCESS;\r
164 Status = EFI_SUCCESS;\r
165 Language = NULL;\r
4ba49616 166\r
167 //\r
168 // initialize the shell lib (we must be in non-auto-init...)\r
169 //\r
47d20b54
MK
170 Status = ShellInitialize ();\r
171 ASSERT_EFI_ERROR (Status);\r
4ba49616 172\r
47d20b54
MK
173 Status = CommandInit ();\r
174 ASSERT_EFI_ERROR (Status);\r
4ba49616 175\r
176 //\r
177 // parse the command line\r
178 //\r
179 Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);\r
47d20b54
MK
180 if (EFI_ERROR (Status)) {\r
181 if ((Status == EFI_VOLUME_CORRUPTED) && (ProblemParam != NULL)) {\r
182 ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellDriver1HiiHandle, L"devtree", ProblemParam);\r
183 FreePool (ProblemParam);\r
4ba49616 184 ShellStatus = SHELL_INVALID_PARAMETER;\r
185 } else {\r
47d20b54 186 ASSERT (FALSE);\r
4ba49616 187 }\r
188 } else {\r
47d20b54
MK
189 if (ShellCommandLineGetCount (Package) > 2) {\r
190 ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellDriver1HiiHandle, L"devtree");\r
4ba49616 191 ShellCommandLineFreeVarList (Package);\r
192 return (SHELL_INVALID_PARAMETER);\r
193 }\r
47d20b54
MK
194\r
195 Lang = ShellCommandLineGetValue (Package, L"-l");\r
4ba49616 196 if (Lang != NULL) {\r
47d20b54
MK
197 Language = AllocateZeroPool (StrSize (Lang));\r
198 AsciiSPrint (Language, StrSize (Lang), "%S", Lang);\r
199 } else if (!ShellCommandLineGetFlag (Package, L"-l")) {\r
200 ASSERT (Language == NULL);\r
201 // Language = AllocateZeroPool(10);\r
202 // AsciiSPrint(Language, 10, "en-us");\r
4ba49616 203 } else {\r
47d20b54
MK
204 ASSERT (Language == NULL);\r
205 ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_VALUE), gShellDriver1HiiHandle, L"devtree", L"-l");\r
4ba49616 206 ShellCommandLineFreeVarList (Package);\r
207 return (SHELL_INVALID_PARAMETER);\r
208 }\r
4ba49616 209\r
47d20b54
MK
210 FlagD = ShellCommandLineGetFlag (Package, L"-d");\r
211\r
212 Lang = ShellCommandLineGetRawValue (Package, 1);\r
213 HiiString = HiiGetString (gShellDriver1HiiHandle, STRING_TOKEN (STR_DEV_TREE_OUTPUT), Language);\r
4ba49616 214\r
215 if (Lang == NULL) {\r
47d20b54
MK
216 for (LoopVar = 1; ; LoopVar++) {\r
217 TheHandle = ConvertHandleIndexToHandle (LoopVar);\r
218 if (TheHandle == NULL) {\r
4ba49616 219 break;\r
220 }\r
f330ff35 221\r
222 //\r
223 // Skip handles that do not have device path protocol\r
224 //\r
225 Status = gBS->OpenProtocol (\r
47d20b54
MK
226 TheHandle,\r
227 &gEfiDevicePathProtocolGuid,\r
228 NULL,\r
229 NULL,\r
230 NULL,\r
231 EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
232 );\r
f330ff35 233 if (EFI_ERROR (Status)) {\r
234 continue;\r
235 }\r
236\r
237 //\r
238 // Skip handles that do have parents\r
239 //\r
240 ParentControllerHandleBuffer = NULL;\r
47d20b54
MK
241 Status = PARSE_HANDLE_DATABASE_PARENTS (\r
242 TheHandle,\r
243 &ParentControllerHandleCount,\r
244 &ParentControllerHandleBuffer\r
245 );\r
f330ff35 246 SHELL_FREE_NON_NULL (ParentControllerHandleBuffer);\r
247 if (ParentControllerHandleCount > 0) {\r
248 continue;\r
249 }\r
250\r
251 //\r
252 // Start a devtree from TheHandle that has a device path and no parents\r
253 //\r
47d20b54 254 ShellStatus = DoDevTreeForHandle (TheHandle, Language, FlagD, 0, HiiString);\r
4ba49616 255 }\r
256 } else {\r
47d20b54
MK
257 Status = ShellConvertStringToUint64 (Lang, &Intermediate, TRUE, FALSE);\r
258 if (EFI_ERROR (Status) || (ConvertHandleIndexToHandle ((UINTN)Intermediate) == NULL)) {\r
259 ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_INV_HANDLE), gShellDriver1HiiHandle, L"devtree", Lang);\r
4ba49616 260 ShellStatus = SHELL_INVALID_PARAMETER;\r
261 } else {\r
47d20b54 262 ShellStatus = DoDevTreeForHandle (ConvertHandleIndexToHandle ((UINTN)Intermediate), Language, FlagD, 0, HiiString);\r
4ba49616 263 }\r
264 }\r
265\r
266 if (HiiString != NULL) {\r
47d20b54 267 FreePool (HiiString);\r
4ba49616 268 }\r
47d20b54
MK
269\r
270 SHELL_FREE_NON_NULL (Language);\r
4ba49616 271 ShellCommandLineFreeVarList (Package);\r
272 }\r
273\r
274 return (ShellStatus);\r
275}\r