summaryrefslogtreecommitdiff
path: root/docs/known-issues.txt
blob: 5228b10e736dfb50963774f8afd2b89278def9a6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
This files lists the known issues encountered while developping crosstool-NG,
but that could not be addressed before the release.

The file has one section for each known issue, each section containing four
sub-sections: Symptoms, Explanations, Fix, and Workaround.

Each section is separated from the others with a lines of at least 4 dashes.

The following dummy section explains it all.

    --------------------------------
    Symptoms:
      A one-liner of what you would observe.

    Explanations:
      An as much as possible in-depth explanations of the context, why it
      happens, what has been investigated so far, and possible orientations
      as how to try to solve this (eg. URLs, code snippets...).

    Fix:
      What you have to do to fix it, if at all possible.
      The fact that there is a fix, and yet this is a known issue means that
      time to incorporate the fix in crosstool-NG was missing, or planned for
      a future release.

    Workaround:
      What you can do to fix it *temporarily*, if at all possible.
      A workaround is not a real fix, as it can break other parts of
      crosstool-NG, but at least makes you going in your particular case.

So now, on for the real issues...

--------------------------------
Symptoms:
  Seemingly native toolchains do not build.

Explanations:
  Seemingly native toolchains are toolchains that target the same architecture
  as the one it is built on, and on which it will run, but the machine tuple
  may be different (eg i686 vs. i386, or x86_64-unknown-linux-gnu vs.
  x86_64-pc-linux-gnu).

  This seems to happen when building glibc-2.7 based toolchains only, for
  x86 and for x86_64.

  Only the system part of the tuple (here, linux-gnu) needs to be the same to
  trigger the bug.

  If you really cross-compile (eg x86 -> x86_64, or the other way around),
  the toolchain builds successfully.

Fix:
  None known.

Workaround:
  If this happens for you, stick with glibc-2.6.1 for now.
  Or investigate! :-)

--------------------------------