Commit Graph

12 Commits

Author SHA1 Message Date
Laszlo Ersek 424d84556d 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 07:29:17 +00:00
Lee Leahy 86e9f87ec8 Enable the build command override the .DSC file contents to enable debug output and specify which debug messages are displayed. An example:
build  -a IA32  -a X64  -t VS2008x86  -p AppPkg/AppPkg.dsc  -b DEBUG   -D DEBUG_ENABLE_OUTPUT=TRUE   -D DEBUG_PROPERTY_MASK=0x27   -D DEBUG_PRINT_ERROR_LEVEL=0xFCF00040

Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Lee Leahy <leroy.p.leahy@intel.com>
Reviewed-by: Daryl McDaniel <daryl.mcdaniel@intel.com>


git-svn-id: https://svn.code.sf.net/p/edk2/code/trunk/edk2@14859 6f19259b-4bc3-4df7-8a09-765794883524
2013-11-19 02:37:37 +00:00
darylm503 d78fab6b4e EADK (StdLib, AppPkg, StdLibPrivateInternalFiles): Python Beta Release.
Clean up and clearly differentiate required and optional items in configuration files.
Enable the system command and synchronize configuration options between all CPU architectures.
Replace the UEFI_ENV macro with UEFI_C_SOURCE to align with Linux and Posix conventions.
Update copyrights and versions and make minor cosmetic enhancements to files.
Fix compiler-specific build errors.
Add Python-specific ReadMe file.

Signed-off-by: darylm503
Reviewed-by: geekboy15a
Reviewed-by: jljusten
Reviewed-by: leegrosenbaum


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@13119 6f19259b-4bc3-4df7-8a09-765794883524
2012-03-24 01:19:06 +00:00
darylm503 b410d6e4ce AppPkg/Applications/Python: Get Python startup process fully working for EDK II.
AppPkg.dsc: Clean up and add Socket support.
Applications/Python/PythonCore.inf: Re-order source files.
Applications/Python/Efi/config.c: Add all mandatory modules.  Disable remaining.
Applications/Python/Efi/edk2module.c: EDK II port of posixmodule.c.
Applications/Python/Efi/getpath.c: Determine initial module search path.
Applications/Python/Ia32/pyconfig.h: Configuration macros for Ia32.
Applications/Python/Ipf/pyconfig.h: Configuration macros for Ipf.
Applications/Python/PyMod-2.7.2/Include/osdefs.h: Select appropriate directory and path separators for UEFI.
Applications/Python/PyMod-2.7.2/Lib/ntpath.py: Allow multi-character device names to left of colon.
Applications/Python/PyMod-2.7.2/Lib/os.py: Add edk2 as a supported OS.
Applications/Python/PyMod-2.7.2/Lib/site.py: UEFI-specific path and environment setup.
Applications/Python/PyMod-2.7.2/Modules/errnomodule.c: Sync with errno.h.
Applications/Python/PyMod-2.7.2/Modules/selectmodule.c: Add UEFI support.
Applications/Python/PyMod-2.7.2/Modules/socketmodule.h: Add UEFI support.
Applications/Python/PyMod-2.7.2/Modules/zlib/zutil.h: Add UEFI support.
Applications/Python/PyMod-2.7.2/Python/getcopyright.c: Add Intel copyright.
Applications/Python/X64/pyconfig.h: Configuration macros for X64.

Signed-off-by: darylm503
Reviewed-by: geekboy15a
Reviewed-by: jljusten
Reviewed-by: lpleahy
Reviewed-by: leegrosenbaum


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12957 6f19259b-4bc3-4df7-8a09-765794883524
2012-01-26 22:04:41 +00:00
darylm503 63f3161896 Add documentation on how to build for execution within an emulation environment.
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12182 6f19259b-4bc3-4df7-8a09-765794883524
2011-08-22 19:30:51 +00:00
darylm503 8072b5973b Disable building socket applications.
These applications are not yet ready to build or use by default.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12114 6f19259b-4bc3-4df7-8a09-765794883524
2011-08-09 17:20:19 +00:00
darylm503 274402de46 Add plain-text ReadMe files and delete the PDF version.
Clean up some comments.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12080 6f19259b-4bc3-4df7-8a09-765794883524
2011-08-02 23:09:06 +00:00
darylm503 4684b66f26 Add Socket Library applications.
Modify AppPkg.dsc file to include StdLib.inc which contains the Boilerplate text for Standard Library based Applications.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12062 6f19259b-4bc3-4df7-8a09-765794883524
2011-07-30 00:32:15 +00:00
darylm503 af9c2a563c Give Python/PythonCore.inf its own GUID.
Do not build Python by default since it requires manual preparation before it can be built.
Update ReadMe.pdf to include information on configuring and building Python.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11930 6f19259b-4bc3-4df7-8a09-765794883524
2011-06-29 18:16:01 +00:00
darylm503 006fecd5a1 Basic Core Python interpreter.
This allows the Python 2.7.1 distribution to be extracted into the AppPkg/Applications/Python directory - producing the AppPkg/Applications/Python/Python-2.7.1 directory - then built for EDK II using the Standard C Libraries provided by the StdLib package.

Only rudimentary functionality has been tested.
Only compilation with Microsoft Visual Studio 2005 has been tested for Ia32 and X64 architectures.
The X64/pyconfig.h file should probably be updated to match the values in Ia32/pyconfig.h.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11910 6f19259b-4bc3-4df7-8a09-765794883524
2011-06-28 03:28:27 +00:00
darylm503 65126b4ebe Changes required to build using the new device abstraction capability of StdLib.
Applications which require file-system functionality must have DevShell listed in the [LibraryClasses] section of the application's INF file.
Entries for the device abstraction Library Classes must be added to the application's package's DSC file.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11909 6f19259b-4bc3-4df7-8a09-765794883524
2011-06-28 02:38:33 +00:00
darylm503 2aa62f2bc9 Standard Libraries for EDK II.
This set of three packages: AppPkg, StdLib, StdLibPrivateInternalFiles; contains the implementation of libraries based upon non-UEFI standards such as ISO/IEC-9899, the library portion of the C Language Standard, POSIX, etc.

AppPkg contains applications that make use of the standard libraries defined in the StdLib Package.

StdLib contains header (include) files and the implementations of the standard libraries.

StdLibPrivateInternalFiles contains files for the exclusive use of the library implementations in StdLib.  These files should never be directly referenced from applications or other code.


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@11600 6f19259b-4bc3-4df7-8a09-765794883524
2011-04-27 21:42:16 +00:00