SourceLevelDebugPkg: 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: Gao, Liming <liming.gao@intel.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>

git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15937 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
Gao, Liming 2014-08-28 05:13:05 +00:00 committed by lgao4
parent 3387dccb34
commit 4e363936ec
8 changed files with 57 additions and 37 deletions
SourceLevelDebugPkg

View File

@ -3,7 +3,7 @@
# #
# This DXE driver will invoke Debug Agent Library to initialize the debug agent. # This DXE driver will invoke Debug Agent Library to initialize the debug agent.
# #
# Copyright (c) 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # 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 # which accompanies this distribution. The full text of the license may be found at
@ -17,6 +17,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = DebugAgentDxe BASE_NAME = DebugAgentDxe
MODULE_UNI_FILE = DebugAgentDxe.uni
FILE_GUID = 9727502C-034E-472b-8E1B-67BB28C6CFDB FILE_GUID = 9727502C-034E-472b-8E1B-67BB28C6CFDB
MODULE_TYPE = DXE_DRIVER MODULE_TYPE = DXE_DRIVER
VERSION_STRING = 1.0 VERSION_STRING = 1.0
@ -46,3 +47,6 @@
[Depex] [Depex]
TRUE TRUE
[UserExtensions.TianoCore."ExtraFiles"]
DebugAgentDxeExtra.uni

View File

@ -4,7 +4,7 @@
# This PEIM will invoke Debug Agent Library to initialize the debug agent in # This PEIM will invoke Debug Agent Library to initialize the debug agent in
# whole PEI phase. # whole PEI phase.
# #
# Copyright (c) 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # 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 # which accompanies this distribution. The full text of the license may be found at
@ -18,6 +18,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = DebugAgentPei BASE_NAME = DebugAgentPei
MODULE_UNI_FILE = DebugAgentPei.uni
FILE_GUID = D9D114EF-F40B-4d48-AAA0-A3DC99C9F5BD FILE_GUID = D9D114EF-F40B-4d48-AAA0-A3DC99C9F5BD
MODULE_TYPE = PEIM MODULE_TYPE = PEIM
VERSION_STRING = 1.0 VERSION_STRING = 1.0
@ -42,3 +43,6 @@
[Depex] [Depex]
TRUE TRUE
[UserExtensions.TianoCore."ExtraFiles"]
DebugAgentPeiExtra.uni

View File

@ -1,7 +1,7 @@
## @file ## @file
# Debug Agent library instance for Dxe Core and Dxe modules. # Debug Agent library instance for Dxe Core and Dxe modules.
# #
# Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
# #
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
@ -16,6 +16,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = DxeDebugAgentLib BASE_NAME = DxeDebugAgentLib
MODULE_UNI_FILE = DxeDebugAgentLib.uni
FILE_GUID = BA6BAD25-B814-4747-B0B0-0FBB61D40B90 FILE_GUID = BA6BAD25-B814-4747-B0B0-0FBB61D40B90
MODULE_TYPE = DXE_DRIVER MODULE_TYPE = DXE_DRIVER
VERSION_STRING = 0.7 VERSION_STRING = 0.7
@ -80,19 +81,22 @@
MemoryAllocationLib MemoryAllocationLib
[Guids] [Guids]
gEfiDebugAgentGuid ## PRODUCES ## Configuration Table ## SOMETIMES_PRODUCES ## SystemTable
gEfiDebugAgentGuid ## CONSUMES ## HOB ## CONSUMES ## HOB
gEfiVectorHandoffTableGuid ## SOMETIMES_PRODUCES ## Configuration Table gEfiDebugAgentGuid
## SOMETIMES_CONSUMES ## SystemTable
## SOMETIMES_PRODUCES ## SystemTable
gEfiVectorHandoffTableGuid
[Ppis] [Ppis]
gEfiVectorHandoffInfoPpiGuid ## UNDEFINED gEfiVectorHandoffInfoPpiGuid ## UNDEFINED
[Protocols] [Protocols]
gEfiSerialIoProtocolGuid ## PRODUCES gEfiSerialIoProtocolGuid ## SOMETIMES_PRODUCES
gEfiDevicePathProtocolGuid ## PRODUCES gEfiDevicePathProtocolGuid ## SOMETIMES_PRODUCES
[Pcd] [Pcd]
gEfiMdePkgTokenSpaceGuid.PcdFSBClock ## CONSUMES gEfiMdePkgTokenSpaceGuid.PcdFSBClock ## SOMETIMES_CONSUMES
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger ## CONSUMES gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger ## SOMETIMES_CONSUMES
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize ## CONSUMES gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize ## CONSUMES

View File

@ -1,7 +1,7 @@
## @file ## @file
# Debug Agent library instance for SEC Core and PEI modules. # Debug Agent library instance for SEC Core and PEI modules.
# #
# Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
# #
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
@ -16,6 +16,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = SecPeiDebugAgentLib BASE_NAME = SecPeiDebugAgentLib
MODULE_UNI_FILE = SecPeiDebugAgentLib.uni
FILE_GUID = 508B7D59-CD4E-4a6b-A45B-6D3B2D90111E FILE_GUID = 508B7D59-CD4E-4a6b-A45B-6D3B2D90111E
MODULE_TYPE = PEIM MODULE_TYPE = PEIM
VERSION_STRING = 0.7 VERSION_STRING = 0.7
@ -76,14 +77,16 @@
PeCoffExtraActionLib PeCoffExtraActionLib
[Ppis] [Ppis]
gEfiPeiMemoryDiscoveredPpiGuid gEfiPeiMemoryDiscoveredPpiGuid ## NOTIFY
gEfiVectorHandoffInfoPpiGuid ## PRODUCES gEfiVectorHandoffInfoPpiGuid ## PRODUCES
[Guids] [Guids]
gEfiDebugAgentGuid ## PRODUCES ## HOB ## PRODUCES ## HOB
## CONSUMES ## HOB
gEfiDebugAgentGuid
[Pcd] [Pcd]
gEfiMdePkgTokenSpaceGuid.PcdFSBClock ## CONSUMES gEfiMdePkgTokenSpaceGuid.PcdFSBClock ## SOMETIMES_CONSUMES
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger ## CONSUMES gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger ## SOMETIMES_CONSUMES
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize ## CONSUMES gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize ## SOMETIMES_CONSUMES

View File

@ -1,7 +1,7 @@
## @file ## @file
# Debug Agent library instance for SMM modules. # Debug Agent library instance for SMM modules.
# #
# Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
# #
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
@ -16,6 +16,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = SmmDebugAgentLib BASE_NAME = SmmDebugAgentLib
MODULE_UNI_FILE = SmmDebugAgentLib.uni
FILE_GUID = CB07D74C-598F-4268-A5D1-644FB4A481E8 FILE_GUID = CB07D74C-598F-4268-A5D1-644FB4A481E8
MODULE_TYPE = DXE_SMM_DRIVER MODULE_TYPE = DXE_SMM_DRIVER
VERSION_STRING = 0.7 VERSION_STRING = 0.7
@ -74,11 +75,13 @@
SmmServicesTableLib SmmServicesTableLib
[Guids] [Guids]
gEfiDebugAgentGuid ## CONSUMES ## Configuration Table ## CONSUMES ## SystemTable
gEfiVectorHandoffTableGuid ## SOMETIMES_PRODUCES ## Configuration Table ## CONSUMES ## HOB
gEfiDebugAgentGuid
gEfiVectorHandoffTableGuid ## PRODUCES # SMM Configuration Table
[Pcd] [Pcd]
gEfiMdePkgTokenSpaceGuid.PcdFSBClock ## CONSUMES gEfiMdePkgTokenSpaceGuid.PcdFSBClock ## SOMETIMES_CONSUMES
## Skip Page Fault exception (14) by default in SMM ## Skip Page Fault exception (14) by default in SMM
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger|0x00004000 ## CONSUMES gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger|0x00004000 ## SOMETIMES_CONSUMES

View File

@ -1,7 +1,7 @@
## @file ## @file
# Debug Communication Library instance based on serila port. # Debug Communication Library instance based on serila port.
# #
# Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
# #
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
@ -16,6 +16,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = DebugCommunicationLibSerialPort BASE_NAME = DebugCommunicationLibSerialPort
MODULE_UNI_FILE = DebugCommunicationLibSerialPort.uni
FILE_GUID = 8CC435C5-6330-4269-B0C3-E3BD05C86FB8 FILE_GUID = 8CC435C5-6330-4269-B0C3-E3BD05C86FB8
MODULE_TYPE = BASE MODULE_TYPE = BASE
VERSION_STRING = 0.7 VERSION_STRING = 0.7
@ -40,6 +41,7 @@
BaseLib BaseLib
[PCD] [PCD]
## The value of data buffer size used for Serial debug port handle. # The value of data buffer size used for Serial debug port handle.
## It should be equal to sizeof (SERIAL_DEBUG_PORT_HANDLE). # It should be equal to sizeof (SERIAL_DEBUG_PORT_HANDLE).
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize|17 gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize|17 ## SOMETIMES_CONSUMES

View File

@ -1,7 +1,7 @@
## @file ## @file
# Debug Communication Library instance based on usb debug port. # Debug Communication Library instance based on usb debug port.
# #
# Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
# #
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
@ -16,6 +16,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = DebugCommunicationLibUsb BASE_NAME = DebugCommunicationLibUsb
MODULE_UNI_FILE = DebugCommunicationLibUsb.uni
FILE_GUID = 87438836-AD8D-4e3e-9249-895120A67240 FILE_GUID = 87438836-AD8D-4e3e-9249-895120A67240
MODULE_TYPE = BASE MODULE_TYPE = BASE
VERSION_STRING = 0.7 VERSION_STRING = 0.7
@ -35,18 +36,16 @@
[Pcd] [Pcd]
## The memory BAR of usb debug port, it may be different with the memory bar of ehci host controller. ## The memory BAR of usb debug port, it may be different with the memory bar of ehci host controller.
## Note that the memory BAR address is only used before Pci bus resource allocation. ## Note that the memory BAR address is only used before Pci bus resource allocation.
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbDebugPortMemorySpaceBase gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbDebugPortMemorySpaceBase ## SOMETIMES_CONSUMES
## The memory BAR of ehci host controller, in which usb debug feature is enabled. ## The memory BAR of ehci host controller, in which usb debug feature is enabled.
## Note that the memory BAR address is only used before Pci bus resource allocation. ## Note that the memory BAR address is only used before Pci bus resource allocation.
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciMemorySpaceBase gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciMemorySpaceBase ## SOMETIMES_CONSUMES
## The pci address of ehci host controller, in which usb debug feature is enabled. ## The pci address of ehci host controller, in which usb debug feature is enabled.
## The format of pci address please refer to SourceLevelDebugPkg.dec ## The format of pci address please refer to SourceLevelDebugPkg.dec
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciPciAddress gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciPciAddress ## CONSUMES
## The value of data buffer size used for USB debug port handle. ## The value of data buffer size used for USB debug port handle.
## It should be equal to sizeof (USB_DEBUG_PORT_HANDLE). ## It should be equal to sizeof (USB_DEBUG_PORT_HANDLE).
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize|40 gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize|40 ## SOMETIMES_CONSUMES
[LibraryClasses] [LibraryClasses]
TimerLib TimerLib

View File

@ -1,7 +1,7 @@
## @file ## @file
# PeCoffExtraAction Library to support source level debug. # PeCoffExtraAction Library to support source level debug.
# #
# Copyright (c) 2010 - 2013, Intel Corporation. All rights reserved.<BR> # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>
# #
# This program and the accompanying materials # This program and the accompanying materials
# are licensed and made available under the terms and conditions of the BSD License # are licensed and made available under the terms and conditions of the BSD License
@ -16,6 +16,7 @@
[Defines] [Defines]
INF_VERSION = 0x00010005 INF_VERSION = 0x00010005
BASE_NAME = PeCoffExtraActionLib BASE_NAME = PeCoffExtraActionLib
MODULE_UNI_FILE = PeCoffExtraActionLib.uni
FILE_GUID = 8F01CBD5-E069-44d7-90C9-35F0318603AD FILE_GUID = 8F01CBD5-E069-44d7-90C9-35F0318603AD
MODULE_TYPE = BASE MODULE_TYPE = BASE
VERSION_STRING = 0.7 VERSION_STRING = 0.7
@ -52,5 +53,5 @@
PcdLib PcdLib
[Pcd] [Pcd]
gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugLoadImageMethod gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugLoadImageMethod ## CONSUMES