You've already forked edk2-upstream
mirror of
https://github.com/Dasharo/edk2-upstream.git
synced 2026-03-06 15:03:57 -08:00
8472271dae
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>
278 lines
8.8 KiB
C
278 lines
8.8 KiB
C
/** @file
|
|
function definitions for shell environment functions.
|
|
|
|
the following includes are required:
|
|
//#include <Guid/ShellVariableGuid.h>
|
|
//#include <Library/UefiRuntimeServicesTableLib.h>
|
|
|
|
|
|
Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.<BR>
|
|
SPDX-License-Identifier: BSD-2-Clause-Patent
|
|
|
|
**/
|
|
|
|
#pragma once
|
|
|
|
typedef struct {
|
|
LIST_ENTRY Link;
|
|
CHAR16 *Key;
|
|
CHAR16 *Val;
|
|
UINT32 Atts;
|
|
} ENV_VAR_LIST;
|
|
|
|
//
|
|
// The list is used to cache the environment variables.
|
|
//
|
|
extern ENV_VAR_LIST gShellEnvVarList;
|
|
|
|
/**
|
|
Reports whether an environment variable is Volatile or Non-Volatile.
|
|
|
|
@param EnvVarName The name of the environment variable in question
|
|
@param Volatile Return TRUE if the environment variable is volatile
|
|
|
|
@retval EFI_SUCCESS The volatile attribute is returned successfully
|
|
@retval others Some errors happened.
|
|
**/
|
|
EFI_STATUS
|
|
IsVolatileEnv (
|
|
IN CONST CHAR16 *EnvVarName,
|
|
OUT BOOLEAN *Volatile
|
|
);
|
|
|
|
/**
|
|
Delete a Non-Volatile environment variable.
|
|
|
|
This will use the Runtime Services call SetVariable to remove a non-volatile variable.
|
|
|
|
@param EnvVarName The name of the environment variable in question
|
|
|
|
@retval EFI_SUCCESS The variable was deleted successfully
|
|
@retval other An error occurred
|
|
@sa SetVariable
|
|
**/
|
|
#define SHELL_DELETE_ENVIRONMENT_VARIABLE(EnvVarName) \
|
|
(gRT->SetVariable((CHAR16*)EnvVarName, \
|
|
&gShellVariableGuid, \
|
|
0, \
|
|
0, \
|
|
NULL))
|
|
|
|
/**
|
|
Set a Non-Volatile environment variable.
|
|
|
|
This will use the Runtime Services call SetVariable to set a non-volatile variable.
|
|
|
|
@param EnvVarName The name of the environment variable in question
|
|
@param BufferSize UINTN size of Buffer
|
|
@param Buffer Pointer to value to set variable to
|
|
|
|
@retval EFI_SUCCESS The variable was changed successfully
|
|
@retval other An error occurred
|
|
@sa SetVariable
|
|
**/
|
|
#define SHELL_SET_ENVIRONMENT_VARIABLE_NV(EnvVarName, BufferSize, Buffer) \
|
|
(gRT->SetVariable((CHAR16*)EnvVarName, \
|
|
&gShellVariableGuid, \
|
|
EFI_VARIABLE_NON_VOLATILE|EFI_VARIABLE_BOOTSERVICE_ACCESS, \
|
|
BufferSize, \
|
|
(VOID*)Buffer))
|
|
|
|
/**
|
|
Get an environment variable.
|
|
|
|
This will use the Runtime Services call GetVariable to get a variable.
|
|
|
|
@param EnvVarName The name of the environment variable in question
|
|
@param BufferSize Pointer to the UINTN size of Buffer
|
|
@param Buffer Pointer buffer to get variable value into
|
|
|
|
@retval EFI_SUCCESS The variable's value was retrieved successfully
|
|
@retval other An error occurred
|
|
@sa SetVariable
|
|
**/
|
|
#define SHELL_GET_ENVIRONMENT_VARIABLE(EnvVarName, BufferSize, Buffer) \
|
|
(gRT->GetVariable((CHAR16*)EnvVarName, \
|
|
&gShellVariableGuid, \
|
|
0, \
|
|
BufferSize, \
|
|
Buffer))
|
|
|
|
/**
|
|
Get an environment variable.
|
|
|
|
This will use the Runtime Services call GetVariable to get a variable.
|
|
|
|
@param EnvVarName The name of the environment variable in question
|
|
@param Atts Pointer to the UINT32 for attributes (or NULL)
|
|
@param BufferSize Pointer to the UINTN size of Buffer
|
|
@param Buffer Pointer buffer to get variable value into
|
|
|
|
@retval EFI_SUCCESS The variable's value was retrieved successfully
|
|
@retval other An error occurred
|
|
@sa SetVariable
|
|
**/
|
|
#define SHELL_GET_ENVIRONMENT_VARIABLE_AND_ATTRIBUTES(EnvVarName, Atts, BufferSize, Buffer) \
|
|
(gRT->GetVariable((CHAR16*)EnvVarName, \
|
|
&gShellVariableGuid, \
|
|
Atts, \
|
|
BufferSize, \
|
|
Buffer))
|
|
|
|
/**
|
|
Set a Volatile environment variable.
|
|
|
|
This will use the Runtime Services call SetVariable to set a volatile variable.
|
|
|
|
@param EnvVarName The name of the environment variable in question
|
|
@param BufferSize UINTN size of Buffer
|
|
@param Buffer Pointer to value to set variable to
|
|
|
|
@retval EFI_SUCCESS The variable was changed successfully
|
|
@retval other An error occurred
|
|
@sa SetVariable
|
|
**/
|
|
#define SHELL_SET_ENVIRONMENT_VARIABLE_V(EnvVarName, BufferSize, Buffer) \
|
|
(gRT->SetVariable((CHAR16*)EnvVarName, \
|
|
&gShellVariableGuid, \
|
|
EFI_VARIABLE_BOOTSERVICE_ACCESS, \
|
|
BufferSize, \
|
|
(VOID*)Buffer))
|
|
|
|
/**
|
|
Creates a list of all Shell-Guid-based environment variables.
|
|
|
|
@param[in, out] List The pointer to pointer to LIST_ENTRY object for
|
|
storing this list.
|
|
|
|
@retval EFI_SUCCESS the list was created successfully.
|
|
**/
|
|
EFI_STATUS
|
|
GetEnvironmentVariableList (
|
|
IN OUT LIST_ENTRY *List
|
|
);
|
|
|
|
/**
|
|
Sets a list of all Shell-Guid-based environment variables. this will
|
|
also eliminate all pre-existing shell environment variables (even if they
|
|
are not on the list).
|
|
|
|
This function will also deallocate the memory from List.
|
|
|
|
@param[in] List The pointer to LIST_ENTRY from
|
|
GetShellEnvVarList().
|
|
|
|
@retval EFI_SUCCESS The list was Set successfully.
|
|
**/
|
|
EFI_STATUS
|
|
SetEnvironmentVariableList (
|
|
IN LIST_ENTRY *List
|
|
);
|
|
|
|
/**
|
|
sets all Shell-Guid-based environment variables. this will
|
|
also eliminate all pre-existing shell environment variables (even if they
|
|
are not on the list).
|
|
|
|
@param[in] Environment Points to a NULL-terminated array of environment
|
|
variables with the format 'x=y', where x is the
|
|
environment variable name and y is the value.
|
|
|
|
@retval EFI_SUCCESS The command executed successfully.
|
|
@retval EFI_INVALID_PARAMETER The parameter is invalid.
|
|
@retval EFI_OUT_OF_RESOURCES Out of resources.
|
|
|
|
@sa SetEnvironmentVariableList
|
|
**/
|
|
EFI_STATUS
|
|
SetEnvironmentVariables (
|
|
IN CONST CHAR16 **Environment
|
|
);
|
|
|
|
/**
|
|
free function for ENV_VAR_LIST objects.
|
|
|
|
@param[in] List The pointer to pointer to list.
|
|
**/
|
|
VOID
|
|
FreeEnvironmentVariableList (
|
|
IN LIST_ENTRY *List
|
|
);
|
|
|
|
/**
|
|
Find an environment variable in the gShellEnvVarList.
|
|
|
|
@param Key The name of the environment variable.
|
|
@param Value The value of the environment variable, the buffer
|
|
shoule be freed by the caller.
|
|
@param ValueSize The size in bytes of the environment variable
|
|
including the tailing CHAR_NULL.
|
|
@param Atts The attributes of the variable.
|
|
|
|
@retval EFI_SUCCESS The command executed successfully.
|
|
@retval EFI_NOT_FOUND The environment variable is not found in
|
|
gShellEnvVarList.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ShellFindEnvVarInList (
|
|
IN CONST CHAR16 *Key,
|
|
OUT CHAR16 **Value,
|
|
OUT UINTN *ValueSize,
|
|
OUT UINT32 *Atts OPTIONAL
|
|
);
|
|
|
|
/**
|
|
Add an environment variable into gShellEnvVarList.
|
|
|
|
@param Key The name of the environment variable.
|
|
@param Value The value of environment variable.
|
|
@param ValueSize The size in bytes of the environment variable
|
|
including the tailing CHAR_NULL
|
|
@param Atts The attributes of the variable.
|
|
|
|
@retval EFI_SUCCESS The environment variable was added to list successfully.
|
|
@retval others Some errors happened.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ShellAddEnvVarToList (
|
|
IN CONST CHAR16 *Key,
|
|
IN CONST CHAR16 *Value,
|
|
IN UINTN ValueSize,
|
|
IN UINT32 Atts
|
|
);
|
|
|
|
/**
|
|
Remove a specified environment variable in gShellEnvVarList.
|
|
|
|
@param Key The name of the environment variable.
|
|
|
|
@retval EFI_SUCCESS The command executed successfully.
|
|
@retval EFI_NOT_FOUND The environment variable is not found in
|
|
gShellEnvVarList.
|
|
**/
|
|
EFI_STATUS
|
|
ShellRemvoeEnvVarFromList (
|
|
IN CONST CHAR16 *Key
|
|
);
|
|
|
|
/**
|
|
Initialize the gShellEnvVarList and cache all Shell-Guid-based environment
|
|
variables.
|
|
|
|
**/
|
|
EFI_STATUS
|
|
ShellInitEnvVarList (
|
|
VOID
|
|
);
|
|
|
|
/**
|
|
Destructe the gShellEnvVarList.
|
|
|
|
**/
|
|
VOID
|
|
ShellFreeEnvVarList (
|
|
VOID
|
|
);
|