diff --git a/documentation/ref-manual/faq.xml b/documentation/ref-manual/faq.xml index da6ce20eef..c53d458029 100644 --- a/documentation/ref-manual/faq.xml +++ b/documentation/ref-manual/faq.xml @@ -361,6 +361,41 @@ + + + + When I try to build a native recipe, the build fails with iconv.h problems. + + + + + If you get an error message that indicates GNU + libiconv is not in use but + iconv.h has been included from + libiconv, you need to check to see if + you have a previously installed version of the header file + in /usr/local/include. + + #error GNU libiconv not in use but included iconv.h is from libiconv + + If you find a previously installed file, you should either + uninstall it or temporarily rename it and try the build again. + + + + This issue is just a single manifestation of "system + leakage" issues caused when the OpenEbedded build system + finds and uses previously installed files during a native + build. + This type of issue might not be limited to + iconv.h. + Be sure that leakage cannot occur from + /usr/local/include and + /opt locations. + + + +