ShellBinPkg: Arm/AArch64 Shell binary update.
[mirror_edk2.git] / ShellBinPkg / ReadMe.txt
1 ============================================================================
2 OVERVIEW
3 ============================================================================
4 The binaries of ShellBinPkg are generated with ShellPkg project and built with
5 BaseTools Package (r16473). The binaries are built with no debug information
6 by building with "RELEASE" target.
7
8 The following steps can help to re-generate these binaries for customization:
9 1. Check out EDK II to $(WORKSPACE)
10 (svn https://svn.code.sf.net/p/edk2/code/trunk/edk2).
11
12 2. Under $(WORKSPACE) directory (i.e. c:\EdkII),
13 To generate Shell, execute:
14 "build -a IA32 -a X64 -p ShellPkg\ShellPkg.dsc -b RELEASE"
15 To generate Minimal Shell, execute:
16 "build -a IA32 -a X64 -p ShellPkg\ShellPkg.dsc -b RELEASE -D NO_SHELL_PROFILES"
17
18 ============================================================================
19 HOW TO INCORPORATE THIS SHELL INTO NT32
20 ============================================================================
21 The instructions below are included as a sample and template on how a
22 developer may integrate this code into an existing platform:
23
24 1. Update system PCDs to support this new module
25 Update the PCD as follows using the Shell's PCD:
26 gEfiIntelFrameworkModulePkgTokenSpaceGuid.PcdShellFile|{ 0x83, 0xA5,
27 0x04, 0x7C, 0x3E, 0x9E, 0x1C, 0x4F, 0xAD, 0x65, 0xE0, 0x52, 0x68, 0xD0,
28 0xB4, 0xD1 }
29
30 2. Remove the old shell from the NT32 Firmware list
31 Remove the FILE APPLICATION section for the old shell.
32
33 3. Add this shell to the NT32 firmware list
34 Add the Shell.INF to the end of the list of DXE modules.
35
36 4. Build NT32
37
38 ============================================================================
39 KNOWN LIMITATIONS
40 ============================================================================
41 1. RM can delete current working directory via other map name.
42 2. DrvCfg does not overlap boot manager functionality.
43 3. Shell documentation is in development and forthcoming.
44
45 ============================================================================