README
author Bryan Hundven <bryanhundven@gmail.com>
Sun Jun 26 03:26:54 2011 -0700 (2011-06-26)
changeset 2515 364b06df9e3a
parent 1575 eb92c99b17cd
child 2725 32aa23619dfd
permissions -rw-r--r--
glibc: Refactor startfiles/headers into do_libc_backend()

Refactor the contents of 'do_libc_start_files()' and 'do_libc()' into a
parameterized 'do_libc_backend()'. 'do_libc_start_files()' and 'do_libc()'
call 'do_libc_backend()' with either 'libc_mode=startfiles' or
'libc_mode=final' (respectively) so that the startfiles/headers and
the final libc builds are configured and built with the same options.

One example of where this is needed is when building a mips toolchain.
Previously, if you were building an n32 toolchain, you wouldn't have
noticed an issue, because if '-mabi' is not in CFLAGS, n32 is the
default:

http://sourceware.org/git/?p=glibc-ports.git;a=blob;f=sysdeps/mips/preconfigure;hb=HEAD

But when trying to build an o32 or n64 toolchain the build would
have failed. This is because (e)glibc expects "-mabi={o32,n32,n64}" to be
in CFLAGS, but was not previously provided in 'do_libc_start_files()'.
The build failure would happen in the shared-core gcc when it tries to
configure an n64 or o32 gcc with an n32 libc.

A simpler solution would have been to just add TARGET_CFLAGS to configure
in 'do_libc_start_files()', but this way makes configure and make
consistent for both steps.

Signed-off-by: Bryan Hundven <bryanhundven@gmail.com>
yann@1
     1
This is the README for crosstool-NG
yann@1
     2
yann@2091
     3
Crosstool-NG follows the autoconf dance. So, to get you
yann@2091
     4
kick-started, just run:
yann@185
     5
  ./configure --help
yann@1
     6
yann@2091
     7
You will find the documentation in the directory 'docs'.
yann@2091
     8
Here is a quick overview of what you'll find there:
yann@2091
     9
  0 - Table of content
yann@2091
    10
  1 - Introduction
yann@2091
    11
  2 - Installing crosstool-NG
yann@2091
    12
  3 - Configuring a toolchain
yann@2091
    13
  4 - Building the toolchain
yann@2091
    14
  5 - Using the toolchain
yann@2091
    15
  6 - Toolchain types
yann@2091
    16
  7 - Contributing
yann@2091
    17
  8 - Internals
yann@2091
    18
  A - Credits
yann@2091
    19
  B - Known issues
yann@2091
    20
  C - Misc. tutorials
yann@1
    21
yann@1575
    22
You can also point your browser at:
yann@1463
    23
  http://ymorin.is-a-geek.org/projects/crosstool
yann@96
    24
yann@185
    25
Aloha!