9d510e61fc
https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Jian J Wang <jian.j.wang@intel.com>
118 lines
3.6 KiB
C
118 lines
3.6 KiB
C
/** @file
|
|
EBC Simple Debugger protocol for debug EBC code.
|
|
|
|
Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#ifndef _EBC_SIMPLE_DEBUGGER_PROTOCOL_H_
|
|
#define _EBC_SIMPLE_DEBUGGER_PROTOCOL_H_
|
|
|
|
#include <Protocol/DebugSupport.h>
|
|
#include <Protocol/EbcVmTest.h>
|
|
|
|
#define EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL_GUID \
|
|
{ \
|
|
0x2a72d11e, 0x7376, 0x40f6, { 0x9c, 0x68, 0x23, 0xfa, 0x2f, 0xe3, 0x63, 0xf1 } \
|
|
}
|
|
|
|
//
|
|
// Defines for a simple EBC debugger interface
|
|
//
|
|
typedef struct _EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL;
|
|
|
|
/**
|
|
Trig Exception on EBC VM.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL structure.
|
|
@param[in] VmPtr A pointer to a VM context.
|
|
@param[in] ExceptionType Exception to be trigged.
|
|
|
|
@retval EFI_UNSUPPORTED No support for it.
|
|
@retval EFI_SUCCESS Exception is trigged.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EBC_DEBUGGER_SIGNAL_EXCEPTION) (
|
|
IN EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL *This,
|
|
IN VM_CONTEXT *VmPtr,
|
|
IN EFI_EXCEPTION_TYPE ExceptionType
|
|
);
|
|
|
|
/**
|
|
Given a pointer to a new VM context, debug one or more instructions.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL structure.
|
|
@param[in] VmPtr A pointer to a VM context.
|
|
|
|
@retval EFI_UNSUPPORTED No support for it.
|
|
@retval EFI_SUCCESS Debug one or more instructions.
|
|
|
|
**/
|
|
typedef
|
|
VOID
|
|
(EFIAPI *EBC_DEBUGGER_DEBUG) (
|
|
IN EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL *This,
|
|
IN VM_CONTEXT *VmPtr
|
|
);
|
|
|
|
/**
|
|
Given a pointer to a new VM context, dump one or more instructions.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL structure.
|
|
@param[in] VmPtr A pointer to a VM context.
|
|
@param[in] DasmString Dump string buffer.
|
|
@param[in] DasmStringSize Dump string size.
|
|
|
|
@retval EFI_UNSUPPORTED No support for it.
|
|
@retval EFI_SUCCESS Dump one or more instructions.
|
|
|
|
**/
|
|
typedef
|
|
UINT32
|
|
(EFIAPI *EBC_DEBUGGER_DASM) (
|
|
IN EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL *This,
|
|
IN VM_CONTEXT *VmPtr,
|
|
IN UINT16 *DasmString OPTIONAL,
|
|
IN UINT32 DasmStringSize
|
|
);
|
|
|
|
/**
|
|
This interface allows you to configure the EBC debug support
|
|
driver. For example, turn on or off saving and printing of
|
|
delta VM even if called. Or to even disable the entire interface,
|
|
in which case all functions become no-ops.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL structure.
|
|
@param[in] ConfigId ID to be configured.
|
|
@param[in] ConfigValue Value to be set.
|
|
|
|
@retval EFI_UNSUPPORTED No support for it.
|
|
@retval EFI_SUCCESS Configure EBC debug.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EBC_DEBUGGER_CONFIGURE) (
|
|
IN EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL *This,
|
|
IN UINT32 ConfigId,
|
|
IN UINTN ConfigValue
|
|
);
|
|
|
|
//
|
|
// Prototype for the actual EBC debug support protocol interface
|
|
//
|
|
struct _EFI_EBC_SIMPLE_DEBUGGER_PROTOCOL {
|
|
EBC_DEBUGGER_DEBUG Debugger;
|
|
EBC_DEBUGGER_SIGNAL_EXCEPTION SignalException;
|
|
EBC_DEBUGGER_DASM Dasm;
|
|
EBC_DEBUGGER_CONFIGURE Configure;
|
|
};
|
|
|
|
extern EFI_GUID gEfiEbcSimpleDebuggerProtocolGuid;
|
|
|
|
#endif
|