Build gcc cross compiler on Windows, Mac OSX, Linux and FreeBSD.

Upgrade notes:

2020-02-13: default target for djgpp has changed to i386-pc-msdosdjgpp.
If you require compatibility with distributions that use i586, you can either:
- run sudo i386-pc-msdosdjgpp-link-i586 after installing, or
- build with ./build-djgpp.sh --target=i586-pc-msdosdjgpp.
2020-02-07: setenv script is now installed to $PREFIX/bin/$TARGET-setenv.
2019-06-06: master is now the default branch again.

Current package versions, as of 2025-05-28:

gcc 14.2.0
binutils 2.44
gdb 16.3
djgpp 2.05 / cvs
watt-32 git
newlib 4.3.0.20230120
avr-libc 2.1.0
avrdude 7.0
avarice 2.14
simulavr git

Tested targets:

i386-pc-msdosdjgpp
ia16
arm-eabi
avr

See the Actions tab on Github for a detailed status of individual targets.

Requirements

Before running this script, you need to install these programs first:

g++
gcc
unzip
tar
bzip2
gzip
xz
bison
flex
make (or gmake for FreeBSD)
makeinfo
patch
zlib header/library
curl or wget
bash (for FreeBSD)
python2 headers (for gdb)
python3 headers (for gdb >= 9.0)
m4
dos2unix
nasm

Depending on your system, installation procedure maybe different.

On Debian/Ubuntu, you can install these programs by :

$ sudo apt-get update
$ sudo apt-get install bison flex curl gcc g++ make texinfo zlib1g-dev tar bzip2 gzip xz-utils unzip python3-dev m4 dos2unix nasm

Fedora :

$ sudo yum install gcc-c++ which bison flex texinfo patch zlib-devel tar bzip2 gzip xz unzip python-devel m4 dos2unix nasm

mingw-w64 (msys2) :

$ pacman -Syuu base-devel mingw-w64-x86_64-{toolchain,curl,zlib,python3} compression m4 dos2unix nasm

Configuration

The following command line options are recognized:

  --prefix=...              # Install location (default: /usr/local/cross)
  --target=...              # Target name
  --enable-languages=...    # Comma-separated list of languages to build compilers for (default: c,c++)
  --no-download             # Do not download any files
  --only-download           # Download source files, then exit
  --ignore-dependencies     # Do not check package dependencies
  --batch                   # Run in batch mode (will not prompt or delay to confirm settings)

Several environment variables also control the build process:

GCC_CONFIGURE_OPTIONS=      # Extra options to pass to gcc's ./configure
BINUTILS_CONFIGURE_OPTIONS= # Same, for binutils
GDB_CONFIGURE_OPTIONS=      # Same, for gdb
NEWLIB_CONFIGURE_OPTIONS=   # Same, for newlib
AVRLIBC_CONFIGURE_OPTIONS=  # Same, for avr-libc
GLOBAL_CONFIGURE_OPTIONS=   # Extra options added to all variables listed above
MAKE_JOBS=                  # Number of parallel build threads (auto-detected)
CFLAGS_FOR_TARGET=          # CFLAGS used to build target libraries
HOST=                       # The platform you are building for, when building a cross-cross compiler
BUILD=                      # The platform you are building on (auto-detected)
MAKE_CHECK=                 # Run test suites on built programs.
MAKE_CHECK_GCC=             # Run gcc test suites.

Building

Pick the script you want to use:

build-djgpp.sh      # builds a toolchain targeting djgpp (default TARGET: i386-pc-msdosdjgpp)
build-newlib.sh     # builds a toolchain with the newlib C library
build-ia16.sh       # builds a toolchain targeting 8086 processors, with the newlib C library (fixed TARGET: ia16-elf)
build-avr.sh        # builds a toolchain targeting AVR microcontrollers (fixed TARGET: avr)

To build DJGPP, just run:

$ ./build-djgpp.sh [options...] [packages...]

Run with no arguments to see a list of supported packages and versions.

For example, to build gcc 9.2.0 with the latest djgpp C library from CVS and latest binutils:

$ ./build-djgpp.sh --prefix=/usr/local djgpp-cvs binutils gcc-9.2.0

To install or upgrade all packages:

$ ./build-djgpp.sh --prefix=/usr/local all

It will download all necessary files, build DJGPP compiler, binutils, and gdb, and install it.

Using

(In the following examples, it is assumed that you built the toolchain with options --prefix=/home/me/.local and --target=i386-pc-msdosdjgpp. Substitute as necessary for your configuration.)

To use your new compiler, you must add its bin directory to your PATH. You can then access the toolchain through its target-prefixed name:

$ PATH="/home/me/.local/bin:$PATH"
$ i386-pc-msdosdjgpp-g++ hello.cpp

A setenv script will also be installed. This sets up environment variables so that you can use the toolchain as if you were working on the target machine. The toolchain utilities are then accessible through their short names (gcc, ld, etc), and you can access target-specific documentation and locate target libraries (via man/info and pkg-config, respectively).

This script can be used either with no arguments, to start a new shell:

$ i386-pc-msdosdjgpp-setenv
Entering new shell for target environment: i386-pc-msdosdjgpp
$ which gcc
/home/me/.local/i386-pc-msdosdjgpp/bin//gcc
$ gcc -v 2>&1 | grep 'Target'
Target: i386-pc-msdosdjgpp

With a single command:

$ i386-pc-msdosdjgpp-setenv info libc
  # (shows documentation for djgpp's C library)

Or sourced into the current shell: (Bash only)

$ which gcc
/usr/bin/gcc
$ source i386-pc-msdosdjgpp-setenv
Environment variables set up for target: i386-pc-msdosdjgpp
$ which gcc
/home/me/.local/i386-pc-msdosdjgpp/bin/gcc

Supported DJGPP utilities

dxe3gen
dxe3res
dxegen
exe2coff
stubedit
stubify
djasm

Supported AVR utilities

avrdude
avarice
simulavr

Thanks

These scripts are based on Andrew Wu's build-djgpp script:
https://github.com/andrewwutw/build-djgpp
Which in turn is based on spec file from DJGPP source rpm files by Andris Pavenis:
http://ap1.pp.fi/djgpp/index.html

License

jwt27/build-gcc

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages