A versatile (cross-)toolchain generator.
Shell C M4 Yacc Makefile Lex Other
Switch branches/tags
crosstool-ng-1.23.0 crosstool-ng-1.23.0-rc2 crosstool-ng-1.23.0-rc1 crosstool-ng-1.22.0 crosstool-ng-1.21.0 crosstool-ng-1.20.0 crosstool-ng-1.19.0 crosstool-ng-1.18.0 crosstool-ng-1.17.0 crosstool-ng-1.16.0 crosstool-ng-1.15.3 crosstool-ng-1.15.2 crosstool-ng-1.15.1 crosstool-ng-1.15.0 crosstool-ng-1.14.1 crosstool-ng-1.14.0 crosstool-ng-1.13.4 crosstool-ng-1.13.3 crosstool-ng-1.13.2 crosstool-ng-1.13.1 crosstool-ng-1.13.0 crosstool-ng-1.12.4 crosstool-ng-1.12.3 crosstool-ng-1.12.2 crosstool-ng-1.12.1 crosstool-ng-1.12.0 crosstool-ng-1.11.4 crosstool-ng-1.11.3 crosstool-ng-1.11.2 crosstool-ng-1.11.1 crosstool-ng-1.11.0 crosstool-ng-1.10.1 crosstool-ng-1.10.0 crosstool-ng-1.9.3 crosstool-ng-1.9.2 crosstool-ng-1.9.1 crosstool-ng-1.9.0 crosstool-ng-1.8.2 crosstool-ng-1.8.1 crosstool-ng-1.8.0 crosstool-ng-1.7.2 crosstool-ng-1.7.1 crosstool-ng-1.7.0 crosstool-ng-1.6.2 crosstool-ng-1.6.1 crosstool-ng-1.6.0 crosstool-ng-1.5.3 crosstool-ng-1.5.2 crosstool-ng-1.5.1 crosstool-ng-1.5.0 crosstool-ng-1.4.2 crosstool-ng-1.4.1 crosstool-ng-1.4.0 crosstool-ng-1.3.3 crosstool-ng-1.3.2 crosstool-ng-1.3.1 crosstool-ng-1.3.0 crosstool-ng-1.2.5 crosstool-ng-1.2.4 crosstool-ng-1.2.3 crosstool-ng-1.2.2 crosstool-ng-1.2.1 crosstool-ng-1.2.0 crosstool-ng-1.1.3 crosstool-ng-1.1.3a crosstool-ng-1.1.2 crosstool-ng-1.1.1 crosstool-ng-1.1.0 crosstool-ng-1.0.0 crosstool-ng-0.3.2 crosstool-ng-0.3.1 crosstool-ng-0.3.0 crosstool-ng-0.2.2 crosstool-ng-0.2.1 crosstool-ng-0.2.0 crosstool-ng-0.1.2 crosstool-ng-0.1.1 crosstool-ng-0.1.0 crosstool-ng-0.0.5 crosstool-ng-0.0.4 crosstool-ng-0.0.3 crosstool-ng-0.0.2 crosstool-ng-0.0.1
Nothing to show
Clone or download
stilor Merge pull request #981 from stilor/use-git-version-gen
Use git-version-gen to generate version info
Latest commit d5900de Jun 7, 2018
Failed to load latest commit information.
bash-completion Install bash completion into new location Apr 7, 2018
config Make patch order overridable by individual packages Jun 6, 2018
contrib Remove OBSTACK from uclibc-ng config Feb 4, 2017
debian Merge pull request #952 from dlech/patch-2 Apr 29, 2018
docs User manual installation Apr 7, 2018
kconfig Supply explicit --tag CC Apr 14, 2018
licenses.d Rename directory "licenses" to "licenses.d" for those filesystems una… Mar 11, 2007
m4 Add checking for *sum and unzip Apr 29, 2018
maintainer Use git-version-gen to generate version info Jun 7, 2018
packages Add upstream patch fixing XScale build Jun 5, 2018
samples ARC: Update Linux samples May 21, 2018
scripts Make patch order overridable by individual packages Jun 6, 2018
testing/docker Add the ability to run some but not all samples in docker Apr 30, 2018
.gitignore Testing works for archlinux docker Apr 16, 2018
.travis.sh .travis.sh: increase the number of jobs to run in parallel Jun 16, 2017
.travis.yml Kill gperf vestiges Apr 7, 2018
COPYING Update and clarify COPYING (plus a typo). Sep 14, 2008
LICENSE Doc renames & issue template Apr 13, 2017
Makefile.am Use git-version-gen to generate version info Jun 7, 2018
README.md Minor fixes in README.md Apr 10, 2017
TODO Merge a local TODO list Dec 17, 2017
bootstrap config.sub/config.guess must either be executable Apr 7, 2018
configure.ac Use git-version-gen to generate version info Jun 7, 2018
ct-ng.in Doh. Change the name of the substituted variable May 15, 2018
issue_template.md Doc renames & issue template Apr 13, 2017
paths.sh.in Add checking for *sum and unzip Apr 29, 2018




Crosstool-NG aims at building toolchains. Toolchains are an essential component in a software development project. It will compile, assemble and link the code that is being developed. Some pieces of the toolchain will eventually end up in the resulting binaries: static libraries are but an example.

Before reporting a bug, please read bug reporting guidelines. Bugs that do not provide the required information will be closed without explanation.

Refer to documentation at crosstool-NG website for more information on how to configure, install and use crosstool-NG.

Note 1: If you elect to build a uClibc-based toolchain, you will have to prepare a config file for uClibc with <= crosstool-NG-1.21.0. In >= crosstool-NG-1.22.0 you only need to prepare a config file for uClibc(or uClibc-ng) if you really need a custom config for uClibc.

Note 2: If you call ct-ng --help you will get help for make(2). This is because ct-ng is in fact a make(2) script. There is no clean workaround for this.

Repository layout

To clone the crosstool-NG repository:

git clone https://github.com/crosstool-ng/crosstool-ng

Old repositories

These are the old Mercurial repositories. They are now read-only: http://crosstool-ng.org/hg/

Pull Requests and Issues

You can find open Pull Requests on GitHub here and you can find open issues here.


To contribute to crosstool-NG it is helpful to provide as much information as you can about your change, including any updates to documentation (if appropriate), and test... test... test.

git clone https://github.com/crosstool-ng/crosstool-ng
  • Create a topic branch for your work
git checkout -b fix_comment_typo
  • Make changes
  • hack
  • test
  • hack
  • etc...
  • Add your changes
git add [file(s) that changed, add -p if you want to be more specific]
  • Verify you are happy with your changes to be commited
git diff --cached
  • Commit changes
git commit -s

The -s automatically adds your Signed-off-by: [name] <email> to your commit message. Your commit will be rejected without this.

Also, please explain what your change does. "Fix stuff" will be rejected. For examples of good commit messages, read the changelog.

  • Push your topic branch with your changes to your fork
git push origin fix_comment_typo
  • Go to the crosstool-ng project and click the Compare & pull request button for the branch you want to open a pull request with.
  • Review the pull request changes, and verify that you are opening a pull request for the appropriate branch. The title and message should reflect the nature/theme of the changes in the PR, say the title is Fix comment typos and the message details any specifics you can provide.
  • You might change the crosstool-ng branch, if you are opening a pull request that is intended for a different branch. For example, when you created your topic branch you could have done:
git checkout -b fix_out_of_date_patch origin/1.22

Then when you get to this pull request screen change the base branch from master to 1.22

  • By creating a pull request, the PR is entered into the backlog. A travis-ci job will run to test your changes against a select set of samples. As they start to get worked, they should be placed in the Ready state. PRs that are being worked are In Progress. If a questions come up about the commit that might envolve changes to the commit then the PR is placed in Waiting For Response, you have two options:
  1. Fix the issue with the commit by adding a new commit in the topic branch that fixes the code review. Then push your changes to your branch. This option keeps the comments in the PR, and allows for further code review. I personally dislike this, because people are lazy and fix reviews with fix more review issues. Please make good commit messages! All rules about commits from above apply! THIS IS PREFERED

Add your changes

git add [file(s) that changed, add -p if you want to be more specific]

Verify you are happy with your changes to be commited

git diff --cached

Commit changes

git commit -s
  • Push your topic branch with your changes to your fork
git push origin fix_comment_typo

At this point the PR will be updated to have the latest commit to that branch, and can be subsequently reviewed.

  1. Interactively rebase the offending commit(s) to fix the code review. This option is slightly annoying on Github, as the comments are stored with the commits, and are hidden when new commits replace the old commits. They used to disappear completely; now Github shows a grey 'View outdated' link next to the old commits.

This recipe also comes handy with other issues, like your topic branch not being up-to-date with master:

git fetch --all
git rebase --ignore-whitespace origin master
git rebase -i <offending-commit-id>^

NOTE: The --ignore-whitespace stops git apply (which is called by rebase) from changing any whitespace when it runs.

Replace pick with edit or remove the line to delete a commit. Fix the issue in the code review.

git add [file(s)]
git rebase --continue
<update commit comment if needed>
git push --force origin fix_comment_typo


We previously used patchwork for development, but it is no longer used. I'd like to see patches that are still applicable turned into Pull Requests on GitHub.

You can find the list of pending patches available on patchwork.

More Info

You can find all of this and more at crosstool-ng.org

Report issues at the project site on GitHub.

We have a mailing list. Archive and subscription info can be found here: https://sourceware.org/ml/crossgcc/

We are also available on IRC: irc.freenode.net #crosstool-ng.

Aloha! :-)

Build Status

Throughput Graph

Stories in Ready Stories in Waiting For Response Stories in In Progress