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>
116 lines
4.9 KiB
C
116 lines
4.9 KiB
C
/** @file
|
|
The internal header file that declared a data structure that is shared
|
|
between the SMM IPL and the SMM Core.
|
|
|
|
Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
///
|
|
/// Define values for the communications buffer used when gEfiEventDxeDispatchGuid is
|
|
/// event signaled. This event is signaled by the DXE Core each time the DXE Core
|
|
/// dispatcher has completed its work. When this event is signaled, the SMM Core
|
|
/// if notified, so the SMM Core can dispatch SMM drivers. If COMM_BUFFER_SMM_DISPATCH_ERROR
|
|
/// is returned in the communication buffer, then an error occurred dispatching SMM
|
|
/// Drivers. If COMM_BUFFER_SMM_DISPATCH_SUCCESS is returned, then the SMM Core
|
|
/// dispatched all the drivers it could. If COMM_BUFFER_SMM_DISPATCH_RESTART is
|
|
/// returned, then the SMM Core just dispatched the SMM Driver that registered
|
|
/// the SMM Entry Point enabling the use of SMM Mode. In this case, the SMM Core
|
|
/// should be notified again to dispatch more SMM Drivers using SMM Mode.
|
|
///
|
|
#define COMM_BUFFER_SMM_DISPATCH_ERROR 0x00
|
|
#define COMM_BUFFER_SMM_DISPATCH_SUCCESS 0x01
|
|
#define COMM_BUFFER_SMM_DISPATCH_RESTART 0x02
|
|
|
|
///
|
|
/// Signature for the private structure shared between the SMM IPL and the SMM Core
|
|
///
|
|
#define SMM_CORE_PRIVATE_DATA_SIGNATURE SIGNATURE_32 ('s', 'm', 'm', 'c')
|
|
|
|
///
|
|
/// Private structure that is used to share information between the SMM IPL and
|
|
/// the SMM Core. This structure is allocated from memory of type EfiRuntimeServicesData.
|
|
/// Since runtime memory types are converted to available memory when a legacy boot
|
|
/// is performed, the SMM Core must not access any fields of this structure if a legacy
|
|
/// boot is performed. As a result, the SMM IPL must create an event notification
|
|
/// for the Legacy Boot event and notify the SMM Core that a legacy boot is being
|
|
/// performed. The SMM Core can then use this information to filter accesses to
|
|
/// thos structure.
|
|
///
|
|
typedef struct {
|
|
UINTN Signature;
|
|
|
|
///
|
|
/// The ImageHandle passed into the entry point of the SMM IPL. This ImageHandle
|
|
/// is used by the SMM Core to fill in the ParentImageHandle field of the Loaded
|
|
/// Image Protocol for each SMM Driver that is dispatched by the SMM Core.
|
|
///
|
|
EFI_HANDLE SmmIplImageHandle;
|
|
|
|
///
|
|
/// The number of SMRAM ranges passed from the SMM IPL to the SMM Core. The SMM
|
|
/// Core uses these ranges of SMRAM to initialize the SMM Core memory manager.
|
|
///
|
|
UINTN SmramRangeCount;
|
|
|
|
///
|
|
/// A table of SMRAM ranges passed from the SMM IPL to the SMM Core. The SMM
|
|
/// Core uses these ranges of SMRAM to initialize the SMM Core memory manager.
|
|
///
|
|
EFI_SMRAM_DESCRIPTOR *SmramRanges;
|
|
|
|
///
|
|
/// The SMM Foundation Entry Point. The SMM Core fills in this field when the
|
|
/// SMM Core is initialized. The SMM IPL is responsible for registering this entry
|
|
/// point with the SMM Configuration Protocol. The SMM Configuration Protocol may
|
|
/// not be available at the time the SMM IPL and SMM Core are started, so the SMM IPL
|
|
/// sets up a protocol notification on the SMM Configuration Protocol and registers
|
|
/// the SMM Foundation Entry Point as soon as the SMM Configuration Protocol is
|
|
/// available.
|
|
///
|
|
EFI_SMM_ENTRY_POINT SmmEntryPoint;
|
|
|
|
///
|
|
/// Boolean flag set to TRUE while an SMI is being processed by the SMM Core.
|
|
///
|
|
BOOLEAN SmmEntryPointRegistered;
|
|
|
|
///
|
|
/// Boolean flag set to TRUE while an SMI is being processed by the SMM Core.
|
|
///
|
|
BOOLEAN InSmm;
|
|
|
|
///
|
|
/// This field is set by the SMM Core then the SMM Core is initialized. This field is
|
|
/// used by the SMM Base 2 Protocol and SMM Communication Protocol implementations in
|
|
/// the SMM IPL.
|
|
///
|
|
EFI_SMM_SYSTEM_TABLE2 *Smst;
|
|
|
|
///
|
|
/// This field is used by the SMM Communication Protocol to pass a buffer into
|
|
/// a software SMI handler and for the software SMI handler to pass a buffer back to
|
|
/// the caller of the SMM Communication Protocol.
|
|
///
|
|
VOID *CommunicationBuffer;
|
|
|
|
///
|
|
/// This field is used by the SMM Communication Protocol to pass the size of a buffer,
|
|
/// in bytes, into a software SMI handler and for the software SMI handler to pass the
|
|
/// size, in bytes, of a buffer back to the caller of the SMM Communication Protocol.
|
|
///
|
|
UINTN BufferSize;
|
|
|
|
///
|
|
/// This field is used by the SMM Communication Protocol to pass the return status from
|
|
/// a software SMI handler back to the caller of the SMM Communication Protocol.
|
|
///
|
|
EFI_STATUS ReturnStatus;
|
|
|
|
EFI_PHYSICAL_ADDRESS PiSmmCoreImageBase;
|
|
UINT64 PiSmmCoreImageSize;
|
|
EFI_PHYSICAL_ADDRESS PiSmmCoreEntryPoint;
|
|
} SMM_CORE_PRIVATE_DATA;
|