Fix typos and adjust some documentation.
1 This files lists the known issues encountered while developping crosstool-NG,
2 but that could not be addressed before the release.
4 The file has one section for each known issue, each section containing four
5 sub-sections: Symptoms, Explanations, Fix, and Workaround.
7 Each section is separated from the others with a lines of at least 4 dashes.
9 The following dummy section explains it all.
11 --------------------------------
13 A one-liner of what you would observe.
16 An as much as possible in-depth explanations of the context, why it
17 happens, what has been investigated so far, and possible orientations
18 as how to try to solve this (eg. URLs, code snippets...).
21 What you have to do to fix it, if at all possible.
22 The fact that there is a fix, and yet this is a known issue means that
23 time to incorporate the fix in crosstool-NG was missing, or planned for
27 What you can do to fix it *temporarily*, if at all possible.
28 A workaround is not a real fix, as it can break other parts of
29 crosstool-NG, but at least makes you going in your particular case.
31 So now, on for the real issues...
33 --------------------------------
35 Seemingly native toolchains do not build.
38 Seemingly native toolchains are toolchains that target the same architecture
39 as the one it is built on, and on which it will run, but the machine tuple
40 may be different (eg i686 vs. i386, or x86_64-unknown-linux-gnu vs.
43 This seems to happen when building glibc-2.7 based toolchains only, for
46 Only the system part of the tuple (here, linux-gnu) needs to be the same to
47 trigger the bug. Which means that building a tolchain for either x86 or
48 x86_64 on either x86 or x86_64 breaks.
54 It seems that using -O2 in the CFLAGS fixes the problem. It has been
55 confirmed in the following threads:
56 http://sourceware.org/ml/crossgcc/2009-09/msg00055.html (for glibc)
57 http://sourceware.org/ml/crossgcc/2009-10/msg00001.html (for eglibc)
59 --------------------------------
61 gcc is not found, although I *do* have gcc installed.
64 This is an issue on at least RHEL systems, where gcc is a symlink to ccache.
65 Because crosstool-NG create links to gcc for the build and host environment,
66 those symlinks are in fact pointing to ccache, which then doesn't know how
69 A possible fix could probably set the environment variable CCACHE_CC to the
78 --------------------------------
80 The extract and/or path steps fail under Cygwin.
83 This is not related to crosstool-NG. Mounts under Cygwin are by default not
84 case-sensitive. You have to use so-called "managed" mounts. See:
85 http://cygwin.com/faq.html section 4, question 32.
88 Use "managed" mounts for the directories where you build *and* install your
94 --------------------------------
96 uClibc fails to build under Cygwin.
99 With uClibc, it is possible to build a cross-ldd. Unfortunately, it is
100 not (currently) possible to build this cross-ldd under Cygwin.
106 Disable the cross-ldd build.
108 --------------------------------