/** @file\r
- This file declares Read-only Variable Service PPI, which is required PPI by framework spec.\r
+ This file declares the Read-only Variable Service PPI, which is required by the framework spec.\r
\r
These services provide a lightweight, read-only variant of the full EFI variable services. The\r
reason that these services are read-only is to reduce the complexity of flash management. Also,\r
some implementation of the PEI may use the same physical flash part for variable and PEIM\r
- storage; as such, a write command to certain technologies would alter the contents of the entire part,\r
- thus making the in situ PEIM execution not follow the required flow.\r
+ storage. As such, a write command to certain technologies would alter the contents of the entire part,\r
+ making the PEIM execution in the original position not follow the required flow.\r
\r
- Copyright (c) 2006 - 2009, Intel Corporation\r
- All rights reserved. This program and the accompanying materials\r
- are licensed and made available under the terms and conditions of the BSD License\r
- which accompanies this distribution. The full text of the license may be found at\r
- http://opensource.org/licenses/bsd-license.php\r
-\r
- THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
- WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
@par Revision Reference:\r
This PPI is defined in PEI CIS\r
typedef struct _EFI_PEI_READ_ONLY_VARIABLE_PPI EFI_PEI_READ_ONLY_VARIABLE_PPI;\r
\r
///\r
-/// Variable attributes\r
+/// Variable attributes.\r
///@{\r
#define EFI_VARIABLE_NON_VOLATILE 0x00000001\r
#define EFI_VARIABLE_BOOTSERVICE_ACCESS 0x00000002\r
#define EFI_VARIABLE_RUNTIME_ACCESS 0x00000004\r
- /**\r
- /// Inconsistent with specification here: \r
- /// In Framework Spec, PeiCis0.91, neither the macro or its value is defined.\r
- /// Keeping this inconsistancy for backward compatibility.\r
- **/ \r
+///\r
+/// Inconsistent with specification here:\r
+/// In Framework Spec, PeiCis0.91, neither the macro or its value is defined.\r
+/// Keeping this inconsistancy for backward compatibility.\r
+///\r
#define EFI_VARIABLE_READ_ONLY 0x00000008\r
///@}\r
\r
/**\r
- Get Variable value by Name and GUID pair\r
+ Get Variable value by Name and GUID pair.\r
\r
- @param[in] PeiServices An indirect pointer to the PEI Services Table published by the PEI Foundation.\r
+ @param[in] PeiServices An indirect pointer to the PEI Services Table published\r
+ by the PEI Foundation.\r
@param[in] VariableName A NULL-terminated Unicode string that is the name of the vendor's variable.\r
@param[in] VendorGuid A unique identifier for the vendor.\r
@param[out] Attributes This OPTIONAL parameter may be either NULL or\r
/**\r
This function can be called multiple times to retrieve the VariableName\r
and VendorGuid of all variables currently available in the system. On each call\r
- to GetNextVariableName() the previous results are passed into the interface,\r
+ to GetNextVariableName(), the previous results are passed into the interface,\r
and on output the interface returns the next variable name data. When the\r
entire variable list has been returned, the error EFI_NOT_FOUND is returned.\r
\r
- @param[in] PeiServices An indirect pointer to the PEI Services Table published by the PEI Foundation.\r
+ @param[in] PeiServices An indirect pointer to the PEI Services Table\r
+ published by the PEI Foundation.\r
@param[in] VariableNameSize The size of the VariableName buffer.\r
@param[in] VariableName On input, supplies the last VariableName that was\r
- returned by GetNextVariableName(). On output, returns the Null-terminated\r
- Unicode string of the current variable.\r
+ returned by GetNextVariableName(). On output,\r
+ returns the Null-terminated Unicode string of the\r
+ current variable.\r
@param[in] VendorGuid On input, supplies the last VendorGuid that was\r
- returned by GetNextVariableName(). On output, returns the VendorGuid\r
- of the current variable.\r
+ returned by GetNextVariableName(). On output,\r
+ returns the VendorGuid of the current variable.\r
\r
@retval EFI_SUCCESS The function completed successfully.\r
@retval EFI_NOT_FOUND The next variable was not found.\r
@retval EFI_BUFFER_TOO_SMALL The VariableNameSize is too small for the result.\r
@retval EFI_INVALID_PARAMETER One of the parameters has an invalid value.\r
- @retval EFI_DEVICE_ERROR The variable name could not be retrieved due to a hardware error.\r
+ @retval EFI_DEVICE_ERROR The variable name could not be retrieved due to\r
+ a hardware error.\r
\r
**/\r
typedef\r
\r
///\r
/// This PPI provides a lightweight, read-only variant of the full EFI\r
-/// variable services. \r
+/// variable services.\r
///\r
struct _EFI_PEI_READ_ONLY_VARIABLE_PPI {\r
- ///\r
- /// Inconsistent with specification here: \r
+ ///\r
+ /// Inconsistent with specification here:\r
/// In Framework Spec, PeiCis0.91, the field is named as GetVariable and GetNextVariableName.\r
- /// Keeping this inconsistance is for backward compatibility.\r
- /// \r
+ /// Keeping this inconsistancy for backward compatibility.\r
+ ///\r
EFI_PEI_GET_VARIABLE PeiGetVariable; ///< A service to ascertain a given variable name.\r
EFI_PEI_GET_NEXT_VARIABLE_NAME PeiGetNextVariableName; ///< A service to ascertain a variable based upon a given, known variable\r
};\r
\r
extern EFI_GUID gEfiPeiReadOnlyVariablePpiGuid;\r
\r
-#endif /* __PEI_READ_ONLY_VARIABLE_PPI_H__ */\r
+#endif /* __PEI_READ_ONLY_VARIABLE_PPI_H__ */\r
\r