yann@771: This files lists the known issues encountered while developping crosstool-NG, yann@771: but that could not be addressed before the release. yann@771: yann@771: The file has one section for each known issue, each section containing four yann@771: sub-sections: Symptoms, Explanations, Fix, and Workaround. yann@771: yann@771: Each section is separated from the others with a lines of at least 4 dashes. yann@771: yann@771: The following dummy section explains it all. yann@771: yann@771: -------------------------------- yann@771: Symptoms: yann@771: A one-liner of what you would observe. yann@771: yann@771: Explanations: yann@771: An as much as possible in-depth explanations of the context, why it yann@771: happens, what has been investigated so far, and possible orientations yann@771: as how to try to solve this (eg. URLs, code snippets...). yann@771: yann@771: Fix: yann@771: What you have to do to fix it, if at all possible. yann@771: The fact that there is a fix, and yet this is a known issue means that yann@771: time to incorporate the fix in crosstool-NG was missing, or planned for yann@771: a future release. yann@771: yann@771: Workaround: yann@771: What you can do to fix it *temporarily*, if at all possible. yann@771: A workaround is not a real fix, as it can break other parts of yann@771: crosstool-NG, but at least makes you going in your particular case. yann@771: yann@771: So now, on for the real issues... yann@771: yann@771: -------------------------------- yann@771: Symptoms: yann@771: Seemingly native toolchains do not build. yann@771: yann@771: Explanations: yann@771: Seemingly native toolchains are toolchains that target the same architecture yann@771: as the one it is built on, and on which it will run, but the machine tuple yann@771: may be different (eg i686 vs. i386, or x86_64-unknown-linux-gnu vs. yann@771: x86_64-pc-linux-gnu). yann@771: yann@771: This seems to happen when building glibc-2.7 based toolchains only, for yann@771: x86 and for x86_64. yann@771: yann@771: Only the system part of the tuple (here, linux-gnu) needs to be the same to yann@771: trigger the bug. yann@771: yann@771: If you really cross-compile (eg x86 -> x86_64, or the other way around), yann@771: the toolchain builds successfully. yann@771: yann@771: Fix: yann@771: None known. yann@771: yann@771: Workaround: yann@771: If this happens for you, stick with glibc-2.6.1 for now. yann@771: Or investigate! :-) yann@771: yann@771: --------------------------------