audk/UnixPkg
li-elvin 1abad90b73 Update UnixPkg to use IA32_SEGMENT_DESCRIPTOR defined in BaseLib.h
Signed-off-by: li-elvin
Reviewed-by: lgao4


git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12279 6f19259b-4bc3-4df7-8a09-765794883524
2011-09-05 09:52:23 +00:00
..
BootModePei Update the copyright notice format 2010-04-28 12:31:45 +00:00
CpuRuntimeDxe Adding Simple Pointer, GOP, SimpleTextInEx, and Networking protocols to the emulator. Cleaned up POSIX include situation by centralizing it in a single file, like NT32. Fixed TPL issue with TPL High not being emulated correctly, it was possible to take a timer tick when the locks in the DXE core should have prevented this. Remove some unused files to make things easier to maintain. 2010-11-30 23:38:40 +00:00
FvbServicesRuntimeDxe Update the copyright notice format 2010-04-28 12:31:45 +00:00
Include UnixPkg: Fix build for Linux 2011-03-05 08:08:47 +00:00
Library Update UnixPkg to use IA32_SEGMENT_DESCRIPTOR defined in BaseLib.h 2011-09-05 09:52:23 +00:00
MetronomeDxe Update the copyright notice format 2010-04-28 12:31:45 +00:00
MiscSubClassPlatformDxe UnixPkg MiscSubClassPlatformDxe: Add en-US langdef to *.uni 2010-10-13 23:02:02 +00:00
RealTimeClockRuntimeDxe Update the copyright notice format 2010-04-28 12:31:45 +00:00
ResetRuntimeDxe Update the copyright notice format 2010-04-28 12:31:45 +00:00
Sec Remove unnecessary global macros in SecMain.inf. 2011-08-29 04:58:13 +00:00
TimerDxe Fix issue with fixing tabs. 2011-02-02 23:19:30 +00:00
UnixAutoScanPei Update the copyright notice format 2010-04-28 12:31:45 +00:00
UnixBlockIoDxe Fix issue with fixing tabs. 2011-02-02 23:19:30 +00:00
UnixBusDriverDxe Fix issue with fixing tabs. 2011-02-02 23:19:30 +00:00
UnixConsoleDxe Update the copyright notice format 2010-04-28 12:31:45 +00:00
UnixFirmwareVolumePei Port UnixPkg to also support X64. Currently only supports Unix x86_64 ABI. In the future we can make Sec support x86_64 ABI and the rest of the code support X64 EFI ABI. This will require assembly gaskets to fix the calling convention differences. I currently have noop gaskets in place for x86_64 ABI. This has only been tested on OS X 10.6. 2010-07-22 21:21:38 +00:00
UnixFlashMapPei Fix bad NT 32 reference in print to be UnixPkg. 2010-10-12 22:04:07 +00:00
UnixGopDxe Fix up the UnixPkg to work with clang on OS X. XCLANG toolchain configuration has already been checked into BaseTools project. 2011-03-08 00:12:30 +00:00
UnixSerialIoDxe Fix issue with fixing tabs. 2011-02-02 23:19:30 +00:00
UnixSimpleFileSystemDxe Fix issue with fixing tabs. 2011-02-02 23:19:30 +00:00
UnixSnpDxe Clean up invalid keywords and missing keywords in [Define] section of INF/DEC files. 2011-06-28 02:24:46 +00:00
UnixThunkDxe Update the copyright notice format 2010-04-28 12:31:45 +00:00
UnixThunkPpiToProtocolPei Update the copyright notice format 2010-04-28 12:31:45 +00:00
UnixUgaDxe update copyright format 2010-12-10 15:20:43 +00:00
Xcode Adding Simple Pointer, GOP, SimpleTextInEx, and Networking protocols to the emulator. Cleaned up POSIX include situation by centralizing it in a single file, like NT32. Fixed TPL issue with TPL High not being emulated correctly, it was possible to take a timer tick when the locks in the DXE core should have prevented this. Remove some unused files to make things easier to maintain. 2010-11-30 23:38:40 +00:00
.gdbinit Added support for Xcode on Snow Leopard. Upaded with bug fixes for Snow Leopard. 2009-12-06 02:00:37 +00:00
UnixPkg.dec Clean up invalid keywords and missing keywords in [Define] section of INF/DEC files. 2011-06-28 02:24:46 +00:00
UnixPkg.dsc Fix the incorrect usage for PCD PcdResetOnMemoryTypeInformationChange in Duet, Unix and Emulator platform. 2011-08-29 13:36:03 +00:00
UnixPkg.fdf 1. solve build time issue that FV size is exceed due to more modules is included. 2011-03-31 09:18:14 +00:00
UnixPkgX64.dsc Correct package name 2011-09-02 13:32:52 +00:00
UnixPkgX64.fdf UnixPkg: Fix build for Linux 2011-03-05 08:08:47 +00:00
build.sh UnixPkg: Fix build for Linux 2011-03-05 08:08:47 +00:00
build64.sh Fix up the UnixPkg to work with clang on OS X. XCLANG toolchain configuration has already been checked into BaseTools project. 2011-03-08 00:12:30 +00:00
readme.txt Added support for Xcode on Snow Leopard. Upaded with bug fixes for Snow Leopard. 2009-12-06 02:00:37 +00:00

readme.txt

Unix Simulation Platform
========================

UnixPkg is one of platform package which can be built to a platform's firmware from UnixPkg.dsc file.
And this package provide a simulation platform under *INUX environment in IA32 architecture.

- Same points between real platform and simulation platform:
  1) Unix simulation platform also run with firmware device image built from UnixPkg
  2) The working flow of simulation platform also contains SEC/PEI/DXE phase.

- Different points between real platform and simulation platform:
  1) The SEC phase in simulation platform in fact is a *INUX native application which can be run from *INUX shell;
  2) The device in simulation platform is not real hardware but simulation component in API level;
  3) The ThunkBus driver in simulation platform will get virtual device's desription from PCD and create virtual Device

Build
=====
UnixPkg is built with following command:
  build -p UnixPkg/UnixPkg.dsc -a IA32 -t ELFGCC
  Notes: ELFGCC is defined in <Workspace>/Conf/tools_def.txt file. This tool chain use native gcc/binutil instead of 
         cross-compiler like UNIXGCC tool chain.

On Mac OS X you can cd into UnixPkg directory and execute ./build.sh to build. This does not require
setting up the environment like running the build command. Note Snow Leopard or later is required. 
This script should also work for any *INUX, but has not been tested. 

./build.sh run will lanuch the emulator in gdb so you can source level debug via gdb. 


Notes:
=====
On Mac OS X Snow Leopard you can use Xcode 3.2 as a GUI debugger. 
Launch Xcode and open UnixPkg/Xcode/xcode_project/xcode_project.xcodeproj
Under the build menu chose build and debug. shift-cmd-B shows the build results.

Under most *INUX the EFI executables are placed in the emulated EFI memory by the EFI PE/COFF loader
but dlopen() is used to also load the image into the process to support source level debug. 
The entry point for the image is moved from the EFI emulator memory into the dlopen() image. This
is not the case for Mac OS X. On Mac OS X a debugger script is used and the real EFI images in
the emulator are the ones being debugged. 

Also on Mac OS X the stack alignment requirements for IA-32 are 16 bytes and this is more strict
than the EFI ABI. To work around this gasket code was introduced to ensure the stack is always
16 byte aligned when making any POSIX call on Mac OS X. 

To build PE/COFF images with Xcode 3.2 and extra tool call mtoc is required to convert Mach-O 
images into PE/COFF images. The tool only supports EFI PE/COFF images and the instructions on 
how to download it are on the edk2 website.

FAQ
===
1, I fail to build UnixPkg due to "X11/extensions/XShm.h: No such file or directory"?
   The display adapter in UnixPkg is a virtual device written in X11 API. The library of x11proto-xext-dev is required
   for building.

2, I fail to build UnixPkg due to "/usr/bin/ld: cannot find -lXext"?   
   libxext-dev library is required for building.