mirror of https://github.com/acidanthera/audk.git
304 lines
11 KiB
C
304 lines
11 KiB
C
/** @file
|
|
Main file for Help shell level 3 function.
|
|
|
|
Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved. <BR>
|
|
Copyright (c) 2014, ARM Limited. All rights reserved. <BR>
|
|
(C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>
|
|
|
|
This program and the accompanying materials
|
|
are licensed and made available under the terms and conditions of the BSD License
|
|
which accompanies this distribution. The full text of the license may be found at
|
|
http://opensource.org/licenses/bsd-license.php
|
|
|
|
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
**/
|
|
|
|
#include "UefiShellLevel3CommandsLib.h"
|
|
|
|
#include <Library/ShellLib.h>
|
|
#include <Library/HandleParsingLib.h>
|
|
|
|
#include <Protocol/EfiShellDynamicCommand.h>
|
|
|
|
/**
|
|
Attempt to print help from a dynamically added command.
|
|
|
|
@param[in] CommandToGetHelpOn The unicode name of the command that help is
|
|
requested on.
|
|
@param[in] SectionToGetHelpOn Pointer to the section specifier(s).
|
|
@param[in] PrintCommandText Print the command followed by the help content
|
|
or just help.
|
|
|
|
@retval EFI_SUCCESS The help was displayed
|
|
@retval EFI_NOT_FOUND The command name could not be found
|
|
@retval EFI_DEVICE_ERROR The help data format was incorrect.
|
|
**/
|
|
EFI_STATUS
|
|
EFIAPI
|
|
PrintDynamicCommandHelp(
|
|
IN CHAR16 *CommandToGetHelpOn,
|
|
IN CHAR16 *SectionToGetHelpOn,
|
|
IN BOOLEAN PrintCommandText
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
BOOLEAN Found;
|
|
EFI_HANDLE *CommandHandleList;
|
|
EFI_HANDLE *NextCommand;
|
|
EFI_SHELL_DYNAMIC_COMMAND_PROTOCOL *DynamicCommand;
|
|
|
|
Status = EFI_NOT_FOUND;
|
|
Found = FALSE;
|
|
CommandHandleList = NULL;
|
|
|
|
CommandHandleList = GetHandleListByProtocol(&gEfiShellDynamicCommandProtocolGuid);
|
|
|
|
if (CommandHandleList == NULL) {
|
|
//
|
|
// not found or out of resources
|
|
//
|
|
return Status;
|
|
}
|
|
|
|
for (NextCommand = CommandHandleList; *NextCommand != NULL; NextCommand++) {
|
|
Status = gBS->HandleProtocol(
|
|
*NextCommand,
|
|
&gEfiShellDynamicCommandProtocolGuid,
|
|
(VOID **)&DynamicCommand
|
|
);
|
|
|
|
if (EFI_ERROR(Status)) {
|
|
continue;
|
|
}
|
|
|
|
//
|
|
// Check execution break flag when printing multiple command help information.
|
|
//
|
|
if (ShellGetExecutionBreakFlag ()) {
|
|
break;
|
|
}
|
|
|
|
if ((gUnicodeCollation->MetaiMatch (gUnicodeCollation, (CHAR16 *)DynamicCommand->CommandName, CommandToGetHelpOn)) ||
|
|
(gEfiShellProtocol->GetAlias (CommandToGetHelpOn, NULL) != NULL && (gUnicodeCollation->MetaiMatch (gUnicodeCollation, (CHAR16 *)DynamicCommand->CommandName, (CHAR16*)(gEfiShellProtocol->GetAlias(CommandToGetHelpOn, NULL)))))) {
|
|
// Print as Shell Help if in ManPage format.
|
|
Status = ShellPrintHelp (DynamicCommand->CommandName, SectionToGetHelpOn,
|
|
PrintCommandText);
|
|
if (Status == EFI_DEVICE_ERROR) {
|
|
ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_HELP_INV),
|
|
gShellLevel3HiiHandle, DynamicCommand->CommandName);
|
|
} else if (EFI_ERROR(Status)) {
|
|
ShellPrintHiiEx (-1, -1, NULL, STRING_TOKEN (STR_HELP_NF),
|
|
gShellLevel3HiiHandle, DynamicCommand->CommandName);
|
|
} else {
|
|
Found = TRUE;
|
|
}
|
|
}
|
|
}
|
|
|
|
return (Found ? EFI_SUCCESS : Status);
|
|
|
|
}
|
|
|
|
STATIC CONST SHELL_PARAM_ITEM ParamList[] = {
|
|
{L"-usage", TypeFlag},
|
|
{L"-section", TypeMaxValue},
|
|
{L"-verbose", TypeFlag},
|
|
{L"-v", TypeFlag},
|
|
{NULL, TypeMax}
|
|
};
|
|
|
|
/**
|
|
Function for 'help' 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
|
|
ShellCommandRunHelp (
|
|
IN EFI_HANDLE ImageHandle,
|
|
IN EFI_SYSTEM_TABLE *SystemTable
|
|
)
|
|
{
|
|
EFI_STATUS Status;
|
|
LIST_ENTRY *Package;
|
|
CHAR16 *ProblemParam;
|
|
SHELL_STATUS ShellStatus;
|
|
CONST COMMAND_LIST *CommandList;
|
|
CONST COMMAND_LIST *Node;
|
|
CHAR16 *CommandToGetHelpOn;
|
|
CHAR16 *SectionToGetHelpOn;
|
|
CHAR16 *HiiString;
|
|
BOOLEAN Found;
|
|
BOOLEAN PrintCommandText;
|
|
|
|
PrintCommandText = TRUE;
|
|
ProblemParam = NULL;
|
|
ShellStatus = SHELL_SUCCESS;
|
|
CommandToGetHelpOn = NULL;
|
|
SectionToGetHelpOn = NULL;
|
|
Found = FALSE;
|
|
|
|
//
|
|
// 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"help", ProblemParam);
|
|
FreePool(ProblemParam);
|
|
ShellStatus = SHELL_INVALID_PARAMETER;
|
|
} else {
|
|
ASSERT(FALSE);
|
|
}
|
|
} else {
|
|
//
|
|
// Check for conflicting parameters.
|
|
//
|
|
if (ShellCommandLineGetFlag(Package, L"-usage")
|
|
&&ShellCommandLineGetFlag(Package, L"-section")
|
|
&&(ShellCommandLineGetFlag(Package, L"-verbose") || ShellCommandLineGetFlag(Package, L"-v"))
|
|
){
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_PARAM_CON), gShellLevel3HiiHandle, L"help");
|
|
ShellStatus = SHELL_INVALID_PARAMETER;
|
|
} else if (ShellCommandLineGetRawValue(Package, 2) != NULL) {
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_GEN_TOO_MANY), gShellLevel3HiiHandle, L"help");
|
|
ShellStatus = SHELL_INVALID_PARAMETER;
|
|
} else {
|
|
//
|
|
// Get the command name we are getting help on
|
|
//
|
|
ASSERT(CommandToGetHelpOn == NULL);
|
|
StrnCatGrow(&CommandToGetHelpOn, NULL, ShellCommandLineGetRawValue(Package, 1), 0);
|
|
if (CommandToGetHelpOn == NULL && ShellCommandLineGetFlag(Package, L"-?")) {
|
|
//
|
|
// If we dont have a command and we got a simple -?
|
|
// we are looking for help on help command.
|
|
//
|
|
StrnCatGrow(&CommandToGetHelpOn, NULL, L"help", 0);
|
|
}
|
|
|
|
if (CommandToGetHelpOn == NULL) {
|
|
StrnCatGrow(&CommandToGetHelpOn, NULL, L"*", 0);
|
|
ASSERT(SectionToGetHelpOn == NULL);
|
|
StrnCatGrow(&SectionToGetHelpOn, NULL, L"NAME", 0);
|
|
} else {
|
|
PrintCommandText = FALSE;
|
|
ASSERT(SectionToGetHelpOn == NULL);
|
|
//
|
|
// Get the section name for the given command name
|
|
//
|
|
if (ShellCommandLineGetFlag(Package, L"-section")) {
|
|
StrnCatGrow(&SectionToGetHelpOn, NULL, ShellCommandLineGetValue(Package, L"-section"), 0);
|
|
} else if (ShellCommandLineGetFlag(Package, L"-usage")) {
|
|
StrnCatGrow(&SectionToGetHelpOn, NULL, L"NAME,SYNOPSIS", 0);
|
|
} else if (ShellCommandLineGetFlag(Package, L"-verbose") || ShellCommandLineGetFlag(Package, L"-v")) {
|
|
} else {
|
|
//
|
|
// The output of help <command> will display NAME, SYNOPSIS, OPTIONS, DESCRIPTION, and EXAMPLES sections.
|
|
//
|
|
StrnCatGrow (&SectionToGetHelpOn, NULL, L"NAME,SYNOPSIS,OPTIONS,DESCRIPTION,EXAMPLES", 0);
|
|
}
|
|
}
|
|
|
|
if (gUnicodeCollation->StriColl(gUnicodeCollation, CommandToGetHelpOn, L"special") == 0) {
|
|
//
|
|
// we need info on the special characters
|
|
//
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_SC_HEADER), gShellLevel3HiiHandle);
|
|
HiiString = HiiGetString(gShellLevel3HiiHandle, STRING_TOKEN(STR_HELP_SC_DATA), NULL);
|
|
ShellPrintEx(-1, -1, L"%s", HiiString);
|
|
FreePool(HiiString);
|
|
Found = TRUE;
|
|
} else {
|
|
CommandList = ShellCommandGetCommandList(TRUE);
|
|
ASSERT(CommandList != NULL);
|
|
for ( Node = (COMMAND_LIST*)GetFirstNode(&CommandList->Link)
|
|
; CommandList != NULL && !IsListEmpty(&CommandList->Link) && !IsNull(&CommandList->Link, &Node->Link)
|
|
; Node = (COMMAND_LIST*)GetNextNode(&CommandList->Link, &Node->Link)
|
|
){
|
|
//
|
|
// Checking execution break flag when print multiple command help information.
|
|
//
|
|
if (ShellGetExecutionBreakFlag ()) {
|
|
break;
|
|
}
|
|
if ((gUnicodeCollation->MetaiMatch(gUnicodeCollation, Node->CommandString, CommandToGetHelpOn)) ||
|
|
(gEfiShellProtocol->GetAlias(CommandToGetHelpOn, NULL) != NULL && (gUnicodeCollation->MetaiMatch(gUnicodeCollation, Node->CommandString, (CHAR16*)(gEfiShellProtocol->GetAlias(CommandToGetHelpOn, NULL)))))) {
|
|
//
|
|
// We have a command to look for help on.
|
|
//
|
|
Status = ShellPrintHelp(Node->CommandString, SectionToGetHelpOn, PrintCommandText);
|
|
if (Status == EFI_DEVICE_ERROR) {
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_INV), gShellLevel3HiiHandle, Node->CommandString);
|
|
} else if (EFI_ERROR(Status)) {
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_NF), gShellLevel3HiiHandle, Node->CommandString);
|
|
} else {
|
|
Found = TRUE;
|
|
}
|
|
}
|
|
}
|
|
|
|
//
|
|
// now try to match against the dynamic command list and print help
|
|
//
|
|
Status = PrintDynamicCommandHelp (CommandToGetHelpOn, SectionToGetHelpOn,
|
|
PrintCommandText);
|
|
if (!EFI_ERROR(Status)) {
|
|
Found = TRUE;
|
|
}
|
|
|
|
//
|
|
// Search the .man file for Shell applications (Shell external commands).
|
|
//
|
|
if (!Found) {
|
|
Status = ShellPrintHelp(CommandToGetHelpOn, SectionToGetHelpOn, FALSE);
|
|
if (Status == EFI_DEVICE_ERROR) {
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_INV), gShellLevel3HiiHandle, CommandToGetHelpOn);
|
|
} else if (EFI_ERROR(Status)) {
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_NF), gShellLevel3HiiHandle, CommandToGetHelpOn);
|
|
} else {
|
|
Found = TRUE;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!Found) {
|
|
ShellStatus = SHELL_NOT_FOUND;
|
|
}
|
|
|
|
//
|
|
// free the command line package
|
|
//
|
|
ShellCommandLineFreeVarList (Package);
|
|
}
|
|
}
|
|
|
|
if (CommandToGetHelpOn != NULL && StrCmp(CommandToGetHelpOn, L"*") == 0){
|
|
//
|
|
// If '*' then the command entered was 'Help' without qualifiers, This footer
|
|
// provides additional info on help switches
|
|
//
|
|
ShellPrintHiiEx(-1, -1, NULL, STRING_TOKEN (STR_HELP_FOOTER), gShellLevel3HiiHandle);
|
|
}
|
|
if (CommandToGetHelpOn != NULL) {
|
|
FreePool(CommandToGetHelpOn);
|
|
}
|
|
if (SectionToGetHelpOn != NULL) {
|
|
FreePool(SectionToGetHelpOn);
|
|
}
|
|
|
|
return (ShellStatus);
|
|
}
|