└── README.md /README.md: -------------------------------------------------------------------------------- 1 | # i386-elf-compiler-collection 2 | 3 | * [About](#about) 4 | * [Supported platforms](#supported-platforms) 5 | * [Downloading precompiled packages](#downloading-precompiled-packages) 6 | * [How to build](#how-to-build) 7 | 8 | ## About 9 | 10 | This buildscript downloads, compiles and installs GNU Binutils and GNU GCC 11 | targetting the i386-elf platform as a cross-compiler. It can be used to build 12 | the i386-elf-binutils and i386-elf-gcc cross-compilers on different 13 | architectures. A typical use case for this is people interested in operating 14 | systems development. 15 | 16 | ## Supported platforms 17 | 18 | The following platforms have been tested and are known to work: 19 | 20 | * GNU/Linux - both i686 and x86_64. 21 | * MacOS X - x86_64 (i686 is deprecated). 22 | * Windows / MinGW - i686 (x86_64 is still not tested). 23 | 24 | ## Downloading precompiled packages 25 | 26 | Please note that the building process can take several minutes depending on 27 | the specs of your computer. On a relatively new computer it might take a few 28 | minutes. On an older computer might take an hour or even more. Also, it has 29 | been found that the build process is extremely slow in Windows due to the 30 | MinGW emulation. 31 | 32 | Several precompiled packages have been provided as is and are available at the 33 | [releases](https://github.com/danirod/i386-elf-compiler-collection/releases) 34 | page of this repository. Download a precompiled package for your architecture 35 | and follow the installation instructions to get an usable environment. 36 | 37 | ## How to build 38 | 39 | You can also build the compiler on your own if you prefer. 40 | 41 | Your host computer needs to have the following software installed: **gcc**, 42 | **g++**, **flex**, **bison**, **texinfo** and **wget**. Several libraries 43 | required for building GCC such as **gmp**, **mpc** and **mpfr** are 44 | download and precompiled by the script. They can be installed too to speed 45 | up the build process. 46 | 47 | **Note for Windows users**: you need to set up an usable UNIX environment 48 | on your Windows system such as MingW or MSYS to run the buildscripts. Cygwin 49 | has not been tested although I'm interested in. 50 | 51 | Once your system is ready, clone the repository, download as ZIP or 52 | get the script on any way and run it. Usage: 53 | 54 | ./buildcomp -p [-l ] [-v] 55 | 56 | Options: 57 | 58 | * -p : the script will install the compiler suite to . This 59 | argument is required and the script has to be provided with a valid 60 | directory: it has to exist and the script must be able to write to it. 61 | The script will refuse to work otherwise. 62 | * -v: if provided, will print to the console the output of the build process 63 | (such as the output made by `make` and `configure`). 64 | * -l : if provided, will save the output of the build process to the 65 | log file with the name hereby given. 66 | --------------------------------------------------------------------------------