[mirror_edk2.git] / EdkShellBinPkg / ReadMe.txt

The binaries of EdkShellBinPkg are generated with EDK-Shell 1.04 release and build with Edk Compatibility & BaseTools Package\r
(r4631)\r
\r
The following steps can help to re-generate these binaries for customization:\r
1. Check out EdkCompatibilityPkg (r4631) to a directory EdkCompatibilityPkg in workspace (svn https://edk2.tianocore.org/svn/edk2/trunk/edk2/EdkCompatibilityPkg). \r
2. Update to the newest BaseTools package.\r
2. Download EfiShell 1.04.zip from EDK Shell official release https://efi-shell.tianocore.org/servlets/ProjectDocumentList?folderID=52&expandFolder=52&folderID=45\r
3. Unzip it to be a sub-directory in EdkCompatibilityPkg , i.e. c:\EdkII\EdkCompatibilityPkg\Shell\r
4. Work around an issue in EdkCompatibilityPkg\Shell\ver\Ver.inf to split:\r
  [sources.ia32|x64]\r
    ia32\ver32.c\r
\r
  to be:\r
  [sources.ia32]\r
    ia32\ver32.c\r
\r
  [sources.x64]\r
    ia32\ver32.c\r
\r
   since current build tools (r4631) do not support this syntax in EDK INF format.\r
\r
5. Under workspace directory (i.e. c:\EdkII), execute:\r
   build -a IA32 -a X64 -a IPF -p EdkShellBinPkg\GenBin\EdkShellPkg.dsc -t WINDDK3790x1830\r
   The use of WINDDK instead of MYTOOLS is due to the fact that EDK shell source 1.04 is not\r
   VS2005 clean.\r
\r
6. Copy the binaries from Build directory to this package. Typically the EFI binary\r
   of EdkCompatibility\Shell\$(INF_BASENAME).inf is generated at:\r
   Build\EdkShellPkg\DEBUG_WINDDK3790x1830\$(ARCH)\EdkCompatibility\Shell\$(INF_BASENAME)\OUTPUT\$(BASENAME).efi\r
   For example:\r
   The x64 EFI image of EdkCompatibility\Shell\ver\ver.inf is generated at:\r
   Build\EdkShellPkg\DEBUG_WINDDK3790x1830\X64\EdkCompatibilityPkg\Shell\ver\Ver\OUTPUT\ver.efi\r
\r
Note: Other\Maintained\Application\Shell\Shell.inf corresponds to Minimum shell binaries.\r
      Other\Maintained\Application\Shell\ShellFull.inf corresponds to Full Shell binaries.
Commit	Line	Data
970e4d2b	1	The binaries of EdkShellBinPkg are generated with EDK-Shell 1.04 release and build with Edk Compatibility & BaseTools Package\r
970e4d2b	2	(r4631)\r
abe7b4c6	3	\r
fa312759	4	The following steps can help to re-generate these binaries for customization:\r
970e4d2b	5	1. Check out EdkCompatibilityPkg (r4631) to a directory EdkCompatibilityPkg in workspace (svn https://edk2.tianocore.org/svn/edk2/trunk/edk2/EdkCompatibilityPkg). \r
	6	2. Update to the newest BaseTools package.\r
	7	2. Download EfiShell 1.04.zip from EDK Shell official release https://efi-shell.tianocore.org/servlets/ProjectDocumentList?folderID=52&expandFolder=52&folderID=45\r
fa312759	8	3. Unzip it to be a sub-directory in EdkCompatibilityPkg , i.e. c:\EdkII\EdkCompatibilityPkg\Shell\r
fa312759	9	4. Work around an issue in EdkCompatibilityPkg\Shell\ver\Ver.inf to split:\r
970e4d2b	10	[sources.ia32\|x64]\r
	11	ia32\ver32.c\r
	12	\r
	13	to be:\r
	14	[sources.ia32]\r
	15	ia32\ver32.c\r
	16	\r
	17	[sources.x64]\r
	18	ia32\ver32.c\r
	19	\r
fa312759	20	since current build tools (r4631) do not support this syntax in EDK INF format.\r
970e4d2b	21	\r
fa312759	22	5. Under workspace directory (i.e. c:\EdkII), execute:\r
970e4d2b	23	build -a IA32 -a X64 -a IPF -p EdkShellBinPkg\GenBin\EdkShellPkg.dsc -t WINDDK3790x1830\r
	24	The use of WINDDK instead of MYTOOLS is due to the fact that EDK shell source 1.04 is not\r
	25	VS2005 clean.\r
	26	\r
	27	6. Copy the binaries from Build directory to this package. Typically the EFI binary\r
fa312759	28	of EdkCompatibility\Shell\$(INF_BASENAME).inf is generated at:\r
970e4d2b	29	Build\EdkShellPkg\DEBUG_WINDDK3790x1830\$(ARCH)\EdkCompatibility\Shell\$(INF_BASENAME)\OUTPUT\$(BASENAME).efi\r
fa312759	30	For example:\r
970e4d2b	31	The x64 EFI image of EdkCompatibility\Shell\ver\ver.inf is generated at:\r
970e4d2b	32	Build\EdkShellPkg\DEBUG_WINDDK3790x1830\X64\EdkCompatibilityPkg\Shell\ver\Ver\OUTPUT\ver.efi\r
abe7b4c6	33	\r
	34	Note: Other\Maintained\Application\Shell\Shell.inf corresponds to Minimum shell binaries.\r
	35	Other\Maintained\Application\Shell\ShellFull.inf corresponds to Full Shell binaries.