SecurityPkg: INF/DEC file updates to EDK II packages

1. Usage information in INF file comment blocks are either incomplete or incorrect.  
This includes usage information for Protocols/PPIs/GUIDs/PCDs/HOBs/Events/BootModes.  
The syntax for usage information in comment blocks is defined in the EDK II Module Information (INF) Specification

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dong, Guo <guo.dong@intel.com>
Reviewed-by: Gao, Liming <liming.gao@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15950 6f19259b-4bc3-4df7-8a09-765794883524

1 files changed, 72 insertions, 37 deletions

diff --git a/SecurityPkg/VariableAuthenticated/RuntimeDxe/VariableRuntimeDxe.inf b/SecurityPkg/VariableAuthenticated/RuntimeDxe/VariableRuntimeDxe.inf
index 41e85c0156..593c906085 100644
--- a/SecurityPkg/VariableAuthenticated/RuntimeDxe/VariableRuntimeDxe.inf
+++ b/SecurityPkg/VariableAuthenticated/RuntimeDxe/VariableRuntimeDxe.inf
@@ -1,10 +1,13 @@
 ## @file

-#  Component description file for Authenticated Variable module.

+#  Provides authenticated variable service

+#

+#  This module installs variable arch protocol and variable write arch protocol to provide 

+#  variable services: SetVariable, GetVariable, GetNextVariableName and QueryVariableInfo.

 #

 #  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 issue like

-#  buffer overflow, integer overflow.

+#  This external input must be validated carefully to avoid security issues such as 

+#  buffer overflow or integer overflow.

 #

 # Copyright (c) 2009 - 2014, Intel Corporation. All rights reserved.<BR>

 # This program and the accompanying materials

@@ -19,6 +22,7 @@
 [Defines]

   INF_VERSION                    = 0x00010005

   BASE_NAME                      = VariableAuthRuntimeDxe

+  MODULE_UNI_FILE                = VariableAuthRuntimeDxe.uni

   FILE_GUID                      = 2226F30F-3D5B-402d-9936-A97184EB4516

   MODULE_TYPE                    = DXE_RUNTIME_DRIVER

   VERSION_STRING                 = 1.0

@@ -65,51 +69,82 @@
   TpmMeasurementLib

 

 [Protocols]

-  gEfiFirmwareVolumeBlockProtocolGuid           ## SOMETIMES_CONSUMES

-  gEfiVariableWriteArchProtocolGuid             ## ALWAYS_PRODUCES

-  gEfiVariableArchProtocolGuid                  ## ALWAYS_PRODUCES

-  gEfiFaultTolerantWriteProtocolGuid            ## SOMETIMES_CONSUMES

-  gEdkiiVariableLockProtocolGuid                ## ALWAYS_PRODUCES

+  gEfiFirmwareVolumeBlockProtocolGuid           ## CONSUMES

+  ## CONSUMES

+  ## NOTIFY

+  gEfiFaultTolerantWriteProtocolGuid

+  gEfiVariableWriteArchProtocolGuid             ## PRODUCES

+  gEfiVariableArchProtocolGuid                  ## PRODUCES

+  gEdkiiVariableLockProtocolGuid                ## PRODUCES

+

 

 [Guids]

-  gEfiAuthenticatedVariableGuid                 ## PRODUCES ## Configuration Table Guid

-  gEfiGlobalVariableGuid                        ## PRODUCES ## Variable Guid

-  gEfiEventVirtualAddressChangeGuid             ## CONSUMES ## Event

-  gEfiCertTypeRsa2048Sha256Guid

+  ## PRODUCES             ## GUID # Variable store header

+  ## CONSUMES             ## GUID # Variable store header

+  ## SOMETIMES_CONSUMES   ## HOB

+  ## SOMETIMES_PRODUCES   ## SystemTable

+  gEfiAuthenticatedVariableGuid

+  

+  ## SOMETIMES_CONSUMES   ## Variable:L"PlatformLang"

+  ## SOMETIMES_PRODUCES   ## Variable:L"PlatformLang"

+  ## SOMETIMES_CONSUMES   ## Variable:L"Lang"

+  ## SOMETIMES_PRODUCES   ## Variable:L"Lang"

+  ## SOMETIMES_CONSUMES   ## Variable:L"HwErrRecSupport"

+  ## CONSUMES             ## Variable:L"SetupMode"

+  ## PRODUCES             ## Variable:L"SetupMode"

+  ## SOMETIMES_CONSUMES   ## Variable:L"PK"

+  ## SOMETIMES_CONSUMES   ## Variable:L"KEK"

+  ## CONSUMES             ## Variable:L"SecureBoot"

+  ## PRODUCES             ## Variable:L"SecureBoot"

+  ## CONSUMES             ## Variable:L"SignatureSupport"

+  ## PRODUCES             ## Variable:L"SignatureSupport"  

+  ## PRODUCES             ## Variable:L"VendorKeys"

+  gEfiGlobalVariableGuid

+  

+  ## SOMETIMES_CONSUMES   ## Variable:L"DB"

+  ## SOMETIMES_CONSUMES   ## Variable:L"DBX"

   gEfiImageSecurityDatabaseGuid

-  gEfiCertX509Guid

-  gEfiCertPkcs7Guid

-  gEfiCertRsa2048Guid

+  

+  ## CONSUMES             ## Variable:L"SecureBootEnable"

+  ## PRODUCES             ## Variable:L"SecureBootEnable"

   gEfiSecureBootEnableDisableGuid

+  

+  ## CONSUMES             ## Variable:L"CustomMode"

+  ## PRODUCES             ## Variable:L"CustomMode"

   gEfiCustomModeEnableGuid

-  gEfiVendorKeysNvGuid

-  gEfiSystemNvDataFvGuid                        ## CONSUMES

+  

+  ## CONSUMES             ## Variable:L"certdb"

+  ## PRODUCES             ## Variable:L"certdb"

   gEfiCertDbGuid

-  gEfiHardwareErrorVariableGuid                 ## SOMETIMES_CONSUMES

-  gEfiEndOfDxeEventGroupGuid                    ## CONSUMES ## Event

-  gEdkiiFaultTolerantWriteGuid                  ## CONSUMES

+  

+  ## CONSUMES             ## Variable:L"VendorKeysNv"

+  ## PRODUCES             ## Variable:L"VendorKeysNv"

+  gEfiVendorKeysNvGuid

+

+  gEfiEndOfDxeEventGroupGuid               ## CONSUMES               ## Event

+  gEfiEventVirtualAddressChangeGuid        ## CONSUMES               ## Event

+  gEfiCertTypeRsa2048Sha256Guid            ## SOMETIMES_CONSUMES     ## GUID     # Unique ID for the type of the certificate.

+  gEfiCertPkcs7Guid                        ## SOMETIMES_CONSUMES     ## GUID     # Unique ID for the type of the certificate.

+  gEfiCertX509Guid                         ## SOMETIMES_CONSUMES     ## GUID     # Unique ID for the type of the signature.

+  gEfiSystemNvDataFvGuid                   ## CONSUMES               ## GUID

+  gEfiHardwareErrorVariableGuid            ## SOMETIMES_CONSUMES     ## Variable:L"HwErrRec####"

+  gEdkiiFaultTolerantWriteGuid             ## SOMETIMES_CONSUMES     ## HOB

 

 [Pcd]

-  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize

-  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase

-  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase64

-  gEfiMdeModulePkgTokenSpaceGuid.PcdMaxVariableSize

-  gEfiMdeModulePkgTokenSpaceGuid.PcdMaxHardwareErrorVariableSize

-  gEfiMdeModulePkgTokenSpaceGuid.PcdVariableStoreSize

-  gEfiMdeModulePkgTokenSpaceGuid.PcdHwErrStorageSize

+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableSize       ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase       ## SOMETIMES_CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdFlashNvStorageVariableBase64     ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdMaxVariableSize                  ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdMaxHardwareErrorVariableSize     ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdVariableStoreSize                ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdHwErrStorageSize                 ## CONSUMES

 

 [FeaturePcd]

-  gEfiMdeModulePkgTokenSpaceGuid.PcdVariableCollectStatistics  ## CONSUMES # statistic the information of variable.

-  gEfiMdePkgTokenSpaceGuid.PcdUefiVariableDefaultLangDeprecate ## CONSUMES

+  gEfiMdeModulePkgTokenSpaceGuid.PcdVariableCollectStatistics        ## CONSUMES  # statistic the information of variable.

+  gEfiMdePkgTokenSpaceGuid.PcdUefiVariableDefaultLangDeprecate       ## CONSUMES  # Auto update PlatformLang/Lang

 

 [Depex]

   TRUE

 

-# [Event]

-#   ##

-#   # Event will be signaled for VIRTUAL_ADDRESS_CHANGE event.

-#   #

-#   EVENT_TYPE_NOTIFY_SIGNAL                    ## PRODUCES

-#

-#

-

+[UserExtensions.TianoCore."ExtraFiles"]

+  VariableRuntimeDxeExtra.uni