mirror of
https://github.com/tianocore/edk2
synced 2026-08-27 00:23:19 -04:00
a0f4ffffff
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>
47 lines
1.2 KiB
C
47 lines
1.2 KiB
C
/** @file
|
|
OP-TEE SMC header file.
|
|
|
|
Copyright (c) 2018, Linaro Ltd. All rights reserved.<BR>
|
|
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
/* Returned in Arg0 only from Trusted OS functions */
|
|
#define OPTEE_SMC_RETURN_OK 0x0
|
|
|
|
#define OPTEE_SMC_RETURN_FROM_RPC 0x32000003
|
|
#define OPTEE_SMC_CALL_WITH_ARG 0x32000004
|
|
#define OPTEE_SMC_GET_SHARED_MEMORY_CONFIG 0xb2000007
|
|
|
|
#define OPTEE_SMC_SHARED_MEMORY_CACHED 1
|
|
|
|
#define OPTEE_SMC_RETURN_UNKNOWN_FUNCTION 0xffffffff
|
|
#define OPTEE_SMC_RETURN_RPC_PREFIX_MASK 0xffff0000
|
|
#define OPTEE_SMC_RETURN_RPC_PREFIX 0xffff0000
|
|
#define OPTEE_SMC_RETURN_RPC_FOREIGN_INTERRUPT 0xffff0004
|
|
|
|
#define OPTEE_MESSAGE_COMMAND_OPEN_SESSION 0
|
|
#define OPTEE_MESSAGE_COMMAND_INVOKE_FUNCTION 1
|
|
#define OPTEE_MESSAGE_COMMAND_CLOSE_SESSION 2
|
|
|
|
#define OPTEE_MESSAGE_ATTRIBUTE_META 0x100
|
|
|
|
#define OPTEE_LOGIN_PUBLIC 0x0
|
|
|
|
typedef struct {
|
|
UINTN Base;
|
|
UINTN Size;
|
|
} OPTEE_SHARED_MEMORY_INFORMATION;
|
|
|
|
//
|
|
// UUID struct compliant with RFC4122 (network byte order).
|
|
//
|
|
typedef struct {
|
|
UINT32 Data1;
|
|
UINT16 Data2;
|
|
UINT16 Data3;
|
|
UINT8 Data4[8];
|
|
} RFC4122_UUID;
|