audk/MdePkg/Library/MmUnblockMemoryLib/MmUnblockMemoryLibNull.inf

## @file
#  Null instance of MM Unblock Page Library.
#
#  This library provides an interface to request non-MMRAM pages to be mapped/unblocked
#  from inside MM environment.
#
#  For MM modules that need to access regions outside of MMRAMs, the agents that set up
#  these regions are responsible for invoking this API in order for these memory areas
#  to be accessed from inside MM.
#
#  Copyright (c) Microsoft Corporation.
#  SPDX-License-Identifier: BSD-2-Clause-Patent
#
#
##

[Defines]
  INF_VERSION                    = 0x0001001B
  BASE_NAME                      = MmUnblockMemoryLibNull
  MODULE_UNI_FILE                = MmUnblockMemoryLibNull.uni
  FILE_GUID                      = 9E890F68-5C95-4C31-95DD-59E6286F85EA
  MODULE_TYPE                    = BASE
  VERSION_STRING                 = 1.0
  LIBRARY_CLASS                  = MmUnblockMemoryLib

#
#  VALID_ARCHITECTURES           = IA32 X64
#

[Sources]
  MmUnblockMemoryLibNull.c

[Packages]
  MdePkg/MdePkg.dec
MdePkg: MmUnblockMemoryLib: Added definition and null instance REF: https://bugzilla.tianocore.org/show_bug.cgi?id=3168 This interface provides an abstration layer to allow MM modules to access requested areas that are outside of MMRAM. On MM model that blocks all non-MMRAM accesses, areas requested through this API will be mapped or unblocked for accessibility inside MM environment. For MM modules that need to access regions outside of MMRAMs, the agents that set up these regions are responsible for invoking this API in order for these memory areas to be accessible from inside MM. Example usages: 1. To enable runtime cache feature for variable service, Variable MM module will need to access the allocated runtime buffer. Thus the agent sets up these buffers, VariableSmmRuntimeDxe, will need to invoke this API to make these regions accessible by Variable MM. 2. For TPM ACPI table to communicate to physical presence handler, the corresponding NVS region has to be accessible from inside MM. Once the NVS region are assigned, it needs to be unblocked thourgh this API. Cc: Michael D Kinney <michael.d.kinney@intel.com> Cc: Liming Gao <gaoliming@byosoft.com.cn> Cc: Zhiguang Liu <zhiguang.liu@intel.com> Cc: Hao A Wu <hao.a.wu@intel.com> Cc: Jiewen Yao <jiewen.yao@intel.com> Cc: Laszlo Ersek <lersek@redhat.com> Signed-off-by: Kun Qin <kun.q@outlook.com> Acked-by: Laszlo Ersek <lersek@redhat.com> Reviewed-by: Liming Gao <gaoliming@byosoft.com.cn> Message-Id: <MWHPR06MB31028AF0D0785B93E4E7CF63F3969@MWHPR06MB3102.namprd06.prod.outlook.com> 2021-03-05 05:12:47 +01:00			`## @file`
			`# Null instance of MM Unblock Page Library.`
			`#`
			`# This library provides an interface to request non-MMRAM pages to be mapped/unblocked`
			`# from inside MM environment.`
			`#`
			`# For MM modules that need to access regions outside of MMRAMs, the agents that set up`
			`# these regions are responsible for invoking this API in order for these memory areas`
			`# to be accessed from inside MM.`
			`#`
			`# Copyright (c) Microsoft Corporation.`
			`# SPDX-License-Identifier: BSD-2-Clause-Patent`
			`#`
			`#`
			`##`

			`[Defines]`
			`INF_VERSION = 0x0001001B`
			`BASE_NAME = MmUnblockMemoryLibNull`
			`MODULE_UNI_FILE = MmUnblockMemoryLibNull.uni`
			`FILE_GUID = 9E890F68-5C95-4C31-95DD-59E6286F85EA`
			`MODULE_TYPE = BASE`
			`VERSION_STRING = 1.0`
			`LIBRARY_CLASS = MmUnblockMemoryLib`

			`#`
			`# VALID_ARCHITECTURES = IA32 X64`
			`#`

			`[Sources]`
			`MmUnblockMemoryLibNull.c`

			`[Packages]`
			`MdePkg/MdePkg.dec`