cp - fix conditional for memory de-allocaiton.

[mirror_edk2.git] / ShellPkg / Library / UefiShellLevel3CommandsLib / Help.c

/** @file\r
  Main file for Help shell level 3 function.\r
\r
  Copyright (c) 2009 - 2011, Intel Corporation. All rights reserved. <BR>\r
  This program and the accompanying materials\r
  are licensed and made available under the terms and conditions of the BSD License\r
  which accompanies this distribution.  The full text of the license may be found at\r
  http://opensource.org/licenses/bsd-license.php\r
\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
\r
#include "UefiShellLevel3CommandsLib.h"\r
\r
#include <Library/ShellLib.h>\r
\r
STATIC CONST SHELL_PARAM_ITEM ParamList[] = {\r
  {L"-usage", TypeFlag},\r
  {L"-section", TypeMaxValue},\r
  {L"-verbose", TypeFlag},\r
  {L"-v", TypeFlag},\r
  {NULL, TypeMax}\r
  };\r
\r
/**\r
  Function for 'help' command.\r
\r
  @param[in] ImageHandle  Handle to the Image (NULL if Internal).\r
  @param[in] SystemTable  Pointer to the System Table (NULL if Internal).\r
**/\r
SHELL_STATUS\r
EFIAPI\r
ShellCommandRunHelp (\r
  IN EFI_HANDLE        ImageHandle,\r
  IN EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS          Status;\r
  LIST_ENTRY          *Package;\r
  CHAR16              *ProblemParam;\r
  SHELL_STATUS        ShellStatus;\r
  CHAR16              *OutText;\r
  CONST COMMAND_LIST  *CommandList;\r
  CONST COMMAND_LIST  *Node;\r
  CHAR16              *CommandToGetHelpOn;\r
  CHAR16              *SectionToGetHelpOn;\r
  CHAR16              *HiiString;\r
  BOOLEAN             Found;\r
\r
  ProblemParam        = NULL;\r
  ShellStatus         = SHELL_SUCCESS;\r
  OutText             = NULL;\r
  CommandToGetHelpOn  = NULL;\r
  SectionToGetHelpOn  = NULL;\r
  Found               = FALSE;\r
\r
  //\r
  // initialize the shell lib (we must be in non-auto-init...)\r
  //\r
  Status = ShellInitialize();\r
  ASSERT_EFI_ERROR(Status);\r
\r
  Status = CommandInit();\r
  ASSERT_EFI_ERROR(Status);\r
\r
  //\r
  // parse the command line\r
  //\r
  Status = ShellCommandLineParse (ParamList, &Package, &ProblemParam, TRUE);\r
  if (EFI_ERROR(Status)) {\r
    if (Status == EFI_VOLUME_CORRUPTED && ProblemParam != NULL) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PROBLEM), gShellLevel3HiiHandle, ProblemParam);\r
      FreePool(ProblemParam);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      ASSERT(FALSE);\r
    }\r
  } else {\r
    //\r
    // Check for conflicting parameters.\r
    //\r
    if (ShellCommandLineGetFlag(Package, L"-usage")\r
      &&ShellCommandLineGetFlag(Package, L"-section")\r
      &&(ShellCommandLineGetFlag(Package, L"-verbose") || ShellCommandLineGetFlag(Package, L"-v"))\r
     ){\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_CON), gShellLevel3HiiHandle);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else if (ShellCommandLineGetRawValue(Package, 2) != NULL) {\r
      ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel3HiiHandle);\r
      ShellStatus = SHELL_INVALID_PARAMETER;\r
    } else {\r
      //\r
      // Get the command name we are getting help on\r
      //\r
      ASSERT(CommandToGetHelpOn == NULL);\r
      StrnCatGrow(&CommandToGetHelpOn, NULL, ShellCommandLineGetRawValue(Package, 1), 0);\r
      if (CommandToGetHelpOn == NULL && ShellCommandLineGetFlag(Package, L"-?")) {\r
        //\r
        // If we dont have a command and we got a simple -?\r
        // we are looking for help on help command.\r
        //\r
        StrnCatGrow(&CommandToGetHelpOn, NULL, L"help", 0);\r
      }\r
\r
      if (CommandToGetHelpOn == NULL) {\r
        StrnCatGrow(&CommandToGetHelpOn, NULL, L"*", 0);\r
        ASSERT(SectionToGetHelpOn == NULL);\r
        StrnCatGrow(&SectionToGetHelpOn, NULL, L"NAME", 0);\r
      } else {\r
        ASSERT(SectionToGetHelpOn == NULL);\r
        //\r
        // Get the section name for the given command name\r
        //\r
        if (ShellCommandLineGetFlag(Package, L"-section")) {\r
          StrnCatGrow(&SectionToGetHelpOn, NULL, ShellCommandLineGetValue(Package, L"-section"), 0);\r
        } else if (ShellCommandLineGetFlag(Package, L"-usage")) {\r
          StrnCatGrow(&SectionToGetHelpOn, NULL, L"NAME,SYNOPSIS", 0);\r
        } else if (ShellCommandLineGetFlag(Package, L"-verbose") || ShellCommandLineGetFlag(Package, L"-v")) {\r
        } else {\r
          StrnCatGrow(&SectionToGetHelpOn, NULL, L"NAME", 0);\r
        }\r
      }\r
\r
      if (gUnicodeCollation->StriColl(gUnicodeCollation, CommandToGetHelpOn, L"special") == 0) {\r
        //\r
        // we need info on the special characters\r
        //\r
        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_SC_HEADER), gShellLevel3HiiHandle);\r
        HiiString = HiiGetString(gShellLevel3HiiHandle, STRING_TOKEN(STR_HELP_SC_DATA), NULL);\r
        ShellPrintEx(-1, -1, L"%s", HiiString);\r
        FreePool(HiiString);\r
        Found = TRUE;\r
      } else {\r
        CommandList = ShellCommandGetCommandList(TRUE);\r
        ASSERT(CommandList != NULL);\r
        for ( Node = (COMMAND_LIST*)GetFirstNode(&CommandList->Link)\r
            ; CommandList != NULL && !IsListEmpty(&CommandList->Link) && !IsNull(&CommandList->Link, &Node->Link)\r
            ; Node = (COMMAND_LIST*)GetNextNode(&CommandList->Link, &Node->Link)\r
           ){\r
          if ((gUnicodeCollation->MetaiMatch(gUnicodeCollation, Node->CommandString, CommandToGetHelpOn)) ||\r
             (gEfiShellProtocol->GetAlias(CommandToGetHelpOn, NULL) != NULL && (gUnicodeCollation->MetaiMatch(gUnicodeCollation, Node->CommandString, (CHAR16*)(gEfiShellProtocol->GetAlias(CommandToGetHelpOn, NULL)))))) {\r
            //\r
            // We have a command to look for help on.\r
            //\r
            Status = gEfiShellProtocol->GetHelpText(Node->CommandString, SectionToGetHelpOn, &OutText);\r
            if (EFI_ERROR(Status) || OutText == NULL) {\r
              if (Status == EFI_DEVICE_ERROR) {\r
                ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_INV), gShellLevel3HiiHandle, Node->CommandString);\r
              } else {\r
                ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_NF), gShellLevel3HiiHandle, Node->CommandString);\r
              }\r
              ShellStatus = SHELL_NOT_FOUND;\r
            } else {\r
              while (OutText[StrLen(OutText)-1] == L'\r' || OutText[StrLen(OutText)-1] == L'\n' || OutText[StrLen(OutText)-1] == L' ') {\r
                OutText[StrLen(OutText)-1] = CHAR_NULL;\r
              }\r
              ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_COMMAND), gShellLevel3HiiHandle, Node->CommandString, OutText);\r
              FreePool(OutText);\r
              OutText = NULL;\r
              Found = TRUE;\r
            }\r
          }\r
        }\r
      }\r
\r
      if (!Found && ShellStatus == SHELL_SUCCESS) {\r
        ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_NF), gShellLevel3HiiHandle, CommandToGetHelpOn);\r
        ShellStatus = SHELL_NOT_FOUND;\r
      }\r
\r
      //\r
      // free the command line package\r
      //\r
      ShellCommandLineFreeVarList (Package);\r
    }\r
  }\r
  if (CommandToGetHelpOn != NULL) {\r
    FreePool(CommandToGetHelpOn);\r
  }\r
  if (SectionToGetHelpOn != NULL) {\r
    FreePool(SectionToGetHelpOn);\r
  }\r
\r
  return (ShellStatus);\r
}\r
\r