/** @file Main file for Parse shell level 2 function. (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.
Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent **/ #include "UefiShellLevel2CommandsLib.h" /** Check if data is coming from StdIn output. @param[in] None @retval TRUE StdIn stream data available to parse @retval FALSE StdIn stream data is not available to parse. **/ BOOLEAN IsStdInDataAvailable ( VOID ) { SHELL_FILE_HANDLE FileHandle; EFI_STATUS Status; CHAR16 CharBuffer; UINTN CharSize; UINT64 OriginalFilePosition; Status = EFI_SUCCESS; FileHandle = NULL; OriginalFilePosition = 0; if (ShellOpenFileByName (L">i", &FileHandle, EFI_FILE_MODE_READ, 0) == EFI_SUCCESS) { CharSize = sizeof (CHAR16); gEfiShellProtocol->GetFilePosition (FileHandle, &OriginalFilePosition); Status = gEfiShellProtocol->ReadFile (FileHandle, &CharSize, &CharBuffer); if (EFI_ERROR (Status) || (CharSize != sizeof (CHAR16))) { return FALSE; } gEfiShellProtocol->SetFilePosition (FileHandle, OriginalFilePosition); } if (FileHandle == NULL) { return FALSE; } else { return TRUE; } } /** Handle stings for SFO Output with escape character ^ in a string 1. Quotation marks in the string must be escaped by using a ^ character (i.e. ^"). 2. The ^ character may be inserted using ^^. @param[in] String The Unicode NULL-terminated string. @retval NewString The new string handled for SFO. **/ EFI_STRING HandleStringWithEscapeCharForParse ( IN CHAR16 *String ) { EFI_STRING NewStr; EFI_STRING StrWalker; EFI_STRING ReturnStr; if (String == NULL) { return NULL; } // // start to parse the input string. // NewStr = AllocateZeroPool (StrSize (String)); if (NewStr == NULL) { return NULL; } ReturnStr = NewStr; StrWalker = String; while (*StrWalker != CHAR_NULL) { if ((*StrWalker == L'^') && ((*(StrWalker + 1) == L'^') || (*(StrWalker + 1) == L'"'))) { *NewStr = *(StrWalker + 1); StrWalker++; } else { *NewStr = *StrWalker; } StrWalker++; NewStr++; } return ReturnStr; } /** Do the actual parsing of the file. the file should be SFO output from a shell command or a similar format. @param[in] FileName The filename to open. @param[in] TableName The name of the table to find. @param[in] ColumnIndex The column number to get. @param[in] TableNameInstance Which instance of the table to get (row). @param[in] ShellCommandInstance Which instance of the command to get. @param[in] StreamingUnicode Indicates Input file is StdIn Unicode streaming data or not @retval SHELL_NOT_FOUND The requested instance was not found. @retval SHELL_SUCCESS The operation was successful. **/ SHELL_STATUS PerformParsing ( IN CONST CHAR16 *FileName, IN CONST CHAR16 *TableName, IN CONST UINTN ColumnIndex, IN CONST UINTN TableNameInstance, IN CONST UINTN ShellCommandInstance, IN BOOLEAN StreamingUnicode ) { SHELL_FILE_HANDLE FileHandle; EFI_STATUS Status; BOOLEAN Ascii; UINTN LoopVariable; UINTN ColumnLoop; CHAR16 *TempLine; CHAR16 *ColumnPointer; SHELL_STATUS ShellStatus; CHAR16 *TempSpot; CHAR16 *SfoString; ASSERT (FileName != NULL); ASSERT (TableName != NULL); ShellStatus = SHELL_SUCCESS; Status = ShellOpenFileByName (FileName, &FileHandle, EFI_FILE_MODE_READ, 0); if (EFI_ERROR (Status)) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_FILE_OPEN_FAIL), gShellLevel2HiiHandle, L"parse", FileName); ShellStatus = SHELL_NOT_FOUND; } else if (!EFI_ERROR (FileHandleIsDirectory (FileHandle))) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_NOT_FILE), gShellLevel2HiiHandle, L"parse", FileName); ShellStatus = SHELL_NOT_FOUND; } else { for (LoopVariable = 0; LoopVariable < ShellCommandInstance && !ShellFileHandleEof (FileHandle);) { TempLine = ShellFileHandleReturnLine (FileHandle, &Ascii); if ((TempLine == NULL) || ((*TempLine == CHAR_NULL) && StreamingUnicode)) { break; } // // Search for "ShellCommand," in the file to start the SFO table // for a given ShellCommand. The UEFI Shell spec does not specify // a space after the comma. // if (StrStr (TempLine, L"ShellCommand,") == TempLine) { LoopVariable++; } SHELL_FREE_NON_NULL (TempLine); } if (LoopVariable == ShellCommandInstance) { LoopVariable = 0; while (1) { TempLine = ShellFileHandleReturnLine (FileHandle, &Ascii); if ( (TempLine == NULL) || (*TempLine == CHAR_NULL) || (StrStr (TempLine, L"ShellCommand,") == TempLine)) { SHELL_FREE_NON_NULL (TempLine); break; } if (StrStr (TempLine, TableName) == TempLine) { LoopVariable++; if ( (LoopVariable == TableNameInstance) || (TableNameInstance == (UINTN)-1)) { for (ColumnLoop = 1, ColumnPointer = TempLine; ColumnLoop < ColumnIndex && ColumnPointer != NULL && *ColumnPointer != CHAR_NULL; ColumnLoop++) { ColumnPointer = StrStr (ColumnPointer, L",\""); if ((ColumnPointer != NULL) && (*ColumnPointer != CHAR_NULL)) { ColumnPointer++; } } if (ColumnLoop == ColumnIndex) { if (ColumnPointer == NULL) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_NO_VALUE), gShellLevel2HiiHandle, L"parse", L"Column Index"); ShellStatus = SHELL_INVALID_PARAMETER; } else { TempSpot = StrStr (ColumnPointer, L",\""); if (TempSpot != NULL) { *TempSpot = CHAR_NULL; } while (ColumnPointer != NULL && *ColumnPointer != CHAR_NULL && ColumnPointer[0] == L' ') { ColumnPointer++; } if ((ColumnPointer != NULL) && (*ColumnPointer != CHAR_NULL) && (ColumnPointer[0] == L'\"')) { ColumnPointer++; } if ((ColumnPointer != NULL) && (*ColumnPointer != CHAR_NULL) && (ColumnPointer[StrLen (ColumnPointer) - 1] == L'\"')) { ColumnPointer[StrLen (ColumnPointer) - 1] = CHAR_NULL; } SfoString = HandleStringWithEscapeCharForParse (ColumnPointer); if (SfoString != NULL) { ShellPrintEx (-1, -1, L"%s\r\n", SfoString); SHELL_FREE_NON_NULL (SfoString); } } } } } SHELL_FREE_NON_NULL (TempLine); } } } return (ShellStatus); } STATIC CONST SHELL_PARAM_ITEM ParamList[] = { { L"-i", TypeValue }, { L"-s", TypeValue }, { NULL, TypeMax } }; /** Function for 'parse' command. @param[in] ImageHandle Handle to the Image (NULL if Internal). @param[in] SystemTable Pointer to the System Table (NULL if Internal). **/ SHELL_STATUS EFIAPI ShellCommandRunParse ( IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable ) { EFI_STATUS Status; LIST_ENTRY *Package; CHAR16 *ProblemParam; CONST CHAR16 *FileName; CONST CHAR16 *TableName; CONST CHAR16 *ColumnString; SHELL_STATUS ShellStatus; UINTN ShellCommandInstance; UINTN TableNameInstance; BOOLEAN StreamingUnicode; ShellStatus = SHELL_SUCCESS; ProblemParam = NULL; StreamingUnicode = FALSE; // // initialize the shell lib (we must be in non-auto-init...) // Status = ShellInitialize (); ASSERT_EFI_ERROR (Status); // // parse the command line // Status = ShellCommandLineParseEx (ParamList, &Package, &ProblemParam, TRUE, FALSE); if (EFI_ERROR (Status)) { if ((Status == EFI_VOLUME_CORRUPTED) && (ProblemParam != NULL)) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel2HiiHandle, L"parse", ProblemParam); FreePool (ProblemParam); ShellStatus = SHELL_INVALID_PARAMETER; } else { ASSERT (FALSE); } } else { StreamingUnicode = IsStdInDataAvailable (); if ((!StreamingUnicode && (ShellCommandLineGetCount (Package) < 4)) || (ShellCommandLineGetCount (Package) < 3)) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellLevel2HiiHandle, L"parse"); ShellStatus = SHELL_INVALID_PARAMETER; } else if ((StreamingUnicode && (ShellCommandLineGetCount (Package) > 3)) || (ShellCommandLineGetCount (Package) > 4)) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel2HiiHandle, L"parse"); ShellStatus = SHELL_INVALID_PARAMETER; } else { if (StreamingUnicode) { FileName = L">i"; TableName = ShellCommandLineGetRawValue (Package, 1); ColumnString = ShellCommandLineGetRawValue (Package, 2); } else { FileName = ShellCommandLineGetRawValue (Package, 1); TableName = ShellCommandLineGetRawValue (Package, 2); ColumnString = ShellCommandLineGetRawValue (Package, 3); } if (ShellCommandLineGetValue (Package, L"-i") == NULL) { TableNameInstance = (UINTN)-1; } else { TableNameInstance = ShellStrToUintn (ShellCommandLineGetValue (Package, L"-i")); } if (ShellCommandLineGetValue (Package, L"-s") == NULL) { ShellCommandInstance = 1; } else { ShellCommandInstance = ShellStrToUintn (ShellCommandLineGetValue (Package, L"-s")); } ShellStatus = PerformParsing (FileName, TableName, ShellStrToUintn (ColumnString), TableNameInstance, ShellCommandInstance, StreamingUnicode); } } // // free the command line package // ShellCommandLineFreeVarList (Package); return (ShellStatus); }