2010-12-10 10:27:54 +01:00
|
|
|
## @file
|
2015-07-01 05:08:29 +02:00
|
|
|
# Runtime DXE part corresponding to SMM authenticated variable module.
|
2010-12-10 10:27:54 +01:00
|
|
|
#
|
2015-07-01 05:08:29 +02:00
|
|
|
# This module installs variable arch protocol and variable write arch protocol to provide
|
|
|
|
|
# variable service. This module need work together with SMM authenticated variable module.
|
2014-08-28 08:34:06 +02:00
|
|
|
#
|
2014-11-19 02:08:23 +01:00
|
|
|
# Caution: This module requires additional review when modified.
|
|
|
|
|
# This driver will have external input - variable data.
|
|
|
|
|
# This external input must be validated carefully to avoid security issues such as
|
|
|
|
|
# buffer overflow or integer overflow.
|
2015-07-01 05:08:29 +02:00
|
|
|
# The whole SMM authentication variable design relies on the integrity of flash part and SMM.
|
|
|
|
|
# which is assumed to be protected by platform. All variable code and metadata in flash/SMM Memory
|
|
|
|
|
# may not be modified without authorization. If platform fails to protect these resources,
|
|
|
|
|
# the authentication service provided in this driver will be broken, and the behavior is undefined.
|
2014-11-19 02:08:23 +01:00
|
|
|
#
|
2017-01-18 04:32:47 +01:00
|
|
|
# Copyright (c) 2010 - 2017, Intel Corporation. All rights reserved.<BR>
|
2015-07-01 05:08:29 +02:00
|
|
|
# This program and the accompanying materials
|
|
|
|
|
# are licensed and made available under the terms and conditions of the BSD License
|
|
|
|
|
# which accompanies this distribution. The full text of the license may be found at
|
|
|
|
|
# http://opensource.org/licenses/bsd-license.php
|
|
|
|
|
# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
|
|
|
# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
2010-12-10 10:27:54 +01:00
|
|
|
#
|
|
|
|
|
##
|
|
|
|
|
|
|
|
|
|
[Defines]
|
|
|
|
|
INF_VERSION = 0x00010005
|
|
|
|
|
BASE_NAME = VariableSmmRuntimeDxe
|
2014-08-28 08:34:06 +02:00
|
|
|
MODULE_UNI_FILE = VariableSmmRuntimeDxe.uni
|
2010-12-10 10:27:54 +01:00
|
|
|
FILE_GUID = 9F7DCADE-11EA-448a-A46F-76E003657DD1
|
|
|
|
|
MODULE_TYPE = DXE_RUNTIME_DRIVER
|
|
|
|
|
VERSION_STRING = 1.0
|
|
|
|
|
ENTRY_POINT = VariableSmmRuntimeInitialize
|
|
|
|
|
|
|
|
|
|
#
|
|
|
|
|
# The following information is for reference only and not required by the build tools.
|
|
|
|
|
#
|
|
|
|
|
# VALID_ARCHITECTURES = IA32 X64
|
|
|
|
|
#
|
|
|
|
|
# VIRTUAL_ADDRESS_MAP_CALLBACK = VariableAddressChangeEvent
|
|
|
|
|
#
|
|
|
|
|
|
|
|
|
|
[Sources]
|
|
|
|
|
VariableSmmRuntimeDxe.c
|
MdeModulePkg/Variable/RuntimeDxe: move SecureBootHook() decl to new header
If the platform supports SMM, a gRT->SetVariable() call at boot time
results in the following call tree to SecureBootHook():
RuntimeServiceSetVariable() [VariableSmmRuntimeDxe.c, unprivileged]
SmmVariableHandler() [VariableSmm.c, PRIVILEGED]
VariableServiceSetVariable() [Variable.c, PRIVILEGED]
SecureBootHook() [VariableSmm.c, PRIVILEGED]
//
// do nothing
//
SecureBootHook() [Measurement.c, unprivileged]
//
// measure variable if it
// is related to SB policy
//
And if the platform does not support SMM:
VariableServiceSetVariable() [Variable.c, unprivileged]
SecureBootHook() [Measurement.c, unprivileged]
//
// measure variable if it
// is related to SB policy
//
In other words, the measurement always happens outside of SMM.
Because there are two implementations of the SecureBootHook() API, one
that is called from SMM and does nothing, and another that is called
outside of SMM and measures variables, the function declaration should be
in a header file. This way the compiler can enforce that the function
declaration and all function definitions match.
"Variable.h" is used for "including common header files, defining internal
structures and functions used by Variable modules". Technically, we could
declare SecureBootHook() in "Variable.h". However, "Measurement.c" and
"VariableSmmRuntimeDxe.c" themselves do not include "Variable.h", and that
is likely intentional -- "Variable.h" exposes so much of the privileged
variable implementation that it is likely excluded from these C source
files on purpose.
Therefore introduce a new header file called "PrivilegePolymorphic.h".
"Variable.h" includes this header (so that all C source files that have
been allowed to see the variable internals learn about the new
SecureBootHook() declaration immediately). In "Measurement.c" and
"VariableSmmRuntimeDxe.c", include *only* the new header.
This change cleans up commit fa0737a839d0 ("MdeModulePkg Variable: Merge
from Auth Variable driver in SecurityPkg", 2015-07-01).
Cc: Eric Dong <eric.dong@intel.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Ladi Prosek <lprosek@redhat.com>
Cc: Star Zeng <star.zeng@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Jiewen Yao <jiewen.yao@intel.com>
Tested-by: Ladi Prosek <lprosek@redhat.com>
2017-09-30 13:40:32 +02:00
|
|
|
PrivilegePolymorphic.h
|
2015-07-01 05:08:29 +02:00
|
|
|
Measurement.c
|
2010-12-10 10:27:54 +01:00
|
|
|
|
|
|
|
|
[Packages]
|
|
|
|
|
MdePkg/MdePkg.dec
|
|
|
|
|
MdeModulePkg/MdeModulePkg.dec
|
|
|
|
|
|
|
|
|
|
[LibraryClasses]
|
|
|
|
|
MemoryAllocationLib
|
2015-07-01 05:08:29 +02:00
|
|
|
BaseLib
|
2010-12-10 10:27:54 +01:00
|
|
|
UefiBootServicesTableLib
|
|
|
|
|
DebugLib
|
|
|
|
|
UefiRuntimeLib
|
|
|
|
|
DxeServicesTableLib
|
|
|
|
|
UefiDriverEntryPoint
|
2015-07-01 05:08:29 +02:00
|
|
|
TpmMeasurementLib
|
2010-12-10 10:27:54 +01:00
|
|
|
|
|
|
|
|
[Protocols]
|
2014-08-28 08:34:06 +02:00
|
|
|
gEfiVariableWriteArchProtocolGuid ## PRODUCES
|
|
|
|
|
gEfiVariableArchProtocolGuid ## PRODUCES
|
|
|
|
|
gEfiSmmCommunicationProtocolGuid ## CONSUMES
|
|
|
|
|
## CONSUMES
|
|
|
|
|
## NOTIFY
|
|
|
|
|
## UNDEFINED # Used to do smm communication
|
2010-12-10 10:27:54 +01:00
|
|
|
gEfiSmmVariableProtocolGuid
|
2014-08-28 08:34:06 +02:00
|
|
|
gEdkiiVariableLockProtocolGuid ## PRODUCES
|
2015-01-05 04:38:36 +01:00
|
|
|
gEdkiiVarCheckProtocolGuid ## PRODUCES
|
2010-12-10 10:27:54 +01:00
|
|
|
|
|
|
|
|
[Guids]
|
2014-08-28 08:34:06 +02:00
|
|
|
gEfiEventVirtualAddressChangeGuid ## CONSUMES ## Event
|
|
|
|
|
gEfiEventExitBootServicesGuid ## CONSUMES ## Event
|
|
|
|
|
## CONSUMES ## GUID # Locate protocol
|
|
|
|
|
## CONSUMES ## GUID # Protocol notify
|
2011-02-28 08:31:45 +01:00
|
|
|
gSmmVariableWriteGuid
|
2010-12-10 10:27:54 +01:00
|
|
|
|
2015-07-01 05:08:29 +02:00
|
|
|
## SOMETIMES_CONSUMES ## Variable:L"PK"
|
|
|
|
|
## SOMETIMES_CONSUMES ## Variable:L"KEK"
|
|
|
|
|
## SOMETIMES_CONSUMES ## Variable:L"SecureBoot"
|
|
|
|
|
gEfiGlobalVariableGuid
|
|
|
|
|
|
2017-01-18 04:32:47 +01:00
|
|
|
## SOMETIMES_CONSUMES ## Variable:L"db"
|
|
|
|
|
## SOMETIMES_CONSUMES ## Variable:L"dbx"
|
|
|
|
|
## SOMETIMES_CONSUMES ## Variable:L"dbt"
|
2015-07-01 05:08:29 +02:00
|
|
|
gEfiImageSecurityDatabaseGuid
|
|
|
|
|
|
2010-12-10 10:27:54 +01:00
|
|
|
[Depex]
|
|
|
|
|
gEfiSmmCommunicationProtocolGuid
|
2014-08-28 08:34:06 +02:00
|
|
|
|
|
|
|
|
[UserExtensions.TianoCore."ExtraFiles"]
|
|
|
|
|
VariableSmmRuntimeDxeExtra.uni
|
