]> git.proxmox.com Git - mirror_edk2.git/blame - BaseTools/gcc/README.txt
MdeModulePkg UefiBootManagerLib: Support LoadFile Protocol based on FV
[mirror_edk2.git] / BaseTools / gcc / README.txt
CommitLineData
30fdf114
LG
1You may run these scripts to build a UEFI/PI gcc cross compiler.\r
2\r
3Cross compilers built with these scripts are tested on\r
4Linux, OS X and Cygwin.\r
5\r
6Please note that you may need to modify your edk2 tree's Conf/tools_def.txt\r
7file to point to the location where you installed the cross compiler.\r
8\r
9=== tianoCross-gcc-4.1 ===\r
10\r
11This script will build an x86 (ia32) cross compiler.\r
12\r
13The results of this script are very similar to the 'mingw' cross compiler\r
14which is commonly available on linux and OS X. But, since the cross\r
15compiler produced by this script is tested, it is the only 'supported' way\r
16to build UEFI/PI images.\r
17\r
18To use this script, you will need:\r
19\r
20 * A recent version (3.0 or later should be fine) of gcc that is able to produce\r
21 executables for the machine that you want to run this compiler on (the host\r
22 machine).\r
23 * wget or curl\r
24 * tar\r
25 * bzip\r
26 * gzip\r
27 * bash\r
28 * As well as (possibly) others tools and development packages\r
29\r
30=== x86_64-mingw-gcc-build.py ==\r
31\r
32This script will build an x86_64 (x64/Intel 64/amd64) cross compiler.\r
33\r
34To use this script, you will need:\r
35\r
36 * A recent version (3.0 or later should be fine) of gcc that is able to\r
37 produce executables for the machine that you want to run this compiler\r
38 on (the host machine).\r
39 * Python 2.5\r
40 * texinfo\r
41 * bison\r
42 * flex\r
43 * libmpfr\r
44 * libgmp\r
45 * As well as (possibly) others tools and development packages\r
46\r
47=== Ubuntu Notes ===\r
48\r
49On Ubuntu, the following command should install all the necessary build\r
50packages to utilize the x86_64-mingw-gcc-build.py script:\r
51\r
52 sudo apt-get install build-essential texinfo bison flex libgmp3-dev libmpfr-dev\r
53\r
54=== CYGWIN Notes ===\r
55\r
56You should setup cygwin to use binmode on all mounts. When you initially\r
57install cygwin it gives you the choice of Unix file mode (recommended) or DOS\r
58file mode. Unix mode will cause all the cygwin directories to be mounted in\r
59binmode, while DOS will mount the dirs in textmode. Here is an example of a\r
60cygwin install where the dirs are (properly) mounted in binmode.\r
61\r
62C:\cygwin\bin on /usr/bin type user (binmode)\r
63C:\cygwin\lib on /usr/lib type user (binmode)\r
64c:\workspace on /workspace type system (binmode)\r
65C:\cygwin on / type user (binmode)\r
66\r
67If you use textmode, it is likely that the build will fail in a way that is\r
68hard to debug.\r
69\r
70Cygwin is pretty slow, so it is not recommended for large builds.\r
71\r