-/*++\r
+/** @file\r
\r
-Copyright (c) 2007 - 2016, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007 - 2016, 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
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
-Module Name:\r
-\r
- Ebc.c\r
-\r
-Abstract:\r
-\r
---*/\r
+**/\r
\r
#include <Uefi.h>\r
#include "Edb.h"\r
L"EXCEPT_EBC_SINGLE_STEP",\r
};\r
\r
+/**\r
+\r
+ Clear all the breakpoint.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param NeedRemove Whether need to remove all the breakpoint\r
+\r
+**/\r
VOID\r
EdbClearAllBreakpoint (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN BOOLEAN NeedRemove\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Clear all the breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- NeedRemove - Whether need to remove all the breakpoint\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
return ;\r
}\r
\r
+/**\r
+\r
+ Set all the breakpoint.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+\r
+**/\r
VOID\r
EdbSetAllBreakpoint (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Set all the breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
UINTN Index;\r
UINT16 Data16;\r
return ;\r
}\r
\r
-VOID\r
-EdbCheckBreakpoint (\r
- IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
- IN EFI_SYSTEM_CONTEXT SystemContext\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
Check all the breakpoint, if match, then set status flag, and record current breakpoint.\r
Then clear all breakpoint to let user see a clean memory\r
\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- SystemContext - EBC system context.\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param SystemContext EBC system context.\r
\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EdbCheckBreakpoint (\r
+ IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
+ IN EFI_SYSTEM_CONTEXT SystemContext\r
+ )\r
{\r
UINT64 Address;\r
UINTN Index;\r
return ;\r
}\r
\r
+/**\r
+ clear all the symbol.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+\r
+**/\r
VOID\r
EdbClearSymbol (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- clear all the symbol\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_CONTEXT *DebuggerSymbolContext;\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
return ;\r
}\r
\r
+/**\r
+\r
+ Initialize Debugger private data structure\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+ @param Initialized Whether the DebuggerPrivate data is initialized.\r
+\r
+**/\r
EFI_STATUS\r
InitDebuggerPrivateData (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
IN BOOLEAN Initialized\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Initialize Debugger private data structure\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
- Initialized - Whether the DebuggerPrivate data is initialized.\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
//\r
// clear STEP flag in any condition.\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ De-initialize Debugger private data structure.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+ @param Initialized Whether the DebuggerPrivate data is initialized.\r
+\r
+**/\r
EFI_STATUS\r
DeinitDebuggerPrivateData (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
IN BOOLEAN Initialized\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- De-initialize Debugger private data structure\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
- Initialized - Whether the DebuggerPrivate data is initialized.\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
if (!Initialized) {\r
//\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Print the reason of current break to EbcDebugger.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+ @param Initialized Whether the DebuggerPrivate data is initialized.\r
+\r
+**/\r
VOID\r
PrintExceptionReason (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
IN BOOLEAN Initialized\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the reason of current break to EbcDebugger.\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
- Initialized - Whether the DebuggerPrivate data is initialized.\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
//\r
// Print break status\r
return ;\r
}\r
\r
-VOID\r
-EFIAPI\r
-EdbExceptionHandler (\r
- IN EFI_EXCEPTION_TYPE ExceptionType,\r
- IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The default Exception Callback for the VM interpreter.\r
In this function, we report status code, and print debug information\r
about EBC_CONTEXT, then dead loop.\r
\r
-Arguments:\r
-\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- None\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
\r
---*/\r
+**/\r
+VOID\r
+EFIAPI\r
+EdbExceptionHandler (\r
+ IN EFI_EXCEPTION_TYPE ExceptionType,\r
+ IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
+ )\r
{\r
CHAR16 InputBuffer[EFI_DEBUG_INPUS_BUFFER_SIZE];\r
CHAR16 *CommandArg;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- Edb.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_H_\r
#define _EFI_EDB_H_\r
#define EFI_DEBUG_BREAK 2\r
#define EFI_DEBUG_CONTINUE 3\r
\r
-//\r
-// Function\r
-//\r
+/**\r
+ Driver Entry point.\r
+\r
+ @param ImageHandle ImageHandle of the loaded driver.\r
+ @param SystemTable Pointer to the EFI System Table.\r
+\r
+**/\r
EFI_STATUS\r
EfiDebuggerEntrypoint (\r
IN EFI_HANDLE ImageHandle,\r
IN EFI_SYSTEM_TABLE *SystemTable\r
);\r
\r
+/**\r
+\r
+ The default Exception Callback for the VM interpreter.\r
+ In this function, we report status code, and print debug information\r
+ about EBC_CONTEXT, then dead loop.\r
+\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+**/\r
VOID\r
EFIAPI\r
EdbExceptionHandler (\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdBranch.c\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#include "Edb.h"\r
\r
L"(JMP8)",\r
};\r
\r
-CHAR16 *\r
-EdbBranchTypeToStr (\r
- IN EFI_DEBUGGER_BRANCH_TYPE Type\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Comvert Branch Type to string\r
+/**\r
\r
-Arguments:\r
+ Comvert Branch Type to string.\r
\r
- Type - Branch Type\r
+ @param Type Branch Type\r
\r
-Returns:\r
+ @retval String string of Branch Type.\r
\r
- String\r
-\r
---*/\r
+**/\r
+CHAR16 *\r
+EdbBranchTypeToStr (\r
+ IN EFI_DEBUGGER_BRANCH_TYPE Type\r
+ )\r
{\r
if (Type < 0 || Type >= EfiDebuggerBranchTypeEbcMax) {\r
return L"(Unknown Type)";\r
return mBranchTypeStr [Type];\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - CallStack.\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerCallStack (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - CallStack\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
INTN Index;\r
UINTN SubIndex;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - InstructionBranch.\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerInstructionBranch (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - InstructionBranch\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdBreak.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
\r
---*/\r
+/**\r
\r
-#include "Edb.h"\r
+ DebuggerCommand - BreakOnCALL.\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakOnCALL (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakOnCALL\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
//\r
// Check argument\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand BreakOnCALLEX.\r
+\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exceptiont type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakOnCALLEX (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakOnCALLEX\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
//\r
// Check argument\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakOnRET.\r
+\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakOnRET (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakOnRET\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
//\r
// Check argument\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakOnEntrypoint.\r
+\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakOnEntrypoint (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakOnEntrypoint\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
//\r
// Check argument\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
-EFI_DEBUG_STATUS\r
-DebuggerBreakOnThunk (\r
- IN CHAR16 *CommandArg,\r
- IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
- IN EFI_EXCEPTION_TYPE ExceptionType,\r
- IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
- )\r
-/*++\r
+/**\r
\r
-Routine Description:\r
\r
- DebuggerCommand - BreakOnThunk\r
+ DebuggerCommand - BreakOnThunk.\r
\r
-Arguments:\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
\r
-Returns:\r
\r
- EFI_DEBUG_CONTINUE - formal return value\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
\r
---*/\r
+**/\r
+EFI_DEBUG_STATUS\r
+DebuggerBreakOnThunk (\r
+ IN CHAR16 *CommandArg,\r
+ IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
+ IN EFI_EXCEPTION_TYPE ExceptionType,\r
+ IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
+ )\r
{\r
//\r
// Check argument\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakOnKey.\r
+\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakOnKey (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakOnKey\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
//\r
// Check argument\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007 - 2016, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007 - 2016, 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
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
-Module Name:\r
\r
- EdbCmdBreakpoint.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ Check whether current IP is EBC BREAK3 instruction.\r
\r
-#include "Edb.h"\r
+ @param Address EBC IP address.\r
\r
+ @retval TRUE Current IP is EBC BREAK3 instruction\r
+ @retval FALSE Current IP is not EBC BREAK3 instruction\r
+\r
+**/\r
BOOLEAN\r
IsEBCBREAK3 (\r
IN UINTN Address\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check whether current IP is EBC BREAK3 instruction\r
-\r
-Arguments:\r
-\r
- Address - EBC IP address.\r
-\r
-Returns:\r
-\r
- TRUE - Current IP is EBC BREAK3 instruction\r
- FALSE - Current IP is not EBC BREAK3 instruction\r
-\r
---*/\r
{\r
if (GET_OPCODE(Address) != OPCODE_BREAK) {\r
return FALSE;\r
}\r
}\r
\r
+/**\r
+\r
+ Check whether the Address is already set in breakpoint.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param Address Breakpoint Address\r
+\r
+ @retval TRUE breakpoint is found\r
+ @retval FALSE breakpoint is not found\r
+\r
+**/\r
BOOLEAN\r
DebuggerBreakpointIsDuplicated (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN Address\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check whether the Address is already set in breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- Address - Breakpoint Address\r
-\r
-Returns:\r
-\r
- TRUE - breakpoint is found\r
- FALSE - breakpoint is not found\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
return FALSE;\r
}\r
\r
+/**\r
+\r
+ Add this breakpoint.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param Address Breakpoint Address\r
+\r
+ @retval EFI_SUCCESS breakpoint added successfully\r
+ @retval EFI_ALREADY_STARTED breakpoint is already added\r
+ @retval EFI_OUT_OF_RESOURCES all the breakpoint entries are used\r
+\r
+**/\r
EFI_STATUS\r
DebuggerBreakpointAdd (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN Address\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Add this breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- Address - Breakpoint Address\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - breakpoint added successfully\r
- EFI_ALREADY_STARTED - breakpoint is already added\r
- EFI_OUT_OF_RESOURCES - all the breakpoint entries are used\r
-\r
---*/\r
{\r
//\r
// Check duplicated breakpoint\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Delete this breakpoint.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param Index Breakpoint Index\r
+\r
+ @retval EFI_SUCCESS breakpoint deleted successfully\r
+ @retval EFI_NOT_FOUND breakpoint not found\r
+\r
+**/\r
EFI_STATUS\r
DebuggerBreakpointDel (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN Index\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Delete this breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- Index - Breakpoint Index\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - breakpoint deleted successfully\r
- EFI_NOT_FOUND - breakpoint not found\r
-\r
---*/\r
{\r
UINTN BpIndex;\r
\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Disable this breakpoint.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param Index Breakpoint Index\r
+\r
+ @retval EFI_SUCCESS breakpoint disabled successfully\r
+ @retval EFI_NOT_FOUND breakpoint not found\r
+\r
+**/\r
EFI_STATUS\r
DebuggerBreakpointDis (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN Index\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disable this breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- Index - Breakpoint Index\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - breakpoint disabled successfully\r
- EFI_NOT_FOUND - breakpoint not found\r
-\r
---*/\r
{\r
if ((Index >= EFI_DEBUGGER_BREAKPOINT_MAX) ||\r
(Index >= DebuggerPrivate->DebuggerBreakpointCount)) {\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Enable this breakpoint.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param Index - Breakpoint Index\r
+\r
+ @retval EFI_SUCCESS - breakpoint enabled successfully\r
+ @retval EFI_NOT_FOUND - breakpoint not found\r
+\r
+**/\r
EFI_STATUS\r
DebuggerBreakpointEn (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN Index\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Enable this breakpoint\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- Index - Breakpoint Index\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - breakpoint enabled successfully\r
- EFI_NOT_FOUND - breakpoint not found\r
-\r
---*/\r
{\r
if ((Index >= EFI_DEBUGGER_BREAKPOINT_MAX) ||\r
(Index >= DebuggerPrivate->DebuggerBreakpointCount)) {\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakpointList.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakpointList (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakpointList\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakpointSet.\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakpointSet (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakpointSet\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Address;\r
EFI_STATUS Status;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakpointClear\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakpointClear (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakpointClear\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
EFI_STATUS Status;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - BreakpointDisable\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakpointDisable (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakpointDisable\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
EFI_STATUS Status;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+ DebuggerCommand - BreakpointEnable.\r
+\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerBreakpointEnable (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - BreakpointEnable\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
EFI_STATUS Status;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdExtIo.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ DebuggerCommand - IB.\r
\r
-#include "Edb.h"\r
+ @param CommandArg The argument for this command\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param ExceptionType Exception type.\r
+ @param SystemContext EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtIoIB (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - IB\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+\r
+/**\r
+\r
+ DebuggerCommand - IW.\r
+\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtIoIW (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - IW\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - ID.\r
+\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtIoID (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - ID\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - OB.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtIoOB (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - OB\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+\r
+/**\r
+\r
+ DebuggerCommand - OW.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtIoOW (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - OW\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+\r
+/**\r
+\r
+ DebuggerCommand - OD.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtIoOD (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - OD\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdExtPci.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ DebuggerCommand - PCIL.\r
\r
-#include "Edb.h"\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtPciPCIL (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - PCIL\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - PCID.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtPciPCID (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - PCID\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - CFGB.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtPciCFGB (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - CFGB\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+\r
+/**\r
+\r
+ DebuggerCommand - CFGW.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtPciCFGW (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - CFGW\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - CFGD.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerExtPciCFGD (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - CFGD\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EDBPrint (L"Unsupported\n");\r
//\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdGo.c\r
\r
-Abstract:\r
+**/\r
\r
+#include "Edb.h"\r
\r
---*/\r
+/**\r
\r
-#include "Edb.h"\r
+ DebuggerCommand - Go.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
\r
+ @retval EFI_DEBUG_BREAK - formal return value\r
+ @retval EFI_DEBUG_CONTINUE - something wrong\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerGo (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - Go\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_BREAK - formal return value\r
- EFI_DEBUG_CONTINUE - something wrong\r
-\r
---*/\r
{\r
UINTN Address;\r
CHAR16 *CommandStr;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdHelp.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ DebuggerCommand - Help.\r
\r
-#include "Edb.h"\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerHelp (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - Help\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdMemory.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
\r
---*/\r
+/**\r
\r
-#include "Edb.h"\r
+ Display memory unit.\r
+\r
+ @param Address - Memory Address\r
+ @param Width - Memory Width\r
\r
+ @return Length of the memory unit\r
+\r
+**/\r
UINTN\r
EdbDisplayMemoryUnit (\r
IN UINTN Address,\r
IN EDB_DATA_WIDTH Width\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Display memory unit\r
-\r
-Arguments:\r
-\r
- Address - Memory Address\r
- Width - Memory Width\r
-\r
-Returns:\r
-\r
- Length of the memory unit\r
-\r
---*/\r
{\r
UINT8 Data8;\r
UINT16 Data16;\r
return 0;\r
}\r
\r
+/**\r
+\r
+ Display memory.\r
+\r
+ @param Address - Memory Address\r
+ @param Count - Memory Count\r
+ @param Width - Memory Width\r
+\r
+**/\r
VOID\r
EdbDisplayMemory (\r
IN UINTN Address,\r
IN UINTN Count,\r
IN EDB_DATA_WIDTH Width\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Display memory\r
-\r
-Arguments:\r
-\r
- Address - Memory Address\r
- Count - Memory Count\r
- Width - Memory Width\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
UINTN LineNumber;\r
UINTN ByteNumber;\r
return ;\r
}\r
\r
+/**\r
+\r
+ Entry memory.\r
+\r
+ @param Address - Memory Address\r
+ @param Value - Memory Value\r
+ @param Width - Memory Width\r
+\r
+**/\r
VOID\r
EdbEnterMemory (\r
IN UINTN Address,\r
IN VOID *Value,\r
IN EDB_DATA_WIDTH Width\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Entry memory\r
-\r
-Arguments:\r
-\r
- Address - Memory Address\r
- Value - Memory Value\r
- Width - Memory Width\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
switch (Width) {\r
case EdbWidthUint8:\r
return ;\r
}\r
\r
+/**\r
+\r
+ Get memory address and count.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param Address - Memory Address\r
+ @param Count - Memory Count\r
+\r
+ @retval EFI_SUCCESS - memory address and count are got\r
+ @retval EFI_INVALID_PARAMETER - something wrong\r
+\r
+**/\r
EFI_STATUS\r
EdbGetMemoryAddressCount (\r
IN CHAR16 *CommandArg,\r
IN UINTN *Address,\r
IN UINTN *Count\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get memory address and count\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- Address - Memory Address\r
- Count - Memory Count\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - memory address and count are got\r
- EFI_INVALID_PARAMETER - something wrong\r
-\r
---*/\r
{\r
CHAR16 *CommandStr;\r
UINTN MemAddress;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Get memory address and value.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param Address - Memory Address\r
+ @param Value - Memory Value\r
+\r
+ @retval EFI_SUCCESS - memory address and value are got\r
+ @retval EFI_INVALID_PARAMETER - something wrong\r
+\r
+**/\r
EFI_STATUS\r
EdbGetMemoryAddressValue (\r
IN CHAR16 *CommandArg,\r
IN UINTN *Address,\r
IN UINT64 *Value\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get memory address and value\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- Address - Memory Address\r
- Value - Memory Value\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - memory address and value are got\r
- EFI_INVALID_PARAMETER - something wrong\r
-\r
---*/\r
{\r
CHAR16 *CommandStr;\r
UINTN MemAddress;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Display memory.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param Width - Memory Width\r
+\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryDisplay (\r
IN CHAR16 *CommandArg,\r
IN EDB_DATA_WIDTH Width\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Display memory\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- Width - Memory Width\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
UINTN Address;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ Enter memory.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param Width - Memory Width\r
+\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryEnter (\r
IN CHAR16 *CommandArg,\r
IN EDB_DATA_WIDTH Width\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Enter memory\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- Width - Memory Width\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
UINTN Address;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - DB.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryDB (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - DB\r
+{\r
+ return DebuggerMemoryDisplay (CommandArg, EdbWidthUint8);\r
+}\r
\r
-Arguments:\r
+/**\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+ DebuggerCommand - DW.\r
\r
-Returns:\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
-{\r
- return DebuggerMemoryDisplay (CommandArg, EdbWidthUint8);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryDW (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - DW\r
+{\r
+ return DebuggerMemoryDisplay (CommandArg, EdbWidthUint16);\r
+}\r
\r
-Arguments:\r
+/**\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+ DebuggerCommand - DD.\r
\r
-Returns:\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
-{\r
- return DebuggerMemoryDisplay (CommandArg, EdbWidthUint16);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryDD (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - DD\r
-\r
-Arguments:\r
+{\r
+ return DebuggerMemoryDisplay (CommandArg, EdbWidthUint32);\r
+}\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+/**\r
\r
-Returns:\r
+ DebuggerCommand - DQ.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
\r
---*/\r
-{\r
- return DebuggerMemoryDisplay (CommandArg, EdbWidthUint32);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryDQ (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - DQ\r
-\r
-Arguments:\r
+{\r
+ return DebuggerMemoryDisplay (CommandArg, EdbWidthUint64);\r
+}\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+/**\r
\r
-Returns:\r
+ DebuggerCommand - EB.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
\r
---*/\r
-{\r
- return DebuggerMemoryDisplay (CommandArg, EdbWidthUint64);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryEB (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - EB\r
+{\r
+ return DebuggerMemoryEnter (CommandArg, EdbWidthUint8);\r
+}\r
\r
-Arguments:\r
+/**\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+ DebuggerCommand - EW.\r
\r
-Returns:\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Interrupt type.\r
+ @param SystemContext - EBC system context.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
-{\r
- return DebuggerMemoryEnter (CommandArg, EdbWidthUint8);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryEW (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - EW\r
+{\r
+ return DebuggerMemoryEnter (CommandArg, EdbWidthUint16);\r
+}\r
\r
-Arguments:\r
+/**\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+ DebuggerCommand - ED.\r
\r
-Returns:\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
-{\r
- return DebuggerMemoryEnter (CommandArg, EdbWidthUint16);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryED (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - ED\r
-\r
-Arguments:\r
+{\r
+ return DebuggerMemoryEnter (CommandArg, EdbWidthUint32);\r
+}\r
\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
+/**\r
\r
-Returns:\r
+ DebuggerCommand - EQ.\r
\r
- EFI_DEBUG_RETURN - formal return value\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
\r
---*/\r
-{\r
- return DebuggerMemoryEnter (CommandArg, EdbWidthUint32);\r
-}\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerMemoryEQ (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - EQ\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
{\r
return DebuggerMemoryEnter (CommandArg, EdbWidthUint64);\r
}\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
Abstract:\r
\r
\r
---*/\r
+**/\r
\r
#include "Edb.h"\r
\r
+/**\r
+\r
+ DebuggerCommand - Quit\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_RETURN - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerQuit (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - Quit\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_RETURN - formal return value\r
-\r
---*/\r
{\r
return EFI_DEBUG_RETURN;\r
}\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdRegister.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ DebuggerCommand - Register.\r
\r
-#include "Edb.h"\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerRegister (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - Register\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
CHAR16 *RegName;\r
CHAR16 *RegValStr;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdScope.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ DebuggerCommand - Scope.\r
\r
-#include "Edb.h"\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerScope (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - Scope\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
UINTN Address;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - List.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerList (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - List\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
if (CommandArg == NULL) {\r
EdbShowDisasm (DebuggerPrivate, SystemContext);\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCmdStep.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
+\r
+/**\r
\r
+ Check whether current IP is EBC CALL instruction (NOTE: CALLEX is exclusive)\r
\r
---*/\r
+ @param Address - EBC IP address.\r
\r
-#include "Edb.h"\r
+ @retval TRUE - Current IP is EBC CALL instruction\r
+ @retval FALSE - Current IP is not EBC CALL instruction\r
\r
+**/\r
BOOLEAN\r
IsEBCCALL (\r
IN UINTN Address\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check whether current IP is EBC CALL instruction (NOTE: CALLEX is exclusive)\r
-\r
-Arguments:\r
-\r
- Address - EBC IP address.\r
-\r
-Returns:\r
-\r
- TRUE - Current IP is EBC CALL instruction\r
- FALSE - Current IP is not EBC CALL instruction\r
-\r
---*/\r
{\r
if (GET_OPCODE(Address) != OPCODE_CALL) {\r
return FALSE;\r
}\r
}\r
\r
-BOOLEAN\r
-IsEBCRET (\r
- IN UINTN Address\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check whether current IP is EBC RET instruction\r
+/**\r
\r
-Arguments:\r
+ Check whether current IP is EBC RET instruction.\r
\r
- Address - EBC IP address.\r
+ @param Address - EBC IP address.\r
\r
-Returns:\r
+ @retval TRUE - Current IP is EBC RET instruction\r
+ @retval FALSE - Current IP is not EBC RET instruction\r
\r
- TRUE - Current IP is EBC RET instruction\r
- FALSE - Current IP is not EBC RET instruction\r
-\r
---*/\r
+**/\r
+BOOLEAN\r
+IsEBCRET (\r
+ IN UINTN Address\r
+ )\r
{\r
if (GET_OPCODE(Address) != OPCODE_RET) {\r
return FALSE;\r
}\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - StepInto.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerStepInto (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - StepInto\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
SystemContext.SystemContextEbc->Flags |= VMFLAGS_STEP;\r
\r
return EFI_DEBUG_BREAK;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - StepOver.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerStepOver (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - StepOver\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
if (IsEBCCALL((UINTN)SystemContext.SystemContextEbc->Ip)) {\r
//\r
return EFI_DEBUG_BREAK;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - StepOut.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerStepOut (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - StepOut\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
if (IsEBCRET((UINTN)SystemContext.SystemContextEbc->Ip)) {\r
//\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007 - 2016, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007 - 2016, 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
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
-Module Name:\r
\r
- EdbCmdSymbol.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ Get file name from full path.\r
\r
-#include "Edb.h"\r
+ @param FullPath - full file path\r
+\r
+ @return file name\r
\r
+**/\r
CHAR16 *\r
GetFileNameFromFullPath (\r
IN CHAR16 *FullPath\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get file name from full path\r
-\r
-Arguments:\r
-\r
- FullPath - full file path\r
-\r
-Returns:\r
-\r
- file name\r
-\r
---*/\r
{\r
CHAR16 *FileName;\r
CHAR16 *TempFileName;\r
return FileName;\r
}\r
\r
-CHAR16 *\r
-GetDirNameFromFullPath (\r
- IN CHAR16 *FullPath\r
- )\r
-/*++\r
+/**\r
\r
-Routine Description:\r
+ Get dir name from full path.\r
\r
- Get dir name from full path\r
+ @param FullPath - full file path\r
\r
-Arguments:\r
+ @return dir name\r
\r
- FullPath - full file path\r
-\r
-Returns:\r
-\r
- dir name\r
-\r
---*/\r
+**/\r
+CHAR16 *\r
+GetDirNameFromFullPath (\r
+ IN CHAR16 *FullPath\r
+ )\r
{\r
CHAR16 *FileName;\r
\r
return L"";\r
}\r
\r
+/**\r
+\r
+ Construct full path accroding to dir and file path.\r
+\r
+ @param DirPath - dir path\r
+ @param FilePath - file path\r
+ @param Size - dir max size\r
+\r
+ @return Full file name\r
+\r
+**/\r
CHAR16 *\r
ConstructFullPath (\r
IN CHAR16 *DirPath,\r
IN CHAR16 *FilePath,\r
IN UINTN Size\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Construct full path accroding to dir and file path\r
-\r
-Arguments:\r
-\r
- DirPath - dir path\r
- FilePath - file path\r
- Size - dir max size\r
-\r
-Returns:\r
-\r
- Full file name\r
-\r
---*/\r
{\r
UINTN DirPathSize;\r
\r
L"(SV)",\r
};\r
\r
-CHAR16 *\r
-EdbSymbolTypeToStr (\r
- IN EFI_DEBUGGER_SYMBOL_TYPE Type\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Comvert Symbol Type to string\r
-\r
-Arguments:\r
+/**\r
\r
- Type - Symbol Type\r
+ Comvert Symbol Type to string.\r
\r
-Returns:\r
+ @param Type - Symbol Type\r
\r
- String\r
+ @return String\r
\r
---*/\r
+**/\r
+CHAR16 *\r
+EdbSymbolTypeToStr (\r
+ IN EFI_DEBUGGER_SYMBOL_TYPE Type\r
+ )\r
{\r
if (Type < 0 || Type >= EfiDebuggerSymbolTypeMax) {\r
return L"(?)";\r
return mSymbolTypeStr [Type];\r
}\r
\r
+/**\r
+\r
+ Find the symbol accroding to address and display symbol.\r
+\r
+ @param Address - SymbolAddress\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerDisplaySymbolAccrodingToAddress (\r
IN UINTN Address,\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the symbol accroding to address and display symbol\r
-\r
-Arguments:\r
-\r
- Address - SymbolAddress\r
- DebuggerPrivate - EBC Debugger private data structure\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
EFI_DEBUGGER_SYMBOL_ENTRY *Entry;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ Find the symbol accroding to name and display symbol.\r
+\r
+ @param SymbolFileName - The Symbol File Name, NULL means for all\r
+ @param SymbolName - The Symbol Name, NULL means for all\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerDisplaySymbolAccrodingToName (\r
IN CHAR16 *SymbolFileName,\r
IN CHAR16 *SymbolName,\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the symbol accroding to name and display symbol\r
-\r
-Arguments:\r
-\r
- SymbolFileName - The Symbol File Name, NULL means for all\r
- SymbolName - The Symbol Name, NULL means for all\r
- DebuggerPrivate - EBC Debugger private data structure\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN Index;\r
UINTN SubIndex;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - ListSymbol.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerListSymbol (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - ListSymbol\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
CHAR16 *SymbolFileName;\r
CHAR16 *SymbolName;\r
return DebuggerDisplaySymbolAccrodingToName (SymbolFileName, SymbolName, DebuggerPrivate);\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - LoadSymbol.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerLoadSymbol (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - LoadSymbol\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN BufferSize;\r
VOID *Buffer;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - UnloadSymbol\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerUnloadSymbol (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - UnloadSymbol\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
CHAR16 *FileName;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - DisplaySymbol.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerDisplaySymbol (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - DisplaySymbol\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
if (CommandArg == NULL) {\r
DebuggerPrivate->DebuggerSymbolContext.DisplaySymbol = !DebuggerPrivate->DebuggerSymbolContext.DisplaySymbol;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - LoadCode.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerLoadCode (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - LoadCode\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
UINTN BufferSize;\r
VOID *Buffer;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - UnloadCode.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerUnloadCode (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - UnloadCode\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
CHAR16 *CommandArg2;\r
CHAR16 *FileName;\r
return EFI_DEBUG_CONTINUE;\r
}\r
\r
+/**\r
+\r
+ DebuggerCommand - DisplayCode.\r
+\r
+ @param CommandArg - The argument for this command\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param ExceptionType - Exception type.\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_DEBUG_CONTINUE - formal return value\r
+\r
+**/\r
EFI_DEBUG_STATUS\r
DebuggerDisplayCode (\r
IN CHAR16 *CommandArg,\r
IN EFI_EXCEPTION_TYPE ExceptionType,\r
IN OUT EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- DebuggerCommand - DisplayCode\r
-\r
-Arguments:\r
-\r
- CommandArg - The argument for this command\r
- DebuggerPrivate - EBC Debugger private data structure\r
- InterruptType - Interrupt type.\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_DEBUG_CONTINUE - formal return value\r
-\r
---*/\r
{\r
if (CommandArg == NULL) {\r
DebuggerPrivate->DebuggerSymbolContext.DisplayCodeOnly = !DebuggerPrivate->DebuggerSymbolContext.DisplayCodeOnly;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCommand.c\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#include "Edb.h"\r
\r
},\r
};\r
\r
+/**\r
+\r
+ Find the command according to name.\r
+\r
+ @param CommandName - Command Name\r
+ @param CommandArg - Command Argument\r
+\r
+ @return Not NULL - The DebuggerCommand is found successfully\r
+ @return NULL - not found\r
+\r
+**/\r
EFI_DEBUGGER_COMMAND\r
MatchDebuggerCommand (\r
IN CHAR16 *CommandName,\r
IN CHAR16 **CommandArg\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the command according to name\r
-\r
-Arguments:\r
-\r
- CommandName - Command Name\r
- CommandArg - Command Argument\r
-\r
-Returns:\r
-\r
- Not NULL - The DebuggerCommand is found successfully\r
- NULL - not found\r
-\r
---*/\r
{\r
UINTN Index;\r
CHAR16 *Temp;\r
return NULL;\r
}\r
\r
-CHAR16 *\r
-GetCommandNameByKey (\r
- IN EFI_INPUT_KEY CommandKey\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Find the command name according to the function key\r
+ Find the command name according to the function key.\r
\r
-Arguments:\r
+ @param CommandKey - Command Function Key\r
\r
- CommandKey - Command Function Key\r
+ @return Not NULL - The DebuggerName is found successfully\r
+ @return NULL - not found\r
\r
-Returns:\r
-\r
- Not NULL - The DebuggerName is found successfully\r
- NULL - not found\r
-\r
---*/\r
+**/\r
+CHAR16 *\r
+GetCommandNameByKey (\r
+ IN EFI_INPUT_KEY CommandKey\r
+ )\r
{\r
UINTN Index;\r
\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbCommand.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_COMMAND_H_\r
#define _EFI_EDB_COMMAND_H_\r
EdbWidthMax\r
} EDB_DATA_WIDTH;\r
\r
+/**\r
+\r
+ Find the command according to name.\r
+\r
+ @param CommandName - Command Name\r
+ @param CommandArg - Command Argument\r
+\r
+ @return Not NULL - The DebuggerCommand is found successfully\r
+ @return NULL - not found\r
+\r
+**/\r
EFI_DEBUGGER_COMMAND\r
MatchDebuggerCommand (\r
IN CHAR16 *CommandName,\r
IN CHAR16 **CommandArg\r
);\r
\r
+/**\r
+\r
+ Find the command name according to the function key.\r
+\r
+ @param CommandKey - Command Function Key\r
+\r
+ @return Not NULL - The DebuggerName is found successfully\r
+ @return NULL - not found\r
+\r
+**/\r
CHAR16 *\r
GetCommandNameByKey (\r
IN EFI_INPUT_KEY CommandKey\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
-\r
- EdbCommon.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_COMMON_H_\r
#define _EFI_EDB_COMMON_H_\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbDisasm.c\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#include "Edb.h"\r
\r
EdbDisasmMOVREL, // opcode 0x39 MOVREL\r
};\r
\r
+/**\r
+\r
+ Disasm instruction - BREAK.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmBREAK (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - BREAK\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
ASSERT (GET_OPCODE(InstructionAddress) == OPCODE_BREAK);\r
\r
\r
extern CONST UINT8 mJMPLen[];\r
\r
+/**\r
+\r
+ Disasm instruction - JMP.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmJMP (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - JMP\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - JMP8.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmJMP8 (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - JMP8\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
\r
return 2;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - CALL.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmCALL (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - CALL\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - RET.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmRET (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - RET\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
ASSERT (GET_OPCODE(InstructionAddress) == OPCODE_RET);\r
\r
return 2;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - CMP.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmCMP (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - CMP\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Opcode;\r
UINT8 Modifiers;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - Unsigned Data Manipulate.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmUnsignedDataManip (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - Unsigned Data Manipulate\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Opcode;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - Signed Data Manipulate,\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmSignedDataManip (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - Signed Data Manipulate\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Opcode;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - MOVxx.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmMOVxx (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - MOVxx\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Opcode;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - MOVsnw.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmMOVsnw (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - MOVsnw\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - MOVsnd.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmMOVsnd (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - MOVsnd\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - LOADSP.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmLOADSP (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - LOADSP\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Operands;\r
\r
return 2;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - STORESP.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmSTORESP (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - STORESP\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Operands;\r
\r
return 2;\r
}\r
\r
+\r
+/**\r
+\r
+ Disasm instruction - PUSH.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmPUSH (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - PUSH\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - POP.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmPOP (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - POP\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - CMPI.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmCMPI (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - CMPI\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Opcode;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - PUSHn.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmPUSHn (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - PUSHn\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - POPn.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmPOPn (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - POPn\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - MOVI.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmMOVI (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - MOVI\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - MOVIn.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmMOVIn (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - MOVIn\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
return Size;\r
}\r
\r
+/**\r
+\r
+ Disasm instruction - MOVREL.\r
+\r
+ @param InstructionAddress - The instruction address\r
+ @param SystemContext - EBC system context.\r
+ @param DisasmString - The instruction string\r
+\r
+ @return Instruction length\r
+\r
+**/\r
UINTN\r
EdbDisasmMOVREL (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
OUT CHAR16 **DisasmString\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Disasm instruction - MOVREL\r
-\r
-Arguments:\r
-\r
- InstructionAddress - The instruction address\r
- SystemContext - EBC system context.\r
- DisasmString - The instruction string\r
-\r
-Returns:\r
-\r
- Instruction length\r
-\r
---*/\r
{\r
UINT8 Modifiers;\r
UINT8 Operands;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbDisasm.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_DISASM_H_\r
#define _EFI_EDB_DISASM_H_\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbDisasmSupport.c\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#include "Edb.h"\r
\r
UINTN mInstructionNameOffset;\r
UINTN mInstructionContentOffset;\r
\r
+/**\r
+\r
+ Set offset for Instruction name and content.\r
+\r
+ @param InstructionNameOffset - Instruction name offset\r
+ @param InstructionContentOffset - Instruction content offset\r
+\r
+**/\r
VOID\r
EdbSetOffset (\r
IN UINTN InstructionNameOffset,\r
IN UINTN InstructionContentOffset\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Set offset for Instruction name and content\r
-\r
-Arguments:\r
-\r
- InstructionNameOffset - Instruction name offset\r
- InstructionContentOffset - Instruction content offset\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
mInstructionNameOffset = InstructionNameOffset;\r
mInstructionContentOffset = InstructionContentOffset;\r
return ;\r
}\r
\r
+/**\r
+\r
+ Pre instruction string construction.\r
+\r
+ @return Instruction string\r
+\r
+**/\r
CHAR16 *\r
EdbPreInstructionString (\r
VOID\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Pre instruction string construction\r
-\r
-Arguments:\r
-\r
- None\r
-\r
-Returns:\r
-\r
- Instruction string\r
-\r
---*/\r
{\r
ZeroMem (&mInstructionString, sizeof(mInstructionString));\r
mInstructionNameOffset = 0;\r
return (CHAR16 *)&mInstructionString;\r
}\r
\r
+/**\r
+\r
+ Post instruction string construction.\r
+\r
+ @return Instruction string\r
+\r
+**/\r
CHAR16 *\r
EdbPostInstructionString (\r
VOID\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Post instruction string construction\r
-\r
-Arguments:\r
-\r
- None\r
-\r
-Returns:\r
-\r
- Instruction string\r
-\r
---*/\r
{\r
CHAR16 *Char;\r
\r
return (CHAR16 *)&mInstructionString;\r
}\r
\r
+/**\r
+\r
+ Get Sign, NaturalUnits, and ConstantUnits of the WORD data.\r
+\r
+ @param Data16 - WORD data\r
+ @param NaturalUnits - Natural Units of the WORD\r
+ @param ConstantUnits - Constant Units of the WORD\r
+\r
+ @return Sign value of WORD\r
+\r
+**/\r
BOOLEAN\r
EdbGetNaturalIndex16 (\r
IN UINT16 Data16,\r
OUT UINTN *NaturalUnits,\r
OUT UINTN *ConstantUnits\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get Sign, NaturalUnits, and ConstantUnits of the WORD data\r
-\r
-Arguments:\r
-\r
- Data16 - WORD data\r
- NaturalUnits - Natural Units of the WORD\r
- ConstantUnits - Constant Units of the WORD\r
-\r
-Returns:\r
-\r
- Sign value of WORD\r
-\r
---*/\r
{\r
BOOLEAN Sign;\r
UINTN NaturalUnitBit;\r
return Sign;\r
}\r
\r
+/**\r
+\r
+ Get Sign, NaturalUnits, and ConstantUnits of the DWORD data.\r
+\r
+ @param Data32 - DWORD data\r
+ @param NaturalUnits - Natural Units of the DWORD\r
+ @param ConstantUnits - Constant Units of the DWORD\r
+\r
+ @return Sign value of DWORD\r
+\r
+**/\r
BOOLEAN\r
EdbGetNaturalIndex32 (\r
IN UINT32 Data32,\r
OUT UINTN *NaturalUnits,\r
OUT UINTN *ConstantUnits\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get Sign, NaturalUnits, and ConstantUnits of the DWORD data\r
-\r
-Arguments:\r
-\r
- Data32 - DWORD data\r
- NaturalUnits - Natural Units of the DWORD\r
- ConstantUnits - Constant Units of the DWORD\r
-\r
-Returns:\r
-\r
- Sign value of DWORD\r
-\r
---*/\r
{\r
BOOLEAN Sign;\r
UINTN NaturalUnitBit;\r
return Sign;\r
}\r
\r
+/**\r
+\r
+ Get Sign, NaturalUnits, and ConstantUnits of the QWORD data.\r
+\r
+ @param Data64 - QWORD data\r
+ @param NaturalUnits - Natural Units of the QWORD\r
+ @param ConstantUnits - Constant Units of the QWORD\r
+\r
+ @return Sign value of QWORD\r
+\r
+**/\r
BOOLEAN\r
EdbGetNaturalIndex64 (\r
IN UINT64 Data64,\r
OUT UINT64 *NaturalUnits,\r
OUT UINT64 *ConstantUnits\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get Sign, NaturalUnits, and ConstantUnits of the QWORD data\r
-\r
-Arguments:\r
-\r
- Data64 - QWORD data\r
- NaturalUnits - Natural Units of the QWORD\r
- ConstantUnits - Constant Units of the QWORD\r
-\r
-Returns:\r
-\r
- Sign value of QWORD\r
-\r
---*/\r
{\r
BOOLEAN Sign;\r
UINTN NaturalUnitBit;\r
return Sign;\r
}\r
\r
-UINT8\r
-EdbGetBitWidth (\r
- IN UINT64 Value\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get Bit Width of the value\r
+/**\r
\r
-Arguments:\r
+ Get Bit Width of the value.\r
\r
- Value - data\r
+ @param Value - data\r
\r
-Returns:\r
+ @return Bit width\r
\r
- Bit width\r
-\r
---*/\r
+**/\r
+UINT8\r
+EdbGetBitWidth (\r
+ IN UINT64 Value\r
+ )\r
{\r
if (Value >= 10000000000000) {\r
return 14;\r
}\r
}\r
\r
-UINTN\r
-EdbPrintInstructionName (\r
- IN CHAR16 *Name\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print the instruction name\r
+ Print the instruction name.\r
\r
-Arguments:\r
+ @param Name - instruction name\r
\r
- Name - instruction name\r
+ @return Instruction name offset\r
\r
-Returns:\r
-\r
- Instruction name offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintInstructionName (\r
+ IN CHAR16 *Name\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Name,\r
return mInstructionNameOffset;\r
}\r
\r
-UINTN\r
-EdbPrintRegister1 (\r
- IN UINT8 Operands\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print register 1 in operands\r
-\r
-Arguments:\r
+/**\r
\r
- Operands - instruction operands\r
+ Print register 1 in operands.\r
\r
-Returns:\r
+ @param Operands - instruction operands\r
\r
- Instruction content offset\r
+ @return Instruction content offset\r
\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintRegister1 (\r
+ IN UINT8 Operands\r
+ )\r
{\r
if (Operands & OPERAND_M_INDIRECT1) {\r
EDBSPrintWithOffset (\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintRegister2 (\r
- IN UINT8 Operands\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print register 2 in operands\r
+ Print register 2 in operands.\r
\r
-Arguments:\r
+ @param Operands - instruction operands\r
\r
- Operands - instruction operands\r
+ @return Instruction content offset\r
\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintRegister2 (\r
+ IN UINT8 Operands\r
+ )\r
{\r
if (Operands & OPERAND_M_INDIRECT2) {\r
EDBSPrintWithOffset (\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintDedicatedRegister1 (\r
- IN UINT8 Operands\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print dedicated register 1 in operands\r
-\r
-Arguments:\r
+/**\r
\r
- Operands - instruction operands\r
+ Print dedicated register 1 in operands.\r
\r
-Returns:\r
+ @param Operands - instruction operands\r
\r
- Instruction content offset\r
+ @return Instruction content offset\r
\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintDedicatedRegister1 (\r
+ IN UINT8 Operands\r
+ )\r
{\r
switch (Operands & OPERAND_M_OP1) {\r
case 0:\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintDedicatedRegister2 (\r
- IN UINT8 Operands\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print dedicated register 2 in operands\r
+/**\r
\r
-Arguments:\r
+ Print dedicated register 2 in operands.\r
\r
- Operands - instruction operands\r
+ @param Operands - instruction operands\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintDedicatedRegister2 (\r
+ IN UINT8 Operands\r
+ )\r
{\r
switch ((Operands & OPERAND_M_OP2) >> 4) {\r
case 0:\r
return mInstructionContentOffset;\r
}\r
\r
+/**\r
+\r
+ Print the hexical UINTN index data to instruction content.\r
+\r
+ @param Sign - Signed bit of UINTN data\r
+ @param NaturalUnits - natural units of UINTN data\r
+ @param ConstantUnits - natural units of UINTN data\r
+\r
+ @return Instruction content offset\r
+\r
+**/\r
UINTN\r
EdbPrintIndexData (\r
IN BOOLEAN Sign,\r
IN UINTN NaturalUnits,\r
IN UINTN ConstantUnits\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical UINTN index data to instruction content\r
-\r
-Arguments:\r
-\r
- Sign - Signed bit of UINTN data\r
- NaturalUnits - natural units of UINTN data\r
- ConstantUnits - natural units of UINTN data\r
-\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
+/**\r
+\r
+ Print the hexical QWORD index data to instruction content.\r
+\r
+ @param Sign - Signed bit of QWORD data\r
+ @param NaturalUnits - natural units of QWORD data\r
+ @param ConstantUnits - natural units of QWORD data\r
+\r
+ @return Instruction content offset\r
+\r
+**/\r
UINTN\r
EdbPrintIndexData64 (\r
IN BOOLEAN Sign,\r
IN UINT64 NaturalUnits,\r
IN UINT64 ConstantUnits\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical QWORD index data to instruction content\r
-\r
-Arguments:\r
-\r
- Sign - Signed bit of QWORD data\r
- NaturalUnits - natural units of QWORD data\r
- ConstantUnits - natural units of QWORD data\r
-\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintRawIndexData16 (\r
- IN UINT16 Data16\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical WORD raw index data to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the hexical WORD raw index data to instruction content.\r
\r
- Data16 - WORD data\r
+ @param Data16 - WORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintRawIndexData16 (\r
+ IN UINT16 Data16\r
+ )\r
{\r
BOOLEAN Sign;\r
UINTN NaturalUnits;\r
return Offset;\r
}\r
\r
-UINTN\r
-EdbPrintRawIndexData32 (\r
- IN UINT32 Data32\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical DWORD raw index data to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the hexical DWORD raw index data to instruction content.\r
\r
- Data32 - DWORD data\r
+ @param Data32 - DWORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintRawIndexData32 (\r
+ IN UINT32 Data32\r
+ )\r
{\r
BOOLEAN Sign;\r
UINTN NaturalUnits;\r
return Offset;\r
}\r
\r
-UINTN\r
-EdbPrintRawIndexData64 (\r
- IN UINT64 Data64\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical QWORD raw index data to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the hexical QWORD raw index data to instruction content.\r
\r
- Data64 - QWORD data\r
+ @param Data64 - QWORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintRawIndexData64 (\r
+ IN UINT64 Data64\r
+ )\r
{\r
BOOLEAN Sign;\r
UINT64 NaturalUnits;\r
return Offset;\r
}\r
\r
-UINTN\r
-EdbPrintImmData8 (\r
- IN UINT8 Data\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print the hexical BYTE immediate data to instruction content\r
+ Print the hexical BYTE immediate data to instruction content.\r
\r
-Arguments:\r
+ @param Data - BYTE data\r
\r
- Data - BYTE data\r
+ @return Instruction content offset\r
\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintImmData8 (\r
+ IN UINT8 Data\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintImmData16 (\r
- IN UINT16 Data\r
- )\r
-/*++\r
+/**\r
\r
-Routine Description:\r
+ Print the hexical WORD immediate data to instruction content.\r
\r
- Print the hexical WORD immediate data to instruction content\r
+ @param Data - WORD data\r
\r
-Arguments:\r
+ @return Instruction content offset\r
\r
- Data - WORD data\r
-\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintImmData16 (\r
+ IN UINT16 Data\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintImmData32 (\r
- IN UINT32 Data\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical DWORD immediate data to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the hexical DWORD immediate data to instruction content.\r
\r
- Data - DWORD data\r
+ @param Data - DWORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintImmData32 (\r
+ IN UINT32 Data\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintImmData64 (\r
- IN UINT64 Data\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print the hexical QWORD immediate data to instruction content\r
+ Print the hexical QWORD immediate data to instruction content.\r
\r
-Arguments:\r
+ @param Data - QWORD data\r
\r
- Data - QWORD data\r
+ @return Instruction content offset\r
\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintImmData64 (\r
+ IN UINT64 Data\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintImmDatan (\r
- IN UINTN Data\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the decimal UINTN immediate data to instruction content\r
-\r
-Arguments:\r
+/**\r
\r
- Data - UINTN data\r
+ Print the decimal UINTN immediate data to instruction content.\r
\r
-Returns:\r
+ @param Data - UINTN data\r
\r
- Instruction content offset\r
+ @return Instruction content offset\r
\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintImmDatan (\r
+ IN UINTN Data\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintImmData64n (\r
- IN UINT64 Data64\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print the decimal QWORD immediate data to instruction content\r
+ Print the decimal QWORD immediate data to instruction content.\r
\r
-Arguments:\r
+ @param Data64 - QWORD data\r
\r
- Data64 - QWORD data\r
+ @return Instruction content offset\r
\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintImmData64n (\r
+ IN UINT64 Data64\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData8 (\r
- IN UINT8 Data8\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical BYTE to instruction content\r
-\r
-Arguments:\r
+/**\r
\r
- Data8 - BYTE data\r
+ Print the hexical BYTE to instruction content.\r
\r
-Returns:\r
+ @param Data8 - BYTE data\r
\r
- Instruction content offset\r
+ @return Instruction content offset\r
\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData8 (\r
+ IN UINT8 Data8\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData16 (\r
- IN UINT16 Data16\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical WORD to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the hexical WORD to instruction content.\r
\r
- Data16 - WORD data\r
+ @param Data16 - WORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData16 (\r
+ IN UINT16 Data16\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData32 (\r
- IN UINT32 Data32\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print the hexical DWORD to instruction content\r
+ Print the hexical DWORD to instruction content.\r
\r
-Arguments:\r
+ @param Data32 - DWORD data\r
\r
- Data32 - DWORD data\r
+ @return Instruction content offset\r
\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData32 (\r
+ IN UINT32 Data32\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData64 (\r
- IN UINT64 Data64\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the hexical QWORD to instruction content\r
-\r
-Arguments:\r
+/**\r
\r
- Data64 - QWORD data\r
+ Print the hexical QWORD to instruction content.\r
\r
-Returns:\r
+ @param Data64 - QWORD data\r
\r
- Instruction content offset\r
+ @return Instruction content offset\r
\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData64 (\r
+ IN UINT64 Data64\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintDatan (\r
- IN UINTN Data\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the decimal unsigned UINTN to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the decimal unsigned UINTN to instruction content.\r
\r
- Data - unsigned UINTN data\r
+ @param Data - unsigned UINTN data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintDatan (\r
+ IN UINTN Data\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData64n (\r
- IN UINT64 Data64\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the decimal unsigned QWORD to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the decimal unsigned QWORD to instruction content.\r
\r
- Data64 - unsigned QWORD data\r
+ @param Data64 - unsigned QWORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData64n (\r
+ IN UINT64 Data64\r
+ )\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData8s (\r
- IN UINT8 Data8\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the decimal signed BYTE to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the decimal signed BYTE to instruction content.\r
\r
- Data8 - signed BYTE data\r
+ @param Data8 - signed BYTE data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData8s (\r
+ IN UINT8 Data8\r
+ )\r
{\r
BOOLEAN Sign;\r
\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData16s (\r
- IN UINT16 Data16\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Print the decimal signed WORD to instruction content\r
+ Print the decimal signed WORD to instruction content.\r
\r
-Arguments:\r
+ @param Data16 - signed WORD data\r
\r
- Data16 - signed WORD data\r
+ @return Instruction content offset\r
\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData16s (\r
+ IN UINT16 Data16\r
+ )\r
{\r
BOOLEAN Sign;\r
\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData32s (\r
- IN UINT32 Data32\r
- )\r
-/*++\r
+/**\r
\r
-Routine Description:\r
+ Print the decimal signed DWORD to instruction content.\r
\r
- Print the decimal signed DWORD to instruction content\r
+ @param Data32 - signed DWORD data\r
\r
-Arguments:\r
+ @return Instruction content offset\r
\r
- Data32 - signed DWORD data\r
-\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData32s (\r
+ IN UINT32 Data32\r
+ )\r
{\r
BOOLEAN Sign;\r
\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbPrintData64s (\r
- IN UINT64 Data64\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the decimal signed QWORD to instruction content\r
+/**\r
\r
-Arguments:\r
+ Print the decimal signed QWORD to instruction content.\r
\r
- Data64 - signed QWORD data\r
+ @param Data64 - signed QWORD data\r
\r
-Returns:\r
+ @return Instruction content offset\r
\r
- Instruction content offset\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbPrintData64s (\r
+ IN UINT64 Data64\r
+ )\r
{\r
BOOLEAN Sign;\r
INT64 Data64s;\r
return mInstructionContentOffset;\r
}\r
\r
+/**\r
+\r
+ Print the comma to instruction content.\r
+\r
+ @return Instruction content offset\r
+\r
+**/\r
UINTN\r
EdbPrintComma (\r
VOID\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the comma to instruction content\r
-\r
-Arguments:\r
-\r
- None\r
-\r
-Returns:\r
-\r
- Instruction content offset\r
-\r
---*/\r
{\r
EDBSPrintWithOffset (\r
mInstructionString.Content,\r
return mInstructionContentOffset;\r
}\r
\r
-UINTN\r
-EdbFindAndPrintSymbol (\r
- IN UINTN Address\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the symbol string according to address, then print it\r
+/**\r
\r
-Arguments:\r
+ Find the symbol string according to address, then print it.\r
\r
- Address - instruction address\r
+ @param Address - instruction address\r
\r
-Returns:\r
+ @retval 1 - symbol string is found and printed\r
+ @retval 0 - symbol string not found\r
\r
- 1 - symbol string is found and printed\r
- 0 - symbol string not found\r
-\r
---*/\r
+**/\r
+UINTN\r
+EdbFindAndPrintSymbol (\r
+ IN UINTN Address\r
+ )\r
{\r
CHAR8 *SymbolStr;\r
\r
return 0;\r
}\r
\r
+/**\r
+\r
+ Print the EBC byte code.\r
+\r
+ @param InstructionAddress - instruction address\r
+ @param InstructionNumber - instruction number\r
+\r
+**/\r
VOID\r
EdbPrintRaw (\r
IN EFI_PHYSICAL_ADDRESS InstructionAddress,\r
IN UINTN InstructionNumber\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the EBC byte code\r
-\r
-Arguments:\r
-\r
- InstructionAddress - instruction address\r
- InstructionNumber - instruction number\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
UINTN LineNumber;\r
UINTN ByteNumber;\r
return ;\r
}\r
\r
+/**\r
+\r
+ Print the EBC asm code.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param SystemContext - EBC system context.\r
+\r
+ @retval EFI_SUCCESS - show disasm successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbShowDisasm (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN EFI_SYSTEM_CONTEXT SystemContext\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print the EBC asm code\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- SystemContext - EBC system context.\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - show disasm successfully\r
-\r
---*/\r
{\r
EFI_PHYSICAL_ADDRESS InstructionAddress;\r
UINTN InstructionNumber;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Get register value accroding to the system context, and register index.\r
+\r
+ @param SystemContext - EBC system context.\r
+ @param Index - EBC register index\r
+\r
+ @return register value\r
+\r
+**/\r
UINT64\r
GetRegisterValue (\r
IN EFI_SYSTEM_CONTEXT SystemContext,\r
IN UINT8 Index\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get register value accroding to the system context, and register index\r
-\r
-Arguments:\r
-\r
- SystemContext - EBC system context.\r
- Index - EBC register index\r
-\r
-Returns:\r
-\r
- register value\r
-\r
---*/\r
{\r
switch (Index) {\r
case 0:\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbDisasmSupport.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_DISASM_SUPPORT_H_\r
#define _EFI_EDB_DISASM_SUPPORT_H_\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbHook.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ Check the Hook flag, and trigger exception if match.\r
\r
-#include "Edb.h"\r
+ @param VmPtr - EbcDebuggerCheckHookFlag\r
+ @param Flag - Feature flag\r
\r
-//\r
-// Hook support function\r
-//\r
+**/\r
VOID\r
EbcDebuggerCheckHookFlag (\r
IN VM_CONTEXT *VmPtr,\r
IN UINT32 Flag\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check the Hook flag, and trigger exception if match.\r
-\r
-Arguments:\r
-\r
- VmPtr - EbcDebuggerCheckHookFlag\r
- Flag - Feature flag\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
if ((mDebuggerPrivate.FeatureFlags & Flag) == Flag) {\r
mDebuggerPrivate.StatusFlags = Flag;\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will record soruce address for Callstack entry.\r
+\r
+ @param SourceEntry - Source address\r
+ @param Type - Branch type\r
+\r
+**/\r
VOID\r
EbcDebuggerPushCallstackSource (\r
IN UINT64 SourceEntry,\r
IN EFI_DEBUGGER_BRANCH_TYPE Type\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will record soruce address for Callstack entry.\r
-\r
-Arguments:\r
-\r
- SourceEntry - Source address\r
- Type - Branch type\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
if (mDebuggerPrivate.CallStackEntryCount > EFI_DEBUGGER_CALLSTACK_MAX) {\r
ASSERT (FALSE);\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will record parameter for Callstack entry.\r
+\r
+ @param ParameterAddress - The address for the parameter\r
+ @param Type - Branch type\r
+\r
+**/\r
VOID\r
EbcDebuggerPushCallstackParameter (\r
IN UINT64 ParameterAddress,\r
IN EFI_DEBUGGER_BRANCH_TYPE Type\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will record parameter for Callstack entry.\r
-\r
-Arguments:\r
-\r
- ParameterAddress - The address for the parameter\r
- Type - Branch type\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
if (mDebuggerPrivate.CallStackEntryCount > EFI_DEBUGGER_CALLSTACK_MAX) {\r
ASSERT (FALSE);\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will record source address for callstack entry.\r
+\r
+ @param DestEntry - Source address\r
+ @param Type - Branch type\r
+\r
+**/\r
VOID\r
EbcDebuggerPushCallstackDest (\r
IN UINT64 DestEntry,\r
IN EFI_DEBUGGER_BRANCH_TYPE Type\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will record source address for callstack entry.\r
-\r
-Arguments:\r
-\r
- DestEntry - Source address\r
- Type - Branch type\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will throw the newest Callstack entry.\r
+\r
+**/\r
VOID\r
EbcDebuggerPopCallstack (\r
VOID\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will throw the newest Callstack entry.\r
-\r
-Arguments:\r
-\r
- None\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
if ((mDebuggerPrivate.CallStackEntryCount > 0) &&\r
(mDebuggerPrivate.CallStackEntryCount <= EFI_DEBUGGER_CALLSTACK_MAX)) {\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will record source address for trace entry.\r
+\r
+ @param SourceEntry - Source address\r
+ @param Type - Branch type\r
+\r
+**/\r
VOID\r
EbcDebuggerPushTraceSourceEntry (\r
IN UINT64 SourceEntry,\r
IN EFI_DEBUGGER_BRANCH_TYPE Type\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will record source address for trace entry.\r
-\r
-Arguments:\r
-\r
- SourceEntry - Source address\r
- Type - Branch type\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
if (mDebuggerPrivate.TraceEntryCount > EFI_DEBUGGER_TRACE_MAX) {\r
ASSERT (FALSE);\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will record destination address for trace entry.\r
+\r
+ @param DestEntry - Destination address\r
+ @param Type - Branch type\r
+\r
+**/\r
VOID\r
EbcDebuggerPushTraceDestEntry (\r
IN UINT64 DestEntry,\r
IN EFI_DEBUGGER_BRANCH_TYPE Type\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will record destination address for trace entry.\r
-\r
-Arguments:\r
-\r
- DestEntry - Destination address\r
- Type - Branch type\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
UINTN Index;\r
\r
return ;\r
}\r
\r
+/**\r
+\r
+ It will record address for StepEntry, if STEPOVER or STEPOUT is enabled.\r
+\r
+ @param Entry - Break Address\r
+ @param FramePtr - Break Frame pointer\r
+ @param Flag - for STEPOVER or STEPOUT\r
+\r
+**/\r
VOID\r
EbcDebuggerPushStepEntry (\r
IN UINT64 Entry,\r
IN UINT64 FramePtr,\r
IN UINT32 Flag\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- It will record address for StepEntry, if STEPOVER or STEPOUT is enabled.\r
-\r
-Arguments:\r
-\r
- Entry - Break Address\r
- FramePtr - Break Frame pointer\r
- Flag - for STEPOVER or STEPOUT\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
{\r
//\r
// Check StepOver\r
}\r
}\r
\r
-//\r
-// Hook function implementation\r
-//\r
-VOID\r
-EbcDebuggerHookInit (\r
- IN EFI_HANDLE Handle,\r
- IN EFI_DEBUG_SUPPORT_PROTOCOL *EbcDebugProtocol\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in InitializeEbcDriver.\r
It will init the EbcDebuggerPrivate data structure.\r
\r
-Arguments:\r
-\r
- Handle - The EbcDebugProtocol handle.\r
- EbcDebugProtocol - The EbcDebugProtocol interface.\r
+ @param Handle - The EbcDebugProtocol handle.\r
+ @param EbcDebugProtocol - The EbcDebugProtocol interface.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookInit (\r
+ IN EFI_HANDLE Handle,\r
+ IN EFI_DEBUG_SUPPORT_PROTOCOL *EbcDebugProtocol\r
+ )\r
{\r
EFI_STATUS Status;\r
UINTN Index;\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookUnload (\r
- VOID\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in UnloadImage for EBC Interpreter.\r
It clean up the environment.\r
\r
-Arguments:\r
-\r
- None\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookUnload (\r
+ VOID\r
+ )\r
{\r
UINTN Index;\r
UINTN SubIndex;\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookEbcUnloadImage (\r
- IN EFI_HANDLE Handle\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in EbcUnloadImage.\r
Currently do nothing here.\r
\r
-Arguments:\r
+ @param Handle - The EbcImage handle.\r
\r
- Handle - The EbcImage handle.\r
+**/\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+VOID\r
+EbcDebuggerHookEbcUnloadImage (\r
+ IN EFI_HANDLE Handle\r
+ )\r
{\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookExecuteEbcImageEntryPoint (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteEbcImageEntryPoint.\r
It will record the call-stack entry. (-1 means EbcImageEntryPoint call)\r
and trigger Exception if BOE enabled.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
+ @param VmPtr - pointer to VM context.\r
\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookExecuteEbcImageEntryPoint (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushCallstackSource ((UINT64)(UINTN)-1, EfiDebuggerBranchTypeEbcCall);\r
EbcDebuggerPushCallstackParameter ((UINT64)(UINTN)VmPtr->Gpr[0], EfiDebuggerBranchTypeEbcCall);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookEbcInterpret (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteEbcImageEntryPoint.\r
It will record the call-stack entry. (-2 means EbcInterpret call)\r
and trigger Exception if BOT enabled.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
+ @param VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookEbcInterpret (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushCallstackSource ((UINT64)(UINTN)-2, EfiDebuggerBranchTypeEbcCall);\r
EbcDebuggerPushCallstackParameter ((UINT64)(UINTN)VmPtr->Gpr[0], EfiDebuggerBranchTypeEbcCall);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookExecuteStart (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in EbcExecute, before ExecuteFunction.\r
It will trigger Exception if GoTil, StepOver, or StepOut hit.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
+ @param VmPtr - pointer to VM context.\r
\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookExecuteStart (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EFI_TPL CurrentTpl;\r
\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookExecuteEnd (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in EbcExecute, after ExecuteFunction.\r
It will record StepOut Entry if need.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
+ @param VmPtr - pointer to VM context.\r
\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookExecuteEnd (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
UINTN Address;\r
\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookCALLStart (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteCALL, before move IP.\r
It will trigger Exception if BOC enabled,\r
and record Callstack, and trace information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
+ @param VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookCALLStart (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerCheckHookFlag (VmPtr, EFI_DEBUG_FLAG_EBC_BOC);\r
EbcDebuggerPushCallstackSource ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcCall);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookCALLEnd (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteCALL, after move IP.\r
It will record Callstack, trace information\r
and record StepOver/StepOut Entry if need.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
+ @param VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookCALLEnd (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
UINT64 Address;\r
UINTN FramePtr;\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookCALLEXStart (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteCALL, before call EbcLLCALLEX.\r
It will trigger Exception if BOCX enabled,\r
and record Callstack information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
+ @param VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookCALLEXStart (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerCheckHookFlag (VmPtr, EFI_DEBUG_FLAG_EBC_BOCX);\r
// EbcDebuggerPushCallstackSource ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcCallEx);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookCALLEXEnd (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteCALL, after call EbcLLCALLEX.\r
It will record trace information.\r
\r
-Arguments:\r
+ @param VmPtr - pointer to VM context.\r
\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookCALLEXEnd (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
// EbcDebuggerPushCallstackDest ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcCallEx);\r
EbcDebuggerPushTraceDestEntry ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcCallEx);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookRETStart (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteRET, before move IP.\r
It will trigger Exception if BOR enabled,\r
and record Callstack, and trace information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
+ @param VmPtr - pointer to VM context.\r
\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookRETStart (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerCheckHookFlag (VmPtr, EFI_DEBUG_FLAG_EBC_BOR);\r
EbcDebuggerPopCallstack ();\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookRETEnd (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteRET, after move IP.\r
It will record trace information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
+ @param VmPtr - pointer to VM context.\r
\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookRETEnd (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushTraceDestEntry ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcRet);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookJMPStart (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteJMP, before move IP.\r
It will record trace information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
+ @param VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookJMPStart (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushTraceSourceEntry ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcJmp);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookJMPEnd (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteJMP, after move IP.\r
It will record trace information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
+ @param VmPtr - pointer to VM context.\r
\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookJMPEnd (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushTraceDestEntry ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcJmp);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookJMP8Start (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteJMP8, before move IP.\r
It will record trace information.\r
\r
-Arguments:\r
+ @param VmPtr - pointer to VM context.\r
\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
-\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookJMP8Start (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushTraceSourceEntry ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcJmp8);\r
return ;\r
}\r
\r
-VOID\r
-EbcDebuggerHookJMP8End (\r
- IN VM_CONTEXT *VmPtr\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
The hook in ExecuteJMP8, after move IP.\r
It will record trace information.\r
\r
-Arguments:\r
-\r
- VmPtr - pointer to VM context.\r
-\r
-Returns:\r
- None\r
+ @param VmPtr - pointer to VM context.\r
\r
---*/\r
+**/\r
+VOID\r
+EbcDebuggerHookJMP8End (\r
+ IN VM_CONTEXT *VmPtr\r
+ )\r
{\r
EbcDebuggerPushTraceDestEntry ((UINT64)(UINTN)VmPtr->Ip, EfiDebuggerBranchTypeEbcJmp8);\r
return ;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
-\r
- EdbHook.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_HOOKER_H_\r
#define _EFI_EDB_HOOKER_H_\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbSupport.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_SUPPORT_H_\r
#define _EFI_EDB_SUPPORT_H_\r
IN CHAR8 Patch\r
);\r
\r
-//\r
-// Shell Library\r
-//\r
+/**\r
+Shell Library.\r
+**/\r
VOID\r
EFIAPI\r
Input (\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbSupportFile.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
+ Read a file.\r
\r
---*/\r
+ @param Vol - File System Volume\r
+ @param FileName - The file to be read.\r
+ @param BufferSize - The file buffer size\r
+ @param Buffer - The file buffer\r
\r
-#include "Edb.h"\r
+ @retval EFI_SUCCESS - read file successfully\r
+ @retval EFI_NOT_FOUND - file not found\r
\r
+**/\r
EFI_STATUS\r
EFIAPI\r
ReadFileFromVol (\r
OUT UINTN *BufferSize,\r
OUT VOID **Buffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Read a file.\r
-\r
-Arguments:\r
-\r
- Vol - File System Volume\r
- FileName - The file to be read.\r
- BufferSize - The file buffer size\r
- Buffer - The file buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - read file successfully\r
- EFI_NOT_FOUND - file not found\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
EFI_FILE_HANDLE RootDir;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Read a file.\r
+ If ScanFs is FLASE, it will use DebuggerPrivate->Vol as default Fs.\r
+ If ScanFs is TRUE, it will scan all FS and check the file.\r
+ If there is only one file match the name, it will be read.\r
+ If there is more than one file match the name, it will return Error.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param FileName - The file to be read.\r
+ @param BufferSize - The file buffer size\r
+ @param Buffer - The file buffer\r
+ @param ScanFs - Need Scan all FS\r
+\r
+ @retval EFI_SUCCESS - read file successfully\r
+ @retval EFI_NOT_FOUND - file not found\r
+ @retval EFI_NO_MAPPING - there is duplicated files found\r
+\r
+**/\r
EFI_STATUS\r
EFIAPI\r
ReadFileToBuffer (\r
OUT VOID **Buffer,\r
IN BOOLEAN ScanFs\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Read a file.\r
- If ScanFs is FLASE, it will use DebuggerPrivate->Vol as default Fs.\r
- If ScanFs is TRUE, it will scan all FS and check the file.\r
- If there is only one file match the name, it will be read.\r
- If there is more than one file match the name, it will return Error.\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- FileName - The file to be read.\r
- BufferSize - The file buffer size\r
- Buffer - The file buffer\r
- ScanFs - Need Scan all FS\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - read file successfully\r
- EFI_NOT_FOUND - file not found\r
- EFI_NO_MAPPING - there is duplicated files found\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *Vol;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Get file name under this dir with index\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param DirName - The dir to be read.\r
+ @param FileName - The file name pattern under this dir\r
+ @param Index - The file index under this dir\r
+\r
+ @return File Name which match the pattern and index.\r
+\r
+**/\r
CHAR16 *\r
EFIAPI\r
GetFileNameUnderDir (\r
IN CHAR16 *FileName,\r
IN OUT UINTN *Index\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get file name under this dir with index\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- DirName - The dir to be read.\r
- FileName - The file name pattern under this dir\r
- Index - The file index under this dir\r
-\r
-Returns:\r
-\r
- File Name which match the pattern and index.\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
EFI_FILE_HANDLE RootDir;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007 - 2016, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007 - 2016, 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
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
-Module Name:\r
\r
- EdbSupportString.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ Convert hex string to uint.\r
\r
-#include "Edb.h"\r
+ @param str - The string\r
\r
+**/\r
UINTN\r
EFIAPI\r
Xtoi (\r
CHAR16 *str\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Convert hex string to uint\r
-\r
-Arguments:\r
-\r
- Str - The string\r
-\r
-Returns:\r
-\r
---*/\r
{\r
UINTN u;\r
CHAR16 c;\r
return u;\r
}\r
\r
+/**\r
+\r
+ Convert hex string to uint.\r
+\r
+ @param str - The string\r
+\r
+**/\r
+\r
UINT64\r
EFIAPI\r
LXtoi (\r
CHAR16 *str\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Convert hex string to uint\r
-\r
-Arguments:\r
-\r
- Str - The string\r
-\r
-Returns:\r
-\r
---*/\r
{\r
UINT64 u;\r
CHAR16 c;\r
return u;\r
}\r
\r
+/**\r
+\r
+ Convert hex string to uint.\r
+\r
+ @param str - The string\r
+\r
+**/\r
UINTN\r
EFIAPI\r
Atoi (\r
CHAR16 *str\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Convert hex string to uint\r
-\r
-Arguments:\r
-\r
- Str - The string\r
-\r
-Returns:\r
-\r
---*/\r
{\r
UINTN u;\r
CHAR16 c;\r
return u;\r
}\r
\r
+/**\r
+\r
+ Convert hex string to uint.\r
+\r
+ @param str - The string\r
+\r
+**/\r
UINTN\r
EFIAPI\r
AsciiXtoi (\r
CHAR8 *str\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Convert hex string to uint\r
-\r
-Arguments:\r
-\r
- Str - The string\r
-\r
-Returns:\r
-\r
---*/\r
{\r
UINTN u;\r
CHAR8 c;\r
return u;\r
}\r
\r
+/**\r
+\r
+ Convert hex string to uint.\r
+\r
+ @param str - The string\r
+\r
+**/\r
UINTN\r
EFIAPI\r
AsciiAtoi (\r
CHAR8 *str\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Convert hex string to uint\r
-\r
-Arguments:\r
-\r
- Str - The string\r
-\r
-Returns:\r
-\r
---*/\r
{\r
UINTN u;\r
CHAR8 c;\r
return (Chr >= 'a' && Chr <= 'z') ? Chr - ('a' - 'A') : Chr;\r
}\r
\r
-INTN\r
-EFIAPI\r
-StrCmpUnicodeAndAscii (\r
- IN CHAR16 *String,\r
- IN CHAR8 *String2\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
Compare the Unicode and Ascii string pointed by String to the string pointed by String2.\r
\r
-Arguments:\r
- String - Unicode String to process\r
+ @param String - Unicode String to process\r
\r
- String2 - Ascii string to process\r
+ @param String2 - Ascii string to process\r
\r
-Returns:\r
- Return a positive integer if String is lexicall greater than String2; Zero if\r
+ @return Return a positive integer if String is lexicall greater than String2; Zero if\r
the two strings are identical; and a negative interger if String is lexically\r
less than String2.\r
\r
---*/\r
+**/\r
+INTN\r
+EFIAPI\r
+StrCmpUnicodeAndAscii (\r
+ IN CHAR16 *String,\r
+ IN CHAR8 *String2\r
+ )\r
{\r
while (*String) {\r
if (*String != (CHAR16)*String2) {\r
return (*String - (CHAR16)*String2);\r
}\r
\r
-INTN\r
-EFIAPI\r
-StriCmp (\r
- IN CHAR16 *String,\r
- IN CHAR16 *String2\r
- )\r
-/*++\r
+/**\r
\r
-Routine Description:\r
Compare the Unicode string pointed by String to the string pointed by String2.\r
\r
-Arguments:\r
- String - Unicode String to process\r
- String2 - Unicode string to process\r
+ @param String - Unicode String to process\r
+ @param String2 - Unicode string to process\r
\r
-Returns:\r
- Return a positive integer if String is lexically greater than String2; Zero if\r
+ @return Return a positive integer if String is lexically greater than String2; Zero if\r
the two strings are identical; and a negative integer if String is lexically\r
less than String2.\r
\r
---*/\r
+**/\r
+INTN\r
+EFIAPI\r
+StriCmp (\r
+ IN CHAR16 *String,\r
+ IN CHAR16 *String2\r
+ )\r
{\r
while ((*String != L'\0') &&\r
(UnicodeToUpper (*String) == UnicodeToUpper (*String2))) {\r
return UnicodeToUpper (*String) - UnicodeToUpper (*String2);\r
}\r
\r
-INTN\r
-EFIAPI\r
-StriCmpUnicodeAndAscii (\r
- IN CHAR16 *String,\r
- IN CHAR8 *String2\r
- )\r
-/*++\r
+/**\r
\r
-Routine Description:\r
Compare the Unicode and Ascii string pointed by String to the string pointed by String2.\r
\r
-Arguments:\r
- String - Unicode String to process\r
-\r
- String2 - Ascii string to process\r
+ @param String - Unicode String to process\r
+ @param String2 - Ascii string to process\r
\r
-Returns:\r
- Return a positive integer if String is lexically greater than String2; Zero if\r
+ @return Return a positive integer if String is lexically greater than String2; Zero if\r
the two strings are identical; and a negative integer if String is lexically\r
less than String2.\r
\r
---*/\r
+**/\r
+INTN\r
+EFIAPI\r
+StriCmpUnicodeAndAscii (\r
+ IN CHAR16 *String,\r
+ IN CHAR8 *String2\r
+ )\r
{\r
while ((*String != L'\0') &&\r
(UnicodeToUpper (*String) == (CHAR16)AsciiToUpper (*String2))) {\r
return UnicodeToUpper (*String) - (CHAR16)AsciiToUpper (*String2);\r
}\r
\r
+/**\r
+\r
+ Verify if the string is end with the sub string.\r
+\r
+ @param Str - The string where to search the sub string\r
+ @param SubStr - The substring.\r
+\r
+**/\r
BOOLEAN\r
EFIAPI\r
StrEndWith (\r
IN CHAR16 *Str,\r
IN CHAR16 *SubStr\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Verify if the string is end with the sub string.\r
-\r
---*/\r
{\r
CHAR16 *Temp;\r
\r
}\r
}\r
\r
+/**\r
+ Duplicate a string.\r
+\r
+ @param Src The string to be duplicated.\r
+\r
+**/\r
CHAR16 *\r
EFIAPI\r
StrDuplicate (\r
IN CHAR16 *Src\r
)\r
-// duplicate a string\r
{\r
CHAR16 *Dest;\r
UINTN Size;\r
CHAR16 *mLineBuffer = NULL;\r
CHAR16 *mFieldBuffer = NULL;\r
\r
+/**\r
+\r
+ Find the first substring.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
UINTN\r
EFIAPI\r
StrSpn (\r
IN CHAR16 *String,\r
IN CHAR16 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the first substring.\r
-\r
---*/\r
{\r
UINTN Count;\r
CHAR16 *Str1;\r
return Count;\r
}\r
\r
+/**\r
+\r
+ Searches a string for the first occurrence of a character contained in a\r
+ specified buffer.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
\r
CHAR16 *\r
EFIAPI\r
IN CHAR16 *String,\r
IN CHAR16 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Searches a string for the first occurrence of a character contained in a\r
- specified buffer.\r
-\r
---*/\r
{\r
CHAR16 *Str1;\r
CHAR16 *Str2;\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Find the next token after one or more specified characters.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
CHAR16 *\r
EFIAPI\r
StrTokenLine (\r
IN CHAR16 *String OPTIONAL,\r
IN CHAR16 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the next token after one or more specified characters.\r
-\r
---*/\r
{\r
CHAR16 *Begin;\r
CHAR16 *End;\r
return Begin;\r
}\r
\r
+/**\r
+\r
+ Find the next token after one specificed characters.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
\r
CHAR16 *\r
EFIAPI\r
IN CHAR16 *String OPTIONAL,\r
IN CHAR16 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the next token after one specificed characters.\r
-\r
---*/\r
{\r
CHAR16 *Begin;\r
CHAR16 *End;\r
CHAR8 *mAsciiLineBuffer = NULL;\r
CHAR8 *mAsciiFieldBuffer = NULL;\r
\r
+/**\r
+\r
+ Find the first substring.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
UINTN\r
EFIAPI\r
AsciiStrSpn (\r
IN CHAR8 *String,\r
IN CHAR8 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the first substring.\r
-\r
---*/\r
{\r
UINTN Count;\r
CHAR8 *Str1;\r
return Count;\r
}\r
\r
+/**\r
+ Searches a string for the first occurrence of a character contained in a\r
+ specified buffer.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
\r
+**/\r
CHAR8 *\r
EFIAPI\r
AsciiStrBrk (\r
IN CHAR8 *String,\r
IN CHAR8 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Searches a string for the first occurrence of a character contained in a\r
- specified buffer.\r
-\r
---*/\r
{\r
CHAR8 *Str1;\r
CHAR8 *Str2;\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Find the next token after one or more specified characters.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
CHAR8 *\r
EFIAPI\r
AsciiStrTokenLine (\r
IN CHAR8 *String OPTIONAL,\r
IN CHAR8 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the next token after one or more specified characters.\r
-\r
---*/\r
{\r
CHAR8 *Begin;\r
CHAR8 *End;\r
return Begin;\r
}\r
\r
+/**\r
+\r
+ Find the next token after one specificed characters.\r
+\r
+ @param String Point to the string where to find the substring.\r
+ @param CharSet Point to the string to be found.\r
+\r
+**/\r
\r
CHAR8 *\r
EFIAPI\r
IN CHAR8 *String OPTIONAL,\r
IN CHAR8 *CharSet\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find the next token after one specificed characters.\r
-\r
---*/\r
{\r
CHAR8 *Begin;\r
CHAR8 *End;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbSupportUI.c\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#include "Edb.h"\r
\r
IN UINTN Len\r
);\r
\r
+/**\r
+\r
+ Function waits for a given event to fire, or for an optional timeout to expire.\r
+\r
+ @param Event - The event to wait for\r
+ @param Timeout - An optional timeout value in 100 ns units.\r
+\r
+ @retval EFI_SUCCESS - Event fired before Timeout expired.\r
+ @retval EFI_TIME_OUT - Timout expired before Event fired..\r
+\r
+**/\r
EFI_STATUS\r
EFIAPI\r
WaitForSingleEvent (\r
IN EFI_EVENT Event,\r
IN UINT64 Timeout OPTIONAL\r
)\r
-/*++\r
-\r
-Routine Description:\r
- Function waits for a given event to fire, or for an optional timeout to expire.\r
-\r
-Arguments:\r
- Event - The event to wait for\r
-\r
- Timeout - An optional timeout value in 100 ns units.\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - Event fired before Timeout expired.\r
- EFI_TIME_OUT - Timout expired before Event fired..\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
UINTN Index;\r
return Status;\r
}\r
\r
+/**\r
+\r
+ Move the cursor position one character backward.\r
+\r
+ @param LineLength Length of a line. Get it by calling QueryMode\r
+ @param Column Current column of the cursor position\r
+ @param Row Current row of the cursor position\r
+\r
+**/\r
VOID\r
EFIAPI\r
ConMoveCursorBackward (\r
IN OUT UINTN *Column,\r
IN OUT UINTN *Row\r
)\r
-/*++\r
-\r
-Routine Description:\r
- Move the cursor position one character backward.\r
-\r
-Arguments:\r
- LineLength Length of a line. Get it by calling QueryMode\r
- Column Current column of the cursor position\r
- Row Current row of the cursor position\r
-\r
-Returns:\r
-\r
---*/\r
{\r
ASSERT (Column != NULL);\r
ASSERT (Row != NULL);\r
}\r
}\r
\r
+/**\r
+\r
+ Move the cursor position one character backward.\r
+\r
+ @param LineLength Length of a line. Get it by calling QueryMode\r
+ @param TotalRow Total row of a screen, get by calling QueryMode\r
+ @param Column Current column of the cursor position\r
+ @param Row Current row of the cursor position\r
+\r
+**/\r
VOID\r
EFIAPI\r
ConMoveCursorForward (\r
IN OUT UINTN *Column,\r
IN OUT UINTN *Row\r
)\r
-/*++\r
-\r
-Routine Description:\r
- Move the cursor position one character backward.\r
-\r
-Arguments:\r
- LineLength Length of a line. Get it by calling QueryMode\r
- TotalRow Total row of a screen, get by calling QueryMode\r
- Column Current column of the cursor position\r
- Row Current row of the cursor position\r
-\r
-Returns:\r
-\r
---*/\r
{\r
ASSERT (Column != NULL);\r
ASSERT (Row != NULL);\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007 - 2016, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007 - 2016, Intel Corporatio. 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
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
-Module Name:\r
\r
- EdbSymbol.c\r
+**/\r
\r
-Abstract:\r
+#include "Edb.h"\r
\r
+/**\r
\r
---*/\r
+ Load single symbol entry.\r
\r
-#include "Edb.h"\r
+ @param Object - Symbol file object\r
+ @param Name - Symbol name\r
+ @param ObjName - Object name\r
+ @param Address - Symbol address\r
+ @param Type - Symbol type\r
+\r
+ @retval EFI_SUCCESS - add single symbol entry successfully\r
\r
+**/\r
EFI_STATUS\r
EdbLoadSymbolSingleEntry (\r
IN EFI_DEBUGGER_SYMBOL_OBJECT *Object,\r
IN UINTN Address,\r
IN EFI_DEBUGGER_SYMBOL_TYPE Type\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load single symbol entry\r
-\r
-Arguments:\r
-\r
- Object - Symbol file object\r
- Name - Symbol name\r
- ObjName - Object name\r
- Address - Symbol address\r
- Type - Symbol type\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - add single symbol entry successfully\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_ENTRY *Entry;\r
\r
EdbEbcSymbolParseStateMax,\r
} EDB_EBC_SYMBOL_PARSE_STATE;\r
\r
-/*++\r
+/**\r
\r
The following code depends on the MAP file generated by IEC compiler (actually Microsoft linker).\r
\r
0001:00000000 TestSubRoutine2 10000400 f EbcTest.obj\r
===============================================================================\r
\r
---*/\r
+**/\r
+\r
+/**\r
+\r
+ Load symbol entry by Iec.\r
+\r
+ @param Object - Symbol file object\r
+ @param BufferSize - Symbol file buffer size\r
+ @param Buffer - Symbol file buffer\r
+\r
+ @retval EFI_SUCCESS - add symbol entry successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbLoadSymbolEntryByIec (\r
IN EFI_DEBUGGER_SYMBOL_OBJECT *Object,\r
IN UINTN BufferSize,\r
IN VOID *Buffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load symbol entry by Iec\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- Object - Symbol file object\r
- BufferSize - Symbol file buffer size\r
- Buffer - Symbol file buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - add symbol entry successfully\r
-\r
---*/\r
{\r
CHAR8 *LineBuffer;\r
CHAR8 *FieldBuffer;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Load symbol entry.\r
+\r
+ @param Object - Symbol file object\r
+ @param BufferSize - Symbol file buffer size\r
+ @param Buffer - Symbol file buffer\r
+\r
+ @retval EFI_SUCCESS - add symbol entry successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbLoadSymbolEntry (\r
IN EFI_DEBUGGER_SYMBOL_OBJECT *Object,\r
IN UINTN BufferSize,\r
IN VOID *Buffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load symbol entry\r
-\r
-Arguments:\r
-\r
- Object - Symbol file object\r
- BufferSize - Symbol file buffer size\r
- Buffer - Symbol file buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - add symbol entry successfully\r
-\r
---*/\r
{\r
//\r
// MAP file format depends on the compiler (actually linker).\r
return EdbLoadSymbolEntryByIec (Object, BufferSize, Buffer);\r
}\r
\r
+/**\r
+\r
+ Find symbol file by name.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param FileName - Symbol file name\r
+ @param Index - Symbol file index\r
+\r
+ @return Object\r
+\r
+**/\r
EFI_DEBUGGER_SYMBOL_OBJECT *\r
EdbFindSymbolFile (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN CHAR16 *FileName,\r
IN OUT UINTN *Index OPTIONAL\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find symbol file by name\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- FileName - Symbol file name\r
- Index - Symbol file index\r
-\r
-Returns:\r
-\r
- Object\r
-\r
---*/\r
{\r
UINTN ObjectIndex;\r
\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Find symbol by address.\r
+\r
+ @param Address - Symbol address\r
+ @param Type - Search type\r
+ @param RetObject - Symbol object\r
+ @param RetEntry - Symbol entry\r
+\r
+ @return Nearest symbol address\r
+\r
+**/\r
UINTN\r
EbdFindSymbolAddress (\r
IN UINTN Address,\r
OUT EFI_DEBUGGER_SYMBOL_OBJECT **RetObject,\r
OUT EFI_DEBUGGER_SYMBOL_ENTRY **RetEntry\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find symbol by address\r
-\r
-Arguments:\r
-\r
- Address - Symbol address\r
- Type - Search type\r
- RetObject - Symbol object\r
- RetEntry - Symbol entry\r
-\r
-Returns:\r
-\r
- Nearest symbol address\r
-\r
---*/\r
{\r
UINTN Index;\r
UINTN SubIndex;\r
return 0;\r
}\r
\r
+/**\r
+\r
+ Unload symbol file by name.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param FileName - Symbol file name\r
+\r
+ @retval EFI_SUCCESS - unload symbol successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbUnloadSymbol (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN CHAR16 *FileName\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Unload symbol file by name\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- FileName - Symbol file name\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - unload symbol successfully\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
UINTN ObjectIndex;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Load symbol file by name.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param FileName - Symbol file name\r
+ @param BufferSize - Symbol file buffer size\r
+ @param Buffer - Symbol file buffer\r
+\r
+ @retval EFI_SUCCESS - load symbol successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbLoadSymbol (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN BufferSize,\r
IN VOID *Buffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load symbol file by name\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- FileName - Symbol file name\r
- BufferSize - Symbol file buffer size\r
- Buffer - Symbol file buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - load symbol successfully\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
EFI_STATUS Status;\r
return EFI_SUCCESS;\r
}\r
\r
-CHAR8 *\r
-GetPdbPath (\r
- VOID *ImageBase\r
- )\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Located PDB path name in PE image\r
-\r
-Arguments:\r
+/**\r
\r
- ImageBase - base of PE to search\r
+ Located PDB path name in PE image.\r
\r
-Returns:\r
+ @param ImageBase - base of PE to search\r
\r
- Pointer into image at offset of PDB file name if PDB file name is found,\r
+ @return Pointer into image at offset of PDB file name if PDB file name is found,\r
Otherwise a pointer to an empty string.\r
\r
---*/\r
+**/\r
+CHAR8 *\r
+GetPdbPath (\r
+ VOID *ImageBase\r
+ )\r
{\r
CHAR8 *PdbPath;\r
UINT32 DirCount;\r
return PdbPath;\r
}\r
\r
+/**\r
+\r
+ Check whether PDB file and MAP file have same name.\r
+\r
+ @param PdbFileName - PDB file name\r
+ @param MapFileName - MAP file name\r
+\r
+ @retval TRUE - PDB and MAP file name match\r
+ @retval FALSE - PDB and MAP file name not match\r
+\r
+**/\r
BOOLEAN\r
MatchPdbAndMap (\r
IN CHAR8 *PdbFileName,\r
IN CHAR16 *MapFileName\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check whether PDB file and MAP file have same name\r
-\r
-Arguments:\r
-\r
- PdbFileName - PDB file name\r
- MapFileName - MAP file name\r
-\r
-Returns:\r
-\r
- TRUE - PDB and MAP file name match\r
- FALSE - PDB and MAP file name not match\r
-\r
---*/\r
{\r
UINTN PdbNameSize;\r
UINTN MapNameSize;\r
\r
EFI_DEBUG_IMAGE_INFO_TABLE_HEADER mDebugImageInfoTableHeader;\r
\r
-VOID\r
-EdbFixDebugImageInfoTable (\r
- IN OUT EFI_DEBUG_IMAGE_INFO_TABLE_HEADER **DebugImageInfoTableHeader\r
- )\r
-/*\r
+/**\r
For compatibility consideration, we handle 2 cases:\r
\r
1) IA32:\r
| TableSize | | |\r
+------------------------+ +------------------------+\r
\r
-*/\r
+ @param DebugImageInfoTableHeader Point to the EFI_DEBUG_IMAGE_INFO_TABLE_HEADER structure.\r
+\r
+**/\r
+VOID\r
+EdbFixDebugImageInfoTable (\r
+ IN OUT EFI_DEBUG_IMAGE_INFO_TABLE_HEADER **DebugImageInfoTableHeader\r
+ )\r
{\r
mDebugImageInfoTableHeader.EfiDebugImageInfoTable = ((EFI_DEBUG_IMAGE_INFO_TABLE_HEADER_OLD *)(*DebugImageInfoTableHeader))->EfiDebugImageInfoTable;\r
mDebugImageInfoTableHeader.UpdateStatus = ((EFI_DEBUG_IMAGE_INFO_TABLE_HEADER_OLD *)(*DebugImageInfoTableHeader))->UpdateStatus;\r
// BUGBUG: work-around end\r
//\r
\r
+/**\r
+\r
+ Patch symbol RVA.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param FileName - Symbol file name\r
+ @param SearchType - Search type for Object\r
+\r
+ @retval EFI_SUCCESS - Patch symbol RVA successfully\r
+ @retval EFI_NOT_FOUND - Symbol RVA base not found\r
+\r
+**/\r
EFI_STATUS\r
EdbPatchSymbolRVA (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN CHAR16 *FileName,\r
IN EDB_EBC_IMAGE_RVA_SEARCH_TYPE SearchType\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Patch symbol RVA\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- FileName - Symbol file name\r
- SearchType - Search type for Object\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - Patch symbol RVA successfully\r
- EFI_NOT_FOUND - Symbol RVA base not found\r
-\r
---*/\r
{\r
EFI_STATUS Status;\r
UINTN ImageNumber;\r
return EFI_NOT_FOUND;\r
}\r
\r
+/**\r
+\r
+ Check whether OBJ file and COD file have same name.\r
+\r
+ @param ObjFileName - OBJ file name\r
+ @param CodFileName - COD file name\r
+\r
+ @retval TRUE - OBJ and COD file name match\r
+ @retval FALSE - OBJ and COD file name not match\r
+\r
+**/\r
BOOLEAN\r
MatchObjAndCod (\r
IN CHAR8 *ObjFileName,\r
IN CHAR16 *CodFileName\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Check whether OBJ file and COD file have same name\r
-\r
-Arguments:\r
-\r
- ObjFileName - OBJ file name\r
- CodFileName - COD file name\r
-\r
-Returns:\r
-\r
- TRUE - OBJ and COD file name match\r
- FALSE - OBJ and COD file name not match\r
-\r
---*/\r
{\r
UINTN ObjNameSize;\r
UINTN CodNameSize;\r
EdbEbcCodParseStateMax,\r
} EDB_EBC_COD_PARSE_STATE;\r
\r
-/*++\r
+/**\r
\r
The following code depends on the COD file generated by IEC compiler.\r
\r
- Sample as follows: EbcTest.cod\r
-===============================================================================\r
-; -- Machine type EFI\r
-; mark_description "Intel(R) C Compiler for EFI Byte Code, Version 1.2 Build 20040123";\r
-; mark_description "XXX";\r
-;ident "Intel(R) C Compiler for EFI Byte Code, Version 1.2 Build 20040123"\r
-;ident "XXX"\r
- .686P\r
- .387\r
-_TEXT SEGMENT PARA PUBLIC USE32 'CODE'\r
-_TEXT ENDS\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
- ALIGN 010H\r
-_DATA ENDS\r
-_BSS SEGMENT PARA PUBLIC USE32 'BSS'\r
- ALIGN 010H\r
-_BSS ENDS\r
-_VARBSS SEGMENT PARA PUBLIC USE32 'BSS'\r
- ALIGN 010H\r
-_VARBSS ENDS\r
- ASSUME CS:FLAT,DS:FLAT,SS:FLAT\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
-TestVariable2 DD 000000003H,000000000H ; u64\r
-_DATA ENDS\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
-_DATA ENDS\r
-_TEXT SEGMENT PARA PUBLIC USE32 'CODE'\r
-; -- Begin EfiMain\r
-; mark_begin;\r
- PUBLIC EfiMain\r
-EfiMain PROC NEAR\r
-$B3$1:; 11a\r
-$LN45:\r
-\r
-;117 ; {\r
-\r
- 0011a 60 00 70 80 MOVqw R0, R0(+0,-112) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:117\r
-$LN46:\r
-\r
-;118 ; UINT16 test = 0x1234;\r
-\r
- 0011e 77 58 58 00 34\r
- 12 MOVIww @R0(+0,+88), +4660 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:118\r
-$LN47:\r
-\r
-;121 ; EFI_STATUS Status;\r
-;121 ;\r
-;121 ; SystemTable->ConOut->OutputString (\r
-\r
- 00124 72 87 01 12 MOVnw R7, @R0(+1,+128) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:121\r
- 00128 72 f7 85 21 MOVnw R7, @R7(+5,+24) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:121\r
-$LN48:\r
-\r
-;122 ; SystemTable->ConOut,\r
-\r
- 0012c 72 84 01 12 MOVnw R4, @R0(+1,+128) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:122\r
- 00130 72 c8 85 21 MOVnw @R0, @R4(+5,+24) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:122\r
- 00134 b9 34 00 00 00\r
- 00 MOVreld R4, __STRING$1 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:122\r
- 0013a b2 48 01 10 MOVnw @R0(+1,+0), R4 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:122\r
- 0013e 83 2f 01 00 00\r
- 10 CALLEX @R7(+1,+0) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:122\r
-$B3$2:; 144\r
-$LN49:\r
-\r
-;125 ; L"Hello EBC Test!\n\r"\r
-;125 ; );\r
-;125 ; EFI_BREAKPOINT ();\r
-\r
- 00144 00 03 BREAK 3 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:125\r
-$B3$3:; 146\r
-$LN50:\r
-\r
-;126 ; TestVariable1 = 6;\r
-\r
- 00146 b9 37 00 00 00\r
- 00 MOVreld R7, TestVariable1 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:126\r
- 0014c 78 0f 06 00 MOVInw @R7, (0,6) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:126\r
-$LN51:\r
-\r
-;127 ; TestSubRoutineSub (1, 5);\r
-\r
- 00150 78 08 01 00 MOVInw @R0, (0,1) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:127\r
- 00154 78 48 01 10 05\r
- 00 MOVInw @R0(1,0), (0,5) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:127\r
- 0015a 83 10 00 00 00\r
- 00 CALL TestSubRoutineSub ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:127\r
-$B3$4:; 160\r
-$LN52:\r
-\r
-;129 ;\r
-;129 ; SystemTable->ConOut->OutputString (\r
-\r
- 00160 72 87 01 12 MOVnw R7, @R0(+1,+128) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:129\r
- 00164 72 f7 85 21 MOVnw R7, @R7(+5,+24) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:129\r
-$LN53:\r
-\r
-;130 ; SystemTable->ConOut,\r
-\r
- 00168 72 84 01 12 MOVnw R4, @R0(+1,+128) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:130\r
- 0016c 72 c8 85 21 MOVnw @R0, @R4(+5,+24) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:130\r
-$LN54:\r
-\r
-;131 ; TestStr\r
-\r
- 00170 b9 34 00 00 00\r
- 00 MOVreld R4, TestStr ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:131\r
- 00176 b2 c8 01 10 MOVnw @R0(+1, +0), @R4 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:131\r
- 0017a 83 2f 01 00 00\r
- 10 CALLEX @R7(+1,+0) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:131\r
-$B3$5:; 180\r
-$LN55:\r
-\r
-;134 ; );\r
-;134 ;\r
-;134 ; test = test & 0xFF;\r
-\r
- 00180 de 88 58 00 58\r
- 00 MOVww @R0(+0,+88), @R0(+0,+88) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:134\r
-$LN56:\r
-\r
-;139 ; if (test != 0x34) {\r
-;139 ; // EFI_BREAKPOINT ();\r
-;139 ; }\r
-;139 ;\r
-;139 ; Status = TestSubRoutine (1, 2, 3, 4, 5, 6, 7, 8, 9, 10);\r
-\r
- 00186 78 08 01 00 MOVInw @R0, (0,1) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 0018a 78 48 01 10 02\r
- 00 MOVInw @R0(1,0), (0,2) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 00190 78 48 02 10 03\r
- 00 MOVInw @R0(2,0), (0,3) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 00196 78 48 03 10 04\r
- 00 MOVInw @R0(3,0), (0,4) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 0019c 78 48 04 20 05\r
- 00 MOVInw @R0(4,0), (0,5) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 001a2 78 48 05 20 06\r
- 00 MOVInw @R0(5,0), (0,6) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 001a8 78 48 06 20 07\r
- 00 MOVInw @R0(6,0), (0,7) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 001ae 78 48 07 20 08\r
- 00 MOVInw @R0(7,0), (0,8) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 001b4 78 48 08 20 09\r
- 00 MOVInw @R0(8,0), (0,9) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 001ba 78 48 09 20 0a\r
- 00 MOVInw @R0(9,0), (0,10) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
- 001c0 83 10 00 00 00\r
- 00 CALL TestSubRoutine ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
-$B3$10:; 1c6\r
- 001c6 b2 78 60 00 MOVnw @R0(+0,+96), R7 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
-$B3$6:; 1ca\r
-$LN57:\r
- 001ca f2 88 50 00 60\r
- 00 MOVnw @R0(+0,+80), @R0(+0,+96) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:139\r
-$LN58:\r
-\r
-;141 ;\r
-;141 ; SystemTable->ConOut->OutputString (\r
-\r
- 001d0 72 87 01 12 MOVnw R7, @R0(+1,+128) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:141\r
- 001d4 72 f7 85 21 MOVnw R7, @R7(+5,+24) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:141\r
-$LN59:\r
-\r
-;142 ; SystemTable->ConOut,\r
-\r
- 001d8 72 84 01 12 MOVnw R4, @R0(+1,+128) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:142\r
- 001dc 72 c8 85 21 MOVnw @R0, @R4(+5,+24) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:142\r
- 001e0 b9 34 00 00 00\r
- 00 MOVreld R4, __STRING$2 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:142\r
- 001e6 b2 48 01 10 MOVnw @R0(+1,+0), R4 ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:142\r
- 001ea 83 2f 01 00 00\r
- 10 CALLEX @R7(+1,+0) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:142\r
-$B3$7:; 1f0\r
-$LN60:\r
-\r
-;146 ; L"Goodbye EBC Test!\n\r"\r
-;146 ; );\r
-;146 ;\r
-;146 ; return Status;\r
-\r
- 001f0 72 87 50 00 MOVnw R7, @R0(+0,+80) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:146\r
- 001f4 60 00 70 00 MOVqw R0, R0(+0,+112) ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:146\r
- 001f8 04 00 RET ;C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest.c:146\r
-; mark_end;\r
-EfiMain ENDP\r
-_TEXT ENDS\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
- DB 3 DUP (0) ; pad\r
-__STRING$2 DW 71 ; u16\r
- DW 111 ; u16\r
- DW 111 ; u16\r
- DW 100 ; u16\r
- DW 98 ; u16\r
- DW 121 ; u16\r
- DW 101 ; u16\r
- DW 32 ; u16\r
- DW 69 ; u16\r
- DW 66 ; u16\r
- DW 67 ; u16\r
- DW 32 ; u16\r
- DW 84 ; u16\r
- DW 101 ; u16\r
- DW 115 ; u16\r
- DW 116 ; u16\r
- DW 33 ; u16\r
- DW 10 ; u16\r
- DW 13 ; u16\r
- DW 0 ; u16\r
-__STRING$1 DW 72 ; u16\r
- DW 101 ; u16\r
- DW 108 ; u16\r
- DW 108 ; u16\r
- DW 111 ; u16\r
- DW 32 ; u16\r
- DW 69 ; u16\r
- DW 66 ; u16\r
- DW 67 ; u16\r
- DW 32 ; u16\r
- DW 84 ; u16\r
- DW 101 ; u16\r
- DW 115 ; u16\r
- DW 116 ; u16\r
- DW 33 ; u16\r
- DW 10 ; u16\r
- DW 13 ; u16\r
- DW 0 ; u16\r
-_DATA ENDS\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
-_DATA ENDS\r
-; -- End EfiMain\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
-__STRING$0 DW 55 ; u16\r
- DW 56 ; u16\r
- DW 57 ; u16\r
- DW 52 ; u16\r
- DW 53 ; u16\r
- DW 54 ; u16\r
- DW 49 ; u16\r
- DW 50 ; u16\r
- DW 51 ; u16\r
- DW 13 ; u16\r
- DW 10 ; u16\r
- DW 0 ; u16\r
-_DATA ENDS\r
-_VARBSS SEGMENT PARA PUBLIC USE32 'BSS'\r
- PUBLIC TestStr\r
-TestStr DD 2 DUP (?) ; pad\r
- PUBLIC TestVariable1\r
-TestVariable1 DD 2 DUP (?) ; pad\r
-_VARBSS ENDS\r
-_VARBSS_INIT SEGMENT DWORD PUBLIC USE32 'CODE'\r
-; -- Begin varbss_init_C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest$c45b815d2\r
- PUBLIC varbss_init_C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest$c45b815d2\r
-varbss_init_C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest$c45b815d2 PROC NEAR\r
- 00000 b9 34 00 00 00\r
- 00 MOVreld R4, TestStr\r
- 00006 b9 35 00 00 00\r
- 00 MOVreld R5, __STRING$0\r
- 0000c 33 5c MOVnd @R4, R5\r
- 0000e b9 34 00 00 00\r
- 00 MOVreld R4, TestVariable1\r
- 00014 78 0c 04 00 MOVInw @R4, (0,4)\r
- 00018 04 00 RET\r
-; -- End varbss_init_C:\efi_src\TIANO\Edk\Sample\Universal\Ebc\Dxe\EbcTest\EbcTest$c45b815d2\r
-_VARBSS_INIT ENDS\r
-_DATA SEGMENT PARA PUBLIC USE32 'DATA'\r
-_DATA ENDS\r
-EXTRN TestSubRoutineSub:PROC\r
- END\r
+**/\r
\r
-===============================================================================\r
+/**\r
+\r
+ Load code by symbol by Iec.\r
+\r
+ @param Name - Symbol file name\r
+ @param Buffer - Symbol file buffer\r
+ @param BufferSize - Symbol file buffer size\r
+ @param CodeBufferSize - Code buffer size\r
+ @param FuncOffset - Code funcion offset\r
\r
---*/\r
+ @return CodeBuffer\r
+\r
+**/\r
CHAR8 *\r
EdbLoadCodBySymbolByIec (\r
IN CHAR8 *Name,\r
OUT UINTN *CodeBufferSize,\r
OUT UINTN *FuncOffset\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load code by symbol by Iec\r
-\r
-Arguments:\r
-\r
- Name - Symbol file name\r
- BufferSize - Symbol file buffer size\r
- Buffer - Symbol file buffer\r
- CodeBufferSize - Code buffer size\r
- FuncOffset - Code funcion offset\r
-\r
-Returns:\r
-\r
- CodeBuffer\r
-\r
---*/\r
{\r
CHAR8 *LineBuffer;\r
CHAR8 *FieldBuffer;\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Load code by symbol.\r
+\r
+ @param Name - Symbol file name\r
+ @param Buffer - Symbol file buffer\r
+ @param BufferSize - Symbol file buffer size\r
+ @param CodeBufferSize - Code buffer size\r
+ @param FuncOffset - Code funcion offset\r
+\r
+ @return CodeBuffer\r
+\r
+**/\r
CHAR8 *\r
EdbLoadCodBySymbol (\r
IN CHAR8 *Name,\r
OUT UINTN *CodeBufferSize,\r
OUT UINTN *FuncOffset\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load code by symbol\r
-\r
-Arguments:\r
-\r
- Name - Symbol file name\r
- BufferSize - Symbol file buffer size\r
- Buffer - Symbol file buffer\r
- CodeBufferSize - Code buffer size\r
- FuncOffset - Code funcion offset\r
-\r
-Returns:\r
-\r
- CodeBuffer\r
-\r
---*/\r
{\r
//\r
// COD file format depends on the compiler.\r
return EdbLoadCodBySymbolByIec (Name, Buffer, BufferSize, CodeBufferSize, FuncOffset);\r
}\r
\r
+/**\r
+\r
+ Find code from object.\r
+\r
+ @param DebuggerPrivate EBC Debugger private data structure\r
+ @param Object - Symbol object\r
+ @param FileName - File name\r
+\r
+**/\r
VOID *\r
EdbFindCodeFromObject (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN EFI_DEBUGGER_SYMBOL_OBJECT *Object,\r
IN CHAR16 *FileName\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Find code from object\r
-\r
-Arguments:\r
-\r
- Object - Symbol object\r
- FileName - File name\r
-\r
-Returns:\r
-\r
- CodeBuffer\r
-\r
---*/\r
{\r
UINTN EntryIndex;\r
\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Load code.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param MapFileName - Symbol file name\r
+ @param FileName - Code file name\r
+ @param BufferSize - Code file buffer size\r
+ @param Buffer - Code file buffer\r
+\r
+ @retval EFI_SUCCESS - Code loaded successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbLoadCode (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN BufferSize,\r
IN VOID *Buffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Load code\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- MapFileName - Symbol file name\r
- FileName - Code file name\r
- BufferSize - Code file buffer size\r
- Buffer - Code file buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - Code loaded successfully\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
UINTN ObjectIndex;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Unload code.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param MapFileName - Symbol file name\r
+ @param FileName - Code file name\r
+ @param Buffer - Code file buffer\r
+\r
+ @retval EFI_SUCCESS - Code unloaded successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbUnloadCode (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN CHAR16 *FileName,\r
OUT VOID **Buffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Unload code\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- MapFileName - Symbol file name\r
- FileName - Code file name\r
- Buffer - Code file buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - Code unloaded successfully\r
-\r
---*/\r
{\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
UINTN ObjectIndex;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Add code buffer.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param MapFileName - Symbol file name\r
+ @param CodeFileName - Code file name\r
+ @param SourceBufferSize- Code buffer size\r
+ @param SourceBuffer - Code buffer\r
+\r
+ @retval EFI_SUCCESS - CodeBuffer added successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbAddCodeBuffer (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN UINTN SourceBufferSize,\r
IN VOID *SourceBuffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Add code buffer\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- MapFileName - Symbol file name\r
- CodeFileName - Code file name\r
- SourceBufferSize- Code buffer size\r
- SourceBuffer - Code buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - CodeBuffer added successfully\r
-\r
---*/\r
{\r
UINTN Index;\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
return EFI_SUCCESS;\r
}\r
\r
+/**\r
+\r
+ Delete code buffer.\r
+\r
+ @param DebuggerPrivate - EBC Debugger private data structure\r
+ @param MapFileName - Symbol file name\r
+ @param CodeFileName - Code file name\r
+ @param SourceBuffer - Code buffer\r
+\r
+ @retval EFI_SUCCESS - CodeBuffer deleted successfully\r
+\r
+**/\r
EFI_STATUS\r
EdbDeleteCodeBuffer (\r
IN EFI_DEBUGGER_PRIVATE_DATA *DebuggerPrivate,\r
IN CHAR16 *CodeFileName,\r
IN VOID *SourceBuffer\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Delete code buffer\r
-\r
-Arguments:\r
-\r
- DebuggerPrivate - EBC Debugger private data structure\r
- MapFileName - Symbol file name\r
- CodeFileName - Code file name\r
- SourceBuffer - Code buffer\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - CodeBuffer deleted successfully\r
-\r
---*/\r
{\r
UINTN Index;\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
return EFI_SUCCESS;\r
}\r
\r
-CHAR8 *\r
-FindSymbolStr (\r
- IN UINTN Address\r
- )\r
-/*++\r
-\r
-Routine Description:\r
+/**\r
\r
- Find the symbol string according to address\r
+ Find the symbol string according to address.\r
\r
-Arguments:\r
+ @param Address - Symbol address\r
\r
- Address - Symbol address\r
+ @return Symbol string\r
\r
-Returns:\r
-\r
- Symbol string\r
-\r
---*/\r
+**/\r
+CHAR8 *\r
+FindSymbolStr (\r
+ IN UINTN Address\r
+ )\r
{\r
UINTN ObjectIndex;\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Get line number and offset from this line in code file.\r
+\r
+ @param Line - Line buffer in code file\r
+ @param Offset - Offset to functin entry\r
+\r
+ @return Line number\r
+\r
+**/\r
UINTN\r
EdbGetLineNumberAndOffsetFromThisLine (\r
IN VOID *Line,\r
OUT UINTN *Offset\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get line number and offset from this line in code file\r
-\r
-Arguments:\r
-\r
- Line - Line buffer in code file\r
- Offset - Offset to functin entry\r
-\r
-Returns:\r
-\r
- Line number\r
-\r
---*/\r
{\r
UINTN LineNumber;\r
CHAR8 *LineBuffer;\r
EdbEbcLineSearchTypeMax,\r
} EDB_EBC_LINE_SEARCH_TYPE;\r
\r
+/**\r
+\r
+ Get line number from this code file.\r
+\r
+ @param Entry - Symbol entry\r
+ @param FuncOffset - Offset to functin entry\r
+ @param SearchType - Search type for the code\r
+\r
+ @return Line number\r
+\r
+**/\r
UINTN\r
EdbGetLineNumberFromCode (\r
IN EFI_DEBUGGER_SYMBOL_ENTRY *Entry,\r
IN UINTN FuncOffset,\r
IN EDB_EBC_LINE_SEARCH_TYPE SearchType\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get line number from this code file\r
-\r
-Arguments:\r
-\r
- Entry - Symbol entry\r
- FuncOffset - Offset to functin entry\r
- SearchType - Search type for the code\r
-\r
-Returns:\r
-\r
- Line number\r
-\r
---*/\r
{\r
CHAR8 *LineBuffer;\r
UINTN LineNumber;\r
return (UINTN)-1;\r
}\r
\r
+/**\r
+\r
+ Get the source string from this code file by line.\r
+\r
+ @param Entry - Symbol entry\r
+ @param LineNumber - line number\r
+ @param FuncEnd - Function end\r
+\r
+ @return Funtion start\r
+\r
+**/\r
VOID *\r
EdbGetSourceStrFromCodeByLine (\r
IN EFI_DEBUGGER_SYMBOL_ENTRY *Entry,\r
IN UINTN LineNumber,\r
IN VOID **FuncEnd\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get the source string from this code file by line\r
-\r
-Arguments:\r
-\r
- Entry - Symbol entry\r
- LineNumber - line number\r
- FuncEnd - Function end\r
-\r
-Returns:\r
-\r
- Funtion start\r
-\r
---*/\r
{\r
CHAR8 *LineBuffer;\r
CHAR8 *FieldBuffer;\r
return NULL;\r
}\r
\r
+/**\r
+\r
+ Get source string from this code file.\r
+\r
+ @param Entry - Symbol entry\r
+ @param FuncOffset - Offset to functin entry\r
+ @param FuncEnd - Function end\r
+\r
+ @retval Funtion start\r
+\r
+**/\r
VOID *\r
EdbGetSourceStrFromCode (\r
IN EFI_DEBUGGER_SYMBOL_ENTRY *Entry,\r
IN UINTN FuncOffset,\r
IN VOID **FuncEnd\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get source string from this code file\r
-\r
-Arguments:\r
-\r
- Entry - Symbol entry\r
- FuncOffset - Offset to functin entry\r
- FuncEnd - Function end\r
-\r
-Returns:\r
-\r
- Funtion start\r
-\r
---*/\r
{\r
UINTN LineNumber;\r
\r
return EdbGetSourceStrFromCodeByLine (Entry, LineNumber, FuncEnd);\r
}\r
\r
+/**\r
+\r
+ Print source.\r
+\r
+ @param Address - Instruction address\r
+ @param IsPrint - Whether need to print\r
+\r
+ @retval 1 - find the source\r
+ @retval 0 - not find the source\r
+\r
+**/\r
UINTN\r
EdbPrintSource (\r
IN UINTN Address,\r
IN BOOLEAN IsPrint\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Print source\r
-\r
-Arguments:\r
-\r
- Address - Instruction address\r
- IsPrint - Whether need to print\r
-\r
-Returns:\r
-\r
- 1 - find the source\r
- 0 - not find the source\r
-\r
---*/\r
{\r
UINTN SymbolAddress;\r
EFI_DEBUGGER_SYMBOL_OBJECT *RetObject;\r
return 1 ;\r
}\r
\r
+/**\r
+\r
+ Get Mapfile and SymbolName from one symbol format: [MapFileName:]SymbolName.\r
+\r
+ @param Symbol - whole Symbol name\r
+ @param MapfileName - the mapfile name in the symbol\r
+ @param SymbolName - the symbol name in the symbol\r
+\r
+**/\r
VOID\r
GetMapfileAndSymbol (\r
IN CHAR16 *Symbol,\r
OUT CHAR16 **MapfileName,\r
OUT CHAR16 **SymbolName\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Get Mapfile and SymbolName from one symbol format: [MapFileName:]SymbolName\r
-\r
-Arguments:\r
-\r
- Symbol - whole Symbol name\r
- MapfileName - the mapfile name in the symbol\r
- SymbolName - the symbol name in the symbol\r
-\r
-Returns:\r
-\r
- None\r
-\r
---*/\r
{\r
CHAR16 *Ch;\r
\r
return ;\r
}\r
\r
+/**\r
+\r
+ Convert a symbol to an address.\r
+\r
+ @param Symbol - Symbol name\r
+ @param Address - Symbol address\r
+\r
+ @retval EFI_SUCCESS - symbol found and address returned.\r
+ @retval EFI_NOT_FOUND - symbol not found\r
+ @retval EFI_NO_MAPPING - duplicated symbol not found\r
+\r
+**/\r
EFI_STATUS\r
Symboltoi (\r
IN CHAR16 *Symbol,\r
OUT UINTN *Address\r
)\r
-/*++\r
-\r
-Routine Description:\r
-\r
- Convert a symbol to an address\r
-\r
-Arguments:\r
-\r
- Symbol - Symbol name\r
- Address - Symbol address\r
-\r
-Returns:\r
-\r
- EFI_SUCCESS - symbol found and address returned.\r
- EFI_NOT_FOUND - symbol not found\r
- EFI_NO_MAPPING - duplicated symbol not found\r
-\r
---*/\r
{\r
UINTN ObjectIndex;\r
EFI_DEBUGGER_SYMBOL_OBJECT *Object;\r
-/*++\r
+/** @file\r
\r
-Copyright (c) 2007, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2007, 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
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
-Module Name:\r
\r
- EdbSymbol.h\r
-\r
-Abstract:\r
-\r
-\r
---*/\r
+**/\r
\r
#ifndef _EFI_EDB_SYMBOL_H_\r
#define _EFI_EDB_SYMBOL_H_\r
projects / mirror_edk2.git / commitdiff