2 Dir for EBL (Embedded Boot Loader)
4 Copyright (c) 2007, Intel Corporation<BR>
5 Portions copyright (c) 2008-2009, Apple Inc. All rights reserved.
8 All rights reserved. This program and the accompanying materials
9 are licensed and made available under the terms and conditions of the BSD License
10 which accompanies this distribution. The full text of the license may be found at
11 http://opensource.org/licenses/bsd-license.php
13 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
14 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
16 Module Name: CmdTemplate.c
18 Search/Replace Dir with the name of your new command
25 GLOBAL_REMOVE_IF_UNREFERENCED CHAR8
*gFvFileType
[] = {
42 Perform a dir on a device. The device must support Simple File System Protocol
46 Argv[1] - Device Name:path. Path is optional
47 Argv[2] - Optional filename to match on. A leading * means match substring
48 Argv[3] - Optional FV file type
50 dir fs1:\efi ; perform a dir on fs1: device in the efi directory
51 dir fs1:\efi *.efi; perform a dir on fs1: device in the efi directory but
52 only print out files that contain the string *.efi
53 dir fv1:\ ; perform a dir on fv1: device in the efi directory
54 NOTE: fv devices do not contian subdirs
55 dir fv1:\ * PEIM ; will match all files of type SEC
57 @param Argc Number of command arguments in Argv
58 @param Argv Array of strings that represent the parsed command line.
59 Argv[0] is the comamnd name
72 EFI_FILE_INFO
*DirInfo
;
75 CHAR16
*MatchSubString
;
76 EFI_STATUS GetNextFileStatus
;
78 EFI_FV_FILETYPE SearchType
;
80 EFI_FV_FILE_ATTRIBUTES Attributes
;
83 EFI_FIRMWARE_VOLUME2_PROTOCOL
*Fv
;
84 UINT32 AuthenticationStatus
;
87 EFI_FV_FILETYPE Index
;
90 CHAR16 UnicodeFileName
[MAX_CMD_LINE
];
94 // CWD not currently supported
98 File
= EfiOpen (Argv
[1], EFI_FILE_MODE_READ
, 0);
103 if (File
->Type
== EfiOpenFirmwareVolume
) {
106 SearchType
= EFI_FV_FILETYPE_ALL
;
107 UnicodeFileName
[0] = '\0';
108 MatchSubString
= &UnicodeFileName
[0];
110 AsciiStrToUnicodeStr (Argv
[2], UnicodeFileName
);
111 if (UnicodeFileName
[0] == '*') {
112 // Handle *Name substring matching
113 MatchSubString
= &UnicodeFileName
[1];
116 // Handle file type matchs
118 // match a specific file type, always last argument
119 Length
= AsciiStrLen (Argv
[3]);
120 for (Index
= 1, BestMatchCount
= 0; Index
< sizeof (gFvFileType
)/sizeof (CHAR8
*); Index
++) {
121 if (AsciiStriCmp (gFvFileType
[Index
], Argv
[3]) == 0) {
127 if (AsciiStrniCmp (Argv
[3], gFvFileType
[Index
], Length
) == 0) {
128 // partial match, so keep looking to make sure there is only one partial match
134 if (BestMatchCount
> 1) {
135 SearchType
= EFI_FV_FILETYPE_ALL
;
145 GetNextFileStatus
= Fv
->GetNextFile (
153 if (!EFI_ERROR (GetNextFileStatus
)) {
154 // Calculate size of entire file
157 Status
= Fv
->ReadFile (
164 &AuthenticationStatus
166 if (!((Status
== EFI_BUFFER_TOO_SMALL
) || !EFI_ERROR (Status
))) {
167 // EFI_SUCCESS or EFI_BUFFER_TOO_SMALL mean size is valid
171 // read the UI seciton to do a name match.
173 Status
= Fv
->ReadSection (
176 EFI_SECTION_USER_INTERFACE
,
180 &AuthenticationStatus
182 if (!EFI_ERROR (Status
)) {
183 if (StrStr (Section
, MatchSubString
) != NULL
) {
184 AsciiPrint (" %g %s %a %,d\n", &NameGuid
, Section
, gFvFileType
[Type
], Size
);
185 if (EblAnyKeyToContinueQtoQuit (&CurrentRow
, FALSE
)) {
191 if (*MatchSubString
== '\0') {
192 AsciiPrint (" %g %a %,d\n", &NameGuid
, gFvFileType
[Type
], Size
);
193 if (EblAnyKeyToContinueQtoQuit (&CurrentRow
, FALSE
)) {
199 } while (!EFI_ERROR (GetNextFileStatus
));
201 } else if ((File
->Type
== EfiOpenFileSystem
) || (File
->Type
== EfiOpenBlockIo
)) {
202 // Simple File System DIR
204 if (File
->FsFileInfo
== NULL
) {
208 if (!(File
->FsFileInfo
->Attribute
& EFI_FILE_DIRECTORY
)) {
212 // Handle *Name substring matching
213 MatchSubString
= NULL
;
214 UnicodeFileName
[0] = '\0';
216 AsciiStrToUnicodeStr (Argv
[2], UnicodeFileName
);
217 if (UnicodeFileName
[0] == '*') {
218 MatchSubString
= &UnicodeFileName
[1];
222 File
->FsFileHandle
->SetPosition (File
->FsFileHandle
, 0);
223 for (CurrentRow
= 0;;) {
224 // First read gets the size
227 Status
= File
->FsFileHandle
->Read (File
->FsFileHandle
, &ReadSize
, DirInfo
);
228 if (Status
== EFI_BUFFER_TOO_SMALL
) {
229 // Allocate the buffer for the real read
230 DirInfo
= AllocatePool (ReadSize
);
231 if (DirInfo
== NULL
) {
236 Status
= File
->FsFileHandle
->Read (File
->FsFileHandle
, &ReadSize
, DirInfo
);
237 if ((EFI_ERROR (Status
)) || (ReadSize
== 0)) {
244 if (MatchSubString
!= NULL
) {
245 if (StrStr (&DirInfo
->FileName
[0], MatchSubString
) == NULL
) {
246 // does not match *name argument, so skip
249 } else if (UnicodeFileName
[0] != '\0') {
250 // is not an exact match for name argument, so skip
251 if (StrCmp (&DirInfo
->FileName
[0], UnicodeFileName
) != 0) {
256 if (DirInfo
->Attribute
& EFI_FILE_DIRECTORY
) {
257 AsciiPrint (" <DIR> %s\n", &DirInfo
->FileName
[0]);
259 AsciiPrint ("%,14ld %s\n", DirInfo
->FileSize
, &DirInfo
->FileName
[0]);
262 if (EblAnyKeyToContinueQtoQuit (&CurrentRow
, FALSE
)) {
270 if (DirInfo
!= NULL
) {
282 GLOBAL_REMOVE_IF_UNREFERENCED
const EBL_COMMAND_TABLE mCmdDirTemplate
[] =
286 " dirdev [*match]; directory listing of dirdev. opt match a substring",
294 Initialize the commands in this in this file
297 EblInitializeDirCmd (
301 if (FeaturePcdGet (PcdEmbeddedDirCmd
)) {
302 EblAddCommands (mCmdDirTemplate
, sizeof (mCmdDirTemplate
)/sizeof (EBL_COMMAND_TABLE
));