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>
114 lines
3.8 KiB
C
114 lines
3.8 KiB
C
/** @file
|
|
This protocol defines the generic memory test interfaces in Dxe phase.
|
|
|
|
Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
#define EFI_GENERIC_MEMORY_TEST_PROTOCOL_GUID \
|
|
{ 0x309de7f1, 0x7f5e, 0x4ace, {0xb4, 0x9c, 0x53, 0x1b, 0xe5, 0xaa, 0x95, 0xef} }
|
|
|
|
typedef struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL EFI_GENERIC_MEMORY_TEST_PROTOCOL;
|
|
|
|
///
|
|
/// Memory test coverage level.
|
|
/// Ignore chooses not to test memory. Quick and Sparse test some memory, and Extensive performs a detailed memory test.
|
|
///
|
|
typedef enum {
|
|
IGNORE,
|
|
QUICK,
|
|
SPARSE,
|
|
EXTENSIVE,
|
|
MAXLEVEL
|
|
} EXTENDMEM_COVERAGE_LEVEL;
|
|
|
|
/**
|
|
Initialize the generic memory test.
|
|
|
|
@param This The protocol instance pointer.
|
|
@param Level The coverage level of the memory test.
|
|
@param RequireSoftECCInit Indicate if the memory need software ECC init.
|
|
|
|
@retval EFI_SUCCESS The generic memory test is initialized correctly.
|
|
@retval EFI_NO_MEDIA The system had no memory to be tested.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_MEMORY_TEST_INIT)(
|
|
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,
|
|
IN EXTENDMEM_COVERAGE_LEVEL Level,
|
|
OUT BOOLEAN *RequireSoftECCInit
|
|
);
|
|
|
|
/**
|
|
Perform the memory test.
|
|
|
|
@param This The protocol instance pointer.
|
|
@param TestedMemorySize Return the tested extended memory size.
|
|
@param TotalMemorySize Return the whole system physical memory size.
|
|
The total memory size does not include memory in a slot with a disabled DIMM.
|
|
@param ErrorOut TRUE if the memory error occurred.
|
|
@param IfTestAbort Indicates that the user pressed "ESC" to skip the memory test.
|
|
|
|
@retval EFI_SUCCESS One block of memory passed the test.
|
|
@retval EFI_NOT_FOUND All memory blocks have already been tested.
|
|
@retval EFI_DEVICE_ERROR Memory device error occurred, and no agent can handle it.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_PERFORM_MEMORY_TEST)(
|
|
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,
|
|
OUT UINT64 *TestedMemorySize,
|
|
OUT UINT64 *TotalMemorySize,
|
|
OUT BOOLEAN *ErrorOut,
|
|
IN BOOLEAN IfTestAbort
|
|
);
|
|
|
|
/**
|
|
Finish the memory test.
|
|
|
|
@param This The protocol instance pointer.
|
|
|
|
@retval EFI_SUCCESS Success. All resources used in the memory test are freed.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_MEMORY_TEST_FINISHED)(
|
|
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This
|
|
);
|
|
|
|
/**
|
|
Provides the capability to test the compatible range used by some special drivers.
|
|
|
|
@param This The protocol instance pointer.
|
|
@param StartAddress The start address of the compatible memory range that
|
|
must be below 16M.
|
|
@param Length The compatible memory range's length.
|
|
|
|
@retval EFI_SUCCESS The compatible memory range pass the memory test.
|
|
@retval EFI_INVALID_PARAMETER The compatible memory range are not below Low 16M.
|
|
|
|
**/
|
|
typedef
|
|
EFI_STATUS
|
|
(EFIAPI *EFI_MEMORY_TEST_COMPATIBLE_RANGE)(
|
|
IN EFI_GENERIC_MEMORY_TEST_PROTOCOL *This,
|
|
IN EFI_PHYSICAL_ADDRESS StartAddress,
|
|
IN UINT64 Length
|
|
);
|
|
|
|
struct _EFI_GENERIC_MEMORY_TEST_PROTOCOL {
|
|
EFI_MEMORY_TEST_INIT MemoryTestInit;
|
|
EFI_PERFORM_MEMORY_TEST PerformMemoryTest;
|
|
EFI_MEMORY_TEST_FINISHED Finished;
|
|
EFI_MEMORY_TEST_COMPATIBLE_RANGE CompatibleRangeTest;
|
|
};
|
|
|
|
extern EFI_GUID gEfiGenericMemTestProtocolGuid;
|