You've already forked edk2-upstream
mirror of
https://github.com/Dasharo/edk2-upstream.git
synced 2026-03-06 15:03:57 -08: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>
96 lines
3.1 KiB
C
96 lines
3.1 KiB
C
/** @file
|
|
Debug Agent Library provide source-level debug capability.
|
|
|
|
Copyright (c) 2010 - 2012, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
#define DEBUG_AGENT_INIT_PREMEM_SEC 1
|
|
#define DEBUG_AGENT_INIT_POSTMEM_SEC 2
|
|
#define DEBUG_AGENT_INIT_DXE_CORE 3
|
|
#define DEBUG_AGENT_INIT_SMM 4
|
|
#define DEBUG_AGENT_INIT_ENTER_SMI 5
|
|
#define DEBUG_AGENT_INIT_EXIT_SMI 6
|
|
#define DEBUG_AGENT_INIT_S3 7
|
|
#define DEBUG_AGENT_INIT_DXE_AP 8
|
|
#define DEBUG_AGENT_INIT_PEI 9
|
|
#define DEBUG_AGENT_INIT_DXE_LOAD 10
|
|
#define DEBUG_AGENT_INIT_DXE_UNLOAD 11
|
|
#define DEBUG_AGENT_INIT_THUNK_PEI_IA32TOX64 12
|
|
#define DEBUG_AGENT_INIT_REINITIALIZE 13
|
|
#define DEBUG_AGENT_INIT_DXE_CORE_LATE 14
|
|
|
|
//
|
|
// Context for DEBUG_AGENT_INIT_POSTMEM_SEC
|
|
//
|
|
typedef struct {
|
|
UINTN HeapMigrateOffset;
|
|
UINTN StackMigrateOffset;
|
|
} DEBUG_AGENT_CONTEXT_POSTMEM_SEC;
|
|
|
|
/**
|
|
Caller provided function to be invoked at the end of InitializeDebugAgent().
|
|
|
|
Refer to the description for InitializeDebugAgent() for more details.
|
|
|
|
@param[in] Context The first input parameter of InitializeDebugAgent().
|
|
|
|
**/
|
|
typedef
|
|
VOID
|
|
(EFIAPI *DEBUG_AGENT_CONTINUE)(
|
|
IN VOID *Context
|
|
);
|
|
|
|
/**
|
|
Initialize debug agent.
|
|
|
|
This function is used to set up debug environment to support source level debugging.
|
|
If certain Debug Agent Library instance has to save some private data in the stack,
|
|
this function must work on the mode that doesn't return to the caller, then
|
|
the caller needs to wrap up all rest of logic after InitializeDebugAgent() into one
|
|
function and pass it into InitializeDebugAgent(). InitializeDebugAgent() is
|
|
responsible to invoke the passing-in function at the end of InitializeDebugAgent().
|
|
|
|
If the parameter Function is not NULL, Debug Agent Library instance will invoke it by
|
|
passing in the Context to be its parameter.
|
|
|
|
If Function() is NULL, Debug Agent Library instance will return after setup debug
|
|
environment.
|
|
|
|
@param[in] InitFlag Init flag is used to decide the initialize process.
|
|
@param[in] Context Context needed according to InitFlag; it was optional.
|
|
@param[in] Function Continue function called by debug agent library; it was
|
|
optional.
|
|
|
|
**/
|
|
VOID
|
|
EFIAPI
|
|
InitializeDebugAgent (
|
|
IN UINT32 InitFlag,
|
|
IN VOID *Context OPTIONAL,
|
|
IN DEBUG_AGENT_CONTINUE Function OPTIONAL
|
|
);
|
|
|
|
/**
|
|
Enable/Disable the interrupt of debug timer and return the interrupt state
|
|
prior to the operation.
|
|
|
|
If EnableStatus is TRUE, enable the interrupt of debug timer.
|
|
If EnableStatus is FALSE, disable the interrupt of debug timer.
|
|
|
|
@param[in] EnableStatus Enable/Disable.
|
|
|
|
@retval TRUE Debug timer interrupt were enabled on entry to this call.
|
|
@retval FALSE Debug timer interrupt were disabled on entry to this call.
|
|
|
|
**/
|
|
BOOLEAN
|
|
EFIAPI
|
|
SaveAndSetDebugTimerInterrupt (
|
|
IN BOOLEAN EnableStatus
|
|
);
|