2011-04-27 23:42:16 +02:00
|
|
|
## @file
|
|
|
|
|
# Intel(r) UEFI Application Development Kit for EDK II.
|
|
|
|
|
# This package contains applications which depend upon Standard Libraries
|
|
|
|
|
# from the StdLib package.
|
|
|
|
|
#
|
|
|
|
|
# See the comments in the [LibraryClasses.IA32] and [BuildOptions] sections
|
|
|
|
|
# for important information about configuring this package for your
|
|
|
|
|
# environment.
|
|
|
|
|
#
|
2012-03-24 02:19:06 +01:00
|
|
|
# Copyright (c) 2010 - 2012, Intel Corporation. All rights reserved.<BR>
|
2011-04-27 23:42:16 +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.
|
|
|
|
|
#
|
|
|
|
|
# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
|
|
|
|
|
# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
|
|
|
|
|
##
|
|
|
|
|
|
|
|
|
|
[Defines]
|
|
|
|
|
PLATFORM_NAME = AppPkg
|
|
|
|
|
PLATFORM_GUID = 0458dade-8b6e-4e45-b773-1b27cbda3e06
|
|
|
|
|
PLATFORM_VERSION = 0.01
|
|
|
|
|
DSC_SPECIFICATION = 0x00010006
|
|
|
|
|
OUTPUT_DIRECTORY = Build/AppPkg
|
|
|
|
|
SUPPORTED_ARCHITECTURES = IA32|IPF|X64
|
|
|
|
|
BUILD_TARGETS = DEBUG|RELEASE
|
|
|
|
|
SKUID_IDENTIFIER = DEFAULT
|
|
|
|
|
|
2013-11-19 03:37:37 +01:00
|
|
|
#
|
|
|
|
|
# Debug output control
|
|
|
|
|
#
|
|
|
|
|
DEFINE DEBUG_ENABLE_OUTPUT = FALSE # Set to TRUE to enable debug output
|
|
|
|
|
DEFINE DEBUG_PRINT_ERROR_LEVEL = 0x80000040 # Flags to control amount of debug output
|
|
|
|
|
DEFINE DEBUG_PROPERTY_MASK = 0
|
|
|
|
|
|
2011-04-27 23:42:16 +02:00
|
|
|
[PcdsFeatureFlag]
|
|
|
|
|
|
|
|
|
|
[PcdsFixedAtBuild]
|
2013-11-19 03:37:37 +01:00
|
|
|
gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|$(DEBUG_PROPERTY_MASK)
|
|
|
|
|
gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|$(DEBUG_PRINT_ERROR_LEVEL)
|
2011-04-27 23:42:16 +02:00
|
|
|
|
|
|
|
|
[PcdsFixedAtBuild.IPF]
|
|
|
|
|
|
|
|
|
|
[LibraryClasses]
|
|
|
|
|
#
|
|
|
|
|
# Entry Point Libraries
|
|
|
|
|
#
|
|
|
|
|
UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf
|
|
|
|
|
ShellCEntryLib|ShellPkg/Library/UefiShellCEntryLib/UefiShellCEntryLib.inf
|
2011-07-30 02:32:15 +02:00
|
|
|
UefiDriverEntryPoint|MdePkg/Library/UefiDriverEntryPoint/UefiDriverEntryPoint.inf
|
2011-04-27 23:42:16 +02:00
|
|
|
#
|
|
|
|
|
# Common Libraries
|
|
|
|
|
#
|
|
|
|
|
BaseLib|MdePkg/Library/BaseLib/BaseLib.inf
|
|
|
|
|
BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf
|
|
|
|
|
UefiLib|MdePkg/Library/UefiLib/UefiLib.inf
|
|
|
|
|
PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf
|
|
|
|
|
PcdLib|MdePkg/Library/BasePcdLibNull/BasePcdLibNull.inf
|
|
|
|
|
MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf
|
|
|
|
|
UefiBootServicesTableLib|MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf
|
|
|
|
|
UefiRuntimeServicesTableLib|MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.inf
|
2013-11-19 03:37:37 +01:00
|
|
|
!if $(DEBUG_ENABLE_OUTPUT)
|
|
|
|
|
DebugLib|MdePkg/Library/UefiDebugLibConOut/UefiDebugLibConOut.inf
|
|
|
|
|
DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
|
|
|
|
|
!else ## DEBUG_ENABLE_OUTPUT
|
|
|
|
|
DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf
|
|
|
|
|
!endif ## DEBUG_ENABLE_OUTPUT
|
2012-03-24 02:19:06 +01:00
|
|
|
|
2011-04-27 23:42:16 +02:00
|
|
|
DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf
|
|
|
|
|
PeCoffGetEntryPointLib|MdePkg/Library/BasePeCoffGetEntryPointLib/BasePeCoffGetEntryPointLib.inf
|
|
|
|
|
IoLib|MdePkg/Library/BaseIoLibIntrinsic/BaseIoLibIntrinsic.inf
|
|
|
|
|
PciLib|MdePkg/Library/BasePciLibCf8/BasePciLibCf8.inf
|
|
|
|
|
PciCf8Lib|MdePkg/Library/BasePciCf8Lib/BasePciCf8Lib.inf
|
|
|
|
|
SynchronizationLib|MdePkg/Library/BaseSynchronizationLib/BaseSynchronizationLib.inf
|
|
|
|
|
UefiRuntimeLib|MdePkg/Library/UefiRuntimeLib/UefiRuntimeLib.inf
|
|
|
|
|
HiiLib|MdeModulePkg/Library/UefiHiiLib/UefiHiiLib.inf
|
|
|
|
|
UefiHiiServicesLib|MdeModulePkg/Library/UefiHiiServicesLib/UefiHiiServicesLib.inf
|
|
|
|
|
PerformanceLib|MdeModulePkg/Library/DxePerformanceLib/DxePerformanceLib.inf
|
|
|
|
|
HobLib|MdePkg/Library/DxeHobLib/DxeHobLib.inf
|
2011-07-30 02:32:15 +02:00
|
|
|
|
2011-04-27 23:42:16 +02:00
|
|
|
ShellLib|ShellPkg/Library/UefiShellLib/UefiShellLib.inf
|
|
|
|
|
FileHandleLib|ShellPkg/Library/UefiFileHandleLib/UefiFileHandleLib.inf
|
|
|
|
|
SortLib|ShellPkg/Library/UefiSortLib/UefiSortLib.inf
|
2011-07-30 02:32:15 +02:00
|
|
|
PathLib|ShellPkg/Library/BasePathLib/BasePathLib.inf
|
2011-04-27 23:42:16 +02:00
|
|
|
|
2012-01-26 23:04:41 +01:00
|
|
|
CacheMaintenanceLib|MdePkg/Library/BaseCacheMaintenanceLib/BaseCacheMaintenanceLib.inf
|
|
|
|
|
|
2011-04-27 23:42:16 +02:00
|
|
|
###################################################################################################
|
|
|
|
|
#
|
|
|
|
|
# Components Section - list of the modules and components that will be processed by compilation
|
|
|
|
|
# tools and the EDK II tools to generate PE32/PE32+/Coff image files.
|
|
|
|
|
#
|
|
|
|
|
# Note: The EDK II DSC file is not used to specify how compiled binary images get placed
|
|
|
|
|
# into firmware volume images. This section is just a list of modules to compile from
|
|
|
|
|
# source into UEFI-compliant binaries.
|
|
|
|
|
# It is the FDF file that contains information on combining binary files into firmware
|
|
|
|
|
# volume images, whose concept is beyond UEFI and is described in PI specification.
|
|
|
|
|
# Binary modules do not need to be listed in this section, as they should be
|
|
|
|
|
# specified in the FDF file. For example: Shell binary (Shell_Full.efi), FAT binary (Fat.efi),
|
|
|
|
|
# Logo (Logo.bmp), and etc.
|
|
|
|
|
# There may also be modules listed in this section that are not required in the FDF file,
|
|
|
|
|
# When a module listed here is excluded from FDF file, then UEFI-compliant binary will be
|
|
|
|
|
# generated for it, but the binary will not be put into any firmware volume.
|
|
|
|
|
#
|
|
|
|
|
###################################################################################################
|
|
|
|
|
|
|
|
|
|
[Components]
|
|
|
|
|
|
|
|
|
|
#### Sample Applications.
|
|
|
|
|
AppPkg/Applications/Hello/Hello.inf # No LibC includes or functions.
|
|
|
|
|
AppPkg/Applications/Main/Main.inf # Simple invocation. No other LibC functions.
|
2012-03-24 02:19:06 +01:00
|
|
|
AppPkg/Applications/Enquire/Enquire.inf #
|
2011-06-29 20:16:01 +02:00
|
|
|
|
AppPkg: introduce OrderedCollectionTest
In this patch a small application is added to AppPkg, with the following
two goals:
- demonstrate how to use OrderedCollectionLib,
- allow users to test and "fuzz" BaseOrderedCollectionRedBlackTreeLib in
particular, entering API "commands" interactively, or providing them
from a script file.
A shell script is included that generates such an API command script.
Speaking about BaseOrderedCollectionRedBlackTreeLib specifically,
OrderedCollectionTest validates the internal red-black properties of the
tree after each read-write operation by setting the
PcdValidateOrderedCollection feature flag to TRUE.
The OrderedCollectionTest application's debugging environment is strictly
specified in the DSC file, because OrderedCollectionTest is entirely
useless for unit testing without full ASSERT() enablement.
The OrderedCollectionTest application deliberately doesn't follow the edk2
coding style in the following:
- const vs. CONST,
- void vs. VOID,
- assert() vs. ASSERT(),
- calloc() and free() vs. AllocateZeroPool() and FreePool(),
- integer types.
This is because OrderedCollectionTest is a standard C application, not a
UEFI application per se. In particular it relies on stdio. INTN, EFIAPI
and CONST VOID are used only in two places, where we provide the
comparator callbacks to OrderedCollectionLib. Proper range checking is
ensured for integers.
The application takes command input from stdin or a file (if the user
requests it), sends command output to stdout or a file (if the user
requests it), prints debug output to the console (as other AppPkg
applications do when debugging is enabled for them), and prints
diagnostics to stderr (like well behaved standard C programs should).
Input/output selection is implemented manually because the old shell
doesn't support input redirection at all, and because the new shell's
input redirection does not co-operate with fgets() for the time being.
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
Reviewed-by: Michael Kinney <michael.d.kinney@intel.com>
git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@15792 6f19259b-4bc3-4df7-8a09-765794883524
2014-08-12 09:29:17 +02:00
|
|
|
#### A simple fuzzer for OrderedCollectionLib, in particular for
|
|
|
|
|
#### BaseOrderedCollectionRedBlackTreeLib.
|
|
|
|
|
AppPkg/Applications/OrderedCollectionTest/OrderedCollectionTest.inf {
|
|
|
|
|
<LibraryClasses>
|
|
|
|
|
OrderedCollectionLib|MdePkg/Library/BaseOrderedCollectionRedBlackTreeLib/BaseOrderedCollectionRedBlackTreeLib.inf
|
|
|
|
|
DebugLib|MdePkg/Library/UefiDebugLibConOut/UefiDebugLibConOut.inf
|
|
|
|
|
DebugPrintErrorLevelLib|MdePkg/Library/BaseDebugPrintErrorLevelLib/BaseDebugPrintErrorLevelLib.inf
|
|
|
|
|
<PcdsFeatureFlag>
|
|
|
|
|
gEfiMdePkgTokenSpaceGuid.PcdValidateOrderedCollection|TRUE
|
|
|
|
|
<PcdsFixedAtBuild>
|
|
|
|
|
gEfiMdePkgTokenSpaceGuid.PcdDebugPropertyMask|0x2F
|
|
|
|
|
gEfiMdePkgTokenSpaceGuid.PcdDebugPrintErrorLevel|0x80400040
|
|
|
|
|
}
|
|
|
|
|
|
2011-07-30 02:32:15 +02:00
|
|
|
#### After extracting the Python distribution, un-comment the following line to build Python.
|
2011-06-29 20:16:01 +02:00
|
|
|
# AppPkg/Applications/Python/PythonCore.inf
|
2011-04-27 23:42:16 +02:00
|
|
|
|
2011-07-30 02:32:15 +02:00
|
|
|
|
2011-08-03 01:09:06 +02:00
|
|
|
##############################################################################
|
2011-04-27 23:42:16 +02:00
|
|
|
#
|
2011-08-22 21:30:51 +02:00
|
|
|
# Specify whether we are running in an emulation environment, or not.
|
2012-01-26 23:04:41 +01:00
|
|
|
# Define EMULATE if we are, else keep the DEFINE commented out.
|
2011-08-22 21:30:51 +02:00
|
|
|
#
|
2012-01-26 23:04:41 +01:00
|
|
|
# DEFINE EMULATE = 1
|
2011-08-22 21:30:51 +02:00
|
|
|
|
2012-01-26 23:04:41 +01:00
|
|
|
##############################################################################
|
|
|
|
|
#
|
|
|
|
|
# Include Boilerplate text required for building with the Standard Libraries.
|
|
|
|
|
#
|
|
|
|
|
##############################################################################
|
2011-07-30 02:32:15 +02:00
|
|
|
!include StdLib/StdLib.inc
|
2012-01-26 23:04:41 +01:00
|
|
|
!include AppPkg/Applications/Sockets/Sockets.inc
|
