/** @file Main file for Alias shell level 3 function. (C) Copyright 2015 Hewlett-Packard Development Company, L.P.
Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent **/ #include "UefiShellLevel3CommandsLib.h" #include /** Print out single alias registered with the Shell. @param[in] Alias Points to the NULL-terminated shell alias. If this parameter is NULL, then all aliases will be returned in ReturnedData. @retval SHELL_SUCCESS the printout was successful **/ SHELL_STATUS PrintSingleShellAlias ( IN CONST CHAR16 *Alias ) { CONST CHAR16 *ConstAliasVal; SHELL_STATUS ShellStatus; BOOLEAN Volatile; ShellStatus = SHELL_SUCCESS; ConstAliasVal = gEfiShellProtocol->GetAlias (Alias, &Volatile); if (ConstAliasVal == NULL) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_INV), gShellLevel3HiiHandle, L"alias", Alias); ShellStatus = SHELL_INVALID_PARAMETER; } else { if (ShellCommandIsOnAliasList (Alias)) { Volatile = FALSE; } ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_ALIAS_OUTPUT), gShellLevel3HiiHandle, !Volatile ? L' ' : L'*', Alias, ConstAliasVal); } return ShellStatus; } /** Print out each alias registered with the Shell. @retval STATUS_SUCCESS the printout was successful @return any return code from GetNextVariableName except EFI_NOT_FOUND **/ SHELL_STATUS PrintAllShellAlias ( VOID ) { CONST CHAR16 *ConstAllAliasList; CHAR16 *Alias; CHAR16 *Walker; ConstAllAliasList = gEfiShellProtocol->GetAlias (NULL, NULL); if (ConstAllAliasList == NULL) { return (SHELL_SUCCESS); } Alias = AllocateZeroPool (StrSize (ConstAllAliasList)); if (Alias == NULL) { return (SHELL_OUT_OF_RESOURCES); } Walker = (CHAR16 *)ConstAllAliasList; do { CopyMem (Alias, Walker, StrSize (Walker)); Walker = StrStr (Alias, L";"); if (Walker != NULL) { Walker[0] = CHAR_NULL; Walker = Walker + 1; } PrintSingleShellAlias (Alias); } while (Walker != NULL && Walker[0] != CHAR_NULL); FreePool (Alias); return (SHELL_SUCCESS); } /** Changes a shell command alias. This function creates an alias for a shell command or if Alias is NULL it will delete an existing alias. @param[in] Command Points to the NULL-terminated shell command or existing alias. @param[in] Alias Points to the NULL-terminated alias for the shell command. If this is NULL, and Command refers to an alias, that alias will be deleted. @param[in] Replace If TRUE and the alias already exists, then the existing alias will be replaced. If FALSE and the alias already exists, then the existing alias is unchanged and EFI_ACCESS_DENIED is returned. @param[in] Volatile if TRUE the Alias being set will be stored in a volatile fashion. if FALSE the Alias being set will be stored in a non-volatile fashion. @retval SHELL_SUCCESS Alias created or deleted successfully. @retval SHELL_NOT_FOUND the Alias intended to be deleted was not found @retval SHELL_ACCESS_DENIED The alias is a built-in alias or already existed and Replace was set to FALSE. @retval SHELL_DEVICE_ERROR Command is null or the empty string. **/ SHELL_STATUS ShellLevel3CommandsLibSetAlias ( IN CONST CHAR16 *Command, IN CONST CHAR16 *Alias, IN BOOLEAN Replace, IN BOOLEAN Volatile ) { SHELL_STATUS ShellStatus; EFI_STATUS Status; ShellStatus = SHELL_SUCCESS; Status = gEfiShellProtocol->SetAlias (Command, Alias, Replace, Volatile); if (EFI_ERROR (Status)) { if (Status == EFI_ACCESS_DENIED) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_AD), gShellLevel3HiiHandle, L"alias"); ShellStatus = SHELL_ACCESS_DENIED; } else if (Status == EFI_NOT_FOUND) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_NOT_FOUND), gShellLevel3HiiHandle, L"alias", Command); ShellStatus = SHELL_NOT_FOUND; } else { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_ERR_UK), gShellLevel3HiiHandle, L"alias", Status); ShellStatus = SHELL_DEVICE_ERROR; } } return ShellStatus; } STATIC CONST SHELL_PARAM_ITEM ParamList[] = { { L"-v", TypeFlag }, { L"-d", TypeValue }, { NULL, TypeMax } }; /** Function for 'alias' 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 ShellCommandRunAlias ( IN EFI_HANDLE ImageHandle, IN EFI_SYSTEM_TABLE *SystemTable ) { EFI_STATUS Status; LIST_ENTRY *Package; CHAR16 *ProblemParam; SHELL_STATUS ShellStatus; CONST CHAR16 *Param1; CONST CHAR16 *Param2; CONST CHAR16 *ParamStrD; CHAR16 *CleanParam2; BOOLEAN DeleteFlag; BOOLEAN VolatileFlag; ProblemParam = NULL; ShellStatus = SHELL_SUCCESS; CleanParam2 = NULL; // // initialize the shell lib (we must be in non-auto-init...) // Status = ShellInitialize (); ASSERT_EFI_ERROR (Status); Status = CommandInit (); ASSERT_EFI_ERROR (Status); // // parse the command line // Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE); if (EFI_ERROR (Status)) { if ((Status == EFI_VOLUME_CORRUPTED) && (ProblemParam != NULL)) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel3HiiHandle, L"alias", ProblemParam); FreePool (ProblemParam); ShellStatus = SHELL_INVALID_PARAMETER; } else { ASSERT (FALSE); } } else { Param1 = ShellCommandLineGetRawValue (Package, 1); Param2 = ShellCommandLineGetRawValue (Package, 2); DeleteFlag = ShellCommandLineGetFlag (Package, L"-d"); VolatileFlag = ShellCommandLineGetFlag (Package, L"-v"); if (Param2 != NULL) { CleanParam2 = AllocateCopyPool (StrSize (Param2), Param2); if (CleanParam2 == NULL) { ShellCommandLineFreeVarList (Package); return SHELL_OUT_OF_RESOURCES; } if ((CleanParam2[0] == L'\"') && (CleanParam2[StrLen (CleanParam2)-1] == L'\"')) { CleanParam2[StrLen (CleanParam2)-1] = L'\0'; CopyMem (CleanParam2, CleanParam2 + 1, StrSize (CleanParam2) - sizeof (CleanParam2[0])); } } if (!DeleteFlag && !VolatileFlag) { switch (ShellCommandLineGetCount (Package)) { case 1: // // "alias" // ShellStatus = PrintAllShellAlias (); break; case 2: // // "alias Param1" // ShellStatus = PrintSingleShellAlias (Param1); break; case 3: // // "alias Param1 CleanParam2" // ShellStatus = ShellLevel3CommandsLibSetAlias (CleanParam2, Param1, FALSE, VolatileFlag); break; default: ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel3HiiHandle, L"alias"); ShellStatus = SHELL_INVALID_PARAMETER; } } else if (DeleteFlag) { if (VolatileFlag || (ShellCommandLineGetCount (Package) > 1)) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel3HiiHandle, L"alias"); ShellStatus = SHELL_INVALID_PARAMETER; } else { ParamStrD = ShellCommandLineGetValue (Package, L"-d"); if (ParamStrD == NULL) { ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellLevel3HiiHandle, L"alias"); ShellStatus = SHELL_INVALID_PARAMETER; } else { // // Delete an alias: "alias -d ParamStrD" // ShellStatus = ShellLevel3CommandsLibSetAlias (ParamStrD, NULL, TRUE, FALSE); } } } else { // // Set volatile alias. // ASSERT (VolatileFlag); ASSERT (!DeleteFlag); switch (ShellCommandLineGetCount (Package)) { case 1: case 2: ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_FEW), gShellLevel3HiiHandle, L"alias"); ShellStatus = SHELL_INVALID_PARAMETER; break; case 3: // // "alias -v Param1 CleanParam2" // ShellStatus = ShellLevel3CommandsLibSetAlias (CleanParam2, Param1, FALSE, VolatileFlag); break; default: ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel3HiiHandle, L"alias"); ShellStatus = SHELL_INVALID_PARAMETER; } } // // free the command line package // ShellCommandLineFreeVarList (Package); } SHELL_FREE_NON_NULL (CleanParam2); return (ShellStatus); }