mirror of
https://github.com/tianocore/edk2
synced 2026-08-27 00:23:19 -04:00
7a934d0bef
Replace traditional `#ifndef`/`#define`/`#endif` include guards with
`#pragma` once.
`#pragma once` is a widely supported preprocessor directive that
prevents header files from being included multiple times. It is
supported by all toolchains used to build edk2: GCC, Clang/LLVM, and
MSVC.
Compared to macro-based include guards, `#pragma once`:
- Eliminates the risk of macro name collisions or copy/paste errors
where two headers inadvertently use the same guard macro.
- Eliminate inconsistency in the way include guard macros are named
(e.g., some files use `__FILE_H__`, others use `FILE_H_`, etc.).
- Reduces boilerplate (three lines replaced by one).
- Avoids polluting the macro namespace with guard symbols.
- Can improve build times as the preprocessor can skip re-opening the
file entirely, rather than re-reading it to find the matching
`#endif` ("multiple-include optimization").
- Note that some compilers may already optimize traditional include
guards, by recognzining the idiomatic pattern.
This change is made acknowledging that overall portability of the
code will technically be reduced, as `#pragma once` is not part of the
C/C++ standards.
However, this is considered acceptable given:
1. edk2 already defines a subset of supported compilers in
BaseTools/Conf/tools_def.template, all of which have supported
`#pragma once` for over two decades.
2. There have been concerns raised to the project about inconsistent
include guard naming and potential macro collisions.
Approximate compiler support dates:
- MSVC: Supported since Visual C++ 4.2 (1996)
- GCC: Supported since 3.4 (2004)
(http://gnu.ist.utl.pt/software/gcc/gcc-3.4/changes.html)
- Clang (LLVM based): Since initial release in 2007
Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
181 lines
6.4 KiB
C
181 lines
6.4 KiB
C
/** @file
|
|
EBC VM Test protocol for test purposes.
|
|
|
|
Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
//
|
|
// Define a protocol for an EBC VM test interface.
|
|
//
|
|
#define EFI_EBC_VM_TEST_PROTOCOL_GUID \
|
|
{ \
|
|
0xAAEACCFD, 0xF27B, 0x4C17, { 0xB6, 0x10, 0x75, 0xCA, 0x1F, 0x2D, 0xFB, 0x52 } \
|
|
}
|
|
|
|
//
|
|
// Define for forward reference.
|
|
//
|
|
typedef struct _EFI_EBC_VM_TEST_PROTOCOL EFI_EBC_VM_TEST_PROTOCOL;
|
|
|
|
//
|
|
// VM major/minor version
|
|
//
|
|
#define VM_MAJOR_VERSION 1
|
|
#define VM_MINOR_VERSION 0
|
|
|
|
//
|
|
// Bits in the VM->StopFlags field
|
|
//
|
|
#define STOPFLAG_APP_DONE 0x0001
|
|
#define STOPFLAG_BREAKPOINT 0x0002
|
|
#define STOPFLAG_INVALID_BREAK 0x0004
|
|
#define STOPFLAG_BREAK_ON_CALLEX 0x0008
|
|
|
|
//
|
|
// Masks for working with the VM flags register
|
|
//
|
|
#define VMFLAGS_CC 0x0001 // condition flag
|
|
#define VMFLAGS_STEP 0x0002 // step instruction mode
|
|
#define VMFLAGS_ALL_VALID (VMFLAGS_CC | VMFLAGS_STEP)
|
|
|
|
//
|
|
// Macros for operating on the VM flags register
|
|
//
|
|
#define VMFLAG_SET(pVM, Flag) (pVM->Flags |= (Flag))
|
|
#define VMFLAG_ISSET(pVM, Flag) ((pVM->Flags & (Flag)) ? 1 : 0)
|
|
#define VMFLAG_CLEAR(pVM, Flag) (pVM->Flags &= ~(Flag))
|
|
|
|
//
|
|
// Define a macro to get the operand. Then we can change it to be either a
|
|
// direct read or have it call a function to read memory.
|
|
//
|
|
#define GETOPERANDS(pVM) (UINT8) (*(UINT8 *) (pVM->Ip + 1))
|
|
#define GETOPCODE(pVM) (UINT8) (*(UINT8 *) pVM->Ip)
|
|
|
|
//
|
|
// Macros for operating on the VM GP registers
|
|
//
|
|
#define OPERAND1_REGDATA(pVM, Op) pVM->Gpr[OPERAND1_REGNUM (Op)]
|
|
#define OPERAND2_REGDATA(pVM, Op) pVM->Gpr[OPERAND2_REGNUM (Op)]
|
|
|
|
//
|
|
// Bits of exception flags field of VM context
|
|
//
|
|
#define EXCEPTION_FLAG_FATAL 0x80000000 // can't continue
|
|
#define EXCEPTION_FLAG_ERROR 0x40000000 // bad, but try to continue
|
|
#define EXCEPTION_FLAG_WARNING 0x20000000 // harmless problem
|
|
#define EXCEPTION_FLAG_NONE 0x00000000 // for normal return
|
|
|
|
///
|
|
/// instruction pointer for the VM
|
|
///
|
|
typedef UINT8 *VMIP;
|
|
|
|
typedef INT64 VM_REGISTER;
|
|
typedef UINT32 EXCEPTION_FLAGS;
|
|
|
|
typedef struct {
|
|
VM_REGISTER Gpr[8]; ///< General purpose registers.
|
|
///< Flags register:
|
|
///< 0 Set to 1 if the result of the last compare was true
|
|
///< 1 Set to 1 if stepping
|
|
UINT64 Flags; ///< 2..63 Reserved.
|
|
VMIP Ip; ///< Instruction pointer.
|
|
UINTN LastException;
|
|
EXCEPTION_FLAGS ExceptionFlags; ///< to keep track of exceptions
|
|
UINT32 StopFlags;
|
|
UINT32 CompilerVersion; ///< via break(6)
|
|
UINTN HighStackBottom; ///< bottom of the upper stack
|
|
UINTN LowStackTop; ///< top of the lower stack
|
|
UINT64 StackRetAddr; ///< location of final return address on stack
|
|
UINTN *StackMagicPtr; ///< pointer to magic value on stack to detect corruption
|
|
EFI_HANDLE ImageHandle; ///< for this EBC driver
|
|
EFI_SYSTEM_TABLE *SystemTable; ///< for debugging only
|
|
UINTN LastAddrConverted; ///< for debug
|
|
UINTN LastAddrConvertedValue; ///< for debug
|
|
VOID *FramePtr;
|
|
VOID *EntryPoint; ///< entry point of EBC image
|
|
UINTN ImageBase;
|
|
VOID *StackPool;
|
|
VOID *StackTop;
|
|
} VM_CONTEXT;
|
|
|
|
/**
|
|
Given a pointer to a new VM context, execute one or more instructions. This
|
|
function is only used for test purposes.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_VM_TEST_PROTOCOL structure.
|
|
@param[in] VmPtr A pointer to a VM context.
|
|
@param[in, out] InstructionCount A pointer to a UINTN value holding the number of
|
|
instructions to execute. If it holds value of 0,
|
|
then the instruction to be executed is 1.
|
|
|
|
@retval EFI_UNSUPPORTED At least one of the opcodes is not supported.
|
|
@retval EFI_SUCCESS All of the instructions are executed successfully.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EBC_VM_TEST_EXECUTE)(
|
|
IN EFI_EBC_VM_TEST_PROTOCOL *This,
|
|
IN VM_CONTEXT *VmPtr,
|
|
IN OUT UINTN *InstructionCount
|
|
);
|
|
|
|
/**
|
|
Convert AsmText to the instruction. This function is only used for test purposes.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_VM_TEST_PROTOCOL structure.
|
|
@param[in] AsmText A pointer to EBC ASM text code.
|
|
@param[out] Buffer Buffer to store the instruction.
|
|
@param[out] BufferLen Size of buffer that is required to store data.
|
|
|
|
@retval EFI_UNSUPPORTED This functionality is unsupported.
|
|
@retval EFI_SUCCESS Successfully convert AsmText to the instruction.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EBC_VM_TEST_ASM)(
|
|
IN EFI_EBC_VM_TEST_PROTOCOL *This,
|
|
IN CHAR16 *AsmText,
|
|
IN OUT INT8 *Buffer,
|
|
IN OUT UINTN *BufferLen
|
|
);
|
|
|
|
/**
|
|
Dump the executed instruction. This function is only used for test purposes.
|
|
|
|
@param[in] This A pointer to the EFI_EBC_VM_TEST_PROTOCOL structure.
|
|
@param[out] AsmText Contain the disasm text.
|
|
@param[out] Buffer Buffer to store the instruction.
|
|
@param[out] BufferLen Size of buffer that is required to store data.
|
|
|
|
@retval EFI_UNSUPPORTED This functionality is unsupported.
|
|
@retval EFI_SUCCESS Successfully dump the executed instruction.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EBC_VM_TEST_DASM)(
|
|
IN EFI_EBC_VM_TEST_PROTOCOL *This,
|
|
IN OUT CHAR16 *AsmText,
|
|
IN OUT INT8 *Buffer,
|
|
IN OUT UINTN *Len
|
|
);
|
|
|
|
//
|
|
// Prototype for the actual EBC test protocol interface
|
|
//
|
|
struct _EFI_EBC_VM_TEST_PROTOCOL {
|
|
EBC_VM_TEST_EXECUTE Execute;
|
|
EBC_VM_TEST_ASM Assemble;
|
|
EBC_VM_TEST_DASM Disassemble;
|
|
};
|
|
|
|
extern EFI_GUID gEfiEbcVmTestProtocolGuid;
|