2 Main file for devices shell Driver1 function.
4 (C) Copyright 2012-2015 Hewlett-Packard Development Company, L.P.<BR>
5 Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>
6 This program and the accompanying materials
7 are licensed and made available under the terms and conditions of the BSD License
8 which accompanies this distribution. The full text of the license may be found at
9 http://opensource.org/licenses/bsd-license.php
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 #include "UefiShellDriver1CommandsLib.h"
19 Get lots of info about a device from its handle.
21 @param[in] TheHandle The device handle to get info on.
22 @param[in, out] Type On successful return R, B, or D (root, bus, or
23 device) will be placed in this buffer.
24 @param[in, out] Cfg On successful return this buffer will be
25 TRUE if the handle has configuration, FALSE
27 @param[in, out] Diag On successful return this buffer will be
28 TRUE if the handle has disgnostics, FALSE
30 @param[in, out] Parents On successful return this buffer will be
31 contain the number of parent handles.
32 @param[in, out] Devices On successful return this buffer will be
33 contain the number of devices controlled.
34 @param[in, out] Children On successful return this buffer will be
35 contain the number of child handles.
36 @param[out] Name The pointer to a buffer that will be allocated
37 and contain the string name of the handle.
38 The caller must free this memory.
39 @param[in] Language The language code as defined by the UEFI spec.
41 @retval EFI_SUCCESS The info is there.
42 @retval EFI_INVALID_PARAMETER A parameter was invalid.
46 IN EFI_HANDLE TheHandle
,
50 IN OUT UINTN
*Parents
,
51 IN OUT UINTN
*Devices
,
52 IN OUT UINTN
*Children
,
54 IN CONST CHAR8
*Language
58 EFI_HANDLE
*HandleBuffer
;
69 return (EFI_INVALID_PARAMETER
);
82 gEfiShellProtocol
->GetDeviceName(TheHandle
, EFI_DEVICE_NAME_USE_COMPONENT_NAME
|EFI_DEVICE_NAME_USE_DEVICE_PATH
, (CHAR8
*)Language
, Name
);
84 Status
= ParseHandleDatabaseForChildControllers(TheHandle
, Children
, NULL
);
85 // if (!EFI_ERROR(Status)) {
86 Status
= PARSE_HANDLE_DATABASE_PARENTS(TheHandle
, Parents
, NULL
);
87 if (/*!EFI_ERROR(Status) && */Parents
!= NULL
&& Children
!= NULL
) {
90 } else if (*Children
> 0) {
97 Status
= PARSE_HANDLE_DATABASE_UEFI_DRIVERS(TheHandle
, Devices
, &HandleBuffer
);
98 if (!EFI_ERROR(Status
) && Devices
!= NULL
&& HandleBuffer
!= NULL
) {
99 for (Count
= 0 ; Count
< *Devices
; Count
++) {
100 if (!EFI_ERROR(gBS
->OpenProtocol(HandleBuffer
[Count
], &gEfiDriverConfigurationProtocolGuid
, NULL
, NULL
, gImageHandle
, EFI_OPEN_PROTOCOL_TEST_PROTOCOL
))) {
103 if (!EFI_ERROR(gBS
->OpenProtocol(HandleBuffer
[Count
], &gEfiDriverDiagnosticsProtocolGuid
, NULL
, NULL
, gImageHandle
, EFI_OPEN_PROTOCOL_TEST_PROTOCOL
))) {
106 if (!EFI_ERROR(gBS
->OpenProtocol(HandleBuffer
[Count
], &gEfiDriverDiagnostics2ProtocolGuid
, NULL
, NULL
, gImageHandle
, EFI_OPEN_PROTOCOL_TEST_PROTOCOL
))) {
110 SHELL_FREE_NON_NULL(HandleBuffer
);
116 STATIC CONST SHELL_PARAM_ITEM ParamList
[] = {
123 Function for 'devices' command.
125 @param[in] ImageHandle Handle to the Image (NULL if Internal).
126 @param[in] SystemTable Pointer to the System Table (NULL if Internal).
130 ShellCommandRunDevices (
131 IN EFI_HANDLE ImageHandle
,
132 IN EFI_SYSTEM_TABLE
*SystemTable
137 CHAR16
*ProblemParam
;
138 SHELL_STATUS ShellStatus
;
140 EFI_HANDLE
*HandleList
;
141 EFI_HANDLE
*HandleListWalker
;
152 ShellStatus
= SHELL_SUCCESS
;
157 // initialize the shell lib (we must be in non-auto-init...)
159 Status
= ShellInitialize();
160 ASSERT_EFI_ERROR(Status
);
162 Status
= CommandInit();
163 ASSERT_EFI_ERROR(Status
);
166 // parse the command line
168 Status
= ShellCommandLineParse (ParamList
, &Package
, &ProblemParam
, TRUE
);
169 if (EFI_ERROR(Status
)) {
170 if (Status
== EFI_VOLUME_CORRUPTED
&& ProblemParam
!= NULL
) {
171 ShellPrintHiiEx(-1, -1, NULL
, STRING_TOKEN (STR_GEN_PROBLEM
), gShellDriver1HiiHandle
, L
"devices", ProblemParam
);
172 FreePool(ProblemParam
);
173 ShellStatus
= SHELL_INVALID_PARAMETER
;
179 // if more than 0 'value' parameters we have too many parameters
181 if (ShellCommandLineGetRawValue(Package
, 1) != NULL
){
183 // error for too many parameters
185 ShellPrintHiiEx(-1, -1, NULL
, STRING_TOKEN (STR_GEN_TOO_MANY
), gShellDriver1HiiHandle
, L
"devices");
186 ShellStatus
= SHELL_INVALID_PARAMETER
;
189 // get the language if necessary
191 Lang
= ShellCommandLineGetValue(Package
, L
"-l");
193 Language
= AllocateZeroPool(StrSize(Lang
));
194 AsciiSPrint(Language
, StrSize(Lang
), "%S", Lang
);
195 } else if (!ShellCommandLineGetFlag(Package
, L
"-l")){
196 ASSERT(Language
== NULL
);
197 // Language = AllocateZeroPool(10);
198 // AsciiSPrint(Language, 10, "en-us");
200 ASSERT(Language
== NULL
);
201 ShellPrintHiiEx(-1, -1, NULL
, STRING_TOKEN (STR_GEN_NO_VALUE
), gShellDriver1HiiHandle
, L
"devices", L
"-l");
202 ShellCommandLineFreeVarList (Package
);
203 return (SHELL_INVALID_PARAMETER
);
211 if (ShellCommandLineGetFlag (Package
, L
"-sfo")) {
212 ShellPrintHiiEx (-1, -1, Language
, STRING_TOKEN (STR_GEN_SFO_HEADER
), gShellDriver1HiiHandle
, L
"devices");
215 ShellPrintHiiEx (-1, -1, Language
, STRING_TOKEN (STR_DEVICES_HEADER_LINES
), gShellDriver1HiiHandle
);
219 // loop through each handle
221 HandleList
= GetHandleListByProtocol(NULL
);
222 ASSERT(HandleList
!= NULL
);
223 for (HandleListWalker
= HandleList
224 ; HandleListWalker
!= NULL
&& *HandleListWalker
!= NULL
/*&& !EFI_ERROR(Status)*/
229 // get all the info on each handle
232 Status
= GetDeviceHandleInfo(*HandleListWalker
, &Type
, &Cfg
, &Diag
, &Parents
, &Devices
, &Children
, &Name
, Language
);
233 if (Name
!= NULL
&& (Parents
!= 0 || Devices
!= 0 || Children
!= 0)) {
238 SfoFlag
?STRING_TOKEN (STR_DEVICES_ITEM_LINE_SFO
):STRING_TOKEN (STR_DEVICES_ITEM_LINE
),
239 gShellDriver1HiiHandle
,
240 ConvertHandleToHandleIndex (*HandleListWalker
),
242 Cfg
?(SfoFlag
?L
'Y':L
'X'):(SfoFlag
?L
'N':L
'-'),
243 Diag
?(SfoFlag
?L
'Y':L
'X'):(SfoFlag
?L
'N':L
'-'),
247 Name
!=NULL
?Name
:L
"<UNKNOWN>");
252 if (ShellGetExecutionBreakFlag ()) {
253 ShellStatus
= SHELL_ABORTED
;
259 if (HandleList
!= NULL
) {
260 FreePool(HandleList
);
264 SHELL_FREE_NON_NULL(Language
);
265 ShellCommandLineFreeVarList (Package
);
267 return (ShellStatus
);