docs: add known issue about missing forced unwind support
author"Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Thu Apr 07 19:02:56 2011 +0200 (2011-04-07)
changeset 23845f260bb27b35
parent 2383 bb6e2df2427f
child 2385 d1b8e9836cbf
docs: add known issue about missing forced unwind support

This has been reported many times, and has become a FAQ.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
docs/B - Known issues.txt
     1.1 --- a/docs/B - Known issues.txt	Fri Apr 08 00:02:44 2011 +0200
     1.2 +++ b/docs/B - Known issues.txt	Thu Apr 07 19:02:56 2011 +0200
     1.3 @@ -146,3 +146,20 @@
     1.4    labelled "Use sjlj for exceptions".
     1.5  
     1.6  --------------------------------
     1.7 +Symptoms:
     1.8 +  Installing the C library headers and start files fails because of
     1.9 +  missing unwind support, with a message like:
    1.10 +    configure: error: forced unwind support is required
    1.11 +
    1.12 +Explanations:
    1.13 +  The issue seems to be related to building NPTL on old versions
    1.14 +  of glibc (and possibly eglibc as well) on some architectures
    1.15 +  (seen on powerpc, s390, s390x and x86_64).
    1.16 +
    1.17 +Fix:
    1.18 +  None so far. It would require some glibc hacking.
    1.19 +
    1.20 +Workaround:
    1.21 +  Try setting "Force unwind support" in the "C-library" menu.
    1.22 +
    1.23 +--------------------------------